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), Movtar (.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 probably 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 border 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 performed (i.e. output files larger than 2 GiB may break on your installation depending on a number of installation-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/

SEE ALSO

yuv2divx(1), lav2yuv(1), divxdec(1), lav2wav(1)