Man / VIDEO OUTPUT OPTIONS

VIDEO OUTPUT OPTIONS (MPLAYER ONLY) †

-adapter <value> †

Set the graphics card that will receive the image. You can get a list of available cards when you run this option with -v. Currently only works with the directx video output driver.

-bpp <depth> †

Override the autodetected color depth.Only supported by the fbdev, dga, svga, vesa video output drivers.

-border †

Play movie with window border and decorations. Since this is on by default, use -noborder to disable the standard window decora- tions. Supported by the directx video output driver.

-brightness <-100-100> †

Adjust the brightness of the video signal (default: 0). Not supported by all video output drivers.

-contrast <-100-100> †

Adjust the contrast of the video signal (default: 0). Not sup- ported by all video output drivers.

-display <name> (X11 only) †

Specify the hostname and display number of the X server you want to display on.

EXAMPLE:

-display xtest.localdomain:0

-dr †

Turns on direct rendering (not supported by all codecs and video outputs) WARNING: May cause OSD/SUB corruption!

-dxr2 <option1:option2:...> †

This option is used to control the dxr2 video output driver.

ar-mode=<value>

aspect ratio mode (0 = normal, 1= pan-and-scan, 2 =letterbox (default))

iec958-encoded

Set iec958 output mode to encoded.

iec958-decoded

Set iec958 output mode to decoded (default).

macrovision=<value>

macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe, 3 = agc 4 colorstripe)

mute

mute sound output

unmute

unmute sound output

ucode=<value>

path to the microcode

TV output †

75ire

enable 7.5 IRE output mode

no75ire

disable 7.5 IRE output mode (default)

bw

b/w TV output

color

color TV output (default)

interlaced

interlaced TV output (default)

nointerlaced

disable interlaced TV output

norm=<value>

TV norm (ntsc (default), pal, pal60, palm, paln, palnc)

square-pixel

set pixel mode to square

ccir601-pixel

set pixel mode to ccir601

overlay †

cr-left=<0-500>

Set the left cropping value (default: 50).

cr-right=<0-500>

Set the right cropping value (default: 300).

cr-top=<0-500>

Set the top cropping value (default: 0).

cr-bottom=<0-500>

Set the bottom cropping value (default: 0).

ck-[r

g|b]=<0-255>|Set the r(ed), g(reen) or b(lue) gain of the overlay color-key.

ck-[r

g|b]min=<0-255>|minimum value for the respective color key

ck-[r

g|b]max=<0-255>|maximum value for the respective color key

ignore-cache

Ignore cached overlay settings.

update-cache

Update cached overlay settings.

ol-osd

Enable overlay onscreen display.

nool-osd

Disable overlay onscreen display (default).

ol[h

w|x|y]-cor=<-20-20>|Adjust the overlay size (h,w) and position (x,y) in case it does not match the window perfectly (default: 0).

overlay

Activate overlay (default).

nooverlay

Activate TVout.

overlay-ratio=<1-2500>

Tune the overlay (default: 1000).

-fbmode <modename> (-vo fbdev only) †

Change video mode to the one that is labeled as <modename> in /etc/fb.modes. NOTE: VESA framebuffer does not support mode changing.

-fbmodeconfig <filename> (-vo fbdev only) †

Override framebuffer mode configuration file (default: /etc/ fb.modes).

-fs (also see -zoom) †

Fullscreen playback (centers movie, and paints black bands around it). Not supported by all video output drivers.

-fsmode-dontuse <0-31> (OBSOLETE, use the -fs option) †

Try this option if you still experience fullscreen problems.

-fstype <type1,type2,...> (X11 only) †

Specify a priority list of fullscreen modes to be used. You can negate the modes by prefixing them with '-'. If you experience problems like the fullscreen window being covered by other win- dows try using a different order. NOTE: See -fstype help for a full list of available modes.

The available types are:

above

Use the _NETWM_STATE_ABOVE hint if available.

below

Use the _NETWM_STATE_BELOW hint if available.

