comparison DOCS/man/en/mplayer.1 @ 12988:a0512367674a

Empty lines are not good troff markup, use .sp 1 instead.

12987:98233a9ab00b

This option can be used to configure certain parts of the input system.
Paths are relative to ~/\:.mplayer/.
.br
.I NOTE:
Autorepeat is currently only supported by joysticks.

Available commands are:

.PD 0
.RSs
.IPs conf=<file>
Read alternative input.conf.
If no full path is given, ~/\:.mplayer/<file> is assumed.

Play files in random order.
.TP
.B \-skin <name> (GUI only)
Loads a skin from the directory given as parameter below the default skin
directories, /usr/local/share/mplayer/Skin/ and ~/.mplayer/Skin/.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-skin fittyfene"
Tries /usr/local/share/mplayer/Skin/fittyfene

Works only for DVD playback.
It selects the DVD audio language and always tries to play audio streams whose
language matches the given code.
For the list of available languages, use with the \-v option and look at the
output.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-alang hu,en"
Plays Hungarian and falls back to English if Hungarian is not available.

When the cache is emptied MPlayer will pause and restart playback when
the cache prefill threshold set with this option is reached.
.TP
.B \-cdda <option1:option2> (CDDA only)
This option can be used to tune the CD Audio reading feature of MPlayer.

Available options are:
.
.RSs
.IPs speed=<value>
set CD spin speed

audio into the requested number of channels.
.br
.I NOTE:
This option is honored by codecs (AC3 only) filters (surround) and ao drivers
(OSS at least).

Available options are:

.PD 0
.RSs
.IPs 2
stereo
.IPs 4

Dump raw compressed video stream to ./stream.dump (not very usable).
.TP
.B \-dvbin <options> (DVB only)
Pass the following parameters to the DVB input module, in order to override
the default ones:

.PD 0
.RSs
.IPs card=<1\-4>
Specifies using card number 1\-4 (default: 1).
.IPs file=<file>

.B \-mc <seconds/frame>
Maximum A-V sync correction per frame (in seconds).
.TP
.B \-mf <option1:option2:...>
Used when decoding from multiple PNG or JPEG files.

Available options are:

.PD 0
.RSs
.IPs w=<value>
width of the output (autodetect)
.IPs h=<value>

.TP
.B \-rawaudio <option1:option2:...>
This option lets you play raw audio files.
It may also be used to play audio CDs which are not 44KHz 16Bit stereo.
For playing raw AC3 streams use \-rawaudio on:format=0x2000.

Available options are:

.PD 0
.RSs
.IPs on\ \ \ 
use raw audio demuxer
.IPs channels=<value>

.PD 1
.
.TP
.B \-rawvideo <option1:option2:...>
This option lets you play raw video files.

Available options are:

.PD 0
.RSs
.IPs on\ \ \ 
use raw video demuxer
.IPs fps=<value>

Selects the given output sampling rate, resampling if necessary.
MEncoder passes this value to lame for resampling.
.TP
.B \-ss <time> (see \-sb option too)
Seek to given time position.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ss 56"
seeks to 56 seconds

.br
Be advised that although you can select any samplerate when using ALSA,
the LAME audio codec is able to encode only the 'standard' samplerates.
You'll get an .avi file with no sound when you choose an odd
samplerate and use this codec.

Available options are:
.
.RSs
.IPs noaudio
no sound

.br
.I NOTE:
With FreeType, this option determines path to the text font file.
.br
With fontconfig, this option determines the fontconfig font name.

.I EXAMPLE:
.PD 0
.RSs
\-font ~/\:.mplayer/\:arial-14/\:font.desc
.br

For the list of available subtitles, use with the \-v option and look at the
output.
.br
Otherwise, determines an optional subtitle suffix which gets a higher
priority when searching for subtitles.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-slang hu,en"
Selects Hungarian and falls back to English if Hungarian is not available.

CC subtitles have not been spotted on DVDs from other regions so far.
.TP
.B \-subcp <codepage> (iconv only)
If your system supports iconv(3), you can use this option to
specify codepage of the subtitle.

.I EXAMPLE:
.PD 0
.RSs
\-subcp latin2
.br

