comparison DOCS/man/en/mplayer.1 @ 19487:29341cdc1cf3

Enclose all space padded headings with quotes.

19486:6710dbdf1ab2

next/\:previous playtree entry in the parent list
.IPs "INS and DEL (ASX playlist only)"
next/\:previous alternative source.
.IPs "p / SPACE"
Pause (pressing again unpauses).
.IPs .\ \ \ \ 
Step forward.
Pressing once will pause movie, every consecutive press will play one frame
and then go into pause mode again (any other key unpauses).
.IPs "q / ESC"
Stop playing and quit.

Adjust audio delay by +/- 0.1 seconds.
.IPs "/ and *"
Decrease/\:increase volume.
.IPs "9 and 0"
Decrease/\:increase volume.
.IPs m\ \ \ \ 
Mute sound.
.IPs "# (MPEG and Matroska only)"
Cycle through the available audio tracks.
.IPs f\ \ \ \ 
Toggle fullscreen (also see \-fs).
.IPs T\ \ \ \ 
Toggle stay-on-top (also see \-ontop).
.IPs "w and e"
Decrease/\:increase pan-and-scan range.
.IPs o\ \ \ \ 
Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
.IPs d\ \ \ \ 
Toggle frame dropping states: none / skip display / skip decoding
(see \-framedrop and \-hardframedrop).
.IPs v\ \ \ \ 
Toggle subtitle visibility.
.IPs "b / j"
Cycle through the available subtitles.
.IPs "y and g"
Step forward/backward in the subtitle list.
.IP F\ \ \ \ 
Toggle displaying "forced subtitles".
.IPs a\ \ \ \ 
Toggle subtitle alignment: top / middle / bottom.
.IPs "x and z"
Adjust subtitle delay by +/- 0.1 seconds.
.IPs "r and t"
Move subtitles up/down.

.PP
.PD 0
.RS
.IPs PAUSE
Pause.
.IPs STOP\ 
Stop playing and quit.
.IPs "PREVIOUS and NEXT"
Seek backward/\:forward 1 minute.
.RE
.PD 1

.PP
.PD 0
.RS
.IPs ENTER
Start playing.
.IPs ESC\ \ 
Stop playing.
.IPs l\ \ \ \ 
Load file.
.IPs t\ \ \ \ 
Load subtitle.
.IPs c\ \ \ \ 
Open skin browser.
.IPs p\ \ \ \ 
Open playlist.
.IPs r\ \ \ \ 
Open preferences.
.RE
.PD 1
.PP
.RS

.PP
.PD 0
.RS
.IPs "h and k"
Select previous/\:next channel.
.IPs n\ \ \ \ 
Change norm.
.IPs u\ \ \ \ 
Change channel list.
.RE
.PD 1
.
.TP

debug level 4
.RE
.PD 1
.
.TP
.B \-quiet\ 
Make console output less verbose; in particular, prevents the status line
(i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
Particularly useful on slow terminals or broken ones which do not properly
handle carriage return (i.e.\& \\r).
.

.TP
.B \-show-profile <profile>
Show the description and content of a profile.
.
.TP
.B \-v\ \ \ \ \ 
Increment verbosity level, one level for each \-v
found on the command line.
.
.
.

Set the image equalizer on the card.
.IPs audiorate=<value>
Set audio capture bitrate.
.IPs forceaudio
Capture audio even if there are no audio sources reported by v4l.
.IPs alsa\ 
Capture from ALSA.
.IPs amode=<0\-3>
Choose an audio mode:
.RSss
0: mono

Align subtitle bottom edge (default).
.RE
.PD 1
.
.TP
.B \-subcc \ 
Display DVD Closed Caption (CC) subtitles.
These are
.B not
the VOB subtitles, these are special ASCII subtitles for the
hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.

.TP
.B \-unicode
Tells MPlayer to handle the subtitle file as unicode.
.
.TP
.B \-utf8 \ \ 
Tells MPlayer to handle the subtitle file as UTF-8.
.
.TP
.B \-vobsub <VOBsub file without extension>
Specify a VOBsub file to use for subtitles.

.PD 1
.sp 1
Available audio output drivers are:
.
.TP
.B alsa\ \ \ 
ALSA 0.9/1.x audio output driver
.PD 0
.RSs
.IPs noblock
Sets noblock-mode.

you really know how to set it correctly.
.RE
.PD 1
.
.TP
.B alsa5\ \ 
ALSA 0.5 audio output driver
.
.TP
.B oss\ \ \ \ 
OSS audio output driver
.PD 0
.RSs
.IPs <dsp-device>
Sets the audio output device (default: /dev/\:dsp).

Sets the audio mixer channel (default: pcm).
.RE
.PD 1
.
.TP
.B sdl\ \ \ \ 
highly platform independent SDL (Simple Directmedia Layer) library
audio output driver
.PD 0
.RSs
.IPs <driver>
Explicitly choose the SDL audio driver to use (default: let SDL choose).
.RE
.PD 1
.
.TP
.B arts\ \ \ 
audio output through the aRts daemon
.
.TP
.B esd\ \ \ \ 
audio output through the ESD daemon
.PD 0
.RSs
.IPs <server>
Explicitly choose the ESD server to use (default: localhost).
.RE
.PD 1
.
.TP
.B jack\ \ \ \ 
audio output through JACK (Jack Audio Connection Kit)
.PD 0
.RSs
.IPs port=<name>
Connects to the ports with the given name (default: physical ports).

(default: enabled).
.RE
.PD 1
.
.TP
.B nas\ \ \ \ 
audio output through NAS
.
.TP
.B macosx (Mac OS X only)
native Mac OS X audio output driver

output filename
.RE
.PD 1
.
.TP
.B null\ \ \ 
Produces no audio output but maintains video playback speed.
Use \-nosound for benchmarking.
.
.TP
.B pcm\ \ \ \ 
raw PCM/wave file writer audio output
.PD 0
.RSs
.IPs (no)waveheader
Include or do not include the wave header (default: included).
When not included, raw PCM will be generated.
.IPs file=<filename>
Write the sound to <filename> instead of the default
audiodump.wav.
If nowaveheader is specified, the default is audiodump.pcm.
.IPs fast\ 
Try to dump faster than realtime.
Make sure the output does not get truncated (usually with
"Too many video packets in buffer" message).
It is normal that you get a "Your system is too SLOW to play this!" message.
.RE
.PD 1
.
.TP
.B plugin\ \ 
plugin audio output driver
.
.
.
.SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"

\-display xtest.localdomain:0
.RE
.PD 1
.
.TP
.B \-dr \ \ \ 
Turns on direct rendering (not supported by all codecs and video outputs)
.br
.I WARNING:
May cause OSD/SUB corruption!
.

.IPs iec958-decoded
Set iec958 output mode to decoded (default).
.IPs macrovision=<value>
macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
3 = agc 4 colorstripe)
.IPs mute\ 
mute sound output
.IPs unmute
unmute sound output
.IPs ucode=<value>
path to the microcode

.RSs
.IPs 75ire
enable 7.5 IRE output mode
.IPs no75ire
disable 7.5 IRE output mode (default)
.IPs bw\ \ \ 
b/w TV output
.IPs color
color TV output (default)
.IPs interlaced
interlaced TV output (default)

Use the _WIN_LAYER hint with the default layer.
.IPs layer=<0...15>
Use the _WIN_LAYER hint with the given layer number.
.IPs netwm
Force NETWM style.
.IPs none\ 
Do not set fullscreen window layer.
.IPs stays_on_top
Use _NETWM_STATE_STAYS_ON_TOP hint if available.
.REss
.sp 1

.RSs
.IPs 50:40
Places the window at x=50, y=40.
.IPs 50%:50%
Places the window in the middle of the screen.
.IPs 100%\ 
Places the window at the middle of the right edge of the screen.
.IPs 100%:100%
Places the window at the bottom right corner of the screen.
.RE
.PD 1

Do not keep window aspect ratio when resizing windows.
Only works with the x11, xv, xmga, xvidix, directx video output drivers.
Furthermore under X11 your window manager has to honor window aspect hints.
.
.TP
.B \-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.
.
.TP

.TP
.B \-stop-xscreensaver (X11 only)
Turns off xscreensaver at startup and turns it on again on exit.
.
.TP
.B \-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.
.
.TP
.B \-vsync \ \ 
Enables VBI for the vesa, dfbmga and svga video output drivers.
.
.TP
.B \-wid <window ID> (also see \-guiwid) (X11, OpenGL and DirectX only)
This tells MPlayer to attach to an existing window.

Use hardware accelerated scaler (default: hwaccel).
.RE
.PD 1
.
.TP
.B 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.
.PD 0
.RSs

same as vidix
.RE
.PD 1
.
.TP
.B cvidix\ 
Generic and platform independent VIDIX frontend, can even run in a
text console with nVidia cards.
.PD 0
.RSs
.IPs <subdevice>

Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
.RE
.PD 1
.
.TP
.B vesa\ \ \ 
Very general video 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 neotv_pal
Activate the NeoMagic TV out and set it to PAL norm.
.IPs neotv_ntsc
Activate the NeoMagic TV out and set it to NTSC norm.
.IPs vidix
Use the VIDIX driver.
.IPs lvo:\ \ \ 
Activate the Linux Video Overlay on top of VESA mode.
.RE
.PD 1
.
.TP
.B svga\ \ \ 
Play video using the SVGA library.
.PD 0
.RSs
.IPs "<video mode>"
Specify video mode to use.

This avoids direct rendering, OSD and hardware acceleration.
.IPs retrace
Force frame switch on vertical retrace.
Usable only with \-double.
It has the same effect as the \-vsync option.
.IPs sq\ \ \ 
Try to select a video mode with square pixels.
.IPs vidix
Use svga with VIDIX.
.RE
.PD 1
.
.TP
.B 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

.REss
.RE
.PD 1
.
.TP
.B gl2\ \ \ \ 
OpenGL video output driver, second generation.
Supports OSD and videos larger than the maximum texture size.
.PD 0
.RSs
.IPs (no)glfinish

