# HG changeset patch # User gabucino # Date 1019666857 0 # Node ID 7c6cf46a44ced4b730083b0d871e08b69ce26cf5 # Parent 8a357300d0ecf03528968fb0dd7c35df56d8d1a8 applied 2 patches diff -r 8a357300d0ec -r 7c6cf46a44ce DOCS/documentation.html --- a/DOCS/documentation.html Wed Apr 24 15:36:07 2002 +0000 +++ b/DOCS/documentation.html Wed Apr 24 16:47:37 2002 +0000 @@ -676,18 +676,58 @@

1.5. Subtitles and OSD

-

Yes, MPlayer also supports many kinds of subtitles. Currently -10 kinds of subtitle can be used by the subreader code. To see what are -these subtitle formats, see subreader.c, line ~30.

+

+MPlayer can display subtitles along with movie files. Currently the following +formats are supported: +

+The command line options differ slightly for the different formats: +

-

MPlayer supports VobSub subtitles. VobSub subtitles consist of -a big (some megabytes) .SUB file, and optional .IDX and/or .IFO files. +

+VobSub subtitles
+VobSub subtitles consist of a big (some megabytes) .SUB file, and optional +.IDX and/or .IFO files.
Usage : if you have files like sample.sub, sample.ifo, sample.idx - you have to pass the -vobsub sample -vobsubid -0 options (optionally with pathname, of course). The +<id> options (optionally with pathname, of course). The -vobsubid option is like -sid for DVDs, you can choose between subtitle tracks (languages) with it.

+

+Other subtitles
+The other formats consist of a single text file containing timing, placement +and text information.
+Usage : if you have a file like sample.txt, you have to pass +the option -sub sample.txt (optionally with pathname, of course). +

+ +

+Adjusting subtitle timing and placement
+ +-subdelay <sec> : Delays subtitles by <sec> seconds. Can be negative.
+-subfps <rate> : Specify frame/sec rate of subtitle file (float number)
+-subpos <0 - 100> : Specify the position of subtitles.
+

+

+If you experience a growing delay between the movie and the subtitles when using a MicroDVD +subtitle file, most likely the frame rate of the movie and the subtitle file are different.
+Please note that the MicroDVD subtitle format uses absolute frame numbers for its +timing, and therefore the -subfps option cannot be used with this format. As +MPlayer has no way to guess the frame rate of the subtitle file, you have to manually +convert the frame rate. There is a little perl script in the contrib directory of +the MPlayer ftp site to do this conversation for you. +

About DVD subtitles, read the DVD section.

MPlayer introduces a new subtitle format called MPsub. diff -r 8a357300d0ec -r 7c6cf46a44ce DOCS/encoding.html --- a/DOCS/encoding.html Wed Apr 24 15:36:07 2002 +0000 +++ b/DOCS/encoding.html Wed Apr 24 16:47:37 2002 +0000 @@ -168,6 +168,23 @@ -divx4opts br=1100 -oac copy -o movie.avi -pass 2

+

2 or 3-pass encoding using internal libavcodec controler : +Optionally you can use libavcodec's internal 2 or 3-pass mode, it may gives you +better final rate accuracy than using the external, DivX4-inspired 2-pass rate +controler with libavcodec.
+

+

2.4.3.2. Rescaling movies

diff -r 8a357300d0ec -r 7c6cf46a44ce DOCS/mencoder.1 --- a/DOCS/mencoder.1 Wed Apr 24 15:36:07 2002 +0000 +++ b/DOCS/mencoder.1 Wed Apr 24 16:47:37 2002 +0000 @@ -194,32 +194,132 @@ Available options: help get help - vcodec=XXX use the specified codec - (for full list, see html doc!) + + vcodec=XXX use the specified codec : + mjpeg - Motion JPEG + h263 - H263 + h263p - H263 Plus + mpeg4 - DivX 4/5 + msmpeg4 - DivX 3 + rv10 - an old RealVideo codec + mpeg1video - MPEG1 video :) + There's no default, you must + specify it. + vbitrate=XXX specify bitrate in kbit <4-16000> or bit <16001-24000000> + (warning: 1kbit = 1000 bits) + default = 800k + + vratetol=XXX approximated *filesize* tolerance + in bits/kbits. + (warning: 1kbit = 1000 bits) + default = 1024*8 bits. + keyint=XXX interval between keyframes - (specify in frames) - vhq very high quality - vme=XXX motion estimation method - vqmin=XXX minimum quantizer - vqmax=XXX maximum quantizer - vqdiff=XXX quantizer difference. Limits the - maximum quantizer difference - between frames. - vratetol=XXX approximated bitrate tolerance + (specify in frames, >300 are not + recommended) + default = 250 (one key frame every + ten seconds in a 25fps movie) + + vhq high quality mode, macro blocks + will be encoded multiple times and + the smallest will be used. + default = HQ disabled + + vme=XXX [0..5] motion estimation method : + 0 - no ME at all + 1 - ME_FULL + 2 - ME_LOG + 3 - ME_PHODS + 4 - ME_EPZS + 5 - ME_X1 + EPZS usually gives best results, + but you can try X1 too. FULL is + very slow and the others are + experimental. + default = EPZS + vqcomp=XXX if the value is set to 1.0, the quantizer will stay nearly - constant. If it's 0.0, the + constant (high motion scenes will + look bad). If it's 0.0, the quantizer will be changed - to make all frames - approximately equally sized. + to make all frames approximately + equally sized (low motion scenes + will look bad). + default = 0.5 + vqblur=XXX blurs the quantizer graph over time. 0.0 : no blur 1.0 : average all past quantizers + default = 0.5 + + vqscale=XXX [2..31] gives each frame the same + quantizer (selects fixed quantizer + mode). + default = 0 (fixed quantizer mode + disabled) + + vrc_strategy=X [0..2] different strategies to + decide which frames should get + which quantizer. + default = 2 + + v4mv 4 motion vectors per macroblock, + may gives you slightly better + quality, can only be used in HQ + mode and is buggy with B frames + currently. + default = disabled + + vpass=X [1,2] select internal first pass + or second pass of 2-pass mode. + default = 0 (1-pass mode) + +The next 3 options apply only to I & P frames : + + vqmin=XX [1..31] minimum quantizer, + default = 3 + + vqmax=XX [1..31] maximum quantizer + default = 15 + + vqdiff=XX [1..31] quantizer difference. + Limits the maximum quantizer + difference between frames. + default = 3 + +The following options apply only to B frames : + + vmax_b_frames=X [0..4] maximum number of frames + between each I/P frame. + default = 0 (B-frames generation + disabled) + + vb_strategy=X strategy to choose between + I/P/B frames : + 0 allways use max B + 1 avoid B frames in high + motion / scene change (can + lead to filesize miss + prediction) + default = 0 + +In fixed quantizer mode you can use those options : + vqscale, vmax_b_frames, vhq, vme, keyint + +You can use the following options only in pass 1 of 2-pass mode or in 1-pass mode : + vqblur, vqdiff + +You can use the following options only in pass 2 of 2-pass mode : + vrc_strategy, vb_strategy + +All other options can be used in all modes. + .TP .B \-lameopts If encoding to MP3 with libmp3lame, you can specify its parameters here, like: