VIDEO OUTPUT DRIVERS section added.

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@11750 b3059339-0415-0410-9bf9-f77b7e298cf2

2 files changed, 252 insertions, 22 deletions

diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1
index 268dbb8084..88d63f0b08 100644
--- a/DOCS/man/en/mplayer.1
+++ b/DOCS/man/en/mplayer.1
@@ -1843,28 +1843,6 @@ Turns off xscreensaver at startup and turns it on again on exit.
 Try to change to a better video mode.
 dga, x11/\:xv (XF86VidMode) and sdl output drivers support it.
 .TP
-.B \-vo <driver1[:device],driver2,...[,]>
-Specify a priority list of video output drivers (optionally with device) to be
-used.
-With SDL and GGI 'device' is valid, too, it means subdriver then.
-.br
-.I NOTE:
-See \-vo help for a full list of available drivers.
-.br
-If the list has a trailing ',' it will fallback to drivers not listed.
-
-.I EXAMPLE:
-.PD 0
-.RSs
-.IPs "\-vo xmga,xv,"
-Try Matrox kernel driver, then Xv driver, then others
-.br
-.IPs "\-vo sdl:aalib"
-specify the SDL subdriver
-.RE
-.PD 1
-.
-.TP
 .B \-vsync \ \ 
 Enables VBI for vesa.
 .TP
@@ -3307,6 +3285,256 @@ fd instructs the filter to always perform the requested decimation (ugly).
 .RE
 .
 .
