/usr/share/doc/grass-doc/html/r.out.mpeg.html is in grass-doc 6.4.3-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS manual: r.out.mpeg</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>r.out.mpeg</b></em> - Raster File Series to MPEG Conversion.
<h2>KEYWORDS</h2>
raster, export
<h2>SYNOPSIS</h2>
<b>r.out.mpeg</b><br>
<b>r.out.mpeg help</b><br>
<b>r.out.mpeg</b> [-<b>qc</b>] <b>view1</b>=<em>string</em>[,<i>string</i>,...] [<b>view2</b>=<em>string</em>[,<i>string</i>,...]] [<b>view3</b>=<em>string</em>[,<i>string</i>,...]] [<b>view4</b>=<em>string</em>[,<i>string</i>,...]] [<b>output</b>=<em>string</em>] [<b>qual</b>=<em>integer</em>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-q</b></DT>
<DD>Quiet - suppress progress report</DD>
<DT><b>-c</b></DT>
<DD>Convert on the fly, use less disk space
(requires r.out.ppm with stdout option)</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>view1</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Raster file(s) for View1</DD>
<DT><b>view2</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Raster file(s) for View2</DD>
<DT><b>view3</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Raster file(s) for View3</DD>
<DT><b>view4</b>=<em>string[,<i>string</i>,...]</em></DT>
<DD>Raster file(s) for View4</DD>
<DT><b>output</b>=<em>string</em></DT>
<DD>Name for output file</DD>
<DD>Default: <em>gmovie.mpg</em></DD>
<DT><b>qual</b>=<em>integer</em></DT>
<DD>Quality factor (1 = highest quality, lowest compression)</DD>
<DD>Options: <em>1-5</em></DD>
<DD>Default: <em>3</em></DD>
</DL>
<h2>DESCRIPTION</h2>
<em>r.out.mpeg</em> is a tool for combining a series of GRASS raster maps
into a single MPEG-1 (Motion Pictures Expert Group) format file. MPEG-1 is
a "lossy" video compression format, so the quality of each resulting frame
of the animation will be much diminished from the original raster image.
The resulting output file may then be viewed using your favorite mpeg-format
viewing program.
MPEG-2 and MPEG-4 provide much better quality animations.
<p>
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.
<!-- flag to keep these to feed into another more modern encoder? -->
<p>
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.
<p>
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.
<h2>Example:</h2>
<div class="code"><pre>
r.out.mpeg view1="rain[1-9]","rain1[0-2]" view2="temp*"
</pre></div>
<p>
If the number of files differs for each view, the view with the fewest files
will determine the number of frames in the animation.
<p>
With <b>-c</b> flag the module converts "on the fly", uses less disk space
by using <em>r.out.ppm</em> 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 <b>CURRENTLY DEFINED GRASS REGION for the output size</b>.
So be careful to set region to a reasonable size prior to encoding.
<p>
A quality value of <em>qual=1</em> 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 <em>qual=5</em> will usually be about 60% the size of the MPEG
produced using <em>qual=1</em>.
<h2>BUGS</h2>
MPEG images must be 16-pixel aligned for successful compression, so if the
rows & columns of the calculated image size (scaled, with borders added)
are not evenly divisible by 16, a few rows/columns will be cut off the
bottom & right sides of the image. The MPEG format is optimized to
recognize image MOTION, so abrupt changes from one frame to another will
cause a "noisy" encoding.
<h2>NOTES</h2>
This program requires the program <em>mpeg_encode</em> (aka <em>ppmtompeg</em>):
<p>
MPEG-1 Video Software Encoder<br>
(Version 1.3; March 14, 1994)
<p>
Lawrence A. Rowe, Kevin Gong, Ketan Patel, and Dan Wallach Computer Science
Division-EECS, <dd>Univ. of Calif. at Berkeley</dd>
<p>
Available from Berkeley:
<a href="http://bmrc.berkeley.edu/frame/research/mpeg/mpeg_encode.html">http://bmrc.berkeley.edu/frame/research/mpeg/mpeg_encode.html</a>
<br>or as part of the netpbm package (<em>ppmtompeg</em>):
<a href="http://netpbm.sourceforge.net">http://netpbm.sourceforge.net</a>
<p>
Playback may be done with many viewers; <em>mpeg_encode</em>'s official companion
is <em>mpeg_play</em> available from Berkeley at
<a href="ftp://mm-ftp.cs.berkeley.edu/pub/multimedia/mpeg/play/">ftp://mm-ftp.cs.berkeley.edu/pub/multimedia/mpeg/play/</a>
or a precompiled Debian package from
<a href="http://packages.debian.org/ucbmpeg-play">http://packages.debian.org/ucbmpeg-play</a>
(includes maintained source code).
<p>
Use of the <em>-c</em> flag requires the <em>r.out.ppm</em> GRASS module
with the <em>stdout</em> option.
<h2>SEE ALSO</h2>
<em><a href="r.out.ppm.html">r.out.ppm</a></em>
<br>
<h2>AUTHOR</h2>
Bill Brown,
U.S. Army Construction Engineering Research Laboratories
<p><i>Last changed: $Date: 2008-05-16 12:09:06 -0700 (Fri, 16 May 2008) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="raster.html">raster index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2013 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
|