changeset 10218:f82646fc1431

Moved video filters to a separate section, moved slave mode section to the tech subdir, random improvements, default indentation reduced. Straight from the LUG camp Felsberg by Jonas and Diego.
author jonas
date Sat, 31 May 2003 16:41:41 +0000
parents 1f3935c55e6f
children beeed3a9606e
files DOCS/en/mplayer.1 DOCS/tech/manpage.txt DOCS/tech/slave.txt
diffstat 3 files changed, 813 insertions(+), 722 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/en/mplayer.1	Fri May 30 18:48:44 2003 +0000
+++ b/DOCS/en/mplayer.1	Sat May 31 16:41:41 2003 +0000
@@ -14,7 +14,7 @@
 .\" default indentation is 7, don't change!
 .nr IN 7
 .\" define indentation for suboptions
-.nr SS 20
+.nr SS 4
 .\" add new suboption
 .de IPs
 .IP "\\$1" \n(SS
@@ -230,6 +230,132 @@
 named 'movie.avi.conf' with the file-specific options in it and put it in
 ~/.mplayer or in the same directory as the file.
 
+
+.\" --------------------------------------------------------------------------
+.\" Keyboard control
+.\" --------------------------------------------------------------------------
+.
+.SH "KEYBOARD CONTROL"
+.I NOTE:
+.br
+MPlayer has a fully configurable, command driven, control layer
+which allow you to control MPlayer using keyboard, mouse, joystick
+or remote control (using lirc).
+.br
+The default configuration file for the input system is
+~/.mplayer/\:input.conf but it can be overriden
+using the \-input conf option.
+.br
+These keys may/\:may not work, depending on your video output driver.
+.TP
+.B general control
+.PD 0
+.RSs
+.IPs "<\- and \->"
+seek backward/\:forward 10 seconds
+.IPs "up and down"
+seek backward/\:forward  1 minute
+.IPs "pgup and pgdown"
+seek backward/\:forward 10 minutes
+.IPs "< and >"
+backward/\:forward in playlist
+.IPs "HOME and END"
+go to next/\:previous playtree entry in the parent list
+.IPs "INS and DEL"
+go to next/\:previous alternative source (asx playlist only)
+.IPs "p / SPACE"
+pause movie (any key unpauses)
+.IPs "q / ESC"
+stop playing and quit
+.IPs "+ and \-"
+adjust audio delay by +/\:\- 0.1 second
+.IPs "/ and *"
+decrease/\:increase volume
+.IPs "9 and 0"
+decrease/\:increase volume
+.IPs m\ \ \ \ 
+mute sound
+.IPs f\ \ \ \ 
+toggle fullscreen
+.IPs "w and e"
+decrease/\:increase panscan range
+.IPs o\ \ \ \ 
+toggle between OSD states: none / seek / seek+timer
+.IPs d\ \ \ \ 
+toggle frame dropping
+.IPs v\ \ \ \ 
+toggle subtitle visibility
+.IPs j\ \ \ \ 
+switch subtitle language
+.IPs a\ \ \ \ 
+toggle subtitle aligment: top/middle/bottom
+.IPs "z and x"
+adjust subtitle delay by +/\:\- 0.1 second
+.IPs "r and t"
+adjust subtitle position
+.IPs "i"
+set EDL mark
+
+.PP
+(The following keys are valid only when using a hardware accelerated video
+output (xv, (x)vidix, (x)mga, etc), or the software equalizer filter
+(-vf eq or -vf eq2).
+
+.IPs "1 and 2"
+adjust contrast
+.IPs "3 and 4"
+adjust brightness
+.IPs "5 and 6"
+adjust hue
+.IPs "7 and 8"
+adjust saturation
+.RE
+.PD 1
+.
+.TP
+.B GUI keyboard control
+.PD 0
+.RSs
+.IPs "ENTER"
+start playing
+.IPs s\ \ \ \ 
+stop playing
+.IPs l\ \ \ \ 
+load file
+.IPs c\ \ \ \ 
+skin browser
+.IPs p\ \ \ \ 
+toggle playlist
+.RE
+.PD 1
+.
+.TP
+.B TV input control
+.PD 0
+.RSs
+.IPs "h and k"
+select previous/\:next channel
+.IPs n\ \ \ \ 
+change norm
+.IPs u\ \ \ \ 
+change channel list
+.RE
+.PD 1
+.
+.TP
+.B DVDNAV input control
+.PD 0
+.RSs
+.IPs "K,J,H,L"
+browse up/\:down/\:left/\:right
+.IPs M\ \ \ \ 
+jump to main menu
+.IPs S\ \ \ \ 
+select
+.RE
+.PD 1
+
+
 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
 .TP
 .B \-use-stdin
@@ -417,9 +543,6 @@
 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.
-The section
-.B SLAVE MODE PROTOCOL
-explains the syntax.
 .TP
 .B \-softsleep
 Uses high quality software timers.
@@ -2063,494 +2186,6 @@
 .PD 1
 .
 .TP
-.B \-vf <filter1[=options],filter2,...>
-Setup a chain of video filters.
-
-.I NOTE:
-.br
-The parameters are optional and if omitted, some of them are set to default
-values.
-Use '-1' to keep the default value.
-Parameters w:h means width x height in pixels, x:y means x;y position counted
-from the upper left corner of the bigger image.
-.br
-To get a full list of available filters, see \-vf help.
-.br
-Available filters are:
-.
-.RSs
-.IPs crop[=w:h:x:y]
-Crops the given part of the image and discards the rest.
-Useful to remove black bands from widescreen movies.
-.RSss
-w,h: Cropped width and height, defaults to original width and height.
-.br
-x,y: Position of the cropped picture, defaults to center.
-.REss
-.IPs cropdetect[=0\-255]
-Calculates necessary cropping parameters and prints the recommended parameters
-to stdout.
-The threshold can be optionally specified from nothing (0) to everything
-(255).
-(default: 24)
-.IPs rectangle[=w:h:x:y]
-Draws a rectangle of the requested width and height at the specified
-coordinates over the image (useful for testing crop parameters).
-.RSss
-w,h: width and height (default: -1, maximum possible width where boundaries
-are still visible.
-.br
-x,y: top left corner position (default: -1, uppermost leftmost)
-.REss
-.IPs
-The plugin responds to the input.conf directive 'change_rectangle'
-that takes two parameters.
-The first parameter can be 0 for w, 1 for h, 2 for x or 3 for y.
-The second parameter is the amount of pixels by which to change the
-designated rectangle boundary.
-.IPs expand[=w:h:x:y:o]
-Expands (not scales) movie resolution to the given value and places the
-unscaled original at coordinates x, y.
-Can be used for placing subtitles/\:OSD in the resulting black bands.
-.RSss
-w,h: expanded width,height (default: original width,height)
-.br
-x,y: position of original image on the expanded image (default: center)
-.br
-o:   OSD/subtitle rendering
-    0: disable (default)
-    1: enable
-.REss
-.IPs
-Negative values for w and h are treated as offsets to the original size, e.g.
-expand=0:-50:0:0 adds a 50 pixel border to the bottom of the picture.
-.IPs flip
-Flips the image upside down.
-See also option \-flip.
-.IPs mirror
-Mirrors the image on the Y axis.
-.IPs rotate[=<0-7>]
-Rotates and flips (optional) the image +/\:\- 90 degrees.
-For parameters between 4-7 rotation is only done if the movie's geometry is
-portrait and not landscape.
-.IPs scale[=w:h[:c[:p]]]
-Scales the image with the software scaler (slow) and performs a YUV<\->RGB
-colorspace conversion (also see \-sws option).
-.RSss
-w,h: new width/height after scaling (default: original width,height)
-    Note: If -zoom is used, and underlying filters (including libvo) are
-    incapable of scaling, then it defaults to d_width/\:d_height!
-    -1: original width/\:height
-    0:  scaled d_width/\:d_height
-    -2: Calculate w/\:h using the other dimension and the prescaled aspect ratio.
-    -3: Calculate w/\:h using the other dimension and the original aspect ratio.
-.br
-c:   chroma skipping
-    0: use all available input lines for chroma
-    1: use only every 2. input line for chroma
-    2: use only every 4. input line for chroma
-    3: use only every 8. input line for chroma
-.br
-p:  scaling parameter (depends upon the scaling method used)
-    for -sws 2 (bicubic)  it is sharpness (0 (soft) - 100 (sharp))
-    for -sws 7 (gaussian) it is sharpness (0 (soft) - 100 (sharp))
-    for -sws 9 (lanczos)  it is filter length (1 - 10)
-The value 0 is used for scaled (aspect) destination w/\:h.
-(default: original w/\:h, destination w/\:h with \-zoom) Optionally chroma
-skipping (c from 0\-3) and scaling parameters can be specified.
-(see the \-sws option for details)
-.REss
-.IPs dsize={aspect|w:h}
-Changes the intended display size/aspect at an arbitrary point in the
-filter chain.
-Aspect can be given as a fraction (4/3) or floating point number
-(1.33).
-Alternatively, you may specify the exact display width and height
-desired.
-Note that this filter does NOT do any scaling itself; it just affects
-what later scalers (software or hardware) will do when auto-scaling to
-correct aspect.
-.IPs yuy2
-Forces software YV12/\:I420 or 422P to YUY2 conversion.
-Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
-.IPs yvu9
-Forces software YVU9 to YV12 colorspace conversion.
-Deprecated in favor of the software scaler.
-.IPs rgb2bgr[=swap]
-RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion.
-.RSss
-swap: Also perform  R <\-> B swapping.
-.REss
-.IPs palette
-RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette.
-.IPs format[=fourcc]
-Restricts the colorspace for the next filter without doing any conversion.
-Use together with the scale filter for a real conversion.
-.RSss
-fourcc: format name like rgb15, bgr24, yv12, etc (default: yuy2)
-.REss
-.IPs pp[=filter1[:option1[:option2...]]/[-]filter2...] (see \-pphelp too)
-This option enables usage of MPlayer's internal postprocessing filter,
-and also gives an interface where you can pass options to the named filter.
-To get a list of available filters, use \-pphelp.
-.br
-Note that each sub-filter must be separated with a / sign.
-.br
-Each filter defaults to 'c' (chrominance).
-.br
-The keywords accept a '\-' prefix to disable the option.
-.br
-A ':' followed by a letter may be appended to the option to indicate its
-scope:
-.RSss
-a: Automatically switches the filter off if the CPU is too slow.
-.br
-c: Do chrominance filtering, too.
-.br
-y: Do not do chrominance filtering (only luminance filtering).
-.REss
-
-.RS
-.I EXAMPLES:
-.RE
-.RSss
-.br
-\-vf pp=hb/vb/dr/al/lb
-.br
-\-vf pp=hb/vb/dr/al
-.br
-Default filters without brightness/\:contrast correction:
-.br
-\-vf pp=de/\-al
-.br
-Enable default filters & temporal denoiser:
-.br
-\-vf pp=de/tn:1:2:3
-.br
-Deblock horizontal only luminance and switch vertical deblocking on or
-off automatically depending on available CPU time:
-.br
-\-vf pp=hb:y/vb:a \-autoq 6
-.REss
-.IPs test
-Generate various test patterns.
-.IPs lavc[=quality:fps]
-Fast software YV12 to MPEG1 conversion with libavcodec for use with DVB/\:DXR3.
-Faster and of better quality than \-vf fame.
-.RSss
-quality:
-    1 \- 31 fixed qscale
-    32 \-   fixed bitrate in kBits
-.br
-fps: force output fps (float value) (default: 0, autodetect based on height)
-.REss
-.IPs fame
-Fast software YV12 to MPEG1 conversion with libfame for use with DVB/\:DXR3.
-.IPs 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.
-.RSss
-aspect: control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
-576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
-.REss
-.IPs
-Only useful together with expand+scale:
-\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc
-.IPs "noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]"
-Adds noise.
-.RSss
-<0\-100>: luma noise
-.br
-<0\-100>: chroma noise
-.br
-u: uniform noise (gaussian otherwise)
-.br
-t: temporal noise (noise pattern changes between frames)
-.br
-a: averaged temporal noise (smoother, but a lot slower)
-.br
-h: high quality (slightly better looking, slightly slower)
-.br
-p: mix random noise with a (semi)regular pattern
-.REss
-.IPs "denoise3d[=luma:chroma:time]"
-This filter aims to reduce image noise producing smooth images and making still
-images really still (This should enhance compressibility.).
-It can be given from 0 to 3 parameters.   If you omit a parameter, a reasonable
-value will be inferred.
-.RSss
-luma:	spatial luma strength (default = 4)
-.br
-chroma:	spatial chroma strength (default = 3)
-.br
-time:	temporal strength (default = 6)
-.REss
-.IPs "hqdn3d[=luma:chroma:time]"
-High precision/\:quality version of the denoise3d filter.
-Parameters and usage are the same.
-.IPs eq[=bright:cont]
-Software equalizer with interactive controls just like the hardware
-equalizer, for cards/\:drivers that do not support brightness and
-contrast controls in hardware.
-Might also be useful with MEncoder, either for fixing poorly captured
-movies, or for slightly reducing contrast to mask artifacts and get by
-with lower bitrates.
-Initial values in the range -100 \- 100 may be given on the command line.
-.IPs 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.
-The parameters are given as floating point values.
-Parameters rg, gg, bg are the independent gamma values for the Red, Green
-and Blue components.
-Defaults are 1.0, brightness=0.0.
-Value ranges are 0.1\-10 for gammas, -2\-2 for contrast (negative values result
-in a negative image), -1\-1 for brightness and 0\-3 for saturation.
-.IPs halfpack[=f]
-Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
-keeping all chroma samples.
-Useful for output to low-resolution display devices when hardware downscaling
-is poor quality or is not available.
-Can also be used as a primitive luma-only deinterlacer with very low cpu
-usage.
-By default, halfpack averages pairs of lines when downsampling.
-The optional parameter f can be 0 to only use even lines, or 1 to only use
-odd lines.
-Any other value for f gives the default (averaging) behavior.
-.IPs ilpack
-When interlaced video is stored in YUV 4:2:0 formats, chroma
-interlacing does not line up properly due to vertical downsampling of
-the chroma channels.
-This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
-the chroma lines in their proper locations, so that in any given
-scanline, the luma and chroma data both come from the same field.
-.IPs dint[=sense:level]
-Detects and drops first of interlaced frames in video stream.
-Values can be from 0.0 to 1.0 - first (default 0.1) is relative difference
-between neighbor pixels, second (default 0.15) is what part of image have to
-be detected as interlaced to drop the frame.
-.IPs lavcdeint
-Use libavcodec's deinterlace filter.
-.IPs "unsharp=l|cWxH:amount[:l|cWxH:amount]"
-Unsharp mask / gaussian blur.
-.RSss
-l: Apply effect on luma component.
-.br
-c: Apply effect on chroma components.
-.br
-WxH: width and height of the matrix, odd sized in both directions
-(min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
-.br
-amount: Relative amount of sharpness/\:blur to add to the image
-(a sane range should be -1.5 \- 1.5).
-    <0: blur
-    >0: sharpen
-.REss
-.IPs swapuv
-Swap U & V plane.
-.IPs "il=[d|i][s][:[d|i][s]]"
-(de)interleaves lines.
-The goal of this filter is to add the ability to process interlaced images
-pre-field without deinterlacing them.
-You can filter your interlaced DVD and play it on a TV without breaking the
-interlacing.
-While deinterlacing (with the postprocessing filter) removes interlacing
-permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
-2 fields (so called half pictures), so you can process (filter) them
-independently and then re-interleave them.
-.RSss
-d: deinterleave
-.br
-i: interleave
-.br
-s: swap fields (exchange even & odd lines)
-.REss
-.IPs "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).
-.IPs "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:
-.RSss
-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!)
-.br
-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.
-.br
-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.
-.br
-tr0, tr1, tr2, tr3: Threshold values to be used in certain modes.
-.REss
-.IPs "ivtc[=1]"
-Experimental "stateless" inverse telecine filter.
-Rather than trying to lock on to a pattern like the detc filter does,
-ivtc makes its decisions independently for each frame.
-This will give much better results for material that has undergone
-heavy editing after telecine was applied, but as a result it is not as
-forgiving of noisy input, for example TV capture.
-The optional parameter (ivtc=1) corresponds to the dr=1 option for the
-detc filter, and should be used with mencoder but not with mplayer.
-As with detc, you must specify the correct output framerate (-ofps
-23.976) when using mencoder.
-.IPs "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).
-.IPs "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:
-.RSss
-0: leave fields unchanged (this will jump/flicker)
-.br
-1: interpolate missing lines (the algorithm used might not be so good)
-.br
-2: translate fields by 1/4 pixel with linear interp (no jump)
-.br
-4: translate fields by 1/4 pixel with 4tap filter (higher quality)
-.REss
-.IPs "boxblur=radius:power[:radius:power]"
-box blur
-.RSss
-radius: size of the filter
-.br
-power: How often the filter should be applied.
-.REss
-.IPs "sab=rad:pf:colorDiff[:rad:pf:colorDiff]"
-shape adaptive blur
-.RSss
-rad: blur filter strength (~0.1\-4.0) (slower if larger)
-.br
-pf: prefilter strength (~0.1\-2.0)
-.br
-colorDiff: How different the pixels are allowed to be considered.
-(~0.1-100.0)
-.REss
-.IPs "smartblur=rad:strength:thresh[:rad:strength:thresh]"
-smart blur
-.RSss
-rad: blur filter strength (~0.1\-5.0) (slower if larger)
-.br
-strength: blur (0.0\-1.0) or sharpen (-1.0\-0.0)
-.br
-thresh: filter all (0), filter flat areas (0\-30) or filter edges (-30\-0)
-.REss
-.IPs "perspective=x0:y0:x1:y1:x2:y2:x3:y3:t"
-perspective correction
-.RSss
-x0,y0,...: coordinates of the top left, top right, bottom left, bottom right
-corners
-.br
-t: linear (0) or cubic resampling (1)
-.REss
-.IPs 2xsai
-Use the 2x scale and interpolate algorithm for scaling and smoothing images.
-.IPs 1bpp
-1bpp bitmap to YUV/BGR 8/15/16/32 conversion
-.IPs down3dright[=lines]
-Reposition and resize stereoscopic images.
-Extracts both stereo fields and places them side by side, resizing
-them to maintain the original movie aspect.
-.RSss
-lines: number of lines to select from the middle of the image (default: 12)
-.REss
-.IPs "bmovl=hidden:opaque:<fifo>"
-Read bitmaps from a FIFO and display them in a window.
-.
-.RSss
-hidden: sets the default value of the 'hidden' flag (boolean)
-.br
-opaque: flag switching between alphablended (transparent) and opaque (fast)
-mode
-.br
-fifo: path/filename for the FIFO (named pipe connecting mplayer -vf bmovl
-to the controlling application)
-.REss
-
-.RS
-FIFO commands are:
-.RE
-.RSss
-RGBA32 width height xpos ypos alpha clear
-.br
-followed by width*height*4 Bytes of raw RGBA32 data.
-
-ABGR32 width height xpos ypos alpha clear
-.br
-followed by width*height*4 Bytes of raw ABGR32 data.
-
-RGB24 width height xpos ypos alpha clear
-.br
-followed by width*height*3 Bytes of raw RGB32 data.
-
-BGR24 width height xpos ypos alpha clear
-.br
-followed by width*height*3 Bytes of raw BGR32 data.
-
-ALPHA width height xpos ypos alpha
-.br
-change alpha for area
-
-CLEAR width height xpos ypos
-.br
-clear area
-
-OPAQUE
-.br
-disable all alpha transparency.
-Send "ALPHA 0 0 0 0 0" to enable it again.
-
-HIDE
-.br
-hide bitmap
-
-SHOW
-.br
-show bitmap
-.REss
-
-.RS
-Arguments are:
-.RE
-.RSss
-width, height: size of image/area
-.br
-xpos, ypos: start blitting at X/Y position   
-.br
-alpha: set alpha difference.
-0 means same as original, 255 makes everything
-opaque, -255 makes everything transparent.
-If you set this to -255 you can then send a sequence of ALPHA-commands to set
-the area to -225, -200, -175 etc for a nice fade-in-effect! ;)
-.br
-clear: clear the framebuffer before blitting.
-1 means clear, if 0, the image will just be blitted on top of the old one, so
-you don't need to send 1,8MB of RGBA32 data everytime a small part of the
-screen is updated.
-.REss
-.RE
-.
-.TP
 .B \-vfm <driver1,driver2,...>
 Specify a priority list of video codecs to be used, according to their
 names in codecs.conf.
@@ -2577,10 +2212,6 @@
 .PD 1
 .
 .TP
-.B \-vop <...,filter3[=options],filter2,filter1> (OBSOLETE)
-Setup a chain of video filters, to be applied in reverse order.
-Deprecated in favor of \-vf.
-.TP
 .B \-x <x> (MPLAYER only)
 Scale image to x width (if sw/\:hw scaling available).
 Disables aspect calculations.
@@ -2598,13 +2229,13 @@
 .PD 1
 .
 .TP
-.B \-xy <x>
+.B \-xy <value>
 .PD 0
 .RSs
-.IPs "x<=8"
-Scale image by factor <x>.
-.IPs "x>8\ "
-Set width to <x> and calculate height to keep correct aspect ratio.
+.IPs "value<=8"
+Scale image by factor <value>.
+.IPs "value>8\ "
+Set width to value and calculate height to keep correct aspect ratio.
 .RE
 .PD 1
 .
@@ -2623,6 +2254,600 @@
 \-zoom.
 
 
+.SH "VIDEO FILTERS"
+Video filter are plugins that allow you to modify the video stream and its
+properties. The syntax is:
+.TP
+.B \-vf <filter1[=options],filter2,...>
+Setup a chain of video filters.
+.TP
+.B \-vop <...,filter3[=options],filter2,filter1> (OBSOLETE)
+Setup a chain of video filters, to be applied in
+.B reverse
+order.  Deprecated in favor of \-vf.
+.RE
+
+The parameters are optional and if omitted, some of them are set to default
+values.
+Use '-1' to keep the default value.
+Parameters w:h means width x height in pixels, x:y means x;y position counted
+from the upper left corner of the bigger image.
+To get a full list of available filters, see \-vf help.
+
+Available filters are:
+
+.TP
+.B crop[=w:h:x:y]
+Crops the given part of the image and discards the rest.
+Useful to remove black bands from widescreen movies.
+.PD 0
+.RSs
+.IPs w,h
+Cropped width and height, defaults to original width and height.
+.IPs x,y
+Position of the cropped picture, defaults to center.
+.RE
+.PD 1
+.TP
+.B cropdetect[=0\-255]
+Calculates necessary cropping parameters and prints the recommended parameters
+to stdout.
+The threshold can be optionally specified from nothing (0) to everything
+(255).
+(default: 24)
+.TP
+.B rectangle[=w:h:x:y]
+The plugin responds to the input.conf directive 'change_rectangle'
+that takes two parameters.
+.PD 0
+.RSs
+.IPs w,h
+width and height (default: -1, maximum possible width where boundaries
+are still visible.
+.IPs x,y
+top left corner position (default: -1, uppermost leftmost)
+.RE
+.PD 1
+.TP
+.B expand[=w:h:x:y:o]
+Expands (not scales) movie resolution to the given value and places the
+unscaled original at coordinates x, y.
+Can be used for placing subtitles/\:OSD in the resulting black bands.
+.RSs
+.IPs w,h
+expanded width,height (default: original width,height).
+Negative values for w and h are treated as offsets to the original size.
+
+.I EXAMPLE
+.PD 0
+.RSs
+.IP expand=0:-50:0:0
+adds a 50 pixel border to the bottom of the picture
+.RE
+.PD 1
+.IPs x,y
+position of original image on the expanded image (default: center)
+.IPs o
+OSD/subtitle rendering
+.RSss
+0: disable (default)
+.br
+1: enable
+.REss
+.RE
+.TP
+.B flip
+Flips the image upside down.
+See also option \-flip.
+.TP
+.B mirror
+Mirrors the image on the Y axis.
+.TP
+.B rotate[=<0-7>]
+Rotates and flips (optional) the image +/\:\- 90 degrees.
+For parameters between 4-7 rotation is only done if the movie's geometry is
+portrait and not landscape.
+.TP
+.B scale[=w:h[:c[:p]]]
+Scales the image with the software scaler (slow) and performs a YUV<\->RGB
+colorspace conversion (also see \-sws option).
+.RSs
+.IPs w,h
+new width/height after scaling (default: original width,height)
+Note: If -zoom is used, and underlying filters (including libvo) are
+incapable of scaling, then it defaults to d_width/\:d_height!
+.RSss
+ 0:   scaled d_width/\:d_height
+.br
+-1:   original width/\:height
+.br
+-2:   Calculate w/\:h using the other dimension and the prescaled aspect ratio.
+.br
+-3:   Calculate w/\:h using the other dimension and the original aspect ratio.
+.REss
+.IPs c
+chroma skipping
+.RSss
+0: use all available input lines for chroma
+.br
+1: use only every 2. input line for chroma
+.br
+2: use only every 4. input line for chroma
+.br
+3: use only every 8. input line for chroma
+.REss
+.IPs p
+scaling parameter (depends upon the scaling method used)
+.RSss
+-sws 2 (bicubic):  sharpness (0 (soft) - 100 (sharp))
+.br
+-sws 7 (gaussian): sharpness (0 (soft) - 100 (sharp))
+.br
+-sws 9 (lanczos):  filter length (1 - 10)
+.REss
+.RE
+.TP
+.B dsize={aspect|w:h}
+Changes the intended display size/aspect at an arbitrary point in the
+filter chain.
+Aspect can be given as a fraction (4/3) or floating point number
+(1.33).
+Alternatively, you may specify the exact display width and height
+desired.
+Note that this filter does NOT do any scaling itself; it just affects
+what later scalers (software or hardware) will do when auto-scaling to
+correct aspect.
+.TP
+.B yuy2
+Forces software YV12/\:I420 or 422P to YUY2 conversion.
+Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
+.TP
+.B yvu9
+Forces software YVU9 to YV12 colorspace conversion.
+Deprecated in favor of the software scaler.
+.TP
+.B rgb2bgr[=swap]
+RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion.
+.PD 0
+.RSs
+.IPs swap
+Also perform  R <\-> B swapping.
+.RE
+.PD 1
+.TP
+.B palette
+RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette.
+.TP
+.B format[=fourcc]
+Restricts the colorspace for the next filter without doing any conversion.
+Use together with the scale filter for a real conversion.
+.PD 0
+.RSs
+.IPs fourcc
+format name like rgb15, bgr24, yv12, etc (default: yuy2)
+.RE
+.PD 1
+.TP
+.B pp[=filter1[:option1[:option2...]]/[-]filter2...] (see \-pphelp too)
+This option enables usage of MPlayer's internal postprocessing filter,
+and also gives an interface where you can pass options to the named filter.
+To get a list of available filters, use \-pphelp.
+
+Note that each sub-filter must be separated with a / sign.
+.br
+Each filter defaults to 'c' (chrominance).
+.br
+The keywords accept a '\-' prefix to disable the option.
+.br
+A ':' followed by a letter may be appended to the option to indicate its
+scope:
+.PD 0
+.RSs
+.IPs a
+Automatically switches the filter off if the CPU is too slow.
+.IPs c
+Do chrominance filtering, too.
+.IPs y
+Do not do chrominance filtering (only luminance filtering).
+.RE
+.PD 1
+
+.RS
+.I EXAMPLES:
+.RE
+.PD 0
+.RSs
+.IPs "\-vf pp=hb/vb/dr/al/lb"
+.IPs "\-vf pp=hb/vb/dr/al/lb"
+.IPs "\-vf pp=de/\-al"
+default filters without brightness/\:contrast correction
+.IPs "\-vf pp=de/tn:1:2:3"
+enable default filters & temporal denoiser
+.IPs "\-vf pp=hb:y/vb:a \-autoq 6"
+deblock horizontal only luminance and switch vertical deblocking on or
+off automatically depending on available CPU time
+.RE
+.PD 1
+.TP
+.B test
+Generate various test patterns.
+.TP
+.B lavc[=quality:fps]
+Fast software YV12 to MPEG1 conversion with libavcodec for use with DVB/\:DXR3.
+Faster and of better quality than \-vf fame.
+.RSs
+.IPs quality
+.RSss
+1 \- 31: fixed qscale
+.br
+32 \-:   fixed bitrate in kBits
+.REss
+.IPs fps\ \ 
+force output fps (float value) (default: 0, autodetect based on height)
+.RE
+.TP
+.B fame
+Fast software YV12 to MPEG1 conversion with libfame for use with DVB/\:DXR3.
+.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
+(\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc).
+.RSs
+.IPs aspect
+control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
+576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
+.RE
+.TP
+.B "noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]"
+Adds noise.
+.PD 0
+.RSs
+.IPs <0\-100>
+luma noise
+.IPs <0\-100>
+chroma noise
+.IPs u
+uniform noise (gaussian otherwise)
+.IPs t
+temporal noise (noise pattern changes between frames)
+.IPs a
+averaged temporal noise (smoother, but a lot slower)
+.IPs h
+high quality (slightly better looking, slightly slower)
+.IPs p
+mix random noise with a (semi)regular pattern
+.RE
+.PD 1
+.
+.TP
+.B "denoise3d[=luma:chroma:time]"
+This filter aims to reduce image noise producing smooth images and making still
+images really still (This should enhance compressibility.).
+It can be given from 0 to 3 parameters.   If you omit a parameter, a reasonable
+value will be inferred.
+.PD 0
+.RSs
+.IPs luma
+spatial luma strength (default = 4)
+.IPs chroma
+spatial chroma strength (default = 3)
+.IPs time
+temporal strength (default = 6)
+.RE
+.PD 1
+.TP
+.B "hqdn3d[=luma:chroma:time]"
+High precision/\:quality version of the denoise3d filter.
+Parameters and usage are the same.
+.TP
+.B eq[=bright:cont]
+Software equalizer with interactive controls just like the hardware
+equalizer, for cards/\:drivers that do not support brightness and
+contrast controls in hardware.
+Might also be useful with MEncoder, either for fixing poorly captured
+movies, or for slightly reducing contrast to mask artifacts and get by
+with lower bitrates.
+Initial values in the range -100 \- 100 may be given on the command line.
+.TP
+.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.
+The parameters are given as floating point values.
+Parameters rg, gg, bg are the independent gamma values for the Red, Green
+and Blue components.
+Defaults are 1.0, brightness=0.0.
+Value ranges are 0.1\-10 for gammas, -2\-2 for contrast (negative values result
+in a negative image), -1\-1 for brightness and 0\-3 for saturation.
+.TP
+.B halfpack[=f]
+Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
+keeping all chroma samples.
+Useful for output to low-resolution display devices when hardware downscaling
+is poor quality or is not available.
+Can also be used as a primitive luma-only deinterlacer with very low cpu
+usage.
+By default, halfpack averages pairs of lines when downsampling.
+The optional parameter f can be 0 to only use even lines, or 1 to only use
+odd lines.
+Any other value for f gives the default (averaging) behavior.
+.TP
+.B ilpack
+When interlaced video is stored in YUV 4:2:0 formats, chroma
+interlacing does not line up properly due to vertical downsampling of
+the chroma channels.
+This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
+the chroma lines in their proper locations, so that in any given
+scanline, the luma and chroma data both come from the same field.
+.TP
+.B dint[=sense:level]
+Detects and drops first of interlaced frames in video stream.
+Values can be from 0.0 to 1.0 - first (default 0.1) is relative difference
+between neighbor pixels, second (default 0.15) is what part of image have to
+be detected as interlaced to drop the frame.
+.TP
+.B lavcdeint
+Use libavcodec's deinterlace filter.
+.TP
+.B "unsharp=l|cWxH:amount[:l|cWxH:amount]"
+Unsharp mask / gaussian blur.
+.RSs
+.IPs l
+Apply effect on luma component.
+.IPs c
+Apply effect on chroma components.
+.IPs WxH
+width and height of the matrix, odd sized in both directions
+(min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
+.IPs amount
+Relative amount of sharpness/\:blur to add to the image
+(a sane range should be -1.5 \- 1.5).
+.RSss
+<0: blur
+.br
+>0: sharpen
+.REss
+.RE
+.TP
+.B swapuv
+Swap U & V plane.
+.TP
+.B "il=[d|i][s][:[d|i][s]]"
+(de)interleaves lines.
+The goal of this filter is to add the ability to process interlaced images
+pre-field without deinterlacing them.
+You can filter your interlaced DVD and play it on a TV without breaking the
+interlacing.
+While deinterlacing (with the postprocessing filter) removes interlacing
+permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
+2 fields (so called half pictures), so you can process (filter) them
+independently and then re-interleave them.
+.PD 0
+.RSs
+.IPs d
+deinterleave
+.IPs i
+interleave
+.IPs s
+swap fields (exchange even & odd lines)
+.RE
+.PD 1
+.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).
+.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:
+.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!)
+.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.
+.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.
+.IPs tr0, tr1, tr2, tr3
+Threshold values to be used in certain modes.
+.RE
+.TP
+.B "ivtc[=1]"
+Experimental "stateless" inverse telecine filter.
+Rather than trying to lock on to a pattern like the detc filter does,
+ivtc makes its decisions independently for each frame.
+This will give much better results for material that has undergone
+heavy editing after telecine was applied, but as a result it is not as
+forgiving of noisy input, for example TV capture.
+The optional parameter (ivtc=1) corresponds to the dr=1 option for the
+detc filter, and should be used with mencoder but not with mplayer.
+As with detc, you must specify the correct output framerate (-ofps
+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).
+.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:
+.PD 0
+.RSs
+.IPs 0
+leave fields unchanged (this will jump/flicker)
+.IPs 1
+interpolate missing lines (the algorithm used might not be so good)
+.IPs 2
+translate fields by 1/4 pixel with linear interp (no jump)
+.IPs 4
+translate fields by 1/4 pixel with 4tap filter (higher quality)
+.RE
+.PD 1
+.TP
+.B "boxblur=radius:power[:radius:power]"
+box blur
+.PD 0
+.RSs
+.IPs radius
+size of the filter
+.IPs power
+How often the filter should be applied.
+.RE
+.PD 1
+.TP
+.B "sab=rad:pf:colorDiff[:rad:pf:colorDiff]"
+shape adaptive blur
+.PD 0
+.RSs
+.IPs rad
+blur filter strength (~0.1\-4.0) (slower if larger)
+.IPs pf
+prefilter strength (~0.1\-2.0)
+.IPs colorDiff
+How different the pixels are allowed to be considered.
+(~0.1-100.0)
+.RE
+.PD 1
+.TP
+.B "smartblur=rad:strength:thresh[:rad:strength:thresh]"
+smart blur
+.PD 0
+.RSs
+.IPs rad\ \ 
+blur filter strength (~0.1\-5.0) (slower if larger)
+.IPs strength
+blur (0.0\-1.0) or sharpen (-1.0\-0.0)
+.IPs thresh
+filter all (0), filter flat areas (0\-30) or filter edges (-30\-0)
+.RE
+.PD 1
+.TP
+.B "perspective=x0:y0:x1:y1:x2:y2:x3:y3:t"
+perspective correction
+.PD 0
+.RSs
+.IPs x0,y0,...
+coordinates of the top left, top right, bottom left, bottom right corners
+.IPs t
+linear (0) or cubic resampling (1)
+.RE
+.PD 1
+.TP
+.B 2xsai
+Use the 2x scale and interpolate algorithm for scaling and smoothing images.
+.TP
+.B 1bpp
+1bpp bitmap to YUV/BGR 8/15/16/32 conversion
+.TP
+.B down3dright[=lines]
+Reposition and resize stereoscopic images.
+Extracts both stereo fields and places them side by side, resizing
+them to maintain the original movie aspect.
+.PD 0
+.RSs
+.IPs lines
+number of lines to select from the middle of the image (default: 12)
+.RE
+.PD 1
+.TP
+.B "bmovl=hidden:opaque:<fifo>"
+Read bitmaps from a FIFO and display them in a window.
+.
+.PD 0
+.RSs
+.IPs hidden
+sets the default value of the 'hidden' flag (boolean)
+.IPs opaque
+flag switching between alphablended (transparent) and opaque (fast) mode
+.IPs fifo
+path/filename for the FIFO (named pipe connecting mplayer -vf bmovl to the
+controlling application)
+.RE
+.PD 1
+
+.RS
+FIFO commands are:
+.RE
+.PD 0
+.RSs
+.IPs RGBA32 width height xpos ypos alpha clear
+followed by width*height*4 Bytes of raw RGBA32 data.
+.IPs ABGR32 width height xpos ypos alpha clear
+followed by width*height*4 Bytes of raw ABGR32 data.
+.IPs RGB24 width height xpos ypos alpha clear
+followed by width*height*3 Bytes of raw RGB32 data.
+.IPs BGR24 width height xpos ypos alpha clear
+followed by width*height*3 Bytes of raw BGR32 data.
+.IPs ALPHA width height xpos ypos alpha
+change alpha for area
+.IPs CLEAR width height xpos ypos
+clear area
+.IPs OPAQUE
+disable all alpha transparency.
+Send "ALPHA 0 0 0 0 0" to enable it again.
+.IPs HIDE
+hide bitmap
+.IPs SHOW
+show bitmap
+.RE
+.PD 1
+
+.RS
+Arguments are:
+.RE
+.PD 0
+.RSs
+.IPs width, height
+size of image/area
+.IPs xpos, ypos
+start blitting at X/Y position   
+.IPs alpha
+set alpha difference.
+If you set this to -255 you can then send a sequence of ALPHA-commands to set
+the area to -225, -200, -175 etc for a nice fade-in-effect! ;)
+.RSss
+0:    same as original
+.br
+255:  makes everything opaque
+.br
+-255: makes everything transparent
+.REss
+.IPs clear
+clear the framebuffer before blitting.
+.RSss
+0: The image will just be blitted on top of the old one, so you don't need to
+send 1,8MB of RGBA32 data everytime a small part of the screen is updated.
+.br
+1: clear
+.REss
+.RE
+.PD 1
+
+
 .SH "ENCODING OPTIONS (MENCODER ONLY)"
 .TP
 .B \-audio-density <1\-50>
@@ -3524,7 +3749,7 @@
 specify the motion detection quality (default=6)
 .IPs interlacing
 enable support for interlaced content (default=off)
-.IPs 4mv
+.IPs 4mv\ \ 
 use 4 motion vectors per macro-block, might give better compression at the
 cost of a slower encoding (default=off)
 .IPs rc_reaction_delay_factor=<value>
@@ -3578,7 +3803,7 @@
 generate DivX5 compatible B-frames (default=on)
 .IPs qpel
 enable quarter-pixel motion estimation (default=off)
-.IPs gmc
+.IPs gmc\ 
 enable global motion compensation, may save bits on panning scenes (default=off)
 .IPs chroma_me
 uses chroma information to estimate motion (default=off)
@@ -3617,220 +3842,6 @@
 
 
 .\" --------------------------------------------------------------------------
-.\" Keyboard control
-.\" --------------------------------------------------------------------------
-.
-.SH "KEYBOARD CONTROL"
-.I NOTE:
-.br
-MPlayer has a fully configurable, command driven, control layer
-which allow you to control MPlayer using keyboard, mouse, joystick
-or remote control (using lirc).
-.br
-The default configuration file for the input system is
-~/.mplayer/\:input.conf but it can be overriden
-using the \-input conf option.
-.br
-These keys may/\:may not work, depending on your video output driver.
-.TP
-.B general control
-.PD 0
-.RSs
-.IPs "<\- and \->"
-seek backward/\:forward 10 seconds
-.IPs "up and down"
-seek backward/\:forward  1 minute
-.IPs "pgup and pgdown"
-seek backward/\:forward 10 minutes
-.IPs "< and >"
-backward/\:forward in playlist
-.IPs "HOME and END"
-go to next/\:previous playtree entry in the parent list
-.IPs "INS and DEL"
-go to next/\:previous alternative source (asx playlist only)
-.IPs "p / SPACE"
-pause movie (any key unpauses)
-.IPs "q / ESC"
-stop playing and quit
-.IPs "+ and \-"
-adjust audio delay by +/\:\- 0.1 second
-.IPs "/ and *"
-decrease/\:increase volume
-.IPs "9 and 0"
-decrease/\:increase volume
-.IPs m\ \ \ \ 
-mute sound
-.IPs f\ \ \ \ 
-toggle fullscreen
-.IPs "w and e"
-decrease/\:increase panscan range
-.IPs o\ \ \ \ 
-toggle between OSD states: none / seek / seek+timer
-.IPs d\ \ \ \ 
-toggle frame dropping
-.IPs v\ \ \ \ 
-toggle subtitle visibility
-.IPs j\ \ \ \ 
-switch subtitle language
-.IPs a\ \ \ \ 
-toggle subtitle aligment: top/middle/bottom
-.IPs "z and x"
-adjust subtitle delay by +/\:\- 0.1 second
-.IPs "r and t"
-adjust subtitle position
-.IPs "i"
-set EDL mark
-
-.PP
-(The following keys are valid only when using a hardware accelerated video
-output (xv, (x)vidix, (x)mga, etc), or the software equalizer filter
-(-vf eq or -vf eq2).
-
-.IPs "1 and 2"
-adjust contrast
-.IPs "3 and 4"
-adjust brightness
-.IPs "5 and 6"
-adjust hue
-.IPs "7 and 8"
-adjust saturation
-.RE
-.PD 1
-.
-.TP
-.B GUI keyboard control
-.PD 0
-.RSs
-.IPs "ENTER"
-start playing
-.IPs s\ \ \ \ 
-stop playing
-.IPs l\ \ \ \ 
-load file
-.IPs c\ \ \ \ 
-skin browser
-.IPs p\ \ \ \ 
-toggle playlist
-.RE
-.PD 1
-.
-.TP
-.B TV input control
-.PD 0
-.RSs
-.IPs "h and k"
-select previous/\:next channel
-.IPs n\ \ \ \ 
-change norm
-.IPs u\ \ \ \ 
-change channel list
-.RE
-.PD 1
-.
-.TP
-.B DVDNAV input control
-.PD 0
-.RSs
-.IPs "K,J,H,L"
-browse up/\:down/\:left/\:right
-.IPs M\ \ \ \ 
-jump to main menu
-.IPs S\ \ \ \ 
-select
-.RE
-.PD 1
-
-
-.\" --------------------------------------------------------------------------
-.\" Slave mode protocol
-.\" --------------------------------------------------------------------------
-.
-.SH "SLAVE MODE PROTOCOL"
-If the \-slave option is given, playback is controlled by a
-line\-based protocol.
-Each line must contain one of the following commands:
-.TP
-.B Commands
-.RSs
-.IPs "seek <value> [type=<0/\:1/\:2>]"
-Seek to some place in the movie.
-Type 0 is a relative seek of +/\:- <value> seconds.
-Type 1 seek to <value> % in the movie.
-Type 2 is a seek to an absolute position of <value> seconds.
-.IPs "edl_mark"
-????
-.IPs "audio_delay <value>"
-Adjust the audio delay of value seconds
-.IPs quit
-Quit MPlayer
-.IPs pause
-Pause/\:unpause the playback
-.IPs grap_frames
-Somebody know ?
-.IPs "pt_step <value> [force=<value>]"
-Go to next/\:previous entry in the playtree.
-.IPs "pt_up_step <value> [force=<value>]"
-Like pt_step but it jumps to next/\:previous in the parent list.
-.IPs "alt_src_step <value>"
-When more than one source is available it selects the next/\:previous one
-(only supported by asx playlist).
-.IPs "sub_delay <value> [abs=<value>]"
-Adjust the subtitles delay of +/\:- <value> seconds or set it to <value>
-seconds when abs is non zero.
-.IPs "osd [level=<value>]"
-Toggle OSD mode or set it to level when level >= 0.
-.IPs "volume <dir>"
-Increase/\:decrease volume
-.IPs "use_master"
-Switch volume control between master and pcm.
-.IPs "mute"
-Mute/\:unmute sound output.
-.IPs "[contrast|brightness|hue|saturation] <\-100\-100> [abs=<value>]"
-Set/\:Adjust video parameters.
-.IPs "frame_drop [type=<value>]"
-Toggle/\:Set frame dropping mode.
-.IPs "sub_alignment <value>"
-Set subtitle alignment.
-.IPs "sub_visibility"
-Toggle subtitle visibility.
-.IPs "sub_pos <value>"
-Adjust subtitles position.
-.IPs "vobsub_lang"
-Switch the subtitle language when using VOBSub subtitles.
-.IPs "get_percent_pos"
-???
-.IPs "get_time_length"
-???
-.IPs "vo_fullscreen"
-Switch to fullscreen mode.
-.IPs "panscan value [value2]"
-???
-.IPs "loadfile url"
-Load the given file/\:url.
-.IPs "loadlist file"
-Load the given playlist file.
-.IPs "change_rectangle val1 val2"
-??? used by the rectangle video filter.
-.IPs "dvdnav button"
-Press the given dvdnav button.
-.br
-1 is up, 2 is down, 3 is left, 4 is right, 5 is menu and 6 is select.
-.IPs "tv_step_channel <dir>"
-Select next/\:previous tv channel.
-.IPs "tv_step_norm"
-Change TV norm.
-.IPs "tv_step_chanlist"
-Change channel list.
-.IPs "tv_set_channel channel"
-Set the current TV channel.
-.IPs "tv_last_channel"
-Set the current TV channel to the last one.
-.IPs "gui_[loadsubtitle|about|play|stop]"
-GUI actions
-.RE
-
-
-.\" --------------------------------------------------------------------------
 .\" Files
 .\" --------------------------------------------------------------------------
 .
--- a/DOCS/tech/manpage.txt	Fri May 30 18:48:44 2003 +0000
+++ b/DOCS/tech/manpage.txt	Sat May 31 16:41:41 2003 +0000
@@ -90,6 +90,8 @@
 GENERAL NOTES
     Some general notes about the options and a description of the config file
     format.
+KEYBOARD CONTROL
+    A description of MPlayer's input system and the default keyboard controls.
 PLAYER OPTIONS (MPLAYER ONLY)
     User interface option descriptions (MPlayer only).
 DEMUXER/STREAM OPTIONS
@@ -103,13 +105,11 @@
 VIDEO OUTPUT OPTIONS (MPLAYER ONLY)
     Video output layer (vo) option descriptions (MPlayer only).
 DECODING/FILTERING OPTIONS
-    Decoding and filter layer options (ad, vd, vf, pl).
+    Decoding/Filtering layer options (ad, vd, pl).
+VIDEO FILTERS
+    Video filter description (vf)
 ENCODING OPTIONS (MENCODER ONLY)
     Encoding option descriptions (ve) (MEncoder only).
-KEYBOARD CONTROL
-    A description of MPlayer's input system and the default keyboard controls.
-SLAVE MODE PROTOCOL
-    A description of the slave mode protocol (-slave).
 FILES
     A list and description of all installed/used files/directories.
 EXAMPLES
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/DOCS/tech/slave.txt	Sat May 31 16:41:41 2003 +0000
@@ -0,0 +1,80 @@
+SLAVE MODE PROTOCOL
+-------------------
+
+If the -slave option is given, playback is controlled by a line-based protocol.
+Each line must contain one of the following commands:
+
+seek <value> [type=<0/\:1/\:2>]
+	Seek to some place in the movie.
+	Type 0 is a relative seek of +/\:- <value> seconds.
+	Type 1 seek to <value> % in the movie.
+	Type 2 is a seek to an absolute position of <value> seconds.
+edl_mark
+	????
+audio_delay <value>
+	Adjust the audio delay of value seconds
+quit
+	Quit MPlayer
+pause
+	Pause/\:unpause the playback
+grap_frames
+	Somebody know ?
+pt_step <value> [force=<value>]
+	Go to next/\:previous entry in the playtree.
+pt_up_step <value> [force=<value>]
+	Like pt_step but it jumps to next/\:previous in the parent list.
+alt_src_step <value>
+	When more than one source is available it selects the next/\:previous one
+	(only supported by asx playlist).
+sub_delay <value> [abs=<value>]
+	Adjust the subtitles delay of +/\:- <value> seconds or set it to <value>
+	seconds when abs is non zero.
+osd [level=<value>]
+	Toggle OSD mode or set it to level when level >= 0.
+volume <dir>
+	Increase/\:decrease volume
+use_master
+	Switch volume control between master and pcm.
+mute
+	Mute/\:unmute sound output.
+[contrast|brightness|hue|saturation] <-100-100> [abs=<value>]
+	Set/\:Adjust video parameters.
+frame_drop [type=<value>]
+	Toggle/\:Set frame dropping mode.
+sub_alignment <value>
+	Set subtitle alignment.
+sub_visibility
+	Toggle subtitle visibility.
+sub_pos <value>
+	Adjust subtitles position.
+vobsub_lang
+	Switch the subtitle language when using VOBSub subtitles.
+get_percent_pos
+	???
+get_time_length
+	???
+vo_fullscreen
+	Switch to fullscreen mode.
+panscan value [value2]
+	???
+loadfile url
+	Load the given file/\:url.
+loadlist file
+	Load the given playlist file.
+change_rectangle val1 val2
+	??? used by the rectangle video filter.
+dvdnav button
+	Press the given dvdnav button.
+	1 is up, 2 is down, 3 is left, 4 is right, 5 is menu and 6 is select.
+tv_step_channel <dir>
+	Select next/\:previous tv channel.
+tv_step_norm
+	Change TV norm.
+tv_step_chanlist
+	Change channel list.
+tv_set_channel channel
+	Set the current TV channel.
+tv_last_channel
+	Set the current TV channel to the last one.
+gui_[loadsubtitle|about|play|stop]
+	GUI actions