Hello,

Some users were confused about lavcopts marked as '(pass 1/2)' in the
man page:

>> 5.  Are all of the options that are noted with (pass 1/2) in the man
>> disabled if you include them in the second pass? Or can they be
>> detrimental if you include them on a second pass?
>
> Generally it's safest (though slow) if pass 2 uses exactly the same
> parameters as pass 1. Using different parameters can (depending on the
> parameters) result in inexact statistics.
> I'm not sure what (pass 1/2) means - perhaps it's something to do with
> pass=3 encodings. Pass=3 works differently, perhaps it just doesn't
> need/use the parameters marked (pass 1/2)? Anybody know?

I can see why they were confused. I think the '(pass 1/2)' marks should
just be removed.

* actually, those options work with pass 1/2/3/4/5...
* it's a natural assumption that options work with all passes unless
  marked otherwise
* only a few of those options are currently marked '(pass 1/2)' right
  now anyway

Any objections?

-Corey
Index: DOCS/man/en/mplayer.1
===================================================================
--- DOCS/man/en/mplayer.1       (revision 26753)
+++ DOCS/man/en/mplayer.1       (working copy)
@@ -7720,7 +7720,7 @@
 .
 .TP
 .B vqmin=<1\-31>
-minimum quantizer (pass 1/2)
+minimum quantizer
 .RSs
 .IPs 1
 Not recommended (much larger file, little quality difference and weird side
@@ -7778,7 +7778,7 @@
 .
 .TP
 .B vqmax=<1\-31>
-Maximum quantizer (pass 1/2), 10\-31 should be a sane range (default: 31).
+Maximum quantizer, 10\-31 should be a sane range (default: 31).
 .
 .TP
 .B mbqmin=<1\-31>
@@ -7791,7 +7791,7 @@
 .TP
 .B vqdiff=<1\-31>
 maximum quantizer difference between consecutive I- or P-frames
-(pass 1/2) (default: 3)
+(default: 3)
 .
 .TP
 .B vmax_b_frames=<0\-4>
@@ -8058,7 +8058,7 @@
 .
 .TP
 .B vbitrate=<value>
-Specify bitrate (pass 1/2) (default: 800).
+Specify bitrate (default: 800).
 .br
 .I WARNING:
 1kbit = 1000 bits
@@ -8084,17 +8084,17 @@
 .
 .TP
 .B vrc_maxrate=<value>
-maximum bitrate in kbit/\:sec (pass 1/2)
+maximum bitrate in kbit/\:sec
 (default: 0, unlimited)
 .
 .TP
 .B vrc_minrate=<value>
-minimum bitrate in kbit/\:sec (pass 1/2)
+minimum bitrate in kbit/\:sec
 (default: 0, unlimited)
 .
 .TP
 .B vrc_buf_size=<value>
-buffer size in kbit (pass 1/2).
+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.
 .
@@ -8119,19 +8119,19 @@
 .
 .TP
 .B vb_qfactor=<\-31.0\-31.0>
-quantizer factor between B- and non-B-frames (pass 1/2) (default: 1.25)
+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 (pass 1/2) (default: 0.8)
+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 (pass 1/2) (default: 1.25)
+quantizer offset between B- and non-B-frames (default: 1.25)
 .
 .TP
 .B vi_qoffset=<\-31.0\-31.0>
-(pass 1/2) (default: 0.0)
+(default: 0.0)
 .br
 if v{b|i}_qfactor > 0
 .br
@@ -8167,7 +8167,7 @@
 .
 .TP
 .B vqcomp=<0.0\-1.0>
-Quantizer compression, vrc_eq depends upon this (pass 1/2) (default: 0.5).
+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.
@@ -8179,7 +8179,7 @@
 .
 .TP
 .B vrc_eq=<equation>
-main ratecontrol equation (pass 1/2)
+main ratecontrol equation
 .RE
 .RSs
 .IPs "1\ \ \ \ "
@@ -8252,7 +8252,7 @@
 .
 .TP
 .B vrc_override=<options>
-User specified quality for specific parts (ending, credits, ...) (pass 1/2).
+User specified quality for specific parts (ending, credits, ...).
 The options are <start-frame>, <end-frame>, <quality>[/<start-frame>,
 <end-frame>, <quality>[/...]]:
 .PD 0
@@ -8274,7 +8274,7 @@
 .
 .TP
 .B vqsquish=<0|1>
-Specify how to keep the quantizer between qmin and qmax (pass 1/2).
+Specify how to keep the quantizer between qmin and qmax.
 .PD 0
 .RSs
 .IPs 0
_______________________________________________
MPlayer-DOCS mailing list
[email protected]
https://lists.mplayerhq.hu/mailman/listinfo/mplayer-docs

Reply via email to