# HG changeset patch # User diego # Date 1057449177 0 # Node ID 9b0c08383461f5f249c6726e7758a99434629293 # Parent c21e3bceec16274b529f0e6760880abcd3bbcc25 Sentences should start on a new line. \' at the beginning of a line creates garbage. diff -r c21e3bceec16 -r 9b0c08383461 DOCS/en/mplayer.1 --- a/DOCS/en/mplayer.1 Sat Jul 05 15:02:51 2003 +0000 +++ b/DOCS/en/mplayer.1 Sat Jul 05 23:52:57 2003 +0000 @@ -203,10 +203,10 @@ specific one is '~/\:.mplayer/\:config'. User specific options override system\-wide options and options given on the command line override either. -The syntax of the configuration files is 'option=', everything after a -\'#' is considered a comment. -Options that work without values can be enabled by setting them to 'yes' or -\'1' and disabled by setting them to 'no' or '0'. +The syntax of the configuration files is 'option=', everything after +a '#' is considered a comment. +Options that work without values can be enabled by setting them to 'yes' +or '1' and disabled by setting them to 'no' or '0'. Even suboptions can be specified in this way. .I EXAMPLE: @@ -462,8 +462,8 @@ Mostly useful with a fifo. .br .I NOTE: -When the given file is a fifo MPlayer opens both ends so you can do several -\'echo "seek 10" > mp_pipe\' and the pipe will stay valid. +When the given file is a fifo MPlayer opens both ends so you can do +several 'echo "seek 10" > mp_pipe' and the pipe will stay valid. .RE .PD 1 . @@ -740,9 +740,9 @@ .B \-hr\-mp3\-seek (MP3 only) Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, as we need to seek -to the very exact position to keep A/\:V sync. It can be slow especially when -seeking backwards \- it has to rewind to the beginning to find the exact -frame. +to the very exact position to keep A/\:V sync. +It can be slow especially when seeking backwards \- it has to rewind to the +beginning to find the exact frame. .TP .B \-idx (also see \-forceidx) Rebuilds INDEX of the AVI if no INDEX was found, @@ -886,8 +886,8 @@ . .TP .B \-tv -This option tunes various properties of tv-capture module. For -watching TV with MPlayer, use 'tv://' or 'tv://' +This option tunes various properties of tv-capture module. +For watching TV with MPlayer, use 'tv://' or 'tv://' or even 'tv:// (see option channels for channel_name below) as a movie URL. @@ -1151,8 +1151,9 @@ . .TP .B \-sub -Use/\:display these subtitle files. Only one file can be displayed -at the same time and the files can be switched with 'j'. +Use/\:display these subtitle files. +Only one file can be displayed at the same time and the files can be +switched with 'j'. .TP .B \-sub-bg-alpha <0\-255> Specify the alpha channel value for subtitles and OSD backgrounds. @@ -1285,8 +1286,8 @@ .TP .B \-vobsub Specify the VobSub files that are to be used for subtitle. -This is the full pathname without extensions, i.e.\& without the '.idx', -\'.ifo' or '.sub'. +This is the full pathname without extensions, i.e.\& without +the '.idx', '.ifo' or '.sub'. .TP .B \-vobsubid <0-31> Specify the VobSub subtitle id. @@ -1297,10 +1298,11 @@ position. .TP .B \-spuaa -Antialiasing/scaling mode for DVD/VobSub. A value of 16 may be added -to mode in order to force scaling even when original and scaled frame -size already match, for example to smooth subtitles with the gaussian -blur. The available modes are: +Antialiasing/scaling mode for DVD/VobSub. +A value of 16 may be added to mode in order to force scaling even +when original and scaled frame size already match, for example to +smooth subtitles with the gaussian blur. +The available modes are: .PD 0 .RSs .IPs 0 @@ -1318,8 +1320,9 @@ . .TP .B \-spugauss <0.0\-3.0> -Variance parameter of gaussian used by -spuaa 4. Higher means more -blur. The default is 1.0. +Variance parameter of gaussian used by -spuaa 4. +Higher means more blur. +The default is 1.0. .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)" @@ -1330,7 +1333,7 @@ .B \-ao Specify a priority list of audio output drivers (optionally with device) to be used. -\'device' is valid with SDL, too, it means subdriver then. +With SDL 'device' is valid, too, it means subdriver then. .I NOTE: .br @@ -1587,8 +1590,9 @@ Specify a priority list of fullscreen layer setting modes to be used. -The default order is "layer,stays_on_top,above,fullscreen". It will be used -as a fallback in case of specifying incorrect or unsupported modes. +The default order is "layer,stays_on_top,above,fullscreen". +It will be used as a fallback in case of specifying incorrect +or unsupported modes. .br If you experience problems with fullscreen window being covered by other windows try using a different order. @@ -1749,7 +1753,7 @@ .B \-vo Specify a priority list of video output drivers (optionally with device) to be used. -\'device' is valid with SDL and GGI, too, it means subdriver then. +With SDL and GGI 'device' is valid, too, it means subdriver then. .I NOTE: .br @@ -2503,8 +2507,8 @@ .TP .B dvbscale[=aspect] Set up optimal scaling for DVB cards, scaling the X axis in hardware and -calculating the Y axis scaling in software to keep aspect. It's only useful -together with expand+scale +calculating the Y axis scaling in software to keep aspect. +It's only useful together with expand+scale (\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc). .RSs .IPs aspect @@ -2566,8 +2570,9 @@ .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg] Alternative software equalizer that uses lookup tables (very slow), allowing gamma correction in addition to simple brightness, -contrast and saturation adjustment. Note that it uses the same MMX -optimized code as \-vf eq if all gamma values are 1.0. +contrast and saturation adjustment. +Note that it uses the same MMX optimized code as \-vf eq if all +gamma values are 1.0. The parameters are given as floating point values. Parameters rg, gg, bg are the independent gamma values for the Red, Green and Blue components. @@ -2667,34 +2672,38 @@ .TP .B "field[=n]" Extracts a single field from an interlaced image using stride arithmetic -to avoid wasting CPU time. The optional argument n specifies whether -to extract the even or the odd field (depending on whether n is even -or odd). +to avoid wasting CPU time. +The optional argument n specifies whether to extract the even or the odd +field (depending on whether n is even or odd). .TP .B "detc[=var1=value2:var2=value2:...]" Attempts to reverse the "telecine" process to recover a clean, -non-interlaced stream at film framerate. This filter is still -experimental but seems to be usable. Please be aware that there is -absolutely no use in this filter unless you see interlacing when -playing the movie! The following arguments (see syntax above) may be -used to control its behavior: +non-interlaced stream at film framerate. +This filter is still experimental but seems to be usable. +Please be aware that there is absolutely no use in this filter +unless you see interlacing when playing the movie! +The following arguments (see syntax above) may be used to control +its behavior: .RSs .IPs dr -Set the frame dropping mode. 0 (default) means don't drop frames -to maintain fixed output framerate. 1 means always drop a frame when -there have been no drops or telecine merges in the past 5 frames. 2 -means always maintain exact 5:4 input to output frame ratio. (Note: -use mode 1 with MEncoder!) +Set the frame dropping mode. +0 (default) means don't drop frames to maintain fixed output framerate. +1 means always drop a frame when there have been no drops or telecine +merges in the past 5 frames. +2 means always maintain exact 5:4 input to output frame ratio. +(Note: use mode 1 with MEncoder!) .IPs am -Analysis mode. Available values are 0 (fixed pattern with initial -frame number specified by fr=#) and 1 (agressive search for telecine -pattern). Default is 1. +Analysis mode. +Available values are 0 (fixed pattern with initial frame number +specified by fr=#) and 1 (agressive search for telecine pattern). +Default is 1. .IPs fr -Set initial frame number in sequence. 0-2 are the three clean -progressive frames; 3 and 4 are the two interlaced frames. The -default, -1, means "not in telecine sequence". The number specified -here is the type for the imaginary previous frame before the movie -starts. +Set initial frame number in sequence. +0-2 are the three clean progressive frames; 3 and 4 are the two +interlaced frames. +The default, -1, means "not in telecine sequence". +The number specified here is the type for the imaginary previous +frame before the movie starts. .IPs tr0, tr1, tr2, tr3 Threshold values to be used in certain modes. .RE @@ -2712,18 +2721,21 @@ 23.976) when using mencoder. .TP .B "telecine[=start]" -Apply 3:2 "telecine" process to increase framerate by 20%. This most -likely will not work correctly with mplayer, but it can be used -with 'mencoder -fps 29.97 -ofps 29.97 -vf telecine'. Both fps options -are essential! (A/V sync will break if they are wrong.) The optional start -parameter tells the filter where in the telecine pattern to start -(0-3). +Apply 3:2 "telecine" process to increase framerate by 20%. +This most likely will not work correctly with mplayer, but it can +be used with 'mencoder -fps 29.97 -ofps 29.97 -vf telecine'. +Both fps options are essential! +(A/V sync will break if they are wrong.) +The optional start parameter tells the filter where in the telecine +pattern to start (0-3). .TP .B "tfields[=mode]" Temporal field separation -- split fields into frames, doubling the -output framerate. Like the telecine filter, "tfields" will only work -properly with mencoder, and only if both -fps and -ofps are set to the -desired (double) framerate! Available modes are: +output framerate. +Like the telecine filter, "tfields" will only work properly with +MEncoder, and only if both -fps and -ofps are set to the +desired (double) framerate! +Available modes are: .PD 0 .RSs .IPs 0 @@ -3118,8 +3130,8 @@ pass=2. .TP .B vbrpass=<0\-2> -Override the pass argument and use XviD VBR Library instead of DivX4 -VBR. Available options are: +Override the pass argument and use XviD VBR Library instead of DivX4 VBR. +Available options are: . .RSs .IPs 0 @@ -3327,8 +3339,10 @@ .PD 1 .TP .B vme=<0\-5> -motion estimation method. Note: 0\-3 currently ignores the amount of Bits -spent, so quality may be low. Available methods are: +motion estimation method. +Note: 0\-3 currently ignores the amount of Bits spent, +so quality may be low. +Available methods are: .PD 0 .RSs .IPs 0 @@ -3646,11 +3660,12 @@ .PD 1 .TP .B -MV & DC are most important, loosing them looks far worse than loosing the -AC and the 1. & 2. partition. (MV&DC) are far smaller than the 3. partition -(AC) meaning that errors will hit the AC partition much more often than the -MV&DC partitions. Thus, the picture will look better with partitioning than -without, as without partitioning an error will trash AC/DC/MV equally. +MV & DC are most important, loosing them looks far worse than loosing +the AC and the 1. & 2. partition. +(MV&DC) are far smaller than the 3. partition (AC) meaning that errors +will hit the AC partition much more often than the MV&DC partitions. +Thus, the picture will look better with partitioning than without, +as without partitioning an error will trash AC/DC/MV equally. .TP .B vpsize=<0\-10000> video packet size, improves error-resistance (see \-vdpart option too): @@ -4025,7 +4040,8 @@ .RE The folowing options are only available with the unstable (cvs -HEAD) -version of XviD. Be warned that these options are experimental and may +version of XviD. +Be warned that these options are experimental and may not work as intended. .TP .B packed