Man / VIDEO OUTPUT DRIVERS

Man / VIDEO OUTPUT DRIVERS

VIDEO OUTPUT DRIVERS (MPLAYER ONLY) †

Video output drivers are interfaces to different video output facili-ties.The syntax is:

-vo <driver1[:suboption1[=value]:...],driver2,...[,]>

Specify a priority list of video output drivers to be used.

If the list has a trailing ',' MPlayer will fall back on drivers not contained in the list. Suboptions are optional and can mostly be omit-ted.

NOTE: See -vo help for a list of compiled-in video output drivers.

EXAMPLE:

-vo xmga,xv,

Try the Matrox X11 driver, then the Xv driver, then oth-ers.

-vo directx:noaccel

Uses the DirectX driver with acceleration features turned off.

Available video output drivers are:

xv (X11 only) †

Uses the XVideo extension of XFree86 4.x to enable hardware ac- celerated playback. If you cannot use a hardware specific driv- er, this is probably the best option. For information about what colorkey is used and how it is drawn run MPlayer with -v option and look out for the lines tagged with [xv common] at the beginning.

port=<number>

Select a specific XVideo port.

ck=<cur|use|set>

Select the source from which the colorkey is taken (de-fault: cur).

• cur The default takes the colorkey currently set in Xv.
• use Use but do not set the colorkey from MPlayer (use -colorkey option to change it).
• set Same as use but also sets the supplied colorkey.

ck-method=<man|bg|auto>

Sets the colorkey drawing method (default: man).

• man Draw the colorkey manually (reduces flicker in some cases).
• bg Set the colorkey as window background.
• auto Let Xv draw the colorkey.

x11 (X11 only) †

Shared memory video output driver without hardware acceleration that works whenever X11 is present.

xover (X11 only) †

Adds X11 support to all overlay based video output drivers.
Currently only supported by tdfx_vid.

<vo_driver>

Select the driver to use as source to overlay on top of X11.

xvmc (X11 with -vc ffmpeg12mc only) †

Video output driver that uses the XvMC (X Video Motion Compensa-tion) extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 de-coding.

port=<number>

Select a specific XVideo port.

(no)benchmark

Disables image display. Necessary for proper benchmark-ing of drivers that change image buffers on monitor re-trace only (nVidia). Default is not to disable image display (nobenchmark).

(no)bobdeint

Very simple deinterlacer. Might not look better than -vf tfields=1, but it is the only deinterlacer for xvmc (default: nobobdeint).

(no)queue

Queue frames for display to allow more parallel work of the video hardware. May add a small (not noticeable) constant A/V desync (default: noqueue).

(no)sleep

Use sleep function while waiting for rendering to finish (not recommended on Linux) (default: nosleep).

ck=cur|use|set

Same as -vo xv:ck (see -vo xv).

ck-method=man|bg|auto

Same as -vo xv:ck-method (see -vo xv).

dga (X11 only) †

Play video through the XFree86 Direct Graphics Access extension. Considered obsolete.

sdl (SDL only) †

Highly platform independent SDL (Simple Directmedia Layer) li- brary video output driver. Since SDL uses its own X11 layer, MPlayer X11 options do not have any effect on SDL.

driver=<driver>

Explicitly choose the SDL driver to use.

(no)forcexv

Use XVideo through the sdl video output driver (default:forcexv).

(no)hwaccel

Use hardware accelerated scaler (default: hwaccel).

vidix †

VIDIX (VIDeo Interface for *niX) is an interface to the video acceleration features of different graphics cards. Very fast video output driver on cards that support it.

<subdevice>

Explicitly choose the VIDIX subdevice driver to use. Available subdevice drivers are cyberblade_vid.so, mach64_vid.so, mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so, radeon_vid.so, rage128_vid.so, sis_vid.so and unichrome_vid.so.

xvidix (X11 only) †

X11 frontend for VIDIX

<subdevice>

same as vidix

cvidix †

Generic and platform independent VIDIX frontend, can even run in a text console with nVidia cards.

<subdevice>

same as vidix

winvidix (Windows only) †

Windows frontend for VIDIX

<subdevice>

same as vidix

directx (Windows only) †

Video output driver that uses the DirectX interface.

noaccel

Turns off hardware acceleration. Try this option if you have display problems.