fullscreen

Use the _NETWM_STATE_FULLSCREEN hint if available.

layer

Use the _WIN_LAYER hint with the default layer.

layer=<0...15>

Use the _WIN_LAYER hint with the given layer number.

netwm

Force NETWM style.

none

Do not set fullscreen window layer.

stays_on_top

Use _NETWM_STATE_STAYS_ON_TOP hint if available. EXAMPLE:

layer,stays_on_top,above,fullscreen

Default order, will be used as a fallback if incorrect or unsupported modes are specified.

-fullscreen

Fixes fullscreen switching on OpenBox 1.x.

-geometry x[%][:y[%]] or [WxH][+x+y] †

Adjust where the output is on the screen initially. The x and y specifications are in pixels measured from the top-left of the screen to the top-left of the image being displayed, however if a percentage sign is given after the argument it turns the value into a percentage of the screen size in that direction. It also supports the standard X11 -geometry option format. If an exter- nal window is specified using the -wid option, then the x and y coordinates are relative to the top-left corner of the window rather than the screen. NOTE: This option is only supported by the x11, xmga, xv, xvmc, xvidix, gl, gl2, directx and tdfxfb video output drivers.

EXAMPLE:

50:40

Places the window at x=50, y=40.

50%:50%

Places the window in the middle of the screen.

100%

Places the window at the middle of the right edge of the screen.

100%:100%

Places the window at the bottom right corner of the screen.

-guiwid <window ID> (also see -wid) (GUI only) †

This tells the GUI to also use an X11 window and stick itself to the bottom of the video, which is useful to embed a mini-GUI in a browser (with the MPlayer plugin for instance).

-hue <-100-100> †

Adjust the hue of the video signal (default: 0).You can get a colored negative of the image with this option. Not supported by all video output drivers.

-monitor-dotclock <range[,range,...]> (-vo fbdev and vesa only) †

Specify the dotclock or pixelclock range of the monitor.

-monitor-hfreq <range[,range,...]> (-vo fbdev and vesa only) †

Specify the horizontal frequency range of the monitor.

-monitor-vfreq <range[,range,...]> (-vo fbdev and vesa only) †

Specify the vertical frequency range of the monitor.

-monitoraspect <ratio> (also see -aspect) †

Set the aspect ratio of your monitor or TV screen.

EXAMPLE:

-monitoraspect 4:3 or 1.3333
-monitoraspect 16:9 or 1.7777

-monitorpixelaspect <ratio> (also see -aspect) †

Set the aspect of a single pixel of your monitoror TVscreen (default: disabled). Overrides the -monitoraspect setting. A value of 0 disables, a value of 1 means square pixels (correct for (almost?) all LCDs).

-nodouble †

Disablesdouble buffering, mostly for debugging purposes. Dou- ble buffering fixes flicker by storing two frames in memory, and displaying one while decoding another. It can affect OSD nega- tively, but often removes OSD flickering.

-nograbpointer †

Do not grab the mouse pointer after a video modechange(-vm). Useful for multihead setups.

-nokeepaspect †

Do not keep window aspect ratio when resizing windows. Only works with the x11, xv, xmga, xvidix, directx video output driv- ers. Furthermore under X11 your window manager has to honor window aspect hints.

-ontop †

Makes the player window stay on top of other windows. Supported by video output drivers which use X11, except SDL, as well as directx, macosx, quartz, ggi and gl2.

-panscan <0.0-1.0> †

Enables pan-and-scan functionality (cropping the sides of e.g. a 16:9 movie to make it fit a 4:3 display without black bands). The range controls how much of the image is cropped. Only works with the xv, xmga, mga, gl, gl2, quartz, macosx and xvidix video output drivers.

-panscanrange <-19.0-99.0> (experimental) †

Change the range of the pan-and-scan functionality (default: 1). Positivevaluesmean multiples of the default range. Negative numbers mean you can zoom in up to a factor of -panscanrange+1. E.g. -panscanrange -3 allows a zoom factor of up to 4. This feature is experimental.Do not report bugs unless you are us- ing -vo gl.

