Usage:
movie action options

Movie is the command-line implementation of Movie Recorder, which captures image frames from Chimera and assembles them into a movie file. Consult the Movie Recorder manual page for information on preparing movie content. During recording, other windows should not be placed over the Chimera graphics window.

One of the following action keywords must be specified:

• record - start recording frames (record options)
• stop - stop recording frames
• reset - reset status to zero frames saved (reset options)
• encode - encode the saved image frames into a movie file (encode options)
• abort - halt any encoding in progress and reset the recorder
• status - report recorder status in the Reply Log. Status information includes the number of frames saved and their format and location.

All specifications are optional, and the order of specification is not important. Option keywords can be truncated, and their case is not important. Default values are indicated with bold. A vertical bar "|" designates mutually exclusive values.

Options for record:

fformat jpeg|png|ppm
The format of saved image files.

directory image-directory
Where image files should be saved; the default varies by platform.

pattern filename-pattern
The filename-pattern is a string to use when naming the image files; the default is chimovie_xxxx-*, where xxxx is replaced by random characters and * is replaced by the frame number (for example, 00001, 00002, etc.). Any specified filename-pattern should include one and only one *, which will be replaced by the frame number.

Options for reset:

resetMode clear|keep
The default behavior (clear) is to delete the image files when a reset occurs; however, one should keep the files if planning to use them for some other purpose, such as movie encoding with a different program.

Options for encode:

mformat mpeg|mp2|mp4|mov
The movie file format.

output movie-pathname
The movie-pathname is the name and location to use for the movie file (the default is chimera_movie.mp2 in the current directory).

qscale quality
Movie quality is an integer that can range from 1 (default; highest quality, the least compression) to 31 (lowest quality, the most compression).

framerate fps
Movie fps is an integer and defaults to 25 frames per second.

target vcd|svcd|dvd
The target option keyword indicates that a preset should be used; no preset is used by default. A preset will override the settings of other parameters such as movie file format. See the Movie Recorder graphical interface for details on the available presets.

resetMode clear|keep|none
By default, a reset will occur when movie encoding is complete. The resetMode values clear and keep are as described above, while none specifies that no reset should occur; none should be used when one may want to re-encode the movie using the same saved frames.