You can specify your language using a two letter language code to
make ENCA detect the codepage automatically.
If unsure, enter anything and watch mplayer -v output for available
languages. Fallback codepage specifies the codepage to use, when the
autodetection fails.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-subcp enca:cs:latin2"
Guess the encoding, assuming the subtitles are Czech, fall back to

.B \-subfont-autoscale <0\-3> (FreeType only)
Sets the autoscale mode.
.br
.I NOTE:
Zero means that text-scale and osd-scale are font heights in points.

The mode can be:

.PD 0
.RSs
.IPs 0
no autoscale
.IPs 1

.B \-aofile <filename>
Filename for \-ao pcm.
.TP
.B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
Specify audio plugin(s) and their options (see documentation too).

Available options are:
.
.RSs
.IPs list=[plugins]
comma separated list of plugins (resample, surround, format, volume,

on the command line.
Suboptions are optional and can mostly be omitted.
.br
.I NOTE:
See \-ao help for a list of compiled-in drivers.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ao alsa,oss,"
Try the ALSA driver, then the OSS driver, then others.
.IPs "\-ao alsa:mmap:noblock:device=hw=0.3"
Sets noblock-mode, mmap-mode and the device-name as first card, fourth device.
.RE
.PD 1
.

FIXME: Document suboptions for sdl, arts, esd, jack, nas, macosx, sgi, sun,
win32, dxr2, mpegpes, null, pcm, plugin.

Available audio output drivers are:
.
.TP
.B alsa\ \ \ 
ALSA 0.9/1.x audio output driver.

Specify a parameter list for the directfb driver.
.TP
.B \-display <name> (X11 only)
Specify the hostname and display number of the X server you want to display
on.

.I EXAMPLE:
.PD 0
.RSs
\-display xtest.localdomain:0
.RE

unmute sound output
.IPs ucode=<value>
path to the microcode
.RE
.RS

.I TV Out
.RE
.RSs
.IPs 75ire
enable 7.5 IRE output mode

set pixel mode to square
.IPs ccir601-pixel
set pixel mode to ccir601
.RE
.RS

.I Overlay
.RE
.RSs
.IPs cr-left=<0\-500>
set the left cropping value (default: 50)

.TP
.B \-fstype <type1,type2,...> (X11 only)
Specify a priority list of fullscreen layer setting modes to be
used.
The available types are:

.PD 0
.RSs
.IPs above
Use _NETWM_STATE_ABOVE hint if available.
.IPs below

The values given must be integers.
.br
.I NOTE:
This option is only supported by vo x11, xmga, xv, xvmc, xvidix,
directx and tdfxfb.

.I EXAMPLE:
.PD 0
.RSs
.IPs 50:40
Places the window at x=50, y=40.

.TP
.B \-jpeg <option1:option2:...> (\-vo jpeg only)
Specify options for the JPEG output.
.br
Available options are:

.PD 0
.RSs
.IPs [no]progressive
Specify standard or progressive JPEG.
.IPs [no]baseline

Specify the vertical frequency range of the monitor.
.TP
.B \-monitoraspect <ratio>
Set aspect ratio of your monitor or TV screen.
See also \-aspect for movie aspect.

.I EXAMPLE:
.PD 0
.RSs
\-monitoraspect 4:3  or 1.3333
.br

command line.
Suboptions are optional and can mostly be omitted.
.br
.I NOTE:
See \-vo help for a list of compiled-in drivers.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-vo xmga,xv,"
Try the Matrox X11 driver, then the Xv driver, then others.
.IPs "\-vo directx:noaccel"
Uses the DirectX driver with acceleration features turned off.
.RE
.PD 1
.

FIXME: Document suboptions for x11, xover, dga, sdl, vidix, xvidix, fbdev,
fbdev2, vesa, svga, null, aa, bl, ggi, mga, xmga, syncfb, 3dfx, tdfx_vid,
tdfxfb, dxr2, dxr3, mpegpes, zr, zr2, yuv4mpeg, gif89a, jpeg, pgm, png, tga.

Available video output drivers are:
.
.TP
.B xv (X11 only)
Uses the XVideo extension of XFree86 4.x to enable hardware

.br
.I NOTE:
See \-ac help for a full list of available codecs.
.br
If the list has a trailing ',' it will fallback to codecs not listed.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ac mp3acm"
force l3codeca.acm MP3 codec

name in codecs.conf.
It falls back to default if none is ok.
.br
.I NOTE:
See \-afm help for a full list of available drivers.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-afm ffmpeg"
try FFmpeg's libavcodec (mp1/\:2/\:3) codecs first

.
.TP
.B \-aspect <ratio>
Override aspect ratio of movies.
It's autodetected on MPEG files, but can't be autodetected on most AVI files.

.I EXAMPLE:
.PD 0
.RSs
\-aspect 4:3  or \-aspect 1.3333
.br

.B \-flip \ 
Flip image upside-down.
.TP
.B \-lavdopts <option1:option2:...> (DEBUG CODE)
If decoding with libavcodec, you can specify its parameters here.

.I EXAMPLE:
.PD 0
.RSs
\-lavdopts bug=1
.RE
.PD 1

.RS
.I NOTE:
Just add the values of the things you want to enable.
.br
Available options are:

.B \-pphelp (see \-vf pp option too)
Show a summary about the available postprocess filters and their usage.
.TP
.B \-ssf <mode>
Specifies SwScaler parameters.

.I EXAMPLE:
.PD 0
.RSs
\-vf scale \-ssf lgb=3.0
.RE

.br
.I NOTE:
For \-sws\ 2 and 7, the sharpness can be set with the scaling parameter (p)
of \-vf scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter
length (1 \- 10).

.PD 0
.RSs
.IPs 0
fast bilinear (default)
.IPs 1

.br
.I NOTE:
See \-vc help for a full list of available codecs.
.br
If the list has a trailing ',' it will fallback to codecs not listed.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-vc divx"
force Win32/\:VFW DivX codec, no fallback

just the same DivX4 codec, but different APIs to reach it.
For difference between them and when to use which, check the DivX4 section in
the documentation.
.br
See \-vfm help for a full list of available drivers.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-vfm ffmpeg,dshow,vfw"
try the libavcodec, then Directshow, then VFW codecs and fallback to the

Parameters w:h means width x height in pixels, x:y means x;y position counted
from the upper left corner of the bigger image.
.br
.I NOTE:
To get a full list of available filters, see \-vf help.

Filters are managed in lists.
There are a few commands to manage the filter list.
.TP
.B \-vf-add <filter1[,filter2,...]>
Appends the filters given as arguments to the filter list.

Can be used for placing subtitles/\:OSD in the resulting black bands.
.RSs
.IPs w,h
expanded width,height (default: original width,height).
Negative values for w and h are treated as offsets to the original size.

.I EXAMPLE:
.PD 0
.RSs
.IP expand=0:-50:0:0
adds a 50 pixel border to the bottom of the picture

Do chrominance filtering, too.
.IPs y
Do not do chrominance filtering (only luminance filtering).
.RE
.PD 1

.RS
.I EXAMPLE:
.RE
.PD 0
.RSs

.IPs fifo\ 
path/filename for the FIFO (named pipe connecting mplayer \-vf bmovl to the
controlling application)
.RE
.PD 1

.RS
FIFO commands are:
.RE
.PD 0
.RSs

hide bitmap
.IPs SHOW\ 
show bitmap
.RE
.PD 1

.RS
Arguments are:
.RE
.PD 0
.RSs

.RE
.PD 1
.TP
.B framestep=I|[i]step
Renders only every nth frame or every Intra (key) frame.

If you call the filter with I (uppercase) as the parameter, then ONLY
keyframes are rendered.
For DVDs it generally means one in every 15/12  frames (IBBPBBPBBPBBPBB),
for AVI it means every scene change or every keyint value (see \-lavcopts
keyint= value if you use MEncoder to encode the video).

When a key frame is found, an 'I!' string followed by a newline character is
printed, leaving the current line of mplayer/mencoder output on the screen,
because it contains the time (in seconds) and frame number of the keyframe
(You can use this information to split the AVI.).

If you call the filter with a numeric parameter 'step' then only one in
every 'step' frames is rendered.

If you put an 'i' (lowercase) before the number then an I! is printed
(like the I parameter).

If you give only the i then nothing is done to the frames, only I! is
printed.
.TP
.B tile=xtile:ytile:output:start:delta
Tile a series of images into a single, bigger image.

value is used. You can also stop when you're OK (... \-vf tile=10:5 ...)
.
It is probably a good idea to put the scale filter before the tile :-)
.br
The parameters are:

