Man / VIDEO OUTPUT DRIVERS (MPLAYER ONLY)

-vo help例（Mac） †

$ mplayer -vo help
MPlayer dev-CVS-051115-06:05-4.0.1 (C) 2000-2005 MPlayer Team
AltiVec found
CPU: PowerPC

Available video output drivers:
       macosx  Mac OSX Core Video
       quartz  Mac OSX (Quartz)
       xv      X11/Xv
       x11     X11 ( XImage/Shm )
       xover   General X11 driver for overlay capable video output drivers
       gl      X11 (OpenGL)
       gl2     X11 (OpenGL) - multiple textures version
       sdl     SDL YUV/RGB/BGR renderer (SDL v1.1.7+ only!)
       null    Null video output
       mpegpes Mpeg-PES file
       yuv4mpeg        yuv4mpeg output for mjpegtools
       png     PNG file
       jpeg    JPEG file
       gif89a  animated GIF output
       tga     Targa output
       pnm     PPM/PGM/PGMYUV file
       md5sum  md5sum of each frame

VIDEO OUTPUT DRIVERS (MPLAYER ONLY) †

Video output drivers are interfaces to different video output facilities. The syntax is:

-vo <driver1[:suboption1[=value]:...],driv-er2,...[,]> [#eea15947]

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 option- al and can mostly be omitted.
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 others.

-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 accelerated playback. If you cannot use a hardware specific driver, 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 (default:cur).

cur

>The default takes the colorkey cur-rently 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 sup- plied 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 back- ground.

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 over- lay on top of X11.

xvmc (X11 with -vc †

ffmpeg12mc only) Video output driver that uses the XvMC (X Video Mo- tion Compensation) extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding.

port=<number>

Select a specific XVideo port.

(no)benchmark

Disables image display. Necessary for proper benchmarking of drivers that change image buffers on monitor retrace only (nVidia). Default is not to disable image display (nobenchmark).

(no)queue

Queue frames for display to allow more par- allel 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 ren- dering to finish (not recomended 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 Ac- cess extension. Considered obsolete.

sdl (SDL only) †

Highly platform independent SDL (Simple Directmedia Layer) library 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 graph- ics cards. Very fast video output driver on cards that support it.

<subdevice>

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

xvidix (X11 only) †

X11 frontend for VIDIX

<subdevice>

same as vidix

cvidix †

Generic and platform independent VIDIX frontend, can even run in a textconsole 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 inter- face.

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 for- mat=yuy2.

device_id=<number>

Choose the display device to use in fullscreen.

fs_res=<width>:<height>

Specify the fullscreen resolution (useful on slow systems).

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 device name starts with 'vidix' (e.g. 'vidixsis_vid' for the sis driver).

fbdev2 (Linux only) †

Uses the kernel framebuffer to play video, alterna- tive implementation.

<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> for- mat, 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. This avoids direct rendering, OSD and hardware acceleration.

retrace

Force frame switch on vertical retrace. Usable only with

• double. It has the same effect as the -vsync option.

  sq

  Try to select a video mode with square pix- els.

  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 implementation. Intended to work even with the most basic OpenGL implementations, 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 imple- mentation, since for higher resolutions this pro- vides a big speedup. The code is doing very little 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 similar tool to display the supported OpenGL extensions.

(no)manyfmts

Enables support for more (RGB and BGR) col- or 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.

(no)osd

Enable or disable support for OSD rendering via OpenGL (default: enabled). Mostly for testing, you should use

• osdlevel 0 to dis- able OSD.

  (no)scaled-osd

  Changes the way the OSD behaves when the size of the window changes (default: dis- abled). When enabled behaves 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.

  (no)aspect

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

  rectangle=<0,1,2>

  Select usage of rectangular textures which saves video RAM, but often is slower (de- fault: 0).

  0: Use power-of-two textures (default).
  

1: Use texture_rectangle.

2: Use texture_non_power_of_two.

(no)glfinish

>Call glFinish() before swapping buffers. Slower but in some cases more correct output (default: dis- abled).

swapinter- val=<n>

>Minimum interval in displayed frames between to buffer swaps (de- fault: 1). 1 is equivalent to en- abling VSYNC, 0 to disabling VSYNC. Values < 0 will leave it at the system default. This will limit the framerate to (horizontal re- fresh rate / n). Requires GLX_SGI_swap_control support to work. With some (most/all?) imple- mentations this only works in fullscreen mode.

gl2 †

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

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 proto- col. This driver is highly hardware specific.

<subdevice>

Explicitly choose the Blinkenlights subde- vice driver to use. It's something like arcade:host=localhost:2323 or hdl:file=name1,file=name2. You must speci- fy 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|dou- ble|triple

Double and triple buffering give best re- sults if you want to avoid tearing issues. Triple buffering is more efficent than dou- ble buffering as it doesn't block MPlayer while waiting for the vertical retrace. Single buffering should be avoided (de- fault: 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 doesn't have any effect on progressive film material like most MPEG movies are. You need to enable this option if you have tearing issues/un- smooth motions watching interlaced film ma- terial.

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 spe- cial hardware features. Enables CRTC2 (second head), displaying video independently of the first head.

(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's a full interlaced picture with proper sync to every odd/even field.

(no)input

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

buffermode=single|dou- ble|triple

Double and triple buffering give best re- sults if you want to avoid tearing issues. Triple buffering is more efficent than dou- ble buffering as it doesn't block MPlayer while waiting for the vertical retrace. Single buffering should be avoided (de- fault: triple).

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 doesn't have any effect on progressive film material like most MPEG movies are. You need to enable this option if you have tearing issues/un- smooth motions watching interlaced film ma- terial.

tvnorm=pal|ntsc|auto

Will set the TV norm of the Matrox card without the need for modifying /etc/di- rectfbrc (default: disabled). Valid norms are pal = PAL, ntsc = NTSC. Special norm is auto (auto-adjust using PAL/NTSC) be- cause it decides which norm to use by look- ing 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 win- dow.

<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 re- trace of your monitor.

3dfx (Linux only) †

3Dfx specific video output driver. This driver di- rectly uses the 3Dfx hardware on top of X11. Only 16 bpp are supported. FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?

tdfxfb (Linux only) †

This driver employs the tdfx framebuffer driver to play movies with YUV acceleration on 3Dfx cards. FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?

<device>

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

tdfx_vid (Linux only) †

3Dfx specific video output driver. This driver di- rectly uses the tdfx_vid kernel module. FIXME: It' ok the difference between 3dfx, tdfxfb and td- fx_vid?

<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 (de- fault).

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.

mpegpes (DVB only) †

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

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>

Allows specifying the output filename (de- fault: ./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 device to use.

pal

Activate PAL video norm.

secam

Activate SECAM video norm.

ntsc

Activate NTSC video norm.

prebuf

Activate prebuffering, not yet supported.

md5sum †

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

outfile=<value>

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

yuv4mpeg †

ビデオストリームを無圧縮YUV 4:2:0に変換し、ファイルに保存(default: ./stream.yuv)。このフォーマットはmjpegtoolsが使うものと同じなので、mjpeg- tools suiteでビデオを生成したい時に有益。このツールはYV12, RGB (24 bpp), BGR (24 bpp) フォーマットをサポートしている。-fixed-vo オプションを使うと、同じ解像度、fps値を持つ複数のファイルを1ファイルに結合できる。

原文

Transforms the video stream into a sequence of un-compressed 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 mjpeg- tools 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, bot- tom field first.

file=<filename>

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

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

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 file- name. EXAMPLE:

mplayer video.nut -vo gif89a:15.0: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 (de- fault: 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 in- stead 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, ap- pended 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 in- stead 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 for- mats 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