-refreshrate <Hz> †

Set the monitor refreshrate in Hz. Currently only supported by

• vo directx combined with the -vm option.

-rootwin †

Play movie in the root window (desktopbackground). Desktop background images may cover the movie window, though. Only works with the x11, xv, xmga, xvidix, quartz, macosx and directx video output drivers.

-saturation <-100-100> †

Adjust the saturation of the video signal (default: 0). You can get grayscale output with this option. Not supported by all video output drivers.

-screenh <pixels> †

Specify the vertical screen resolution for video output drivers which do not know the screen resolutionlike fbdev, x11 and TVout.

-screenw <pixels> †

Specify the horizontal screen resolution for video output driv- ers which do not know the screen resolution like fbdev, x11 and TVout.

-stop-xscreensaver (X11 only) †

Turns off xscreensaver at startup and turns it on again on exit.

-vm †

Try to change to a different video mode.Supported by the dga, x11, xv, sdl and directx video output drivers. If used with the directx video output driver the -screenw, -screenh, -bpp and

• refreshrate options can be used to set the new display mode.

-vsync †

Enables VBI for the vesa, dfbmga and svga video output drivers.

-wid <window ID> (also see -guiwid) (X11, OpenGL and DirectX only) †

This tells MPlayer to attach to an existing window. Useful to embed MPlayer in a browser (e.g. the plugger extension).

-xineramascreen <-2-...> (X11 only) †

In Xinerama configurations (i.e. a single desktop that spans across multiple displays) this option tells MPlayer which screen to display the movie on. A value of -2 means fullscreen across the whole virtual display, -1 means fullscreen on the display the window currently is on. The initial position set via the

• geometry option is relative to the specified screen. Will usu- ally only work with "-fstype -fullscreen" or "-fstype none".

-zrbw (-vo zr only) †

Display in black and white. For optimal performance, this can be combined with '-lavdopts gray'.

-zrcrop <[width]x[height]+[x offset]+[y offset]> (-vo zr only) †

Select a part of the input imageto display, multipleoccur- rences of this option switch on cinerama mode. In cinerama mode the movie is distributed over more than one TV (or beamer) to create a larger image. Options appearing after the n-th -zrcrop apply to the n-th MJPEG card, each card should at least have a

• zrdev in addition to the -zrcrop. For examples, see the output of -zrhelp and the Zr section of the documentation.

-zrdev <device> (-vo zr only) †

Specify the device special file that belongs to your MJPEG card, by default the zr video output driver takes the first v4l device it can find.

-zrfd (-vo zr only) †

Force decimation: Decimation, as specified by -zrhdec and

• zrvdec, only happens if the hardware scaler can stretch the im- age to its original size. Use this option to force decimation.

-zrhdec <1|2|4> (-vo zr only) †

Horizontal decimation: Ask the driver to send only every 2nd or 4th line/pixel of the input image to the MJPEG card and use the scaler of the MJPEG card to stretch the image to its original size.

-zrhelp (-vo zr only) †

Display a list of all -zr* options, their default valuesand a cinerama mode example.

-zrnorm <norm> (-vo zr only) †

Specify the TV norm as PAL or NTSC (default: no change).

-zrquality <1-20> (-vo zr only) †

A number from 1 (best) to 20 (worst) representing the JPEG en- coding quality.

-zrvdec <1|2|4> (-vo zr only) †

Vertical decimation: Ask the driver to send onlyevery 2nd or 4th line/pixel of the input image to the MJPEG card and use the scaler of the MJPEG card to stretch the image to its original size.

-zrxdoff <x display offset> (-vo zr only) †

If the movie is smaller than the TV screen, this option speci- fies the x offset from the upper-left corner of the TVscreen (default: centered).

-zrydoff <y display offset> (-vo zr only) †

If the movie is smaller than the TV screen, this option speci- fies the y offset from the upper-left corner of the TVscreen (default: centered).