The user may define up to four "views", or sub-windows, to animate simultaneously. e.g., View 1 could be rainfall, View 2 flooded areas, View 3 damage to bridges or levees, View 4 other economic damage, all animated as a time series. A black border 2 pixels wide is drawn around each view. There is an arbitrary limit of 400 files per view (400 animation frames). Temporary files are created in the conversion process, so lack of adequate tmp space could also limit the number of frames you are able to convert.
The environment variable GMPEG_SIZE is checked for a value to use as the dimension, in pixels, of the longest dimension of the animation image. If GMPEG_SIZE is not set, the animation size defaults to the rows & columns in the current GRASS region, scaling if necessary to a default minimum size of 200 and maximum of 500. These size defaults are overridden when using the -c flag (see below). The resolution of the current GRASS region is maintained, independent of image size. Playback programs have to decode the compressed data "on-the-fly", therefore smaller dimensioned animations will provide higher frame rates and smoother animations.
UNIX - style wild cards may be used with the command line version in place of a raster map name, but wild cards must be quoted.
r.out.mpeg view1="rain[1-9]","rain1[0-2]" view2="temp*"
If the number of files differs for each view, the view with the fewest files will determine the number of frames in the animation.
With -c flag the module converts "on the fly", uses less disk space by using r.out.ppm with stdout option to convert frames as needed instead of converting all frames to ppm before encoding. Only use when encoding a single view. Use of this option also overrides any size defaults, using the CURRENTLY DEFINED GRASS REGION for the output size. So be careful to set region to a reasonable size prior to encoding.
A quality value of qual=1 will yield higher quality images, but with less compression (larger MPEG file size). Compression ratios will vary depending on the number of frames in the animation, but an MPEG produced using qual=5 will usually be about 60% the size of the MPEG produced using qual=1.
MPEG-1 Video Software Encoder
(Version 1.3; March 14, 1994)
Lawrence A. Rowe, Kevin Gong, Ketan Patel, and Dan Wallach Computer Science Division-EECS,
Available from Berkeley:
or as part of the netpbm package (ppmtompeg): http://netpbm.sourceforge.net
Playback may be done with many viewers; mpeg_encode's official companion is mpeg_play available from Berkeley at ftp://mm-ftp.cs.berkeley.edu/pub/multimedia/mpeg/play/ or a precompiled Debian package from http://packages.debian.org/ucbmpeg-play (includes maintained source code).
Use of the -c flag requires the r.out.ppm GRASS module with the stdout option.
Last changed: $Date$