gamma setting is only available via the global X server settings.
Apart from this the values have the same meaning as for \-vo gl.
.REss
.
.TP
.B null\ \ \ 
Produces no video output.
Useful for benchmarking.
.
.TP
.B aa\ \ \ \ \ 
ASCII art video output driver that works on a text console.
You can get a list and an explanation of available suboptions executing
.I mplayer \-vo aa:help
.
.TP
.B caca\ \ \ 
Color ASCII art video output driver that works on a text console.
.
.TP
.B bl\ \ \ \ \ 
Video playback using the Blinkenlights UDP protocol.
This driver is highly hardware specific.
.PD 0
.RSs
.IPs <subdevice>

You must specify a subdevice.
.RE
.PD 1
.
.TP
.B ggi\ \ \ \ 
GGI graphics system video output driver
.PD 0
.RSs
.IPs <driver>
Explicitly choose the GGI driver to use.

Specify a parameter list for DirectFB.
.RE
.PD 1
.
.TP
.B 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.
.PD 0
.RSs

Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
.RE
.PD 1
.
.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.
.

.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).

(De)Activate prebuffering, not yet supported.
.RE
.PD 1
.
.TP
.B md5sum\ 
Calculate MD5 sums of each frame and write them to a file.
Supports RGB24 and YV12 colorspaces.
Useful for debugging.
.PD 0
.RSs

If you do not specify any option the output is progressive
(i.e.\& not interlaced).
.RE
.
.TP
.B 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.
.PD 0
.RSs

mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif
.RE
.PD 1
.
.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.
.PD 0
.RSs
.IPs [no]progressive

Must be equal to or larger than 1 (default: 1000).
.RE
.PD 1
.
.TP
.B 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).
.PD 0
.RSs
.IPs ppm\ \ 
Write PPM files (default).
.IPs pgm\ \ 
Write PGM files.
.IPs pgmyuv
Write PGMYUV files.
PGMYUV is like PGM, but it also contains the U and V plane, appended at the
bottom of the picture.
.IPs raw\ \ 
Write PNM files in raw mode (default).
.IPs ascii
Write PNM files in ASCII mode.
.IPs outdir=<dirname>
Specify the directory to save the PNM files to (default: ./).

Must be equal to or larger than 1 (default: 1000).
.RE
.PD 1
.
.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.
24bpp RGB and BGR formats are supported.
.PD 0
.RSs

0 is no compression, 9 is maximum compression.
.RE
.PD 1
.
.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.
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.

.TP
.B \-noaspect
Disable automatic movie aspect ratio compensation.
.
.TP
.B \-flip \ 
Flip image upside-down.
.
.TP
.B \-lavdopts <option1:option2:...> (DEBUG CODE)
Specify libavcodec decoding parameters.

.IPs "fast (MPEG-2 only)"
Enable optimizations which do not comply to the specification and might
potentially cause problems, like simpler dequantization, assuming use
of the default quantization matrix, assuming YUV 4:2:0 and skipping a few
checks to detect damaged bitstreams.
.IPs gray\ 
grayscale only decoding (a bit faster than with color)
.IPs "idct=<0\-99> (see \-lavcopts)"
For best decoding quality use the same IDCT algorithm for decoding and encoding.
This may come at a price in accuracy, though.
.IPs lowres=<number>[,<w>]

.RS
rendering methods:
.RE
.PD 0
.RSs
.IPs dr2\ \ 
Activate direct rendering method 2.
.IPs nodr2
Deactivate direct rendering method 2.
.RE
.PD 1

.B \-y <y> (also see \-zoom) (MPlayer only)
Scale image to height <y> (if software/\:hardware scaling is available).
Disables aspect calculations.
.
.TP
.B \-zoom\ \ 
Allow software scaling, where available.
This will allow scaling with output drivers (like x11, fbdev) that
do not support hardware scaling where MPlayer disables scaling by
default for performance reasons.
.

of input channels the exceeding channels are truncated.
.PD 0
.RSs
.IPs <nch>
number of output channels (1\-6)
.IPs <nr>\ 
number of routes (1\-6)
.IPs <from1:to1:from2:to2:from3:to3:...>
Pairs of numbers between 0 and 5 that define where to route each channel.
.RE
.sp 1

.I NOTE:
This filter is not reentrant and can therefore only be enabled
once for every audio stream.
.PD 0
.RSs
.IPs <v>\ \ 
Sets the desired gain in dB for all channels in the stream
from -200dB to +60dB, where -200dB mutes the sound
completely and +60dB equals a gain of 1000 (default: 0).
.IPs <sc>\ 
Turns soft clipping on (1) or off (0).
Soft-clipping can make the sound more smooth if very
high volume levels are used.
Enable this option if the dynamic range of the
loudspeakers is very low.

the number of output channels.
An example how to downmix a six-channel file to two channels with
this filter can be found in the examples section near the end.
.PD 0
.RSs
.IPs <n>\ \ 
number of output channels (1\-6)
.IPs <Lij>
How much of input channel i is mixed into output channel j (0\-1).
So in principle you first have n numbers saying what to do with the
first input channel, then n numbers that act on the second input channel

Disable this filter when you are playing DVDs with Dolby
Digital 5.1 sound, otherwise this filter will disrupt
the sound to the subwoofer.
.PD 0
.RSs
.IPs <fc>\ 
cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
For the best result try setting the cutoff frequency as low as possible.
This will improve the stereo or surround sound experience.
.IPs <ch>\ 
Determines the channel number in which to insert the sub-channel audio.
Channel number can be between 0 and 5 (default: 5).
Observe that the number of channels will automatically
be increased to <ch> if necessary.
.RE

100Hz to output channel 4.
.RE
.PD 1
.
.TP
.B center\ 
Creates a center channel from the front channels.
May currently be low quality as it does not implement a
high-pass filter for proper extraction yet, but averages and
halves the channels instead.
.PD 0
.RSs
.IPs <ch>\ 
Determines the channel number in which to insert the center channel.
Channel number can be between 0 and 5 (default: 5).
Observe that the number of channels will automatically
be increased to <ch> if necessary.
.RE

This eliminates the use of 'analyseplugin' from the LADSPA SDK.
.RE
.PD 1
.
.TP
.B comp\ \ \ 
Compressor/expander filter usable for microphone input.
Prevents artifacts on very loud sound and raises the volume on
very low sound.
This filter is untested, maybe even unusable.
.
.TP
.B gate\ \ \ 
Noise gate filter similar to the comp audio filter.
This filter is untested, maybe even unusable.
.
.TP
.B karaoke

Adds a 50 pixel border to the bottom of the picture.
.RE
.PD 1
.IPs <x>,<y>
position of original image on the expanded image (default: center)
.IPs <o>\ \ 
OSD/\:subtitle rendering
.RSss
0: disable (default)
.br
1: enable
.REss
.IPs <a>\ \ 
Expands to fit an aspect instead of a resolution (default: 0).
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IP expand=800::::4/3
Expands to 800x600, unless the source is higher resolution, in which
case it expands to fill a 4/3 aspect.
.RE
.PD 1
.IPs <r>\ \ 
Rounds up to make both width and height divisible by <r> (default: 1).
.RE
.
.TP
.B flip (also see \-flip)
Flips the image upside down.
.
.TP
.B mirror\ 
Mirrors the image on the Y axis.
.
.TP
.B rotate[=<0\-7>]
Rotates the image by 90 degrees and optionally flips it.

.IP dsize=800:600:0
Specifies a display resolution of at most 800x600, or smaller, in order
to keep aspect.
.RE
.PD 1
.IPs <r>\ \ 
Rounds up to make both width and height divisible by <r> (default: 1).
.RE
.
.TP
.B yuy2\ \ \ 
Forces software YV12/\:I420/\:422P to YUY2 conversion.
Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
.
.TP
.B yvu9\ \ \ 
Forces software YVU9 to YV12 colorspace conversion.
Deprecated in favor of the software scaler.
.
.TP
.B yuvcsp\ 
Clamps YUV color values to the CCIR 601 range without doing real conversion.
.
.TP
.B rgb2bgr[=swap]
RGB 24/32 <\-> BGR 24/32 colorspace conversion.
.PD 0
.RSs
.IPs swap\ 
Also perform  R <-> B swapping.
.RE
.PD 1
.
.TP

.REss
.IPs de/default
default pp filter combination (hb:a,vb:a,dr:a)
.IPs fa/fast
fast pp filter combination (h1:a,v1:a,dr:a)
.IPs ac\ \ \ 
high quality pp filter combination (ha:a:128:7,va:a,dr:a)
.RE
.RS
.sp 1
.I EXAMPLE:

image at several (or \- in the case of quality level 6 \- all)
shifts and averages the results.
.RSs
.IPs <quality>
0\-6 (default: 3)
.IPs <qp>\ 
Force quantization parameter (default: 0, use QP from video).
.IPs <mode>
0: hard thresholding (default)
.br
1: soft thresholding (better deringing, but blurrier)

encodes & decodes each case with libavcodec MPEG-4, whereas spp uses
a simplified intra only 8x8 DCT similar to MJPEG.
.RSs
.IPs <quality>
0\-8 (default: 3)
.IPs <qp>\ 
Force quantization parameter (default: 0, use QP from video).
.RE
.
.TP
.B fspp[=quality[:qp[:strength[:bframes]]]]
faster version of the simple postprocessing filter
.RSs
.IPs <quality>
4\-5 (equivalent to spp; default: 4)
.IPs <qp>\ 
Force quantization parameter (default: 0, use QP from video).
.IPs <-15\-32>
Filter strength, lower values mean more details but also more artifacts,
while higher values make the image smoother but also blurrier (default:
0 \- PSNR optimal).

.IPs <equation>
some equation like "2+2*sin(PI*qp)"
.RE
.
.TP
.B test\ \ \ 
Generate various test patterns.
.
.TP
.B rgbtest
Generate an RGB test pattern useful for detecting RGB vs BGR issues.

.IPs <fps>
force output fps (float value) (default: 0, autodetect based on height)
.RE
.
.TP
.B fame\ \ \ 
Fast software YV12 to MPEG-1 conversion with libfame for use with DVB/\:DXR3/IVTV.
.
.TP
.B dvbscale[=aspect]
Set up optimal scaling for DVB cards, scaling the x axis in hardware and