.PD 0
.RSs
.IPs xtile
number of tiles on the x axis (default: 5)
.IPs ytile

Can be specified in many ways:
.br
.I NOTE:
Byte position won't be accurate, as it can only stop at
a frame boundary.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-endpos 56"
encode only 56 seconds

.PD 1
.
.TP
.B \-ffourcc <fourcc>
Can be used to override the video fourcc of the output file.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ffourcc div3"
will have the output file contain 'div3' as video fourcc.

.TP
.B \-oac <codec name>
Encode with the given audio codec.
Use \-oac help to get a list of available codecs.
(no default set)

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-oac copy"
no encoding, just streamcopy

.
.TP
.B \-of <format> (BETA CODE!)
Encode to the specified format.
Use \-of help to get a list of available formats.

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-of avi"
encode to avi (default)

.TP
.B \-ovc <codec name>
Encode with the given video codec.
Use \-ovc help to get a list of available codecs.
(no default set)

.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ovc copy"
no encoding, just streamcopy

.IPs insane
CBR encoding, highest preset quality, 320 kbps bitrate.
.IPs <8\-320>
ABR encoding at average given kbps bitrate.
.RE

.RS
.I EXAMPLE:
.RE
.PD 0
.RSs

first pass
.IPs 2
second pass
.RE
.PD 1