quartz (Mac OS X only) †

Mac OS X Quartz video output driver. Under some circumstances,it might be more efficient to force a packed YUV output format,with e.g. -vf format=yuy2.

device_id=<number>

Choose the display device to use in fullscreen.

fs_res=<width>:<height>

Specify the fullscreen resolution (useful on slow sys-tems).

macosx (Mac OS X 10.4 or 10.3.9 with QuickTime 7) †

Mac OS X CoreVideo video output driver

device_id=<number>

Choose the display device to use in fullscreen.

fbdev (Linux only) †

Uses the kernel framebuffer to play video.

<device>

Explicitly choose the fbdev device name to use (e.g. /dev/fb0) or the name of the VIDIX subdevice if the de- vice name starts with 'vidix' (e.g. 'vidixsis_vid' for the sis driver).

fbdev2 (Linux only) †

Uses the kernel framebuffer to play video, alternative implemen- tation.

<device>

Explicitly choose the fbdev device name to use (default: /dev/fb0).

vesa †

Very general video output driver that should work on any VESA VBE 2.0 compatible card.

dga

Turns on DGA mode.

nodga

Turns off DGA mode.

neotv_pal

Activate the NeoMagic TV out and set it to PAL norm.

neotv_ntsc

Activate the NeoMagic TV out and set it to NTSC norm.

vidix

Use the VIDIX driver.

lvo:

Activate the Linux Video Overlay on top of VESA mode.

svga †

Play video using the SVGA library.

<video mode>

Specify video mode to use. The mode can be given in a <width>x<height>x<colors> format, e.g. 640x480x16M or be a graphics mode number, e.g. 84.

bbosd

Draw OSD into black bands below the movie (slower).

native

Use only native drawing functions. Thisavoidsdirect rendering, OSD and hardware acceleration.

retrace

Force frame switch onvertical retrace. Usable only with -double. It has the same effect as the -vsync op- tion.

sq

Try to select a video mode with square pixels.

vidix

Use svga with VIDIX.

gl †

OpenGL video output driver, simple version. Video size must be smaller than the maximum texture size of your OpenGL implementa-tion. Intended to work even with the most basic OpenGL imple-mentations, but also makes use of newer extensions, which allow support for more colorspaces and direct rendering. Please use-dr if it works with your OpenGL implementation, since for high-er resolutions this provides a big speedup. The code performs very few checks, so if a feature does not work, this might be because it is not supported by your card/OpenGL implementation even if you do not get any error message. Use glxinfo or a sim-ilar tool to display the supported OpenGL extensions.

(no)manyfmts

Enables support for more (RGB and BGR) color formats (default: enabled). Needs OpenGL version >= 1.2.

slice-height=<0-...>

Number of lines copied to texture in one piece (default:4). 0 for whole image.
NOTE: If YUV colorspace is used (see yuv suboption), special rules apply:

If the decoder uses slice rendering (see -noslices), this setting has no effect, the size of the slices as provided by the decoder is used. If the decoder does not use slice rendering, the de-fault is 16.

(no)osd

Enable or disable support for OSD rendering via OpenGL (default: enabled). This option is for testing; to dis- able the OSD use -osdlevel 0 instead.

(no)scaled-osd

Changes the way the OSD behaves when the size of the window changes (default: disabled). When enabled be- haves more like the other video output drivers, which is better for fixed-size fonts. Disabled looks much better with FreeType fonts and uses the borders in fullscreen mode. Does not work correctly with ass subtitles (see -ass).

osdcolor=<0xRRGGBB>

Color for OSD (default: 0xffffff, corresponds to white).

(no)aspect

Enable or disable aspect scaling and pan-and-scan sup-port (default: enabled). Disabling might increase speed.

rectangle=<0,1,2>

Select usage of rectangular textures which saves videoRAM, but often is slower (default: 0).
0: Use power-of-two textures (default).
1: Use the GL_ARB_texture_rectangle extension.
2: Use the GL_ARB_texture_non_power_of_two extension. In some cases only supported in software and thus very slow.

(no)glfinish

Call glFinish() before swapping buffers. Slower but in some cases more correct output (default: disabled).

swapinterval=<n>