is poor quality or is not available.
Can also be used as a primitive luma-only deinterlacer with very low CPU
usage.
.PD 0
.RSs
.IPs <f>\ \ 
By default, halfpack averages pairs of lines when downsampling.
Any value different from 0 or 1 gives the default (averaging) behavior.
.RSss
0: Only use even lines when downsampling.
.br

.
.TP
.B unsharp[=l|cWxH:amount[:l|cWxH:amount]]
unsharp mask / gaussian blur
.RSs
.IPs l\ \ \ \ 
Apply effect on luma component.
.IPs c\ \ \ \ 
Apply effect on chroma components.
.IPs <width>x<height>
width and height of the matrix, odd sized in both directions
(min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
.IPs amount

>0: sharpen
.REss
.RE
.
.TP
.B swapuv\ 
Swap U & V plane.
.
.TP
.B il[=d|i][s][:[d|i][s]]
(De)interleaves lines.

Development on this filter is no longer taking place, as ivtc, pullup,
and filmdint are better for most applications.
The following arguments (see syntax above) may be used to control
detc's behavior:
.RSs
.IPs <dr>\ 
Set the frame dropping mode.
.RSss
0: Do not drop frames to maintain fixed output framerate (default).
.br
1: Always drop a frame when there have been no drops or telecine

2: Always maintain exact 5:4 input to output frame ratio.
.br
.I NOTE:
Use mode 1 or 2 with MEncoder.
.REss
.IPs <am>\ 
Analysis mode.
.RSss
0: Fixed pattern with initial frame number specified by <fr>.
.br
1: aggressive search for telecine pattern (default)
.REss
.IPs <fr>\ 
Set initial frame number in sequence.
0\-2 are the three clean progressive frames; 3 and 4 are the two
interlaced frames.
The default, -1, means 'not in telecine sequence'.
The number specified here is the type for the imaginary previous

2: slow, iterative motion estimation
.br
3: extra slow, like 2 plus multiple reference frames
.IPs <parity>
0 or 1 selects which field to use (note: no autodetection yet!).
.IPs <qp>\ 
Higher values should result in a smoother motion vector
field but less optimal individual vectors.
.RE
.PD 1
.

shape adaptive blur
.PD 0
.RSs
.IPs <radius>
blur filter strength (~0.1\-4.0) (slower if larger)
.IPs <pf>\ 
prefilter strength (~0.1\-2.0)
.IPs <colorDiff>
maximum difference between pixels to still be considered (~0.1\-100.0)
.RE
.PD 1

Correct the perspective of movies not filmed perpendicular to the screen.
.PD 0
.RSs
.IPs <x0>,<y0>,...
coordinates of the top left, top right, bottom left, bottom right corners
.IPs <t>\ \ 
linear (0) or cubic resampling (1)
.RE
.PD 1
.
.TP
.B 2xsai\ \ 
Scale and smooth the image with the 2x scale and interpolate algorithm.
.
.TP
.B 1bpp\ \ \ 
1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
.
.TP
.B down3dright[=lines]
Reposition and resize stereoscopic images.

.IPs "CLEAR width height xpos ypos"
Clear area.
.IPs OPAQUE
Disable all alpha transparency.
Send "ALPHA 0 0 0 0 0" to enable it again.
.IPs HIDE\ 
Hide bitmap.
.IPs SHOW\ 
Show bitmap.
.RE
.PD 1
.sp 1
.RS

The filter has no overhead when not used and accepts an arbitrary
colorspace, so it is safe to add it to the configuration file.
.RE
.
.TP
.B ass\ \ \ \ 
Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain.
Only useful with the \-ass option.
.RE
.
.TP

.B \-info <option1:option2:...> (AVI only)
Specify the info header of the resulting AVI file.
.sp 1
Available options are:
.RSs
.IPs help\ 
Show this description.
.IPs name=<value>
title of the work
.IPs artist=<value>
artist or author of the work

.
.
.SS lame (\-lameopts)
.
.TP
.B help\ \ \ 
get help
.
.TP
.B vbr=<0\-4>
variable bitrate method

mtrh
.RE
.PD 1
.
.TP
.B abr\ \ \ \ 
average bitrate
.
.TP
.B cbr\ \ \ \ 
constant bitrate
Also forces CBR mode encoding on subsequent ABR presets modes.
.
.TP
.B br=<0\-1024>

adjust
.RE
.PD 1
.
.TP
.B fast\ \ \ 
Switch on faster encoding on subsequent VBR presets modes.
This results in slightly lower quality and higher bitrates.
.
.TP
.B highpassfreq=<freq>

.
.TP
.B preset=<value>
preset values
.RSs
.IPs help\ 
Print additional options and information about presets settings.
.IPs medium
VBR encoding, good quality, 150\-180 kbps bitrate range
.IPs standard
VBR encoding, high quality, 170\-210 kbps bitrate range

.TP
.B mpeg=<2|4>
MPEG version (default: 4)
.
.TP
.B tns\ \ \ \ 
Enables temporal noise shaping.
.
.TP
.B cutoff=<0\-sampling_rate/2>
cutoff frequency (default: sampling_rate/2)
.
.TP
.B raw\ \ \ \ 
Stores the bitstream as raw payload with extradata in the container header
(default: 0, corresponds to ADTS).
Do not set this flag if not explicitly required or you will not be able to
remux the audio stream later on.
.RE

.TP
.B acodec=<value>
audio codec (default: mp2)
.PD 0
.RSs
.IPs mp2\ \ 
MPEG Layer 2
.IPs mp3\ \ 
MPEG Layer 3
.IPs ac3\ \ 
AC3
.IPs adpcm_ima_wav
IMA Adaptive PCM (4bits per sample, 4:1 compression)
.IPs sonic\ 
Experimental lossy/lossless codec
.RE
.PD 1
.
.TP

.RSs
.IPs mjpeg
Motion JPEG
.IPs ljpeg
Lossless JPEG
.IPs h261\ 
H.261
.IPs h263\ 
H.263
.IPs h263p
H.263+
.IPs mpeg4
MPEG-4 (DivX 4/5)
.IPs msmpeg4
DivX 3
.IPs msmpeg4v2
MS MPEG4v2
.IPs wmv1\ 
Windows Media Video, version 1 (AKA WMV7)
.IPs wmv2\ 
Windows Media Video, version 2 (AKA WMV8)
.IPs rv10\ 
an old RealVideo codec
.IPs mpeg1video
MPEG-1 video
.IPs mpeg2video
MPEG-2 video
.IPs huffyuv
HuffYUV
.IPs ffvhuff (also see: vstrict)
nonstandard 20% smaller HuffYUV using YV12
.IPs asv1\ 
ASUS Video v1
.IPs asv2\ 
ASUS Video v2
.IPs "ffv1 (also see: vstrict)"
FFmpeg's lossless video codec
.IPs flv\ \ 
Sorenson H.263 used in Flash Video
.IPs dvvideo
Sony Digital Video
.IPs svq1\ 
Apple Sorenson Video 1
.IPs "snow (also see: vstrict)"
FFmpeg's experimental wavelet-based codec
.RE
.PD 1

Select the MB mode which has the best rate distortion.
.RE
.PD 1
.
.TP
.B vhq\ \ \ \ 
Same as mbd=1, kept for compatibility reasons.
.
.TP
.B v4mv\ \ \ 
Allow 4 motion vectors per macroblock (slightly better quality).
Works better if used with mbd>0.
.
.TP
.B obmc\ \ \ 
overlapped block motion compensation (H.263+)
.
.TP
.B loop\ \ \ 
loop filter (H.263+)
note, this is broken
.
.TP
.B inter_threshold <-1000\-1000>

.TP
.B vrc_eq=<equation>
main ratecontrol equation (pass 1/2)
.RE
.RSs
.IPs 1\ \ \ \ 
constant bitrate
.IPs tex\ \ 
constant quality
.IPs 1+(tex/\:avgTex-1)*qComp
approximately the equation of the old ratecontrol code
.IPs tex^qComp
with qcomp 0.5 or something like that (default)

.PP
.RS
variables:
.RE
.RSs
.IPs tex\ \ 
texture complexity
.IPs iTex,pTex
intra, non-intra texture complexity
.IPs avgTex
average texture complexity

average intra texture complexity in P-frames
.IPs avgPPTex
average non-intra texture complexity in P-frames
.IPs avgBPTex
average non-intra texture complexity in B-frames
.IPs mv\ \ \ 
bits used for motion vectors
.IPs fCode
maximum length of motion vector in log2 scale
.IPs iCount
number of intra macroblocks / number of macroblocks
.IPs var\ \ 
spatial complexity
.IPs mcVar
temporal complexity
.IPs qComp
qcomp from the command line
.IPs "isI, isP, isB"
Is 1 if picture type is I/P/B else 0.
.IPs Pi,E\ 
See your favorite math book.
.RE
.PP
.RS
functions:

with future MPlayer versions (snow, ffvhuff, ffv1).
.RE
.PD 1
.
.TP
.B vdpart\ 
Data partitioning.
Adds 2 Bytes per video packet, improves error-resistance when transferring over
unreliable channels (e.g.\& streaming over the internet).
Each video packet will be encoded in 3 separate partitions:
.PD 0

.TP
.B vpsize=<0\-10000> (also see vdpart)
Video packet size, improves error-resistance.
.PD 0
.RSs
.IPs 0\ \ \ \ 
disabled (default)
.IPs 100\-1000
good choice
.RE
.PD 1
.
.TP
.B ss\ \ \ \ \ 
slice structured mode for H.263+
.
.TP
.B gray\ \ \ 
grayscale only encoding (faster)
.
.TP
.B vfdct=<0\-10>
DCT algorithm

.I WARNING:
Large values might look good on some monitors but may look horrible
on other monitors.
.PD 0
.RSs
.IPs 0.0\ \ 
disabled (default)
.IPs 0.0\-0.3
sane range
.RE
.PD 1

.I WARNING:
Large values might look good on some monitors but may look horrible
on other monitors / TV / TFT.
.PD 0
.RSs
.IPs 0.0\ \ 
disabled (default)
.IPs 0.0\-0.3
sane range
.RE
.PD 1

.I HINT:
Crop any black borders completely as they will reduce the quality
of the macroblocks (also applies without scplx_mask).
.PD 0
.RSs
.IPs 0.0\ \ 
disabled (default)
.IPs 0.0\-0.5
sane range
.RE
.PD 1

Border processing increases the quantizer for macroblocks which are less
than 1/5th of the frame width/height away from the frame border,
since they are often visually less important.
.
.TP
.B naq\ \ \ \ 
Normalize adaptive quantization (experimental).
When using adaptive quantization (*_mask), the average per-MB quantizer may no
longer match the requested frame-level quantizer.
Naq will attempt to adjust the per-MB quantizers to maintain the proper
average.
.
.TP
.B ildct\ \ 
Use interlaced DCT.
.
.TP
.B ilme\ \ \ 
Use interlaced motion estimation (mutually exclusive with qpel).
.
.TP
.B alt\ \ \ \ 
Use alternative scantable.
.
.TP
.B top=<-1\-1>\ \ \ 
.PD 0
.RSs
.IPs -1
automatic
.IPs 0

.
.TP
.B format=<value>
.PD 0
.RSs
.IPs YV12\ 
default
.IPs 444P\ 
for ffv1
.IPs 422P\ 
for HuffYUV, lossless JPEG and ffv1
.IPs 411P,YVU9
for lossless JPEG and ffv1
.IPs BGR32
for lossless JPEG and ffv1
.RE
.PD 1
.
.TP
.B pred\ \ \ 
(for HuffYUV)
.PD 0
.RSs
.IPs 0
left prediction

median prediction
.RE
.PD 1
.
.TP
.B pred\ \ \ 
(for lossless JPEG)
.PD 0
.RSs
.IPs 0
left prediction

mean prediction
.RE
.PD 1
.
.TP
.B coder\ \ 
(for ffv1)
.PD 0
.RSs
.IPs 0
vlc coding (Golomb-Rice)

adaptive Huffman tables
.RE
.PD 1
.
.TP
.B qpel\ \ \ 
Use quarter pel motion compensation (mutually exclusive with ilme).
.br
.I HINT:
This seems only useful for high bitrate encodings.
.

noise preserving sum of squared differences
.IPs "11 (W53)"
5/3 wavelet, only used in snow
.IPs "12 (W97)"
9/7 wavelet, only used in snow
.IPs +256\ 
Also use chroma, currently does not work (correctly) with B-frames.
.RE
.PD 1
.
.TP

      0
.fi
.RE
.
.TP
.B trell\ \ 
Trellis searched quantization.
This will find the optimal encoding for each 8x8 block.
Trellis searched quantization is quite simply an optimal quantization in
the PSNR versus bitrate sense (Assuming that there would be no rounding
errors introduced by the IDCT, which is obviously not the case.).
It simply finds a block for the minimum of error and lambda*bits.
.PD 0
.RSs
.IPs lambda
quantization parameter (QP) dependent constant
.IPs bits\ 
amount of bits needed to encode the block
.IPs error
sum of squared errors of the quantization
.RE
.PD 1
.
.TP
.B cbp\ \ \ \ 
Rate distorted optimal coded block pattern.
Will select the coded block pattern which minimizes distortion + lambda*rate.
This can only be used together with trellis quantization.
.
.TP
.B mv0\ \ \ \ 
Try to encode each MB with MV=<0,0> and choose the better one.
This has no effect if mbd=0.
.
.TP
.B mv0_threshold=<any non-negative integer>

.B refs=<1\-8>
number of reference frames to consider for motion compensation
(Snow only) (default: 1)
.
.TP
.B psnr\ \ \ 
print the PSNR (peak signal to noise ratio) for the whole video after encoding
and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'.
Returned values are in dB (decibel), the higher the better.
.
.TP
.B mpeg_quant
Use MPEG quantizers instead of H.263.
.
.TP
.B aic\ \ \ \ 
Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+.
This will improve quality very slightly (around 0.02 dB PSNR) and slow
down encoding very slightly (about 1%).
.br
.I NOTE:
vqmin should be 8 or larger for H.263+ AIC.
.
.TP
.B aiv\ \ \ \ 
alternative inter vlc for H.263+
.
.TP
.B umv\ \ \ \ 
unlimited MVs (H.263+ only)
Allows encoding of arbitrarily long MVs.
.
.TP
.B ibias=<-256\-256>

.TP
.B vqmod_freq
experimental quantizer modulation
.
.TP
.B dc\ \ \ \ \ 
intra DC precision in bits (default: 8).
If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
.
.TP
.B cgop (also see sc_threshold)

.TP
.B l=<0\-20>
luminance threshold (default: 1)
.
.TP
.B lzo\ \ \ \ 
Enable LZO compression (default).
.
.TP
.B nolzo\ \ 
Disable LZO compression.
.
.TP
.B q=<3\-255>
quality level (default: 255)
.
.TP
.B raw \ \ \ 
Disable RTJPEG encoding.
.
.TP
.B rtjpeg\ 
Enable RTJPEG encoding (default).
.
.
.SS xvidenc (\-xvidencopts)
.

.I NOTE:
Should you rescale the video, you would need an interlace-aware resizer,
which you can activate with -vf scale=<width>:<height>:1.
.
.TP
.B 4mv\ \ \ \ 
Use 4 motion vectors per macroblock.
This might give better compression, but slows down encoding.
.br
.I WARNING:
As of XviD-1.0.x, this option is no longer available separately, and its

Make XviD discard chroma planes so the encoded video is greyscale only.
Note that this does not speed up encoding, it just prevents chroma data
from being written in the last stage of encoding.
.
.TP
.B debug\ \ 
Save per-frame statistics in ./xvid.dbg. (This is not the two pass control
file.)
.RE
.
.PP

profile specifications.
.PD 0
.RSs
.IPs unrestricted
no restrictions (default)
.IPs sp0\ \ 
simple profile at level 0
.IPs sp1\ \ 
simple profile at level 1
.IPs sp2\ \ 
simple profile at level 2
.IPs sp3\ \ 
simple profile at level 3
.IPs asp0\ 
advanced simple profile at level 0
.IPs asp1\ 
advanced simple profile at level 1
.IPs asp2\ 
advanced simple profile at level 2
.IPs asp3\ 
advanced simple profile at level 3
.IPs asp4\ 
advanced simple profile at level 4
.IPs asp5\ 
advanced simple profile at level 5
.IPs dxnhandheld
DXN handheld profile
.IPs dxnportntsc
DXN portable NTSC profile

same as above
.IPs ntsc43
same as above
.IPs ntsc169
same as above (Do not forget to give the exact ratio.)
.IPs ext\ \ 
Allows you to specify your own pixel aspect ratio with par_width and
par_height.
.RE
.PD 1
.RS

Same as the aspect option, but automatically computes aspect, taking
into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
filter chain.
.
.TP
.B psnr\ \ \ 
Print the PSNR (peak signal to noise ratio) for the whole video after encoding
and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in
the current directory.
Returned values are in dB (decibel), the higher the better.
.

.B cqm=<flat|jvt|<filename>>
Either uses a predefined custom quantization matrix or loads a JM format
matrix file.
.PD 0
.RSs
.IPs flat\ 
Use the predefined flat 16 matrix (default).
.IPs jvt\ \ 
Use the predefined JVT matrix.
.IPs <filename>
Use the provided JM format matrix file.
.PD 1
.RE

Each block type on the visualized movie will be colored as follows:
.PD 0
.RSs
.IPs red/pink
intra block
.IPs blue\ 
inter block
.IPs green
skip block
.IPs yellow
B-block

.B muxrate=<int>
Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s).
Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'.
.
.TP
.B tsaf\ \ \ 
Sets timestamps on all frames, if possible.
.
.TP
.B init_vpts=<100\-700>
initial video pts, in milliseconds (default: 200)

