Browse code

Improve documentation for the -pass and -passlog options. Add mention to how the log file is used and specify the default log file name.

Originally committed as revision 15969 to svn://svn.ffmpeg.org/ffmpeg/trunk

Stefano Sabatini authored on 2008/12/01 17:27:53
Showing 1 changed files
... ...
@@ -439,10 +439,11 @@ tell that the raw codec data must be copied as is.
439 439
 Use same video quality as source (implies VBR).
440 440
 
441 441
 @item -pass @var{n}
442
-Select the pass number (1 or 2). It is useful to do two pass
443
-encoding. The statistics of the video are recorded in the first
444
-pass and the video is generated at the exact requested bitrate
445
-in the second pass.
442
+Select the pass number (1 or 2). It is used to do two-pass
443
+video encoding. The statistics of the video are recorded in the first
444
+pass into a log file (see also the option -passlogfile),
445
+and in the second pass that log file is used to generate the video
446
+at the exact requested bitrate.
446 447
 On pass 1, you may just deactivate audio and set output to null,
447 448
 examples for Windows and Unix:
448 449
 @example
... ...
@@ -451,7 +452,9 @@ ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y /dev/null
451 451
 @end example
452 452
 
453 453
 @item -passlogfile @var{file}
454
-Set two pass logfile name to @var{file}.
454
+Set two-pass log file name to @var{file}. Default name is
455
+@file{ffmpeg2pass-N.log}, where N is a number specific to the output
456
+stream.
455 457
 
456 458
 @item -newvideo
457 459
 Add a new video stream to the current output stream.