Makes a movie from movie, image, and audio files. Makemovie is used to take image and audio data in a variety of forms and put them into a movie file that can be edited with moviemaker or viewed with movieplayer.

Usage: makemovie [-o outfile] [-f format] [-c compression] [-l loopmode][-r framerate] [-i interlacing] [-t] [-s xsize,ysize] [-b] [-q spatial_quality] [-p temporal_quality] [-a bitrate][-k keyframe_rate] [ file1 ... ]

The -o option must be used to specify the file in which the resulting movie will be placed. Image and audio data are taken from the input files in the order listed; this ordering determines the order in which they will appear when the movie is played. The options -c, -l, -i, -t,-r, -s, -b, -q, -p, -k, and -a can be used to set the compression scheme, loop mode, interlacing, orientation, frame rate, image size, image blurring, spatial quality, temporal quality, keyframe rate, and bitrate of the output movie.

The input files may be images, audio, QuickTime movies, SGI movies, or MPEG-1 movies. Image file formats are those supported by the IRIS ImageVision Library, which include ilSGI, ilFIT, and ilTIFF. Audio file formats include AIFF and AIFFC. makemovie can read QuickTime movies that have been compressed using "Animation", "Video", "Compact Video", "jpeg", or no compression.

For editing operations, it may be preferable to generate the movie in uncompressed format, then compress it afterward. This is because most compression schemes are slightly lossy, and some image degradation may result from long decompression-compression sequences. However, this will result in increased disk space requirements, since uncompressed movies are much larger than compressed movies. Typically, for "real world" video data, the compression achieved is about 8 or 10 to 1, but with simpler data, such as many computer graphics images, the compression achieved may be much greater, possibly 20 to 1 or so disk space should be planned accordingly.

Options:

-f format: Sets the file format of the output movie. Choices are "sgi" for the SGI movie format and "qt" for the QuickTime movie format.

-c compression: Sets the compression scheme for the output movie. Choices for the SGI movie format are "none" (no compression), "mvc1" (an SGI video compression scheme), "mvc2" (another SGI video compression scheme,with slower but greater compression and faster decompression than mvc1), "jpeg" (standard JPEG compression), "rle" (8-bit run-length encoding), and "rle24" (24-bit run-length encoding). Choices for the QuickTime movie format are "qt_anim" (QuickTime Animation),"qt_video" (QuickTime Video), "qt_cvid" (Compact Video), "jpeg", and"none".

-D file: Describes the contents of a movie file. Cannot be used with any other options.

-l loopmode: Sets default looping mode for playing the movie. Choices are:"once" (play the movie once), "loop" (keep playing it over and over), and "swing" (play it front-to-back, back-to-front over and over).

-r framerate: Sets the rate at which the images in the movie will be displayed during playback. This option can only be used when making movies from image files. If any of the input files are movies, they must all have the same rate and the output movie will be given that same rate. The default value is 15 frames per second.

-i interlacing: Sets the interlacing of the image track in the output movie. Choices are: "even" for PAL (even lines first), "odd" for NTSC (odd lines first) and "none" (no interlacing). Images are non-interlaced by default.

-q spatial_quality: Sets the spatial quality of the image track in the output movie. This is useful for setting the quality factor of a JPEG compressed image track and for setting the spatial quality of QuickTime Animation and Video tracks. spatial_quality must be a floating point number between 0 and 1.0. The default value of the spatial quality varies with the compression scheme.

-p temporal_quality: Sets the temporal quality of the image track in the output movie. This is useful for setting the temporal quality of QuickTime Animation and Video tracks. temporal_quality must be a floating point number between 0 and 1.0. The default value of the temporal compression varies with the compression scheme.

-a bitrate: Sets the bitrate for those compression algorithms that allow you to specify a compressed bitrate. bitrate is specified in bits/second and must be a an integer greater than 0.

-k keyframe_rate: Sets the frequency at which keyframes occur for those compression algorithms that use keyframes. keyframe_rate must be an integer greater than 0. The default value of the keyframe rate is 5.

-t : Sets the image orientation of the output movie to be top-to-bottom. The default orientation is bottom-to-top.

-s xsize,ysize: Sets the frame size of the movie to be created. This option overrides the default frame size, which is the size taken from the first image or movie file listed. If any of the images are the wrong size, they will be adjusted to fit by letterboxing. This means that they will made as big as possible within the new size. If the aspect ration of the new size is different, there will be black borders either at the top and bottom or at the left and right of the images.

-b Blurs the image track of the output movie with a 1-2-1 vertical convolution filter. This reduces flicker if the movie is played back through video.

-o outfile: This option is required and names the file that will be produced.

EXAMPLES
To make a compressed movie, movie1.mv, from audio file afile.AF and image file img.fit:

makemovie -o movie1.mv img.fit afile.AF

To make an uncompressed movie that will play at 10 frames per second from audio file afile.AF and image files img1.FIT, img2.FIT, and img3.FIT:

makemovie -o movie2.mv -c none -r 15 img1.FIT img2.FIT img3.FIT afile.AF

To make an odd interlaced, 640x480, JPEG compressed movie with top-to-bottom orientation (of the sort that can be played back on the Cosmo compression board using NTSC timing) from image files img1.rgb, img2.rgb, and img3.rgb:

makemovie -o movie3.mv -c jpeg -s 640,480 -i odd -t img1.rgb img2.rgb img3.rgb

To do the same thing for PAL video:

makemovie -o movie3.mv -c jpeg -s 768,576 -i even -t img1.rgb img2.rgb img3.rgb

To make a top-to-bottom QuickTime movie compressed with Compact Video and with a spatial quality factor of .5 from image files img1.rgb, img2.rgb, and img3.rgb:

makemovie -o movie4.mv -t -f qt -c qt_cvid -q .5 img1.rgb img2.rgb img3.rgb

To convert a QuickTime movie (monkey.qt) to an SGI movie (monkey.mv):

makemovie -o monkey.mv monkey.qt