.RS
huffyuv:
.RE
.PD 0
.RSs

Store movie aspect internally, just like MPEG files.
Much nicer solution than rescaling, because quality isn't decreased.
Only MPlayer will play these files correctly, other players will display
them with wrong aspect.
The aspect parameter can be given as a ratio or a floating point number.

.RS
.I EXAMPLE:
.RE
.RSs
.PD 0

kfreduction determines the bitrate reduction they get.
The last i-frame will get treated normally.
(default: 30, 2pass mode only)
.RE
.PP

The following options are only available with the latest stable
releases of XviD 1.0.x (api4).
.TP
.B packed\ 
create a bitstream that can be decoded delay-free (default: off)

12988:a0512367674a

This option can be used to configure certain parts of the input system.
Paths are relative to ~/\:.mplayer/.
.br
.I NOTE:
Autorepeat is currently only supported by joysticks.
.sp 1
Available commands are:
.sp 1
.PD 0
.RSs
.IPs conf=<file>
Read alternative input.conf.
If no full path is given, ~/\:.mplayer/<file> is assumed.

Play files in random order.
.TP
.B \-skin <name> (GUI only)
Loads a skin from the directory given as parameter below the default skin
directories, /usr/local/share/mplayer/Skin/ and ~/.mplayer/Skin/.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-skin fittyfene"
Tries /usr/local/share/mplayer/Skin/fittyfene

Works only for DVD playback.
It selects the DVD audio language and always tries to play audio streams whose
language matches the given code.
For the list of available languages, use with the \-v option and look at the
output.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-alang hu,en"
Plays Hungarian and falls back to English if Hungarian is not available.

When the cache is emptied MPlayer will pause and restart playback when
the cache prefill threshold set with this option is reached.
.TP
.B \-cdda <option1:option2> (CDDA only)
This option can be used to tune the CD Audio reading feature of MPlayer.
.sp 1
Available options are:
.
.RSs
.IPs speed=<value>
set CD spin speed

audio into the requested number of channels.
.br
.I NOTE:
This option is honored by codecs (AC3 only) filters (surround) and ao drivers
(OSS at least).
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs 2
stereo
.IPs 4

Dump raw compressed video stream to ./stream.dump (not very usable).
.TP
.B \-dvbin <options> (DVB only)
Pass the following parameters to the DVB input module, in order to override
the default ones:
.sp 1
.PD 0
.RSs
.IPs card=<1\-4>
Specifies using card number 1\-4 (default: 1).
.IPs file=<file>