Minimum interval between two buffer swaps, counted in displayed frames (default: 1). 1 is equivalent to en- abling VSYNC, 0 to disabling VSYNC. Values below 0 will leave it at the system default. This limits the framer- ate to (horizontal refresh rate / n). Requires GLX_SGI_swap_control support to work. With some (most/all?) implementations this only works in fullscreen mode.

yuv=<n>

Select the type of YUV to RGB conversion.

0: Use software conversion (default). Compatible with all OpenGL versions. Provides brightness, con- trast and saturation control.
1: Use register combiners. This uses an nVidia-spe- cific extension (GL_NV_register_combiners). At least three texture units are needed. Provides saturation and hue control. This method is fast but inexact.
2: Use a fragment program. Needs the GL_ARB_frag- ment_program extension and at least three texture units. Provides brightness, contrast, saturation and hue control.
3: Use a fragment program using the POW instruction. Needs the GL_ARB_fragment_program extension and at least three texture units. Provides brightness, con- trast, saturation, hue and gamma control. Gamma can also be set independently for red, green and blue. Method 4 is usually faster.
4: Use a fragment program with additional lookup. Needs the GL_ARB_fragment_program extension and at least four texture units. Provides brightness, con- trast, saturation, hue and gamma control. Gamma can also be set independently for red, green and blue.
5: Use ATI-specific method (for older cards). This uses an ATI-specific extension (GL_ATI_fragment_shad- er - not GL_ARB_fragment_shader!). At least three texture units are needed. Provides saturation and hue control. This method is fast but inexact.
6: Use a 3D texture to do conversion via lookup. Needs the GL_ARB_fragment_program extension and at least four texture units. Extremely slow (software emulation) on some (all?) ATI cards since it uses a texture with border pixels. Provides brightness, contrast, saturation, hue and gamma control. Gamma can also be set independently for red, green and blue. Speed depends more on GPU memory bandwidth than other methods.

lscale=<n>

Select the scaling function to use for luminance scal-ing. Only valid for yuv modes 2, 3, 4 and 6.
0: Use simple linear filtering (default).
1: Use bicubic filtering (better quality). Needs one additional texture unit. Older cards will not be able to handle this for chroma at least in fullscreen mode.

cscale=<n>

Select the scaling function to use for chrominance scal-ing. For details see lscale.

customprog=<filename>

Load a custom fragment program from <filename>. See TOOLS/edgedect.fp for an example.

customtex=<filename>

Load a custom "gamma ramp" texture from <filename>. This can be used in combination with yuv=4 or with thecustomprog option.

(no)customtlin

If enabled (default) use GL_LINEAR interpolation, other- wise use GL_NEAREST for customtex texture.

(no)customtrect

If enabled, use texture_rectangle for customtex texture. Default is disabled.

gl2 †

OpenGL video output driver, second generation. Supports OSD and videos larger than the maximum texture size.

(no)glfinish

same as gl (default: enabled)

yuv=<n>

Select the type of YUV to RGB conversion. If set to anything except 0 OSD will be disabled and brightness, contrast and gamma setting is only available via the global X server settings. Apart from this the values have the same meaning as for −vo gl.

null †

Produces no video output. Useful for benchmarking.

aa †

ASCII art video output driver that works on a text console. You can get a list and an explanation of available suboptions executing mplayer −vo aa:help

caca †

Color ASCII art video output driver that works on a text console.

bl †

Video playback using the Blinkenlights UDP protocol. This driver is highly hardware specific.

<subdevice>

Explicitly choose the Blinkenlights subdevice driver to use. It is something like arcade:host=localhost:2323 or hdl:file=name1,file=name2. You must specify a subdevice.

ggi †

GGI graphics system video output driver

<driver>

Explicitly choose the GGI driver to use. Replace any ’,’ that would appear in the driver string by a ’.’.

directfb †

Play video using the DirectFB library.

(no)input

Use the DirectFB instead of the MPlayer keyboard code (default: enabled).

buffermode=single|double|triple

Double and triple buffering give best results if you want to avoid tearing issues. Triple buffering is more efficient than double buffering as it does not block MPlayer while waiting for the vertical retrace. Single buffering should be avoided (default: single).

fieldparity=top|bottom

Control the output order for interlaced frames (default: disabled). Valid values are top = top fields first, bottom = bottom fields first. This option does not have any effect on progressive film material like most MPEG movies are. You need to enable this option if you have tearing issues or unsmooth motions watching interlaced film material.