.B vdelay=<1\-32760>
Initial video delay time, in milliseconds (default: 0),
use it if you want to delay video with respect to audio.
.
.TP
.B drop\ \ \ 
When used with init_adelay the muxer drops the part of audio that was
anticipated.
.
.TP
.B vwidth, vheight=<1\-4095>

.B format=<container_format>
Override which container format to mux into
(default: autodetect from output file extension).
.PD 0
.RSs
.IPs mpg\ \ 
MPEG-1 systems and MPEG-2 PS
.IPs asf\ \ 
Advanced Streaming Format
.IPs avi\ \ 
Audio Video Interleave file
.IPs wav\ \ 
Waveform Audio
.IPs swf\ \ 
Macromedia Flash
.IPs flv\ \ 
Macromedia Flash video files
.IPs rm\ \ \ 
RealAudio and RealVideo
.IPs au\ \ \ 
SUN AU format
.IPs nut\ \ 
NUT open container format (experimental)
.IPs mov\ \ 
QuickTime
.IPs mp4\ \ 
MPEG-4 format
.IPs dv\ \ \ 
Sony Digital Video container
.RE
.PD 1
.TP
.B i_certify_that_my_video_stream_does_not_use_b_frames

Sets the authentication and decryption method that
libdvdcss will use to read scrambled discs.
Can be one of title, key or disc.
.PD 0
.RSs
.IPs key\ \ 
is the default method.
libdvdcss will use a set of calculated player keys to try and get the disc key.
This can fail if the drive does not recognize any of the player keys.
.IPs disc\ 
is a fallback method when key has failed.
Instead of using player keys, libdvdcss will crack the disc key using
a brute force algorithm.
This process is CPU intensive and requires 64 MB of memory to store
temporary data.

19487:29341cdc1cf3

next/\:previous playtree entry in the parent list
.IPs "INS and DEL (ASX playlist only)"
next/\:previous alternative source.
.IPs "p / SPACE"
Pause (pressing again unpauses).
.IPs ".\ \ \ \ "
Step forward.
Pressing once will pause movie, every consecutive press will play one frame
and then go into pause mode again (any other key unpauses).
.IPs "q / ESC"
Stop playing and quit.

