MPEG TIPS
#
    To create an MPEG movie, select the MPEG file format option from
the Save movie window and click the Generate button.  The Generate
button will only produce a movie when a file has been opened and a 
plot has been drawn. 
#
    The Save movie window has several fields that may be set by the
user.  These fields control how the movie is generated.  The value
present in the filename field is the name of the movie that will be
generated.  Other fields control how many frames to generate and what
file format to use.
#
    There are three formats for saving images.  Using the MPEG format,
all generated images are combined into an MPEG movie file.  The RGB
format indicates that movie frames will be written to a series of RGB
files instead of an MPEG movie.  The TIFF format indicates that movie
frames will be written to a series of TIFF files instead of an MPEG
movie.  Before an MPEG movie is generated, all movie frames are saved
as a set of PPM files.  If the MPEG movie cannot be generated for some
reason, then these files remain in the directory in which MeshTV was
executed.  If movie generation is successful, then these files are
removed.
#
    The image resolution may be set to any value from 100 to 2048. 
Make sure that the image resolution is divisible by sixteen or the
resulting MPEG movie may not be viewable by some players.
#
#
COMMAND LINE
#
    The Save movie window also allows the user to generate a movie
at a later date if the "Generate now" toggle button is not toggled.
When it is not toggled, the necessary parameter files are generated
and the user is given the commands needed to generate a movie using
the movie_generate script. The movie_generate script generates the images
that are used to create a movie and then calls an MPEG encoder program
to combine the individual images into an MPEG movie.  The movie_generate
script can output series of RGB or TIFF files in addition to MPEG movies. 
MPEG movie generation is only supported on Silicon Graphics machines
running IRIX since an MPEG conversion program is required.  When generating
an MPEG movie on a Silicon Graphics machine running IRIX, the MESHTVHOME
environment variable must be set prior to running the movie_generate
script. This is required so the movie_generate script can locate the MPEG
encoder program. Please email MeshTV@viper.llnl.gov for assistance.
#
    %movie_generate  filebase  outputmode  resolution  meshtvxname  [gui_pid]  [-np N]
#
    The command line options for this script allow the user to specify
arguments that determine how the script executes.  Filebase is the
family name of the images to be generated.  Outputmode is either rgb,
tiff, or mpeg and it determines whether the output of the script is an
MPEG movie or a series of RGB or TIFF files.  Resolution is the
horizontal and vertical size of the images to be created.  Meshtvxname
is the name of the meshtvx being used in the current version of
MeshTV.  If the gui_pid argument is given, then the script will assume
that it has been run from the MeshTV gui and will send signals to the
gui indicating the success or failure of the script to generate RGB or
TIFF files or an MPEG movie.  The last optional argument is the
-np argument.  This tells the script whether or not to start
meshtvx using the mpirun command.  The argument is only needed for
parallel versions of meshtvx. If the -np argument is specified, you must
provide an integer greater than zero for the number of processors to use.