layer=N

Will force layer with ID N for playback (default: -1 - auto).

dfbopts=<list>

Specify a parameter list for DirectFB.

dfbmga †

Matrox G400/G450/G550 specific video output driver that uses the DirectFB library to make use of special hardware features. Enables CRTC2 (second head), displaying video independently of the first head.

(no)input

same as directfb (default: disabled)

buffermode=single|double|triple

same as directfb (default: triple)

fieldparity=top|bottom

same as directfb

(no)bes

Enable the use of the Matrox BES (backend scaler) (default: disabled). Gives very good results concerning speed and output quality as interpolated picture processing is done in hardware. Works only on the primary head.

(no)spic

Make use of the Matrox sub picture layer to display the OSD (default: enabled).

(no)crtc2

Turn on TV-out on the second head (default: enabled). The output quality is amazing as it is a full interlaced picture with proper sync to every odd/even field.

tvnorm=pal|ntsc|auto

Will set the TV norm of the Matrox card without the need for modifying /etc/directfbrc (default: disabled). Valid norms are pal = PAL, ntsc = NTSC. Special norm is auto (auto-adjust using PAL/NTSC) because it decides which norm to use by looking at the framerate of the movie.

mga (Linux only) †

Matrox specific video 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.

<device>

Explicitly choose the Matrox device name to use (default: /dev/mga_vid).

xmga (Linux, X11 only) †

The mga video output driver, running in an X11 window.

<device>

Explicitly choose the Matrox device name to use (default: /dev/mga_vid).

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.

s3fb (Linux only) (see also −vf yuv2 and −dr) †

S3 Virge specific video output driver. This driver supports the card’s YUV conversion and scaling, double buffering and direct rendering features. Use −vf yuy2 to get hardware-accelerated YUY2 rendering, which is much faster than YV12 on this card.

<device>

Explicitly choose the fbdev device name to use (default: /dev/fb0).

3dfx (Linux only) †

3dfx-specific video output driver that directly uses the hardware on top of X11. Only 16 bpp are supported.

tdfxfb (Linux only) †

This driver employs the tdfxfb framebuffer driver to play movies with YUV acceleration on 3dfx cards.

<device>

Explicitly choose the fbdev device name to use (default: /dev/fb0).

tdfx_vid (Linux only) †

3dfx-specific video output driver that works in combination with the tdfx_vid kernel module.

<device>

Explicitly choose the device name to use (default: /dev/tdfx_vid).

dxr2 (also see −dxr2) (DXR2 only) †

Creative DXR2 specific video output driver.

<vo_driver>

Output video subdriver to use as overlay (x11, xv).

dxr3 (DXR3 only) †

Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs Hollywood Plus) specific video output driver. Also see the lavc video filter.

overlay

Activates the overlay instead of TVOut.

prebuf

Turns on prebuffering.

sync

Will turn on the new sync-engine.

norm=<norm>

Specifies the TV norm.

0: Does not change current norm (default).
1: Auto-adjust using PAL/NTSC.
2: Auto-adjust using PAL/PAL-60.
3: PAL
4: PAL-60
5: NTSC

<0−3>

Specifies the device number to use if you have more than one em8300 card.

ivtv (IVTV only) †

Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500) specific video output driver for TV-Out. Also see the lavc video filter.

device

Explicitly choose the MPEG decoder device name to use (default: /dev/video16).

output

Explicitly choose the TV-Out output to be used for the video signal.

mpegpes (DVB only) †

Video output driver for DVB cards that writes the output to an MPEG-PES file if no DVB card is installed.

card=<1−4>

Specifies the device number to use if you have more than one DVB output card (V3 API only, such as 1.x.y series drivers).

<filename>

output filename (default: ./grab.mpg)

zr (also see −zr* and −zrhelp) †

Video output driver for a number of MJPEG capture/playback cards.

zr2 (also see the zrmjpeg video filter) †

Video output driver for a number of MJPEG capture/playback cards, second generation.

dev=<device>

Specifies the video device to use.

norm=<PAL|NTSC|SECAM|auto>

Specifies the video norm to use (default: auto).

(no)prebuf

(De)Activate prebuffering, not yet supported.

