comparison DOCS/mplayer.1 @ 4531:1736cd920aa4

applied pl's patch (sorry, overlooked it previously.. and procmailrc put the Cc into mplayer-dev-eng also;)

4530:22a4c7957f03

.LP
.SH "DVD OPTIONS"
.I NOTE:
These options are valid only with DVD support compiled in. For details,
see the documentation.
.TP
.B \-dvd\ titleid
tell MPlayer which movies (marked with titleid) to play. For example
sometimes '1' are trailers, and '2' is the real movie.
.TP

.TP
.B \-xy\ <factor>
scale image by <factor>
.TP
.B \-autoq\ <quality>
dynamically changes the level of postprocess, depending on spare CPU
time available. Uses the same value ranges as -pp . The number you
specify will be the maximum level used. Usually you can use some big
number. You don't have to (and don't) use together with -pp !
.TP
.B \-ffactor\ <number>
resample alphamap of the font. Can be:

        0    plain white fonts

.TP
.B \-bpp\ <depth>
use different color depth than autodetect. Not all -vo drivers support
it (fbdev, dga2, svga, vesa).
.TP
.B \-pp\ <quality>
apply postprocess filter on decoded image.
Postprocessing effect depends on the codec and works only for MPEG1/2,
libavcodec codecs (ff*). It doesn't work for Win32/XAnim codecs.
Quality is an hexadecimal number built as below:

0x 00 TX hv YZ
      ^^ ^^ ^^
      ||  | ||
      ||  | |\- postprocessing flag for luminance:
      ||  | |   1/2: v/h deblock  4: dering
      ||  | |   8: auto contrast/brightness correction
      ||  | |
      ||  | \-- postproc flags for color:
      ||  |     1/2: v/h deblock  4: dering
      ||  |
      ||  \---- experimental deblocking filters:
      ||        11: X's filter 22: x1 filter
      ||
      |\------- deinterlacing modes
      |         1: linear interpolation  2: linear blend
      |         4: cubic interpolation   8: median
      |
      \-------- temporal denoise filter: 1 enabled
	
.I HINT:
0x2007f or 0x7f are known to give good results.
.I NOTE:
0x20000 (deinterlacing) may be required for DVD playback 
.TP
.B \-npp\ <options> (EXPERIMENTAL)
This option allows to give more litterate options for postprocessing, and is
another way of calling it (not with -pp).

.I EXAMPLE:
    '-pp 0x2007f' <=> '-npp hb,vb,dr,al,lb'
    '-pp 0x7f'    <=> '-npp hb,vb,dr,al'

The options for -npp are a coma separated list of the keywords below:
    de or default        : hdeblock:a,vdeblock:a,
                           dering:a,autolevels,tmpnoise:a:150:200:400 (0xTODO)
    fa or fast           : x1hdeblock:a,x1vdeblock:a,
                           dering:a,autolevels,tmpnoise:a:150:200:400 (0xTODO)
    hb or hdeblock       : horizontal deblocking filter (0xTODO)
    vb or vdeblock       : vertical deblocking filter (0xTODO)
    hr or rkhdeblock     : rk horizontal deblock filter (0xTODO)
    vr or rkvdeblock     : rk vertical deblock filter (0xTODO)
    h1 or x1hdeblock     : x1 horizontal deblock filter (0xTODO)
    v1 or x1vdeblock     : y1 horizontal deblock filter (0xTODO)
    dr or dering         : TODO
    al or autolevels     : brightness/contrast correction (0xTODO)
    lb or linblenddeint  : linear blend deinterlacing (0x20000)
    li or linipoldeint   : linear interpolation deinterlacing (0x10000)
    ci or cubicipoldeint : cubic interpolation deinterlacing (0x40000)
    md or mediandeint    : median deinterlacing (0x80000)
    tn or tmpnoise       : temporal denoise filter (0x100000)

These keywords accept a '-' prefix to disable the option.

.I EXAMPLE:
    '-npp de,-al' means 'default filters without brightness/contrast correction'

A postfix letter, separated by ':' may be appended to the option to indicate
its scope:
    a : automatically switches the filter off if the cpu is too slow
    c : do chrominance filtering too
    y : do not do chrominance filtering (that is only luminance filtering)

Each filter defaults to 'c' (chrominance).

.I EXAMPLE:
    '-npp de,tn:1:2:3' means 'enable default filters & temporal denoiser'
    '-npp hb:y,vb:a -autoq 6' means 'deblock horizontal only luminance, and
    automatically switch vertical deblocking on/off depending on available 
    cpu time'

.I HINT:
    the following values are known to give good results:
    -npp default -autoq 6 and -npp tn:150:200:400 for the denoiser

.TP
.B \-slave
This option switches on slave mode. This is intended for use
of MPlayer as a backend to other programs. Instead of intercepting keyboard
events, MPlayer will read simplistic command lines from its stdin.

