mirror of https://github.com/mpv-player/mpv
XviD option descriptions, patch by Guillaume POIRIER <gpoirier@irisa.fr>
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@12979 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
parent
3975310f95
commit
57017402ed
|
@ -5440,76 +5440,106 @@ specify the pass in 2pass mode
|
||||||
.B bitrate=<value>
|
.B bitrate=<value>
|
||||||
sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second
|
sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second
|
||||||
if >16000
|
if >16000
|
||||||
(CBR or 2pass mode, default=687 kbits/s)
|
(CBR or 2pass mode, default: 687 kbits/s)
|
||||||
.TP
|
.TP
|
||||||
.B fixed_quant=<1\-31>
|
.B fixed_quant=<1\-31>
|
||||||
switch to fixed quantizer mode and specify the quantizer to be used
|
switch to fixed quantizer mode and specify the quantizer to be used
|
||||||
.TP
|
.TP
|
||||||
.B me_quality=<0\-6>
|
.B me_quality=<0\-6>
|
||||||
specify the motion detection quality (default=6)
|
This option controls the motion estimation subsystem.
|
||||||
|
The higher the value, the more precise the estimation should be.
|
||||||
|
The more precise the motion estimation is, the more bits can be saved.
|
||||||
|
Precision is gained at the expense of CPU time so decrease this setting if
|
||||||
|
you need realtime encoding.
|
||||||
|
(default: 6)
|
||||||
.TP
|
.TP
|
||||||
.B interlacing
|
.B interlacing
|
||||||
enable support for interlaced content (default=off)
|
For interlaced video material, turn this option on.
|
||||||
|
.I Note:
|
||||||
|
This option does not deinterlace video, it encodes it field-based
|
||||||
|
(default: off).
|
||||||
.TP
|
.TP
|
||||||
.B 4mv\ \ \ \
|
.B 4mv\ \ \ \
|
||||||
use 4 motion vectors per macro-block, might give better compression at the
|
use 4 motion vectors per macro-block, might give better compression at the
|
||||||
cost of a slower encoding (default=off)
|
cost of a slower encoding (default: off).
|
||||||
|
.br
|
||||||
|
.I WARNING:
|
||||||
|
This option doesn't exist in XviD-1.0.x.
|
||||||
.TP
|
.TP
|
||||||
.B rc_reaction_delay_factor=<value>
|
.B rc_reaction_delay_factor=<value>
|
||||||
specify how fast the rate control reacts, lower values are faster
|
This parameter controls the delay in frames before the CBR rate controller
|
||||||
|
will react to bitrate changes and will try to compensate the change to obtain
|
||||||
|
a constant bitrate over an averaging range of frames.
|
||||||
.TP
|
.TP
|
||||||
.B rc_averaging_period=<value>
|
.B rc_averaging_period=<value>
|
||||||
period to reach the required average
|
Real CBR is hard to achieve.
|
||||||
|
Depending on the video material, bitrate can be variable, and hard to predict.
|
||||||
|
That's why XviD uses an averaging period for which it guarantees a given
|
||||||
|
amount of bits (minus a small variation).
|
||||||
|
This settings expresses the "number of frames" for which XviD averages
|
||||||
|
bitrate and tries to achieve CBR.
|
||||||
.TP
|
.TP
|
||||||
.B rc_buffer=<value>
|
.B rc_buffer=<value>
|
||||||
size of the rate control buffer
|
size of the rate control buffer
|
||||||
.TP
|
.TP
|
||||||
.B quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>]
|
.B quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>]
|
||||||
min & max quantizer for all frames (default=2\-31, CBR mode)
|
min & max quantizer for all frames (default: 2\-31, CBR mode)
|
||||||
.br
|
.br
|
||||||
min & max quantizer for I/P frames (default=2\-31/2\-31, 2pass mode)
|
min & max quantizer for I/P frames (default: 2\-31/2\-31, 2pass mode)
|
||||||
.TP
|
.TP
|
||||||
.B min_key_interval=<value>
|
.B min_key_interval=<value>
|
||||||
minimum interval between key frames (default=0, 2pass only)
|
minimum interval between key frames (default: 0, 2pass only)
|
||||||
.TP
|
.TP
|
||||||
.B max_key_interval=<value>
|
.B max_key_interval=<value>
|
||||||
maximum interval between key frames (default=10*fps)
|
maximum interval between key frames (default: 10*fps)
|
||||||
.TP
|
.TP
|
||||||
.B mpeg_quant
|
.B mpeg_quant
|
||||||
use MPEG quantizers instead of H.263 (default=off)
|
use MPEG quantizers instead of H.263.
|
||||||
|
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.
|
||||||
|
(default: off)
|
||||||
.TP
|
.TP
|
||||||
.B mod_quant
|
.B mod_quant
|
||||||
decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis.
|
decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis.
|
||||||
(default=off, 2pass mode only)
|
(default: off, 2pass mode only)
|
||||||
.TP
|
.TP
|
||||||
.B greyscale
|
.B greyscale
|
||||||
encode in black & white (default=off)
|
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.
|
||||||
|
(default: off)
|
||||||
.TP
|
.TP
|
||||||
.B debug\ \
|
.B debug\ \
|
||||||
Save per-frame statistics in xvid.dbg (default=off).
|
Save per-frame statistics in ./xvid.dbg (default: off).
|
||||||
This is NOT the 2pass control file.
|
This is NOT the 2pass control file.
|
||||||
.TP
|
.TP
|
||||||
.B keyframe_boost=<0\-1000>
|
.B keyframe_boost=<0\-1000>
|
||||||
(default=0, 2pass mode only)
|
Shift some bits from the pool for other frame types to intra frames,
|
||||||
|
thus improving keyframe quality.
|
||||||
|
(default: 0, 2pass mode only)
|
||||||
.TP
|
.TP
|
||||||
.B kfthreshold=<value>
|
.B kfthreshold=<value>
|
||||||
(default=10, 2pass mode only)
|
(default: 10, 2pass mode only)
|
||||||
.TP
|
.TP
|
||||||
.B kfreduction=<0\-100>
|
.B kfreduction=<0\-100>
|
||||||
(default=30, 2pass mode only)
|
The above two settings can be used to adjust the size of keyframes that
|
||||||
|
you consider too close to the first (in a row).
|
||||||
|
kfthreshold sets the range in which keyframes are reduced, and
|
||||||
|
kfreduction determines the bitrate reduction they get.
|
||||||
|
The last i-frame will get treated normally.
|
||||||
|
(default: 30, 2pass mode only)
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
|
|
||||||
The following options are only available with the latest stable
|
The following options are only available with the latest stable
|
||||||
XviD 0.9.2 (api3) version and are marked as experimental and unstable.
|
releases of XviD 1.0.x (api4).
|
||||||
The newest development version of XviD 1.0 (api4) supports
|
|
||||||
them fully.
|
|
||||||
.TP
|
.TP
|
||||||
.B packed\
|
.B packed\
|
||||||
create a bitstream that can be decoded delay-free (default=off)
|
create a bitstream that can be decoded delay-free (default: off)
|
||||||
.br
|
.br
|
||||||
.I WARNING:
|
.I WARNING:
|
||||||
this will generate an illegal bitstream, and WILL NOT be
|
this will generate an illegal bitstream, and WILL NOT be
|
||||||
decodeable by ISO-MPEG4 decoders except DivX/libavcodec/XviD
|
decodeable by ISO-MPEG4 decoders except DivX/libavcodec/XviD
|
||||||
.br
|
.br
|
||||||
.I WARNING:
|
.I WARNING:
|
||||||
|
@ -5517,40 +5547,84 @@ this will also store a fake DivX version in the file so the bug
|
||||||
autodetection of some decoders might be confused
|
autodetection of some decoders might be confused
|
||||||
.TP
|
.TP
|
||||||
.B divx5bvop
|
.B divx5bvop
|
||||||
generate DivX5 compatible B-frames (default=on)
|
generate DivX5 compatible B-frames (default: on)
|
||||||
.TP
|
.TP
|
||||||
.B qpel\ \ \
|
.B qpel\ \ \
|
||||||
enable quarter-pixel motion estimation (default=off)
|
MPEG4 uses a half pixel precision for its motion search by default.
|
||||||
|
The standard proposes a mode where encoders are allowed to use quarter
|
||||||
|
pixel precision.
|
||||||
|
This option usually results in a sharper image.
|
||||||
|
Unfortunately it has a great impact on bitrate and sometimes the
|
||||||
|
higher bitrate use will prevent it from giving a better image
|
||||||
|
quality at a fixed bitrate.
|
||||||
|
It's better to test with and without this option and see whether it
|
||||||
|
is worth activating.
|
||||||
|
(default: off)
|
||||||
.TP
|
.TP
|
||||||
.B gmc\ \ \ \
|
.B gmc\ \ \ \
|
||||||
enable global motion compensation, may save bits on panning scenes (default=off)
|
Enable Global Motion Compensation, which makes XviD generate Sprite
|
||||||
|
Frames which best describe Pan/Zoom/Rotating images.
|
||||||
|
The decision whether to activate this option or not to save bits
|
||||||
|
depends highly on the video material.
|
||||||
|
(default: off)
|
||||||
|
.TP
|
||||||
|
.B trellis
|
||||||
|
Trellis Quantization is a kind of adaptive quantization method that
|
||||||
|
saves bits by modifying quantized coefficients to make them more
|
||||||
|
compressible by the entropy encoder.
|
||||||
|
Its impact on quality is good, and if VHQ uses too much CPU for you,
|
||||||
|
this setting can be a good alternative to save a few bits (and gain
|
||||||
|
quality at fixed bitrate) at a lesser cost than with VHQ (default: off).
|
||||||
|
.TP
|
||||||
|
.B cartoon
|
||||||
|
Activate this if your encoded sequence is an anime/cartoon.
|
||||||
|
It modifies some XviD internal thresholds so XviD takes better decisions on
|
||||||
|
frame types and motion vectors for flat looking cartoons.
|
||||||
.TP
|
.TP
|
||||||
.B chroma_me
|
.B chroma_me
|
||||||
uses chroma information to estimate motion (default=off)
|
The usual motion estimation algorithm uses only the luminance information to
|
||||||
|
find the best motion vector.
|
||||||
|
However for some video material, using the chroma planes can help find
|
||||||
|
better vectors.
|
||||||
|
This setting toggles the use of chroma planes for motion estimation
|
||||||
|
(default: off).
|
||||||
.TP
|
.TP
|
||||||
.B chroma_opt
|
.B chroma_opt
|
||||||
enable a chroma optimizer prefilter (default=off)
|
enable a chroma optimizer prefilter (default: off)
|
||||||
.TP
|
.TP
|
||||||
.B reduced
|
.B reduced
|
||||||
enable encoding reduced resolution frames (default=off)
|
enable encoding reduced resolution frames (default: off)
|
||||||
.TP
|
.TP
|
||||||
.B max_bframes=<0\-4>
|
.B max_bframes=<0\-4>
|
||||||
maximum number of B frames to put between I/P frames (default=0)
|
maximum number of B frames to put between I/P frames (default: 0)
|
||||||
.TP
|
.TP
|
||||||
.B bquant_ratio=<0\-1000>
|
.B bquant_ratio=<0\-1000>
|
||||||
quantizer ratio between B and non B frames, 150=1.50 (default=150)
|
quantizer ratio between B and non B frames, 150=1.50 (default: 150)
|
||||||
.TP
|
.TP
|
||||||
.B bquant_offset=<-1000\-1000>
|
.B bquant_offset=<-1000\-1000>
|
||||||
quantizer offset between B and non B frames, 100=1.00 (default=100)
|
quantizer offset between B and non B frames, 100=1.00 (default: 100)
|
||||||
.TP
|
.TP
|
||||||
.B bf_threshold=<-255\-255>
|
.B bf_threshold=<-255\-255>
|
||||||
change the probability of a frame to be a bframe (default=0)
|
Sometimes B frames do not look good, and introduce artifacts when most of
|
||||||
|
the frame is static and some small zones have high motion (in a static
|
||||||
|
scene with a man talking, his mouth will probably look bad if what is
|
||||||
|
surrounding the man and his mouth is completly static).
|
||||||
|
This setting allows you to favorize or not, the use of B frames.
|
||||||
|
The higher the value, the higher the probability of B frames being used.
|
||||||
|
(default: 0)
|
||||||
.TP
|
.TP
|
||||||
.B hq_ac\ \
|
.B hq_ac\ \
|
||||||
enable a better prediction of AC component (default=off)
|
Activates High Quality AC coefficient prediction from neighbor blocks.
|
||||||
|
(default:off)
|
||||||
.TP
|
.TP
|
||||||
.B vhq=<0\-4>
|
.B vhq=<0\-4>
|
||||||
enable a higher quality ME search using DCT, faster to slower:
|
The motion search algorithm is based on a search in the usual color domain
|
||||||
|
and tries to find a motion vector that minimizes the difference between the
|
||||||
|
reference frame and the encoded frame.
|
||||||
|
With this setting activated, XviD will also use the frequency domain (DCT)
|
||||||
|
to search for a motion vector that minimizes not only the spatial
|
||||||
|
difference but also the encoding length of the block.
|
||||||
|
Fastest to slowest:
|
||||||
.PD 0
|
.PD 0
|
||||||
.RSs
|
.RSs
|
||||||
.IPs 0
|
.IPs 0
|
||||||
|
@ -5569,8 +5643,8 @@ wide search
|
||||||
.B aspect=<x/y | f (float value)>
|
.B aspect=<x/y | f (float value)>
|
||||||
Store movie aspect internally, just like MPEG files.
|
Store movie aspect internally, just like MPEG files.
|
||||||
Much nicer solution than rescaling, because quality isn't decreased.
|
Much nicer solution than rescaling, because quality isn't decreased.
|
||||||
MPlayer and few others players will play these files correctly, others will display
|
MPlayer and a few others players will play these files correctly, others
|
||||||
them with the wrong aspect.
|
will display them with the wrong aspect.
|
||||||
The aspect parameter can be given as a ratio or a floating point number.
|
The aspect parameter can be given as a ratio or a floating point number.
|
||||||
.TP
|
.TP
|
||||||
.B autoaspect
|
.B autoaspect
|
||||||
|
@ -5580,7 +5654,8 @@ filter chain.
|
||||||
.TP
|
.TP
|
||||||
.B psnr\ \ \
|
.B psnr\ \ \
|
||||||
Print the psnr (peak signal to noise ratio) for the whole video after encoding
|
Print the psnr (peak signal to noise ratio) for the whole video after encoding
|
||||||
and store the per frame psnr in a file with a name like 'psnr_hhmmss.log'.
|
and store the per frame psnr in a file with a name like 'psnr_hhmmss.log' in
|
||||||
|
the current directory.
|
||||||
Returned values are in dB (decibel), the higher the better.
|
Returned values are in dB (decibel), the higher the better.
|
||||||
.
|
.
|
||||||
.
|
.
|
||||||
|
|
Loading…
Reference in New Issue