comparison DOCS/man/en/mplayer.1 @ 13894:7f22fdc992a4

Some work on the XviD section: - better divx5bvop description - "new" (no)packed and (no)closed_gop options explained - more appropriate wordings

13893:9f1c3cf149fe

.
.\" --------------------------------------------------------------------------
.\" Title
.\" --------------------------------------------------------------------------
.
.TH MPlayer 1 "2004-11-02" "The MPlayer Project" "The Movie Player"
.
.SH NAME
mplayer  \- movie player
.br
mencoder \- movie encoder

.B 4mv\ \ \ \ 
Use 4 motion vectors per macroblock.
This might give better compression, but slows down encoding.
.br
.I WARNING:
This option is deprecated in XviD-1.0.x, as all is now taken care of
by the me_quality option.
When me_quality > 4, 4mv is activated.
.
.TP
.B rc_reaction_delay_factor=<value>
This parameter controls the number of frames the CBR rate controller

CBR mode: min & max quantizer for all frames (default: 2\-31)
.br
2pass mode: min & max quantizer for I/\:P-frames (default: 2\-31/\:2\-31)
.br
.I WARNING:
This option is deprecated in XviD-1.0.x, and is replaced by the
[min|max]_[i|p|b]quant options.
.
.TP
.B min_key_interval=<value>
minimum interval between keyframes (default: 0, 2pass only)

For high bitrates, you will find that MPEG quantization preserves more detail.
For low bitrates, the smoothing of H.263 will give you less block noise.
When using custom matrices, MPEG must be used.
.br
.I WARNING:
This option is deprecated in XviD-1.0.x, and is replaced by the quant_type
option.
.
.TP
.B mod_quant
Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis
(2pass mode only).

.I WARNING:
This will generate an illegal bitstream, and most likely not be decodable
by any MPEG4 decoder besides libavcodec or XviD.
.br
.I WARNING:
This option is deprecated in XviD-1.0.x.
.
.TP
.B keyframe_boost=<0\-1000>
Shift some bits from the pool for other frame types to intra frames,
thus improving keyframe quality.

kfreduction determines the bitrate reduction they get.
The last I-frame will get treated normally.
(default: 30, 2pass mode only)
.
.TP
.B (no)greyscale
Make XviD discard chroma planes so the encoded video is greyscale only.
Note that this does not speed up encoding, it just prevents chroma data
from being written in the last stage of encoding.
.

The following options are only available with the latest stable
releases of XviD 1.0.x (api4).
.
.TP
.B (no)packed
Create a bitstream which can be decoded delay-free.
.br
.I WARNING:
This will generate an illegal bitstream, and will not be
decodable by ISO-MPEG4 decoders except DivX/\:libavcodec/\:XviD.
.br
.I WARNING:
This will also store a fake DivX version in the file so the bug
autodetection of some decoders might be confused.
.
.TP
.B divx5bvop
Generate DivX5 compatible B-frames (default: on).
.
.TP
.B max_bframes=<0\-4>
Maximum number of B-frames to put between I/\:P-frames (default: 0).
.

surrounding the man and his mouth is completely static).
This setting allows you to specify what priority to place on the use of
B-frames.
The higher the value, the higher the probability of B-frames being used.
(default: 0)
.
.TP
.B frame_drop_ratio=<0\-100> (max_bframes=0 only)
This setting allows the creation of variable framerate video streams.
The value of the setting specifies a threshold under which, if the

13894:7f22fdc992a4

.
.\" --------------------------------------------------------------------------
.\" Title
.\" --------------------------------------------------------------------------
.
.TH MPlayer 1 "2004-11-07" "The MPlayer Project" "The Movie Player"
.
.SH NAME
mplayer  \- movie player
.br
mencoder \- movie encoder

.B 4mv\ \ \ \ 
Use 4 motion vectors per macroblock.
This might give better compression, but slows down encoding.
.br
.I WARNING:
As of XviD-1.0.x, this option is no longer available separately, and its
functionality is included in the me_quality option.
When me_quality > 4, 4mv is activated.
.
.TP
.B rc_reaction_delay_factor=<value>
This parameter controls the number of frames the CBR rate controller

CBR mode: min & max quantizer for all frames (default: 2\-31)
.br
2pass mode: min & max quantizer for I/\:P-frames (default: 2\-31/\:2\-31)
.br
.I WARNING:
As of XviD-1.0.x, this option is replaced by the
[min|max]_[i|p|b]quant options.
.
.TP
.B min_key_interval=<value>
minimum interval between keyframes (default: 0, 2pass only)

For high bitrates, you will find that MPEG quantization preserves more detail.
For low bitrates, the smoothing of H.263 will give you less block noise.
When using custom matrices, MPEG must be used.
.br
.I WARNING:
As of XviD-1.0.x, this option is replaced by the quant_type option.
.
.TP
.B mod_quant
Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis
(2pass mode only).

.I WARNING:
This will generate an illegal bitstream, and most likely not be decodable
by any MPEG4 decoder besides libavcodec or XviD.
.br
.I WARNING:
As of XviD-1.0.x, this option is no longer available.
.
.TP
.B keyframe_boost=<0\-1000>
Shift some bits from the pool for other frame types to intra frames,
thus improving keyframe quality.

kfreduction determines the bitrate reduction they get.
The last I-frame will get treated normally.
(default: 30, 2pass mode only)
.
.TP
.B divx5bvop
Generate DivX5 compatible B-frames (default: on).
This seems to be mandatory only for old versions of DivX's decoder.
.br
.I WARNING:
As of XviD-1.0.x, this option is replaced by the closed_gop option.
.
.TP
.B (no)greyscale
Make XviD discard chroma planes so the encoded video is greyscale only.
Note that this does not speed up encoding, it just prevents chroma data
from being written in the last stage of encoding.
.

The following options are only available with the latest stable
releases of XviD 1.0.x (api4).
.
.TP
.B (no)packed
This option is meant to solve frame-order issues when encoding to
container formats like AVI that cannot cope with out-of-order frames.
In practise, most decoders (both software and hardware) are able to deal
with frame-order themselves, and may get confused when this option is
turned on, so you can safely leave if off, unless you really know what
you are doing.
.br
.I WARNING:
This will generate an illegal bitstream, and will not be
decodable by ISO-MPEG4 decoders except DivX/\:libavcodec/\:XviD.
.br
.I WARNING:
This will also store a fake DivX version in the file so the bug
autodetection of some decoders might be confused.
.
.TP
.B max_bframes=<0\-4>
Maximum number of B-frames to put between I/\:P-frames (default: 0).
.

surrounding the man and his mouth is completely static).
This setting allows you to specify what priority to place on the use of
B-frames.
The higher the value, the higher the probability of B-frames being used.
(default: 0)
.
.TP
.B (no)closed_gop
This option tells XviD to close every GOP (Group Of Pictures bounded
by two I-frames), which makes GOPs independent from each other.
This just implies that the last frame of the GOP is eiter a P-frame or a
N-frame but not a B-frame.
It is usually a good idea to turn this option on (default: on).
.
.TP
.B frame_drop_ratio=<0\-100> (max_bframes=0 only)
This setting allows the creation of variable framerate video streams.
The value of the setting specifies a threshold under which, if the