.B \-mc <seconds/frame>
Maximum A-V sync correction per frame (in seconds).
.TP
.B \-mf <option1:option2:...>
Used when decoding from multiple PNG or JPEG files.
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs w=<value>
width of the output (autodetect)
.IPs h=<value>

.TP
.B \-rawaudio <option1:option2:...>
This option lets you play raw audio files.
It may also be used to play audio CDs which are not 44KHz 16Bit stereo.
For playing raw AC3 streams use \-rawaudio on:format=0x2000.
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs on\ \ \ 
use raw audio demuxer
.IPs channels=<value>

.PD 1
.
.TP
.B \-rawvideo <option1:option2:...>
This option lets you play raw video files.
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs on\ \ \ 
use raw video demuxer
.IPs fps=<value>

Selects the given output sampling rate, resampling if necessary.
MEncoder passes this value to lame for resampling.
.TP
.B \-ss <time> (see \-sb option too)
Seek to given time position.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ss 56"
seeks to 56 seconds

.br
Be advised that although you can select any samplerate when using ALSA,
the LAME audio codec is able to encode only the 'standard' samplerates.
You'll get an .avi file with no sound when you choose an odd
samplerate and use this codec.
.sp 1
Available options are:
.
.RSs
.IPs noaudio
no sound

.br
.I NOTE:
With FreeType, this option determines path to the text font file.
.br
With fontconfig, this option determines the fontconfig font name.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-font ~/\:.mplayer/\:arial-14/\:font.desc
.br

For the list of available subtitles, use with the \-v option and look at the
output.
.br
Otherwise, determines an optional subtitle suffix which gets a higher
priority when searching for subtitles.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-slang hu,en"
Selects Hungarian and falls back to English if Hungarian is not available.

CC subtitles have not been spotted on DVDs from other regions so far.
.TP
.B \-subcp <codepage> (iconv only)
If your system supports iconv(3), you can use this option to
specify codepage of the subtitle.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-subcp latin2
.br

You can specify your language using a two letter language code to
make ENCA detect the codepage automatically.
If unsure, enter anything and watch mplayer -v output for available
languages. Fallback codepage specifies the codepage to use, when the
autodetection fails.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-subcp enca:cs:latin2"
Guess the encoding, assuming the subtitles are Czech, fall back to

.B \-subfont-autoscale <0\-3> (FreeType only)
Sets the autoscale mode.
.br
.I NOTE:
Zero means that text-scale and osd-scale are font heights in points.
.sp 1
The mode can be:
.sp 1
.PD 0
.RSs
.IPs 0
no autoscale
.IPs 1

