comparison DOCS/man/en/mplayer.1 @ 26731:c14608941385

Remove '(pass 1/2)' from some lavcopts. These options really worked on all passes, and most options that worked on all passes weren't marked at all. It's valid to assume that any option not marked otherwise will work on all passes.

26730:41794a5fb100

.RE
.PD 1
.
.TP
.B vqmin=<1\-31>
minimum quantizer (pass 1/2)
.RSs
.IPs 1
Not recommended (much larger file, little quality difference and weird side
effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused
resulting in lower quality and some decoders will not be able to decode it).

effect.
1 is not recommended (see vqmin for details).
.
.TP
.B vqmax=<1\-31>
Maximum quantizer (pass 1/2), 10\-31 should be a sane range (default: 31).
.
.TP
.B mbqmin=<1\-31>
obsolete, use vqmin
.

obsolete, use vqmax
.
.TP
.B vqdiff=<1\-31>
maximum quantizer difference between consecutive I- or P-frames
(pass 1/2) (default: 3)
.
.TP
.B vmax_b_frames=<0\-4>
maximum number of B-frames between non-B-frames:
.PD 0

Does not incur a performance penalty, so you can safely leave it
always on.
.
.TP
.B vbitrate=<value>
Specify bitrate (pass 1/2) (default: 800).
.br
.I WARNING:
1kbit = 1000 bits
.PD 0
.RSs

vratetol should not be too large during the second pass or there might
be problems if vrc_(min|max)rate is used.
.
.TP
.B vrc_maxrate=<value>
maximum bitrate in kbit/\:sec (pass 1/2)
(default: 0, unlimited)
.
.TP
.B vrc_minrate=<value>
minimum bitrate in kbit/\:sec (pass 1/2)
(default: 0, unlimited)
.
.TP
.B vrc_buf_size=<value>
buffer size in kbit (pass 1/2).
For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD,
917 for SVCD and 1835 for DVD.
.
.TP
.B vrc_buf_aggressivity

.RE
.PD 1
.
.TP
.B vb_qfactor=<\-31.0\-31.0>
quantizer factor between B- and non-B-frames (pass 1/2) (default: 1.25)
.
.TP
.B vi_qfactor=<\-31.0\-31.0>
quantizer factor between I- and non-I-frames (pass 1/2) (default: 0.8)
.
.TP
.B vb_qoffset=<\-31.0\-31.0>
quantizer offset between B- and non-B-frames (pass 1/2) (default: 1.25)
.
.TP
.B vi_qoffset=<\-31.0\-31.0>
(pass 1/2) (default: 0.0)
.br
if v{b|i}_qfactor > 0
.br
I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
.br

Quantizer gaussian blur (default: 0.5), larger values will average
the quantizer more over time (slower change).
.
.TP
.B vqcomp=<0.0\-1.0>
Quantizer compression, vrc_eq depends upon this (pass 1/2) (default: 0.5).
For instance, assuming the default rate control equation is used,
if vqcomp=1.0, the ratecontrol allocates to each frame the number of bits
needed to encode them all at the same QP.
If vqcomp=0.0, the ratecontrol allocates the same number of bits to each
frame, i.e. strict CBR.

Those are extreme settings and should never be used.
Perceptual quality will be optimal somewhere in between these two extremes.
.
.TP
.B vrc_eq=<equation>
main ratecontrol equation (pass 1/2)
.RE
.RSs
.IPs "1\ \ \ \ "
constant bitrate
.IPs "tex\ \ "

.IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
.RE
.
.TP
.B vrc_override=<options>
User specified quality for specific parts (ending, credits, ...) (pass 1/2).
The options are <start-frame>, <end-frame>, <quality>[/<start-frame>,
<end-frame>, <quality>[/...]]:
.PD 0
.RSs
.IPs "quality (2\-31)"