4531:1736cd920aa4

.LP
.SH "DVD OPTIONS"
.I NOTE:
These options are valid only with DVD support compiled in. For details,
see the documentation.
.I NOTE:
DVD playback sometimes requires deinterlacing: see '-pp 0x20000' or '-npp lb' options.
.TP
.B \-dvd\ titleid
tell MPlayer which movies (marked with titleid) to play. For example
sometimes '1' are trailers, and '2' is the real movie.
.TP

.TP
.B \-xy\ <factor>
scale image by <factor>
.TP
.B \-autoq\ <quality>
dynamically changes the level of postprocess, depending on spare CPU time
available. The number you specify will be the maximum level used. Usually you
can use some big number. You may not use together with -pp but it's ok with
-npp !
.TP
.B \-ffactor\ <number>
resample alphamap of the font. Can be:

        0    plain white fonts

.TP
.B \-bpp\ <depth>
use different color depth than autodetect. Not all -vo drivers support
it (fbdev, dga2, svga, vesa).
.TP
.B \-pp\ <quality> (see -npp option too !)
apply postprocess filter on decoded image

Postprocessing effect depends on the codec and works only for MPEG1/2,
libavcodec codecs (ff*). It doesn't work for Win32/XAnim codecs.

This is the numerical mode to use postprocessing. The '-npp' option described
below has the same effects but with letters. To have several filters at the
same time, simply add the hexadecimal values.

.I EXAMPLE:
The following values are known to give good results:
    \-pp 0x20000 <=> \-npp lb (deinterlacing - for DVD/MPEG2 playback e.g.)
    \-pp 0x7f    <=> \-npp hb,vb,dr,al (smooth the images)
.TP
.B \-npp\ <options>
This option allows to give more litterate options for postprocessing, and is
another way of calling it (not with -pp).

.I EXAMPLE:
    '-pp 0x2007f' <=> '-npp hb,vb,dr,al,lb'
    '-pp 0x7f'    <=> '-npp hb,vb,dr,al'

The options for -npp are a coma separated list of the keywords below:
    help                 : display the options available and exit MPlayer
    de or default        : hdeblock:a,vdeblock:a,
                           dering:a,autolevels,tmpnoise:a:150:200:400
    fa or fast           : x1hdeblock:a,x1vdeblock:a,
                           dering:a,autolevels,tmpnoise:a:150:200:400
    hb or hdeblock       : horizontal deblocking filter
                           (luminance: 0x2 chrominance: 0x20)
        + 1st threshold  : default is 1, higher means stronger deblocking
        + 2nd threshold  : default is 40, lower means stronger deblocking
    vb or vdeblock       : vertical deblocking filter
                           (luminance: 0x1 chrominance: 0x10)
        + 2 thresholds   : shared with hdeblock thresholds
    hr or rkhdeblock     : Ramkishor & Karandikar's horizontal deblock
                           filter (0x1000)
    vr or rkvdeblock     : R&K's vertical deblock filter (0x100)
    h1 or x1hdeblock     : x1 horizontal deblock filter (0x2000)
    v1 or x1vdeblock     : y1 horizontal deblock filter (0x200)
    dr or dering         : dering
                           (luminance: 0x4 chrominance: 0x40)
    al or autolevels     : auto brightness/contrast correction (0x8)
    lb or linblenddeint  : linear blend deinterlacing (0x20000)
    li or linipoldeint   : linear interpolation deinterlacing (0x10000)
    ci or cubicipoldeint : cubic interpolation deinterlacing (0x40000)
    md or mediandeint    : median deinterlacing (0x80000)
    tn or tmpnoise       : temporal noise reducer (0x100000)
        + 3 thresholds   : t1 <= t2 <= t3 (larger means stronger filtering)
    fq or forcequant     : force quantizer [for low-quality movies
                           reencoded at high bitrates] (0x200000)

These keywords accept a '-' prefix to disable the option.

.I EXAMPLE:
    '-npp de,-al' means 'default filters without brightness/contrast correction'

A ':' followed by a letter may be appended to the option to indicate its
scope:
    a : automatically switches the filter off if the cpu is too slow
    c : do chrominance filtering too
    y : do not do chrominance filtering (that is only luminance filtering)

Each filter defaults to 'c' (chrominance).

.I EXAMPLE:
    '-npp de,tn:1:2:3' means 'enable default filters & temporal denoiser'
    '-npp hb:y,vb:a -autoq 6' means 'deblock horizontal only luminance, and
    automatically switch vertical deblocking on/off depending on available 
    cpu time'
.TP
.B \-slave
This option switches on slave mode. This is intended for use
of MPlayer as a backend to other programs. Instead of intercepting keyboard
events, MPlayer will read simplistic command lines from its stdin.