.B \-aofile <filename>
Filename for \-ao pcm.
.TP
.B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
Specify audio plugin(s) and their options (see documentation too).
.sp 1
Available options are:
.
.RSs
.IPs list=[plugins]
comma separated list of plugins (resample, surround, format, volume,

on the command line.
Suboptions are optional and can mostly be omitted.
.br
.I NOTE:
See \-ao help for a list of compiled-in drivers.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ao alsa,oss,"
Try the ALSA driver, then the OSS driver, then others.
.IPs "\-ao alsa:mmap:noblock:device=hw=0.3"
Sets noblock-mode, mmap-mode and the device-name as first card, fourth device.
.RE
.PD 1
.
.sp 1
FIXME: Document suboptions for sdl, arts, esd, jack, nas, macosx, sgi, sun,
win32, dxr2, mpegpes, null, pcm, plugin.
.sp 1
Available audio output drivers are:
.
.TP
.B alsa\ \ \ 
ALSA 0.9/1.x audio output driver.

Specify a parameter list for the directfb driver.
.TP
.B \-display <name> (X11 only)
Specify the hostname and display number of the X server you want to display
on.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-display xtest.localdomain:0
.RE

unmute sound output
.IPs ucode=<value>
path to the microcode
.RE
.RS
.sp 1
.I TV Out
.RE
.RSs
.IPs 75ire
enable 7.5 IRE output mode

set pixel mode to square
.IPs ccir601-pixel
set pixel mode to ccir601
.RE
.RS
.sp 1
.I Overlay
.RE
.RSs
.IPs cr-left=<0\-500>
set the left cropping value (default: 50)

.TP
.B \-fstype <type1,type2,...> (X11 only)
Specify a priority list of fullscreen layer setting modes to be
used.
The available types are:
.sp 1
.PD 0
.RSs
.IPs above
Use _NETWM_STATE_ABOVE hint if available.
.IPs below

The values given must be integers.
.br
.I NOTE:
This option is only supported by vo x11, xmga, xv, xvmc, xvidix,
directx and tdfxfb.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs 50:40
Places the window at x=50, y=40.

.TP
.B \-jpeg <option1:option2:...> (\-vo jpeg only)
Specify options for the JPEG output.
.br
Available options are:
.sp 1
.PD 0
.RSs
.IPs [no]progressive
Specify standard or progressive JPEG.
.IPs [no]baseline

Specify the vertical frequency range of the monitor.
.TP
.B \-monitoraspect <ratio>
Set aspect ratio of your monitor or TV screen.
See also \-aspect for movie aspect.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-monitoraspect 4:3  or 1.3333
.br

command line.
Suboptions are optional and can mostly be omitted.
.br
.I NOTE:
See \-vo help for a list of compiled-in drivers.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-vo xmga,xv,"
Try the Matrox X11 driver, then the Xv driver, then others.
.IPs "\-vo directx:noaccel"
Uses the DirectX driver with acceleration features turned off.
.RE
.PD 1
.
.sp 1
FIXME: Document suboptions for x11, xover, dga, sdl, vidix, xvidix, fbdev,
fbdev2, vesa, svga, null, aa, bl, ggi, mga, xmga, syncfb, 3dfx, tdfx_vid,
tdfxfb, dxr2, dxr3, mpegpes, zr, zr2, yuv4mpeg, gif89a, jpeg, pgm, png, tga.
.sp 1
Available video output drivers are:
.
.TP
.B xv (X11 only)
Uses the XVideo extension of XFree86 4.x to enable hardware

.br
.I NOTE:
See \-ac help for a full list of available codecs.
.br
If the list has a trailing ',' it will fallback to codecs not listed.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ac mp3acm"
force l3codeca.acm MP3 codec

name in codecs.conf.
It falls back to default if none is ok.
.br
.I NOTE:
See \-afm help for a full list of available drivers.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-afm ffmpeg"
try FFmpeg's libavcodec (mp1/\:2/\:3) codecs first

.
.TP
.B \-aspect <ratio>
Override aspect ratio of movies.
It's autodetected on MPEG files, but can't be autodetected on most AVI files.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-aspect 4:3  or \-aspect 1.3333
.br

.B \-flip \ 
Flip image upside-down.
.TP
.B \-lavdopts <option1:option2:...> (DEBUG CODE)
If decoding with libavcodec, you can specify its parameters here.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-lavdopts bug=1
.RE
.PD 1
.sp 1
.RS
.I NOTE:
Just add the values of the things you want to enable.
.br
Available options are:

.B \-pphelp (see \-vf pp option too)
Show a summary about the available postprocess filters and their usage.
.TP
.B \-ssf <mode>
Specifies SwScaler parameters.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-vf scale \-ssf lgb=3.0
.RE

.br
.I NOTE:
For \-sws\ 2 and 7, the sharpness can be set with the scaling parameter (p)
of \-vf scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter
length (1 \- 10).
.sp 1
.PD 0
.RSs
.IPs 0
fast bilinear (default)
.IPs 1

.br
.I NOTE:
See \-vc help for a full list of available codecs.
.br
If the list has a trailing ',' it will fallback to codecs not listed.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-vc divx"
force Win32/\:VFW DivX codec, no fallback

just the same DivX4 codec, but different APIs to reach it.
For difference between them and when to use which, check the DivX4 section in
the documentation.
.br
See \-vfm help for a full list of available drivers.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-vfm ffmpeg,dshow,vfw"
try the libavcodec, then Directshow, then VFW codecs and fallback to the

Parameters w:h means width x height in pixels, x:y means x;y position counted
from the upper left corner of the bigger image.
.br
.I NOTE:
To get a full list of available filters, see \-vf help.
.sp 1
Filters are managed in lists.
There are a few commands to manage the filter list.
.TP
.B \-vf-add <filter1[,filter2,...]>
Appends the filters given as arguments to the filter list.

Can be used for placing subtitles/\:OSD in the resulting black bands.
.RSs
.IPs w,h
expanded width,height (default: original width,height).
Negative values for w and h are treated as offsets to the original size.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IP expand=0:-50:0:0
adds a 50 pixel border to the bottom of the picture

Do chrominance filtering, too.
.IPs y
Do not do chrominance filtering (only luminance filtering).
.RE
.PD 1
.sp 1
.RS
.I EXAMPLE:
.RE
.PD 0
.RSs

.IPs fifo\ 
path/filename for the FIFO (named pipe connecting mplayer \-vf bmovl to the
controlling application)
.RE
.PD 1
.sp 1
.RS
FIFO commands are:
.RE
.PD 0
.RSs

hide bitmap
.IPs SHOW\ 
show bitmap
.RE
.PD 1
.sp 1
.RS
Arguments are:
.RE
.PD 0
.RSs

.RE
.PD 1
.TP
.B framestep=I|[i]step
Renders only every nth frame or every Intra (key) frame.
.sp 1
If you call the filter with I (uppercase) as the parameter, then ONLY
keyframes are rendered.
For DVDs it generally means one in every 15/12  frames (IBBPBBPBBPBBPBB),
for AVI it means every scene change or every keyint value (see \-lavcopts
keyint= value if you use MEncoder to encode the video).
.sp 1
When a key frame is found, an 'I!' string followed by a newline character is
printed, leaving the current line of mplayer/mencoder output on the screen,
because it contains the time (in seconds) and frame number of the keyframe
(You can use this information to split the AVI.).
.sp 1
If you call the filter with a numeric parameter 'step' then only one in
every 'step' frames is rendered.
.sp 1
If you put an 'i' (lowercase) before the number then an I! is printed
(like the I parameter).
.sp 1
If you give only the i then nothing is done to the frames, only I! is
printed.
.TP
.B tile=xtile:ytile:output:start:delta
Tile a series of images into a single, bigger image.

value is used. You can also stop when you're OK (... \-vf tile=10:5 ...)
.
It is probably a good idea to put the scale filter before the tile :-)
.br
The parameters are:
.sp 1
.PD 0
.RSs
.IPs xtile
number of tiles on the x axis (default: 5)
.IPs ytile

