Section: User Commands (1)
Updated: 1 February 1995
ppmtompeg produces an MPEG-1 video stream. param_file is a parameter file which includes a list of input files and other parameters. The file is described in detail below. The -gop, -combine_gops, -frames, and -combine_frames options are all exclusive. This man page is probably incomplete. For complete usage, see the User's Guide.
::PATTERN <pattern> :OUTPUT <output file>INPUT_DIR <directory>
:INPUT :This line must be followed by a list of the input files (in display order) and then the line
There are three types of lines between INPUT and END_INPUT. First, a line may simply be the name of an input file. Secondly, the line may be of the form
single_star_expr can have a single '*' in it. It is replaced by all the numbers between x and y inclusive. So, for example, the line
is replaced by tennis12.ppm, tennis13.ppm, tennis14.ppm, tennis15.ppm. Uniform zero-padding occurs, as well. For example, the line
is replaced by football.001.ppm, football.002.ppm, ..., football.009.ppm, football.010.ppm, ..., football.130.ppm. The third type of line is:
Where the line is treated exactly as above, except that we skip by s. Thus, the line
is replaced by football.001.ppm, football.005.ppm, football.009.ppm, football.013.ppm, etc.: :BASE_FILE_FORMAT <YUV or PPM or PNM or JPEG or JMOVIE>
:INPUT_CONVERT <conversion command>
If you had a bunch of gif files, you might say:
If you have a bunch of separate a.Y, a.U, and a.V files, then you might say:
:PIXEL <FULL or HALF>
:REFERENCE_FRAME <ORIGINAL or DECODED>
The following lines are optional::FORCE_I_ALIGN
where w = width, h = height (in pixels) of image, and
See the file doc/INPUT.FORMAT for more information.
If the -combine-gops option is used, then only the YUV_SIZE and OUTPUT values need be specified in the parameter file. In addition, the parameter file may specify input GOP files in the same manner as normal input files -- except instead of using INPUT_DIR, INPUT, and END_INPUT, use GOP_INPUT_DIR, GOP_INPUT, and GOP_END_INPUT. If no input GOP files are specified, then the default is to use the output file name with suffix ".gop.<gop_num>" starting from 0 as the input files.
If the -combine-frames option is used, then only the YUV_SIZE, GOP_SIZE, and OUTPUT values need be specified in the parameter file. In addition, the parameter file may specify input frame files in the same manner as normal input files -- except instead of using INPUT_DIR, INPUT, and END_INPUT, use FRAME_INPUT_DIR, FRAME_INPUT, and FRAME_END_INPUT. If no input frame files are specified, then the default is to use the output file name with suffix ".frame.<frame_num>" starting from 0 as the input files.
Any number of spaces and tabs may come between each option and value. Lines beginning with '#' are ignored. Any other lines are ignored except for those between INPUT and END_INPUT. This allows you to use the same parameter file for normal usage and for -combine_gops and -combine_frames.
The encoder is case-sensitive so, except for file names and directories, everything should be in upper case.
The lines may appear in any order, except the following exceptions. INPUT must appear before END_INPUT (also, GOP_INPUT before GOP_END_INPUT and FRAME_INPUT before FRAME_END_INPUT). All lines between INPUT and END_INPUT must be the frames in play order.
The encoder is prepared to handle up to 16 B frames between reference frames when encoding with input from stdin. To increase this amount, change the constant B_FRAME_RUN in frame.c and recompile.
<machine> <user> <executable>
The executable is normally ppmtompeg (you may need to give the complete path if you've built for different architectures). If the machine is a remote machine, then the line should be:
REMOTE <machine> <user> <executable> <parameter file>
Full paths should generally be used when describing executables and parameter files. This INCLUDES the parameter file given as an argument to the original call to ppmtompeg. Also, .rhosts files on the appropriate machines should have the appropriate information.
The encoder will use the original machine for the master and I/O server processes, and uses the listed machines as slaves to do the computation.
Optional lines are
:RSH <remote shell command>
:PARALLEL_TIME_CHUNKS <t> :subsequently, each slave processor will be asked to encode for approximately t seconds. Smaller values of <t> increase communication, but improve load balancing.
Not really a bug, but at least a limitation: If writing to an output file, ppmtompeg sometimes uses <filename>.* as temporary files.
No known bugs, but if you find any, report them to [email protected].
:Kevin Gong - University of California, Berkeley, [email protected] Patel - University of California, Berkeley, [email protected] Wallach - University of California, Berkeley, [email protected] Brown - University of California, Berkeley, [email protected] Hung - University of California, Berkeley, [email protected] Smoot - University of California, Berkeley, [email protected]
Tutoriais de Tecnologia Web