.B vrc_init_occupancy=<0.0\-1.0>
initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9)
.
.TP
.B vqsquish=<0|1>
Specify how to keep the quantizer between qmin and qmax (pass 1/2).
.PD 0
.RSs
.IPs 0
Use clipping.
.IPs 1

26731:c14608941385

.RE
.PD 1
.
.TP
.B vqmin=<1\-31>
minimum quantizer
.RSs
.IPs 1
Not recommended (much larger file, little quality difference and weird side
effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused
resulting in lower quality and some decoders will not be able to decode it).

effect.
1 is not recommended (see vqmin for details).
.
.TP
.B vqmax=<1\-31>
Maximum quantizer, 10\-31 should be a sane range (default: 31).
.
.TP
.B mbqmin=<1\-31>
obsolete, use vqmin
.

obsolete, use vqmax
.
.TP
.B vqdiff=<1\-31>
maximum quantizer difference between consecutive I- or P-frames
(default: 3)
.
.TP
.B vmax_b_frames=<0\-4>
maximum number of B-frames between non-B-frames:
.PD 0

Does not incur a performance penalty, so you can safely leave it
always on.
.
.TP
.B vbitrate=<value>
Specify bitrate (default: 800).
.br
.I WARNING:
1kbit = 1000 bits
.PD 0
.RSs

vratetol should not be too large during the second pass or there might
be problems if vrc_(min|max)rate is used.
.
.TP
.B vrc_maxrate=<value>
maximum bitrate in kbit/\:sec
(default: 0, unlimited)
.
.TP
.B vrc_minrate=<value>
minimum bitrate in kbit/\:sec
(default: 0, unlimited)
.
.TP
.B vrc_buf_size=<value>
buffer size in kbit
For MPEG-1/2 this also sets the vbv buffer size, use 327 for VCD,
917 for SVCD and 1835 for DVD.
.
.TP
.B vrc_buf_aggressivity

.RE
.PD 1
.
.TP
.B vb_qfactor=<\-31.0\-31.0>
quantizer factor between B- and non-B-frames (default: 1.25)
.
.TP
.B vi_qfactor=<\-31.0\-31.0>
quantizer factor between I- and non-I-frames (default: 0.8)
.
.TP
.B vb_qoffset=<\-31.0\-31.0>
quantizer offset between B- and non-B-frames (default: 1.25)
.
.TP
.B vi_qoffset=<\-31.0\-31.0>
(default: 0.0)
.br
if v{b|i}_qfactor > 0
.br
I/B-frame quantizer = P-frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
.br

Quantizer gaussian blur (default: 0.5), larger values will average
the quantizer more over time (slower change).
.
.TP
.B vqcomp=<0.0\-1.0>
Quantizer compression, vrc_eq depends upon this (default: 0.5).
For instance, assuming the default rate control equation is used,
if vqcomp=1.0, the ratecontrol allocates to each frame the number of bits
needed to encode them all at the same QP.
If vqcomp=0.0, the ratecontrol allocates the same number of bits to each
frame, i.e. strict CBR.

Those are extreme settings and should never be used.
Perceptual quality will be optimal somewhere in between these two extremes.
.
.TP
.B vrc_eq=<equation>
main ratecontrol equation
.RE
.RSs
.IPs "1\ \ \ \ "
constant bitrate
.IPs "tex\ \ "

.IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
.RE
.
.TP
.B vrc_override=<options>
User specified quality for specific parts (ending, credits, ...).
The options are <start-frame>, <end-frame>, <quality>[/<start-frame>,
<end-frame>, <quality>[/...]]:
.PD 0
.RSs
.IPs "quality (2\-31)"

.B vrc_init_occupancy=<0.0\-1.0>
initial buffer occupancy, as a fraction of vrc_buf_size (default: 0.9)
.
.TP
.B vqsquish=<0|1>
Specify how to keep the quantizer between qmin and qmax.
.PD 0
.RSs
.IPs 0
Use clipping.
.IPs 1