Can be specified in many ways:
.br
.I NOTE:
Byte position won't be accurate, as it can only stop at
a frame boundary.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-endpos 56"
encode only 56 seconds

.PD 1
.
.TP
.B \-ffourcc <fourcc>
Can be used to override the video fourcc of the output file.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ffourcc div3"
will have the output file contain 'div3' as video fourcc.

.TP
.B \-oac <codec name>
Encode with the given audio codec.
Use \-oac help to get a list of available codecs.
(no default set)
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-oac copy"
no encoding, just streamcopy

.
.TP
.B \-of <format> (BETA CODE!)
Encode to the specified format.
Use \-of help to get a list of available formats.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-of avi"
encode to avi (default)

.TP
.B \-ovc <codec name>
Encode with the given video codec.
Use \-ovc help to get a list of available codecs.
(no default set)
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-ovc copy"
no encoding, just streamcopy

.IPs insane
CBR encoding, highest preset quality, 320 kbps bitrate.
.IPs <8\-320>
ABR encoding at average given kbps bitrate.
.RE
.sp 1
.RS
.I EXAMPLE:
.RE
.PD 0
.RSs

first pass
.IPs 2
second pass
.RE
.PD 1
.sp 1
.RS
huffyuv:
.RE
.PD 0
.RSs

Store movie aspect internally, just like MPEG files.
Much nicer solution than rescaling, because quality isn't decreased.
Only MPlayer will play these files correctly, other players will display
them with wrong aspect.
The aspect parameter can be given as a ratio or a floating point number.
.sp 1
.RS
.I EXAMPLE:
.RE
.RSs
.PD 0

kfreduction determines the bitrate reduction they get.
The last i-frame will get treated normally.
(default: 30, 2pass mode only)
.RE
.PP
.sp 1
The following options are only available with the latest stable
releases of XviD 1.0.x (api4).
.TP
.B packed\ 
create a bitstream that can be decoded delay-free (default: off)