Adjust audio delay by +/- 0.1 seconds.
.IPs "/ and *"
Decrease/\:increase volume.
.IPs "9 and 0"
Decrease/\:increase volume.
.IPs "m\ \ \ \ "
Mute sound.
.IPs "# (MPEG and Matroska only)"
Cycle through the available audio tracks.
.IPs "f\ \ \ \ "
Toggle fullscreen (also see \-fs).
.IPs "T\ \ \ \ "
Toggle stay-on-top (also see \-ontop).
.IPs "w and e"
Decrease/\:increase pan-and-scan range.
.IPs "o\ \ \ \ "
Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
.IPs "d\ \ \ \ "
Toggle frame dropping states: none / skip display / skip decoding
(see \-framedrop and \-hardframedrop).
.IPs "v\ \ \ \ "
Toggle subtitle visibility.
.IPs "b / j"
Cycle through the available subtitles.
.IPs "y and g"
Step forward/backward in the subtitle list.
.IP "F\ \ \ \ "
Toggle displaying "forced subtitles".
.IPs "a\ \ \ \ "
Toggle subtitle alignment: top / middle / bottom.
.IPs "x and z"
Adjust subtitle delay by +/- 0.1 seconds.
.IPs "r and t"
Move subtitles up/down.

.PP
.PD 0
.RS
.IPs PAUSE
Pause.
.IPs "STOP\ "
Stop playing and quit.
.IPs "PREVIOUS and NEXT"
Seek backward/\:forward 1 minute.
.RE
.PD 1

.PP
.PD 0
.RS
.IPs ENTER
Start playing.
.IPs "ESC\ \ "
Stop playing.
.IPs "l\ \ \ \ "
Load file.
.IPs "t\ \ \ \ "
Load subtitle.
.IPs "c\ \ \ \ "
Open skin browser.
.IPs "p\ \ \ \ "
Open playlist.
.IPs "r\ \ \ \ "
Open preferences.
.RE
.PD 1
.PP
.RS

.PP
.PD 0
.RS
.IPs "h and k"
Select previous/\:next channel.
.IPs "n\ \ \ \ "
Change norm.
.IPs "u\ \ \ \ "
Change channel list.
.RE
.PD 1
.
.TP

debug level 4
.RE
.PD 1
.
.TP
.B "\-quiet\ "
Make console output less verbose; in particular, prevents the status line
(i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
Particularly useful on slow terminals or broken ones which do not properly
handle carriage return (i.e.\& \\r).
.

.TP
.B \-show-profile <profile>
Show the description and content of a profile.
.
.TP
.B "\-v\ \ \ \ \ "
Increment verbosity level, one level for each \-v
found on the command line.
.
.
.

Set the image equalizer on the card.
.IPs audiorate=<value>
Set audio capture bitrate.
.IPs forceaudio
Capture audio even if there are no audio sources reported by v4l.
.IPs "alsa\ "
Capture from ALSA.
.IPs amode=<0\-3>
Choose an audio mode:
.RSss
0: mono

Align subtitle bottom edge (default).
.RE
.PD 1
.
.TP
.B "\-subcc \ "
Display DVD Closed Caption (CC) subtitles.
These are
.B not
the VOB subtitles, these are special ASCII subtitles for the
hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.

.TP
.B \-unicode
Tells MPlayer to handle the subtitle file as unicode.
.
.TP
.B "\-utf8 \ \ "
Tells MPlayer to handle the subtitle file as UTF-8.
.
.TP
.B \-vobsub <VOBsub file without extension>
Specify a VOBsub file to use for subtitles.

.PD 1
.sp 1
Available audio output drivers are:
.
.TP
.B "alsa\ \ \ "
ALSA 0.9/1.x audio output driver
.PD 0
.RSs
.IPs noblock
Sets noblock-mode.

you really know how to set it correctly.
.RE
.PD 1
.
.TP
.B "alsa5\ \ "
ALSA 0.5 audio output driver
.
.TP
.B "oss\ \ \ \ "
OSS audio output driver
.PD 0
.RSs
.IPs <dsp-device>
Sets the audio output device (default: /dev/\:dsp).

Sets the audio mixer channel (default: pcm).
.RE
.PD 1
.
.TP
.B "sdl\ \ \ \ "
highly platform independent SDL (Simple Directmedia Layer) library
audio output driver
.PD 0
.RSs
.IPs <driver>
Explicitly choose the SDL audio driver to use (default: let SDL choose).
.RE
.PD 1
.
.TP
.B "arts\ \ \ "
audio output through the aRts daemon
.
.TP
.B "esd\ \ \ \ "
audio output through the ESD daemon
.PD 0
.RSs
.IPs <server>
Explicitly choose the ESD server to use (default: localhost).
.RE
.PD 1
.
.TP
.B "jack\ \ \ \ "
audio output through JACK (Jack Audio Connection Kit)
.PD 0
.RSs
.IPs port=<name>
Connects to the ports with the given name (default: physical ports).

(default: enabled).
.RE
.PD 1
.
.TP
.B "nas\ \ \ \ "
audio output through NAS
.
.TP
.B macosx (Mac OS X only)
native Mac OS X audio output driver

output filename
.RE
.PD 1
.
.TP
.B "null\ \ \ "
Produces no audio output but maintains video playback speed.
Use \-nosound for benchmarking.
.
.TP
.B "pcm\ \ \ \ "
raw PCM/wave file writer audio output
.PD 0
.RSs
.IPs (no)waveheader
Include or do not include the wave header (default: included).
When not included, raw PCM will be generated.
.IPs file=<filename>
Write the sound to <filename> instead of the default
audiodump.wav.
If nowaveheader is specified, the default is audiodump.pcm.
.IPs "fast\ "
Try to dump faster than realtime.
Make sure the output does not get truncated (usually with
"Too many video packets in buffer" message).
It is normal that you get a "Your system is too SLOW to play this!" message.
.RE
.PD 1
.
.TP
.B "plugin\ \ "
plugin audio output driver
.
.
.
.SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"

\-display xtest.localdomain:0
.RE
.PD 1
.
.TP
.B "\-dr \ \ \ "
Turns on direct rendering (not supported by all codecs and video outputs)
.br
.I WARNING:
May cause OSD/SUB corruption!
.

.IPs iec958-decoded
Set iec958 output mode to decoded (default).
.IPs macrovision=<value>
macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
3 = agc 4 colorstripe)
.IPs "mute\ "
mute sound output
.IPs unmute
unmute sound output
.IPs ucode=<value>
path to the microcode

.RSs
.IPs 75ire
enable 7.5 IRE output mode
.IPs no75ire
disable 7.5 IRE output mode (default)
.IPs "bw\ \ \ "
b/w TV output
.IPs color
color TV output (default)
.IPs interlaced
interlaced TV output (default)

Use the _WIN_LAYER hint with the default layer.
.IPs layer=<0...15>
Use the _WIN_LAYER hint with the given layer number.
.IPs netwm
Force NETWM style.
.IPs "none\ "
Do not set fullscreen window layer.
.IPs stays_on_top
Use _NETWM_STATE_STAYS_ON_TOP hint if available.
.REss
.sp 1

.RSs
.IPs 50:40
Places the window at x=50, y=40.
.IPs 50%:50%
Places the window in the middle of the screen.
.IPs "100%\ "
Places the window at the middle of the right edge of the screen.
.IPs 100%:100%
Places the window at the bottom right corner of the screen.
.RE
.PD 1

Do not keep window aspect ratio when resizing windows.
Only works with the x11, xv, xmga, xvidix, directx video output drivers.
Furthermore under X11 your window manager has to honor window aspect hints.
.
.TP
.B "\-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.
.
.TP

.TP
.B \-stop-xscreensaver (X11 only)
Turns off xscreensaver at startup and turns it on again on exit.
.
.TP
.B "\-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.
.
.TP
.B "\-vsync \ \ "
Enables VBI for the vesa, dfbmga and svga video output drivers.
.
.TP
.B \-wid <window ID> (also see \-guiwid) (X11, OpenGL and DirectX only)
This tells MPlayer to attach to an existing window.

Use hardware accelerated scaler (default: hwaccel).
.RE
.PD 1
.
.TP
.B "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.
.PD 0
.RSs

same as vidix
.RE
.PD 1
.
.TP
.B "cvidix\ "
Generic and platform independent VIDIX frontend, can even run in a
text console with nVidia cards.
.PD 0
.RSs
.IPs <subdevice>

Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
.RE
.PD 1
.
.TP
.B "vesa\ \ \ "
Very general video 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 neotv_pal
Activate the NeoMagic TV out and set it to PAL norm.
.IPs neotv_ntsc
Activate the NeoMagic TV out and set it to NTSC norm.
.IPs vidix
Use the VIDIX driver.
.IPs "lvo:\ \ \ "
Activate the Linux Video Overlay on top of VESA mode.
.RE
.PD 1
.
.TP
.B "svga\ \ \ "
Play video using the SVGA library.
.PD 0
.RSs
.IPs "<video mode>"
Specify video mode to use.

This avoids direct rendering, OSD and hardware acceleration.
.IPs retrace
Force frame switch on vertical retrace.
Usable only with \-double.
It has the same effect as the \-vsync option.
.IPs "sq\ \ \ "
Try to select a video mode with square pixels.
.IPs vidix
Use svga with VIDIX.
.RE
.PD 1
.
.TP
.B "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

.REss
.RE
.PD 1
.
.TP
.B "gl2\ \ \ \ "
OpenGL video output driver, second generation.
Supports OSD and videos larger than the maximum texture size.
.PD 0
.RSs
.IPs (no)glfinish

gamma setting is only available via the global X server settings.
Apart from this the values have the same meaning as for \-vo gl.
.REss
.
.TP
.B "null\ \ \ "
Produces no video output.
Useful for benchmarking.
.
.TP
.B "aa\ \ \ \ \ "
ASCII art video output driver that works on a text console.
You can get a list and an explanation of available suboptions executing
.I mplayer \-vo aa:help
.
.TP
.B "caca\ \ \ "
Color ASCII art video output driver that works on a text console.
.
.TP
.B "bl\ \ \ \ \ "
Video playback using the Blinkenlights UDP protocol.
This driver is highly hardware specific.
.PD 0
.RSs
.IPs <subdevice>

