[MPlayer-dev-eng] mplayer.1 -pp/-npp update
pl
p_l at tfz.net
Fri Jan 4 13:23:54 CET 2002
Hi,
A small update according to postproc/postprocess.[hc] + cvs logs for
-pp/-npp and a note added in DVD section.
Michael, maybe adding a '-npp help' that simply printf() the comment of
postproc/postprocess.c would help to maintain the manpage in sync ;)
Btw, in the current page:
"-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 ! "
Is this still the case ?
(if yes, some -pp/-npp examples are misleading)
--
Best regards,
pl
-------------- next part --------------
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/mplayer.1,v
retrieving revision 1.129
diff -u -r1.129 mplayer.1
--- mplayer.1 2 Jan 2002 19:07:40 -0000 1.129
+++ mplayer.1 4 Jan 2002 12:19:20 -0000
@@ -140,6 +140,8 @@
.I NOTE:
These options are valid only with DVD support compiled in. For details,
see the documentation.
+.I NOTE:
+DVD playback may require postprocessing, see '-pp' option in this man page.
.TP
.B \-dvd\ titleid
tell MPlayer which movies (marked with titleid) to play. For example
@@ -391,68 +393,70 @@
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 MPEG, OpenDivX,
-DivX4, DivX. 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.
+.B \-pp\ <quality> (see -npp option too !)
+apply postprocess filter on decoded image. Postprocessing effect depends on
+the codec and works only for MPEG, OpenDivX, DivX4, DivX.
+
+This is the numerical mode to invoke postprocessing.
+
+Quality is an hexadecimal number: see -npp option below for the available
+features. Then, sum the hexadecimal values to have several filters applied at
+the same time).
+
+.I HINT/EXAMPLE:
+The following values are known to give good results:
+ \-pp 0x2007f <=> \-npp hb,vb,dr,al,lb
+ \-pp 0x7f <=> \-npp hb,vb,dr,al
+
.I NOTE:
-0x20000 (deinterlacing) may be required for DVD playback
+A deinterlacing filter may be required for DVD playback (0x20000 for
+instance).
.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).
+apply postprocess filter on decoded image. Postprocessing effect depends on
+the codec and works only for MPEG, OpenDivX, DivX4, DivX.
-.I EXAMPLE:
- '-pp 0x2007f' <=> '-npp hb,vb,dr,al,lb'
- '-pp 0x7f' <=> '-npp hb,vb,dr,al'
+This is the verbose mode to invoke postprocessing.
+
+.I HINTS:
+You want to try '-npp default' or '-npp fast' before messing with the options.
+You can mix this option with -autoq (as in '-npp default -autoq 6')
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)
+ dering:a,autolevels,tmpnoise:a:150:200:400
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)
+ 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 denoise filter (0x100000)
+ 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 postfix letter, separated by ':' may be appended to the option to indicate
+A postfixed 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
@@ -465,10 +469,6 @@
'-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
More information about the MPlayer-dev-eng
mailing list