md5sum †

Calculate MD5 sums of each frame and write them to a file. Supports RGB24 and YV12 colorspaces. Useful for debugging.

outfile=<value>

Specify the output filename (default: ./md5sums).

yuv4mpeg †

Transforms the video stream into a sequence of uncompressed YUV 4:2:0 images and stores it in a file (default: ./stream.yuv). The format is the same as the one employed by mjpegtools, so this is useful if you want to process the video with the mjpegtools suite. It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format. You can combine it with the −fixed-vo option to concatenate files with the same dimensions and fps value.

interlaced

Write the output as interlaced frames, top field first.

interlaced_bf

Write the output as interlaced frames, bottom field first.

file=<filename>

Write the output to <filename> instead of the default stream.yuv.

' NOTE ': If you do not specify any option the output is progressive (i.e. not interlaced).

訳文
video streamを非圧縮YUV 4:2:0イメージに変換し、ファイルに書き出す(default: ./stream.yuv)。このフォーマットはmjpegtoolsで使われるものと同じなので、mjpegtools suiteでvideoを扱いたい時に便利。YV12, RGB (24 bpp) and BGR (24 bpp) formatをサポート。解像度とfpsが同じなら−fixed-vo optionでファイルを結合（＊concatenate＊）できる。

interlaced

出力をインターレースドフレーム、top field firstで書き出し。

interlaced_bf

出力をインターレースドフレーム、bottom field firstで書き出し。

file=<filename>

出力をデフォルトのstream.yuvの代わりに、<filename>へ書き出し。

' NOTE ':オプションを何も指定しなければ、出力はプログレッシブ（ノット・インターレースド）になる。

gif89a †

Output each frame into a single animated GIF file in the current directory. It supports only RGB format with 24 bpp and the output is converted to 256 colors.

<fps>

Float value to specify framerate (default: 5.0).

<filename>

Specify the output filename (default: ./out.gif).

NOTE: You must specify the framerate before the filename or the framerate will be part of the filename.

EXAMPLE:

mplayer video.nut −vo gif89a:fps=15.0:filename=test.gif

jpeg †

Output each frame into a JPEG file in the current directory. Each file takes the frame number padded with leading zeros as name.

[no]progressive

Specify standard or progressive JPEG (default: noprogressive).

[no]baseline

Specify use of baseline or not (default: baseline).

optimize=<0−100>

optimization factor (default: 100)

smooth=<0−100>

smooth factor (default: 0)

quality=<0−100>

quality factor (default: 75)

outdir=<dirname>

Specify the directory to save the JPEG files to (default: ./).

subdirs=<prefix>

Create numbered subdirectories with the specified prefix to save the files in instead of the current directory.

maxfiles=<value>

Maximum number of files to be saved per subdirectory. Must be equal to or larger than 1 (default: 1000).

pnm †

Output each frame into a PNM file in the current directory. Each file takes the frame number padded with leading zeros as name. It supports PPM, PGM and PGMYUV files in both raw and ASCII mode. Also see pnm(5), ppm(5) and pgm(5).

ppm

Write PPM files (default).

pgm

Write PGM files.

pgmyuv

Write PGMYUV files. PGMYUV is like PGM, but it also contains the U and V plane, appended at the bottom of the picture.

raw

Write PNM files in raw mode (default).

ascii

Write PNM files in ASCII mode.

outdir=<dirname>

Specify the directory to save the PNM files to (default: ./).

subdirs=<prefix>

Create numbered subdirectories with the specified prefix to save the files in instead of the current directory.

maxfiles=<value>

Maximum number of files to be saved per subdirectory. Must be equal to or larger than 1 (default: 1000).

png †

Output each frame into a PNG file in the current directory. Each file takes the frame number padded with leading zeros as name. 24bpp RGB and BGR formats are supported.

z=<0-9>

Specifies the compression level. 0 is no compression, 9 is maximum compression.

tga †

Output each frame into a Targa file in the current directory. Each file takes the frame number padded with leading zeros as name. The purpose of this video output driver is to have a simple lossless image writer to use without any external library. It supports the BGR[A] color format, with 15, 24 and 32 bpp. You can force a particular format with the format video filter.

EXAMPLE:

mplayer video.nut −vf format=bgr15 −vo tga