mirror of https://github.com/mpv-player/mpv
7912 lines
220 KiB
Groff
7912 lines
220 KiB
Groff
.\" $Revision$
|
|
.\" MPlayer (C) 2000-2010 MPlayer Team
|
|
.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Macro definitions
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.\" define indentation for suboptions
|
|
.nr SS 5
|
|
.\" add new suboption
|
|
.de IPs
|
|
.IP "\\$1" \n(SS
|
|
..
|
|
.\" begin of first level suboptions, end with .RE
|
|
.de RSs
|
|
.RS 10
|
|
..
|
|
.\" begin of 2nd level suboptions
|
|
.de RSss
|
|
.PD 0
|
|
.RS \n(SS+3
|
|
..
|
|
.\" end of 2nd level suboptions
|
|
.de REss
|
|
.RE
|
|
.PD 1
|
|
..
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Title
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.TH MPlayer 1 "2009-03-25" "The MPlayer Project" "The Movie Player"
|
|
.
|
|
.SH NAME
|
|
mplayer \- movie player
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Synopsis
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH SYNOPSIS
|
|
.na
|
|
.nh
|
|
.B mplayer
|
|
[options] [file|URL|playlist|\-]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
[options] file1
|
|
[specific options] [file2] [specific options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
[options]
|
|
{group of files and options}
|
|
[group-specific options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
[br]://[title][/device]
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
[dvd|dvdnav]://[title|[start_title]\-end_title][/device]
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
vcd://track[/device]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
tv://[channel][/input_id]
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
radio://[channel|frequency][/capture]
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
pvr://
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
dvb://[card_number@]channel
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
mf://[filemask|@listfile]
|
|
[\-mf options] [options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
[cdda|cddb]://track[\-endtrack][:speed][/device]
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
cue://file[:track]
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
[file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]://
|
|
[user:pass@]URL[:port] [options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
sdp://file
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
mpst://host[:port]/URL
|
|
[options]
|
|
.
|
|
.br
|
|
.B mplayer
|
|
tivo://host/[list|llist|fsid]
|
|
[options]
|
|
.ad
|
|
.hy
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Description
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH DESCRIPTION
|
|
.B mplayer
|
|
is a movie player for Linux (runs on many other platforms and CPU
|
|
architectures, see the documentation).
|
|
It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
|
|
MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
|
|
native and binary codecs.
|
|
You can watch VCD, SVCD, DVD, Blu\-ray, 3ivx, DivX 3/4/5, WMV and even H.264 movies,
|
|
too.
|
|
.PP
|
|
MPlayer supports a wide range of video and audio output drivers.
|
|
It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
|
|
Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers),
|
|
VESA (on every VESA-compatible card, even without X11), some low-level
|
|
card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder
|
|
boards, such as the Siemens DVB, Hauppauge PVR (IVTV) and DXR3/\:Hollywood+.
|
|
Most of them support software or hardware scaling, so you can enjoy movies in
|
|
fullscreen mode.
|
|
.PP
|
|
MPlayer has an onscreen display (OSD) for status information, nice big
|
|
antialiased shaded subtitles and visual feedback for keyboard controls.
|
|
European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
|
|
fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
|
|
SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
|
|
DVD subtitles (SPU streams, VOBsub and Closed Captions).
|
|
.PP
|
|
Usage examples to get you started quickly can be found at the end
|
|
of this man page.
|
|
.PP
|
|
.B Also see the HTML documentation!
|
|
.
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" interactive control
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH "INTERACTIVE CONTROL"
|
|
MPlayer has a fully configurable, command-driven control layer
|
|
which allows you to control MPlayer using keyboard, mouse, joystick
|
|
or remote control (with LIRC).
|
|
See the \-input option for ways to customize it.
|
|
.
|
|
.TP
|
|
.B keyboard control
|
|
.PD 0
|
|
.RS
|
|
.IPs "LEFT and RIGHT"
|
|
Seek backward/\:forward 10 seconds.
|
|
Shift+arrow does a 1 second exact seek (see \-hr\-seek; currently modifier
|
|
keys like shift only work if used in an X output window).
|
|
.IPs "UP and DOWN"
|
|
Seek forward/\:backward 1 minute.
|
|
Shift+arrow does a 5 second exact seek (see \-hr\-seek; currently modifier
|
|
keys like shift only work if used in an X output window).
|
|
.IPs "PGUP and PGDWN"
|
|
Seek forward/\:backward 10 minutes.
|
|
.IPs "[ and ]"
|
|
Decrease/increase current playback speed by 10%.
|
|
.IPs "{ and }"
|
|
Halve/double current playback speed.
|
|
.IPs "BACKSPACE"
|
|
Reset playback speed to normal.
|
|
.IPs "< and >"
|
|
Go backward/\:forward in the playlist.
|
|
.IPs "ENTER"
|
|
Go forward in the playlist, even over the end.
|
|
.IPs "HOME and END"
|
|
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.
|
|
.IPs "q / ESC"
|
|
Stop playing and quit.
|
|
.IPs "U\ \ \ \ "
|
|
Stop playing (and quit if \-idle is not used).
|
|
.IPs "+ and \-"
|
|
Adjust audio delay by +/\- 0.1 seconds.
|
|
.IPs "/ and *"
|
|
Decrease/\:increase volume.
|
|
.IPs "9 and 0"
|
|
Decrease/\:increase volume.
|
|
.IPs "( and )"
|
|
Adjust audio balance in favor of left/\:right channel.
|
|
.IPs "m\ \ \ \ "
|
|
Mute sound.
|
|
.IPs "_ (MPEG-TS, AVI and libavformat only)"
|
|
Cycle through the available video tracks.
|
|
.IPs "# (DVD, Blu-ray, MPEG, Matroska, AVI and libavformat only)"
|
|
Cycle through the available audio tracks.
|
|
.IPs "TAB (MPEG-TS and libavformat only)"
|
|
Cycle through the available programs.
|
|
.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 "j and J"
|
|
Cycle through the available subtitles.
|
|
.IPs "y and g"
|
|
Step forward/backward in the subtitle list.
|
|
.IPs "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 "V\ \ \ \ "
|
|
Toggle subtitle VSFilter aspect compatibility mode.
|
|
See -ass\-vsfilter\-aspect\-compat for more info.
|
|
.IPs "C (\-capture only)"
|
|
Start/stop capturing the primary stream.
|
|
.IPs "r and t"
|
|
Move subtitles up/down.
|
|
.IPs "i (\-edlout mode only)"
|
|
Set start or end of an EDL skip and write it out to the given file.
|
|
.IPs "s (\-vf screenshot only)"
|
|
Take a screenshot.
|
|
.IPs "S (\-vf screenshot only)"
|
|
Start/stop taking screenshots.
|
|
.IPs "I\ \ \ \ "
|
|
Show filename on the OSD.
|
|
.IPs "P\ \ \ \ "
|
|
Show progression bar, elapsed time and total duration on the OSD.
|
|
.IPs "! and @"
|
|
Seek to the beginning of the previous/next chapter.
|
|
.IPs "D (\-vo vdpau, \-vf yadif, \-vf kerndeint only)"
|
|
Activate/deactivate deinterlacer.
|
|
.IPs "A\ \ \ \ "
|
|
Cycle through the available DVD angles.
|
|
.IPs "c (currently -vo vdpau and -vo xv only)"
|
|
Change YUV colorspace.
|
|
.RE
|
|
.PD 1
|
|
.PP
|
|
.RS
|
|
(The following keys are valid only when using a video output that supports
|
|
the corresponding adjustment, the software equalizer
|
|
(\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
|
|
.RE
|
|
.PP
|
|
.PD 0
|
|
.RS
|
|
.IPs "1 and 2"
|
|
Adjust contrast.
|
|
.IPs "3 and 4"
|
|
Adjust brightness.
|
|
.IPs "5 and 6"
|
|
Adjust hue.
|
|
.IPs "7 and 8"
|
|
Adjust saturation.
|
|
.RE
|
|
.PD 1
|
|
.PP
|
|
.RS
|
|
(The following keys are valid only when using the quartz or corevideo
|
|
video output driver.)
|
|
.RE
|
|
.PP
|
|
.PD 0
|
|
.RS
|
|
.IPs "command + 0"
|
|
Resize movie window to half its original size.
|
|
.IPs "command + 1"
|
|
Resize movie window to its original size.
|
|
.IPs "command + 2"
|
|
Resize movie window to double its original size.
|
|
.IPs "command + f"
|
|
Toggle fullscreen (also see \-fs).
|
|
.IPs "command + [ and command + ]"
|
|
Set movie window alpha.
|
|
.RE
|
|
.PD 1
|
|
.PP
|
|
.RS
|
|
(The following keys are valid only when using the sdl
|
|
video output driver.)
|
|
.RE
|
|
.PP
|
|
.PD 0
|
|
.RS
|
|
.IPs "c\ \ \ \ "
|
|
Cycle through available fullscreen modes.
|
|
.IPs "n\ \ \ \ "
|
|
Restore original mode.
|
|
.RE
|
|
.PD 1
|
|
.PP
|
|
.RS
|
|
(The following keys are valid if you have a keyboard
|
|
with multimedia keys.)
|
|
.RE
|
|
.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
|
|
.RS
|
|
(The following keys are only valid if you compiled with TV or DVB input
|
|
support and will take precedence over the keys defined above.)
|
|
.RE
|
|
.PP
|
|
.PD 0
|
|
.RS
|
|
.IPs "h and k"
|
|
Select previous/\:next channel.
|
|
.IPs "n\ \ \ \ "
|
|
Change norm.
|
|
.IPs "u\ \ \ \ "
|
|
Change channel list.
|
|
.RE
|
|
.PD 1
|
|
.PP
|
|
.RS
|
|
(The following keys are only valid if you compiled with dvdnav
|
|
support: They are used to navigate the menus.)
|
|
.RE
|
|
.PP
|
|
.PD 0
|
|
.RS
|
|
.IPs "keypad 8"
|
|
Select button up.
|
|
.IPs "keypad 2"
|
|
Select button down.
|
|
.IPs "keypad 4"
|
|
Select button left.
|
|
.IPs "keypad 6"
|
|
Select button right.
|
|
.IPs "keypad 5"
|
|
Return to main menu.
|
|
.IPs "keypad 7"
|
|
Return to nearest menu (the order of preference is: chapter->title->root).
|
|
.IPs "keypad ENTER"
|
|
Confirm choice.
|
|
.RE
|
|
.PD 1
|
|
.PP
|
|
.RS
|
|
.
|
|
(The following keys are used for controlling TV teletext. The data may
|
|
come from either an analog TV source or an MPEG transport stream.)
|
|
.RE
|
|
.PP
|
|
.PD 0
|
|
.RS
|
|
.IPs "X\ \ \ \ "
|
|
Switch teletext on/\:off.
|
|
.IPs "Q and W"
|
|
Go to next/\:prev teletext page.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B mouse control
|
|
.PD 0
|
|
.RS
|
|
.IPs "button 3 and button 4"
|
|
Seek backward/\:forward 1 minute.
|
|
.IPs "button 5 and button 6"
|
|
Decrease/\:increase volume.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B joystick control
|
|
.PD 0
|
|
.RS
|
|
.IPs "left and right"
|
|
Seek backward/\:forward 10 seconds.
|
|
.IPs "up and down"
|
|
Seek forward/\:backward 1 minute.
|
|
.IPs "button 1"
|
|
Pause.
|
|
.IPs "button 2"
|
|
Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
|
|
.IPs "button 3 and button 4"
|
|
Decrease/\:increase volume.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Usage
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH "USAGE"
|
|
Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
|
|
\-fs option is \-nofs.
|
|
.PP
|
|
If an option is marked as (XXX only), it will only work in combination with
|
|
the XXX option or if XXX is compiled in.
|
|
.PP
|
|
.I NOTE:
|
|
The suboption parser (used for example for \-ao pcm suboptions) supports
|
|
a special kind of string-escaping intended for use with external GUIs.
|
|
.br
|
|
It has the following format:
|
|
.br
|
|
%n%string_of_length_n
|
|
.br
|
|
.I EXAMPLES:
|
|
.br
|
|
mplayer \-ao pcm:file=%10%C:test.wav test.avi
|
|
.br
|
|
Or in a script:
|
|
.br
|
|
mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
|
|
.PP
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Configuration files
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH "CONFIGURATION FILES"
|
|
You can put all of the options in configuration files which will be read
|
|
every time MPlayer is run.
|
|
The system-wide configuration file 'mplayer.conf' is in your configuration
|
|
directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
|
|
specific one is '~/\:.mplayer/\:config'.
|
|
User specific options override system-wide options and options given on the
|
|
command line override either.
|
|
The syntax of the configuration files is 'option=<value>', everything after
|
|
a '#' is considered a comment.
|
|
Options that work without values can be enabled by setting them to 'yes'
|
|
or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
|
|
Even suboptions can be specified in this way.
|
|
.PP
|
|
You can also write file-specific configuration files.
|
|
If you wish to have a configuration file for a file called 'movie.avi', create a file
|
|
named 'movie.avi.conf' with the file-specific options in it and put it in
|
|
~/.mplayer/.
|
|
You can also put the configuration file in the same directory as the file to
|
|
be played, as long as you give the \-use\-filedir\-conf option (either on the
|
|
command line or in your global config file).
|
|
If a file-specific configuration file is found in the same directory, no
|
|
file-specific configuration is loaded from ~/.mplayer.
|
|
In addition, the \-use\-filedir\-conf option enables directory-specific
|
|
configuration files.
|
|
For this, MPlayer first tries to load a mplayer.conf from the same directory as
|
|
the file played and then tries to load any file-specific configuration.
|
|
.PP
|
|
.I EXAMPLE MPLAYER CONFIGURATION FILE:
|
|
.sp 1
|
|
.nf
|
|
# Use Matrox driver by default.
|
|
vo=xmga
|
|
# I love practicing handstands while watching videos.
|
|
flip=yes
|
|
# Decode multiple files from PNG,
|
|
# start with mf://filemask
|
|
mf=type=png:fps=25
|
|
# Eerie negative images are cool.
|
|
vf=eq2=1.0:\-0.8
|
|
.fi
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Profiles
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH "PROFILES"
|
|
To ease working with different configurations profiles can be defined in the
|
|
configuration files.
|
|
A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
|
|
All following options will be part of the profile.
|
|
A description (shown by \-profile help) can be defined with the profile-desc
|
|
option.
|
|
To end the profile, start another one or use the profile name 'default'
|
|
to continue with normal options.
|
|
.fi
|
|
.PP
|
|
.I "EXAMPLE MPLAYER PROFILE:"
|
|
.sp 1
|
|
.nf
|
|
|
|
[protocol.dvd]
|
|
profile-desc="profile for dvd:// streams"
|
|
vf=pp=hb/vb/dr/al/fd
|
|
alang=en
|
|
|
|
[protocol.dvdnav]
|
|
profile-desc="profile for dvdnav:// streams"
|
|
profile=protocol.dvd
|
|
mouse-movements=yes
|
|
nocache=yes
|
|
|
|
[extension.flv]
|
|
profile-desc="profile for .flv files"
|
|
flip=yes
|
|
|
|
[vo.pnm]
|
|
outdir=/tmp
|
|
|
|
[ao.alsa]
|
|
device=spdif
|
|
.fi
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Options
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH "GENERAL OPTIONS"
|
|
.
|
|
.TP
|
|
.B \-codecpath <dir>
|
|
Specify a directory for binary codecs.
|
|
.
|
|
.TP
|
|
.B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
|
|
Override the standard search path and use the specified file
|
|
instead of the builtin codecs.conf.
|
|
.
|
|
.TP
|
|
.B \-include <configuration file>
|
|
Specify configuration file to be parsed after the default ones.
|
|
.
|
|
.TP
|
|
.B \-list\-options
|
|
Prints all available options.
|
|
.
|
|
.TP
|
|
.B \-msgcharset <charset>
|
|
Convert console messages to the specified character set (default: autodetect).
|
|
Text will be in the encoding specified with the \-\-charset configure option.
|
|
Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
|
|
.br
|
|
.I NOTE:
|
|
The option takes effect after command line parsing has finished.
|
|
The MPLAYER_CHARSET environment variable can help you get rid of
|
|
the first lines of garbled output.
|
|
.
|
|
.TP
|
|
.B \-msgcolor
|
|
Enable colorful console output on terminals that support ANSI color.
|
|
.
|
|
.TP
|
|
.B \-msglevel <all=<level>:<module>=<level>:...>
|
|
Control verbosity directly for each module.
|
|
The 'all' module changes the verbosity of all the modules not
|
|
explicitly specified on the command line.
|
|
See '\-msglevel help' for a list of all modules.
|
|
.br
|
|
.I NOTE:
|
|
Some messages are printed before the command line is parsed and are
|
|
therefore not affected by \-msglevel.
|
|
To control these messages you have to use the MPLAYER_VERBOSE environment
|
|
variable, see its description below for details.
|
|
.br
|
|
Available levels:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-1"
|
|
complete silence
|
|
.IPs " 0"
|
|
fatal messages only
|
|
.IPs " 1"
|
|
error messages
|
|
.IPs " 2"
|
|
warning messages
|
|
.IPs " 3"
|
|
short hints
|
|
.IPs " 4"
|
|
informational messages
|
|
.IPs " 5"
|
|
status messages (default)
|
|
.IPs " 6"
|
|
verbose messages
|
|
.IPs " 7"
|
|
debug level 2
|
|
.IPs " 8"
|
|
debug level 3
|
|
.IPs " 9"
|
|
debug level 4
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-msgmodule
|
|
Prepend module name in front of each console message.
|
|
.
|
|
.TP
|
|
.B \-noconfig <options>
|
|
Do not parse selected configuration files.
|
|
.br
|
|
.I NOTE:
|
|
If \-include or \-use\-filedir\-conf options are
|
|
specified at the command line, they will be honoured.
|
|
.sp 1
|
|
Available options are:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "all\ \ "
|
|
all configuration files
|
|
.IPs system
|
|
system configuration file
|
|
.IPs "user\ "
|
|
user configuration file
|
|
.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 \-priority <prio> (Windows and OS/2 only)
|
|
Set process priority for MPlayer according to the predefined
|
|
priorities available under Windows and OS/2.
|
|
Possible values of <prio>:
|
|
.RSs
|
|
idle|belownormal|normal|abovenormal|high|realtime
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I WARNING:
|
|
Using realtime priority can cause system lockup.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-profile <profile1,profile2,...>
|
|
Use the given profile(s), \-profile help displays a list of the defined profiles.
|
|
.
|
|
.TP
|
|
.B \-really\-quiet (also see \-quiet)
|
|
Display even less output and status messages than with \-quiet.
|
|
.
|
|
.TP
|
|
.B \-show\-profile <profile>
|
|
Show the description and content of a profile.
|
|
.
|
|
.TP
|
|
.B \-use\-filedir\-conf
|
|
Look for a file-specific configuration file in the same directory as
|
|
the file that is being played.
|
|
.br
|
|
.I WARNING:
|
|
May be dangerous if playing from untrusted media.
|
|
.
|
|
.TP
|
|
.B "\-v\ \ \ \ \ "
|
|
Increment verbosity level, one level for each \-v
|
|
found on the command line.
|
|
.
|
|
.
|
|
.
|
|
.SH "PLAYER OPTIONS"
|
|
.
|
|
.TP
|
|
.B \-autoq <quality> (use with \-vf [s]pp)
|
|
Dynamically changes the level of postprocessing depending on the available spare
|
|
CPU time.
|
|
The number you specify will be the maximum level used.
|
|
Usually you can use some big number.
|
|
You have to use \-vf [s]pp without parameters in order for this to work.
|
|
.
|
|
.TP
|
|
.B \-autosync <factor>
|
|
Gradually adjusts the A/V sync based on audio delay measurements.
|
|
Specifying \-autosync 0, the default, will cause frame timing to be based
|
|
entirely on audio delay measurements.
|
|
Specifying \-autosync 1 will do the same, but will subtly change the A/V
|
|
correction algorithm.
|
|
An uneven video framerate in a movie which plays fine with \-nosound can
|
|
often be helped by setting this to an integer value greater than 1.
|
|
The higher the value, the closer the timing will be to \-nosound.
|
|
Try \-autosync 30 to smooth out problems with sound drivers which do
|
|
not implement a perfect audio delay measurement.
|
|
With this value, if large A/V sync offsets occur, they will only take about
|
|
1 or 2 seconds to settle out.
|
|
This delay in reaction time to sudden A/V offsets should be the only
|
|
side-effect of turning this option on, for all sound drivers.
|
|
.
|
|
.TP
|
|
.B \-benchmark
|
|
Prints some statistics on CPU usage and dropped frames at the end of playback.
|
|
Use in combination with \-nosound and \-vo null for benchmarking only the
|
|
video codec.
|
|
.br
|
|
.I NOTE:
|
|
With this option MPlayer will also ignore frame duration when playing
|
|
only video (you can think of that as infinite fps).
|
|
.
|
|
.TP
|
|
.B \-chapter\-merge\-threshold <number>
|
|
Threshold for merging almost consecutive ordered chapter parts
|
|
in milliseconds (default: 100).
|
|
Some Matroska files with ordered chapters have inaccurate chapter
|
|
end timestamps, causing a small gap between the end of one chapter and
|
|
the start of the next one when they should match.
|
|
If the end of one playback part is less than the given threshold away
|
|
from the start of the next one then keep playing video normally over the
|
|
chapter change instead of doing a seek.
|
|
.
|
|
.TP
|
|
.B \-colorkey <number>
|
|
Changes the colorkey to an RGB value of your choice.
|
|
0x000000 is black and 0xffffff is white.
|
|
Only supported by the fbdev, svga, vesa, xmga,
|
|
xover, xv (see \-vo xv:ck) and directx video output drivers.
|
|
.
|
|
.TP
|
|
.B \-nocolorkey
|
|
Disables colorkeying.
|
|
Only supported by the fbdev, svga, vesa, xmga,
|
|
xover, xv (see \-vo xv:ck) and directx video output drivers.
|
|
.
|
|
.TP
|
|
.B \-correct\-pts, \-nocorrect\-pts
|
|
Switches MPlayer to a mode where timestamps for video frames
|
|
are calculated differently and video filters which add new frames or
|
|
modify timestamps of existing ones are supported.
|
|
Now enabled automatically for most common file formats.
|
|
The more accurate timestamps can be visible for example when playing
|
|
subtitles timed to scene changes with the \-ass option.
|
|
Without \-correct\-pts the subtitle timing will typically be off by some frames.
|
|
This option does not work correctly with some demuxers and codecs.
|
|
.
|
|
.TP
|
|
.B \-crash\-debug (DEBUG CODE)
|
|
Automatically attaches gdb upon crash or SIGTRAP.
|
|
Support must be compiled in by configuring with \-\-enable\-crash\-debug.
|
|
.
|
|
.TP
|
|
.B \-doubleclick\-time
|
|
Time in milliseconds to recognize two consecutive button presses as
|
|
a double-click (default: 300).
|
|
Set to 0 to let your windowing system decide what a double-click is
|
|
(\-vo directx only).
|
|
.
|
|
.TP
|
|
.B \-edlout <filename>
|
|
Creates a new file and writes edit decision list (EDL) records to it.
|
|
During playback, the user hits 'i' to mark the start or end of a skip block.
|
|
This provides a starting point from which the user can fine-tune EDL entries
|
|
later.
|
|
See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
|
|
.
|
|
.TP
|
|
.B \-fixed\-vo, \-nofixed\-vo
|
|
\-fixed\-vo enforces a fixed video system for multiple files (one
|
|
(un)initialization for all files).
|
|
Therefore only one window will be opened for all files.
|
|
Now enabled by default, use \-nofixed\-vo to disable and create a new window
|
|
whenever the video stream changes.
|
|
Some of the older drivers may not be fixed-vo compliant.
|
|
.
|
|
.TP
|
|
.B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts)
|
|
Skip displaying some frames to maintain A/V sync on slow systems.
|
|
Video filters are not applied to such frames.
|
|
For B-frames even decoding is skipped completely.
|
|
.
|
|
.TP
|
|
.B \-h, \-help, \-\-help
|
|
Show short summary of options.
|
|
.
|
|
.TP
|
|
.B \-hardframedrop (experimental without \-nocorrect\-pts)
|
|
More intense frame dropping (breaks decoding).
|
|
Leads to image distortion!
|
|
Note that especially the libmpeg2 decoder may crash with this,
|
|
so consider using "\-vc ffmpeg12,".
|
|
.
|
|
.TP
|
|
.B \-heartbeat\-cmd
|
|
Command that is executed every 30 seconds during playback via system() -
|
|
i.e.\& using the shell.
|
|
.sp 1
|
|
.I NOTE:
|
|
MPlayer uses this command without any checking, it is your responsibility
|
|
to ensure it does not cause security problems (e.g.\& make sure to use full
|
|
paths if "." is in your path like on Windows).
|
|
It also only works when playing video (i.e.\& not with \-novideo but works with \-vo null).
|
|
.sp 1
|
|
This can be "misused" to disable screensavers that do not support the proper
|
|
X API (also see \-stop\-xscreensaver).
|
|
If you think this is too complicated, ask the author of the screensaver
|
|
program to support the proper X APIs.
|
|
.sp 1
|
|
.I EXAMPLE for xscreensaver:
|
|
mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file
|
|
.sp 1
|
|
.I EXAMPLE for GNOME screensaver:
|
|
mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-hr\-seek off|absolute|always
|
|
Select when to use precise seeks that are not limited to keyframes.
|
|
Such seeks require decoding video from the previous keyframe up to the target
|
|
position and so can take some time depending on decoding performance.
|
|
For some video formats precise seeks are disabled. This option selects the
|
|
default choice to use for seeks; it's possible to explicitly override that
|
|
default in the definition of key bindings and in slave mode commands.
|
|
.PD 0
|
|
.RSs
|
|
.IPs off
|
|
Never use precise seeks.
|
|
.IPs absolute
|
|
Use precise seeks if the seek is to an absolute position in the file,
|
|
such as a chapter seek, but not for relative seeks like the default
|
|
behavior of arrow keys (default).
|
|
.IPs always
|
|
Use precise seeks whenever possible.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-identify
|
|
Shorthand for \-msglevel identify=4.
|
|
Show file parameters in an easily parseable format.
|
|
Also prints more detailed information about subtitle and audio
|
|
track languages and IDs.
|
|
In some cases you can get more information by using \-msglevel identify=6.
|
|
For example, for a DVD or Blu\-ray it will list the chapters and time length
|
|
of each title, as well as a disk ID.
|
|
Combine this with \-frames 0 to suppress all video output.
|
|
The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and
|
|
(hopefully) shellescapes the filenames.
|
|
.
|
|
.TP
|
|
.B \-idle (also see \-slave)
|
|
Makes MPlayer wait idly instead of quitting when there is no file to play.
|
|
Mostly useful in slave mode where MPlayer can be controlled
|
|
through input commands.
|
|
.
|
|
.TP
|
|
.B \-input <commands>
|
|
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=<filename>
|
|
Specify input configuration file other than the default
|
|
~/\:.mplayer/\:input.conf.
|
|
~/\:.mplayer/\:<filename> is assumed if no full path is given.
|
|
.IPs ar-dev=<device>
|
|
Device to be used for Apple IR Remote (default is autodetected, Linux only).
|
|
.IPs ar-delay
|
|
Delay in milliseconds before we start to autorepeat a key (0 to disable).
|
|
.IPs ar-rate
|
|
Number of key presses to generate per second on autorepeat.
|
|
.IPs (no)default-bindings
|
|
Use the key bindings that MPlayer ships with by default.
|
|
.IPs keylist
|
|
Prints all keys that can be bound to commands.
|
|
.IPs cmdlist
|
|
Prints all commands that can be bound to keys.
|
|
.IPs js-dev
|
|
Specifies the joystick device to use (default: /dev/\:input/\:js0).
|
|
.IPs file=<filename>
|
|
Read commands from the given file.
|
|
Mostly useful with a FIFO.
|
|
.br
|
|
.I NOTE:
|
|
When the given file is a FIFO MPlayer opens both ends so you can do
|
|
several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-key\-fifo\-size <2\-65000>
|
|
Specify the size of the FIFO that buffers key events (default: 7).
|
|
If it is too small some events may be lost.
|
|
The main disadvantage of setting it to a very large value is that if you
|
|
hold down a key triggering some particularly slow command then the player
|
|
may be unresponsive while it processes all the queued commands.
|
|
.
|
|
.TP
|
|
.B \-lircconf <filename> (LIRC only)
|
|
Specifies a configuration file for LIRC (default: ~/.lircrc).
|
|
.
|
|
.TP
|
|
.B \-list\-properties
|
|
Print a list of the available properties.
|
|
.
|
|
.TP
|
|
.B \-loop <number>
|
|
Loops movie playback <number> times.
|
|
0 means forever.
|
|
.
|
|
.TP
|
|
.B \-menu (OSD menu only)
|
|
Turn on OSD menu support.
|
|
.
|
|
.TP
|
|
.B \-menu\-cfg <filename> (OSD menu only)
|
|
Use an alternative menu.conf.
|
|
.
|
|
.TP
|
|
.B \-menu\-chroot <path> (OSD menu only)
|
|
Chroot the file selection menu to a specific location.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-menu\-chroot /home"
|
|
Will restrict the file selection menu to /\:home and downward (i.e.\& no
|
|
access to / will be possible, but /home/user_name will).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-menu\-keepdir (OSD menu only)
|
|
File browser starts from the last known location instead of current directory.
|
|
.
|
|
.TP
|
|
.B \-menu\-root <value> (OSD menu only)
|
|
Specify the main menu.
|
|
.
|
|
.TP
|
|
.B \-menu\-startup (OSD menu only)
|
|
Display the main menu at MPlayer startup.
|
|
.
|
|
.TP
|
|
.B \-mouse\-movements
|
|
Permit MPlayer to receive pointer events reported by the video
|
|
output driver.
|
|
Necessary to select the buttons in DVD menus.
|
|
Supported for X11-based VOs (x11, xv, etc) and the gl, gl2, direct3d and
|
|
corevideo VOs.
|
|
.
|
|
.TP
|
|
.B \-noar
|
|
Turns off AppleIR remote support.
|
|
.
|
|
.TP
|
|
.B \-noconsolecontrols
|
|
Prevent MPlayer from reading key events from standard input.
|
|
Useful when reading data from standard input.
|
|
This is automatically enabled when \- is found on the command line.
|
|
There are situations where you have to set it manually, e.g.\&
|
|
if you open /dev/\:stdin (or the equivalent on your system), use stdin
|
|
in a playlist or intend to read from stdin later on via the loadfile or
|
|
loadlist slave commands.
|
|
.
|
|
.TP
|
|
.B \-noinitial-audio-sync
|
|
When starting a video file or after events such as seeking MPlayer will by
|
|
default modify the audio stream to make it start from the same timestamp as
|
|
video, by either inserting silence at the start or cutting away the first
|
|
samples.
|
|
This option disables that functionality and makes the player behave like
|
|
older MPlayer versions did: video and audio are both started immediately
|
|
even if their start timestamps differ, and then video timing is gradually
|
|
adjusted if necessary to reach correct synchronization later.
|
|
.
|
|
.TP
|
|
.B \-nojoystick
|
|
Turns off joystick support.
|
|
.
|
|
.TP
|
|
.B \-nolirc
|
|
Turns off LIRC support.
|
|
.
|
|
.TP
|
|
.B \-nomouseinput
|
|
Disable mouse button press/\:release input (mozplayerxp's context menu relies
|
|
on this option).
|
|
.TP
|
|
.B \-noordered\-chapters
|
|
Disable support for Matroska ordered chapters.
|
|
MPlayer will not load or search for video segments from other files,
|
|
and will also ignore any chapter order specified for the main file.
|
|
.
|
|
.TP
|
|
.B \-pts\-association\-mode auto|decode|sort
|
|
Select the method used to determine which container packet timestamp
|
|
corresponds to a particular output frame from the video decoder.
|
|
Normally you shouldn't need to change this option.
|
|
.PD 0
|
|
.RSs
|
|
.IPs auto
|
|
Try to pick a working mode from the ones below automatically (default)
|
|
.IPs decoder
|
|
Use decoder reordering functionality.
|
|
.IPs sort
|
|
Maintain a buffer of unused pts values and use the lowest value for the frame.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-rtc (RTC only)
|
|
Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
|
|
mechanism.
|
|
This wakes up the process every 1/1024 seconds to check the current time.
|
|
Useless with modern Linux kernels configured for desktop use as they already
|
|
wake up the process with similar accuracy when using normal timed sleep.
|
|
.
|
|
.TP
|
|
.B \-playing\-msg <string>
|
|
Print out a string before starting playback.
|
|
The following expansions are supported:
|
|
.RSs
|
|
.IPs ${NAME}
|
|
Expand to the value of the property NAME.
|
|
.IPs ?(NAME:TEXT)
|
|
Expand TEXT only if the property NAME is available.
|
|
.IPs ?(!NAME:TEXT)
|
|
Expand TEXT only if the property NAME is not available.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-playlist <filename>
|
|
Play files according to a playlist file (ASX, Winamp, SMIL, or
|
|
one-file-per-line format).
|
|
.br
|
|
.I WARNING:
|
|
The way MPlayer parses and uses playlist files is not safe against
|
|
maliciously constructed files.
|
|
Such files may trigger harmful actions.
|
|
This has been the case for all MPlayer versions, but unfortunately this
|
|
fact was not well documented earlier, and some people have even misguidedly
|
|
recommended use of -playlist with untrusted sources.
|
|
Do NOT use -playlist with random internet sources or files you don't trust!
|
|
.br
|
|
.I NOTE:
|
|
This option is considered an entry so options found after it will apply
|
|
only to the elements of this playlist.
|
|
.br
|
|
FIXME: This needs to be clarified and documented thoroughly.
|
|
.
|
|
.TP
|
|
.B \-rtc\-device <device>
|
|
Use the specified device for RTC timing.
|
|
.
|
|
.TP
|
|
.B \-shuffle
|
|
Play files in random order.
|
|
.
|
|
.TP
|
|
.B \-slave (also see \-input)
|
|
Switches on slave mode, in which MPlayer works as a backend for other programs.
|
|
Instead of intercepting keyboard events, MPlayer will read commands separated
|
|
by a newline (\\n) from stdin.
|
|
.br
|
|
.I NOTE:
|
|
See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
|
|
for their description.
|
|
Also, this is not intended to disable other inputs, e.g.\& via the video window,
|
|
use some other method like \-input nodefault\-bindings:conf=/dev/null for that.
|
|
.
|
|
.TP
|
|
.B \-softsleep
|
|
Time frames by repeatedly checking the current time instead of asking the
|
|
kernel to wake up MPlayer at the correct time.
|
|
Useful if your kernel timing is imprecise and you cannot use the RTC either.
|
|
Comes at the price of higher CPU consumption.
|
|
.
|
|
.TP
|
|
.B \-sstep <sec>
|
|
Skip <sec> seconds after every frame.
|
|
The normal framerate of the movie is kept, so playback is accelerated.
|
|
Since MPlayer can only seek to the next keyframe this may be inexact.
|
|
.
|
|
.
|
|
.
|
|
.SH "DEMUXER/STREAM OPTIONS"
|
|
.
|
|
.TP
|
|
.B \-a52drc <level>
|
|
Select the Dynamic Range Compression level for AC-3 audio streams.
|
|
<level> is a float value ranging from 0 to 1, where 0 means no compression
|
|
and 1 (which is the default) means full compression (make loud passages more
|
|
silent and vice versa).
|
|
Values up to 2 are also accepted, but are purely experimental.
|
|
This option only shows an effect if the AC-3 stream contains the required range
|
|
compression information.
|
|
.
|
|
.TP
|
|
.B \-aid <ID> (also see \-alang)
|
|
Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
|
|
VOB(AC-3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
|
|
MPlayer prints the available audio IDs when run in verbose (\-v) mode.
|
|
When playing an MPEG-TS stream, MPlayer will use the first program (if present)
|
|
with the chosen audio stream.
|
|
.
|
|
.TP
|
|
.B \-ausid <ID> (also see \-alang)
|
|
Select audio substream channel.
|
|
Currently the valid range is 0x55..0x75 and applies only to MPEG-TS when handled
|
|
by the native demuxer (not by libavformat).
|
|
The format type may not be correctly identified because of how this information
|
|
(or lack thereof) is embedded in the stream, but it will demux correctly the
|
|
audio streams when multiple substreams are present.
|
|
MPlayer prints the available substream IDs when run with \-identify.
|
|
.
|
|
.TP
|
|
.B \-alang <language code[,language code,...]> (also see \-aid)
|
|
Specify a priority list of audio languages to use.
|
|
Different container formats employ different language codes.
|
|
DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT
|
|
use ISO 639-2 three letter language codes while OGM uses a free-form identifier.
|
|
MPlayer prints the available languages when run in verbose (\-v) mode.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "mplayer dvd://1 \-alang hu,en"
|
|
Chooses the Hungarian language track on a DVD and falls back on English if
|
|
Hungarian is not available.
|
|
.IPs "mplayer \-alang jpn example.mkv"
|
|
Plays a Matroska file in Japanese.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-audio\-demuxer <[+]name> (\-audiofile only)
|
|
Force audio demuxer type for \-audiofile.
|
|
Use a '+' before the name to force it, this will skip some checks!
|
|
Give the demuxer name as printed by \-audio\-demuxer help.
|
|
\-audio\-demuxer audio forces MP3.
|
|
.
|
|
.TP
|
|
.B \-audiofile <filename>
|
|
Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
|
|
movie.
|
|
.
|
|
.TP
|
|
.B \-audiofile\-cache <kBytes>
|
|
Enables caching for the stream used by \-audiofile, using the specified
|
|
amount of memory.
|
|
.
|
|
.TP
|
|
.B \-reuse\-socket (udp:// only)
|
|
Allows a socket to be reused by other processes as soon as it is closed.
|
|
.
|
|
.TP
|
|
.B \-bandwidth <Bytes> (network only)
|
|
Specify the maximum bandwidth for network streaming (for servers that are
|
|
able to send content in different bitrates).
|
|
Useful if you want to watch live streamed media behind a slow connection.
|
|
With Real RTSP streaming, it is also used to set the maximum delivery
|
|
bandwidth allowing faster cache filling and stream dumping.
|
|
.
|
|
.TP
|
|
.B \-bluray\-angle <angle ID> (Blu\-ray only)
|
|
Some Blu\-ray discs contain scenes that can be viewed from multiple angles.
|
|
Here you can tell MPlayer which angles to use (default: 1).
|
|
.
|
|
.TP
|
|
.B \-bluray\-chapter <chapter ID> (Blu\-ray only)
|
|
Tells MPlayer which Blu\-ray chapter to start the current title from (default: 1).
|
|
.
|
|
.TP
|
|
.B \-bluray\-device <path to disc> (Blu\-ray only)
|
|
Specify the Blu\-ray disc location. Must be a directory with Blu\-ray structure.
|
|
.
|
|
.TP
|
|
.B \-cache <kBytes>
|
|
This option specifies how much memory (in kBytes) to use when precaching a
|
|
file or URL.
|
|
Especially useful on slow media.
|
|
.
|
|
.TP
|
|
.B \-nocache
|
|
Turns off caching.
|
|
.
|
|
.TP
|
|
.B \-cache\-min <percentage>
|
|
Playback will start when the cache has been filled up to <percentage>
|
|
of the total.
|
|
.
|
|
.TP
|
|
.B \-cache\-seek\-min <percentage>
|
|
If a seek is to be made to a position within <percentage> of the cache size
|
|
from the current position, MPlayer will wait for the cache to be filled to
|
|
this position rather than performing a stream seek (default: 50).
|
|
.
|
|
.TP
|
|
.B \-capture
|
|
Allows capturing the primary stream (not additional audio tracks or other
|
|
kind of streams) into the file specified by \-dumpfile or \"stream.dump\"
|
|
by default.
|
|
If this option is given, capturing can be started and stopped by pressing
|
|
the key bound to this function (see section INTERACTIVE CONTROL).
|
|
Same as for \-dumpstream, this will likely not produce usable results for
|
|
anything else than MPEG streams.
|
|
Note that, due to cache latencies, captured data may begin and end
|
|
somewhat delayed compared to what you see displayed.
|
|
.
|
|
.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.
|
|
.IPs paranoia=<0\-2>
|
|
Set paranoia level.
|
|
Values other than 0 seem to break playback of anything but the first track.
|
|
.RSss
|
|
0: disable checking (default)
|
|
.br
|
|
1: overlap checking only
|
|
.br
|
|
2: full data correction and verification
|
|
.REss
|
|
.IPs generic-dev=<value>
|
|
Use specified generic SCSI device.
|
|
.IPs sector-size=<value>
|
|
Set atomic read size.
|
|
.IPs overlap=<value>
|
|
Force minimum overlap search during verification to <value> sectors.
|
|
.IPs toc-bias
|
|
Assume that the beginning offset of track 1 as reported in the TOC will be
|
|
addressed as LBA 0.
|
|
Some Toshiba drives need this for getting track boundaries correct.
|
|
.IPs toc-offset=<value>
|
|
Add <value> sectors to the values reported when addressing tracks.
|
|
May be negative.
|
|
.IPs (no)skip
|
|
(Never) accept imperfect data reconstruction.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-cdrom\-device <path to device>
|
|
Specify the CD-ROM device (default: /dev/\:cdrom).
|
|
.
|
|
.TP
|
|
.B \-channels <number> (also see \-af channels)
|
|
Request the number of playback channels (default: 2).
|
|
MPlayer asks the decoder to decode the audio into as many channels as
|
|
specified.
|
|
Then it is up to the decoder to fulfill the requirement.
|
|
This is usually only important when playing videos with AC-3 audio (like DVDs).
|
|
In that case liba52 does the decoding by default and correctly downmixes the
|
|
audio into the requested number of channels.
|
|
To directly control the number of output channels independently of how many
|
|
channels are decoded, use the channels filter.
|
|
.br
|
|
.I NOTE:
|
|
This option is honored by codecs (AC-3 only), filters (surround) and audio
|
|
output drivers (OSS at least).
|
|
.sp 1
|
|
Available options are:
|
|
.sp 1
|
|
.PD 0
|
|
.RSs
|
|
.IPs 2
|
|
stereo
|
|
.IPs 4
|
|
surround
|
|
.IPs 6
|
|
full 5.1
|
|
.IPs 8
|
|
full 7.1
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
|
|
Specify which chapter to start playing at.
|
|
Optionally specify which chapter to end playing at (default: 1).
|
|
.
|
|
.TP
|
|
.B \-edition <edition ID> (Matroska only)
|
|
Specify the edition (set of chapters) to use, where 0 is the first. If set to
|
|
-1 (the default), MPlayer will choose the first edition declared as a default,
|
|
or if there is no default, the first edition defined.
|
|
.
|
|
.TP
|
|
.B \-cookies (network only)
|
|
Send cookies when making HTTP requests.
|
|
.
|
|
.TP
|
|
.B \-cookies\-file <filename> (network only)
|
|
Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
|
|
and skip reading from default locations.
|
|
The file is assumed to be in Netscape format.
|
|
.
|
|
.TP
|
|
.B \-delay <sec>
|
|
audio delay in seconds (positive or negative float value)
|
|
.br
|
|
Negative values delay the audio, and positive values delay the video.
|
|
.
|
|
.TP
|
|
.B \-ignore\-start
|
|
Ignore the specified starting time for streams in AVI files.
|
|
This nullifies stream delays.
|
|
.
|
|
.TP
|
|
.B \-demuxer <[+]name>
|
|
Force demuxer type.
|
|
Use a '+' before the name to force it, this will skip some checks!
|
|
Give the demuxer name as printed by \-demuxer help.
|
|
.
|
|
.TP
|
|
.B \-dumpaudio
|
|
Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3,
|
|
in most other cases the resulting file will not be playable).
|
|
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
|
|
on the command line only the last one will work.
|
|
.
|
|
.TP
|
|
.B \-dumpfile <filename>
|
|
Specify which file MPlayer should dump to.
|
|
Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream /
|
|
\-capture.
|
|
.
|
|
.TP
|
|
.B \-dumpstream
|
|
Dumps the raw stream to ./stream.dump.
|
|
Useful when ripping from DVD or network.
|
|
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
|
|
on the command line only the last one will work.
|
|
.
|
|
.TP
|
|
.B \-dumpvideo
|
|
Dump raw compressed video stream to ./stream.dump (not very usable).
|
|
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
|
|
on the command line only the last one will work.
|
|
.
|
|
.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=<filename>
|
|
Instructs MPlayer to read the channels list from <filename>.
|
|
Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
|
|
or ~/.mplayer/\:channels.conf as a last resort.
|
|
.IPs timeout=<1\-30>
|
|
Maximum number of seconds to wait when trying to tune a
|
|
frequency before giving up (default: 30).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-dvd\-device <path to device> (DVD only)
|
|
Specify the DVD device or .iso filename (default: /dev/\:dvd).
|
|
You can also specify a directory that contains files previously copied directly
|
|
from a DVD (with e.g.\& vobcopy).
|
|
.
|
|
.TP
|
|
.B \-dvd\-speed <factor or speed in KB/s> (DVD only)
|
|
Try to limit DVD speed (default: 0, no change).
|
|
DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to
|
|
10800KB/s.
|
|
Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be
|
|
quiet and fast enough.
|
|
MPlayer resets the speed to the drive default value on close.
|
|
Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects
|
|
10800KB/s.
|
|
.br
|
|
.I NOTE:
|
|
You need write access to the DVD device to change the speed.
|
|
.
|
|
.TP
|
|
.B \-dvdangle <angle ID> (DVD only)
|
|
Some DVD discs contain scenes that can be viewed from multiple angles.
|
|
Here you can tell MPlayer which angles to use (default: 1).
|
|
.
|
|
.TP
|
|
.B \-edl <filename>
|
|
Enables edit decision list (EDL) actions during playback.
|
|
Video will be skipped over and audio will be muted and unmuted according to
|
|
the entries in the given file.
|
|
See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
|
|
on how to use this.
|
|
.
|
|
.TP
|
|
.B \-endpos <[[hh:]mm:]ss[.ms]> (also see \-ss and \-sb)
|
|
Stop at given time.
|
|
.br
|
|
.I NOTE:
|
|
When used in conjunction with \-ss option, \-endpos time will shift forward by
|
|
seconds specified with \-ss.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-endpos 56"
|
|
Stop at 56 seconds.
|
|
.IPs "\-endpos 01:10:00"
|
|
Stop at 1 hour 10 minutes.
|
|
.IPs "\-ss 10 \-endpos 56"
|
|
Stop at 1 minute 6 seconds.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-forceidx
|
|
Force index rebuilding.
|
|
Useful for files with broken index (A/V desync, etc).
|
|
This will enable seeking in files where seeking was not possible.
|
|
.br
|
|
.I NOTE:
|
|
This option only works if the underlying media supports seeking
|
|
(i.e.\& not with stdin, pipe, etc).
|
|
.
|
|
.TP
|
|
.B \-fps <float value>
|
|
Override video framerate.
|
|
Useful if the original value is wrong or missing.
|
|
.
|
|
.TP
|
|
.B \-frames <number>
|
|
Play/\:convert only first <number> frames, then quit.
|
|
.
|
|
.TP
|
|
.B \-hr\-mp3\-seek (MP3 only)
|
|
Hi-res MP3 seeking.
|
|
Enabled when playing from an external MP3 file, as we need to seek
|
|
to the very exact position to keep A/V sync.
|
|
Can be slow especially when seeking backwards since it has to rewind
|
|
to the beginning to find an exact frame position.
|
|
.
|
|
.TP
|
|
.B \-http-header-fields <field1,field2>
|
|
Set custom HTTP fields when accessing HTTP stream.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs
|
|
mplayer \-http\-header\-fields 'Field1: value1','Field2: value2' http://localhost:1234
|
|
.br
|
|
Will generate HTTP request:
|
|
.RSss
|
|
.br
|
|
GET / HTTP/1.0
|
|
.br
|
|
Host: localhost:1234
|
|
.br
|
|
User-Agent: MPlayer
|
|
.br
|
|
Icy-MetaData: 1
|
|
.br
|
|
Field1: value1
|
|
.br
|
|
Field2: value2
|
|
.br
|
|
Connection: close
|
|
.REss
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-idx (also see \-forceidx)
|
|
Rebuilds index of files if no index was found, allowing seeking.
|
|
Useful with broken/\:incomplete downloads, or badly created files.
|
|
.br
|
|
.I NOTE:
|
|
This option only works if the underlying media supports seeking
|
|
(i.e.\& not with stdin, pipe, etc).
|
|
.
|
|
.TP
|
|
.B \-noidx
|
|
Skip rebuilding index file.
|
|
.
|
|
.TP
|
|
.B \-ipv4\-only\-proxy (network only)
|
|
Skip the proxy for IPv6 addresses.
|
|
It will still be used for IPv4 connections.
|
|
.
|
|
.TP
|
|
.B \-lavfdopts <option1:option2:...>
|
|
Specify parameters for libavformat demuxers (\-demuxer lavf).
|
|
Separate multiple options with a colon.
|
|
.sp
|
|
.RS
|
|
Available suboptions are:
|
|
.RE
|
|
.RSs
|
|
.IPs analyzeduration=<value>
|
|
Maximum length in seconds to analyze the stream properties.
|
|
.IPs format=<value>
|
|
Force a specific libavformat demuxer.
|
|
.IPs o=<key>=<value>[,<key>=<value>[,...]]
|
|
Pass AVOptions to libavformat demuxer.
|
|
Note, a patch to make the o= unneeded and pass all unknown options through
|
|
the AVOption system is welcome.
|
|
A full list of AVOptions can be found in the FFmpeg manual.
|
|
Note that some options may conflict with MPlayer options.
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.PD 0
|
|
.IPs o=fflags=+ignidx
|
|
.PD 1
|
|
.RE
|
|
.IPs probesize=<value>
|
|
Maximum amount of data to probe during the detection phase.
|
|
In the case of MPEG-TS this value identifies the maximum number
|
|
of TS packets to scan.
|
|
.IPs cryptokey=<hexstring>
|
|
Encryption key the demuxer should use.
|
|
This is the raw binary data of the key converted to a hexadecimal string.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-loadidx <index file>
|
|
The file from which to read the video index data saved by \-saveidx.
|
|
This index will be used for seeking, overriding any index data
|
|
contained in the AVI itself.
|
|
MPlayer will not prevent you from loading an index file generated
|
|
from a different AVI, but this is sure to cause unfavorable results.
|
|
.br
|
|
.I NOTE:
|
|
This option is obsolete now that MPlayer has OpenDML support.
|
|
.
|
|
.TP
|
|
.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>
|
|
input file width (default: autodetect)
|
|
.IPs h=<value>
|
|
input file height (default: autodetect)
|
|
.IPs fps=<value>
|
|
output fps (default: 25)
|
|
.IPs type=<value>
|
|
input file type (available: jpeg, png, tga, sgi)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-ni (AVI only)
|
|
Force usage of non-interleaved AVI parser (fixes playback
|
|
of some bad AVI files).
|
|
.
|
|
.TP
|
|
.B \-nobps (AVI only)
|
|
Do not use average byte/\:second value for A-V sync.
|
|
Helps with some AVI files with broken header.
|
|
.
|
|
.TP
|
|
.B \-noextbased
|
|
Disables extension-based demuxer selection.
|
|
By default, when the file type (demuxer) cannot be detected reliably
|
|
(the file has no header or it is not reliable enough), the filename
|
|
extension is used to select the demuxer.
|
|
Always falls back on content-based demuxer selection.
|
|
.
|
|
.TP
|
|
.B \-passwd <password> (also see \-user) (network only)
|
|
Specify password for HTTP authentication.
|
|
.
|
|
.TP
|
|
.B \-prefer\-ipv4 (network only)
|
|
Use IPv4 on network connections.
|
|
Falls back on IPv6 automatically.
|
|
.
|
|
.TP
|
|
.B \-prefer\-ipv6 (IPv6 network only)
|
|
Use IPv6 on network connections.
|
|
Falls back on IPv4 automatically.
|
|
.
|
|
.TP
|
|
.B \-psprobe <byte position>
|
|
When playing an MPEG-PS or MPEG-PES streams, this option lets you specify
|
|
how many bytes in the stream you want MPlayer to scan in order to identify
|
|
the video codec used.
|
|
This option is needed to play EVO or VDR files containing H.264 streams.
|
|
.
|
|
.TP
|
|
.B \-pvr <option1:option2:...> (PVR only)
|
|
This option tunes various encoding properties of the PVR capture module.
|
|
It has to be used with any hardware MPEG encoder based card supported by the
|
|
V4L2 driver.
|
|
The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
|
|
cards are known as PVR capture cards.
|
|
Be aware that only Linux 2.6.18 kernel
|
|
and above is able to handle MPEG stream through V4L2 layer.
|
|
For hardware capture of an MPEG stream and watching it with
|
|
MPlayer, use 'pvr://' as a movie URL.
|
|
.sp 1
|
|
Available options are:
|
|
.RSs
|
|
.IPs aspect=<0\-3>
|
|
Specify input aspect ratio:
|
|
.RSss
|
|
0: 1:1
|
|
.br
|
|
1: 4:3 (default)
|
|
.br
|
|
2: 16:9
|
|
.br
|
|
3: 2.21:1
|
|
.REss
|
|
.IPs arate=<32000\-48000>
|
|
Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
|
|
and 48000 Hz).
|
|
.IPs alayer=<1\-3>
|
|
Specify MPEG audio layer encoding (default: 2).
|
|
.IPs abitrate=<32\-448>
|
|
Specify audio encoding bitrate in kbps (default: 384).
|
|
.IPs amode=<value>
|
|
Specify audio encoding mode.
|
|
Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
|
|
.IPs vbitrate=<value>
|
|
Specify average video bitrate encoding in Mbps (default: 6).
|
|
.IPs vmode=<value>
|
|
Specify video encoding mode:
|
|
.RSss
|
|
vbr: Variable BitRate (default)
|
|
.br
|
|
cbr: Constant BitRate
|
|
.REss
|
|
.IPs vpeak=<value>
|
|
Specify peak video bitrate encoding in Mbps
|
|
(only useful for VBR encoding, default: 9.6).
|
|
.IPs fmt=<value>
|
|
Choose an MPEG format for encoding:
|
|
.RSss
|
|
ps: MPEG-2 Program Stream (default)
|
|
.br
|
|
ts: MPEG-2 Transport Stream
|
|
.br
|
|
mpeg1: MPEG-1 System Stream
|
|
.br
|
|
vcd: Video CD compatible stream
|
|
.br
|
|
svcd: Super Video CD compatible stream
|
|
.br
|
|
dvd: DVD compatible stream
|
|
.REss
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-radio <option1:option2:...> (radio only)
|
|
These options set various parameters of the radio capture module.
|
|
For listening to radio with MPlayer use 'radio://<frequency>'
|
|
(if channels option is not given) or 'radio://<channel_number>'
|
|
(if channels option is given) as a movie URL.
|
|
You can see allowed frequency range by running MPlayer with '\-v'.
|
|
To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
|
|
If the capture keyword is not given you can listen to radio
|
|
using the line-in cable only.
|
|
Using capture to listen is not recommended due to synchronization
|
|
problems, which makes this process uncomfortable.
|
|
.sp 1
|
|
Available options are:
|
|
.RSs
|
|
.IPs device=<value>
|
|
Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD).
|
|
.IPs driver=<value>
|
|
Radio driver to use (default: v4l2 if available, otherwise v4l).
|
|
Currently, v4l and v4l2 drivers are supported.
|
|
.IPs volume=<0..100>
|
|
sound volume for radio device (default 100)
|
|
.IPs "freq_min=<value> (*BSD BT848 only)"
|
|
minimum allowed frequency (default: 87.50)
|
|
.IPs "freq_max=<value> (*BSD BT848 only)"
|
|
maximum allowed frequency (default: 108.00)
|
|
.IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
|
|
Set channel list.
|
|
Use _ for spaces in names (or play with quoting ;-).
|
|
The channel names will then be written using OSD and the slave commands
|
|
radio_step_channel and radio_set_channel will be usable for
|
|
a remote control (see LIRC).
|
|
If given, number in movie URL will be treated as channel position in
|
|
channel list.
|
|
.br
|
|
.I EXAMPLE:
|
|
radio://1, radio://104.4, radio_set_channel 1
|
|
.IPs "adevice=<value> (radio capture only)"
|
|
Name of device to capture sound from.
|
|
Without such a name capture will be disabled,
|
|
even if the capture keyword appears in the URL.
|
|
For ALSA devices use it in the form hw=<card>.<device>.
|
|
If the device name contains a '=', the module will use
|
|
ALSA to capture, otherwise OSS.
|
|
.IPs "arate=<value> (radio capture only)"
|
|
Rate in samples per second (default: 44100).
|
|
.br
|
|
.I NOTE:
|
|
When using audio capture set also \-rawaudio rate=<value> option
|
|
with the same value as arate.
|
|
If you have problems with sound speed (runs too quickly), try to play
|
|
with different rate values (e.g.\& 48000,44100,32000,...).
|
|
.IPs "achannels=<value> (radio capture only)"
|
|
Number of audio channels to capture.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-rawaudio <option1:option2:...>
|
|
This option lets you play raw audio files.
|
|
You have to use \-demuxer rawaudio as well.
|
|
It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
|
|
For playing raw AC-3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
|
|
.sp 1
|
|
Available options are:
|
|
.sp 1
|
|
.PD 0
|
|
.RSs
|
|
.IPs channels=<value>
|
|
number of channels
|
|
.IPs rate=<value>
|
|
rate in samples per second
|
|
.IPs samplesize=<value>
|
|
sample size in bytes
|
|
.IPs bitrate=<value>
|
|
bitrate for rawaudio files
|
|
.IPs format=<value>
|
|
fourcc in hex
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-rawvideo <option1:option2:...>
|
|
This option lets you play raw video files.
|
|
You have to use \-demuxer rawvideo as well.
|
|
.sp 1
|
|
Available options are:
|
|
.sp 1
|
|
.PD 0
|
|
.RSs
|
|
.IPs fps=<value>
|
|
rate in frames per second (default: 25.0)
|
|
.IPs sqcif|qcif|cif|4cif|pal|ntsc
|
|
set standard image size
|
|
.IPs w=<value>
|
|
image width in pixels
|
|
.IPs h=<value>
|
|
image height in pixels
|
|
.IPs i420|yv12|yuy2|y8
|
|
set colorspace
|
|
.IPs format=<value>
|
|
colorspace (fourcc) in hex or string constant.
|
|
Use \-rawvideo format=help for a list of possible strings.
|
|
.IPs size=<value>
|
|
frame size in Bytes
|
|
.REss
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
|
|
Play the famous "foreman" sample video.
|
|
.IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
|
|
Play a raw YUV sample.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-referrer <string> (network only)
|
|
Specify a referrer path or URL for HTTP requests.
|
|
.
|
|
.TP
|
|
.B \-rtsp\-port
|
|
Used with 'rtsp://' URLs to force the client's port number.
|
|
This option may be useful if you are behind a router and want to forward
|
|
the RTSP stream from the server to a specific client.
|
|
.
|
|
.TP
|
|
.B \-rtsp\-destination
|
|
Used with 'rtsp://' URLs to force the destination IP address to be bound.
|
|
This option may be useful with some RTSP server which do not
|
|
send RTP packets to the right interface.
|
|
If the connection to the RTSP server fails, use \-v to see
|
|
which IP address MPlayer tries to bind to and try to force
|
|
it to one assigned to your computer instead.
|
|
.
|
|
.TP
|
|
.B \-rtsp\-stream\-over\-tcp (LIVE555 and NEMESI only)
|
|
Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
|
|
packets be streamed over TCP (using the same TCP connection as RTSP).
|
|
This option may be useful if you have a broken internet connection that does
|
|
not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
|
|
.
|
|
.TP
|
|
.B \-rtsp\-stream\-over\-http (LIVE555 only)
|
|
Used with 'http://' URLs to specify that the resulting incoming RTP and RTCP
|
|
packets be streamed over HTTP.
|
|
.
|
|
.TP
|
|
.B \-saveidx <filename>
|
|
Force index rebuilding and dump the index to <filename>.
|
|
Currently this only works with AVI files.
|
|
.br
|
|
.I NOTE:
|
|
This option is obsolete now that MPlayer has OpenDML support.
|
|
.
|
|
.TP
|
|
.B \-sb <byte position> (also see \-ss)
|
|
Seek to byte position.
|
|
Useful for playback from CD-ROM images or VOB files with junk at the beginning.
|
|
.
|
|
.TP
|
|
.B \-speed <0.01\-100>
|
|
Slow down or speed up playback by the factor given as parameter.
|
|
.
|
|
.TP
|
|
.B \-srate <Hz>
|
|
Select the output sample rate to be used
|
|
(of course sound cards have limits on this).
|
|
If the sample frequency selected is different from that
|
|
of the current media, the resample or lavcresample audio filter will be inserted
|
|
into the audio filter layer to compensate for the difference.
|
|
The type of resampling can be controlled by the \-af\-adv option.
|
|
The default is fast resampling that may cause distortion.
|
|
.
|
|
.TP
|
|
.B \-ss <time> (also see \-sb)
|
|
Seek to given time position.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-ss 56"
|
|
Seeks to 56 seconds.
|
|
.IPs "\-ss 01:10:00"
|
|
Seeks to 1 hour 10 min.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-tskeepbroken
|
|
Tells MPlayer not to discard TS packets reported as broken in the stream.
|
|
Sometimes needed to play corrupted MPEG-TS files.
|
|
.
|
|
.TP
|
|
.B \-tsprobe <byte position>
|
|
When playing an MPEG-TS stream, this option lets you specify how many
|
|
bytes in the stream you want MPlayer to search for the desired
|
|
audio and video IDs.
|
|
.
|
|
.TP
|
|
.B \-tsprog <1\-65534>
|
|
When playing an MPEG-TS stream, you can specify with this option which
|
|
program (if present) you want to play.
|
|
Can be used with \-vid and \-aid.
|
|
.
|
|
.TP
|
|
.B \-tv <option1:option2:...> (TV/\:PVR only)
|
|
This option tunes various properties of the TV capture module.
|
|
For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
|
|
or even 'tv://<channel_name> (see option channels for channel_name below)
|
|
as a movie URL.
|
|
You can also use 'tv:///<input_id>' to start watching a
|
|
movie from a composite or S-Video input (see option input for details).
|
|
.sp 1
|
|
Available options are:
|
|
.RSs
|
|
.IPs noaudio
|
|
no sound
|
|
.IPs "automute=<0\-255> (v4l and v4l2 only)"
|
|
If signal strength reported by device is less than this value,
|
|
audio and video will be muted.
|
|
In most cases automute=100 will be enough.
|
|
Default is 0 (automute disabled).
|
|
.IPs driver=<value>
|
|
See \-tv driver=help for a list of compiled-in TV input drivers.
|
|
available: dummy, v4l, v4l2, bsdbt848 (default: autodetect)
|
|
.IPs device=<value>
|
|
Specify TV device (default: /dev/\:video0).
|
|
.I NOTE:
|
|
For the bsdbt848 driver you can provide both bktr and tuner device
|
|
names separating them with a comma, tuner after
|
|
bktr (e.g.\& -tv device=/dev/bktr1,/dev/tuner1).
|
|
.IPs input=<value>
|
|
Specify input (default: 0 (TV), see console output for available inputs).
|
|
.IPs freq=<value>
|
|
Specify the frequency to set the tuner to (e.g.\& 511.250).
|
|
Not compatible with the channels parameter.
|
|
.IPs outfmt=<value>
|
|
Specify the output format of the tuner with a preset value supported by the
|
|
V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
|
|
arbitrary format given as hex value.
|
|
Try outfmt=help for a list of all available formats.
|
|
.IPs width=<value>
|
|
output window width
|
|
.IPs height=<value>
|
|
output window height
|
|
.IPs fps=<value>
|
|
framerate at which to capture video (frames per second)
|
|
.IPs buffersize=<value>
|
|
maximum size of the capture buffer in megabytes (default: dynamical)
|
|
.IPs norm=<value>
|
|
For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
|
|
For v4l2, see the console output for a list of all available norms,
|
|
also see the normid option below.
|
|
.IPs "normid=<value> (v4l2 only)"
|
|
Sets the TV norm to the given numeric ID.
|
|
The TV norm depends on the capture card.
|
|
See the console output for a list of available TV norms.
|
|
.IPs channel=<value>
|
|
Set tuner to <value> channel.
|
|
.IPs chanlist=<value>
|
|
available: argentina, australia, china-bcast, europe-east, europe-west, france,
|
|
ireland, italy, japan-bcast, japan-cable, newzealand, russia, southafrica,
|
|
us-bcast, us-cable, us-cable-hrc
|
|
.IPs channels=<chan>\-<name>[=<norm>],<chan>\-<name>[=<norm>],...
|
|
Set names for channels.
|
|
.I NOTE:
|
|
If <chan> is an integer greater than 1000, it will be treated as frequency (in kHz)
|
|
rather than channel name from frequency table.
|
|
.br
|
|
Use _ for spaces in names (or play with quoting ;-).
|
|
The channel names will then be written using OSD, and the slave commands
|
|
tv_step_channel, tv_set_channel and tv_last_channel will be usable for
|
|
a remote control (see LIRC).
|
|
Not compatible with the frequency parameter.
|
|
.br
|
|
.I NOTE:
|
|
The channel number will then be the position in the 'channels' list,
|
|
beginning with 1.
|
|
.br
|
|
.I EXAMPLE:
|
|
tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
|
|
.IPs [brightness|contrast|hue|saturation]=<\-100\-100>
|
|
Set the image equalizer on the card.
|
|
.IPs audiorate=<value>
|
|
Set input audio sample rate.
|
|
.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
|
|
.br
|
|
1: stereo
|
|
.br
|
|
2: language 1
|
|
.br
|
|
3: language 2
|
|
.REss
|
|
.IPs forcechan=<1\-2>
|
|
By default, the count of recorded audio channels is determined automatically
|
|
by querying the audio mode from the TV card.
|
|
This option allows forcing stereo/\:mono recording regardless of the amode
|
|
option and the values returned by v4l.
|
|
This can be used for troubleshooting when the TV card is unable to report the
|
|
current audio mode.
|
|
.IPs adevice=<value>
|
|
Set an audio device.
|
|
<value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
|
|
You must replace any ':' by a '.' in the hardware ID for ALSA.
|
|
.IPs audioid=<value>
|
|
Choose an audio output of the capture card, if it has more than one.
|
|
.IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
|
|
.IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
|
|
These options set parameters of the mixer on the video capture card.
|
|
They will have no effect, if your card does not have one.
|
|
For v4l2 50 maps to the default value of the
|
|
control, as reported by the driver.
|
|
.IPs "gain=<0\-100> (v4l2)"
|
|
Set gain control for video devices (usually webcams) to the desired
|
|
value and switch off automatic control.
|
|
A value of 0 enables automatic control.
|
|
If this option is omitted, gain control will not be modified.
|
|
.IPs immediatemode=<bool>
|
|
A value of 0 means capture and buffer audio and video together.
|
|
A value of 1 (default) means to do video capture only and let the
|
|
audio go through a loopback cable from the TV card to the sound card.
|
|
.IPs mjpeg
|
|
Use hardware MJPEG compression (if the card supports it).
|
|
When using this option, you do not need to specify the width and height
|
|
of the output window, because MPlayer will determine it automatically
|
|
from the decimation value (see below).
|
|
.IPs decimation=<1|2|4>
|
|
choose the size of the picture that will be compressed by hardware
|
|
MJPEG compression:
|
|
.RSss
|
|
1: full size
|
|
704x576 PAL
|
|
704x480 NTSC
|
|
.br
|
|
2: medium size
|
|
352x288 PAL
|
|
352x240 NTSC
|
|
.br
|
|
4: small size
|
|
176x144 PAL
|
|
176x120 NTSC
|
|
.REss
|
|
.IPs quality=<0\-100>
|
|
Choose the quality of the JPEG compression
|
|
(< 60 recommended for full size).
|
|
.IPs tdevice=<value>
|
|
Specify TV teletext device (example: /dev/\:vbi0) (default: none).
|
|
.IPs tformat=<format>
|
|
Specify TV teletext display format (default: 0):
|
|
.RSss
|
|
0: opaque
|
|
.br
|
|
1: transparent
|
|
.br
|
|
2: opaque with inverted colors
|
|
.br
|
|
3: transparent with inverted colors
|
|
.REss
|
|
.IPs tpage=<100\-899>
|
|
Specify initial TV teletext page number (default: 100).
|
|
.IPs tlang=<\-1\-127>
|
|
Specify default teletext language code (default: 0), which will be used
|
|
as primary language until a type 28 packet is received.
|
|
Useful when the teletext system uses a non-latin character set, but language
|
|
codes are not transmitted via teletext type 28 packets for some reason.
|
|
To see a list of supported language codes set this option to \-1.
|
|
.IPs "hidden_video_renderer (dshow only)"
|
|
Terminate stream with video renderer instead of Null renderer (default: off).
|
|
Will help if video freezes but audio does not.
|
|
.I NOTE:
|
|
May not work with \-vo directx and \-vf crop combination.
|
|
.IPs "hidden_vp_renderer (dshow only)"
|
|
Terminate VideoPort pin stream with video renderer
|
|
instead of removing it from the graph (default: off).
|
|
Useful if your card has a VideoPort pin and video is choppy.
|
|
.I NOTE:
|
|
May not work with \-vo directx and \-vf crop combination.
|
|
.IPs "system_clock (dshow only)"
|
|
Use the system clock as sync source instead of the default graph clock
|
|
(usually the clock from one of the live sources in graph).
|
|
.IPs "normalize_audio_chunks (dshow only)"
|
|
Create audio chunks with a time length equal to
|
|
video frame time length (default: off).
|
|
Some audio cards create audio chunks about 0.5s in size, resulting in
|
|
choppy video when using immediatemode=0.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-tvscan <option1:option2:...> (TV only)
|
|
Tune the TV channel scanner.
|
|
MPlayer will also print value for "-tv channels=" option,
|
|
including existing and just found channels.
|
|
.sp 1
|
|
Available suboptions are:
|
|
.RSs
|
|
.IPs autostart
|
|
Begin channel scanning immediately after startup (default: disabled).
|
|
.IPs period=<0.1\-2.0>
|
|
Specify delay in seconds before switching to next channel (default: 0.5).
|
|
Lower values will cause faster scanning, but can detect
|
|
inactive TV channels as active.
|
|
.IPs threshold=<1\-100>
|
|
Threshold value for the signal strength (in percent), as reported
|
|
by the device (default: 50).
|
|
A signal strength higher than this value will indicate that the
|
|
currently scanning channel is active.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-user <username> (also see \-passwd) (network only)
|
|
Specify username for HTTP authentication.
|
|
.
|
|
.TP
|
|
.B \-user\-agent <string>
|
|
Use <string> as user agent for HTTP streaming.
|
|
.
|
|
.TP
|
|
.B \-vid <ID>
|
|
Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
|
|
When playing an MPEG-TS stream, MPlayer will use the first program (if present)
|
|
with the chosen video stream.
|
|
.
|
|
.TP
|
|
.B \-vivo <suboption> (DEBUG CODE)
|
|
Force audio parameters for the VIVO demuxer (for debugging purposes).
|
|
FIXME: Document this.
|
|
.
|
|
.
|
|
.
|
|
.SH "OSD/SUBTITLE OPTIONS"
|
|
.I NOTE:
|
|
Also see \-vf expand.
|
|
.
|
|
.TP
|
|
.B \-ass, \-noass (FreeType only)
|
|
Use libass to render all text subtitles.
|
|
This enables support for the native styling of SSA/ASS subtitles,
|
|
and also support for some styling features in other subtitle formats by
|
|
conversion to ASS markup.
|
|
Enabled by default if the player was compiled with libass support.
|
|
.br
|
|
.I NOTE:
|
|
Some of the other subtitle options were written for the old non-libass
|
|
subtitle rendering system and may not work the same way or at all with
|
|
libass rendering enabled.
|
|
.
|
|
.TP
|
|
.B \-ass\-border\-color <value>
|
|
Sets the border (outline) color for text subtitles.
|
|
The color format is RRGGBBAA.
|
|
.
|
|
.TP
|
|
.B \-ass\-bottom\-margin <value>
|
|
Adds a black band at the bottom of the frame.
|
|
The SSA/ASS renderer can place subtitles there (with \-ass\-use\-margins).
|
|
.
|
|
.TP
|
|
.B \-ass\-color <value>
|
|
Sets the color for text subtitles.
|
|
The color format is RRGGBBAA.
|
|
.
|
|
.TP
|
|
.B \-ass\-font\-scale <value>
|
|
Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
|
|
.
|
|
.TP
|
|
.B \-ass\-force\-style <[Style.]Param=Value[,...]>
|
|
Override some style or script info parameters.
|
|
.sp
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
\-ass\-force\-style FontName=Arial,Default.Bold=1
|
|
.br
|
|
\-ass\-force\-style PlayResY=768
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-ass\-hinting <type>
|
|
Set hinting type.
|
|
<type> can be:
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
no hinting
|
|
.IPs 1
|
|
FreeType autohinter, light mode
|
|
.IPs 2
|
|
FreeType autohinter, normal mode
|
|
.IPs 3
|
|
font native hinter
|
|
.IPs "0-3 + 4"
|
|
The same, but hinting will only be performed if the OSD is rendered at
|
|
screen resolution and will therefore not be scaled.
|
|
.RE
|
|
.RSs
|
|
The default value is 5 (use light hinter for unscaled OSD and no hinting otherwise).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-ass\-line\-spacing <value>
|
|
Set line spacing value for SSA/ASS renderer.
|
|
.
|
|
.TP
|
|
.B \-ass\-styles <filename>
|
|
Load all SSA/ASS styles found in the specified file and use them for
|
|
rendering text subtitles.
|
|
The syntax of the file is exactly like the
|
|
[V4 Styles] / [V4+ Styles] section of SSA/ASS.
|
|
.
|
|
.TP
|
|
.B \-ass\-top\-margin <value>
|
|
Adds a black band at the top of the frame.
|
|
The SSA/ASS renderer can place toptitles there (with \-ass\-use\-margins).
|
|
.
|
|
.TP
|
|
.B \-ass\-use\-margins
|
|
Enables placing toptitles and subtitles in black borders when they
|
|
are available.
|
|
.
|
|
.TP
|
|
.B \-ass\-vsfilter\-aspect\-compat
|
|
Stretch SSA/ASS subtitles when playing anamorphic videos for compatibility
|
|
with traditional VSFilter behavior.
|
|
This switch has no effect when the video is stored with square pixels.
|
|
.sp 1
|
|
The renderer historically most commonly used for the SSA/ASS subtitle formats,
|
|
VSFilter, had questionable behavior that resulted in subtitles being
|
|
stretched too if the video was stored in anamorphic format that required
|
|
scaling for display.
|
|
This behavior is usually undesirable and newer VSFilter versions may
|
|
behave differently.
|
|
However, many existing scripts compensate for the stretching by modifying
|
|
things in the opposite direction.
|
|
Thus if such scripts are displayed "correctly" they will not appear as intended.
|
|
This switch enables emulation of the old VSFilter behavior (undesirable but
|
|
expected by many existing scripts).
|
|
Enabled by default.
|
|
.
|
|
.TP
|
|
.B \-dumpjacosub
|
|
Convert the given subtitle (specified with the \-sub option) to the time-based
|
|
JACOsub subtitle format.
|
|
Creates a dumpsub.js file in the current directory.
|
|
.
|
|
.TP
|
|
.B \-dumpmicrodvdsub
|
|
Convert the given subtitle (specified with the \-sub option) to the
|
|
MicroDVD subtitle format.
|
|
Creates a dumpsub.sub file in the current directory.
|
|
.
|
|
.TP
|
|
.B \-dumpmpsub
|
|
Convert the given subtitle (specified with the \-sub option) to MPlayer's
|
|
subtitle format, MPsub.
|
|
Creates a dump.mpsub file in the current directory.
|
|
.
|
|
.TP
|
|
.B \-dumpsami
|
|
Convert the given subtitle (specified with the \-sub option) to the time-based
|
|
SAMI subtitle format.
|
|
Creates a dumpsub.smi file in the current directory.
|
|
.
|
|
.TP
|
|
.B \-dumpsrtsub
|
|
Convert the given subtitle (specified with the \-sub option) to the time-based
|
|
SubViewer (SRT) subtitle format.
|
|
Creates a dumpsub.srt file in the current directory.
|
|
.br
|
|
.I NOTE:
|
|
Some broken hardware players choke on SRT subtitle files with Unix
|
|
line endings.
|
|
If you are unlucky enough to have such a box, pass your subtitle
|
|
files through unix2dos or a similar program to replace Unix line
|
|
endings with DOS/Windows line endings.
|
|
.
|
|
.TP
|
|
.B \-dumpsub (BETA CODE)
|
|
Dumps the subtitle substream from VOB streams.
|
|
Also see the \-dump*sub options.
|
|
.
|
|
.TP
|
|
.B \-noembeddedfonts
|
|
Disables use of fonts embedded in Matroska containers and ASS scripts (default: enabled).
|
|
These fonts can be used for SSA/ASS subtitle
|
|
rendering (\-ass option).
|
|
.
|
|
.TP
|
|
.B \-ffactor <number>
|
|
Resample the font alphamap.
|
|
Can be:
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
plain white fonts
|
|
.IPs 0.75
|
|
very narrow black outline (default)
|
|
.IPs 1
|
|
narrow black outline
|
|
.IPs 10
|
|
bold black outline
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-flip\-hebrew (FriBiDi only)
|
|
Turns on flipping subtitles using FriBiDi.
|
|
.
|
|
.TP
|
|
.B \-noflip\-hebrew\-commas
|
|
Change FriBiDi's assumptions about the placements of commas in subtitles.
|
|
Use this if commas in subtitles are shown at the start of a sentence
|
|
instead of at the end.
|
|
.
|
|
.TP
|
|
.B \-font <path to font.desc file, path to font (FreeType), font pattern (Fontconfig)>
|
|
Search for the OSD/\:SUB fonts in an alternative directory (default for normal
|
|
fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
|
|
~/.mplayer/\:subfont.ttf).
|
|
.br
|
|
.I NOTE:
|
|
With FreeType, this option determines the path to the text font file.
|
|
With Fontconfig, this option determines the Fontconfig font pattern.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
\-font ~/\:.mplayer/\:arial-14/\:font.desc
|
|
.br
|
|
\-font ~/\:.mplayer/\:arialuni.ttf
|
|
.br
|
|
\-font 'Bitstream Vera Sans'
|
|
.br
|
|
\-font 'Bitstream Vera Sans:style=Bold'
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-fontconfig, \-nofontconfig (fontconfig only)
|
|
Enables the use of fontconfig managed fonts. Enabled by default.
|
|
.
|
|
.TP
|
|
.B \-forcedsubsonly
|
|
Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
|
|
\-slang.
|
|
.
|
|
.TP
|
|
.B \-fribidi\-charset <charset name> (FriBiDi only)
|
|
Specifies the character set that will be passed to FriBiDi when
|
|
decoding non-UTF-8 subtitles (default: ISO8859-8).
|
|
.
|
|
.TP
|
|
.B \-ifo <VOBsub IFO file>
|
|
Indicate the file that will be used to load palette and frame size for VOBsub
|
|
subtitles.
|
|
.
|
|
.TP
|
|
.B \-noautosub
|
|
Turns off automatic subtitle file loading.
|
|
.
|
|
.TP
|
|
.B \-osd\-duration <time>
|
|
Set the duration of the OSD messages in ms (default: 1000).
|
|
.
|
|
.TP
|
|
.B \-osd\-fractions <0\-2>
|
|
Set how fractions of seconds of the current timestamp are printed on the OSD:
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
Do not display fractions (default).
|
|
.IPs 1
|
|
Show the first two decimals.
|
|
.IPs 2
|
|
Show approximate frame count within current second.
|
|
This frame count is not accurate but only an approximation.
|
|
For variable fps, the approximation is known to be far off the correct frame
|
|
count.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-osdlevel <0\-3>
|
|
Specifies which mode the OSD should start in.
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
subtitles only
|
|
.IPs 1
|
|
volume + seek (default)
|
|
.IPs 2
|
|
volume + seek + timer + percentage
|
|
.IPs 3
|
|
volume + seek + timer + percentage + total time
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-overlapsub
|
|
Allows the next subtitle to be displayed while the current one is
|
|
still visible (default is to enable the support only for specific
|
|
formats).
|
|
.
|
|
.TP
|
|
.B \-sid <ID> (also see \-slang, \-vobsubid)
|
|
Display the subtitle stream specified by <ID> (0\-31).
|
|
MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
|
|
If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
|
|
.
|
|
.TP
|
|
.B \-nosub
|
|
Disables any otherwise auto-selected internal subtitles (as e.g.\& the Matroska/mkv
|
|
demuxer supports).
|
|
Use \-noautosub to disable the loading of external subtitle files.
|
|
.
|
|
.TP
|
|
.B \-slang <language code[,language code,...]> (also see \-sid)
|
|
Specify a priority list of subtitle languages to use.
|
|
Different container formats employ different language codes.
|
|
DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
|
|
three letter language codes while OGM uses a free-form identifier.
|
|
MPlayer prints the available languages when run in verbose (\-v) mode.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "mplayer dvd://1 \-slang hu,en"
|
|
Chooses the Hungarian subtitle track on a DVD and falls back on English if
|
|
Hungarian is not available.
|
|
.IPs "mplayer \-slang jpn example.mkv"
|
|
Plays a Matroska file with Japanese subtitles.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-spuaa <mode>
|
|
Antialiasing/\:scaling mode for DVD/\:VOBsub.
|
|
A value of 16 may be added to <mode> in order to force scaling even
|
|
when original and scaled frame size already match.
|
|
This can be employed to e.g.\& smooth subtitles with gaussian blur.
|
|
Available modes are:
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
none (fastest, very ugly)
|
|
.IPs 1
|
|
approximate (broken?)
|
|
.IPs 2
|
|
full (slow)
|
|
.IPs 3
|
|
bilinear (default, fast and not too bad)
|
|
.IPs 4
|
|
uses swscaler gaussian blur (looks very good)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-spualign <\-1\-2>
|
|
Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-1"
|
|
original position
|
|
.IPs " 0"
|
|
Align at top (original behavior, default).
|
|
.IPs " 1"
|
|
Align at center.
|
|
.IPs " 2"
|
|
Align at bottom.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-spugauss <0.0\-3.0>
|
|
Variance parameter of gaussian used by \-spuaa 4.
|
|
Higher means more blur (default: 1.0).
|
|
.
|
|
.TP
|
|
.B \-sub <subtitlefile1,subtitlefile2,...>
|
|
Use/\:display these subtitle files.
|
|
Only one file can be displayed at the same time.
|
|
.
|
|
.TP
|
|
.B \-sub\-bg\-alpha <0\-255>
|
|
Specify the alpha channel value for subtitles and OSD backgrounds.
|
|
Big values mean more transparency.
|
|
0 means completely transparent.
|
|
.
|
|
.TP
|
|
.B \-sub\-bg\-color <0\-255>
|
|
Specify the color value for subtitles and OSD backgrounds.
|
|
Currently subtitles are grayscale so this value is equivalent to the
|
|
intensity of the color.
|
|
255 means white and 0 black.
|
|
.
|
|
.TP
|
|
.B \-sub\-demuxer <[+]name> (\-subfile only) (BETA CODE)
|
|
Force subtitle demuxer type for \-subfile.
|
|
Use a '+' before the name to force it, this will skip some checks!
|
|
Give the demuxer name as printed by \-sub\-demuxer help.
|
|
.
|
|
.TP
|
|
.B \-sub\-fuzziness <mode>
|
|
Adjust matching fuzziness when searching for subtitles:
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
exact match
|
|
.IPs 1
|
|
Load all subs containing movie name.
|
|
.IPs 2
|
|
Load all subs in the current and \-sub\-paths directories.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-sub\-no\-text\-pp
|
|
Disables any kind of text post processing done after loading the subtitles.
|
|
Used for debug purposes.
|
|
.
|
|
.TP
|
|
.B \-subalign <0\-2>
|
|
Specify which edge of the subtitles should be aligned at the height
|
|
given by \-subpos.
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
Align subtitle top edge (original behavior).
|
|
.IPs 1
|
|
Align subtitle center.
|
|
.IPs 2
|
|
Align subtitle bottom edge (default).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "\-subcc <1\-4>\ "
|
|
Display DVD Closed Caption (CC) subtitles from the specified channel.
|
|
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.
|
|
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 the subtitle codepage.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
\-subcp latin2
|
|
.br
|
|
\-subcp cp1250
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-subcp enca:<language>:<fallback codepage> (ENCA only)
|
|
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 autodetection fails.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-subcp enca:cs:latin2"
|
|
Guess the encoding, assuming the subtitles are Czech, fall back on
|
|
latin 2, if the detection fails.
|
|
.IPs "\-subcp enca:pl:cp1250"
|
|
Guess the encoding for Polish, fall back on cp1250.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-sub\-paths <path1:path2:...>
|
|
Specify extra directories where to search for subtitles matching the video.
|
|
Multiple directories can be separated by ":" (";" on Windows).
|
|
Paths can be relative or absolute.
|
|
Relative paths are interpreted relative to video file directory.
|
|
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
Assuming that /path/\:to/\:movie/\:movie.avi is played and \-sub\-paths
|
|
sub:subtitles:/tmp/subs is specified, MPlayer searches for subtitle files in
|
|
these directories:
|
|
.RSs
|
|
/path/\:to/\:movie/
|
|
.br
|
|
/path/\:to/\:movie/\:sub/
|
|
.br
|
|
/path/\:to/\:movie/\:subtitles/
|
|
.br
|
|
/tmp/\:subs/
|
|
.br
|
|
~/.mplayer/\:sub/
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-subdelay <sec>
|
|
Delays subtitles by <sec> seconds.
|
|
Can be negative.
|
|
.
|
|
.TP
|
|
.B \-subfile <filename> (BETA CODE)
|
|
Currently useless.
|
|
Same as \-audiofile, but for subtitle streams (OggDS?).
|
|
.
|
|
.TP
|
|
.B \-subfont <path to font (FreeType), font pattern (Fontconfig)> (FreeType only)
|
|
Sets the subtitle font (see \-font).
|
|
If no \-subfont is given, \-font is used.
|
|
.
|
|
.TP
|
|
.B \-subfont\-autoscale <0\-3> (FreeType only)
|
|
Sets the autoscale mode.
|
|
.br
|
|
.I NOTE:
|
|
0 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
|
|
proportional to movie height
|
|
.IPs 2
|
|
proportional to movie width
|
|
.IPs 3
|
|
proportional to movie diagonal (default)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-subfont\-blur <0\-8> (FreeType only)
|
|
Sets the font blur radius (default: 2).
|
|
.
|
|
.TP
|
|
.B \-subfont\-encoding <value> (FreeType only)
|
|
Sets the font encoding.
|
|
When set to 'unicode', all the glyphs from the font file will be rendered and
|
|
unicode will be used (default: unicode).
|
|
.
|
|
.TP
|
|
.B \-subfont\-osd\-scale <0\-100> (FreeType only)
|
|
Sets the autoscale coefficient of the OSD elements (default: 6).
|
|
.
|
|
.TP
|
|
.B \-subfont\-outline <0\-8> (FreeType only)
|
|
Sets the font outline thickness (default: 2).
|
|
.
|
|
.TP
|
|
.B \-subfont\-text\-scale <0\-100> (FreeType only)
|
|
Sets the subtitle text autoscale coefficient as percentage of the
|
|
screen size (default: 5).
|
|
.
|
|
.TP
|
|
.B \-subfps <rate>
|
|
Specify the framerate of the subtitle file (default: movie fps).
|
|
.br
|
|
.I NOTE:
|
|
<rate> > movie fps speeds the subtitles up for frame-based subtitle files and
|
|
slows them down for time-based ones.
|
|
.
|
|
.TP
|
|
.B \-subpos <0\-100> (useful with \-vf expand)
|
|
Specify the position of subtitles on the screen.
|
|
The value is the vertical position of the subtitle in % of the screen height.
|
|
.
|
|
.TP
|
|
.B \-subwidth <10\-100>
|
|
Specify the maximum width of subtitles on the screen.
|
|
Useful for TV-out.
|
|
The value is the width of the subtitle in % of the screen width.
|
|
.
|
|
.TP
|
|
.B \-noterm\-osd
|
|
Disable the display of OSD messages on the console when no video output is
|
|
available.
|
|
.
|
|
.TP
|
|
.B \-term\-osd\-esc <escape sequence>
|
|
Specify the escape sequence to use before writing an OSD message on the
|
|
console.
|
|
The escape sequence should move the pointer to the beginning of the line
|
|
used for the OSD and clear it (default: ^[[A\\r^[[K).
|
|
.
|
|
.TP
|
|
.B \-unicode
|
|
Tells MPlayer to handle the subtitle file as unicode.
|
|
.
|
|
.TP
|
|
.B \-unrarexec <path to unrar executable> (not supported on MingW)
|
|
Specify the path to the unrar executable so MPlayer can use it to access
|
|
rar-compressed VOBsub files (default: not set, so the feature is off).
|
|
The path must include the executable's filename, i.e.\& /usr/local/bin/unrar.
|
|
.
|
|
.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.
|
|
Has to be the full pathname without extension, i.e.\& without
|
|
the '.idx', '.ifo' or '.sub'.
|
|
.
|
|
.TP
|
|
.B \-vobsubid <0\-31>
|
|
Specify the VOBsub subtitle ID.
|
|
.
|
|
.
|
|
.
|
|
.SH "AUDIO OUTPUT OPTIONS"
|
|
.
|
|
.TP
|
|
.B \-abs <value> (\-ao oss only) (OBSOLETE)
|
|
Override audio driver/\:card buffer size detection.
|
|
.
|
|
.TP
|
|
.B \-format <format> (also see the format audio filter)
|
|
Select the sample format used for output from the audio filter
|
|
layer to the sound card.
|
|
The values that <format> can adopt are listed below in the
|
|
description of the format audio filter.
|
|
.
|
|
.TP
|
|
.B \-gapless\-audio
|
|
Try to play consecutive audio files with no silence or disruption
|
|
at the point of file change.
|
|
This feature is implemented in a simple manner and relies on audio output
|
|
device buffering to continue playback while moving from one file to another.
|
|
If playback of the new file starts slowly, for example because it's played from
|
|
a remote network location or because you have specified cache settings that
|
|
require time for the initial cache fill, then the buffered audio may run out
|
|
before playback of the new file can start.
|
|
.
|
|
.TP
|
|
.B \-mixer <device>
|
|
Use a mixer device different from the default /dev/\:mixer.
|
|
For ALSA this is the mixer name.
|
|
.
|
|
.TP
|
|
.B \-mixer\-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
|
|
This option will tell MPlayer to use a different channel for controlling
|
|
volume than the default PCM.
|
|
Options for OSS include
|
|
.B vol, pcm, line.
|
|
For a complete list of options look for SOUND_DEVICE_NAMES in
|
|
/usr/\:include/\:linux/\:soundcard.h.
|
|
For ALSA you can use the names e.g.\& alsamixer displays, like
|
|
.B Master, Line, PCM.
|
|
.br
|
|
.I NOTE:
|
|
ALSA mixer channel names followed by a number must be specified in the
|
|
<name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
|
|
be converted to
|
|
.BR PCM,1 .
|
|
.
|
|
.TP
|
|
.B \-softvol
|
|
Force the use of the software mixer, instead of using the sound card
|
|
mixer.
|
|
.
|
|
.TP
|
|
.B \-softvol\-max <10.0\-10000.0>
|
|
Set the maximum amplification level in percent (default: 110).
|
|
A value of 200 will allow you to adjust the volume up to a maximum of
|
|
double the current level.
|
|
With values below 100 the initial volume (which is 100%) will be above
|
|
the maximum, which e.g.\& the OSD cannot display correctly.
|
|
.
|
|
.TP
|
|
.B \-volstep <0\-100>
|
|
Set the step size of mixer volume changes in percent of the whole range
|
|
(default: 3).
|
|
.
|
|
.TP
|
|
.B \-volume <-1\-100> (also see \-af volume)
|
|
Set the startup volume in the mixer, either hardware or software (if
|
|
used with \-softvol).
|
|
A value of -1 (the default) will not change the volume.
|
|
.
|
|
.
|
|
.
|
|
.SH "AUDIO OUTPUT DRIVERS"
|
|
Audio output drivers are interfaces to different audio output facilities.
|
|
The syntax is:
|
|
.
|
|
.TP
|
|
.B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
|
|
Specify a priority list of audio output drivers to be used.
|
|
.PP
|
|
If the list has a trailing ',' MPlayer will fall back on drivers not
|
|
contained in the list.
|
|
Suboptions are optional and can mostly be omitted.
|
|
.br
|
|
.I NOTE:
|
|
See \-ao help for a list of compiled-in audio output 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:noblock:device=hw=0.3"
|
|
Sets noblock-mode and the device-name as first card, fourth device.
|
|
.RE
|
|
.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.
|
|
.IPs device=<device>
|
|
Sets the device name.
|
|
Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
|
|
For hwac3 output via S/PDIF, use an "iec958" or "spdif" device, unless
|
|
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).
|
|
.IPs <mixer-device>
|
|
Sets the audio mixer device (default: /dev/\:mixer).
|
|
.IPs <mixer-channel>
|
|
Sets the audio mixer channel (default: pcm).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B sdl (SDL only)
|
|
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).
|
|
.IPs name=<client name>
|
|
Client name that is passed to JACK (default: MPlayer [<PID>]).
|
|
Useful if you want to have certain connections established automatically.
|
|
.IPs (no)estimate
|
|
Estimate the audio delay, supposed to make the video playback smoother
|
|
(default: enabled).
|
|
.IPs (no)autostart
|
|
Automatically start jackd if necessary (default: disabled).
|
|
Note that this seems unreliable and will spam stdout with server messages.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "nas\ \ \ \ "
|
|
audio output through NAS
|
|
.
|
|
.TP
|
|
.B coreaudio (Mac OS X only)
|
|
native Mac OS X audio output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs device_id=<id>
|
|
ID of output device to use (0 = default device)
|
|
.IPs help
|
|
List all available output devices with their IDs.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "openal\ "
|
|
Experimental OpenAL audio output driver
|
|
.
|
|
.TP
|
|
.B "pulse\ \ "
|
|
PulseAudio audio output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs "[<host>][:<output sink>]"
|
|
Specify the host and optionally output sink to use.
|
|
An empty <host> string uses a local connection, "localhost"
|
|
uses network transfer (most likely not what you want).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B sgi (SGI only)
|
|
native SGI audio output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs "<output device name>"
|
|
Explicitly choose the output device/\:interface to use
|
|
(default: system-wide default).
|
|
For example, 'Analog Out' or 'Digital Out'.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B sun (Sun only)
|
|
native Sun audio output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the audio device to use (default: /dev/\:audio).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B win32 (Windows only)
|
|
native Windows waveout audio output driver
|
|
.
|
|
.TP
|
|
.B dsound (Windows only)
|
|
DirectX DirectSound audio output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs device=<devicenum>
|
|
Sets the device number to use.
|
|
Playing a file with \-v will show a list of available devices.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B kai (OS/2 only)
|
|
OS/2 KAI audio output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs uniaud
|
|
Force UNIAUD mode.
|
|
.IPs dart
|
|
Force DART mode.
|
|
.IPs (no)share
|
|
Open audio in shareable or exclusive mode.
|
|
.IPs bufsize=<size>
|
|
Set buffer size to <size> in samples (default: 2048).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B dart (OS/2 only)
|
|
OS/2 DART audio output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs (no)share
|
|
Open DART in shareable or exclusive mode.
|
|
.IPs bufsize=<size>
|
|
Set buffer size to <size> in samples (default: 2048).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B ivtv (IVTV only)
|
|
IVTV specific MPEG audio output driver.
|
|
Works with \-ac hwmpa only.
|
|
.
|
|
.TP
|
|
.B v4l2 (requires Linux 2.6.22+ kernel)
|
|
Audio output driver for V4L2 cards with hardware MPEG decoder.
|
|
.
|
|
.TP
|
|
.B mpegpes (DVB only)
|
|
Audio output driver for DVB cards that writes the output to an MPEG-PES
|
|
file if no DVB card is installed.
|
|
.PD 0
|
|
.RSs
|
|
.IPs card=<1\-4>
|
|
DVB card to use if more than one card is present.
|
|
If not specified MPlayer will search the first usable card.
|
|
.IPs file=<filename>
|
|
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.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "rsound\ \ \ \ "
|
|
audio output to an RSound daemon
|
|
.PD 0
|
|
.RSs
|
|
.IPs host=<name/path>
|
|
Set the address of the server (default: localhost).
|
|
Can be either a network hostname for TCP connections or a Unix domain
|
|
socket path starting with '/'.
|
|
.IPs port=<number>
|
|
Set the TCP port used for connecting to the server (default: 12345).
|
|
Not used if connecting to a Unix domain socket.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "plugin\ \ "
|
|
plugin audio output driver
|
|
.
|
|
.
|
|
.
|
|
.SH "VIDEO OUTPUT OPTIONS"
|
|
.
|
|
.TP
|
|
.B \-adapter <value>
|
|
Set the graphics card that will receive the image.
|
|
You can get a list of available cards when you run this option with \-v.
|
|
Currently only works with the directx video output driver.
|
|
.
|
|
.TP
|
|
.B \-bpp <depth>
|
|
Override the autodetected color depth.
|
|
Only supported by the fbdev, dga, svga, vesa video output drivers.
|
|
.
|
|
.TP
|
|
.B \-border
|
|
Play movie with window border and decorations.
|
|
Since this is on by default, use \-noborder to disable the standard window
|
|
decorations.
|
|
.
|
|
.TP
|
|
.B \-brightness <\-100\-100>
|
|
Adjust the brightness of the video signal (default: 0).
|
|
Not supported by all video output drivers.
|
|
.
|
|
.TP
|
|
.B \-contrast <\-100\-100>
|
|
Adjust the contrast of the video signal (default: 0).
|
|
Not supported by all video output drivers.
|
|
.
|
|
.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
|
|
.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!
|
|
.
|
|
.TP
|
|
.B \-fbmode <modename> (\-vo fbdev only)
|
|
Change video mode to the one that is labeled as <modename> in
|
|
/etc/\:fb.modes.
|
|
.br
|
|
.I NOTE:
|
|
VESA framebuffer does not support mode changing.
|
|
.
|
|
.TP
|
|
.B \-fbmodeconfig <filename> (\-vo fbdev only)
|
|
Override framebuffer mode configuration file (default: /etc/\:fb.modes).
|
|
.
|
|
.TP
|
|
.B \-force\-window\-position
|
|
Forcefully move MPlayer's video output window to default location whenever
|
|
there is a change in video parameters, video stream or file.
|
|
This used to be the default behavior.
|
|
Currently only affects X11 VOs.
|
|
.
|
|
.TP
|
|
.B \-fs (also see \-zoom)
|
|
Fullscreen playback (centers movie, and paints black bands around it).
|
|
Not supported by all video output drivers.
|
|
.
|
|
.TP
|
|
.B \-fsmode\-dontuse <0\-31> (OBSOLETE, use the \-fs option)
|
|
Try this option if you still experience fullscreen problems.
|
|
.
|
|
.TP
|
|
.B \-fstype <type1,type2,...> (X11 only)
|
|
Specify a priority list of fullscreen modes to be used.
|
|
You can negate the modes by prefixing them with '\-'.
|
|
If you experience problems like the fullscreen window being covered
|
|
by other windows try using a different order.
|
|
.br
|
|
.I NOTE:
|
|
See \-fstype help for a full list of available modes.
|
|
.sp 1
|
|
The available types are:
|
|
.sp 1
|
|
.PD 0
|
|
.RSs
|
|
.IPs above
|
|
Use the _NETWM_STATE_ABOVE hint if available.
|
|
.IPs below
|
|
Use the _NETWM_STATE_BELOW hint if available.
|
|
.IPs fullscreen
|
|
Use the _NETWM_STATE_FULLSCREEN hint if available.
|
|
.IPs layer
|
|
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\ "
|
|
Clear the list of modes; you can add modes to enable afterward.
|
|
.IPs stays_on_top
|
|
Use _NETWM_STATE_STAYS_ON_TOP hint if available.
|
|
.REss
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs layer,stays_on_top,above,fullscreen
|
|
Default order, will be used as a fallback if incorrect or
|
|
unsupported modes are specified.
|
|
.IPs \-fullscreen
|
|
Fixes fullscreen switching on OpenBox 1.x.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-gamma <\-100\-100>
|
|
Adjust the gamma of the video signal (default: 0).
|
|
Not supported by all video output drivers.
|
|
.
|
|
.TP
|
|
.B \-geometry x[%][:y[%]] or [WxH][+-x+-y]
|
|
Adjust where the output is on the screen initially.
|
|
The x and y specifications are in pixels measured from the top-left of the
|
|
screen to the top-left of the image being displayed, however if a percentage
|
|
sign is given after the argument it turns the value into a percentage of the
|
|
screen size in that direction.
|
|
It also supports the standard X11 \-geometry option format, in which e.g.
|
|
+10-50 means "place 10 pixels from the left border and 50 pixels from the lower
|
|
border" and "--20+-10" means "place 20 pixels beyond the right and 10 pixels
|
|
beyond the top border".
|
|
If an external window is specified using the \-wid option, then the x and
|
|
y coordinates are relative to the top-left corner of the window rather
|
|
than the screen.
|
|
The coordinates are relative to the screen given with \-xineramascreen for
|
|
the video output drivers that fully support \-xineramascreen (direct3d, gl, gl2,
|
|
vdpau, x11, xv, corevideo).
|
|
.br
|
|
.I NOTE:
|
|
May not be supported by some of the older VO drivers.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.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
|
|
.
|
|
.TP
|
|
.B \-hue <\-100\-100>
|
|
Adjust the hue of the video signal (default: 0).
|
|
You can get a colored negative of the image with this option.
|
|
Not supported by all video output drivers.
|
|
.
|
|
.TP
|
|
.B \-monitor\-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
|
|
Specify the dotclock or pixelclock range of the monitor.
|
|
.
|
|
.TP
|
|
.B \-monitor\-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
|
|
Specify the horizontal frequency range of the monitor.
|
|
.
|
|
.TP
|
|
.B \-monitor\-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
|
|
Specify the vertical frequency range of the monitor.
|
|
.
|
|
.TP
|
|
.B \-monitoraspect <ratio> (also see \-aspect)
|
|
Set the aspect ratio of your monitor or TV screen.
|
|
A value of 0 disables a previous setting (e.g.\& in the config file).
|
|
Overrides the \-monitorpixelaspect setting if enabled.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
\-monitoraspect 4:3 or 1.3333
|
|
.br
|
|
\-monitoraspect 16:9 or 1.7777
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-monitorpixelaspect <ratio> (also see \-aspect)
|
|
Set the aspect of a single pixel of your monitor or TV screen (default: 1).
|
|
A value of 1 means square pixels
|
|
(correct for (almost?) all LCDs).
|
|
.
|
|
.TP
|
|
.B \-name (X11 only)
|
|
Set the window class name.
|
|
.
|
|
.TP
|
|
.B \-nodouble
|
|
Disables double buffering, mostly for debugging purposes.
|
|
Double buffering fixes flicker by storing two frames in memory, and
|
|
displaying one while decoding another.
|
|
It can affect OSD negatively, but often removes OSD flickering.
|
|
.
|
|
.TP
|
|
.B \-nograbpointer
|
|
Do not grab the mouse pointer after a video mode change (\-vm).
|
|
Useful for multihead setups.
|
|
.
|
|
.TP
|
|
.B \-nokeepaspect
|
|
Do not keep window aspect ratio when resizing windows.
|
|
By default MPlayer tries to keep the correct video aspect ratio by
|
|
instructing the window manager to maintain window aspect when resizing,
|
|
and by adding black bars if the window manager nevertheless allows
|
|
window shape to change.
|
|
This option disables window manager aspect hints and scales the video
|
|
to completely fill the window without regard for aspect ratio.
|
|
.
|
|
.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, corevideo, quartz, ggi and gl2.
|
|
.
|
|
.TP
|
|
.B \-panscan <0.0\-1.0>
|
|
Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
|
|
movie to make it fit a 4:3 display without black bands).
|
|
The range controls how much of the image is cropped.
|
|
May not work with all video output drivers.
|
|
.br
|
|
.I NOTE:
|
|
Values between \-1 and 0 are allowed as well, but highly experimental
|
|
and may crash or worse.
|
|
Use at your own risk!
|
|
.
|
|
.TP
|
|
.B \-panscanrange <\-19.0\-99.0> (experimental)
|
|
Change the range of the pan-and-scan functionality (default: 1).
|
|
Positive values mean multiples of the default range.
|
|
Negative numbers mean you can zoom in up to a factor of \-panscanrange+1.
|
|
E.g.\& \-panscanrange \-3 allows a zoom factor of up to 4.
|
|
This feature is experimental.
|
|
Do not report bugs unless you are using \-vo gl.
|
|
.
|
|
.TP
|
|
.B \-refreshrate <Hz>
|
|
Set the monitor refreshrate in Hz.
|
|
Currently only supported by \-vo directx combined with the \-vm option.
|
|
.
|
|
.TP
|
|
.B \-rootwin
|
|
Play movie in the root window (desktop background).
|
|
Desktop background images may cover the movie window, though.
|
|
May not work with all video output drivers.
|
|
.
|
|
.TP
|
|
.B \-saturation <\-100\-100>
|
|
Adjust the saturation of the video signal (default: 0).
|
|
You can get grayscale output with this option.
|
|
Not supported by all video output drivers.
|
|
.
|
|
.TP
|
|
.B \-screenh <pixels>
|
|
Specify the screen height for video output drivers which
|
|
do not know the screen resolution like fbdev, x11 and TV-out.
|
|
.
|
|
.TP
|
|
.B \-screenw <pixels>
|
|
Specify the screen width for video output drivers which
|
|
do not know the screen resolution like fbdev, x11 and TV-out.
|
|
.
|
|
.TP
|
|
.B \-(no)stop\-xscreensaver (X11 only)
|
|
Turns off xscreensaver at startup and turns it on again on exit
|
|
(default: enabled).
|
|
If your screensaver supports neither the XSS nor XResetScreenSaver
|
|
API please use \-heartbeat\-cmd instead.
|
|
.
|
|
.TP
|
|
.B \-title (also see \-use\-filename\-title)
|
|
Set the window title.
|
|
Supported by X11-based video output drivers.
|
|
.
|
|
.TP
|
|
.B \-use\-filename\-title (also see \-title)
|
|
Set the window title using the media filename, when not set with \-title.
|
|
Supported by X11-based video output drivers.
|
|
.
|
|
.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> (X11, OpenGL and DirectX only)
|
|
This tells MPlayer to attach to an existing window.
|
|
Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
|
|
This option fills the given window completely, thus aspect scaling,
|
|
panscan, etc are no longer handled by MPlayer but must be managed by the
|
|
application that created the window.
|
|
.
|
|
.TP
|
|
.B \-xineramascreen <\-2\-...>
|
|
In Xinerama configurations (i.e.\& a single desktop that spans across multiple
|
|
displays) this option tells MPlayer which screen to display the movie on.
|
|
A value of \-2 means fullscreen across the whole virtual display (in this case
|
|
Xinerama information is completely ignored), \-1 means
|
|
fullscreen on the display the window currently is on.
|
|
The initial position set via the \-geometry option is relative to the
|
|
specified screen.
|
|
Will usually only work with "\-fstype \-fullscreen" or "\-fstype none".
|
|
This option is not suitable to only set the startup screen (because
|
|
it will always display on the given screen in fullscreen mode),
|
|
\-geometry is the best that is available for that purpose
|
|
currently.
|
|
Supported by at least the direct3d, gl, gl2, x11, xv and corevideo video output
|
|
drivers.
|
|
.
|
|
.
|
|
.
|
|
.SH "VIDEO OUTPUT DRIVERS"
|
|
Video output drivers are interfaces to different video output facilities.
|
|
The syntax is:
|
|
.
|
|
.TP
|
|
.B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
|
|
Specify a priority list of video output drivers to be used.
|
|
.PP
|
|
If the list has a trailing ',' MPlayer will fall back on drivers not
|
|
contained in the list.
|
|
Suboptions are optional and can mostly be omitted.
|
|
.br
|
|
.I NOTE:
|
|
See \-vo help for a list of compiled-in video output 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
|
|
Available video output drivers are:
|
|
.
|
|
.TP
|
|
.B xv (X11 only)
|
|
Uses the XVideo extension of XFree86 4.x to enable hardware
|
|
accelerated playback.
|
|
If you cannot use a hardware specific driver, this is probably
|
|
the best option.
|
|
For information about what colorkey is used and how it is drawn run MPlayer
|
|
with \-v option and look out for the lines tagged with [xv common] at the
|
|
beginning.
|
|
.PD 0
|
|
.RSs
|
|
.IPs adaptor=<number>
|
|
Select a specific XVideo adaptor (check xvinfo results).
|
|
.IPs port=<number>
|
|
Select a specific XVideo port.
|
|
.IPs ck=<cur|use|set>
|
|
Select the source from which the colorkey is taken (default: cur).
|
|
.RSss
|
|
.IPs cur
|
|
The default takes the colorkey currently set in Xv.
|
|
.IPs use
|
|
Use but do not set the colorkey from MPlayer (use \-colorkey option to change
|
|
it).
|
|
.IPs set
|
|
Same as use but also sets the supplied colorkey.
|
|
.RE
|
|
.IPs ck-method=<man|bg|auto>
|
|
Sets the colorkey drawing method (default: man).
|
|
.RSss
|
|
.IPs man
|
|
Draw the colorkey manually (reduces flicker in some cases).
|
|
.IPs bg
|
|
Set the colorkey as window background.
|
|
.IPs auto
|
|
Let Xv draw the colorkey.
|
|
.RE
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B x11 (X11 only)
|
|
Shared memory video output driver without hardware acceleration that
|
|
works whenever X11 is present.
|
|
.
|
|
.TP
|
|
.B xover (X11 only)
|
|
Adds X11 support to all overlay based video output drivers.
|
|
Currently only supported by tdfx_vid.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <vo_driver>
|
|
Select the driver to use as source to overlay on top of X11.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B vdpau (X11 only)
|
|
Uses the VDPAU interface to display and optionally also decode video.
|
|
Hardware decoding is used with \-vc ffmpeg12vdpau, ffwmv3vdpau, ffvc1vdpau, ffh264vdpau or ffodivxvdpau.
|
|
.PD 0
|
|
.RSs
|
|
.IPs sharpen=<\-1\-1>
|
|
For positive values, apply a sharpening algorithm to the video,
|
|
for negative values a blurring algorithm (default: 0).
|
|
.IPs denoise=<0\-1>
|
|
Apply a noise reduction algorithm to the video (default: 0, no noise reduction).
|
|
.IPs deint=<-4\-4>
|
|
Select deinterlacing mode (default: -3).
|
|
Positive values choose mode and enable deinterlacing.
|
|
Corresponding negative values select the same deinterlacing mode,
|
|
but do not enable deinterlacing on startup (useful in configuration files
|
|
to specify what mode will be enabled by the "D" key).
|
|
All modes respect \-field\-dominance.
|
|
.RSss
|
|
.IPs 0
|
|
same as -3
|
|
.IPs 1
|
|
Show only first field, similar to \-vf field.
|
|
.IPs 2
|
|
Bob deinterlacing, similar to \-vf tfields=1.
|
|
.IPs 3
|
|
motion adaptive temporal deinterlacing.
|
|
May lead to A/V desync with slow video hardware and/or high resolution.
|
|
.IPs 4
|
|
motion adaptive temporal deinterlacing with edge-guided spatial interpolation.
|
|
Needs fast video hardware.
|
|
.RE
|
|
.IPs chroma\-deint
|
|
Makes temporal deinterlacers operate both on luma and chroma (default).
|
|
Use nochroma\-deint to solely use luma and speed up advanced deinterlacing.
|
|
Useful with slow video memory.
|
|
.IPs pullup
|
|
Try to apply inverse telecine, needs motion adaptive temporal deinterlacing.
|
|
.IPs colorspace=<0-3>
|
|
Select the color space for YUV to RGB conversion.
|
|
In general BT.601 should be used for standard definition (SD) content and
|
|
BT.709 for high definition (HD) content.
|
|
Using incorrect color space results in slightly under or over saturated and
|
|
shifted colors.
|
|
.RSss
|
|
.IPs 0
|
|
Guess the color space based on video resolution.
|
|
Video with width >= 1280 or height > 576 is assumed to be HD and BT.709 color
|
|
space will be used.
|
|
.IPs 1
|
|
Use ITU-R BT.601 color space (default).
|
|
.IPs 2
|
|
Use ITU-R BT.709 color space.
|
|
.IPs 3
|
|
Use SMPTE-240M color space.
|
|
.RE
|
|
.IPs hqscaling=<0-9>
|
|
.RSss
|
|
.IPs 0
|
|
Use default VDPAU scaling (default).
|
|
.IPs 1\-9
|
|
Apply high quality VDPAU scaling (needs capable hardware).
|
|
.RE
|
|
.IPs studio
|
|
Output video in studio level RGB (16-235).
|
|
This is what TVs and video monitors generally expect.
|
|
By default PC level RGB (0-255) suitable for PC monitors is used.
|
|
Providing studio level output to a device expecting PC level input results in
|
|
grey blacks and dim whites, the reverse in crushed blacks and whites.
|
|
.IPs fps=<number>
|
|
Override autodetected display refresh rate value (the value is needed for framedrop to allow video playback rates higher than display refresh rate, and for vsync-aware frame timing adjustments).
|
|
Default 0 means use autodetected value.
|
|
A positive value is interpreted as a refresh rate in Hz and overrides the autodetected value.
|
|
A negative value disables all timing adjustment and framedrop logic.
|
|
.IPs queuetime_windowed=<number>
|
|
.IPs queuetime_fs=<number>
|
|
Use VDPAU's presentation queue functionality to queue future video frame
|
|
changes at most this many milliseconds in advance (default: 50).
|
|
See below for additional information.
|
|
.IPs output_surfaces=<2-15>
|
|
Allocate this many output surfaces to display video frames (default: 3).
|
|
See below for additional information.
|
|
.RE
|
|
.RS
|
|
.sp 1
|
|
Using the VDPAU frame queueing functionality controlled by the queuetime
|
|
options makes MPlayer's frame flip timing less sensitive to system CPU load
|
|
and allows MPlayer to start decoding the next frame(s) slightly earlier
|
|
which can reduce jitter caused by individual slow-to-decode frames.
|
|
However the NVIDIA graphics drivers can make other window behavior such as
|
|
window moves choppy if VDPAU is using the blit queue (mainly happens
|
|
if you have the composite extension enabled) and this feature is active.
|
|
If this happens on your system and it bothers you then you can set the
|
|
queuetime value to 0 to disable this feature.
|
|
The settings to use in windowed and fullscreen mode are separate because there
|
|
should be less reason to disable this for fullscreen mode (as the driver issue
|
|
shouldn't affect the video itself).
|
|
.sp 1
|
|
You can queue more frames ahead by increasing the queuetime values and the
|
|
output_surfaces count (to ensure enough surfaces to buffer video for a
|
|
certain time ahead you need at least as many surfaces as the video has
|
|
frames during that time, plus two).
|
|
This could help make video smoother in some cases.
|
|
The main downsides are increased video RAM requirements for the surfaces
|
|
and laggier display response to user commands (display changes only become
|
|
visible some time after they're queued). The graphics driver implementation may
|
|
also have limits on the length of maximum queuing time or number of queued
|
|
surfaces that work well or at all.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B dga (X11 only)
|
|
Play video through the XFree86 Direct Graphics Access extension.
|
|
Considered obsolete.
|
|
.
|
|
.TP
|
|
.B sdl (SDL only, buggy/outdated)
|
|
Highly platform independent SDL (Simple Directmedia Layer) library
|
|
video output driver.
|
|
Since SDL uses its own X11 layer, MPlayer X11 options do not have
|
|
any effect on SDL.
|
|
Note that it has several minor bugs (\-vm/\-novm is mostly ignored,
|
|
\-fs behaves like \-novm should, window is in top-left corner when
|
|
returning from fullscreen, panscan is not supported, ...).
|
|
.PD 0
|
|
.RSs
|
|
.IPs driver=<driver>
|
|
Explicitly choose the SDL driver to use.
|
|
.IPs (no)forcexv
|
|
Use XVideo through the sdl video output driver (default: forcexv).
|
|
.IPs (no)hwaccel
|
|
Use hardware accelerated scaler (default: hwaccel).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B direct3d (Windows only) (BETA CODE!)
|
|
Video output driver that uses the Direct3D interface (useful for Vista).
|
|
.
|
|
.TP
|
|
.B directx (Windows only)
|
|
Video output driver that uses the DirectX interface.
|
|
.PD 0
|
|
.RSs
|
|
.IPs noaccel
|
|
Turns off hardware acceleration.
|
|
Try this option if you have display problems.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B kva (OS/2 only)
|
|
Video output driver that uses the libkva interface.
|
|
.PD 0
|
|
.RSs
|
|
.IPs snap
|
|
Force SNAP mode.
|
|
.IPs wo
|
|
Force WarpOverlay! mode.
|
|
.IPs dive
|
|
Force DIVE mode.
|
|
.IPs (no)t23
|
|
Enable or disable workaround for T23 laptop (default: disabled).
|
|
Try to enable this option if your video card supports upscaling only.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B quartz (Mac OS X only)
|
|
Mac OS X Quartz video output driver.
|
|
Under some circumstances, it might be more efficient to force a
|
|
packed YUV output format, with e.g.\& \-vf format=yuy2.
|
|
.PD 0
|
|
.RSs
|
|
.IPs device_id=<number>
|
|
Choose the display device to use in fullscreen.
|
|
.IPs fs_res=<width>:<height>
|
|
Specify the fullscreen resolution (useful on slow systems).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B corevideo (Mac OS X 10.4 or 10.3.9 with QuickTime 7)
|
|
Mac OS X CoreVideo video output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs device_id=<number>
|
|
Choose the display device to use for fullscreen or set it to \-1 to
|
|
always use the same screen the video window is on (default: \-1 \- auto).
|
|
.IPs shared_buffer
|
|
Write output to a shared memory buffer instead of displaying it and
|
|
try to open an existing NSConnection for communication with a GUI.
|
|
.IPs buffer_name=<name>
|
|
Name of the shared buffer created with shm_open as well as the name of
|
|
the NSConnection MPlayer will try to open (default: "mplayerosx").
|
|
Setting buffer_name implicitly enables shared_buffer.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B fbdev (Linux only)
|
|
Uses the kernel framebuffer to play video.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B fbdev2 (Linux only)
|
|
Uses the kernel framebuffer to play video,
|
|
alternative implementation.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
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 (no)dga
|
|
Turns DGA mode on or off (default: on).
|
|
.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 "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.
|
|
The mode can be given in a <width>x<height>x<colors> format,
|
|
e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
|
|
.IPs bbosd
|
|
Draw OSD into black bands below the movie (slower).
|
|
.IPs native
|
|
Use only native drawing functions.
|
|
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.
|
|
.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
|
|
colorspaces and direct rendering.
|
|
For optimal speed try adding the options
|
|
.br
|
|
\-dr \-noslices
|
|
.br
|
|
The code performs very few checks, so if a feature does not work, this
|
|
might be because it is not supported by your card/OpenGL implementation
|
|
even if you do not get any error message.
|
|
Use glxinfo or a similar tool to display the supported OpenGL extensions.
|
|
.PD 0
|
|
.RSs
|
|
.IPs (no)ati\-hack
|
|
ATI drivers may give a corrupted image when PBOs are used (when using \-dr
|
|
or force\-pbo).
|
|
This option fixes this, at the expense of using a bit more memory.
|
|
.IPs (no)force\-pbo
|
|
Always uses PBOs to transfer textures even if this involves an extra copy.
|
|
Currently this gives a little extra speed with NVidia drivers and a lot more
|
|
speed with ATI drivers.
|
|
May need \-noslices and the ati\-hack suboption to work correctly.
|
|
.IPs (no)scaled-osd
|
|
Changes the way the OSD behaves when the size of the
|
|
window changes (default: disabled).
|
|
When enabled behaves more like the other video output drivers,
|
|
which is better for fixed-size fonts.
|
|
Disabled looks much better with FreeType fonts and uses the
|
|
borders in fullscreen mode.
|
|
Does not work correctly with ass subtitles (see \-ass), you can instead
|
|
render them without OpenGL support via \-vf ass.
|
|
.IPs osdcolor=<0xAARRGGBB>
|
|
Color for OSD (default: 0x00ffffff, corresponds to non-transparent white).
|
|
.IPs rectangle=<0,1,2>
|
|
Select usage of rectangular textures which saves video RAM, but often is
|
|
slower (default: 0).
|
|
.RSss
|
|
0: Use power-of-two textures (default).
|
|
.br
|
|
1: Use the GL_ARB_texture_rectangle extension.
|
|
.br
|
|
2: Use the GL_ARB_texture_non_power_of_two extension.
|
|
In some cases only supported in software and thus very slow.
|
|
.RE
|
|
.IPs swapinterval=<n>
|
|
Minimum interval between two buffer swaps, counted in
|
|
displayed frames (default: 1).
|
|
1 is equivalent to enabling VSYNC, 0 to disabling VSYNC.
|
|
Values below 0 will leave it at the system default.
|
|
This limits the framerate to (horizontal refresh rate / n).
|
|
Requires GLX_SGI_swap_control support to work.
|
|
With some (most/all?) implementations this only works in fullscreen mode.
|
|
.IPs ycbcr
|
|
Use the GL_MESA_ycbcr_texture extension to convert YUV to RGB.
|
|
In most cases this is probably slower than doing software conversion to RGB.
|
|
.IPs yuv=<n>
|
|
Select the type of YUV to RGB conversion.
|
|
The default is auto-detection deciding between values 0 and 2.
|
|
.RSss
|
|
0: Use software conversion.
|
|
Compatible with all OpenGL versions.
|
|
Provides brightness, contrast and saturation control.
|
|
.br
|
|
1: Use register combiners.
|
|
This uses an nVidia-specific extension (GL_NV_register_combiners).
|
|
At least three texture units are needed.
|
|
Provides saturation and hue control.
|
|
This method is fast but inexact.
|
|
.br
|
|
2: Use a fragment program.
|
|
Needs the GL_ARB_fragment_program extension and at least three texture units.
|
|
Provides brightness, contrast, saturation and hue control.
|
|
.br
|
|
3: Use a fragment program using the POW instruction.
|
|
Needs the GL_ARB_fragment_program extension and at least three texture units.
|
|
Provides brightness, contrast, saturation, hue and gamma control.
|
|
Gamma can also be set independently for red, green and blue.
|
|
Method 4 is usually faster.
|
|
.br
|
|
4: Use a fragment program with additional lookup.
|
|
Needs the GL_ARB_fragment_program extension and at least four texture units.
|
|
Provides brightness, contrast, saturation, hue and gamma control.
|
|
Gamma can also be set independently for red, green and blue.
|
|
.br
|
|
5: Use ATI-specific method (for older cards).
|
|
This uses an ATI-specific extension (GL_ATI_fragment_shader \- not
|
|
GL_ARB_fragment_shader!).
|
|
At least three texture units are needed.
|
|
Provides saturation and hue control.
|
|
This method is fast but inexact.
|
|
.br
|
|
6: Use a 3D texture to do conversion via lookup.
|
|
Needs the GL_ARB_fragment_program extension and at least four texture units.
|
|
Extremely slow (software emulation) on some (all?) ATI cards since it uses
|
|
a texture with border pixels.
|
|
Provides brightness, contrast, saturation, hue and gamma control.
|
|
Gamma can also be set independently for red, green and blue.
|
|
Speed depends more on GPU memory bandwidth than other methods.
|
|
.RE
|
|
.IPs colorspace
|
|
Select the color space for YUV to RGB conversion.
|
|
.RSss
|
|
.IPs 0
|
|
Use the formula used normally by MPlayer (default).
|
|
.IPs 1
|
|
Use ITU-R BT.601 color space.
|
|
.IPs 2
|
|
Use ITU-R BT.709 color space.
|
|
.IPs 3
|
|
Use SMPTE-240M color space.
|
|
.RE
|
|
.IPs levelconv=<n>
|
|
Select the brightness level conversion to use for the YUV to RGB conversion
|
|
.RSss
|
|
.IPs 0
|
|
Convert TV to PC levels (default).
|
|
.IPs 1
|
|
Convert PC to TV levels.
|
|
.IPs 2
|
|
Do not do any conversion.
|
|
.RE
|
|
.IPs lscale=<n>
|
|
Select the scaling function to use for luminance scaling.
|
|
Only valid for yuv modes 2, 3, 4 and 6.
|
|
.RSss
|
|
.IPs 0
|
|
Use simple linear filtering (default).
|
|
.IPs 1
|
|
Use bicubic B-spline filtering (better quality).
|
|
Needs one additional texture unit.
|
|
Older cards will not be able to handle this for chroma at least in fullscreen mode.
|
|
.IPs 2
|
|
Use cubic filtering in horizontal, linear filtering in vertical direction.
|
|
Works on a few more cards than method 1.
|
|
.IPs 3
|
|
Same as 1 but does not use a lookup texture.
|
|
Might be faster on some cards.
|
|
.IPs 4
|
|
Use experimental unsharp masking with 3x3 support and a default strength of 0.5 (see filter-strength).
|
|
.IPs 5
|
|
Use experimental unsharp masking with 5x5 support and a default strength of 0.5 (see filter-strength).
|
|
.RE
|
|
.IPs cscale=<n>
|
|
Select the scaling function to use for chrominance scaling.
|
|
For details see lscale.
|
|
.IPs filter-strength=<value>
|
|
Set the effect strength for the lscale/cscale filters that support it.
|
|
.IPs noise-strength=<value>
|
|
Set how much noise to add. 0 to disable (default), 1.0 for level suitable
|
|
for dithering to 6 bit.
|
|
.IPs stereo=<value>
|
|
Select a method for stereo display.
|
|
You may have to use \-aspect to fix the aspect value.
|
|
Experimental, do not expect too much from it.
|
|
.RSss
|
|
.IPs 0
|
|
normal 2D display
|
|
.IPs 1
|
|
Convert side by side input to full-color red-cyan stereo.
|
|
.IPs 2
|
|
Convert side by side input to full-color green-magenta stereo.
|
|
.IPs 3
|
|
Convert side by side input to quadbuffered stereo.
|
|
Only supported by very few OpenGL cards.
|
|
.RE
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
The following options are only useful if writing your own fragment programs.
|
|
.RE
|
|
.sp 1
|
|
.RSs
|
|
.IPs customprog=<filename>
|
|
Load a custom fragment program from <filename>.
|
|
See TOOLS/edgedect.fp for an example.
|
|
.IPs customtex=<filename>
|
|
Load a custom "gamma ramp" texture from <filename>.
|
|
This can be used in combination with yuv=4 or with the customprog option.
|
|
.IPs (no)customtlin
|
|
If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST
|
|
for customtex texture.
|
|
.IPs (no)customtrect
|
|
If enabled, use texture_rectangle for customtex texture.
|
|
Default is disabled.
|
|
.IPs (no)mipmapgen
|
|
If enabled, mipmaps for the video are automatically generated.
|
|
This should be useful together with the customprog and the TXB
|
|
instruction to implement blur filters with a large radius.
|
|
For most OpenGL implementations this is very slow for any non-RGB
|
|
formats.
|
|
Default is disabled.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
Normally there is no reason to use the following options, they mostly
|
|
exist for testing purposes.
|
|
.RE
|
|
.sp 1
|
|
.RSs
|
|
.IPs (no)glfinish
|
|
Call glFinish() before swapping buffers.
|
|
Slower but in some cases more correct output (default: disabled).
|
|
.IPs (no)manyfmts
|
|
Enables support for more (RGB and BGR) color formats (default: enabled).
|
|
Needs OpenGL version >= 1.2.
|
|
.IPs slice-height=<0\-...>
|
|
Number of lines copied to texture in one piece (default: 0).
|
|
0 for whole image.
|
|
.br
|
|
.I NOTE:
|
|
If YUV colorspace is used (see yuv suboption), special rules apply:
|
|
.RSss
|
|
If the decoder uses slice rendering (see \-noslices), this setting
|
|
has no effect, the size of the slices as provided by the decoder is used.
|
|
.br
|
|
If the decoder does not use slice rendering, the default is 16.
|
|
.RE
|
|
.IPs (no)osd
|
|
Enable or disable support for OSD rendering via OpenGL (default: enabled).
|
|
This option is for testing; to disable the OSD use \-osdlevel 0 instead.
|
|
.IPs (no)aspect
|
|
Enable or disable aspect scaling and pan-and-scan support (default: enabled).
|
|
Disabling might increase speed.
|
|
.REss
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "gl2\ \ \ \ "
|
|
Variant of the OpenGL video output driver.
|
|
Supports videos larger than the maximum texture size but lacks many of the
|
|
advanced features and optimizations of the gl driver and is unlikely to be
|
|
extended further.
|
|
.PD 0
|
|
.RSs
|
|
.IPs (no)glfinish
|
|
same as gl (default: enabled)
|
|
.IPs yuv=<n>
|
|
Select the type of YUV to RGB conversion.
|
|
If set to anything except 0 OSD will be disabled and brightness, contrast and
|
|
gamma setting is only available via the global X server settings.
|
|
Apart from this the values have the same meaning as for \-vo gl.
|
|
.REss
|
|
.
|
|
.TP
|
|
.B matrixview
|
|
OpenGL-based renderer creating a Matrix-like running-text effect.
|
|
.PD 0
|
|
.RSs
|
|
.IPs cols=<n>
|
|
Number of text columns to display.
|
|
Very low values (< 16) will probably fail due to scaler limitations.
|
|
Values not divisible by 16 may cause issues as well.
|
|
.IPs rows=<n>
|
|
Number of text rows to display.
|
|
Very low values (< 16) will probably fail due to scaler limitations.
|
|
Values not divisible by 16 may cause issues as well.
|
|
.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
|
|
by executing 'mplayer \-vo aa:help'.
|
|
.br
|
|
.I NOTE:
|
|
The driver does not handle \-aspect correctly.
|
|
.br
|
|
.I HINT:
|
|
You probably have to specify \-monitorpixelaspect.
|
|
Try 'mplayer \-vo aa \-monitorpixelaspect 0.5'.
|
|
.
|
|
.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>
|
|
Explicitly choose the Blinkenlights subdevice driver to use.
|
|
It is something like arcade:host=localhost:2323 or
|
|
hdl:file=name1,file=name2.
|
|
You must specify a subdevice.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "ggi\ \ \ \ "
|
|
GGI graphics system video output driver
|
|
.PD 0
|
|
.RSs
|
|
.IPs <driver>
|
|
Explicitly choose the GGI driver to use.
|
|
Replace any ',' that would appear in the driver string by a '.'.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B directfb
|
|
Play video using the DirectFB library.
|
|
.PD 0
|
|
.RSs
|
|
.IPs (no)input
|
|
Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
|
|
.IPs buffermode=single|double|triple
|
|
Double and triple buffering give best results if you want to avoid tearing issues.
|
|
Triple buffering is more efficient than double buffering as it does
|
|
not block MPlayer while waiting for the vertical retrace.
|
|
Single buffering should be avoided (default: single).
|
|
.IPs fieldparity=top|bottom
|
|
Control the output order for interlaced frames (default: disabled).
|
|
Valid values are top = top fields first, bottom = bottom fields first.
|
|
This option does not have any effect on progressive film material
|
|
like most MPEG movies are.
|
|
You need to enable this option if you have tearing issues or unsmooth
|
|
motions watching interlaced film material.
|
|
.IPs layer=N
|
|
Will force layer with ID N for playback (default: \-1 \- auto).
|
|
.IPs dfbopts=<list>
|
|
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
|
|
.IPs (no)input
|
|
same as directfb (default: disabled)
|
|
.IPs buffermode=single|double|triple
|
|
same as directfb (default: triple)
|
|
.IPs fieldparity=top|bottom
|
|
same as directfb
|
|
.IPs (no)bes
|
|
Enable the use of the Matrox BES (backend scaler) (default: disabled).
|
|
Gives very good results concerning speed and output quality as interpolated
|
|
picture processing is done in hardware.
|
|
Works only on the primary head.
|
|
.IPs (no)spic
|
|
Make use of the Matrox sub picture layer to display the OSD (default: enabled).
|
|
.IPs (no)crtc2
|
|
Turn on TV-out on the second head (default: enabled).
|
|
The output quality is amazing as it is a full interlaced picture
|
|
with proper sync to every odd/\:even field.
|
|
.IPs tvnorm=pal|ntsc|auto
|
|
Will set the TV norm of the Matrox card without the need
|
|
for modifying /etc/\:directfbrc (default: disabled).
|
|
Valid norms are pal = PAL, ntsc = NTSC.
|
|
Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
|
|
which norm to use by looking at the framerate of the movie.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B mga (Linux only)
|
|
Matrox specific video output driver that makes use of the YUV back
|
|
end scaler on Gxxx cards through a kernel module.
|
|
If you have a Matrox card, this is the fastest option.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B xmga (Linux, X11 only)
|
|
The mga video output driver, running in an X11 window.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B s3fb (Linux only) (also see \-dr)
|
|
S3 Virge specific video output driver.
|
|
This driver supports the card's YUV conversion and scaling, double
|
|
buffering and direct rendering features.
|
|
Use \-vf format=yuy2 to get hardware-accelerated YUY2 rendering, which is
|
|
much faster than YV12 on this card.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B wii (Linux only)
|
|
Nintendo Wii/GameCube specific video output driver.
|
|
.
|
|
.TP
|
|
.B 3dfx (Linux only)
|
|
3dfx-specific video output driver that directly uses
|
|
the hardware on top of X11.
|
|
Only 16 bpp are supported.
|
|
.
|
|
.TP
|
|
.B tdfxfb (Linux only)
|
|
This driver employs the tdfxfb framebuffer driver to play movies with
|
|
YUV acceleration on 3dfx cards.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B tdfx_vid (Linux only)
|
|
3dfx-specific video output driver that works in combination with
|
|
the tdfx_vid kernel module.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B dxr3 (DXR3 only)
|
|
Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
|
|
Hollywood Plus) specific video output driver.
|
|
Also see the lavc video filter.
|
|
.PD 0
|
|
.RSs
|
|
.IPs overlay
|
|
Activates the overlay instead of TV-out.
|
|
.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).
|
|
.br
|
|
1: Auto-adjust using PAL/\:NTSC.
|
|
.br
|
|
2: Auto-adjust using PAL/\:PAL-60.
|
|
.br
|
|
3: PAL
|
|
.br
|
|
4: PAL-60
|
|
.br
|
|
5: NTSC
|
|
.RE
|
|
.IPs <0\-3>
|
|
Specifies the device number to use if you have more than one em8300 card.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B ivtv (IVTV only)
|
|
Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression
|
|
iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500)
|
|
specific video output driver for TV-out.
|
|
Also see the lavc video filter.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
|
|
.IPs <output>
|
|
Explicitly choose the TV-out output to be used for the video signal.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B v4l2 (requires Linux 2.6.22+ kernel)
|
|
Video output driver for V4L2 compliant cards with built-in hardware MPEG decoder.
|
|
Also see the lavc video filter.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <device>
|
|
Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
|
|
.IPs <output>
|
|
Explicitly choose the TV-out output to be used for the video signal.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B mpegpes (DVB only)
|
|
Video output driver for DVB cards that writes the output to an MPEG-PES file
|
|
if no DVB card is installed.
|
|
.PD 0
|
|
.RSs
|
|
.IPs card=<1\-4>
|
|
Specifies the device number to use if you have more than one DVB output card
|
|
(V3 API only, such as 1.x.y series drivers).
|
|
If not specified MPlayer will search the first usable card.
|
|
.IPs <filename>
|
|
output filename (default: ./grab.mpg)
|
|
.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
|
|
.IPs outfile=<value>
|
|
Specify the output filename (default: ./md5sums).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B yuv4mpeg
|
|
Transforms the video stream into a sequence of uncompressed YUV 4:2:0
|
|
images and stores it in a file (default: ./stream.yuv).
|
|
The format is the same as the one employed by mjpegtools, so this is
|
|
useful if you want to process the video with the mjpegtools suite.
|
|
It supports the YV12 format.
|
|
If your source file has a different format and is interlaced, make sure
|
|
to use -vf scale=::1 to ensure the conversion uses interlaced mode.
|
|
You can combine it with the \-fixed\-vo option to concatenate files
|
|
with the same dimensions and fps value.
|
|
.PD 0
|
|
.RSs
|
|
.IPs interlaced
|
|
Write the output as interlaced frames, top field first.
|
|
.IPs interlaced_bf
|
|
Write the output as interlaced frames, bottom field first.
|
|
.IPs file=<filename>
|
|
Write the output to <filename> instead of the default stream.yuv.
|
|
.REss
|
|
.PD 1
|
|
.RS
|
|
.sp 1
|
|
.I NOTE:
|
|
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
|
|
.IPs <fps>
|
|
Float value to specify framerate (default: 5.0).
|
|
.IPs <output>
|
|
Specify the output filename (default: ./out.gif).
|
|
.REss
|
|
.PD 1
|
|
.RS
|
|
.sp 1
|
|
.I NOTE:
|
|
You must specify the framerate before the filename or the framerate will
|
|
be part of the filename.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
mplayer video.nut \-vo gif89a:fps=15:output=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
|
|
Specify standard or progressive JPEG (default: noprogressive).
|
|
.IPs [no]baseline
|
|
Specify use of baseline or not (default: baseline).
|
|
.IPs optimize=<0\-100>
|
|
optimization factor (default: 100)
|
|
.IPs smooth=<0\-100>
|
|
smooth factor (default: 0)
|
|
.IPs quality=<0\-100>
|
|
quality factor (default: 75)
|
|
.IPs outdir=<dirname>
|
|
Specify the directory to save the JPEG files to (default: ./).
|
|
.IPs subdirs=<prefix>
|
|
Create numbered subdirectories with the specified prefix to
|
|
save the files in instead of the current directory.
|
|
.IPs "maxfiles=<value> (subdirs only)"
|
|
Maximum number of files to be saved per subdirectory.
|
|
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: ./).
|
|
.IPs subdirs=<prefix>
|
|
Create numbered subdirectories with the specified prefix to
|
|
save the files in instead of the current directory.
|
|
.IPs "maxfiles=<value> (subdirs only)"
|
|
Maximum number of files to be saved per subdirectory.
|
|
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
|
|
.IPs z=<0\-9>
|
|
Specifies the compression level.
|
|
0 is no compression, 9 is maximum compression.
|
|
.IPs alpha (default: noalpha)
|
|
Create PNG files with an alpha channel.
|
|
Note that MPlayer in general does not support alpha, so this will only
|
|
be useful in some rare cases.
|
|
.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.
|
|
You can force a particular format with the format video filter.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
mplayer video.nut \-vf format=bgr15 \-vo tga
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.
|
|
.
|
|
.SH "DECODING/FILTERING OPTIONS"
|
|
.
|
|
.TP
|
|
.B \-ac <[\-|+]codec1,[\-|+]codec2,...[,]>
|
|
Specify a priority list of audio codecs to be used, according to their codec
|
|
name in codecs.conf.
|
|
Use a '\-' before the codec name to omit it.
|
|
Use a '+' before the codec name to force it, this will likely crash!
|
|
If the list has a trailing ',' MPlayer will fall back on codecs not
|
|
contained in the list.
|
|
.br
|
|
.I NOTE:
|
|
See \-ac help for a full list of available codecs.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-ac mp3acm"
|
|
Force the l3codeca.acm MP3 codec.
|
|
.IPs "\-ac mad,"
|
|
Try libmad first, then fall back on others.
|
|
.IPs "\-ac hwac3,a52,"
|
|
Try hardware AC-3 passthrough, software AC-3, then others.
|
|
.IPs "\-ac hwdts,"
|
|
Try hardware DTS passthrough, then fall back on others.
|
|
.IPs "\-ac \-ffmp3,"
|
|
Skip FFmpeg's MP3 decoder.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-af\-adv <force=(0\-7):list=(filters)> (also see \-af)
|
|
Specify advanced audio filter options:
|
|
.RSs
|
|
.IPs force=<0\-7>
|
|
Forces the insertion of audio filters to one of the following:
|
|
.RSss
|
|
0: Use completely automatic filter insertion (currently identical to 1).
|
|
.br
|
|
1: Optimize for accuracy (default).
|
|
.br
|
|
2: Optimize for speed.
|
|
.I Warning:
|
|
Some features in the audio filters may silently fail,
|
|
and the sound quality may drop.
|
|
.br
|
|
3: Use no automatic insertion of filters and no optimization.
|
|
.I Warning:
|
|
It may be possible to crash MPlayer using this setting.
|
|
.br
|
|
4: Use automatic insertion of filters according to 0 above,
|
|
but use floating point processing when possible.
|
|
.br
|
|
5: Use automatic insertion of filters according to 1 above,
|
|
but use floating point processing when possible.
|
|
.br
|
|
6: Use automatic insertion of filters according to 2 above,
|
|
but use floating point processing when possible.
|
|
.br
|
|
7: Use no automatic insertion of filters according to 3 above,
|
|
and use floating point processing when possible.
|
|
.REss
|
|
.IPs list=<filters>
|
|
Same as \-af.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-afm <driver1,driver2,...>
|
|
Specify a priority list of audio codec families to be used, according
|
|
to their codec name in codecs.conf.
|
|
Falls back on the default codecs if none of the given codec families work.
|
|
.br
|
|
.I NOTE:
|
|
See \-afm help for a full list of available codec families.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-afm ffmpeg"
|
|
Try FFmpeg's libavcodec codecs first.
|
|
.IPs "\-afm acm,dshow"
|
|
Try Win32 codecs first.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-aspect <ratio> (also see \-zoom)
|
|
Override movie aspect ratio, in case aspect information is
|
|
incorrect or missing in the file being played.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
\-aspect 4:3 or \-aspect 1.3333
|
|
.br
|
|
\-aspect 16:9 or \-aspect 1.7777
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-noaspect
|
|
Disable automatic movie aspect ratio compensation.
|
|
.
|
|
.TP
|
|
.B "\-field\-dominance <\-1\-1>"
|
|
Set first field for interlaced content.
|
|
Useful for deinterlacers that double the framerate: \-vf tfields=1,
|
|
\-vf yadif=1 and \-vo vdpau:deint.
|
|
.PD 0
|
|
.RSs
|
|
.IPs \-1
|
|
auto (default): If the decoder does not export the appropriate information,
|
|
it falls back to 0 (top field first).
|
|
.IPs 0
|
|
top field first
|
|
.IPs 1
|
|
bottom field first
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "\-flip \ "
|
|
Flip image upside-down.
|
|
.
|
|
.TP
|
|
.B \-lavdopts <option1:option2:...> (DEBUG CODE)
|
|
Specify libavcodec decoding parameters.
|
|
Separate multiple options with a colon.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
\-lavdopts gray:skiploopfilter=all:skipframe=nonref
|
|
.RE
|
|
.PD 1
|
|
.sp 1
|
|
.RS
|
|
Available options are:
|
|
.RE
|
|
.RSs
|
|
.IPs bitexact
|
|
Only use bit-exact algorithms in all decoding steps (for codec testing).
|
|
.IPs bug=<value>
|
|
Manually work around encoder bugs.
|
|
.RSss
|
|
0: nothing
|
|
.br
|
|
1: autodetect bugs (default)
|
|
.br
|
|
2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
|
|
.br
|
|
4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX)
|
|
.br
|
|
8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
|
|
.br
|
|
16 (mpeg4): padding bug (autodetected)
|
|
.br
|
|
32 (mpeg4): illegal vlc bug (autodetected per fourcc)
|
|
.br
|
|
64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version)
|
|
.br
|
|
128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
|
|
.br
|
|
256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
|
|
.br
|
|
512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
|
|
.br
|
|
1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
|
|
.REss
|
|
.IPs debug=<value>
|
|
Display debugging information.
|
|
.RSss
|
|
.br
|
|
0: disabled
|
|
.br
|
|
1: picture info
|
|
.br
|
|
2: rate control
|
|
.br
|
|
4: bitstream
|
|
.br
|
|
8: macroblock (MB) type
|
|
.br
|
|
16: per-block quantization parameter (QP)
|
|
.br
|
|
32: motion vector
|
|
.br
|
|
0x0040: motion vector visualization (use \-noslices)
|
|
.br
|
|
0x0080: macroblock (MB) skip
|
|
.br
|
|
0x0100: startcode
|
|
.br
|
|
0x0200: PTS
|
|
.br
|
|
0x0400: error resilience
|
|
.br
|
|
0x0800: memory management control operations (H.264)
|
|
.br
|
|
0x1000: bugs
|
|
.br
|
|
0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
|
|
.br
|
|
0x4000: Visualize block types.
|
|
.REss
|
|
.IPs ec=<value>
|
|
Set error concealment strategy.
|
|
.RSss
|
|
1: Use strong deblock filter for damaged MBs.
|
|
.br
|
|
2: iterative motion vector (MV) search (slow)
|
|
.br
|
|
3: all (default)
|
|
.REss
|
|
.IPs er=<value>
|
|
Set error resilience strategy.
|
|
.RSss
|
|
.br
|
|
0: disabled
|
|
.br
|
|
1: careful (Should work with broken encoders.)
|
|
.br
|
|
2: normal (default) (Works with compliant encoders.)
|
|
.br
|
|
3: aggressive (More checks, but might cause problems even for valid bitstreams.)
|
|
.br
|
|
4: very aggressive
|
|
.REss
|
|
.IPs "fast (MPEG-2, MPEG-4, and H.264 only)"
|
|
Enable optimizations which do not comply to the specification and might
|
|
potentially cause problems, like simpler dequantization, simpler motion
|
|
compensation, 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>]
|
|
Decode at lower resolutions.
|
|
Low resolution decoding is not supported by all codecs, and it will
|
|
often result in ugly artifacts.
|
|
This is not a bug, but a side effect of not decoding at full resolution.
|
|
.RSss
|
|
.br
|
|
0: disabled
|
|
.br
|
|
1: 1/2 resolution
|
|
.br
|
|
2: 1/4 resolution
|
|
.br
|
|
3: 1/8 resolution
|
|
.REss
|
|
.RS
|
|
If <w> is specified lowres decoding will be used only if the width of the
|
|
video is major than or equal to <w>.
|
|
.RE
|
|
.B o=<key>=<value>[,<key>=<value>[,...]]
|
|
Pass AVOptions to libavcodec decoder.
|
|
Note, a patch to make the o= unneeded and pass all unknown options through
|
|
the AVOption system is welcome.
|
|
A full list of AVOptions can be found in the FFmpeg manual.
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.PD 0
|
|
.IPs o=debug=pict
|
|
.PD 1
|
|
.RE
|
|
.IPs "sb=<number> (MPEG-2 only)"
|
|
Skip the given number of macroblock rows at the bottom.
|
|
.IPs "st=<number> (MPEG-2 only)"
|
|
Skip the given number of macroblock rows at the top.
|
|
.IPs "skiploopfilter=<skipvalue> (H.264 only)"
|
|
Skips the loop filter (AKA deblocking) during H.264 decoding.
|
|
Since the filtered frame is supposed to be used as reference
|
|
for decoding dependent frames this has a worse effect on quality
|
|
than not doing deblocking on e.g.\& MPEG-2 video.
|
|
But at least for high bitrate HDTV this provides a big speedup with
|
|
no visible quality loss.
|
|
.sp 1
|
|
<skipvalue> can be either one of the following:
|
|
.RSss
|
|
.br
|
|
none: Never skip.
|
|
.br
|
|
default: Skip useless processing steps (e.g.\& 0 size packets in AVI).
|
|
.br
|
|
nonref: Skip frames that are not referenced (i.e.\& not used for
|
|
decoding other frames, the error cannot "build up").
|
|
.br
|
|
bidir: Skip B-Frames.
|
|
.br
|
|
nonkey: Skip all frames except keyframes.
|
|
.br
|
|
all: Skip all frames.
|
|
.REss
|
|
.IPs "skipidct=<skipvalue> (MPEG-1/2 only)"
|
|
Skips the IDCT step.
|
|
This degrades quality a lot of in almost all cases
|
|
(see skiploopfilter for available skip values).
|
|
.IPs skipframe=<skipvalue>
|
|
Skips decoding of frames completely.
|
|
Big speedup, but jerky motion and sometimes bad artifacts
|
|
(see skiploopfilter for available skip values).
|
|
.IPs "threads=<0\-16>"
|
|
Number of threads to use for decoding.
|
|
Whether threading is actually supported depends on codec.
|
|
0 means autodetect number of cores on the machine and use that, up to the
|
|
maximum of 16.
|
|
(default: 0)
|
|
.IPs vismv=<value>
|
|
Visualize motion vectors.
|
|
.RSss
|
|
.br
|
|
0: disabled
|
|
.br
|
|
1: Visualize forward predicted MVs of P-frames.
|
|
.br
|
|
2: Visualize forward predicted MVs of B-frames.
|
|
.br
|
|
4: Visualize backward predicted MVs of B-frames.
|
|
.REss
|
|
.IPs vstats
|
|
Prints some statistics and stores them in ./vstats_*.log.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-noslices
|
|
Disable drawing video by 16-pixel height slices/\:bands, instead draws the
|
|
whole frame in a single run.
|
|
May be faster or slower, depending on video card and available cache.
|
|
It has effect only with libmpeg2 and libavcodec codecs.
|
|
.
|
|
.TP
|
|
.B \-nosound
|
|
Do not play sound.
|
|
Useful for benchmarking.
|
|
.
|
|
.TP
|
|
.B \-novideo
|
|
Do not play video.
|
|
With some demuxers this may not work. In those cases you can try \-vc null \-vo null instead; but "\-vc null" is always unreliable.
|
|
.
|
|
.TP
|
|
.B \-pp <quality> (also see \-vf pp)
|
|
Set the DLL postprocess level.
|
|
This option is no longer usable with \-vf pp.
|
|
It only works with Win32 DirectShow DLLs with internal postprocessing routines.
|
|
The valid range of \-pp values varies by codec, it is mostly
|
|
0\-6, where 0=disable, 6=slowest/\:best.
|
|
.
|
|
.TP
|
|
.B \-pphelp (also see \-vf pp)
|
|
Show a summary about the available postprocess filters and their usage.
|
|
.
|
|
.TP
|
|
.B \-ssf <mode>
|
|
Specifies software scaler parameters.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
\-vf scale \-ssf lgb=3.0
|
|
.RE
|
|
.PD 1
|
|
.PD 0
|
|
.RSs
|
|
.IPs lgb=<0\-100>
|
|
gaussian blur filter (luma)
|
|
.IPs cgb=<0\-100>
|
|
gaussian blur filter (chroma)
|
|
.IPs ls=<\-100\-100>
|
|
sharpen filter (luma)
|
|
.IPs cs=<\-100\-100>
|
|
sharpen filter (chroma)
|
|
.IPs chs=<h>
|
|
chroma horizontal shifting
|
|
.IPs cvs=<v>
|
|
chroma vertical shifting
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-stereo <mode>
|
|
Select type of MP2/\:MP3 stereo output.
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
stereo
|
|
.IPs 1
|
|
left channel
|
|
.IPs 2
|
|
right channel
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-sws <software scaler type> (also see \-vf scale and \-zoom)
|
|
Specify the software scaler algorithm to be used with the \-zoom option.
|
|
This affects video output drivers which lack hardware acceleration, e.g.\& x11.
|
|
.sp 1
|
|
Available types are:
|
|
.sp 1
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
fast bilinear
|
|
.IPs 1
|
|
bilinear
|
|
.IPs 2
|
|
bicubic (good quality) (default)
|
|
.IPs 3
|
|
experimental
|
|
.IPs 4
|
|
nearest neighbor (bad quality)
|
|
.IPs 5
|
|
area
|
|
.IPs 6
|
|
luma bicubic / chroma bilinear
|
|
.IPs 7
|
|
gauss
|
|
.IPs 8
|
|
sincR
|
|
.IPs 9
|
|
lanczos
|
|
.IPs 10
|
|
natural bicubic spline
|
|
.RE
|
|
.PD 1
|
|
.sp 1
|
|
.RS
|
|
.I NOTE:
|
|
Some \-sws options are tunable.
|
|
The description of the scale video filter has further information.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B \-vc <[\-|+]codec1,[\-|+]codec2,...[,]>
|
|
Specify a priority list of video codecs to be used, according to their codec
|
|
name in codecs.conf.
|
|
Use a '\-' before the codec name to omit it.
|
|
Use a '+' before the codec name to force it, this will likely crash!
|
|
If the list has a trailing ',' MPlayer will fall back on codecs not
|
|
contained in the list.
|
|
.br
|
|
.I NOTE:
|
|
See \-vc help for a full list of available codecs.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-vc divx"
|
|
Force Win32/\:VfW DivX codec, no fallback.
|
|
.IPs "\-vc \-divxds,\-divx,"
|
|
Skip Win32 DivX codecs.
|
|
.IPs "\-vc ffmpeg12,mpeg12,"
|
|
Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-vfm <driver1,driver2,...>
|
|
Specify a priority list of video codec families to be used, according
|
|
to their names in codecs.conf.
|
|
Falls back on the default codecs if none of the given codec families work.
|
|
.br
|
|
.I NOTE:
|
|
See \-vfm help for a full list of available codec families.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-vfm ffmpeg,dshow,vfw"
|
|
Try the libavcodec, then Directshow, then VfW codecs and fall back
|
|
on others, if they do not work.
|
|
.IPs "\-vfm xanim"
|
|
Try XAnim codecs first.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-x <x> (also see \-zoom)
|
|
Scale image to width <x> (if software/\:hardware scaling is available).
|
|
Disables aspect calculations.
|
|
.
|
|
.TP
|
|
.B \-xvidopts <option1:option2:...>
|
|
Specify additional parameters when decoding with Xvid.
|
|
.br
|
|
.I NOTE:
|
|
Since libavcodec is faster than Xvid you might want to use the libavcodec
|
|
postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
|
|
.sp 1
|
|
Xvid's internal postprocessing filters:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "deblock-chroma (also see \-vf pp)"
|
|
chroma deblock filter
|
|
.IPs "deblock-luma (also see \-vf pp)"
|
|
luma deblock filter
|
|
.IPs "dering-luma (also see \-vf pp)"
|
|
luma deringing filter
|
|
.IPs "dering-chroma (also see \-vf pp)"
|
|
chroma deringing filter
|
|
.IPs "filmeffect (also see \-vf noise)"
|
|
Adds artificial film grain to the video.
|
|
May increase perceived quality, while lowering true quality.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
rendering methods:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs "dr2\ \ "
|
|
Activate direct rendering method 2.
|
|
.IPs nodr2
|
|
Deactivate direct rendering method 2.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-xy <value> (also see \-zoom)
|
|
.PD 0
|
|
.RSs
|
|
.IPs value<=8
|
|
Scale image by factor <value>.
|
|
.IPs value>8
|
|
Set width to value and calculate height to keep correct aspect ratio.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B \-y <y> (also see \-zoom)
|
|
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.
|
|
.
|
|
.
|
|
.
|
|
.SH "AUDIO FILTERS"
|
|
Audio filters allow you to modify the audio stream and its properties.
|
|
The syntax is:
|
|
.
|
|
.TP
|
|
.B \-af <filter1[=parameter1:parameter2:...],filter2,...>
|
|
Setup a chain of audio filters.
|
|
.PP
|
|
.I NOTE:
|
|
To get a full list of available audio filters, see \-af help.
|
|
.sp 1
|
|
Audio filters are managed in lists.
|
|
There are a few commands to manage the filter list.
|
|
.
|
|
.TP
|
|
.B \-af\-add <filter1[,filter2,...]>
|
|
Appends the filters given as arguments to the filter list.
|
|
.
|
|
.TP
|
|
.B \-af\-pre <filter1[,filter2,...]>
|
|
Prepends the filters given as arguments to the filter list.
|
|
.
|
|
.TP
|
|
.B \-af\-del <index1[,index2,...]>
|
|
Deletes the filters at the given indexes.
|
|
Index numbers start at 0, negative numbers address the end of the
|
|
list (\-1 is the last).
|
|
.
|
|
.TP
|
|
.B \-af\-clr
|
|
Completely empties the filter list.
|
|
.PP
|
|
Available filters are:
|
|
.
|
|
.TP
|
|
.B resample[=srate[:sloppy[:type]]]
|
|
Changes the sample rate of the audio stream.
|
|
Can be used if you have a fixed frequency sound card or if you are
|
|
stuck with an old sound card that is only capable of max 44.1kHz.
|
|
This filter is automatically enabled if necessary.
|
|
It only supports 16-bit integer and float in native-endian format as input.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <srate>
|
|
output sample frequency in Hz.
|
|
The valid range for this parameter is 8000 to 192000.
|
|
If the input and output sample frequency are the same or if this
|
|
parameter is omitted the filter is automatically unloaded.
|
|
A high sample frequency normally improves the audio quality,
|
|
especially when used in combination with other filters.
|
|
.IPs <sloppy>
|
|
Allow (1) or disallow (0) the output frequency to differ slightly
|
|
from the frequency given by <srate> (default: 1).
|
|
Can be used if the startup of the playback is extremely slow.
|
|
.IPs <type>
|
|
Select which resampling method to use.
|
|
.RSss
|
|
0: linear interpolation (fast, poor quality especially when upsampling)
|
|
.br
|
|
1: polyphase filterbank and integer processing
|
|
.br
|
|
2: polyphase filterbank and floating point processing (slow, best quality)
|
|
.REss
|
|
.PD 1
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs "mplayer \-af resample=44100:0:0"
|
|
would set the output frequency of the resample filter to 44100Hz using
|
|
exact output frequency scaling and linear interpolation.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
|
|
Changes the sample rate of the audio stream to an integer <srate> in Hz.
|
|
It only supports the 16-bit native-endian format.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <srate>
|
|
the output sample rate
|
|
.IPs <length>
|
|
length of the filter with respect to the lower sampling rate (default: 16)
|
|
.IPs <linear>
|
|
if 1 then filters will be linearly interpolated between polyphase entries
|
|
.IPs <count>
|
|
log2 of the number of polyphase entries
|
|
(..., 10->1024, 11->2048, 12->4096, ...)
|
|
(default: 10->1024)
|
|
.IPs <cutoff>
|
|
cutoff frequency (0.0\-1.0), default set depending upon filter length
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B lavcac3enc[=tospdif[:bitrate[:minchn]]]
|
|
Encode multi-channel audio to AC-3 at runtime using libavcodec.
|
|
Supports 16-bit native-endian input format, maximum 6 channels.
|
|
The output is big-endian when outputting a raw AC-3 stream,
|
|
native-endian when outputting to S/PDIF.
|
|
The output sample rate of this filter is same with the input sample rate.
|
|
When input sample rate is 48kHz, 44.1kHz, or 32kHz, this filter directly use it.
|
|
Otherwise a resampling filter is auto-inserted before this filter to make
|
|
the input and output sample rate be 48kHz.
|
|
You need to specify '\-channels N' to make the decoder decode audio into
|
|
N-channel, then the filter can encode the N-channel input to AC-3.
|
|
.br
|
|
.PD 0
|
|
.RSs
|
|
.IPs <tospdif>
|
|
Output raw AC-3 stream if zero or not set,
|
|
output to S/PDIF for passthrough when <tospdif> is set non-zero.
|
|
.IPs <bitrate>
|
|
The bitrate to encode the AC-3 stream.
|
|
Set it to either 384 or 384000 to get 384kbits.
|
|
Valid values: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256,
|
|
320, 384, 448, 512, 576, 640
|
|
Default bitrate is based on the input channel number:
|
|
1ch: 96, 2ch: 192, 3ch: 224, 4ch: 384, 5ch: 448, 6ch: 448
|
|
.IPs <minchn>
|
|
If the input channel number is less than <minchn>, the filter will
|
|
detach itself (default: 5).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B sweep[=speed]
|
|
Produces a sine sweep.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <0.0\-1.0>
|
|
Sine function delta, use very low values to hear the sweep.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B sinesuppress[=freq:decay]
|
|
Remove a sine at the specified frequency.
|
|
Useful to get rid of the 50/60Hz noise on low quality audio equipment.
|
|
It probably only works on mono input.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <freq>
|
|
The frequency of the sine which should be removed (in Hz) (default: 50)
|
|
.IPs <decay>
|
|
Controls the adaptivity (a larger value will make the filter adapt to
|
|
amplitude and phase changes quicker, a smaller value will make the
|
|
adaptation slower) (default: 0.0001).
|
|
Reasonable values are around 0.001.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B bs2b[=option1:option2:...]
|
|
Bauer stereophonic to binaural transformation using libbs2b.
|
|
Improves the headphone listening experience by making the sound
|
|
similar to that from loudspeakers, allowing each ear to hear both
|
|
channels and taking into account the distance difference and the
|
|
head shadowing effect.
|
|
It is applicable only to 2 channel audio.
|
|
.PD 0
|
|
.RSs
|
|
.IPs fcut=<300\-1000>
|
|
Set cut frequency in Hz.
|
|
.IPs feed=<10\-150>
|
|
Set feed level for low frequencies in 0.1*dB.
|
|
.IPs profile=<value>
|
|
Several profiles are available for convenience:
|
|
.PD 0
|
|
.RSs
|
|
.IPs default
|
|
will be used if nothing else was specified (fcut=700, feed=45)
|
|
.IPs "cmoy\ "
|
|
Chu Moy circuit implementation (fcut=700, feed=60)
|
|
.IPs jmeier
|
|
Jan Meier circuit implementation (fcut=650, feed=95)
|
|
.RE
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
If fcut or feed options are specified together with a profile, they
|
|
will be applied on top of the selected profile.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B hrtf[=flag]
|
|
Head-related transfer function: Converts multichannel audio to
|
|
2 channel output for headphones, preserving the spatiality of the sound.
|
|
.sp 1
|
|
.PD 0
|
|
.RS
|
|
.IPs "Flag Meaning"
|
|
.IPs "m matrix decoding of the rear channel"
|
|
.IPs "s 2-channel matrix decoding"
|
|
.IPs "0 no matrix decoding (default)"
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B equalizer=[g1:g2:g3:...:g10]
|
|
10 octave band graphic equalizer, implemented using 10 IIR band pass filters.
|
|
This means that it works regardless of what type of audio is being played back.
|
|
The center frequencies for the 10 bands are:
|
|
.sp 1
|
|
.PD 0
|
|
.RS
|
|
.IPs "No. frequency"
|
|
.IPs "0 31.25 Hz"
|
|
.IPs "1 62.50 Hz"
|
|
.IPs "2 125.00 Hz"
|
|
.IPs "3 250.00 Hz"
|
|
.IPs "4 500.00 Hz"
|
|
.IPs "5 1.00 kHz"
|
|
.IPs "6 2.00 kHz"
|
|
.IPs "7 4.00 kHz"
|
|
.IPs "8 8.00 kHz"
|
|
.IPs "9 16.00 kHz"
|
|
.RE
|
|
.PD 1
|
|
.sp 1
|
|
.RS
|
|
If the sample rate of the sound being played is lower than the center
|
|
frequency for a frequency band, then that band will be disabled.
|
|
A known bug with this filter is that the characteristics for the
|
|
uppermost band are not completely symmetric if the sample
|
|
rate is close to the center frequency of that band.
|
|
This problem can be worked around by upsampling the sound
|
|
using the resample filter before it reaches this filter.
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs <g1>:<g2>:<g3>:...:<g10>
|
|
floating point numbers representing the gain in dB
|
|
for each frequency band (\-12\-12)
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af equalizer=11:11:10:5:0:\-12:0:5:12:12 media.avi"
|
|
Would amplify the sound in the upper and lower frequency region
|
|
while canceling it almost completely around 1kHz.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...]
|
|
Can be used for adding, removing, routing and copying audio channels.
|
|
If only <nch> is given the default routing is used, it works as
|
|
follows: If the number of output channels is bigger than the number of
|
|
input channels empty channels are inserted (except mixing from mono to
|
|
stereo, then the mono channel is repeated in both of the output
|
|
channels).
|
|
If the number of output channels is smaller than the number
|
|
of input channels the exceeding channels are truncated.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <nch>
|
|
number of output channels (1\-8)
|
|
.IPs "<nr>\ "
|
|
number of routes (1\-8)
|
|
.IPs <from1:to1:from2:to2:from3:to3:...>
|
|
Pairs of numbers between 0 and 7 that define where to route each channel.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi"
|
|
Would change the number of channels to 4 and set up 4 routes that
|
|
swap channel 0 and channel 1 and leave channel 2 and 3 intact.
|
|
Observe that if media containing two channels was played back, channels
|
|
2 and 3 would contain silence but 0 and 1 would still be swapped.
|
|
.IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi"
|
|
Would change the number of channels to 6 and set up 4 routes
|
|
that copy channel 0 to channels 0 to 3.
|
|
Channel 4 and 5 will contain silence.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B format[=format] (also see \-format)
|
|
Convert between different sample formats.
|
|
Automatically enabled when needed by the sound card or another filter.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <format>
|
|
Sets the desired format.
|
|
The general form is 'sbe', where 's' denotes the sign (either 's' for signed
|
|
or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
|
|
and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
|
|
and 'ne' the endianness of the computer MPlayer is running on).
|
|
Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
|
|
Exceptions to this rule that are also valid format specifiers: u8, s8,
|
|
floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B volume[=v[:sc]]
|
|
Implements software volume control.
|
|
Use this filter with caution since it can reduce the signal
|
|
to noise ratio of the sound.
|
|
In most cases it is best to set the level for the PCM sound to max,
|
|
leave this filter out and control the output level to your
|
|
speakers with the master volume control of the mixer.
|
|
In case your sound card has a digital PCM mixer instead of an analog
|
|
one, and you hear distortion, use the MASTER mixer instead.
|
|
If there is an external amplifier connected to the computer (this
|
|
is almost always the case), the noise level can be minimized by
|
|
adjusting the master level and the volume knob on the amplifier
|
|
until the hissing noise in the background is gone.
|
|
.br
|
|
This filter has a second feature: It measures the overall maximum
|
|
sound level and prints out that level when MPlayer exits.
|
|
This feature currently only works with floating-point data,
|
|
use e.g. \-af\-adv force=5, or use \-af stats.
|
|
.br
|
|
.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.
|
|
.br
|
|
.I WARNING:
|
|
This feature creates distortion and should be considered a last resort.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af volume=10.1:0 media.avi"
|
|
Would amplify the sound by 10.1dB and hard-clip if the
|
|
sound level is too high.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...]
|
|
Mixes channels arbitrarily.
|
|
Basically a combination of the volume and the channels filter
|
|
that can be used to down-mix many channels to only a few,
|
|
e.g.\& stereo to mono or vary the "width" of the center
|
|
speaker in a surround sound system.
|
|
This filter is hard to use, and will require some tinkering
|
|
before the desired result is obtained.
|
|
The number of options for this filter depends on
|
|
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\-8)
|
|
.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
|
|
etc.
|
|
If you do not specify any numbers for some input channels, 0 is assumed.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af pan=1:0.5:0.5 media.avi"
|
|
Would down-mix from stereo to mono.
|
|
.IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi"
|
|
Would give 3 channel output leaving channels 0 and 1 intact,
|
|
and mix channels 0 and 1 into output channel 2 (which could
|
|
be sent to a subwoofer for example).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B sub[=fc:ch]
|
|
Adds a subwoofer channel to the audio stream.
|
|
The audio data used for creating the subwoofer channel is
|
|
an average of the sound in channel 0 and channel 1.
|
|
The resulting sound is then low-pass filtered by a 4th order
|
|
Butterworth filter with a default cutoff frequency of 60Hz
|
|
and added to a separate channel in the audio stream.
|
|
.br
|
|
.I Warning:
|
|
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 7 (default: 5).
|
|
Observe that the number of channels will automatically
|
|
be increased to <ch> if necessary.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af sub=100:4 \-channels 5 media.avi"
|
|
Would add a sub-woofer channel with a cutoff frequency of
|
|
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 7 (default: 5).
|
|
Observe that the number of channels will automatically
|
|
be increased to <ch> if necessary.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B surround[=delay]
|
|
Decoder for matrix encoded surround sound like Dolby Surround.
|
|
Many files with 2 channel audio actually contain matrixed surround sound.
|
|
Requires a sound card supporting at least 4 channels.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <delay>
|
|
delay time in ms for the rear speakers (0 to 1000) (default: 20)
|
|
This delay should be set as follows: If d1 is the distance
|
|
from the listening position to the front speakers and d2 is the distance
|
|
from the listening position to the rear speakers, then the delay should
|
|
be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af surround=15 \-channels 4 media.avi"
|
|
Would add surround sound decoding with 15ms delay for the sound to the
|
|
rear speakers.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B delay[=ch1:ch2:...]
|
|
Delays the sound to the loudspeakers such that the sound from the
|
|
different channels arrives at the listening position simultaneously.
|
|
It is only useful if you have more than 2 loudspeakers.
|
|
.PD 0
|
|
.RSs
|
|
.IPs ch1,ch2,...
|
|
The delay in ms that should be imposed on each channel
|
|
(floating point number between 0 and 1000).
|
|
.RE
|
|
.PD 1
|
|
.sp 1
|
|
.RS
|
|
To calculate the required delay for the different channels do as follows:
|
|
.IP 1. 3
|
|
Measure the distance to the loudspeakers in meters in relation
|
|
to your listening position, giving you the distances s1 to s5
|
|
(for a 5.1 system).
|
|
There is no point in compensating for the subwoofer (you will not hear the
|
|
difference anyway).
|
|
.IP 2. 3
|
|
Subtract the distances s1 to s5 from the maximum distance,
|
|
i.e.\& s[i] = max(s) \- s[i]; i = 1...5.
|
|
.IP 3.
|
|
Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5.
|
|
.RE
|
|
.PD 0
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi"
|
|
Would delay front left and right by 10.5ms, the two rear channels
|
|
and the sub by 0ms and the center channel by 7ms.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B export[=mmapped_file[:nsamples]]
|
|
Exports the incoming signal to other processes using memory mapping (mmap()).
|
|
Memory mapped areas contain a header:
|
|
.sp 1
|
|
.nf
|
|
int nch /*number of channels*/
|
|
int size /*buffer size*/
|
|
unsigned long long counter /*Used to keep sync, updated every
|
|
time new data is exported.*/
|
|
.fi
|
|
.sp 1
|
|
The rest is payload (non-interleaved) 16 bit data.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <mmapped_file>
|
|
file to map data to (default: ~/.mplayer/\:mplayer-af_export)
|
|
.IPs <nsamples>
|
|
number of samples per channel (default: 512)
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi"
|
|
Would export 1024 samples per channel to '/tmp/mplayer-af_export'.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B extrastereo[=mul]
|
|
(Linearly) increases the difference between left and right channels
|
|
which adds some sort of "live" effect to playback.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <mul>
|
|
Sets the difference coefficient (default: 2.5).
|
|
0.0 means mono sound (average of both channels), with 1.0 sound will be
|
|
unchanged, with \-1.0 left and right channels will be swapped.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B volnorm[=method:target]
|
|
Maximizes the volume without distorting the sound.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <method>
|
|
Sets the used method.
|
|
.RSss
|
|
1: Use a single sample to smooth the variations via the standard
|
|
weighted mean over past samples (default).
|
|
.br
|
|
2: Use several samples to smooth the variations via the standard
|
|
weighted mean over past samples.
|
|
.REss
|
|
.IPs <target>
|
|
Sets the target amplitude as a fraction of the maximum for the
|
|
sample type (default: 0.25).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B ladspa=file:label[:controls...]
|
|
Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
|
|
This filter is reentrant, so multiple LADSPA plugins can be used at once.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <file>
|
|
Specifies the LADSPA plugin library file.
|
|
If LADSPA_PATH is set, it searches for the specified file.
|
|
If it is not set, you must supply a fully specified pathname.
|
|
.IPs <label>
|
|
Specifies the filter within the library.
|
|
Some libraries contain only one filter, but others contain many of them.
|
|
Entering 'help' here, will list all available filters within the specified
|
|
library, which eliminates the use of 'listplugins' from the LADSPA SDK.
|
|
.IPs <controls>
|
|
Controls are zero or more floating point values that determine the
|
|
behavior of the loaded plugin (for example delay, threshold or gain).
|
|
In verbose mode (add \-v to the MPlayer command line), all available controls
|
|
and their valid ranges are printed.
|
|
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
|
|
Simple voice removal filter exploiting the fact that voice is
|
|
usually recorded with mono gear and later 'center' mixed onto
|
|
the final audio stream.
|
|
Beware that this filter will turn your signal into mono.
|
|
Works well for 2 channel tracks; do not bother trying it
|
|
on anything but 2 channel stereo.
|
|
.
|
|
.TP
|
|
.B scaletempo[=option1:option2:...]
|
|
Scales audio tempo without altering pitch, optionally synced to playback
|
|
speed (default).
|
|
.br
|
|
This works by playing \'stride\' ms of audio at normal speed then
|
|
consuming \'stride*scale\' ms of input audio.
|
|
It pieces the strides together by blending \'overlap\'% of stride with
|
|
audio following the previous stride.
|
|
It optionally performs a short statistical analysis on the next \'search\'
|
|
ms of audio to determine the best overlap position.
|
|
.PD 0
|
|
.RSs
|
|
.IPs scale=<amount>
|
|
Nominal amount to scale tempo.
|
|
Scales this amount in addition to speed.
|
|
(default: 1.0)
|
|
.IPs stride=<amount>
|
|
Length in milliseconds to output each stride.
|
|
Too high of value will cause noticable skips at high scale amounts and
|
|
an echo at low scale amounts.
|
|
Very low values will alter pitch.
|
|
Increasing improves performance.
|
|
(default: 60)
|
|
.IPs overlap=<percent>
|
|
Percentage of stride to overlap.
|
|
Decreasing improves performance.
|
|
(default: .20)
|
|
.IPs search=<amount>
|
|
Length in milliseconds to search for best overlap position.
|
|
Decreasing improves performance greatly.
|
|
On slow systems, you will probably want to set this very low.
|
|
(default: 14)
|
|
.IPs speed=<tempo|pitch|both|none>
|
|
Set response to speed change.
|
|
.RSss
|
|
.IPs tempo
|
|
Scale tempo in sync with speed (default).
|
|
.IPs pitch
|
|
Reverses effect of filter.
|
|
Scales pitch without altering tempo.
|
|
Add \'[ speed_mult 0.9438743126816935\' and \'] speed_mult 1.059463094352953\'
|
|
to your input.conf to step by musical semi-tones.
|
|
.I WARNING:
|
|
Loses sync with video.
|
|
.IPs both
|
|
Scale both tempo and pitch.
|
|
.IPs none
|
|
Ignore speed changes.
|
|
.RE
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.RSs
|
|
.IPs "mplayer \-af scaletempo \-speed 1.2 media.ogg"
|
|
Would playback media at 1.2x normal speed, with audio at normal pitch.
|
|
Changing playback speed, would change audio tempo to match.
|
|
.IPs "mplayer \-af scaletempo=scale=1.2:speed=none \-speed 1.2 media.ogg"
|
|
Would playback media at 1.2x normal speed, with audio at normal pitch,
|
|
but changing playback speed has no effect on audio tempo.
|
|
.IPs "mplayer \-af scaletempo=stride=30:overlap=.50:search=10 media.ogg"
|
|
Would tweak the quality and performace parameters.
|
|
.IPs "mplayer \-af format=floatne,scaletempo media.ogg"
|
|
Would make scaletempo use float code.
|
|
Maybe faster on some platforms.
|
|
.IPs "mplayer \-af scaletempo=scale=1.2:speed=pitch audio.ogg"
|
|
Would playback audio file at 1.2x normal speed, with audio at normal pitch.
|
|
Changing playback speed, would change pitch, leaving audio tempo at 1.2x.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B "stats\ \ "
|
|
Collects and prints statistics about the audio stream, especially the volume.
|
|
These statistics are especially intended to help adjusting the volume while
|
|
avoiding clipping.
|
|
The volumes are printed in dB and compatible with the volume audio filter.
|
|
.
|
|
.
|
|
.
|
|
.SH "VIDEO FILTERS"
|
|
Video filters allow you to modify the video stream and its properties.
|
|
The syntax is:
|
|
.
|
|
.TP
|
|
.B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
|
|
Setup a chain of video filters.
|
|
.PP
|
|
Many parameters are optional and set to default values if omitted.
|
|
To explicitly use a default value set a parameter to '\-1'.
|
|
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 video filters, see \-vf help.
|
|
.sp 1
|
|
Video 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.
|
|
.
|
|
.TP
|
|
.B \-vf\-pre <filter1[,filter2,...]>
|
|
Prepends the filters given as arguments to the filter list.
|
|
.
|
|
.TP
|
|
.B \-vf\-del <index1[,index2,...]>
|
|
Deletes the filters at the given indexes.
|
|
Index numbers start at 0, negative numbers address the end of the
|
|
list (\-1 is the last).
|
|
.
|
|
.TP
|
|
.B \-vf\-clr
|
|
Completely empties the filter list.
|
|
.PP
|
|
With filters that support it, you can access parameters by their name.
|
|
.
|
|
.TP
|
|
.B \-vf <filter>=help
|
|
Prints the parameter names and parameter value ranges for a particular
|
|
filter.
|
|
.
|
|
.TP
|
|
.B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
|
|
Sets a named parameter to the given value.
|
|
Use on and off or yes and no to set flag parameters.
|
|
.PP
|
|
Available filters are:
|
|
.
|
|
.TP
|
|
.B crop[=w:h:x:y]
|
|
Crops the given part of the image and discards the rest.
|
|
Useful to remove black bands from widescreen movies.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <w>,<h>
|
|
Cropped width and height, defaults to original width and height.
|
|
.IPs <x>,<y>
|
|
Position of the cropped picture, defaults to center.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B cropdetect[=limit:round[:reset]]
|
|
Calculates necessary cropping parameters and prints the recommended parameters
|
|
to stdout.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <limit>
|
|
Threshold, which can be optionally specified from nothing (0) to
|
|
everything (255) (default: 24).
|
|
.br
|
|
.IPs <round>
|
|
Value which the width/\:height should be divisible by (default: 16).
|
|
The offset is automatically adjusted to center the video.
|
|
Use 2 to get only even dimensions (needed for 4:2:2 video).
|
|
16 is best when encoding to most video codecs.
|
|
.br
|
|
.IPs <reset>
|
|
Counter that determines after how many frames cropdetect will reset the
|
|
previously detected largest video area and start over to detect the current
|
|
optimal crop area (default: 0).
|
|
This can be useful when channel logos distort the video area.
|
|
0 indicates never reset and return the largest area encountered during playback.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B rectangle[=w:h:x:y]
|
|
Draws a rectangle of the requested width and height at the specified
|
|
coordinates over the image and prints current rectangle parameters
|
|
to the console.
|
|
This can be used to find optimal cropping parameters.
|
|
If you bind the input.conf directive 'change_rectangle' to keystrokes,
|
|
you can move and resize the rectangle on the fly.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <w>,<h>
|
|
width and height (default: \-1, maximum possible width where boundaries
|
|
are still visible.)
|
|
.IPs <x>,<y>
|
|
top left corner position (default: \-1, uppermost leftmost)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B expand[=w:h:x:y:o:a:r]
|
|
Expands (not scales) movie resolution to the given value and places the
|
|
unscaled original at coordinates x, y.
|
|
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.
|
|
.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.
|
|
For values between 4\-7 rotation is only done if the movie geometry is
|
|
portrait and not landscape.
|
|
.RSs
|
|
.IPs 0
|
|
Rotate by 90 degrees clockwise and flip (default).
|
|
.IPs 1
|
|
Rotate by 90 degrees clockwise.
|
|
.IPs 2
|
|
Rotate by 90 degrees counterclockwise.
|
|
.IPs 3
|
|
Rotate by 90 degrees counterclockwise and flip.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B scale[=w:h[:interlaced[:chr_drop[:par[:par2[:presize[:noup[:arnd]]]]]]]]
|
|
Scales the image with the software scaler (slow) and performs a YUV<\->RGB
|
|
colorspace conversion (also see \-sws).
|
|
.RSs
|
|
.IPs <w>,<h>
|
|
scaled width/\:height (default: original width/\:height)
|
|
.br
|
|
.I NOTE:
|
|
If \-zoom is used, and underlying filters (including libvo) are
|
|
incapable of scaling, it defaults to d_width/\:d_height!
|
|
.RSss
|
|
0: scaled d_width/\:d_height
|
|
.br
|
|
\-1: original width/\:height
|
|
.br
|
|
\-2: Calculate w/h using the other dimension and the prescaled aspect ratio.
|
|
.br
|
|
\-3: Calculate w/h using the other dimension and the original aspect ratio.
|
|
.br
|
|
\-(n+8): Like \-n above, but rounding the dimension to the closest multiple of 16.
|
|
.REss
|
|
.IPs <interlaced>
|
|
Toggle interlaced scaling.
|
|
.RSss
|
|
0: off (default)
|
|
.br
|
|
1: on
|
|
.REss
|
|
.IPs <chr_drop>
|
|
chroma skipping
|
|
.RSss
|
|
0: Use all available input lines for chroma.
|
|
.br
|
|
1: Use only every 2. input line for chroma.
|
|
.br
|
|
2: Use only every 4. input line for chroma.
|
|
.br
|
|
3: Use only every 8. input line for chroma.
|
|
.REss
|
|
.IPs "<par>[:<par2>] (also see \-sws)"
|
|
Set some scaling parameters depending on the type of scaler selected
|
|
with \-sws.
|
|
.RSss
|
|
\-sws 2 (bicubic): B (blurring) and C (ringing)
|
|
.br
|
|
0.00:0.60 default
|
|
.br
|
|
0.00:0.75 VirtualDub's "precise bicubic"
|
|
.br
|
|
0.00:0.50 Catmull-Rom spline
|
|
.br
|
|
0.33:0.33 Mitchell-Netravali spline
|
|
.br
|
|
1.00:0.00 cubic B-spline
|
|
.br
|
|
\-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp))
|
|
.br
|
|
\-sws 9 (lanczos): filter length (1\-10)
|
|
.REss
|
|
.IPs <presize>
|
|
Scale to preset sizes.
|
|
.RSss
|
|
qntsc: 352x240 (NTSC quarter screen)
|
|
.br
|
|
qpal: 352x288 (PAL quarter screen)
|
|
.br
|
|
ntsc: 720x480 (standard NTSC)
|
|
.br
|
|
pal: 720x576 (standard PAL)
|
|
.br
|
|
sntsc: 640x480 (square pixel NTSC)
|
|
.br
|
|
spal: 768x576 (square pixel PAL)
|
|
.REss
|
|
.IPs <noup>
|
|
Disallow upscaling past the original dimensions.
|
|
.RSss
|
|
0: Allow upscaling (default).
|
|
.br
|
|
1: Disallow upscaling if one dimension exceeds its original value.
|
|
.br
|
|
2: Disallow upscaling if both dimensions exceed their original values.
|
|
.REss
|
|
.IPs <arnd>
|
|
Accurate rounding for the vertical scaler, which may be faster
|
|
or slower than the default rounding.
|
|
.RSss
|
|
0: Disable accurate rounding (default).
|
|
.br
|
|
1: Enable accurate rounding.
|
|
.REss
|
|
.RE
|
|
.
|
|
.TP
|
|
.B dsize[=aspect|w:h:aspect-method:r]
|
|
Changes the intended display size/\:aspect at an arbitrary point in the
|
|
filter chain.
|
|
Aspect can be given as a fraction (4/3) or floating point number
|
|
(1.33).
|
|
Alternatively, you may specify the exact display width and height
|
|
desired.
|
|
Note that this filter does
|
|
.B not
|
|
do any scaling itself; it just affects
|
|
what later scalers (software or hardware) will do when auto-scaling to
|
|
correct aspect.
|
|
.RSs
|
|
.IPs <w>,<h>
|
|
New display width and height.
|
|
Can also be these special values:
|
|
.RSss
|
|
0: original display width and height
|
|
.br
|
|
\-1: original video width and height (default)
|
|
.br
|
|
\-2: Calculate w/h using the other dimension and the original display
|
|
aspect ratio.
|
|
.br
|
|
\-3: Calculate w/h using the other dimension and the original video
|
|
aspect ratio.
|
|
.REss
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IP dsize=800:\-2
|
|
Specifies a display resolution of 800x600 for a 4/3 aspect video, or
|
|
800x450 for a 16/9 aspect video.
|
|
.RE
|
|
.IPs <aspect-method>
|
|
Modifies width and height according to original aspect ratios.
|
|
.RSss
|
|
\-1: Ignore original aspect ratio (default).
|
|
.br
|
|
0: Keep display aspect ratio by using <w> and <h> as maximum
|
|
resolution.
|
|
.br
|
|
1: Keep display aspect ratio by using <w> and <h> as minimum
|
|
resolution.
|
|
.br
|
|
2: Keep video aspect ratio by using <w> and <h> as maximum
|
|
resolution.
|
|
.br
|
|
3: Keep video aspect ratio by using <w> and <h> as minimum
|
|
resolution.
|
|
.REss
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.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 "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 palette
|
|
RGB/BGR 8 \-> 15/16/24/32bpp colorspace conversion using palette.
|
|
.
|
|
.TP
|
|
.B format[=fourcc[:outfourcc]]
|
|
Restricts the colorspace for the next filter without doing any conversion.
|
|
Use together with the scale filter for a real conversion.
|
|
.br
|
|
.I NOTE:
|
|
For a list of available formats see format=fmt=help.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <fourcc>
|
|
format name like rgb15, bgr24, yv12, etc (default: yuy2)
|
|
.IPs <outfourcc>
|
|
Format name that should be substituted for the output.
|
|
If this is not 100% compatible with the <fourcc> value it will crash.
|
|
.br
|
|
Valid examples:
|
|
.br
|
|
format=rgb24:bgr24 format=yuyv:yuy2
|
|
.br
|
|
Invalid examples (will crash):
|
|
.br
|
|
format=rgb24:yv12
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B noformat[=fourcc]
|
|
Restricts the colorspace for the next filter without doing any conversion.
|
|
Unlike the format filter, this will allow any colorspace
|
|
.B except
|
|
the one you specify.
|
|
.br
|
|
.I NOTE:
|
|
For a list of available formats see noformat=fmt=help.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <fourcc>
|
|
format name like rgb15, bgr24, yv12, etc (default: yv12)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B pp[=filter1[:option1[:option2...]]/[\-]filter2...] (also see \-pphelp)
|
|
Enables the specified chain of postprocessing subfilters.
|
|
Subfilters must be separated by '/' and can be disabled by
|
|
prepending a '\-'.
|
|
Each subfilter and some options have a short and a long name that can be
|
|
used interchangeably, i.e.\& dr/dering are the same.
|
|
All subfilters share common options to determine their scope:
|
|
.PD 0
|
|
.RSs
|
|
.IPs a/autoq
|
|
Automatically switch the subfilter off if the CPU is too slow.
|
|
.IPs c/chrom
|
|
Do chrominance filtering, too (default).
|
|
.IPs y/nochrom
|
|
Do luminance filtering only (no chrominance).
|
|
.IPs n/noluma
|
|
Do chrominance filtering only (no luminance).
|
|
.RE
|
|
.PD 1
|
|
.sp 1
|
|
.RS
|
|
.br
|
|
.I NOTE:
|
|
\-pphelp shows a list of available subfilters.
|
|
.sp 1
|
|
Available subfilters are
|
|
.RE
|
|
.RSs
|
|
.IPs hb/hdeblock[:difference[:flatness]]
|
|
horizontal deblocking filter
|
|
.RSss
|
|
<difference>: Difference factor where higher values mean
|
|
more deblocking (default: 32).
|
|
.br
|
|
<flatness>: Flatness threshold where lower values mean
|
|
more deblocking (default: 39).
|
|
.REss
|
|
.IPs vb/vdeblock[:difference[:flatness]]
|
|
vertical deblocking filter
|
|
.RSss
|
|
<difference>: Difference factor where higher values mean
|
|
more deblocking (default: 32).
|
|
.br
|
|
<flatness>: Flatness threshold where lower values mean
|
|
more deblocking (default: 39).
|
|
.REss
|
|
.IPs ha/hadeblock[:difference[:flatness]]
|
|
accurate horizontal deblocking filter
|
|
.RSss
|
|
<difference>: Difference factor where higher values mean
|
|
more deblocking (default: 32).
|
|
.br
|
|
<flatness>: Flatness threshold where lower values mean
|
|
more deblocking (default: 39).
|
|
.REss
|
|
.IPs va/vadeblock[:difference[:flatness]]
|
|
accurate vertical deblocking filter
|
|
.RSss
|
|
<difference>: Difference factor where higher values mean
|
|
more deblocking (default: 32).
|
|
.br
|
|
<flatness>: Flatness threshold where lower values mean
|
|
more deblocking (default: 39).
|
|
.REss
|
|
.sp 1
|
|
The horizontal and vertical deblocking filters share the
|
|
difference and flatness values so you cannot set
|
|
different horizontal and vertical thresholds.
|
|
.sp 1
|
|
.IPs h1/x1hdeblock
|
|
experimental horizontal deblocking filter
|
|
.IPs v1/x1vdeblock
|
|
experimental vertical deblocking filter
|
|
.IPs dr/dering
|
|
deringing filter
|
|
.IPs tn/tmpnoise[:threshold1[:threshold2[:threshold3]]]
|
|
temporal noise reducer
|
|
.RSss
|
|
<threshold1>: larger -> stronger filtering
|
|
.br
|
|
<threshold2>: larger -> stronger filtering
|
|
.br
|
|
<threshold3>: larger -> stronger filtering
|
|
.REss
|
|
.IPs al/autolevels[:f/fullyrange]
|
|
automatic brightness / contrast correction
|
|
.RSss
|
|
f/fullyrange: Stretch luminance to (0\-255).
|
|
.REss
|
|
.IPs lb/linblenddeint
|
|
Linear blend deinterlacing filter that deinterlaces the given block
|
|
by filtering all lines with a (1 2 1) filter.
|
|
.IPs li/linipoldeint
|
|
Linear interpolating deinterlacing filter that deinterlaces the given block
|
|
by linearly interpolating every second line.
|
|
.IPs ci/cubicipoldeint
|
|
Cubic interpolating deinterlacing filter deinterlaces the given block
|
|
by cubically interpolating every second line.
|
|
.IPs md/mediandeint
|
|
Median deinterlacing filter that deinterlaces the given block
|
|
by applying a median filter to every second line.
|
|
.IPs fd/ffmpegdeint
|
|
FFmpeg deinterlacing filter that deinterlaces the given block
|
|
by filtering every second line with a (\-1 4 2 4 \-1) filter.
|
|
.IPs l5/lowpass5
|
|
Vertically applied FIR lowpass deinterlacing filter that deinterlaces
|
|
the given block by filtering all lines with a (\-1 2 6 2 \-1) filter.
|
|
.IPs fq/forceQuant[:quantizer]
|
|
Overrides the quantizer table from the input with the constant
|
|
quantizer you specify.
|
|
.RSss
|
|
<quantizer>: quantizer to use
|
|
.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:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-vf pp=hb/vb/dr/al"
|
|
horizontal and vertical deblocking, deringing and automatic
|
|
brightness/\:contrast
|
|
.IPs "\-vf pp=de/\-al"
|
|
default filters without brightness/\:contrast correction
|
|
.IPs "\-vf pp=default/tmpnoise:1:2:3"
|
|
Enable default filters & temporal denoiser.
|
|
.IPs "\-vf pp=hb:y/vb:a"
|
|
Horizontal deblocking on luminance only, and switch vertical deblocking
|
|
on or off automatically depending on available CPU time.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B spp[=quality[:qp[:mode]]]
|
|
Simple postprocessing filter that compresses and decompresses the
|
|
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)
|
|
.br
|
|
4: like 0, but also use B-frames' QP (may cause flicker)
|
|
.br
|
|
5: like 1, but also use B-frames' QP (may cause flicker)
|
|
.RE
|
|
.
|
|
.TP
|
|
.B uspp[=quality[:qp]]
|
|
Ultra simple & slow postprocessing filter that compresses and
|
|
decompresses the image at several (or \- in the case of quality
|
|
level 8 \- all) shifts and averages the results.
|
|
The way this differs from the behavior of spp is that uspp actually
|
|
encodes & decodes each case with libavcodec Snow, 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 <bframes>
|
|
0: do not use QP from B-frames (default)
|
|
.br
|
|
1: use QP from B-frames too (may cause flicker)
|
|
.RE
|
|
.
|
|
.TP
|
|
.B pp7[=qp[:mode]]
|
|
Variant of the spp filter, similar to spp=6 with 7 point DCT where
|
|
only the center sample is used after IDCT.
|
|
.RSs
|
|
.IPs "<qp>\ "
|
|
Force quantization parameter (default: 0, use QP from video).
|
|
.IPs <mode>
|
|
0: hard thresholding
|
|
.br
|
|
1: soft thresholding (better deringing, but blurrier)
|
|
.br
|
|
2: medium thresholding (default, good results)
|
|
.RE
|
|
.
|
|
.TP
|
|
.B qp=equation
|
|
quantization parameter (QP) change filter
|
|
.RSs
|
|
.IPs <equation>
|
|
some equation like "2+2*sin(PI*qp)"
|
|
.RE
|
|
.
|
|
.TP
|
|
.B geq=equation
|
|
generic equation change filter
|
|
.RSs
|
|
.IPs <equation>
|
|
Some equation, e.g.\& 'p(W-X\\,Y)' to flip the image horizontally.
|
|
You can use whitespace to make the equation more readable.
|
|
There are a couple of constants that can be used in the equation:
|
|
.RSss
|
|
PI: the number pi
|
|
.br
|
|
E: the number e
|
|
.br
|
|
X / Y: the coordinates of the current sample
|
|
.br
|
|
W / H: width and height of the image
|
|
.br
|
|
SW / SH: width/height scale depending on the currently filtered plane, e.g.\&
|
|
1,1 and 0.5,0.5 for YUV 4:2:0.
|
|
.br
|
|
p(x,y): returns the value of the pixel at location x/y of the current plane.
|
|
.REss
|
|
.RE
|
|
.
|
|
.TP
|
|
.B "test\ \ \ "
|
|
Generate various test patterns.
|
|
.
|
|
.TP
|
|
.B rgbtest[=width:height]
|
|
Generate an RGB test pattern useful for detecting RGB vs BGR issues.
|
|
You should see a red, green and blue stripe from top to bottom.
|
|
.RSs
|
|
.IPs <width>
|
|
Desired width of generated image (default: 0).
|
|
0 means width of input image.
|
|
.br
|
|
.IPs <height>
|
|
Desired height of generated image (default: 0).
|
|
0 means height of input image.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B lavc[=quality:fps]
|
|
Fast software YV12 to MPEG-1 conversion with libavcodec for use with DVB/\:DXR3/\:IVTV/\:V4L2.
|
|
.RSs
|
|
.IPs <quality>
|
|
1\-31: fixed qscale
|
|
.br
|
|
32\-: fixed bitrate in kbits
|
|
.IPs <fps>
|
|
force output fps (float value) (default: 0, autodetect based on height)
|
|
.RE
|
|
.
|
|
.TP
|
|
.B dvbscale[=aspect]
|
|
Set up optimal scaling for DVB cards, scaling the x axis in hardware and
|
|
calculating the y axis scaling in software to keep aspect.
|
|
Only useful together with expand and scale.
|
|
.RSs
|
|
.IPs <aspect>
|
|
Control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
|
|
576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-vf dvbscale,scale=\-1:0,expand=\-1:576:\-1:\-1:1,lavc"
|
|
FIXME: Explain what this does.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
|
|
Adds noise.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <0\-100>
|
|
luma noise
|
|
.IPs <0\-100>
|
|
chroma noise
|
|
.IPs u
|
|
uniform noise (gaussian otherwise)
|
|
.IPs t
|
|
temporal noise (noise pattern changes between frames)
|
|
.IPs a
|
|
averaged temporal noise (smoother, but a lot slower)
|
|
.IPs h
|
|
high quality (slightly better looking, slightly slower)
|
|
.IPs p
|
|
mix random noise with a (semi)regular pattern
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B denoise3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
|
|
This filter aims to reduce image noise producing smooth images and making still
|
|
images really still (This should enhance compressibility.).
|
|
.PD 0
|
|
.RSs
|
|
.IPs <luma_spatial>
|
|
spatial luma strength (default: 4)
|
|
.IPs <chroma_spatial>
|
|
spatial chroma strength (default: 3)
|
|
.IPs <luma_tmp>
|
|
luma temporal strength (default: 6)
|
|
.IPs <chroma_tmp>
|
|
chroma temporal strength (default: luma_tmp*chroma_spatial/luma_spatial)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B hqdn3d[=luma_spatial:chroma_spatial:luma_tmp:chroma_tmp]
|
|
High precision/\:quality version of the denoise3d filter.
|
|
Parameters and usage are the same.
|
|
.
|
|
.TP
|
|
.B ow[=depth[:luma_strength[:chroma_strength]]]
|
|
Overcomplete Wavelet denoiser.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <depth>
|
|
Larger depth values will denoise lower frequency components more, but
|
|
slow down filtering (default: 8).
|
|
.IPs <luma_strength>
|
|
luma strength (default: 1.0)
|
|
.IPs <chroma_strength>
|
|
chroma strength (default: 1.0)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B eq[=brightness:contrast] (OBSOLETE)
|
|
Software equalizer with interactive controls just like the hardware
|
|
equalizer, for cards/\:drivers that do not support brightness and
|
|
contrast controls in hardware.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <\-100\-100>
|
|
initial brightness
|
|
.IPs <\-100\-100>
|
|
initial contrast
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
|
|
Alternative software equalizer that uses lookup tables (very slow),
|
|
allowing gamma correction in addition to simple brightness
|
|
and contrast adjustment.
|
|
Note that it uses the same MMX optimized code as \-vf eq if all
|
|
gamma values are 1.0.
|
|
The parameters are given as floating point values.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <0.1\-10>
|
|
initial gamma value (default: 1.0)
|
|
.IPs <\-2\-2>
|
|
initial contrast, where negative values result in a
|
|
negative image (default: 1.0)
|
|
.IPs <\-1\-1>
|
|
initial brightness (default: 0.0)
|
|
.IPs <0\-3>
|
|
initial saturation (default: 1.0)
|
|
.IPs <0.1\-10>
|
|
gamma value for the red component (default: 1.0)
|
|
.IPs <0.1\-10>
|
|
gamma value for the green component (default: 1.0)
|
|
.IPs <0.1\-10>
|
|
gamma value for the blue component (default: 1.0)
|
|
.IPs <0\-1>
|
|
The weight parameter can be used to reduce the effect of a high gamma value on
|
|
bright image areas, e.g.\& keep them from getting overamplified and just plain
|
|
white.
|
|
A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it
|
|
at its full strength (default: 1.0).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B hue[=hue:saturation]
|
|
Software equalizer with interactive controls just like the hardware
|
|
equalizer, for cards/\:drivers that do not support hue and
|
|
saturation controls in hardware.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <\-180\-180>
|
|
initial hue (default: 0.0)
|
|
.IPs <\-100\-100>
|
|
initial saturation, where negative values result
|
|
in a negative chroma (default: 1.0)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B halfpack[=f]
|
|
Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
|
|
keeping all chroma samples.
|
|
Useful for output to low-resolution display devices when hardware downscaling
|
|
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
|
|
1: Only use odd lines when downsampling.
|
|
.REss
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B ilpack[=mode]
|
|
When interlaced video is stored in YUV 4:2:0 formats, chroma
|
|
interlacing does not line up properly due to vertical downsampling of
|
|
the chroma channels.
|
|
This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
|
|
the chroma lines in their proper locations, so that in any given
|
|
scanline, the luma and chroma data both come from the same field.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <mode>
|
|
Select the sampling mode.
|
|
.RSss
|
|
0: nearest-neighbor sampling, fast but incorrect
|
|
.br
|
|
1: linear interpolation (default)
|
|
.REss
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B decimate[=max:hi:lo:frac]
|
|
Drops frames that do not differ greatly from the previous frame in
|
|
order to reduce framerate.
|
|
The main use of this filter is for very-low-bitrate encoding (e.g.\&
|
|
streaming over dialup modem), but it could in theory be used for
|
|
fixing movies that were inverse-telecined incorrectly.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <max>
|
|
Sets the maximum number of consecutive frames which can be
|
|
dropped (if positive), or the minimum interval between
|
|
dropped frames (if negative).
|
|
.IPs <hi>,<lo>,<frac>
|
|
A frame is a candidate for dropping if no 8x8 region differs by more
|
|
than a threshold of <hi>, and if not more than <frac> portion (1
|
|
meaning the whole image) differs by more than a threshold of <lo>.
|
|
Values of <hi> and <lo> are for 8x8 pixel blocks and represent actual
|
|
pixel value differences, so a threshold of 64 corresponds to 1 unit of
|
|
difference for each pixel, or the same spread out differently over the
|
|
block.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B dint[=sense:level]
|
|
The drop-deinterlace (dint) filter detects and drops the first from a set
|
|
of interlaced video frames.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <0.0\-1.0>
|
|
relative difference between neighboring pixels (default: 0.1)
|
|
.IPs <0.0\-1.0>
|
|
What part of the image has to be detected as interlaced to
|
|
drop the frame (default: 0.15).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B lavcdeint (OBSOLETE)
|
|
FFmpeg deinterlacing filter, same as \-vf pp=fd
|
|
.
|
|
.TP
|
|
.B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
|
|
Donald Graft's adaptive kernel deinterlacer.
|
|
Deinterlaces parts of a video if a configurable threshold is exceeded.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <0\-255>
|
|
threshold (default: 10)
|
|
.IPs <map>
|
|
.RSss
|
|
0: Ignore pixels exceeding the threshold (default).
|
|
.br
|
|
1: Paint pixels exceeding the threshold white.
|
|
.REss
|
|
.IPs <order>
|
|
.RSss
|
|
0: Leave fields alone (default).
|
|
.br
|
|
1: Swap fields.
|
|
.REss
|
|
.IPs <sharp>
|
|
.RSss
|
|
0: Disable additional sharpening (default).
|
|
.br
|
|
1: Enable additional sharpening.
|
|
.REss
|
|
.IPs <twoway>
|
|
.RSss
|
|
0: Disable twoway sharpening (default).
|
|
.br
|
|
1: Enable twoway sharpening.
|
|
.REss
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.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
|
|
Relative amount of sharpness/\:blur to add to the image
|
|
(a sane range should be \-1.5\-1.5).
|
|
.RSss
|
|
<0: blur
|
|
.br
|
|
>0: sharpen
|
|
.REss
|
|
.RE
|
|
.
|
|
.TP
|
|
.B "swapuv\ "
|
|
Swap U & V plane.
|
|
.
|
|
.TP
|
|
.B il[=d|i][s][:[d|i][s]]
|
|
(De)interleaves lines.
|
|
The goal of this filter is to add the ability to process interlaced images
|
|
pre-field without deinterlacing them.
|
|
You can filter your interlaced DVD and play it on a TV without breaking the
|
|
interlacing.
|
|
While deinterlacing (with the postprocessing filter) removes interlacing
|
|
permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
|
|
2 fields (so called half pictures), so you can process (filter) them
|
|
independently and then re-interleave them.
|
|
.PD 0
|
|
.RSs
|
|
.IPs d
|
|
deinterleave (placing one above the other)
|
|
.IPs i
|
|
interleave
|
|
.IPs s
|
|
swap fields (exchange even & odd lines)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B fil[=i|d]
|
|
(De)interleaves lines.
|
|
This filter is very similar to the il filter but much faster, the main
|
|
disadvantage is that it does not always work.
|
|
Especially if combined with other filters it may produce randomly messed
|
|
up images, so be happy if it works but do not complain if it does not for
|
|
your combination of filters.
|
|
.PD 0
|
|
.RSs
|
|
.IPs d
|
|
Deinterleave fields, placing them side by side.
|
|
.IPs i
|
|
Interleave fields again (reversing the effect of fil=d).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B field[=n]
|
|
Extracts a single field from an interlaced image using stride arithmetic
|
|
to avoid wasting CPU time.
|
|
The optional argument n specifies whether to extract the even or the odd
|
|
field (depending on whether n is even or odd).
|
|
.
|
|
.TP
|
|
.B detc[=var1=value1:var2=value2:...]
|
|
Attempts to reverse the 'telecine' process to recover a clean,
|
|
non-interlaced stream at film framerate.
|
|
This was the first and most primitive inverse telecine filter to be
|
|
added to MPlayer.
|
|
It works by latching onto the telecine 3:2 pattern and following it as
|
|
long as possible.
|
|
This makes it suitable for perfectly-telecined material, even in the
|
|
presence of a fair degree of noise, but it will fail in the presence
|
|
of complex post-telecine edits.
|
|
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
|
|
merges in the past 5 frames.
|
|
.br
|
|
2: Always maintain exact 5:4 input to output frame ratio.
|
|
.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
|
|
frame before the movie starts.
|
|
.IPs "<t0>, <t1>, <t2>, <t3>"
|
|
Threshold values to be used in certain modes.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B ivtc[=1]
|
|
Experimental 'stateless' inverse telecine filter.
|
|
Rather than trying to lock on to a pattern like the detc filter does,
|
|
ivtc makes its decisions independently for each frame.
|
|
This will give much better results for material that has undergone
|
|
heavy editing after telecine was applied, but as a result it is not as
|
|
forgiving of noisy input, for example TV capture.
|
|
The optional parameter (ivtc=1) corresponds to the dr=1 option for the
|
|
detc filter, and should not be used with MPlayer.
|
|
Further development on ivtc has stopped, as the pullup and filmdint
|
|
filters appear to be much more accurate.
|
|
.
|
|
.TP
|
|
.B pullup[=jl:jr:jt:jb:sb:mp]
|
|
Third-generation pulldown reversal (inverse telecine) filter,
|
|
capable of handling mixed hard-telecine, 24000/1001 fps progressive, and 30000/1001
|
|
fps progressive content.
|
|
The pullup filter is designed to be much more robust than detc or
|
|
ivtc, by taking advantage of future context in making its decisions.
|
|
Like ivtc, pullup is stateless in the sense that it does not lock onto
|
|
a pattern to follow, but it instead looks forward to the following
|
|
fields in order to identify matches and rebuild progressive frames.
|
|
It is still under development, but believed to be quite accurate.
|
|
.RSs
|
|
.IPs "jl, jr, jt, and jb"
|
|
These options set the amount of "junk" to ignore at
|
|
the left, right, top, and bottom of the image, respectively.
|
|
Left/\:right are in units of 8 pixels, while top/\:bottom are in units of
|
|
2 lines.
|
|
The default is 8 pixels on each side.
|
|
.br
|
|
.IPs "sb (strict breaks)"
|
|
Setting this option to 1 will reduce the chances of
|
|
pullup generating an occasional mismatched frame, but it may also
|
|
cause an excessive number of frames to be dropped during high motion
|
|
sequences.
|
|
Conversely, setting it to \-1 will make pullup match fields more
|
|
easily.
|
|
This may help processing of video where there is slight blurring
|
|
between the fields, but may also cause there to be interlaced frames
|
|
in the output.
|
|
.br
|
|
.IPs "mp (metric plane)"
|
|
This option may be set to 1 or 2 to use a chroma
|
|
plane instead of the luma plane for doing pullup's computations.
|
|
This may improve accuracy on very clean source material, but more
|
|
likely will decrease accuracy, especially if there is chroma noise
|
|
(rainbow effect) or any grayscale video.
|
|
The main purpose of setting mp to a chroma plane is to reduce CPU load
|
|
and make pullup usable in realtime on slow machines.
|
|
.REss
|
|
.
|
|
.TP
|
|
.B filmdint[=options]
|
|
Inverse telecine filter, similar to the pullup filter above.
|
|
It is designed to handle any pulldown pattern, including mixed soft and
|
|
hard telecine and limited support for movies that are slowed down or sped
|
|
up from their original framerate for TV.
|
|
Only the luma plane is used to find the frame breaks.
|
|
If a field has no match, it is deinterlaced with simple linear
|
|
approximation.
|
|
If the source is MPEG-2, this must be the first filter to allow
|
|
access to the field-flags set by the MPEG-2 decoder.
|
|
Depending on the source MPEG, you may be fine ignoring this advice, as
|
|
long as you do not see lots of "Bottom-first field" warnings.
|
|
With no options it does normal inverse telecine.
|
|
When this filter is used with MPlayer, it will result in an uneven
|
|
framerate during playback, but it is still generally better than using
|
|
pp=lb or no deinterlacing at all.
|
|
Multiple options can be specified separated by /.
|
|
.RSs
|
|
.IPs crop=<w>:<h>:<x>:<y>
|
|
Just like the crop filter, but faster, and works on mixed hard and soft
|
|
telecined content as well as when y is not a multiple of 4.
|
|
If x or y would require cropping fractional pixels from the chroma
|
|
planes, the crop area is extended.
|
|
This usually means that x and y must be even.
|
|
.IPs io=<ifps>:<ofps>
|
|
For each ifps input frames the filter will output ofps frames.
|
|
This could be used to filter movies that are broadcast on TV at a frame
|
|
rate different from their original framerate.
|
|
.IPs luma_only=<n>
|
|
If n is nonzero, the chroma plane is copied unchanged.
|
|
This is useful for YV12 sampled TV, which discards one of the chroma
|
|
fields.
|
|
.IPs mmx2=<n>
|
|
On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
|
|
optimized functions, otherwise, use plain C.
|
|
If this option is not specified, MMX2 and 3DNow! are auto-detected, use
|
|
this option to override auto-detection.
|
|
.IPs fast=<n>
|
|
The larger n will speed up the filter at the expense of accuracy.
|
|
The default value is n=3.
|
|
If n is odd, a frame immediately following a frame marked with the
|
|
REPEAT_FIRST_FIELD MPEG flag is assumed to be progressive, thus filter
|
|
will not spend any time on soft-telecined MPEG-2 content.
|
|
This is the only effect of this flag if MMX2 or 3DNow! is available.
|
|
Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used
|
|
as with n=2 or 3.
|
|
If n=2 or 3, the number of luma levels used to find the frame breaks is
|
|
reduced from 256 to 128, which results in a faster filter without losing
|
|
much accuracy.
|
|
If n=4 or 5, a faster, but much less accurate metric will be used to
|
|
find the frame breaks, which is more likely to misdetect high vertical
|
|
detail as interlaced content.
|
|
.IPs verbose=<n>
|
|
If n is nonzero, print the detailed metrics for each frame.
|
|
Useful for debugging.
|
|
.IPs dint_thres=<n>
|
|
Deinterlace threshold.
|
|
Used during de-interlacing of unmatched frames.
|
|
Larger value means less deinterlacing, use n=256 to completely turn off
|
|
deinterlacing.
|
|
Default is n=8.
|
|
.IPs comb_thres=<n>
|
|
Threshold for comparing a top and bottom fields.
|
|
Defaults to 128.
|
|
.IPs diff_thres=<n>
|
|
Threshold to detect temporal change of a field.
|
|
Default is 128.
|
|
.IPs sad_thres=<n>
|
|
Sum of Absolute Difference threshold, default is 64.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B divtc[=options]
|
|
Inverse telecine for deinterlaced video.
|
|
If 3:2-pulldown telecined video has lost one of the fields or is deinterlaced
|
|
using a method that keeps one field and interpolates the other, the result is
|
|
a juddering video that has every fourth frame duplicated.
|
|
This filter is intended to find and drop those duplicates and restore the
|
|
original film framerate.
|
|
Two different modes are available:
|
|
One pass mode is the default and is straightforward to use,
|
|
but has the disadvantage that any changes in the telecine
|
|
phase (lost frames or bad edits) cause momentary judder
|
|
until the filter can resync again.
|
|
Two pass mode avoids this by analyzing the whole video
|
|
beforehand so it will have forward knowledge about the
|
|
phase changes and can resync at the exact spot.
|
|
These passes do
|
|
.B not
|
|
correspond to pass one and two of the encoding process.
|
|
You must run an extra pass using divtc pass one before the
|
|
actual encoding throwing the resulting video away.
|
|
Use \-nosound \-ovc raw \-o /dev/null to avoid
|
|
wasting CPU power for this pass.
|
|
You may add something like crop=2:2:0:0 after divtc
|
|
to speed things up even more.
|
|
Then use divtc pass two for the actual encoding.
|
|
If you use multiple encoder passes, use divtc
|
|
pass two for all of them.
|
|
The options are:
|
|
.RSs
|
|
.IPs pass=1|2
|
|
Use two pass mode.
|
|
.IPs file=<filename>
|
|
Set the two pass log filename (default: "framediff.log").
|
|
.IPs threshold=<value>
|
|
Set the minimum strength the telecine pattern must have for the filter to
|
|
believe in it (default: 0.5).
|
|
This is used to avoid recognizing false pattern from the parts of the video
|
|
that are very dark or very still.
|
|
.IPs window=<numframes>
|
|
Set the number of past frames to look at when searching for pattern
|
|
(default: 30).
|
|
Longer window improves the reliability of the pattern search, but shorter
|
|
window improves the reaction time to the changes in the telecine phase.
|
|
This only affects the one pass mode.
|
|
The two pass mode currently uses fixed window that extends to both future
|
|
and past.
|
|
.IPs phase=0|1|2|3|4
|
|
Sets the initial telecine phase for one pass mode (default: 0).
|
|
The two pass mode can see the future, so it is able to use the correct
|
|
phase from the beginning, but one pass mode can only guess.
|
|
It catches the correct phase when it finds it, but this option can be used
|
|
to fix the possible juddering at the beginning.
|
|
The first pass of the two pass mode also uses this, so if you save the output
|
|
from the first pass, you get constant phase result.
|
|
.IPs deghost=<value>
|
|
Set the deghosting threshold (0\-255 for one pass mode, \-255\-255 for two pass
|
|
mode, default 0).
|
|
If nonzero, deghosting mode is used.
|
|
This is for video that has been deinterlaced by blending the fields
|
|
together instead of dropping one of the fields.
|
|
Deghosting amplifies any compression artifacts in the blended frames, so the
|
|
parameter value is used as a threshold to exclude those pixels from
|
|
deghosting that differ from the previous frame less than specified value.
|
|
If two pass mode is used, then negative value can be used to make the
|
|
filter analyze the whole video in the beginning of pass-2 to determine
|
|
whether it needs deghosting or not and then select either zero or the
|
|
absolute value of the parameter.
|
|
Specify this option for pass-2, it makes no difference on pass-1.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B phase[=t|b|p|a|u|T|B|A|U][:v]
|
|
Delay interlaced video by one field time so that the field order
|
|
changes.
|
|
The intended use is to fix PAL movies that have been captured with the
|
|
opposite field order to the film-to-video transfer.
|
|
The options are:
|
|
.RSs
|
|
.IPs t
|
|
Capture field order top-first, transfer bottom-first.
|
|
Filter will delay the bottom field.
|
|
.IPs b
|
|
Capture bottom-first, transfer top-first.
|
|
Filter will delay the top field.
|
|
.IPs p
|
|
Capture and transfer with the same field order.
|
|
This mode only exists for the documentation of the other options to refer to,
|
|
but if you actually select it, the filter will faithfully do nothing ;-)
|
|
.IPs a
|
|
Capture field order determined automatically by field flags, transfer opposite.
|
|
Filter selects among t and b modes on a frame by frame basis using field flags.
|
|
If no field information is available, then this works just like u.
|
|
.IPs u
|
|
Capture unknown or varying, transfer opposite.
|
|
Filter selects among t and b on a frame by frame basis by analyzing the
|
|
images and selecting the alternative that produces best match between the
|
|
fields.
|
|
.IPs T
|
|
Capture top-first, transfer unknown or varying.
|
|
Filter selects among t and p using image analysis.
|
|
.IPs B
|
|
Capture bottom-first, transfer unknown or varying.
|
|
Filter selects among b and p using image analysis.
|
|
.IPs A
|
|
Capture determined by field flags, transfer unknown or varying.
|
|
Filter selects among t, b and p using field flags and image analysis.
|
|
If no field information is available, then this works just like U.
|
|
This is the default mode.
|
|
.IPs U
|
|
Both capture and transfer unknown or varying.
|
|
Filter selects among t, b and p using image analysis only.
|
|
.IPs v
|
|
Verbose operation.
|
|
Prints the selected mode for each frame and the average squared difference
|
|
between fields for t, b, and p alternatives.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B telecine[=start]
|
|
Apply 3:2 'telecine' process to increase framerate by 20%.
|
|
This most likely will not work correctly with MPlayer.
|
|
The optional start parameter tells the filter where in the telecine
|
|
pattern to start (0\-3).
|
|
.
|
|
.TP
|
|
.B tinterlace[=mode]
|
|
Temporal field interlacing \- merge pairs of frames into an interlaced
|
|
frame, halving the framerate.
|
|
Even frames are moved into the upper field, odd frames to the lower field.
|
|
This can be used to fully reverse the effect of the tfields filter (in mode 0).
|
|
Available modes are:
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
Move odd frames into the upper field, even into the lower field, generating
|
|
a full-height frame at half framerate.
|
|
.IPs 1
|
|
Only output odd frames, even frames are dropped; height unchanged.
|
|
.IPs 2
|
|
Only output even frames, odd frames are dropped; height unchanged.
|
|
.IPs 3
|
|
Expand each frame to full height, but pad alternate lines with black;
|
|
framerate unchanged.
|
|
.IPs 4
|
|
Interleave even lines from even frames with odd lines from odd frames.
|
|
Height unchanged at half framerate.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B tfields[=mode[:field_dominance]]
|
|
Temporal field separation \- split fields into frames, doubling the
|
|
output framerate.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <mode>
|
|
0: Leave fields unchanged (will jump/\:flicker).
|
|
.br
|
|
1: Interpolate missing lines. (The algorithm used might not be so good.)
|
|
.br
|
|
2: Translate fields by 1/4 pixel with linear interpolation (no jump).
|
|
.br
|
|
4: Translate fields by 1/4 pixel with 4tap filter (higher quality) (default).
|
|
.IPs <field_dominance>\ (DEPRECATED)
|
|
\-1: auto (default)
|
|
Only works if the decoder exports the appropriate information and
|
|
no other filters which discard that information come before tfields
|
|
in the filter chain, otherwise it falls back to 0 (top field first).
|
|
.br
|
|
0: top field first
|
|
.br
|
|
1: bottom field first
|
|
.br
|
|
.I NOTE:
|
|
This option will possibly be removed in a future version.
|
|
Use \-field\-dominance instead.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B yadif=[mode[:field_dominance]]
|
|
Yet another deinterlacing filter
|
|
.PD 0
|
|
.RSs
|
|
.IPs <mode>
|
|
0: Output 1 frame for each frame.
|
|
.br
|
|
1: Output 1 frame for each field.
|
|
.br
|
|
2: Like 0 but skips spatial interlacing check.
|
|
.br
|
|
3: Like 1 but skips spatial interlacing check.
|
|
.IPs <field_dominance>\ (DEPRECATED)
|
|
Operates like tfields.
|
|
.br
|
|
.I NOTE:
|
|
This option will possibly be removed in a future version.
|
|
Use \-field\-dominance instead.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B mcdeint=[mode[:parity[:qp]]]
|
|
Motion compensating deinterlacer.
|
|
It needs one field per frame as input and must thus be used together
|
|
with tfields=1 or yadif=1/3 or equivalent.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <mode>
|
|
0: fast
|
|
.br
|
|
1: medium
|
|
.br
|
|
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
|
|
.
|
|
.TP
|
|
.B boxblur=radius:power[:radius:power]
|
|
box blur
|
|
.PD 0
|
|
.RSs
|
|
.IPs <radius>
|
|
blur filter strength
|
|
.IPs <power>
|
|
number of filter applications
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B sab=radius:pf:colorDiff[:radius:pf:colorDiff]
|
|
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
|
|
.
|
|
.TP
|
|
.B smartblur=radius:strength:threshold[:radius:strength:threshold]
|
|
smart blur
|
|
.PD 0
|
|
.RSs
|
|
.IPs <radius>
|
|
blur filter strength (~0.1\-5.0) (slower if larger)
|
|
.IPs <strength>
|
|
blur (0.0\-1.0) or sharpen (\-1.0\-0.0)
|
|
.IPs <threshold>
|
|
filter all (0), filter flat areas (0\-30) or filter edges (\-30\-0)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
|
|
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.
|
|
Extracts both stereo fields and places them side by side, resizing
|
|
them to maintain the original movie aspect.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <lines>
|
|
number of lines to select from the middle of the image (default: 12)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B bmovl=hidden:opaque:fifo
|
|
The bitmap overlay filter reads bitmaps from a FIFO and displays them
|
|
on top of the movie, allowing some transformations on the image.
|
|
Also see TOOLS/bmovl-test.c for a small bmovl test program.
|
|
.PD 0
|
|
.RSs
|
|
.IPs <hidden>
|
|
Set the default value of the 'hidden' flag (0=visible, 1=hidden).
|
|
.IPs <opaque>
|
|
Set the default value of the 'opaque' flag (0=transparent, 1=opaque).
|
|
.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
|
|
.IPs "RGBA32 width height xpos ypos alpha clear"
|
|
followed by width*height*4 Bytes of raw RGBA32 data.
|
|
.IPs "ABGR32 width height xpos ypos alpha clear"
|
|
followed by width*height*4 Bytes of raw ABGR32 data.
|
|
.IPs "RGB24 width height xpos ypos alpha clear"
|
|
followed by width*height*3 Bytes of raw RGB24 data.
|
|
.IPs "BGR24 width height xpos ypos alpha clear"
|
|
followed by width*height*3 Bytes of raw BGR24 data.
|
|
.IPs "ALPHA width height xpos ypos alpha"
|
|
Change alpha transparency of the specified area.
|
|
.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
|
|
Arguments are:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs "<width>, <height>"
|
|
image/area size
|
|
.IPs "<xpos>, <ypos>"
|
|
Start blitting at position x/y.
|
|
.IPs <alpha>
|
|
Set alpha difference.
|
|
If you set this to \-255 you can then send a sequence of ALPHA-commands to set
|
|
the area to \-225, \-200, \-175 etc for a nice fade-in-effect! ;)
|
|
.RSss
|
|
0: same as original
|
|
.br
|
|
255: Make everything opaque.
|
|
.br
|
|
\-255: Make everything transparent.
|
|
.REss
|
|
.IPs <clear>
|
|
Clear the framebuffer before blitting.
|
|
.RSss
|
|
0: The image will just be blitted on top of the old one, so you do not need to
|
|
send 1.8MB of RGBA32 data every time a small part of the screen is updated.
|
|
.br
|
|
1: clear
|
|
.REss
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B framestep=I|[i]step
|
|
Renders only every nth frame or every intra frame (keyframe).
|
|
.sp 1
|
|
If you call the filter with I (uppercase) as the parameter, then
|
|
.B 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.
|
|
.sp 1
|
|
When a keyframe is found, an 'I!' string followed by a newline character is
|
|
printed, leaving the current line of MPlayer 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=xtiles:ytiles:output:start:delta
|
|
Tile a series of images into a single, bigger image.
|
|
If you omit a parameter or use a value less than 0, then the default
|
|
value is used.
|
|
You can also stop when you are satisfied (... \-vf tile=10:5 ...).
|
|
It is probably a good idea to put the scale filter before the tile :-)
|
|
.sp 1
|
|
The parameters are:
|
|
.sp 1
|
|
.PD 0
|
|
.RSs
|
|
.IPs <xtiles>
|
|
number of tiles on the x axis (default: 5)
|
|
.IPs <ytiles>
|
|
number of tiles on the y axis (default: 5)
|
|
.IPs <output>
|
|
Render the tile when 'output' number of frames are reached, where 'output'
|
|
should be a number less than xtile * ytile.
|
|
Missing tiles are left blank.
|
|
You could, for example, write an 8 * 7 tile every 50 frames to have one
|
|
image every 2 seconds @ 25 fps.
|
|
.IPs <start>
|
|
outer border thickness in pixels (default: 2)
|
|
.IPs <delta>
|
|
inner border thickness in pixels (default: 4)
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B delogo[=x:y:w:h:t]
|
|
Suppresses a TV station logo by a simple interpolation of the
|
|
surrounding pixels.
|
|
Just set a rectangle covering the logo and watch it disappear (and
|
|
sometimes something even uglier appear \- your mileage may vary).
|
|
.PD 0
|
|
.RSs
|
|
.IPs <x>,<y>
|
|
top left corner of the logo
|
|
.IPs <w>,<h>
|
|
width and height of the cleared rectangle
|
|
.IPs <t>
|
|
Thickness of the fuzzy edge of the rectangle (added to w and h).
|
|
When set to \-1, a green rectangle is drawn on the screen to
|
|
simplify finding the right x,y,w,h parameters.
|
|
.IPs file=<file>
|
|
You can specify a text file to load the coordinates from.
|
|
Each line must have a timestamp (in seconds, and in ascending order) and the
|
|
"x:y:w:h:t" coordinates (t can be omitted).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B remove\-logo=/path/to/logo_bitmap_file_name.pgm
|
|
Suppresses a TV station logo, using a PGM or PPM image
|
|
file to determine which pixels comprise the logo.
|
|
The width and height of the image file must match
|
|
those of the video stream being processed.
|
|
Uses the filter image and a circular blur
|
|
algorithm to remove the logo.
|
|
.RSs
|
|
.IPs /path/to/logo_bitmap_file_name.pgm
|
|
[path] + filename of the filter image.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B screenshot
|
|
Allows acquiring screenshots of the movie using slave mode
|
|
commands that can be bound to keypresses.
|
|
See the slave mode documentation and the INTERACTIVE CONTROL
|
|
section for details.
|
|
Files named 'shotNNNN.png' will be saved in the working directory,
|
|
using the first available number \- no files will be overwritten.
|
|
The filter has no overhead when not used and accepts an arbitrary
|
|
colorspace, so it is safe to add it to the configuration file.
|
|
Make sure that the screenshot filter is added after all other filters
|
|
whose effect you want to record on the saved image.
|
|
E.g.\& it should be the last filter if you want to have an exact
|
|
screenshot of what you see on the monitor.
|
|
.RE
|
|
.
|
|
.TP
|
|
.B "ass\ \ \ \ "
|
|
Moves SSA/ASS subtitle rendering to an arbitrary point in the filter chain.
|
|
Only useful with the \-ass option.
|
|
.sp 1
|
|
.I EXAMPLE:
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-vf ass,screenshot"
|
|
Moves SSA/ASS rendering before the screenshot filter.
|
|
Screenshots taken this way will contain subtitles.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B blackframe[=amount:threshold]
|
|
Detect frames that are (almost) completely black.
|
|
Can be useful to detect chapter transitions or commercials.
|
|
Output lines consist of the frame number of the detected frame, the
|
|
percentage of blackness, the frame type and the frame number of the last
|
|
encountered keyframe.
|
|
.RSs
|
|
.IPs <amount>
|
|
Percentage of the pixels that have to be below the threshold (default: 98).
|
|
.IPs <threshold>
|
|
Threshold below which a pixel value is considered black (default: 32).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B stereo3d[=in:out]
|
|
Stereo3d converts between different stereoscopic image formats.
|
|
.RSs
|
|
.IPs <in>
|
|
Stereoscopic image format of input. Possible values:
|
|
.RS
|
|
.B sbsl or side_by_side_left_first
|
|
.RS
|
|
side by side parallel (left eye left, right eye right)
|
|
.RE
|
|
.B sbsr or side_by_side_right_first
|
|
.RS
|
|
side by side crosseye (right eye left, left eye right)
|
|
.RE
|
|
.B sbs2l or side_by_side_half_width_left_first
|
|
.RS
|
|
side by side with half width resolution (left eye left, right eye right)
|
|
.RE
|
|
.B sbs2r or side_by_side_half_width_right_first
|
|
.RS
|
|
side by side with half width resolution (right eye left, left eye right)
|
|
.RE
|
|
.B abl or above_below_left_first
|
|
.RS
|
|
above-below (left eye above, right eye below)
|
|
.RE
|
|
.B abl or above_below_right_first
|
|
.RS
|
|
above-below (right eye above, left eye below)
|
|
.RE
|
|
.B ab2l or above_below_half_height_left_first
|
|
.RS
|
|
above-below with half height resolution (left eye above, right eye below)
|
|
.RE
|
|
.B ab2r or above_below_half_height_right_first
|
|
.RS
|
|
above-below with half height resolution (right eye above, left eye below)
|
|
.RE
|
|
.RE
|
|
.IPs <out>
|
|
Stereoscopic image format of output. Possible values are all the input formats
|
|
as well as:
|
|
.RS
|
|
.B arcg or anaglyph_red_cyan_gray
|
|
.RS
|
|
anaglyph red/cyan gray (red filter on left eye, cyan filter on right eye)
|
|
.RE
|
|
.B arch or anaglyph_red_cyan_half_color
|
|
.RS
|
|
anaglyph red/cyan half colored (red filter on left eye, cyan filter on right
|
|
eye)
|
|
.RE
|
|
.B arcc or anaglyph_red_cyan_color
|
|
.RS
|
|
anaglyph red/cyan color (red filter on left eye, cyan filter on right eye)
|
|
.RE
|
|
.B arcd or anaglyph_red_cyan_dubois
|
|
.RS
|
|
anaglyph red/cyan color optimized with the least squares projection of dubois
|
|
(red filter on left eye, cyan filter on right eye)
|
|
.RE
|
|
.B agmg or anaglyph_green_magenta_gray
|
|
.RS
|
|
anaglyph green/magenta gray (green filter on left eye, magenta filter on right
|
|
eye)
|
|
.RE
|
|
.B agmh or anaglyph_green_magenta_half_color
|
|
.RS
|
|
anaglyph green/magenta half colored (green filter on left eye, magenta filter on
|
|
right eye)
|
|
.RE
|
|
.B agmc or anaglyph_green_magenta_color
|
|
.RS
|
|
anaglyph green/magenta colored (green filter on left eye, magenta filter on
|
|
right eye)
|
|
.RE
|
|
.B aybg or anaglyph_yellow_blue_gray
|
|
.RS
|
|
anaglyph yellow/blue gray (yellow filter on left eye, blue filter on right eye)
|
|
.RE
|
|
.B aybh or anaglyph_yellow_blue_half_color
|
|
.RS
|
|
anaglyph yellow/blue half colored (yellow filter on left eye, blue filter on
|
|
right eye)
|
|
.RE
|
|
.B aybc or anaglyph_yellow_blue_color
|
|
.RS
|
|
anaglyph yellow/blue colored (yellow filter on left eye, blue filter on right
|
|
eye)
|
|
.RE
|
|
.B irl or interleave_rows_left_first
|
|
.RS
|
|
Interleaved rows (left eye has top row, right eye starts on next row)
|
|
.RE
|
|
.B irr or interleave_rows_right_first
|
|
.RS
|
|
Interleaved rows (right eye has top row, left eye starts on next row)
|
|
.RE
|
|
.B ml or mono_left
|
|
.RS
|
|
mono output (left eye only)
|
|
.RE
|
|
.B mr or mono_right
|
|
.RS
|
|
mono output (right eye only)
|
|
.RE
|
|
.RE
|
|
.I NOTE:
|
|
To use either of the interleaved-rows output formats to display
|
|
full-screen on a row-interleaved 3D display, you will need to scale the
|
|
video to the correct height first using the "scale" filter, if it is not
|
|
already the right height. Typically, that is 1080 rows (so use e.g.
|
|
"-vf scale=1440:1080,stereo3d=sbsl:irl" for a 720p side-by-side encoded
|
|
movie).
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B gradfun[=strength[:radius]]
|
|
Fix the banding artifacts that are sometimes introduced into nearly flat
|
|
regions by truncation to 8bit colordepth.
|
|
Interpolates the gradients that should go where the bands are, and
|
|
dithers them.
|
|
.sp 1
|
|
This filter is designed for playback only.
|
|
Do not use it prior to lossy compression, because compression tends
|
|
to lose the dither and bring back the bands.
|
|
.RSs
|
|
.IPs <strength>
|
|
Maximum amount by which the filter will change any one pixel.
|
|
Also the threshold for detecting nearly flat regions (default: 1.2).
|
|
.IPs <radius>
|
|
Neighborhood to fit the gradient to.
|
|
Larger radius makes for smoother gradients, but also prevents the filter
|
|
from modifying pixels near detailed regions (default: 16).
|
|
.RE
|
|
.
|
|
.TP
|
|
.B fixpts[=options]
|
|
Fixes the presentation timestamps (PTS) of the frames.
|
|
By default, the PTS passed to the next filter is dropped, but the following
|
|
options can change that:
|
|
.RSs
|
|
.IPs print
|
|
Print the incoming PTS.
|
|
.IPs fps=<fps>
|
|
Specify a frame per second value.
|
|
.IPs start=<pts>
|
|
Specify an initial value for the PTS.
|
|
.IPs autostart=<n>
|
|
Uses the
|
|
.IR n th
|
|
incoming PTS as the initial PTS.
|
|
All previous PTS are kept, so setting a huge value or \-1 keeps the PTS
|
|
intact.
|
|
.IPs autofps=<n>
|
|
Uses the
|
|
.IR n th
|
|
incoming PTS after the end of autostart to determine the framerate.
|
|
.RE
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLE:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs "\-vf fixpts=fps=24000/1001,ass,fixpts"
|
|
Generates a new sequence of PTS, uses it for ASS subtitles, then drops it.
|
|
Generating a new sequence is useful when the timestamps are reset during the
|
|
program; this is frequent on DVDs.
|
|
Dropping it may be necessary to avoid confusing encoders.
|
|
.RE
|
|
.PD 1
|
|
.sp 1
|
|
.RS
|
|
.I NOTE:
|
|
Using this filter together with any sort of seeking (including -ss and EDLs)
|
|
may make demons fly out of your nose.
|
|
.RE
|
|
.
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" environment variables
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH ENVIRONMENT VARIABLES
|
|
.
|
|
There are a number of environment variables that can be used to
|
|
control the behavior of MPlayer.
|
|
.
|
|
.TP
|
|
.B MPLAYER_CHARSET (also see \-msgcharset)
|
|
Convert console messages to the specified charset (default: autodetect).
|
|
A value of "noconv" means no conversion.
|
|
.
|
|
.TP
|
|
.B MPLAYER_HOME
|
|
Directory where MPlayer looks for user settings.
|
|
.
|
|
.TP
|
|
.B MPLAYER_LOCALEDIR
|
|
Directory where MPlayer looks for gettext translation files (if enabled).
|
|
.
|
|
.TP
|
|
.B MPLAYER_VERBOSE (also see \-v and \-msglevel)
|
|
Set the initial verbosity level across all message modules (default: 0).
|
|
The resulting verbosity corresponds to that of \-msglevel 5 plus the
|
|
value of MPLAYER_VERBOSE.
|
|
.
|
|
.SS libaf:
|
|
.
|
|
.TP
|
|
.B LADSPA_PATH
|
|
If LADSPA_PATH is set, it searches for the specified file.
|
|
If it is not set, you must supply a fully specified pathname.
|
|
FIXME: This is also mentioned in the ladspa section.
|
|
.
|
|
.SS libdvdcss:
|
|
.
|
|
.TP
|
|
.B DVDCSS_CACHE
|
|
Specify a directory in which to store title key values.
|
|
This will speed up descrambling of DVDs which are in the cache.
|
|
The DVDCSS_CACHE directory is created if it does not exist,
|
|
and a subdirectory is created named after the DVD's title
|
|
or manufacturing date.
|
|
If DVDCSS_CACHE is not set or is empty, libdvdcss will use
|
|
the default value which is "${HOME}/.dvdcss/" under Unix and
|
|
"C:\\Documents and Settings\\$USER\\Application Data\\dvdcss\\" under Win32.
|
|
The special value "off" disables caching.
|
|
.
|
|
.TP
|
|
.B DVDCSS_METHOD
|
|
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.
|
|
.IPs title
|
|
is the fallback when all other methods have failed.
|
|
It does not rely on a key exchange with the DVD drive, but rather uses
|
|
a crypto attack to guess the title key.
|
|
On rare cases this may fail because there is not enough encrypted data
|
|
on the disc to perform a statistical attack, but in the other hand it
|
|
is the only way to decrypt a DVD stored on a hard disc, or a DVD with
|
|
the wrong region on an RPC2 drive.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B DVDCSS_RAW_DEVICE
|
|
Specify the raw device to use.
|
|
Exact usage will depend on your operating system, the Linux
|
|
utility to set up raw devices is raw(8) for instance.
|
|
Please note that on most operating systems, using a raw device
|
|
requires highly aligned buffers: Linux requires a 2048 bytes
|
|
alignment (which is the size of a DVD sector).
|
|
.
|
|
.TP
|
|
.B DVDCSS_VERBOSE
|
|
Sets the libdvdcss verbosity level.
|
|
.PD 0
|
|
.RSs
|
|
.IPs 0
|
|
Outputs no messages at all.
|
|
.IPs 1
|
|
Outputs error messages to stderr.
|
|
.IPs 2
|
|
Outputs error messages and debug messages to stderr.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B DVDREAD_NOKEYS
|
|
Skip retrieving all keys on startup.
|
|
Currently disabled.
|
|
.
|
|
.TP
|
|
.B HOME
|
|
FIXME: Document this.
|
|
.
|
|
.SS libao2:
|
|
.
|
|
.TP
|
|
.B AO_SUN_DISABLE_SAMPLE_TIMING
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B AUDIODEV
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B AUDIOSERVER
|
|
Specifies the Network Audio System server to which the
|
|
nas audio output driver should connect and the transport
|
|
that should be used.
|
|
If unset DISPLAY is used instead.
|
|
The transport can be one of tcp and unix.
|
|
Syntax is tcp/<somehost>:<someport>, <somehost>:<instancenumber>
|
|
or [unix]:<instancenumber>.
|
|
The NAS base port is 8000 and <instancenumber> is added to that.
|
|
.sp 1
|
|
.RS
|
|
.I EXAMPLES:
|
|
.RE
|
|
.PD 0
|
|
.RSs
|
|
.IPs AUDIOSERVER=somehost:0
|
|
Connect to NAS server on somehost using default port and transport.
|
|
.IPs AUDIOSERVER=tcp/somehost:8000
|
|
Connect to NAS server on somehost listening on TCP port 8000.
|
|
.IPs AUDIOSERVER=(unix)?:0
|
|
Connect to NAS server instance 0 on localhost using unix domain sockets.
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.TP
|
|
.B DISPLAY
|
|
FIXME: Document this.
|
|
.
|
|
.SS osdep:
|
|
.
|
|
.TP
|
|
.B TERM
|
|
FIXME: Document this.
|
|
.
|
|
.SS libvo:
|
|
.
|
|
.TP
|
|
.B DISPLAY
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B FRAMEBUFFER
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B HOME
|
|
FIXME: Document this.
|
|
.
|
|
.SS libmpdemux:
|
|
.
|
|
.TP
|
|
.B HOME
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B HOMEPATH
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B http_proxy
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B LOGNAME
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B USERPROFILE
|
|
FIXME: Document this.
|
|
.
|
|
.SS GUI:
|
|
.
|
|
.TP
|
|
.B CHARSET
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B DISPLAY
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B HOME
|
|
FIXME: Document this.
|
|
.
|
|
.SS libavformat:
|
|
.
|
|
.TP
|
|
.B AUDIO_FLIP_LEFT
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B BKTR_DEV
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B BKTR_FORMAT
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B BKTR_FREQUENCY
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B http_proxy
|
|
FIXME: Document this.
|
|
.
|
|
.TP
|
|
.B no_proxy
|
|
FIXME: Document this.
|
|
.
|
|
.
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Files
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH FILES
|
|
.
|
|
.TP
|
|
/usr/\:local/\:etc/\:mplayer/\:mplayer.conf
|
|
MPlayer system-wide settings
|
|
.
|
|
.TP
|
|
~/.mplayer/\:config
|
|
MPlayer user settings
|
|
.
|
|
.TP
|
|
~/.mplayer/\:input.conf
|
|
input bindings (see '\-input keylist' for the full list)
|
|
.
|
|
.TP
|
|
~/.mplayer/\:font/
|
|
font directory (There must be a font.desc file and files with .RAW extension.)
|
|
.
|
|
.TP
|
|
~/.mplayer/\:DVDkeys/
|
|
cached CSS keys
|
|
.RE
|
|
.PD 1
|
|
.
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Examples
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH EXAMPLES OF MPLAYER USAGE
|
|
.
|
|
.PP
|
|
.B Quickstart Blu\-ray playing:
|
|
.nf
|
|
mplayer br:////path/to/disc
|
|
mplayer br:// \-bluray\-device /path/to/disc
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Quickstart DVD playing:
|
|
.nf
|
|
mplayer dvd://1
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play in Japanese with English subtitles:
|
|
.nf
|
|
mplayer dvd://1 \-alang ja \-slang en
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play only chapters 5, 6, 7:
|
|
.nf
|
|
mplayer dvd://1 \-chapter 5\-7
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play only titles 5, 6, 7:
|
|
.nf
|
|
mplayer dvd://5\-7
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play a multiangle DVD:
|
|
.nf
|
|
mplayer dvd://1 \-dvdangle 2
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play from a different DVD device:
|
|
.nf
|
|
mplayer dvd://1 \-dvd\-device /dev/\:dvd2
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play DVD video from a directory with VOB files:
|
|
.nf
|
|
mplayer dvd://1 \-dvd\-device /path/\:to/\:directory/
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Copy a DVD title to hard disk, saving to file "title1.vob":
|
|
.nf
|
|
mplayer dvd://1 \-dumpstream \-dumpfile title1.vob
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play a DVD with dvdnav from path /dev/sr1:
|
|
.nf
|
|
mplayer dvdnav:////dev/sr1
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Stream from HTTP:
|
|
.nf
|
|
mplayer http://mplayer.hq/example.avi
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Stream using RTSP:
|
|
.nf
|
|
mplayer rtsp://server.example.com/streamName
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Convert subtitles to MPsub format:
|
|
.nf
|
|
mplayer dummy.avi \-sub source.sub \-dumpmpsub
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Convert subtitles to MPsub format without watching the movie:
|
|
.nf
|
|
mplayer /dev/\:zero \-rawvideo pal:fps=xx \-demuxer rawvideo \-vc null \-vo null \-noframedrop \-benchmark \-sub source.sub \-dumpmpsub
|
|
.fi
|
|
.
|
|
.PP
|
|
.B input from standard V4L:
|
|
.nf
|
|
mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv
|
|
.fi
|
|
.
|
|
.PP
|
|
.B Play DTS-CD with passthrough:
|
|
.nf
|
|
mplayer \-ac hwdts \-rawaudio format=0x2001 \-cdrom\-device /dev/cdrom cdda://
|
|
.fi
|
|
.br
|
|
You can also use \-afm hwac3 instead of \-ac hwdts.
|
|
Adjust '/dev/cdrom' to match the CD-ROM device on your system.
|
|
If your external receiver supports decoding raw DTS streams,
|
|
you can directly play it via cdda:// without setting format, hwac3 or hwdts.
|
|
.
|
|
.PP
|
|
.B Play a 6-channel AAC file with only two speakers:
|
|
.nf
|
|
mplayer \-rawaudio format=0xff \-demuxer rawaudio \-af pan=2:.32:.32:.39:.06:.06:.39:.17:-.17:-.17:.17:.33:.33 adts_he-aac160_51.aac
|
|
.fi
|
|
.br
|
|
You might want to play a bit with the pan values (e.g multiply with a value) to
|
|
increase volume or avoid clipping.
|
|
.
|
|
.PP
|
|
.B checkerboard invert with geq filter:
|
|
.nf
|
|
mplayer \-vf geq='128+(p(X\\,Y)\-128)*(0.5\-gt(mod(X/SW\\,128)\\,64))*(0.5\-gt(mod(Y/SH\\,128)\\,64))*4'
|
|
.fi
|
|
.
|
|
.
|
|
.\" --------------------------------------------------------------------------
|
|
.\" Bugs, authors, standard disclaimer
|
|
.\" --------------------------------------------------------------------------
|
|
.
|
|
.SH AUTHORS
|
|
MPlayer was initially written by Arpad Gereoffy.
|
|
See the AUTHORS file for a list of some of the many other contributors.
|
|
.PP
|
|
MPlayer is (C) 2000\-2011 The MPlayer Team
|
|
.PP
|
|
This man page was written mainly by Gabucino, Jonas Jermann and Diego Biurrun.
|
|
.\" end of file
|