comparison DOCS/man/en/mplayer.1 @ 11749:c04aca6c9161

VIDEO OUTPUT DRIVERS section added.

11748:d99cbb6221cd

.TP
.B \-vm \ \ \ 
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
.B \-wid <window\ id>
This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a

can upscale the resulting MJPEG images to the original size. The option
fd instructs the filter to always perform the requested decimation (ugly).
.RE
.
.
.SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
.TP
.B \-audio-delay <0.0\-...>
Sets the audio delay field in the header.
Default is 0.0, negative values do not work.

11749:c04aca6c9161

.TP
.B \-vm \ \ \ 
Try to change to a better video mode.
dga, x11/\:xv (XF86VidMode) and sdl output drivers support it.
.TP
.B \-vsync \ \ 
Enables VBI for vesa.
.TP
.B \-wid <window\ id>
This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a

can upscale the resulting MJPEG images to the original size. The option
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\-...>
Sets the audio delay field in the header.
Default is 0.0, negative values do not work.