lav2divx(1)
NAME
lav2divx - build a .AVI file based on lavtools-compatible
input.
SYNTAX
lav2divx [options] -o [output AVI] lavfile1 [lavfile2 ...
lavfileN]
DESCRIPTION
This utility reads lavtools-compatible files and uses them
to generate a .avi file using avifile.
Note that you must have avifile available in order to use
this utility. If building from a CVS snapshot or copy,
this will be detected at build time.
The input files may be any combination of AVI (.avi), Mov
tar (.movtar), Quicktime (.qt/.mov) or editlist files so
long as they are all lavtools-readable (e.g. MJPEG-encoded
AVI/Quicktime/Movtar or DV type 2 AVI).
OPTIONS
-o <filename>
- --outputfile <filename>
- Mandatory</fR> (except for --help, -V). The resulting encoded avi file is written to filename.
- -b <kbps>
- --divxbitrate <kbps>
- Specifies the output video bitrate (kilobits per
second). Default is 1800. - -a <kbps>
- --mp3bitrate <kbps>
- Specifies the output audio bitrate (kilobits per
second). Default is 56 for mono audio and 128 for
stereo. - -e <frames>
- --endframe <frames>
- Encode only frames frames. Default is to encode all
frames present in video on stdin (extra audio, if
available, is ignored). - -c <width>x<height>+<left>+<top>
- --crop <width>x<height>+<left>+<top>
- Include only the specified rectangle in the encoded
output. Default is no cropping, entire frame is
encoded. - -d <num>
- --droplsb <num>
- Drop the num least significant bits of each frame
(as a primitive noise control technique; you might
want to look at yuvdenoise for better results).
Default 0. - -n <num>
- --noise <num>
- Use a very simple noise filter. You should proba
bly use yuvdenoise instead. - -V
- --version
- Output version and exit.
- -s <rate>
- --forcedaudiorate <rate>
- Overrides audio rate (if audio is present). Should
only be used if rate is not correct in wav or input
lav file. (This option may disappear, I can no
longer find any cases where it is needed.) - -g
- --guess
- Attempt to guess the argument to use for -c. This
looks at the first 100 hundred frames and attempts
to determine where the transition from a black bor
der to active content occurs. It does not always
work (that's why it's a guess!) but can help narrow
the process down some. This is useful as an
invariant border can usually be discarded to
increase the available bandwidth for the active
portion of the frame. When using this option, the
utility exits after the first 100 frames. - -k <num>
- --keyframes <num>
- Sets the keyframes attribute of the video encoder.
Not all avifile encoders use this attribute, but
when an encoder does, the attribute specifies the
number of frames between keyframes. The default
depends on the codec being used. - -C <num>
- --crispness <num>
- Sets the crispness attribute of the video encoder.
Not all avifile encoders use this attribute. When
it is used, it affects how edges are detected and
encoded. I have found that higher values may cause
increased bandwidth usage with some codecs.
Default 50. - -E <fourcc>
- --encoder <fourcc>
- Specifies which video encoder to use. You must
specify the encoder using the "fourcc" of the
codec. The default is "DIV3". Common ones include: - MJPG - MJPEG (though why you'd use this utility for
this is a bit of a mystery) - DIV3 - Divx ;-) low motion
- DIV4 - Divx ;-) fast motion
- DIV5 - Divx ;-) low motion variable keyframe
- DIV6 - Divx ;-) fast motion variable keyframe
- There are many others. Consult your version of
avifile to see which ones might be available for
you. - -m
- --mono
- Performs a rather naive combination of stereo input
audio to monoaural. - -v <level>
- --verbose <level>
- Specifies the level of verbosity on output. All
output occurs to stderr. 2 shows progress and all
logging, 1 shows informative output and 0 shows
only important messages. - --help
- Display a brief summary of help and exit.
EXAMPLES
lav2divx -o output.avi -b 600 -E DIV5 input.eli input.avi
input.mov
BUGS
No checking or handling of large output avi files is per
formed (i.e. output files larger than 2 GiB may break on
your installation depending on a number of installa
tion-specific parameters).
Interlaced video isn't handled well.
<insert general pithy comment about additional hidden bugs
remaining here>
AUTHOR
- Shawn Sulma <lav2divx@athos.cx>
If you have questions, remarks, problems or you just want
to contact the developers, the main mailing list for the
MJPEG-tools is: - mjpeg-users@lists.sourceforge.net
- For more info, see our website at
- http://mjpeg.sourceforge.net/