+.SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
+Video output drivers are interfaces to different output facilities.
+The syntax is:
+.TP
+.B \-vo <driver1[:option],driver2,...[,]>
+Specify a priority list of video output drivers to be used.
+.PP
+If the list has a trailing ',' it will fall back to drivers not listed on the
+command line.
+Suboptions are optional and can mostly be omitted.
+.br
+.I NOTE:
+See \-vo help for a list of compiled-in drivers.
+
+.I EXAMPLE:
+.PD 0
+.RSs
+.IPs "\-vo xmga,xv,"
+Try the Matrox X11 driver, then the Xv driver, then others.
+.br
+.IPs "\-vo directx:noaccel"
+Uses the DirectX driver with acceleration features turned off.
+.RE
+.PD 1
+.
+
+Available output drivers are:
+.
+.TP
+.B xv (X11 only)
+Uses the XVideo extension of XFree86 4.x to enable hardware
+accelerated playback.
+If you cannot use a hardware specific driver, this is probably
+the best option.
+.TP
+.B x11 (X11 only)
+Shared memory output driver without hardware acceleration that
+works whenever X11 is present.
+.TP
+.B xover (X11 only)
+Adds X11 support to all overlay based video output drivers.
+Currently only supported by tdfx_vid.
+.TP
+.B xvmc (X11 only)
+This video output driver employs the XvMC (X Video Motion Compensation)
+extension of XFree86 4.x.
+.TP
+.B dga (X11 only)
+Output video through the XFree86 Direct Graphics Access extension.
+Considered obsolete.
+.TP
+.B sdl\ \ \ \ 
+Highly platform independent SDL (Simple Directmedia Layer) library
+output driver.
+.TP
+.B vidix\ \ 
+VIDIX (VIDeo Interface for *niX) is an interface to the
+video acceleration features of different graphics cards.
+Very fast output driver on cards that support it.
+.TP
+.B xvidix (X11 only)
+VIDIX running under X11.
+.TP
+.B cvidix\ 
+VIDIX running in a console.
+.TP
+.B winvidix (Windows only)
+Windows version of the VIDIX driver.
+.TP
+.B directx (Windows only)
+Output driver that uses the DirectX interface.
+.PD 0
+.RSs
+.IPs noaccel
+Turns off hardware acceleration.
+Try this option if you have display problems.
+.RE
+.PD 1
+.TP
+.B fbdev (Linux only)
+Uses the kernel framebuffer to output video.
+.TP
+.B fbdev2 (Linux only)
+Uses the kernel framebuffer to output video,
+alternative implementation.
+.TP
+.B vesa\ \ \ 
+Very general output driver that should work on any VESA VBE 2.0
+compatible card.
+.PD 0
+.RSs
+.IPs dga\ \ 
+Turns on DGA mode.
+.IPs nodga
+Turns off DGA mode.
+.IPs vidix
+FIXME: document this
+.IPs lvo\ \ 
+FIXME: document this
+.RE
+.PD 1
+.TP
+.B svga\ \ \ 
+Output video using the SVGA library.
+.TP
+.B gl\ \ \ \ \ 
+OpenGL output driver.
+.TP
+.B gl2\ \ \ \ 
+OpenGL output driver, second generation.
+.TP
+.B null\ \ \ 
+Produces no video output.
+Useful for benchmarking.
+.TP
+.B aa\ \ \ \ \ 
+ASCII art output driver that works on a text console.
+.TP
+.B bl\ \ \ \ \ 
+Video playback using the Blinkenlights UDP protocol.
+This driver is highly hardware specific.
+.TP
+.B ggi\ \ \ \ 
+Output driver for the GGI graphics system.
+.TP
+.B directfb
+Play video using the DirectFB library.
+.PD 0
+.RSs
+.IPs number
+Selects layer.
+.RE
+.PD 1
+.TP
+.B directfb2
+Play video using the DirectFB library, second generation.
+.TP
+.B dfbmga\ 
+Matrox G400/G450/G550 specific output driver that uses the DirectFB library.
+Enables CRTC2 (second head), displaying video independently of the first head.
+.TP
+.B mga (Linux only)
+Matrox specific output driver that makes use of the YUV back
+end scaler on Gxxx cards through a kernel module.
+If you have a Matrox card, this is the fastest option.
+.TP
+.B xmga (Linux, X11 only)
+The mga output driver, running in an X11 window.
+.TP
+.B syncfb\ 
+Video output driver for the SyncFB kernel module, which provides
+special hardware features of Matrox Gxxx cards like hardware
+deinterlacing, scaling and synchronizing your video output to
+the vertical retrace of your monitor.
+.TP
+.B 3dfx (Linux only)
+This driver employs the tdfx framebuffer driver to play movies with
+YUV acceleration.
+.TP
+.B tdfx_vid (Linux only)
+3Dfx specific output driver.
+Works in conjunction with a kernel module.
+.TP
+.B dxr2\ \ \ 
+Creative DXR2 specific output driver.
+Also see the -dxr2 option.
+.PD 0
+.RSs
+.IPs x11
+Enables overlay.
+.IPs xv
+Enables overlay.
+.RE
+.PD 1
+.TP
+.B dxr3\ \ \ 
+Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
+Hollywood Plus) specific output driver.
+Also see the lavc video filter.
+.PD 0
+.RSs
+.IPs overlay
+Activates the overlay instead of TVOut.
+.IPs prebuf
+Turns on prebuffering.
+.IPs sync
+Will turn on the new sync-engine.
+.IPs norm=<norm>
+Specifies the TV norm.
+.RSss
+0: Does not change current norm (default).
+.br
+1: Auto-adjust using PAL/NTSC.
+.br
+2: Auto-adjust using PAL/PAL-60.
+.br
+3: PAL
+.br
+4: PAL-60
+.br
+5: NTSC
+.REss
+.IPs device=<number>
+Specifies the device number to use if you have more than one em8300 card.
+.RE
+.PD 1
+.TP
+.B mpegpes
+DVB specific output driver.
+.TP
+.B zr\ \ \ \ \ 
+Output driver for a number of MJPEG capture/playback cards.
+Also see the -zr* options and -zrhelp.
+.TP
+.B zr2\ \ \ \ 
+Output driver for a number of MJPEG capture/playback cards, second generation.
+Also see the zrmjpeg video filter.
+.TP
+.B md5\ \ \ \ 
+Writes md5sums for each frame into a file called 'md5' in the
+current directory.
+Useful for debugging.
+.TP
+.B yuv4mpeg
+Transforms the video stream into a sequence of uncompressed YUV 4:2:0
+images and stores it in a file called 'stream.yuv' in the current
+directory.
+Useful if you want to process the video with the mjpegtools suite.
+.TP
+.B gif89a\ 
+Output each frame into a GIF file in the current directory.
+Each file takes the frame number padded with leading zeros as name.
+.TP
+.B jpeg\ \ \ 
+Output each frame into a JPEG file in the current directory.
+Each file takes the frame number padded with leading zeros as name.
+.TP
+.B pgm\ \ \ \ 
+Output each frame into a PGM file in the current directory.
+Each file takes the frame number padded with leading zeros as name.
+.TP
+.B png\ \ \ \ 
+Output each frame into a PNG file in the current directory.
+Each file takes the frame number padded with leading zeros as name.
+.TP
+.B tga\ \ \ \ 
+Output each frame into a Targa file in the current directory.
+Each file takes the frame number padded with leading zeros as name.
+.
+.
 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
 .TP
 .B \-audio-delay <0.0\-...>
diff --git a/DOCS/tech/manpage.txt b/DOCS/tech/manpage.txt
index 5186e1dcb5..4ea14372ac 100644
--- a/DOCS/tech/manpage.txt
+++ b/DOCS/tech/manpage.txt
@@ -111,6 +111,8 @@ DECODING/FILTERING OPTIONS
     Decoding/Filtering layer options (ad, vd, pl).
 VIDEO FILTERS
     Video filter description (vf)
+VIDEO OUTPUT DRIVERS (MPLAYER ONLY)
+    Video output driver description (vo)
 GENERAL ENCODING OPTIONS (MENCODER ONLY)
     Encoding option descriptions (ve) (MEncoder only).
 CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)