You must specify a subdevice.
.RE
.PD 1
.
.TP
.B "ggi\ \ \ \ "
GGI graphics system video output driver
.PD 0
.RSs
.IPs <driver>
Explicitly choose the GGI driver to use.

Specify a parameter list for DirectFB.
.RE
.PD 1
.
.TP
.B "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.
.PD 0
.RSs

Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
.RE
.PD 1
.
.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.
.

.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).

(De)Activate prebuffering, not yet supported.
.RE
.PD 1
.
.TP
.B "md5sum\ "
Calculate MD5 sums of each frame and write them to a file.
Supports RGB24 and YV12 colorspaces.
Useful for debugging.
.PD 0
.RSs

If you do not specify any option the output is progressive
(i.e.\& not interlaced).
.RE
.
.TP
.B "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.
.PD 0
.RSs

mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif
.RE
.PD 1
.
.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.
.PD 0
.RSs
.IPs [no]progressive

Must be equal to or larger than 1 (default: 1000).
.RE
.PD 1
.
.TP
.B "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).
.PD 0
.RSs
.IPs "ppm\ \ "
Write PPM files (default).
.IPs "pgm\ \ "
Write PGM files.
.IPs pgmyuv
Write PGMYUV files.
PGMYUV is like PGM, but it also contains the U and V plane, appended at the
bottom of the picture.
.IPs "raw\ \ "
Write PNM files in raw mode (default).
.IPs ascii
Write PNM files in ASCII mode.
.IPs outdir=<dirname>
Specify the directory to save the PNM files to (default: ./).

Must be equal to or larger than 1 (default: 1000).
.RE
.PD 1
.
.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.
24bpp RGB and BGR formats are supported.
.PD 0
.RSs

0 is no compression, 9 is maximum compression.
.RE
.PD 1
.
.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.
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.

.TP
.B \-noaspect
Disable automatic movie aspect ratio compensation.
.
.TP
.B "\-flip \ "
Flip image upside-down.
.
.TP
.B \-lavdopts <option1:option2:...> (DEBUG CODE)
Specify libavcodec decoding parameters.

.IPs "fast (MPEG-2 only)"
Enable optimizations which do not comply to the specification and might
potentially cause problems, like simpler dequantization, assuming use
of the default quantization matrix, assuming YUV 4:2:0 and skipping a few
checks to detect damaged bitstreams.
.IPs "gray\ "
grayscale only decoding (a bit faster than with color)
.IPs "idct=<0\-99> (see \-lavcopts)"
For best decoding quality use the same IDCT algorithm for decoding and encoding.
This may come at a price in accuracy, though.
.IPs lowres=<number>[,<w>]

.RS
rendering methods:
.RE
.PD 0
.RSs
.IPs "dr2\ \ "
Activate direct rendering method 2.
.IPs nodr2
Deactivate direct rendering method 2.
.RE
.PD 1

.B \-y <y> (also see \-zoom) (MPlayer only)
Scale image to height <y> (if software/\:hardware scaling is available).
Disables aspect calculations.
.
.TP
.B "\-zoom\ \ "
Allow software scaling, where available.
This will allow scaling with output drivers (like x11, fbdev) that
do not support hardware scaling where MPlayer disables scaling by
default for performance reasons.
.

of input channels the exceeding channels are truncated.
.PD 0
.RSs
.IPs <nch>
number of output channels (1\-6)
.IPs "<nr>\ "
number of routes (1\-6)
.IPs <from1:to1:from2:to2:from3:to3:...>
Pairs of numbers between 0 and 5 that define where to route each channel.
.RE
.sp 1

.I NOTE:
This filter is not reentrant and can therefore only be enabled
once for every audio stream.
.PD 0
.RSs
.IPs "<v>\ \ "
Sets the desired gain in dB for all channels in the stream
from -200dB to +60dB, where -200dB mutes the sound
completely and +60dB equals a gain of 1000 (default: 0).
.IPs "<sc>\ "
Turns soft clipping on (1) or off (0).
Soft-clipping can make the sound more smooth if very
high volume levels are used.
Enable this option if the dynamic range of the
loudspeakers is very low.

the number of output channels.
An example how to downmix a six-channel file to two channels with
this filter can be found in the examples section near the end.
.PD 0
.RSs
.IPs "<n>\ \ "
number of output channels (1\-6)
.IPs <Lij>
How much of input channel i is mixed into output channel j (0\-1).
So in principle you first have n numbers saying what to do with the
first input channel, then n numbers that act on the second input channel

Disable this filter when you are playing DVDs with Dolby
Digital 5.1 sound, otherwise this filter will disrupt
the sound to the subwoofer.
.PD 0
.RSs
.IPs "<fc>\ "
cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
For the best result try setting the cutoff frequency as low as possible.
This will improve the stereo or surround sound experience.
.IPs "<ch>\ "
Determines the channel number in which to insert the sub-channel audio.
Channel number can be between 0 and 5 (default: 5).
Observe that the number of channels will automatically
be increased to <ch> if necessary.
.RE

100Hz to output channel 4.
.RE
.PD 1
.
.TP
.B "center\ "
Creates a center channel from the front channels.
May currently be low quality as it does not implement a
high-pass filter for proper extraction yet, but averages and
halves the channels instead.
.PD 0
.RSs
.IPs "<ch>\ "
Determines the channel number in which to insert the center channel.
Channel number can be between 0 and 5 (default: 5).
Observe that the number of channels will automatically
be increased to <ch> if necessary.
.RE

This eliminates the use of 'analyseplugin' from the LADSPA SDK.
.RE
.PD 1
.
.TP
.B "comp\ \ \ "
Compressor/expander filter usable for microphone input.
Prevents artifacts on very loud sound and raises the volume on
very low sound.
This filter is untested, maybe even unusable.
.
.TP
.B "gate\ \ \ "
Noise gate filter similar to the comp audio filter.
This filter is untested, maybe even unusable.
.
.TP
.B karaoke

Adds a 50 pixel border to the bottom of the picture.
.RE
.PD 1
.IPs <x>,<y>
position of original image on the expanded image (default: center)
.IPs "<o>\ \ "
OSD/\:subtitle rendering
.RSss
0: disable (default)
.br
1: enable
.REss
.IPs "<a>\ \ "
Expands to fit an aspect instead of a resolution (default: 0).
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IP expand=800::::4/3
Expands to 800x600, unless the source is higher resolution, in which
case it expands to fill a 4/3 aspect.
.RE
.PD 1
.IPs "<r>\ \ "
Rounds up to make both width and height divisible by <r> (default: 1).
.RE
.
.TP
.B flip (also see \-flip)
Flips the image upside down.
.
.TP
.B "mirror\ "
Mirrors the image on the Y axis.
.
.TP
.B rotate[=<0\-7>]
Rotates the image by 90 degrees and optionally flips it.

.IP dsize=800:600:0
Specifies a display resolution of at most 800x600, or smaller, in order
to keep aspect.
.RE
.PD 1
.IPs "<r>\ \ "
Rounds up to make both width and height divisible by <r> (default: 1).
.RE
.
.TP
.B "yuy2\ \ \ "
Forces software YV12/\:I420/\:422P to YUY2 conversion.
Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
.
.TP
.B "yvu9\ \ \ "
Forces software YVU9 to YV12 colorspace conversion.
Deprecated in favor of the software scaler.
.
.TP
.B "yuvcsp\ "
Clamps YUV color values to the CCIR 601 range without doing real conversion.
.
.TP
.B rgb2bgr[=swap]
RGB 24/32 <\-> BGR 24/32 colorspace conversion.
.PD 0
.RSs
.IPs "swap\ "
Also perform  R <-> B swapping.
.RE
.PD 1
.
.TP

.REss
.IPs de/default
default pp filter combination (hb:a,vb:a,dr:a)
.IPs fa/fast
fast pp filter combination (h1:a,v1:a,dr:a)
.IPs "ac\ \ \ "
high quality pp filter combination (ha:a:128:7,va:a,dr:a)
.RE
.RS
.sp 1
.I EXAMPLE:

image at several (or \- in the case of quality level 6 \- all)
shifts and averages the results.
.RSs
.IPs <quality>
0\-6 (default: 3)
.IPs "<qp>\ "
Force quantization parameter (default: 0, use QP from video).
.IPs <mode>
0: hard thresholding (default)
.br
1: soft thresholding (better deringing, but blurrier)

encodes & decodes each case with libavcodec MPEG-4, whereas spp uses
a simplified intra only 8x8 DCT similar to MJPEG.
.RSs
.IPs <quality>
0\-8 (default: 3)
.IPs "<qp>\ "
Force quantization parameter (default: 0, use QP from video).
.RE
.
.TP
.B fspp[=quality[:qp[:strength[:bframes]]]]
faster version of the simple postprocessing filter
.RSs
.IPs <quality>
4\-5 (equivalent to spp; default: 4)
.IPs "<qp>\ "
Force quantization parameter (default: 0, use QP from video).
.IPs <-15\-32>
Filter strength, lower values mean more details but also more artifacts,
while higher values make the image smoother but also blurrier (default:
0 \- PSNR optimal).

.IPs <equation>
some equation like "2+2*sin(PI*qp)"
.RE
.
.TP
.B "test\ \ \ "
Generate various test patterns.
.
.TP
.B rgbtest
Generate an RGB test pattern useful for detecting RGB vs BGR issues.

.IPs <fps>
force output fps (float value) (default: 0, autodetect based on height)
.RE
.
.TP
.B "fame\ \ \ "
Fast software YV12 to MPEG-1 conversion with libfame for use with DVB/\:DXR3/IVTV.
.
.TP
.B dvbscale[=aspect]
Set up optimal scaling for DVB cards, scaling the x axis in hardware and

is poor quality or is not available.
Can also be used as a primitive luma-only deinterlacer with very low CPU
usage.
.PD 0
.RSs
.IPs "<f>\ \ "
By default, halfpack averages pairs of lines when downsampling.
Any value different from 0 or 1 gives the default (averaging) behavior.
.RSss
0: Only use even lines when downsampling.
.br

.
.TP
.B unsharp[=l|cWxH:amount[:l|cWxH:amount]]
unsharp mask / gaussian blur
.RSs
.IPs "l\ \ \ \ "
Apply effect on luma component.
.IPs "c\ \ \ \ "
Apply effect on chroma components.
.IPs <width>x<height>
width and height of the matrix, odd sized in both directions
(min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
.IPs amount

>0: sharpen
.REss
.RE
.
.TP
.B "swapuv\ "
Swap U & V plane.
.
.TP
.B il[=d|i][s][:[d|i][s]]
(De)interleaves lines.

Development on this filter is no longer taking place, as ivtc, pullup,
and filmdint are better for most applications.
The following arguments (see syntax above) may be used to control
detc's behavior:
.RSs
.IPs "<dr>\ "
Set the frame dropping mode.
.RSss
0: Do not drop frames to maintain fixed output framerate (default).
.br
1: Always drop a frame when there have been no drops or telecine

2: Always maintain exact 5:4 input to output frame ratio.
.br
.I NOTE:
Use mode 1 or 2 with MEncoder.
.REss
.IPs "<am>\ "
Analysis mode.
.RSss
0: Fixed pattern with initial frame number specified by <fr>.
.br
1: aggressive search for telecine pattern (default)
.REss
.IPs "<fr>\ "
Set initial frame number in sequence.
0\-2 are the three clean progressive frames; 3 and 4 are the two
interlaced frames.
The default, -1, means 'not in telecine sequence'.
The number specified here is the type for the imaginary previous

2: slow, iterative motion estimation
.br
3: extra slow, like 2 plus multiple reference frames
.IPs <parity>
0 or 1 selects which field to use (note: no autodetection yet!).
.IPs "<qp>\ "
Higher values should result in a smoother motion vector
field but less optimal individual vectors.
.RE
.PD 1
.

shape adaptive blur
.PD 0
.RSs
.IPs <radius>
blur filter strength (~0.1\-4.0) (slower if larger)
.IPs "<pf>\ "
prefilter strength (~0.1\-2.0)
.IPs <colorDiff>
maximum difference between pixels to still be considered (~0.1\-100.0)
.RE
.PD 1

Correct the perspective of movies not filmed perpendicular to the screen.
.PD 0
.RSs
.IPs <x0>,<y0>,...
coordinates of the top left, top right, bottom left, bottom right corners
.IPs "<t>\ \ "
linear (0) or cubic resampling (1)
.RE
.PD 1
.
.TP
.B "2xsai\ \ "
Scale and smooth the image with the 2x scale and interpolate algorithm.
.
.TP
.B "1bpp\ \ \ "
1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
.
.TP
.B down3dright[=lines]
Reposition and resize stereoscopic images.

.IPs "CLEAR width height xpos ypos"
Clear area.
.IPs OPAQUE
Disable all alpha transparency.
Send "ALPHA 0 0 0 0 0" to enable it again.
.IPs "HIDE\ "
Hide bitmap.
.IPs "SHOW\ "
Show bitmap.
.RE
.PD 1
.sp 1
.RS

The filter has no overhead when not used and accepts an arbitrary
colorspace, so it is safe to add it to the configuration file.
.RE
.
.TP
.B "ass\ \ \ \ "
Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain.
Only useful with the \-ass option.
.RE
.
.TP

.B \-info <option1:option2:...> (AVI only)
Specify the info header of the resulting AVI file.
.sp 1
Available options are:
.RSs
.IPs "help\ "
Show this description.
.IPs name=<value>
title of the work
.IPs artist=<value>
artist or author of the work

.
.
.SS lame (\-lameopts)
.
.TP
.B "help\ \ \ "
get help
.
.TP
.B vbr=<0\-4>
variable bitrate method

mtrh
.RE
.PD 1
.
.TP
.B "abr\ \ \ \ "
average bitrate
.
.TP
.B "cbr\ \ \ \ "
constant bitrate
Also forces CBR mode encoding on subsequent ABR presets modes.
.
.TP
.B br=<0\-1024>

adjust
.RE
.PD 1
.
.TP
.B "fast\ \ \ "
Switch on faster encoding on subsequent VBR presets modes.
This results in slightly lower quality and higher bitrates.
.
.TP
.B highpassfreq=<freq>

.
.TP
.B preset=<value>
preset values
.RSs
.IPs "help\ "
Print additional options and information about presets settings.
.IPs medium
VBR encoding, good quality, 150\-180 kbps bitrate range
.IPs standard
VBR encoding, high quality, 170\-210 kbps bitrate range

.TP
.B mpeg=<2|4>
MPEG version (default: 4)
.
.TP
.B "tns\ \ \ \ "
Enables temporal noise shaping.
.
.TP
.B cutoff=<0\-sampling_rate/2>
cutoff frequency (default: sampling_rate/2)
.
.TP
.B "raw\ \ \ \ "
Stores the bitstream as raw payload with extradata in the container header
(default: 0, corresponds to ADTS).
Do not set this flag if not explicitly required or you will not be able to
remux the audio stream later on.
.RE

.TP
.B acodec=<value>
audio codec (default: mp2)
.PD 0
.RSs
.IPs "mp2\ \ "
MPEG Layer 2
.IPs "mp3\ \ "
MPEG Layer 3
.IPs "ac3\ \ "
AC3
.IPs adpcm_ima_wav
IMA Adaptive PCM (4bits per sample, 4:1 compression)
.IPs "sonic\ "
Experimental lossy/lossless codec
.RE
.PD 1
.
.TP

.RSs
.IPs mjpeg
Motion JPEG
.IPs ljpeg
Lossless JPEG
.IPs "h261\ "
H.261
.IPs "h263\ "
H.263
.IPs h263p
H.263+
.IPs mpeg4
MPEG-4 (DivX 4/5)
.IPs msmpeg4
DivX 3
.IPs msmpeg4v2
MS MPEG4v2
.IPs "wmv1\ "
Windows Media Video, version 1 (AKA WMV7)
.IPs "wmv2\ "
Windows Media Video, version 2 (AKA WMV8)
.IPs "rv10\ "
an old RealVideo codec
.IPs mpeg1video
MPEG-1 video
.IPs mpeg2video
MPEG-2 video
.IPs huffyuv
HuffYUV
.IPs ffvhuff (also see: vstrict)
nonstandard 20% smaller HuffYUV using YV12
.IPs "asv1\ "
ASUS Video v1
.IPs "asv2\ "
ASUS Video v2
.IPs "ffv1 (also see: vstrict)"
FFmpeg's lossless video codec
.IPs "flv\ \ "
Sorenson H.263 used in Flash Video
.IPs dvvideo
Sony Digital Video
.IPs "svq1\ "
Apple Sorenson Video 1
.IPs "snow (also see: vstrict)"
FFmpeg's experimental wavelet-based codec
.RE
.PD 1

Select the MB mode which has the best rate distortion.
.RE
.PD 1
.
.TP
.B "vhq\ \ \ \ "
Same as mbd=1, kept for compatibility reasons.
.
.TP
.B "v4mv\ \ \ "
Allow 4 motion vectors per macroblock (slightly better quality).
Works better if used with mbd>0.
.
.TP
.B "obmc\ \ \ "
overlapped block motion compensation (H.263+)
.
.TP
.B "loop\ \ \ "
loop filter (H.263+)
note, this is broken
.
.TP
.B inter_threshold <-1000\-1000>

.TP
.B vrc_eq=<equation>
main ratecontrol equation (pass 1/2)
.RE
.RSs
.IPs "1\ \ \ \ "
constant bitrate
.IPs "tex\ \ "
constant quality
.IPs 1+(tex/\:avgTex-1)*qComp
approximately the equation of the old ratecontrol code
.IPs tex^qComp
with qcomp 0.5 or something like that (default)

.PP
.RS
variables:
.RE
.RSs
.IPs "tex\ \ "
texture complexity
.IPs iTex,pTex
intra, non-intra texture complexity
.IPs avgTex
average texture complexity

average intra texture complexity in P-frames
.IPs avgPPTex
average non-intra texture complexity in P-frames
.IPs avgBPTex
average non-intra texture complexity in B-frames
.IPs "mv\ \ \ "
bits used for motion vectors
.IPs fCode
maximum length of motion vector in log2 scale
.IPs iCount
number of intra macroblocks / number of macroblocks
.IPs "var\ \ "
spatial complexity
.IPs mcVar
temporal complexity
.IPs qComp
qcomp from the command line
.IPs "isI, isP, isB"
Is 1 if picture type is I/P/B else 0.
.IPs "Pi,E\ "
See your favorite math book.
.RE
.PP
.RS
functions:

with future MPlayer versions (snow, ffvhuff, ffv1).
.RE
.PD 1
.
.TP
.B "vdpart\ "
Data partitioning.
Adds 2 Bytes per video packet, improves error-resistance when transferring over
unreliable channels (e.g.\& streaming over the internet).
Each video packet will be encoded in 3 separate partitions:
.PD 0

.TP
.B vpsize=<0\-10000> (also see vdpart)
Video packet size, improves error-resistance.
.PD 0
.RSs
.IPs "0\ \ \ \ "
disabled (default)
.IPs 100\-1000
good choice
.RE
.PD 1
.
.TP
.B "ss\ \ \ \ \ "
slice structured mode for H.263+
.
.TP
.B "gray\ \ \ "
grayscale only encoding (faster)
.
.TP
.B vfdct=<0\-10>
DCT algorithm

.I WARNING:
Large values might look good on some monitors but may look horrible
on other monitors.
.PD 0
.RSs
.IPs "0.0\ \ "
disabled (default)
.IPs 0.0\-0.3
sane range
.RE
.PD 1

.I WARNING:
Large values might look good on some monitors but may look horrible
on other monitors / TV / TFT.
.PD 0
.RSs
.IPs "0.0\ \ "
disabled (default)
.IPs 0.0\-0.3
sane range
.RE
.PD 1

.I HINT:
Crop any black borders completely as they will reduce the quality
of the macroblocks (also applies without scplx_mask).
.PD 0
.RSs
.IPs "0.0\ \ "
disabled (default)
.IPs 0.0\-0.5
sane range
.RE
.PD 1

Border processing increases the quantizer for macroblocks which are less
than 1/5th of the frame width/height away from the frame border,
since they are often visually less important.
.
.TP
.B "naq\ \ \ \ "
Normalize adaptive quantization (experimental).
When using adaptive quantization (*_mask), the average per-MB quantizer may no
longer match the requested frame-level quantizer.
Naq will attempt to adjust the per-MB quantizers to maintain the proper
average.
.
.TP
.B "ildct\ \ "
Use interlaced DCT.
.
.TP
.B "ilme\ \ \ "
Use interlaced motion estimation (mutually exclusive with qpel).
.
.TP
.B "alt\ \ \ \ "
Use alternative scantable.
.
.TP
.B "top=<-1\-1>\ \ \ "
.PD 0
.RSs
.IPs -1
automatic
.IPs 0

.
.TP
.B format=<value>
.PD 0
.RSs
.IPs "YV12\ "
default
.IPs "444P\ "
for ffv1
.IPs "422P\ "
for HuffYUV, lossless JPEG and ffv1
.IPs 411P,YVU9
for lossless JPEG and ffv1
.IPs BGR32
for lossless JPEG and ffv1
.RE
.PD 1
.
.TP
.B "pred\ \ \ "
(for HuffYUV)
.PD 0
.RSs
.IPs 0
left prediction

median prediction
.RE
.PD 1
.
.TP
.B "pred\ \ \ "
(for lossless JPEG)
.PD 0
.RSs
.IPs 0
left prediction

mean prediction
.RE
.PD 1
.
.TP
.B "coder\ \ "
(for ffv1)
.PD 0
.RSs
.IPs 0
vlc coding (Golomb-Rice)

adaptive Huffman tables
.RE
.PD 1
.
.TP
.B "qpel\ \ \ "
Use quarter pel motion compensation (mutually exclusive with ilme).
.br
.I HINT:
This seems only useful for high bitrate encodings.
.

noise preserving sum of squared differences
.IPs "11 (W53)"
5/3 wavelet, only used in snow
.IPs "12 (W97)"
9/7 wavelet, only used in snow
.IPs "+256\ "
Also use chroma, currently does not work (correctly) with B-frames.
.RE
.PD 1
.
.TP

      0
.fi
.RE
.
.TP
.B "trell\ \ "
Trellis searched quantization.
This will find the optimal encoding for each 8x8 block.
Trellis searched quantization is quite simply an optimal quantization in
the PSNR versus bitrate sense (Assuming that there would be no rounding
errors introduced by the IDCT, which is obviously not the case.).
It simply finds a block for the minimum of error and lambda*bits.
.PD 0
.RSs
.IPs lambda
quantization parameter (QP) dependent constant
.IPs "bits\ "
amount of bits needed to encode the block
.IPs error
sum of squared errors of the quantization
.RE
.PD 1
.
.TP
.B "cbp\ \ \ \ "
Rate distorted optimal coded block pattern.
Will select the coded block pattern which minimizes distortion + lambda*rate.
This can only be used together with trellis quantization.
.
.TP
.B "mv0\ \ \ \ "
Try to encode each MB with MV=<0,0> and choose the better one.
This has no effect if mbd=0.
.
.TP
.B mv0_threshold=<any non-negative integer>

.B refs=<1\-8>
number of reference frames to consider for motion compensation
(Snow only) (default: 1)
.
.TP
.B "psnr\ \ \ "
print the PSNR (peak signal to noise ratio) for the whole video after encoding
and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log'.
Returned values are in dB (decibel), the higher the better.
.
.TP
.B mpeg_quant
Use MPEG quantizers instead of H.263.
.
.TP
.B "aic\ \ \ \ "
Enable AC prediction for MPEG-4 or advanced intra prediction for H.263+.
This will improve quality very slightly (around 0.02 dB PSNR) and slow
down encoding very slightly (about 1%).
.br
.I NOTE:
vqmin should be 8 or larger for H.263+ AIC.
.
.TP
.B "aiv\ \ \ \ "
alternative inter vlc for H.263+
.
.TP
.B "umv\ \ \ \ "
unlimited MVs (H.263+ only)
Allows encoding of arbitrarily long MVs.
.
.TP
.B ibias=<-256\-256>

.TP
.B vqmod_freq
experimental quantizer modulation
.
.TP
.B "dc\ \ \ \ \ "
intra DC precision in bits (default: 8).
If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
.
.TP
.B cgop (also see sc_threshold)

.TP
.B l=<0\-20>
luminance threshold (default: 1)
.
.TP
.B "lzo\ \ \ \ "
Enable LZO compression (default).
.
.TP
.B "nolzo\ \ "
Disable LZO compression.
.
.TP
.B q=<3\-255>
quality level (default: 255)
.
.TP
.B "raw \ \ \ "
Disable RTJPEG encoding.
.
.TP
.B "rtjpeg\ "
Enable RTJPEG encoding (default).
.
.
.SS xvidenc (\-xvidencopts)
.

.I NOTE:
Should you rescale the video, you would need an interlace-aware resizer,
which you can activate with -vf scale=<width>:<height>:1.
.
.TP
.B "4mv\ \ \ \ "
Use 4 motion vectors per macroblock.
This might give better compression, but slows down encoding.
.br
.I WARNING:
As of XviD-1.0.x, this option is no longer available separately, and its

Make XviD discard chroma planes so the encoded video is greyscale only.
Note that this does not speed up encoding, it just prevents chroma data
from being written in the last stage of encoding.
.
.TP
.B "debug\ \ "
Save per-frame statistics in ./xvid.dbg. (This is not the two pass control
file.)
.RE
.
.PP

profile specifications.
.PD 0
.RSs
.IPs unrestricted
no restrictions (default)
.IPs "sp0\ \ "
simple profile at level 0
.IPs "sp1\ \ "
simple profile at level 1
.IPs "sp2\ \ "
simple profile at level 2
.IPs "sp3\ \ "
simple profile at level 3
.IPs "asp0\ "
advanced simple profile at level 0
.IPs "asp1\ "
advanced simple profile at level 1
.IPs "asp2\ "
advanced simple profile at level 2
.IPs "asp3\ "
advanced simple profile at level 3
.IPs "asp4\ "
advanced simple profile at level 4
.IPs "asp5\ "
advanced simple profile at level 5
.IPs dxnhandheld
DXN handheld profile
.IPs dxnportntsc
DXN portable NTSC profile

same as above
.IPs ntsc43
same as above
.IPs ntsc169
same as above (Do not forget to give the exact ratio.)
.IPs "ext\ \ "
Allows you to specify your own pixel aspect ratio with par_width and
par_height.
.RE
.PD 1
.RS

Same as the aspect option, but automatically computes aspect, taking
into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
filter chain.
.
.TP
.B "psnr\ \ \ "
Print the PSNR (peak signal to noise ratio) for the whole video after encoding
and store the per frame PSNR in a file with a name like 'psnr_hhmmss.log' in
the current directory.
Returned values are in dB (decibel), the higher the better.
.

.B cqm=<flat|jvt|<filename>>
Either uses a predefined custom quantization matrix or loads a JM format
matrix file.
.PD 0
.RSs
.IPs "flat\ "
Use the predefined flat 16 matrix (default).
.IPs "jvt\ \ "
Use the predefined JVT matrix.
.IPs <filename>
Use the provided JM format matrix file.
.PD 1
.RE

Each block type on the visualized movie will be colored as follows:
.PD 0
.RSs
.IPs red/pink
intra block
.IPs "blue\ "
inter block
.IPs green
skip block
.IPs yellow
B-block

.B muxrate=<int>
Nominal muxrate in kbit/s used in the pack headers (default: 1800 kb/s).
Will be updated as necessary in the case of 'format=mpeg1' or 'mpeg2'.
.
.TP
.B "tsaf\ \ \ "
Sets timestamps on all frames, if possible.
.
.TP
.B init_vpts=<100\-700>
initial video pts, in milliseconds (default: 200)

.B vdelay=<1\-32760>
Initial video delay time, in milliseconds (default: 0),
use it if you want to delay video with respect to audio.
.
.TP
.B "drop\ \ \ "
When used with init_adelay the muxer drops the part of audio that was
anticipated.
.
.TP
.B vwidth, vheight=<1\-4095>

.B format=<container_format>
Override which container format to mux into
(default: autodetect from output file extension).
.PD 0
.RSs
.IPs "mpg\ \ "
MPEG-1 systems and MPEG-2 PS
.IPs "asf\ \ "
Advanced Streaming Format
.IPs "avi\ \ "
Audio Video Interleave file
.IPs "wav\ \ "
Waveform Audio
.IPs "swf\ \ "
Macromedia Flash
.IPs "flv\ \ "
Macromedia Flash video files
.IPs "rm\ \ \ "
RealAudio and RealVideo
.IPs "au\ \ \ "
SUN AU format
.IPs "nut\ \ "
NUT open container format (experimental)
.IPs "mov\ \ "
QuickTime
.IPs "mp4\ \ "
MPEG-4 format
.IPs "dv\ \ \ "
Sony Digital Video container
.RE
.PD 1
.TP
.B i_certify_that_my_video_stream_does_not_use_b_frames

Sets the authentication and decryption method that
libdvdcss will use to read scrambled discs.
Can be one of title, key or disc.
.PD 0
.RSs
.IPs "key\ \ "
is the default method.
libdvdcss will use a set of calculated player keys to try and get the disc key.
This can fail if the drive does not recognize any of the player keys.
.IPs "disc\ "
is a fallback method when key has failed.
Instead of using player keys, libdvdcss will crack the disc key using
a brute force algorithm.
This process is CPU intensive and requires 64 MB of memory to store
temporary data.