[MPlayer-DOCS] CVS: main/DOCS/man/en mplayer.1,1.682,1.683
Diego Biurrun CVS
syncmail at mplayerhq.hu
Sat Aug 28 19:35:35 CEST 2004
CVS change done by Diego Biurrun CVS
Update of /cvsroot/mplayer/main/DOCS/man/en
In directory mail:/var2/tmp/cvs-serv21338/DOCS/man/en
Modified Files:
mplayer.1
Log Message:
Consistently insert lines with only "." between options.
Greatly improves readability.
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v
retrieving revision 1.682
retrieving revision 1.683
diff -u -r1.682 -r1.683
--- mplayer.1 27 Aug 2004 20:43:03 -0000 1.682
+++ mplayer.1 28 Aug 2004 17:35:32 -0000 1.683
@@ -49,12 +49,14 @@
.nh
.B mplayer
.RI [options]\ [ \ file\ | \ URL\ | \ playlist\ | \ \-\ ]
+.
.br
.B mplayer
'in +\n[.k]u
[global options]
.I file1
[specific options] [file2] [specific options]
+.
.br
.in
.B mplayer
@@ -62,70 +64,82 @@
[global options]
.RI { "group of files and options" }
[group specific options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I dvd://[title | [start_title]\-end_title ]
[options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I vcd://track[/device]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I tv://[channel]
[options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I dvb://[card_number@]channel
[options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I mf://filemask
[-mf options] [options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I [cdda|cddb]://track[:speed][/device]
[options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I cue://file[:track]
[options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.RI [ mms[t] | http | http_proxy | rt[s]p | ftp ] ://
[user:passwd@]\fIURL\fP[:port] [options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I sdp://file
[options]
+.
.br
.in
.B mplayer
'in +\n[.k]u
.I mpst://host[:port]/URL
[options]
+.
.br
.in
.B gmplayer
[options]
[\-skin\ skin]
+.
.br
.B mencoder
[options]
@@ -193,6 +207,7 @@
The default configuration file for the input system is
~/.mplayer/\:input.conf but it can be overriden
using the \-input option.
+.
.TP
.B general control
.PD 0
@@ -340,24 +355,28 @@
~/.mplayer or in the same directory as the file.
.
.
+.
.SH "GENERAL OPTIONS"
+.
.TP
.B \-codecs-file <filename>
Use the specified file instead of system wide installed or builtin codecs.conf.
See also \-afm, \-ac, \-vfm and \-vc.
+.
.TP
.B \-include <configuration\ file>
Specify configuration file to be parsed after the default ones.
+.
.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 \-v, \-verbose
Increment verbose level (more \-v means more verbosity).
-.
.PD 0
.RSs
.IPs 0
@@ -374,6 +393,7 @@
.
.
.SH "PLAYER OPTIONS (MPLAYER ONLY)"
+.
.TP
.B \-autoq <quality> (use with \-vf [s]pp)
Dynamically changes the level of postprocessing depending on the available spare
@@ -381,6 +401,7 @@
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.
@@ -397,6 +418,7 @@
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.
@@ -406,23 +428,27 @@
.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 \-colorkey <number>
Changes the colorkey to an RGB value of your choice.
0x000000 is black and 0xffffff is white.
Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
xover video out drivers.
+.
.TP
.B \-nocolorkey
Disables colorkeying.
Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
xover video out drivers.
+.
.TP
.B \-edl <filename> (EDL only)
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 DOCS/\:HTML/\:en/\:edl.html for details on how to use this.
+.
.TP
.B \-edlout <filename> (EDL only)
Creates a new file and writes edit decision list (EDL) records to that file.
@@ -431,10 +457,12 @@
This provides a starting point from which the user can fine-tune EDL entries
later.
See DOCS/\:HTML/\:en/\:edl.html for details.
+.
.TP
.B \-enqueue (GUI only)
Enqueue files given on the command line in the playlist instead of playing them
immediately.
+.
.TP
.B \-fixed-vo (BETA CODE!)
Enforces a fixed video system for multiple files (one (un)initialisation for
@@ -442,23 +470,28 @@
Therefore only one window will be opened for all files.
Currently the following drivers are fixed-vo compliant: gl2, mga, svga, x11,
xmga, xv, xvidix and dfbmga.
+.
.TP
.B \-framedrop (also see \-hardframedrop)
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
More intense frame dropping (breaks decoding).
Leads to image distortion!
+.
.TP
.B \-identify
Show file parameters in an easily parseable format.
The wrapper script TOOLS/\:midentify suppresses the other MPlayer output and
(hopefully) shellescapes the filenames.
+.
.TP
.B \-input <commands>
This option can be used to configure certain parts of the input system.
@@ -497,22 +530,28 @@
.TP
.B \-lircconf <file> (LIRC only)
Specifies a configuration file for LIRC (default: ~/\:.lircrc).
+.
.TP
.B \-list-options
Prints out all the available options.
+.
.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 <file> (OSD menu only)
Use an alternative menu.conf.
+.
.TP
.B \-menu-root <value> (OSD menu only)
Specify the main menu.
+.
.TP
.B \-noconsolecontrols
Prevent MPlayer from reading key events from standard input.
@@ -522,20 +561,25 @@
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 \-nojoystick
Turns off joystick support.
+.
.TP
.B \-nolirc
Turns off LIRC support.
+.
.TP
.B \-nomouseinput (X11 only)
Disable mouse button press/\:release input (mozplayerxp's context menu relies
on this option).
+.
.TP
.B \-nortc (RTC only)
Turns off usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
mechanism.
+.
.TP
.B \-playlist <file>
Play files according to a playlist file (ASX, Winamp, SMIL, or
@@ -546,15 +590,19 @@
only to the elements of this playlist.
.br
FIXME: This needs to be clarified and documented thoroughly.
+.
.TP
.B \-really-quiet (also see \-quiet)
Display even less output and status messages than with \-quiet.
+.
.TP
.B \-rtc-device <device>
Use the specified device for RTC timing.
+.
.TP
.B \-shuffle
Play files in random order.
+.
.TP
.B \-skin <name> (GUI only)
Loads a skin from the directory given as parameter below the default skin
@@ -576,21 +624,26 @@
.br
.I NOTE:
See DOCS/\:tech/\:slave.txt and \-input cmdlist for a list of slave commands.
+.
.TP
.B \-softsleep
Use high-quality software timers instead of the RTC.
As precise as the RTC without requiring special privileges.
Comes at the price of higher CPU consumption.
+.
.TP
.B \-speed <0.01\-100>
Slow down or speed up playback by the factor given as parameter.
+.
.TP
.B \-sstep <sec>
Display one frame every <sec> seconds.
Useful for slideshows.
.
.
+.
.SH "DEMUXER/\:STREAM OPTIONS"
+.
.TP
.B \-a52drc <level>
Select the Dynamic Range Compression level for AC3 audio streams.
@@ -599,6 +652,7 @@
silent and vice versa).
This option only shows an effect if the AC3 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,
@@ -606,6 +660,7 @@
MPlayer prints the available IDs when run in verbose (\-v) mode.
When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
(if present) with the chosen audio stream.
+.
.TP
.B \-alang <two letter\ country\ code> (also see \-aid) (DVD only)
Selects the DVD audio language and tries to play audio streams whose
@@ -625,41 +680,48 @@
Force audio demuxer type for \-audiofile.
Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
\-audio-demuxer 17 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 \-bandwidth <value> (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.
+.
.TP
.B \-cdrom-device <path\ to\ device>
Specify the CD-ROM device (default: /dev/\:cdrom).
+.
.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 \-cache-min <percentage>
Playback will start when the cache fill threshold set with this option
is reached.
+.
.TP
.B \-cache-prefill <percentage> (not yet implemented)
When the cache is emptied MPlayer will pause and restart playback when
the cache prefill threshold set with this option is reached.
+.
.TP
.B \-cdda <option1:option2> (CDDA only)
This option can be used to tune the CD Audio reading feature of MPlayer.
.sp 1
Available options are:
-.
.RSs
.IPs speed=<value>
Set CD spin speed.
@@ -727,33 +789,41 @@
.B \-chapter <chapter\ id>[\-<end\ chapter\ id>] (DVD only)
Specify which chapter to start playing at.
Optionally specify which chapter to end playing at (default: 1).
+.
.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 \-demuxer <number>
Force demuxer type.
Give the demuxer ID as defined in libmpdemux/\:demuxer.h.
\-demuxer 17 forces MP3.
+.
.TP
.B \-dumpaudio (MPlayer only)
Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC3).
+.
.TP
.B \-dumpfile <filename> (MPlayer only)
Specify which file MPlayer should dump to.
Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
+.
.TP
.B \-dumpstream (MPlayer only)
Dumps the raw stream to ./stream.dump.
Useful when ripping from DVD or network.
+.
.TP
.B \-dumpvideo (MPlayer only)
Dump raw compressed video stream to ./stream.dump (not very usable).
+.
.TP
.B \-dvbin <options> (DVB only)
Pass the following parameters to the DVB input module, in order to override
@@ -773,10 +843,12 @@
.TP
.B \-dvd-device <path\ to\ device> (DVD only)
Specify the DVD device (default: /dev/\:dvd).
+.
.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 \-forceidx
Force index rebuilding.
@@ -787,13 +859,16 @@
.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.
@@ -801,6 +876,7 @@
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 \-idx (also see \-forceidx)
Rebuilds index of files if no index was found, allowing seeking.
@@ -809,10 +885,12 @@
.I NOTE:
This option only works if the underlying media supports seeking
(i.e.\& not with stdin, pipe, etc).
+.
.TP
.B \-ipv4-only-proxy (network only)
Skip the proxy for IPv6 addresses.
It will still be used for IPv4 connections.
+.
.TP
.B \-loadidx <index file>
The file from which to read the video index data saved by \-saveidx.
@@ -823,9 +901,11 @@
.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.
@@ -849,10 +929,12 @@
.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.
@@ -860,17 +942,21 @@
(the file has no header or it is not reliable enough), the filename
extension is used to select the demuxer.
Always falls back to content-based demuxer selection.
+.
.TP
.B \-passwd <password> (see \-user option too) (network only)
Specify password for HTTP authentication.
+.
.TP
.B \-prefer-ipv4 (network only)
Use IPv4 on network connections.
Falls back to IPv6 automatically.
+.
.TP
.B \-prefer-ipv6 (IPv6 network only)
Use IPv6 on network connections.
Falls back to IPv4 automatically.
+.
.TP
.B \-rawaudio <option1:option2:...>
This option lets you play raw audio files.
@@ -929,6 +1015,7 @@
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.live.com/\:mplayer/).
+.
.TP
.B \-saveidx <filename>
Force index rebuilding and dump the index to <filename>.
@@ -936,14 +1023,17 @@
.br
.I NOTE:
This option is obsolete now that MPlayer has OpenDML support.
+.
.TP
.B \-sb <byte\ position> (see \-ss option too)
Seek to byte position.
Useful for playback from CD-ROM images or VOB files with junk at the beginning.
+.
.TP
.B \-srate <Hz>
Selects the given output sampling rate, resampling if necessary.
MEncoder passes this value to LAME for resampling.
+.
.TP
.B \-ss <time> (see \-sb option too)
Seek to given time position.
@@ -983,7 +1073,6 @@
as a movie URL.
.sp 1
Available options are:
-.
.RSs
.IPs noaudio
no sound
@@ -1104,56 +1193,66 @@
.TP
.B \-user <user name> (also see \-passwd) (network only)
Specify user name 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/\:MEncoder will use the first program
(if present) with the chosen video stream.
+.
.TP
.B \-vivo <sub-options> (DEBUG CODE)
Force audio parameters for the VIVO demuxer (for debugging purposes).
.
.
+.
.SH "OSD/\:SUB OPTIONS"
.I NOTE:
Also see \-vf expand.
+.
.TP
.B \-dumpjacosub (MPlayer only)
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 (MPlayer only)
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 (MPlayer only)
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 (MPlayer only)
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 (MPlayer only)
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.
+.
.TP
.B \-dumpsub (MPlayer only) (BETA CODE)
Dumps the subtitle substream from VOB streams.
Also see the \-dump*sub and \-vobsubout* options.
+.
.TP
.B \-ffactor <number> (OSD only)
Resample the font alphamap.
Can be:
-.
.PD 0
.RSs
.IPs 0
@@ -1170,6 +1269,7 @@
.TP
.B \-flip-hebrew (FriBiDi only)
Turns on flipping subtitles using FriBiDi.
+.
.TP
.B \-font <path\ to\ font.desc\ file> (OSD only)
Search for the OSD/\:SUB fonts in an alternative directory (default for normal
@@ -1194,25 +1294,29 @@
.TP
.B \-fontconfig (fontconfig only)
Enables the usage of fontconfig managed fonts.
+.
.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 \-osdlevel <0\-3> (MPlayer only)
Specifies which mode the OSD should start in.
-.
.PD 0
.RSs
.IPs 0
@@ -1231,10 +1335,12 @@
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 option)
Display DVD subtitles in the language specified by <ID> (0\-31).
MPlayer prints the available subtitle languages when run in verbose (\-v) mode.
+.
.TP
.B \-slang <country\ code[,country\ code,...]> (also see \-sid)
Specify a priority list of DVD subtitle languages to use.
@@ -1291,25 +1397,30 @@
.B \-spugauss <0.0\-3.0> (OSD only)
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 equivalente to the
intensity of the color.
255 means white and 0 black.
+.
.TP
.B \-sub-demuxer <number> (\-subfile only) (BETA CODE)
Force subtitle demuxer type for \-subfile.
Give the demuxer ID as defined in subreader.h.
+.
.TP
.B \-sub-fuzziness <mode>
Adjust matching fuzziness when searching for subtitles:
@@ -1328,6 +1439,7 @@
.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> (OSD only)
Specify how subtitles should be aligned with \-subpos.
@@ -1348,6 +1460,7 @@
These are 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
@@ -1386,10 +1499,12 @@
.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-autoscale <0\-3> (FreeType only)
Sets the autoscale mode.
@@ -1415,65 +1530,79 @@
.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:
Only for frame-based subtitle files, i.e.\& not MicroDVD format.
+.
.TP
.B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
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> (OSD only)
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 \-unicode
Tells MPlayer to handle the subtitle file as unicode.
+.
.TP
.B \-utf8 \ \
Tells MPlayer to handle the subtitle file as UTF-8.
+.
.TP
.B \-vobsub <VOBsub\ file\ without\ extension>
Specify a VOBsub file to use for subtitles.
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 (MPLAYER ONLY)"
+.
.TP
.B \-abs <value> (\-ao oss only) (OBSOLETE)
Override audio driver/\:card buffer size detection.
+.
.TP
.B \-aofile <filename>
Override the default filename employed by \-ao pcm.
+.
.TP
.B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
Specify audio plugin(s) and their options (see documentation too).
.sp 1
Available options are:
-.
.RSs
.IPs list=[plugins]
comma separated list of plugins (resample, surround, format, volume,
@@ -1495,11 +1624,11 @@
.TP
.B \-delay <sec>
Audio delay in seconds (positive or negative float value).
+.
.TP
.B \-format <0\-8192>
Select the format used for output from the filter layer (according to the
defines in libao2/\:afmt.h):
-.
.PD 0
.RSs
.IPs 1
@@ -1535,6 +1664,7 @@
.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> (\-ao oss and \-ao alsa only)
This option will tell MPlayer to use a different channel for controlling
@@ -1545,19 +1675,23 @@
/usr/\:include/\:linux/\:soundcard.h.
For ALSA you can use the names e.g.\& alsamixer displays, like
.B Master, Line, PCM.
+.
.TP
.B \-nowaveheader (\-ao pcm only)
Don't include wave header.
Used for raw PCM.
+.
.TP
.B \-volstep <0\-100>
Set the step size of mixer volume changes in percent of the whole range
(default: 3).
.
.
+.
.SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
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.
@@ -1578,7 +1712,6 @@
Sets noblock-mode, mmap-mode and the device-name as first card, fourth device.
.RE
.PD 1
-.
.sp 1
FIXME: Document suboptions for sdl, arts, esd, jack, nas, macosx, sgi, sun,
dxr2, mpegpes, null, pcm, plugin.
@@ -1599,17 +1732,21 @@
Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
.RE
.PD 1
+.
.TP
.B alsa1x (OBSOLETE)
ALSA 1.x audio output driver.
Obsoleted by the general alsa audio output driver.
+.
.TP
.B alsa9 (OBSOLETE)
ALSA 0.9 audio output driver.
Obsoleted by the general alsa audio output driver.
+.
.TP
.B alsa5\ \
ALSA 0.5 audio output driver.
+.
.TP
.B oss\ \ \ \
OSS audio output driver
@@ -1619,79 +1756,101 @@
Sets the audio-output device (default: /dev/\:dsp).
.RE
.PD 1
+.
.TP
.B sdl\ \ \ \
Highly platform independent SDL (Simple Directmedia Layer) library
audio output driver.
+.
.TP
.B arts\ \ \
Audio output through the Arts daemon.
+.
.TP
.B esd\ \ \ \
Audio output through the ESD daemon.
+.
.TP
.B jack\ \ \ \
Audio output through JACK (Jack Audio Connection Kit).
+.
.TP
.B nas\ \ \ \
Audio output through NAS.
+.
.TP
.B macosx (Mac OS X only)
Native Mac OS X audio output driver.
+.
.TP
.B sgi (SGI only)
Native SGI audio output driver.
+.
.TP
.B sun (Sun only)
Native Sun audio output driver.
+.
.TP
.B win32 (Windows only)
Native Windows waveout audio output driver.
+.
.TP
.B dxr2 (also see \-dxr2) (DXR2 only)
Creative DXR2 specific output driver.
+.
.TP
.B mpegpes (DVB only)
DVB specific output driver.
+.
.TP
.B null\ \ \
Produces no audio output but maintains video playback speed.
Use \-nosound for benchmarking.
+.
.TP
.B pcm (also see \-aofile)
Raw PCM/\:wave file writer audio output.
Writes the sound to ./audiodump.wav.
+.
.TP
.B plugin\ \
Plugin audio output driver.
.
.
+.
.SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
+.
.TP
.B \-aa* (\-vo aa only)
You can get a list and an explanation of available options executing
.I mplayer \-aahelp
+.
.TP
.B \-adapter <value>
Set the graphics card that will receive the image.
Needs the \-vm option to work.
You can get a list of available cards when you run this option with \-v.
Works currently only with \-vo directx.
+.
.TP
.B \-bpp <depth>
Override the autodetected color depth.
Only supported by the fbdev, dga, svga, vesa video output drivers.
+.
.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 \-dfbopts <value> (\-vo directfb only)
Specify a parameter list for the directfb video output driver.
+.
.TP
.B \-display <name> (X11 only)
Specify the hostname and display number of the X server you want to display
@@ -1712,16 +1871,17 @@
Can affect OSD negatively, but often it removes OSD flickering.
Needs twice the memory of a single buffer, so it won't work on cards with
very little video memory.
+.
.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 \-dxr2 <option1:option2:...>
This option is used to control the dxr2 video output driver.
-.
.RSs
.IPs ar-mode=<value>
aspect ratio mode (0 = normal, 1 = pan and scan, 2 = letterbox (default))
@@ -1804,6 +1964,7 @@
.TP
.B \-fb <device> (\-vo fbdev or directfb only) (OBSOLETE)
Specifies the framebuffer device to use (default: /dev/\:fb0).
+.
.TP
.B \-fbmode <modename> (\-vo fbdev only)
Change video mode to the one that is labeled as <modename> in
@@ -1811,19 +1972,24 @@
.br
.I NOTE:
VESA framebuffer doesn't support mode changing.
+.
.TP
.B \-fbmodeconfig <filename> (\-vo fbdev only)
Override framebuffer mode configuration file (default: /etc/\:fb.modes).
+.
.TP
.B \-forcexv (\-vo sdl only)
Force using XVideo through the sdl video output driver.
+.
.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.
@@ -1869,6 +2035,7 @@
Fixes fullscreen switching on OpenBox 1.x.
.RE
.PD 1
+.
.TP
.B \-geometry x[%][:y[%]] or [WxH][+x+y]
Adjust where the output is on the screen initially.
@@ -1901,11 +2068,13 @@
This tells the GUI to also use an X11 window and stick itself to the bottom
of the video, which is useful to embed a mini-GUI in a browser (with the
MPlayer plugin for instance).
+.
.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 \-jpeg <option1:option2:...> (\-vo jpeg only)
Specify options for the jpeg video output driver.
@@ -1942,12 +2111,15 @@
.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.
@@ -1965,49 +2137,60 @@
.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.
Only works with the x11, xv, xmga, xvidix, directx video output drivers.
Furthermore under X11 your window manager has to honor window aspect hints.
+.
.TP
.B \-noxv (\-vo sdl only)
Disables using XVideo through the sdl video output driver.
+.
.TP
.B \-ontop
Makes the player window stay on top other windows.
Supported by drivers which use X11, except SDL, as well as directx and gl2 under Windows.
+.
.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.
Only works with the xv, xmga, mga and xvidix video output drivers.
+.
.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.
Only works with the x11, xv, xmga, xvidix, quartz and directx 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 vertical screen resolution for video output drivers which
do not know the screen resolution like fbdev, x11 and TVout.
+.
.TP
.B \-screenw <pixels>
Specify the horizontal screen resolution for video output drivers which
do not know the screen resolution like fbdev, x11 and TVout.
+.
.TP
.B \-stop-xscreensaver (X11 only)
Turns off xscreensaver at startup and turns it on again on exit.
+.
.TP
.B \-vm \ \ \
Try to change to a different video mode.
@@ -2015,25 +2198,31 @@
If used with the directx video output driver the \-screenw,
\-screenh, \-bpp and \-refreshrate options can be used to set
the new display mode.
+.
.TP
.B \-vsync \ \
Enables VBI for the vesa, dfbmga and svga video output drivers.
+.
.TP
.B \-wid <window\ id> (also see \-guiwid) (X11 only)
This tells MPlayer to attach to an existing X11 window.
Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
+.
.TP
.B \-xineramascreen <0\-...>
In Xinerama configurations (i.e.\& a single desktop that spans across multiple
displays) this option tells MPlayer which screen to display movie on.
+.
.TP
.B \-z <0\-9> (\-vo png only)
Specifies the compression level of the png video output driver.
0 is no compression, 9 is the maximum compression.
+.
.TP
.B \-zrbw (\-vo zr only)
Display in black and white.
For optimal performance, this can be combined with '\-lavdopts gray'.
+.
.TP
.B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
Select a part of the input image to display, multiple occurences
@@ -2044,48 +2233,59 @@
card should at least have a \-zrdev in addition to the \-zrcrop.
For examples, see the output of \-zrhelp and the Zr section of the
documentation.
+.
.TP
.B \-zrdev <device> (\-vo zr only)
Specify the device special file that belongs to your MJPEG card, by default
the zr video output driver takes the first v4l device it can find.
+.
.TP
.B \-zrfd (\-vo zr only)
Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
happens if the hardware scaler can stretch the image to its original size.
Use this option to force decimation.
+.
.TP
.B \-zrhdec <1,2,4> (\-vo zr only)
Horizontal decimation: Ask the driver to send only every 2nd or 4th
line/\:pixel of the input image to the MJPEG card and use the scaler
of the MJPEG card to stretch the image to its original size.
+.
.TP
.B \-zrhelp (\-vo zr only)
Display a list of all \-zr* options, their default values and a
cinerama mode example.
+.
.TP
.B \-zrnorm <norm> (\-vo zr only)
Specify the TV norm as PAL or NTSC (default: no change).
+.
.TP
.B \-zrquality <1\-20> (\-vo zr only)
A number from 1 (best) to 20 (worst) representing the JPEG encoding quality.
+.
.TP
.B \-zrvdec <1,2,4> (\-vo zr only)
Vertical decimation: Ask the driver to send only every 2nd or 4th
line/\:pixel of the input image to the MJPEG card and use the scaler
of the MJPEG card to stretch the image to its original size.
+.
.TP
.B \-zrxdoff <x display offset> (\-vo zr only)
If the movie is smaller than the TV screen, this option specifies the x
offset from the upper-left corner of the TV screen (default: centered).
+.
.TP
.B \-zrydoff <y display offset> (\-vo zr only)
If the movie is smaller than the TV screen, this option specifies the y
offset from the upper-left corner of the TV screen (default: centered).
.
.
+.
.SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
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.
@@ -2106,7 +2306,6 @@
Uses the DirectX driver with acceleration features turned off.
.RE
.PD 1
-.
.sp 1
FIXME: Document suboptions for x11, xover, dga, sdl, vidix, xvidix, fbdev,
fbdev2, vesa, null, aa, bl, ggi, mga, xmga, syncfb, 3dfx, tdfx_vid,
@@ -2126,14 +2325,17 @@
Select a specific XVideo port.
.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.
+.
.TP
.B xvmc (X11, \-vc ffmpeg12mc only)
Video output driver that uses the XvMC (X Video Motion Compensation)
@@ -2155,14 +2357,17 @@
(default).
.RE
.PD 1
+.
.TP
.B dga (X11 only)
Play video through the XFree86 Direct Graphics Access extension.
Considered obsolete.
+.
.TP
.B sdl (SDL only)
Highly platform independent SDL (Simple Directmedia Layer) library
video output driver.
+.
.TP
.B vidix\ \
VIDIX (VIDeo Interface for *niX) is an interface to the
@@ -2176,6 +2381,7 @@
mga_vid, nvidia_vid, pm3_vid, radeon_vid, rage128_vid and sis_vid.
.RE
.PD 1
+.
.TP
.B xvidix (X11 only)
X11 frontend for VIDIX
@@ -2185,6 +2391,7 @@
same as vidix
.RE
.PD 1
+.
.TP
.B cvidix\
Generic and platform independent VIDIX frontend, can even run in a
@@ -2195,6 +2402,7 @@
same as vidix
.RE
.PD 1
+.
.TP
.B winvidix (Windows only)
Windows frontend for VIDIX
@@ -2204,6 +2412,7 @@
same as vidix
.RE
.PD 1
+.
.TP
.B directx (Windows only)
Video output driver that uses the DirectX interface.
@@ -2214,6 +2423,7 @@
Try this option if you have display problems.
.RE
.PD 1
+.
.TP
.B quartz (Mac OS X only)
Mac OS X Quartz video output driver.
@@ -2225,13 +2435,16 @@
Choose the display device to use in fullscreen.
.RE
.PD 1
+.
.TP
.B fbdev (Linux only)
Uses the kernel framebuffer to play video.
+.
.TP
.B fbdev2 (Linux only)
Uses the kernel framebuffer to play video,
alternative implementation.
+.
.TP
.B vesa\ \ \
Very general video output driver that should work on any VESA VBE 2.0
@@ -2248,6 +2461,7 @@
FIXME: document this
.RE
.PD 1
+.
.TP
.B svga\ \ \
Play video using the SVGA library.
@@ -2272,6 +2486,7 @@
Use svga with VIDIX.
.RE
.PD 1
+.
.TP
.B gl\ \ \ \ \
OpenGL video output driver.
@@ -2288,27 +2503,34 @@
0 for whole image.
.RE
.PD 1
+.
.TP
.B gl2\ \ \ \
OpenGL video output driver, second generation.
Supports OSD and videos larger than the maximum texture size.
+.
.TP
.B null\ \ \
Produces no video output.
Useful for benchmarking.
+.
.TP
.B aa\ \ \ \ \
ASCII art video output driver that works on a text console.
+.
.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.
+.
.TP
.B ggi\ \ \ \
GGI graphics system video output driver
+.
.TP
.B directfb
Play video using the DirectFB library.
@@ -2332,6 +2554,7 @@
Will force layer with id N for playback (default: -1 - auto).
.RE
.PD 1
+.
.TP
.B dfbmga\
Matrox G400/\:G450/\:G550 specific video output driver that uses the
@@ -2372,34 +2595,41 @@
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.
+.
.TP
.B xmga (Linux, X11 only)
The mga video output driver, running in an X11 window.
+.
.TP
.B syncfb\
Video output driver for the SyncFB kernel module, which provides
special hardware features of Matrox Gxxx cards like hardware
deinterlacing, scaling and synchronizing your video output to
the vertical retrace of your monitor.
+.
.TP
.B 3dfx (Linux only)
3Dfx specific video output driver.
FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
+.
.TP
.B tdfxfb (Linux only)
This driver employs the tdfx framebuffer driver to play movies with
YUV acceleration.
FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
+.
.TP
.B tdfx_vid (Linux only)
3Dfx specific video output driver.
Works in conjunction with a kernel module.
FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
+.
.TP
.B dxr2 (also see \-dxr2) (DXR2 only)
Creative DXR2 specific video output driver.
@@ -2411,6 +2641,7 @@
Enables overlay.
.RE
.PD 1
+.
.TP
.B dxr3 (DXR3 only)
Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
@@ -2443,6 +2674,7 @@
Specifies the device number to use if you have more than one em8300 card.
.RE
.PD 1
+.
.TP
.B mpegpes (DVB only)
DVB specific video output driver.
@@ -2453,14 +2685,17 @@
(V3 API only, such as 1.x.y series drivers).
.RE
.PD 1
+.
.TP
.B zr (also see \-zr* and \-zrhelp)
Video output driver for a number of MJPEG capture/\:playback cards.
+.
.TP
.B zr2\ \ \ \
Video output driver for a number of MJPEG capture/\:playback cards,
second generation.
Also see the zrmjpeg video filter.
+.
.TP
.B md5\ \ \ \
Generates images from each frame with the help of \-vo pgm and writes
@@ -2472,6 +2707,7 @@
Allows specifying the output filename (default: ./md5).
.RE
.PD 1
+.
.TP
.B yuv4mpeg
Transforms the video stream into a sequence of uncompressed YUV 4:2:0
@@ -2479,29 +2715,36 @@
directory.
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.
+.
.TP
.B gif89a\
Output each frame into a GIF file in the current directory.
Each file takes the frame number padded with leading zeros as name.
+.
.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.
+.
.TP
.B pgm\ \ \ \
Output each frame into a PGM file in the current directory.
Each file takes the frame number padded with leading zeros as name.
+.
.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.
+.
.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.
.
.
+.
.SH "DECODING/\:FILTERING OPTIONS"
+.
.TP
.B \-ac <[-]codec1,[-]codec2,...[,]>
Specify a priority list of audio codecs to be used, according to their codec
@@ -2532,7 +2775,6 @@
Activate a comma separated list of audio filters and their options.
.br
Available filters are:
-.
.RSs
.IPs resample[=srate[:sloppy][:type]]
Changes the sample rate of the audio stream to an integer srate (Hz).
@@ -2604,7 +2846,6 @@
.TP
.B \-af-adv <force=(0\-3):list=(filters)> (see \-af option too)
Specify advanced audio filter options:
-.
.RSs
.IPs force=<0\-3>
Forces the insertion of audio filters to one of the following:
@@ -2657,9 +2898,11 @@
.TP
.B \-noaspect
Disable automatic movie aspect ratio compensation.
+.
.TP
.B \-flip \
Flip image upside-down.
+.
.TP
.B \-lavdopts <option1:option2:...> (DEBUG CODE)
If decoding with libavcodec, you can specify its parameters here.
@@ -2677,7 +2920,6 @@
.br
Available options are:
.RE
-.
.RSs
.IPs ec\ \ \
error concealment:
@@ -2793,13 +3035,16 @@
whole frame in a single run.
May be faster or slower, depending on card/\:cache.
It has effect only with libmpeg2 and libavcodec codecs.
+.
.TP
.B \-nosound
Do not play/\:encode sound.
Useful for benchmarking.
+.
.TP
.B \-novideo
Do not play/\:encode video.
+.
.TP
.B \-oldpp <quality> (OpenDivX only) (OBSOLETE)
Use the opendivx postprocessing code instead of the internal one.
@@ -2808,6 +3053,7 @@
.
The valid range of \-oldpp values varies by codec, mostly
0\-6, where 0=disable 6=slowest/\:best.
+.
.TP
.B \-pp <quality> (see \-vf pp option too!)
Set postprocess level of the DLL.
@@ -2816,9 +3062,11 @@
.
The valid range of \-pp values varies by codec, mostly
0\-6, where 0=disable 6=slowest/\:best.
+.
.TP
.B \-pphelp (see \-vf pp option too)
Show a summary about the available postprocess filters and their usage.
+.
.TP
.B \-ssf <mode>
Specifies SwScaler parameters.
@@ -2829,7 +3077,6 @@
\-vf scale \-ssf lgb=3.0
.RE
.PD 1
-.
.PD 0
.RSs
.IPs lgb=<0\-100>
@@ -2850,7 +3097,6 @@
.TP
.B \-stereo <mode>
Select type of MP2/\:MP3 stereo output.
-.
.PD 0
.RSs
.IPs 0
@@ -2955,10 +3201,10 @@
.B \-x <x> (MPlayer only)
Scale image to x width (if sw/\:hw scaling available).
Disables aspect calculations.
+.
.TP
.B \-xvidopts <option1:option2:...>
Specify additional parameters when decoding with XviD.
-.
.PD 0
.RSs
.IPs deblock-chroma
@@ -2994,6 +3240,7 @@
.B \-y <y> (MPlayer only)
Scale image to y height (if sw/\:hw scaling available).
Disables aspect calculations.
+.
.TP
.B \-zoom \
Allow software scaling, where available.
@@ -3004,13 +3251,16 @@
\-zoom.
.
.
+.
.SH "VIDEO FILTERS"
Video filter are plugins that allow you to modify the video stream and its
properties.
The syntax is:
+.
.TP
.B \-vf <filter1[=parameters],filter2,...>
Setup a chain of video filters.
+.
.TP
.B \-vop <...,filter3[=parameters],filter2,filter1> (OBSOLETE)
Setup a chain of video filters, to be applied in
@@ -3029,26 +3279,32 @@
.sp 1
Filters are managed in lists.
There are a few commands to manage the filter list.
+.
.TP
.B \-vf-add <filter1[,filter2,...]>
Appends the filters given as arguments to the filter list.
+.
.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.
@@ -3068,6 +3324,7 @@
Position of the cropped picture, defaults to center.
.RE
.PD 1
+.
.TP
.B cropdetect[=0\-255]
Calculates necessary cropping parameters and prints the recommended parameters
@@ -3075,6 +3332,7 @@
The threshold can be optionally specified from nothing (0) to everything
(255).
(default: 24)
+.
.TP
.B rectangle[=w:h:x:y]
The plugin responds to the input.conf directive 'change_rectangle'
@@ -3088,6 +3346,7 @@
top left corner position (default: -1, uppermost leftmost)
.RE
.PD 1
+.
.TP
.B expand[=w:h:x:y:o]
Expands (not scales) movie resolution to the given value and places the
@@ -3115,18 +3374,22 @@
1: enable
.REss
.RE
+.
.TP
.B flip\ \ \
Flips the image upside down.
See also option \-flip.
+.
.TP
.B mirror\
Mirrors the image on the Y axis.
+.
.TP
.B rotate[=<0\-7>]
Rotates and flips (optional) the image +/\:- 90 degrees.
For parameters between 4\-7 rotation is only done if the movie's geometry is
portrait and not landscape.
+.
.TP
.B scale[=w:h[:interlaced[:chr_drop[:param[:presize]]]]]
Scales the image with the software scaler (slow) and performs a YUV<\->RGB
@@ -3185,6 +3448,7 @@
spal: 768x576 (square pixel PAL)
.REss
.RE
+.
.TP
.B dsize={aspect|w:h}
Changes the intended display size/\:aspect at an arbitrary point in the
@@ -3196,17 +3460,21 @@
Note that this filter does NOT do any scaling itself; it just affects
what later scalers (software or hardware) will do when auto-scaling to
correct aspect.
+.
.TP
.B yuy2\ \ \
Forces software YV12/\:I420 or 422P to YUY2 conversion.
Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
+.
.TP
.B yvu9\ \ \
Forces software YVU9 to YV12 colorspace conversion.
Deprecated in favor of the software scaler.
+.
.TP
.B yuvcsp\
Clamps YUV color values to the CCIR 601 range without doing real conversion.
+.
.TP
.B rgb2bgr[=swap]
RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion.
@@ -3216,9 +3484,11 @@
Also perform R <\-> B swapping.
.RE
.PD 1
+.
.TP
.B palette
RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette.
+.
.TP
.B format[=fourcc]
Restricts the colorspace for the next filter without doing any conversion.
@@ -3230,6 +3500,7 @@
format name like rgb15, bgr24, yv12, etc (default: yuy2)
.RE
.PD 1
+.
.TP
.B noformat[=fourcc]
Restricts the colorspace for the next filter without doing any conversion.
@@ -3243,6 +3514,7 @@
format name like rgb15, bgr24, yv12, etc (default: yv12)
.RE
.PD 1
+.
.TP
.B pp[=filter1[:option1[:option2...]]/\:[-]filter2...] (see \-pphelp too)
This option enables usage of MPlayer's internal postprocessing filter,
@@ -3287,6 +3559,7 @@
off automatically depending on available CPU time.
.RE
.PD 1
+.
.TP
.B spp[=quality[:qp[:mode]]]
simple postprocessing filter
@@ -3300,6 +3573,7 @@
.br
1: soft thresholding (better deringing, but blurrier)
.RE
+.
.TP
.B qp=equation
qp change filter
@@ -3307,13 +3581,16 @@
.IPs equation
some equation like "2+2*sin(PI*qp)"
.RE
+.
.TP
.B test\ \ \
Generate various test patterns.
+.
.TP
.B rgbtest
Generate an RGB test pattern useful for detecting RGB vs BGR issues.
You should see a red, green and blue stripe from top to bottom.
+.
.TP
.B lavc[=quality:fps]
Fast software YV12 to MPEG1 conversion with libavcodec for use with DVB/\:DXR3.
@@ -3328,9 +3605,11 @@
.IPs fps\ \
force output fps (float value) (default: 0, autodetect based on height)
.RE
+.
.TP
.B fame\ \ \
Fast software YV12 to MPEG1 conversion with libfame for use with DVB/\:DXR3.
+.
.TP
.B dvbscale[=aspect]
Set up optimal scaling for DVB cards, scaling the X axis in hardware and
@@ -3342,6 +3621,7 @@
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
+.
.TP
.B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
Adds noise.
@@ -3380,10 +3660,12 @@
temporal strength (default = 6)
.RE
.PD 1
+.
.TP
.B hqdn3d[=luma:chroma:time]
High precision/\:quality version of the denoise3d filter.
Parameters and usage are the same.
+.
.TP
.B eq[=bright:cont]
Software equalizer with interactive controls just like the hardware
@@ -3393,6 +3675,7 @@
movies, or for slightly reducing contrast to mask artifacts and get by
with lower bitrates.
Initial values in the range -100\-100 may be given on the command line.
+.
.TP
.B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
Alternative software equalizer that uses lookup tables (very slow),
@@ -3413,11 +3696,13 @@
Value ranges are 0.1\-10 for gamma, -2\-2 for contrast (negative values result
in a negative image), -1\-1 for brightness, 0\-3 for saturation and 0\-1 for
weight.
+.
.TP
.B hue[=hue:saturation]
Defaults are hue=0.0, saturation=1.0.
Value ranges are -180\-180 for hue, -2\-2 for saturation (negative values result
in a negative chroma).
+.
.TP
.B halfpack[=f]
Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
@@ -3430,6 +3715,7 @@
The optional parameter f can be 0 to only use even lines, or 1 to only use
odd lines.
Any other value for f gives the default (averaging) behavior.
+.
.TP
.B ilpack[=mode]
When interlaced video is stored in YUV 4:2:0 formats, chroma
@@ -3441,6 +3727,7 @@
The optional argument selects the sampling mode.
By default, linear interpolation (mode 1) is used.
Mode 0 uses nearest-neighbor sampling, which is fast but incorrect.
+.
.TP
.B harddup
Only useful with MEncoder.
@@ -3451,6 +3738,7 @@
encoding.
Should be placed at or near the end of the filter chain unless you
have a good reason to do otherwise.
+.
.TP
.B softskip
Only useful with MEncoder.
@@ -3460,6 +3748,7 @@
temporal denoising, etc.) to function properly.
Should be placed after the filters which need to see all frames and
before any subsequent filters that are CPU-intensive.
+.
.TP
.B decimate[=max:hi:lo:frac]
Drops frames that don't differ greatly from the previous frame in
@@ -3477,15 +3766,18 @@
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.
+.
.TP
.B dint[=sense:level]
Detects and drops first of interlaced frames in video stream.
Values can be from 0.0 to 1.0 \- first (default 0.1) is relative difference
between neighbor pixels, second (default 0.15) is what part of image have to
be detected as interlaced to drop the frame.
+.
.TP
.B lavcdeint
Use libavcodec's deinterlace filter.
+.
.TP
.B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
Donald Graft's adaptive kernel deinterlacer.
@@ -3504,6 +3796,7 @@
Enable twoway sharpening (default: 0).
.RE
.PD 1
+.
.TP
.B unsharp=l|cWxH:amount[:l|cWxH:amount]
Unsharp mask / gaussian blur.
@@ -3524,9 +3817,11 @@
>0: sharpen
.REss
.RE
+.
.TP
.B swapuv\
Swap U & V plane.
+.
.TP
.B il=[d|i][s][:[d|i][s]]
(de)interleaves lines.
@@ -3548,6 +3843,7 @@
swap fields (exchange even & odd lines)
.RE
.PD 1
+.
.TP
.B fil=[i|d]
(de)interleaves lines.
@@ -3564,12 +3860,14 @@
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=value2:var2=value2:...]
Attempts to reverse the 'telecine' process to recover a clean,
@@ -3609,6 +3907,7 @@
.IPs "tr0, tr1, tr2, tr3"
Threshold values to be used in certain modes.
.RE
+.
.TP
.B ivtc[=1]
Experimental 'stateless' inverse telecine filter.
@@ -3623,6 +3922,7 @@
23.976) when using MEncoder.
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]\
Third-generation pulldown reversal (inverse telecine) filter,
@@ -3649,6 +3949,7 @@
that pullup is able to see each frame.
Failure to do so will lead to incorrect output and will usually crash,
due to design limitations in the codec/\:filter layer.
+.
.TP
.B filmdint[=options]
Inverse telecine filter, similar to the pullup filter above.
@@ -3722,12 +4023,14 @@
.IPs sad_thres=n
Sum of Absolute Difference threshold, default is 64.
.RE
+.
.TP
.B softpulldown
This filter works only correct with MEncoder and acts on the MPEG2 flags
used for soft 3:2 pulldown (soft telecine).
If you want to use the ivtc or detc filter on movies that are partly soft
telecined, inserting this filter before them should make them more reliable.
+.
.TP
.B divtc[=options]
Inverse telecine for deinterlaced video.
@@ -3788,6 +4091,7 @@
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
@@ -3834,6 +4138,7 @@
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%.
@@ -3843,6 +4148,7 @@
(A/\:V sync will break if they are wrong.)
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
@@ -3864,6 +4170,7 @@
framerate unchanged
.RE
.PD 1
+.
.TP
.B tfields[=mode]
Temporal field separation \- split fields into frames, doubling the
@@ -3884,6 +4191,7 @@
translate fields by 1/\:4 pixel with 4tap filter (higher quality)
.RE
.PD 1
+.
.TP
.B boxblur=radius:power[:radius:power]
box blur
@@ -3895,6 +4203,7 @@
How often the filter should be applied.
.RE
.PD 1
+.
.TP
.B sab=rad:pf:colorDiff[:rad:pf:colorDiff]
shape adaptive blur
@@ -3909,6 +4218,7 @@
(~0.1\-100.0)
.RE
.PD 1
+.
.TP
.B smartblur=rad:strength:thresh[:rad:strength:thresh]
smart blur
@@ -3922,6 +4232,7 @@
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
perspective correction
@@ -3933,12 +4244,15 @@
linear (0) or cubic resampling (1)
.RE
.PD 1
+.
.TP
.B 2xsai\ \
Use the 2x scale and interpolate algorithm for scaling and smoothing images.
+.
.TP
.B 1bpp\ \ \
1bpp bitmap to YUV/\:BGR 8/\:15/\:16/\:32 conversion
+.
.TP
.B down3dright[=lines]
Reposition and resize stereoscopic images.
@@ -3950,10 +4264,10 @@
number of lines to select from the middle of the image (default: 12)
.RE
.PD 1
+.
.TP
.B bmovl=hidden:opaque:<fifo>
Read bitmaps from a FIFO and display them in a window.
-.
.PD 0
.RSs
.IPs hidden
@@ -4023,6 +4337,7 @@
.REss
.RE
.PD 1
+.
.TP
.B framestep=I|[i]step
Renders only every nth frame or every Intra (key) frame.
@@ -4046,6 +4361,7 @@
.sp 1
If you give only the i then nothing is done to the frames, only I! is
printed.
+.
.TP
.B tile=xtile:ytile:output:start:delta
Tile a series of images into a single, bigger image.
@@ -4075,6 +4391,7 @@
pixel between 2 tiles, (x/\:y) (default: 4)
.RE
.PD 1
+.
.TP
.B delogo[=x:y:w:h:t]
Suppresses a TV station logo by a simple interpolation of the
@@ -4093,6 +4410,7 @@
simplify finding the right x,y,w,h parameters.
.RE
.PD 1
+.
.TP
.B zrmjpeg[=options]
Software YV12 to MJPEG encoder for use with the zr2 video
@@ -4123,22 +4441,27 @@
.RE
.
.
+.
.SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
+.
.TP
.B \-audio-delay <0.0\-...>
Sets the audio delay field in the header.
Default is 0.0, negative values do not work.
This does not delay the audio while encoding, but the player will see the
default audio delay, sparing you the use of the \-delay option.
+.
.TP
.B \-audio-density <1\-50>
Number of audio chunks per second (default is 2 for 0.5s long audio chunks).
.br
.I NOTE:
CBR only, VBR ignores this as it puts each packet in a new chunk.
+.
.TP
.B \-audio-preload <0.0\-2.0>
Sets up audio buffering time interval (default: 0.5s).
+.
.TP
.B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see \-ss and \-sb option too)
Stop encoding at given time or byte position.
@@ -4176,12 +4499,12 @@
.B \-force-avi-aspect <0.2\-3.0>
Override the aspect stored in the AVI OpenDML vprp header.
This can be used to change the aspect ratio with \-ovc copy.
+.
.TP
.B \-info <option1:option2:...> (AVI only)
Specify the info header of the resulting AVI file.
.br
Available options are:
-.
.RSs
.IPs help\
show this description
@@ -4206,15 +4529,19 @@
Do not automatically insert the expand filter into the MEncoder filter chain.
Useful to control at which point of the filter chain subtitles are rendered
when hardcoding subtitles onto a movie.
+.
.TP
.B \-noodml (\-of avi only)
Do not write OpenDML index for files >1GB.
+.
.TP
.B \-noskip
Do not skip frames.
+.
.TP
.B \-o <filename>
Outputs to the given filename, instead of the default 'test.avi'.
+.
.TP
.B \-oac <codec name>
Encode with the given audio codec.
@@ -4257,6 +4584,7 @@
The output file will have different frame/\:sec than the source.
You MUST set it for variable fps (asf, some mov) and progressive
(29.97fps telecined MPEG) files.
+.
.TP
.B \-ovc <codec name>
Encode with the given video codec.
@@ -4281,28 +4609,34 @@
.B \-passlogfile <filename>
When encoding in 2pass mode, MEncoder dumps first pass' informations
to the given file instead of the default divx2pass.log.
+.
.TP
.B \-skiplimit <value>
Maximum skippable frames after non-skipped one
(\-noskiplimit for unlimited number).
+.
.TP
.B \-vobsubout <basename>
Specify the basename for the output .idx and .sub files.
This turns off subtitle rendering in the encoded movie and diverts it to
VOBsub subtitle files.
+.
.TP
.B \-vobsuboutid <langid>
Specify the language two letter code for the subtitles.
This overrides what is read from the DVD or the .ifo file.
+.
.TP
.B \-vobsuboutindex <index>
Specify the index of the subtitles in the output files.
(default: 0)
.
.
+.
.SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
You can specify codec specific encoding parameters using the following
syntax:
+.
.TP
.B \-<codec>opts <option1[=value],option2,...>
.RE
@@ -4315,9 +4649,11 @@
DivX4 is obsolete and only supported for completeness.
For details about DivX4 options, read the source, most options are not
described here.
+.
.TP
.B help\ \ \
get help
+.
.TP
.B br=<value>
specify bitrate
@@ -4327,43 +4663,53 @@
.IPs 16001\-24000000
(in bit)
.RE
+.
.TP
.B key=<value>
maximum keyframe interval (in frames)
+.
.TP
.B deinterlace
enable deinterlacing (avoid it, DivX4 is buggy)
+.
.TP
.B q=<1\-5>
quality (1\-fastest, 5\-best)
+.
.TP
.B min_quant=<1\-31>
minimum quantizer
+.
.TP
.B max_quant=<1\-31>
maximum quantizer
+.
.TP
.B rc_period=<value>
rate control period
+.
.TP
.B rc_reaction_period=<value>
rate control reaction period
+.
.TP
.B rc_reaction_ratio=<value>
rate control reaction ratio
+.
.TP
.B crispness=<0\-100>
specify crispness/\:smoothness
+.
.TP
.B pass=<1\-2>
With this you can encode 2pass DivX4 files.
First encode with pass=1, then with the same parameters, encode with
pass=2.
+.
.TP
.B vbrpass=<0\-2>
Override the pass argument and use XviD VBR Library instead of DivX4 VBR.
Available options are:
-.
.RSs
.IPs 0
one pass encoding (as in not putting pass on the command line)
@@ -4380,6 +4726,7 @@
.TP
.B help\ \ \
get help
+.
.TP
.B vbr=<0\-4>
variable bitrate method
@@ -4397,29 +4744,37 @@
mtrh
.RE
.PD 1
+.
.TP
.B abr\ \ \ \
average bitrate
+.
.TP
.B cbr\ \ \ \
constant bitrate.
.br
Forces also CBR mode encoding on subsequent ABR presets modes
+.
.TP
.B br=<0\-1024>
specify bitrate in kBit (CBR and ABR only)
+.
.TP
.B q=<0\-9>
quality (0\-highest, 9\-lowest) (only for VBR)
+.
.TP
.B aq=<0\-9>
algorithmic quality (0\-best/\:slowest, 9\-worst/\:fastest)
+.
.TP
.B ratio=<1\-100>
compression ratio
+.
.TP
.B vol=<0\-10>
set audio input gain
+.
.TP
.B mode=<0\-3>
(default: auto)
@@ -4435,6 +4790,7 @@
mono
.RE
.PD 1
+.
.TP
.B padding=<0\-2>
.PD 0
@@ -4447,22 +4803,26 @@
adjust
.RE
.PD 1
+.
.TP
.B fast\ \ \
switch on faster encoding on subsequent VBR presets modes, slightly lower
quality and higher bitrates.
+.
.TP
.B highpassfreq=<freq>
Set a highpass filtering frequency in Hz.
Frequencies below the specified one will be cut off.
A value of -1 will disable filtering, a value of 0
will let lame choose values automatically.
+.
.TP
.B lowpassfreq=<freq>
Set a lowpass filtering frequency in Hz.
Frequencies above the specified one will be cut off.
A value of -1 will disable filtering, a value of 0
will let lame choose values automatically.
+.
.TP
.B preset=<value>
preset values
@@ -4524,12 +4884,15 @@
IMA Adaptive PCM (4bits per sample, 4:1 compression)
.RE
.PD 1
+.
.TP
.B abitrate=<value>
Audio bitrate in kBit (default 224).
+.
.TP
.B atag=<value>
Use the specified Windows audio format tag (e.g.\& atag=0x55).
+.
.TP
.B bit_exact
Use only bit exact algorithms (except (i)dct).
@@ -4538,10 +4901,12 @@
identical files even if the encoder version changes.
This also suppresses the user_data header in MPEG-4 streams.
Do not use this option unless you know exactly what you are doing.
+.
.TP
.B threads=<1\-8>
Maximum number of threads to use (default: 1).
.RE
+.
.TP
.B vcodec=<value>
Use the specified codec (default: mpeg4):
@@ -4581,6 +4946,7 @@
FFmpeg's lossless video codec
.RE
.PD 1
+.
.TP
.B vqmin=<1\-31>
minimum quantizer (pass\ 1/\:2)
@@ -4597,32 +4963,40 @@
(this will be fixed for h263(p) by changing the quantizer per MB in
the future, msmpeg4 cannot be fixed as it does not support that).
.RE
+.
.TP
.B lmin=<0.01\-255.0>
Minimum lagrange multiplier for ratecontrol, you probably want it to be
equal to or lower than vqmin (default: 2.0).
.RE
+.
.TP
.B lmax=<0.01\-255.0>
maximum lagrange multiplier for ratecontrol (default: 31.0)
.RE
+.
.TP
.B vqscale=<1\-31>
Constant quantizer /\: constant quality encoding (selects fixed quantizer mode).
A lower value means better quality but larger files (default: 0 (disabled)).
1 is not recommended (see vqmin for details).
+.
.TP
.B vqmax=<1\-31>
maximum quantizer (pass\ 1/\:2) 10\-31 should be a sane range (default: 31)
+.
.TP
.B mbqmin=<1\-31>
minimum macroblock quantizer (pass\ 1/\:2) (default: 2)
+.
.TP
.B mbqmax=<1\-31>
maximum macroblock quantizer (pass\ 1/\:2) (default: 31)
+.
.TP
.B vqdiff=<1\-31>
maximum quantizer difference between I or P frames (pass\ 1/\:2) (default: 3)
+.
.TP
.B vmax_b_frames=<0\-4>
maximum number of B frames between non B frames:
@@ -4634,6 +5008,7 @@
sane range for MPEG4
.RE
.PD 1
+.
.TP
.B vme=<0\-5>
motion estimation method.
@@ -4658,9 +5033,11 @@
X1 (experimental)
.RE
.PD 1
+.
.TP
.B me_range=<0\-9999>
motion estimation search range, 0 (default) means unlimited
+.
.TP
.B mbd=<0\-2>
Macroblock decision algorithm (high quality mode), encode each macro
@@ -4676,22 +5053,28 @@
select the MB mode which has the best rate distortion
.RE
.PD 1
+.
.TP
.B vhq\ \ \ \
Same as mbd=1, kept for compatibility reasons.
+.
.TP
.B v4mv\ \ \
Allow 4 motion vectors per macroblock (slightly better quality).
+.
.TP
.B obmc\ \ \
overlapped block motion compensation (H.263+)
+.
.TP
.B loop\ \ \
loop filter (H.263+)
note, this is broken
+.
.TP
.B inter_threshold <-1000\-1000>
Does absolutely nothing at the moment.
+.
.TP
.B keyint=<0\-300>
maximum interval between keyframes in frames.
@@ -4702,6 +5085,7 @@
decoder, encoder and luck.
For a strict MPEG1/\:2/\:4 compliance this would have to be <=132.
(default: 250 or one keyframe every ten seconds in a 25fps movie)
+.
.TP
.B sc_threshold=<-1000000\-1000000>
Threshold for scene change detection.
@@ -4709,6 +5093,7 @@
You can specify the sensitivity of the detection with this option.
-1000000 means there is a scene change detected at every frame, 1000000 means
no scene changes are detected (default 0).
+.
.TP
.B vb_strategy=<0\-1>
strategy to choose between I/\:P/\:B frames (pass\ 2):
@@ -4718,6 +5103,7 @@
.IPs 1
avoid B frames in high motion scenes (will cause bitrate misprediction)
.RE
+.
.TP
.B vpass=<1\-2>
Activates internal two pass mode, only specify if you wish to use two pass
@@ -4743,6 +5129,7 @@
from the first pass.
.RE
.PD 1
+.
.TP
.B aspect=<x/\:y>
Store movie aspect internally, just like MPEG files.
@@ -4759,11 +5146,13 @@
.IPs "aspect=16/\:9 or aspect=1.78"
.PD 1
.RE
+.
.TP
.B autoaspect
Same as the aspect option, but automatically computes aspect, taking
into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
filter chain.
+.
.TP
.B vbitrate=<value>
Specify bitrate (pass\ 1/\:2).
@@ -4776,6 +5165,7 @@
.IPs 800
default
.RE
+.
.TP
.B vratetol=<value>
approximated filesize tolerance in kBit.
@@ -4786,32 +5176,41 @@
.I NOTE:
vratetol should not be too large during the second pass or there might
be problems if vrc_(min|max)rate is used.
+.
.TP
.B vrc_maxrate=<value>
maximum bitrate in kbit/\:sec (pass\ 1/\:2)
+.
.TP
.B vrc_minrate=<value>
minimum bitrate in kbit/\:sec (pass\ 1/\:2)
+.
.TP
.B vrc_buf_size=<value>
buffer size in kbit (pass\ 1/\:2).
For MPEG1/\:2 this also sets the vbv buffer size, use 327 for VCD,
917 for SVCD and 1835 for DVD.
+.
.TP
.B vrc_buf_aggressivity
currently useless
+.
.TP
.B vrc_strategy
Dummy, reserved for future use.
+.
.TP
.B vb_qfactor=<-31.0\-31.0>
quantizer factor between B and non B frames (pass\ 1/\:2) (default: 1.25)
+.
.TP
.B vi_qfactor=<-31.0\-31.0>
(pass\ 1/\:2) (default: 0.8)
+.
.TP
.B vb_qoffset=<-31.0\-31.0>
quantizer offset between B and non B frames (pass\ 1/\:2) (default: 1.25)
+.
.TP
.B vi_qoffset=<-31.0\-31.0>
(pass\ 1/\:2) (default: 0.0)
@@ -4824,11 +5223,13 @@
.br
do normal ratecontrol (dont lock to next P frame quantizer) and
set q= -q * v{b|i}_qfactor + v{b|i}_qoffset
+.
.TP
.B \
Tip: To do constant quantizer encoding with different quantizers for
I/\:P and B frames you can use:
lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>
+.
.TP
.B vqblur=<0.0\-1.0> (pass 1)
Quantizer blur, larger values will average the quantizer more over
@@ -4841,13 +5242,16 @@
.IPs 1.0
average the quantizer over all previous frames
.RE
+.
.TP
.B vqblur=<0.0\-99.0> (pass 2)
Quantizer gaussian blur, larger values will average the quantizer more
over time (slower change) (default: 0.5).
+.
.TP
.B vqcomp=<value>
quantizer compression, depends upon vrc_eq (pass\ 1/\:2) (default: 0.5)
+.
.TP
.B vrc_eq=<equation>
main ratecontrol equation (pass\ 1/\:2):
@@ -4929,9 +5333,11 @@
.IPs "quality (-500\-0)"
quality correction in %
.RE
+.
.TP
.B vrc_init_cplx=<0\-1000>
initial complexity (pass\ 1)
+.
.TP
.B vqsquish=<0,1>
specify how to keep the quantizer between qmin and qmax (pass\ 1/\:2):
@@ -4943,6 +5349,7 @@
use a nice differentiable function (default)
.RE
.PD 1
+.
.TP
.B vlelim=<-1000\-1000>
Sets single coefficient elimination threshold for luminance.
@@ -4956,6 +5363,7 @@
(JVT recommendation)
.RE
.PD 1
+.
.TP
.B vcelim=<-1000\-1000>
Sets single coefficient elimination threshold for chrominance.
@@ -4968,6 +5376,7 @@
.IPs 7
(JVT recommendation)
.RE
+.
.TP
.B vstrict=<-1,0,1>
strict standard compliance
@@ -4982,6 +5391,7 @@
played by the official huffyuv codec)
.RE
.PD 1
+.
.TP
.B vdpart\
data partitioning.
@@ -4998,6 +5408,7 @@
(details)
.RE
.PD 1
+.
.TP
.B \
MV & DC are most important, loosing them looks far worse than loosing
@@ -5006,6 +5417,7 @@
will hit the AC partition much more often than the MV&DC partitions.
Thus, the picture will look better with partitioning than without,
as without partitioning an error will trash AC/\:DC/\:MV equally.
+.
.TP
.B vpsize=<0\-10000>
video packet size, improves error-resistance (see \-vdpart option too):
@@ -5015,12 +5427,15 @@
.IPs 100-1000
good choice
.RE
+.
.TP
.B ss\ \ \ \ \
slice structured mode for H.263+
+.
.TP
.B gray\ \ \
grayscale only encoding (faster)
+.
.TP
.B vfdct=<0\-10>
dct algorithm:
@@ -5042,6 +5457,7 @@
floating point AAN
.RE
.PD 1
+.
.TP
.B idct=<0\-99>
idct algorithm.
@@ -5072,6 +5488,7 @@
sh4
.RE
.PD 1
+.
.TP
.B lumi_mask=<0.0\-1.0>
luminance masking
@@ -5088,6 +5505,7 @@
.IPs 0.0\-0.3
sane range
.RE
+.
.TP
.B dark_mask=<0.0\-1.0>
darkness masking
@@ -5104,9 +5522,11 @@
.IPs 0.0\-0.3
sane range
.RE
+.
.TP
.B tcplx_mask=<0.0\-1.0>
temporal complexity masking (default: 0.0 (disabled))
+.
.TP
.B scplx_mask=<0.0\-1.0>
Spatial complexity masking.
@@ -5122,9 +5542,11 @@
.IPs 0.0\-0.5
sane range
.RE
+.
.TP
.B p_mask=<0.0\-1.0>
inter MB masking (default: 0.0 (disabled))
+.
.TP
.B naq\ \ \ \
Normalize adaptive quantization (experimental).
@@ -5132,15 +5554,19 @@
longer match the requested frame-level quantizer.
Naq will attempt to adjust the per-MB quantizers to maintain the proper
average.
+.
.TP
.B ildct\ \
use interlaced dct
+.
.TP
.B ilme\ \ \
Use interlaced motion estimation (mutually exclusive with qpel).
+.
.TP
.B alt\ \ \ \
use alternative scantable
+.
.TP
.B top=<-1\-1>\ \ \
.RSs
@@ -5151,6 +5577,7 @@
.IPs 1
top field first
.RE
+.
.TP
.B format=<value>
.RSs
@@ -5165,6 +5592,7 @@
.IPs BGR32
for lossless jpeg and ffv1
.RE
+.
.TP
.B pred\ \ \
(for huffyuv)
@@ -5178,6 +5606,7 @@
median prediction
.RE
.PD 1
+.
.TP
.B pred\ \ \
(for lossless JPEG)
@@ -5195,6 +5624,7 @@
mean prediction
.RE
.PD 1
+.
.TP
.B coder\ \
(for ffv1)
@@ -5206,6 +5636,7 @@
arithmetic coding (cabac)
.RE
.PD 1
+.
.TP
.B context
(for ffv1)
@@ -5217,22 +5648,28 @@
large context model
.RE
.PD 1
+.
.TP
.B qpel\ \ \
Use quarter pel motion compensation (mutually exclusive with ilme).
Hint: This seems only useful for high bitrate encodings.
+.
.TP
.B ildctcmp=<0\-2000>
comparison function for interlaced dct decision
+.
.TP
.B precmp=<0\-2000>
comparison function for motion estimation pre pass
+.
.TP
.B cmp=<0\-2000>
comparison function for full pel motion estimation
+.
.TP
.B subcmp=<0\-2000>
comparison function for sub pel motion estimation
+.
.TP
.B mbcmp=<0\-2000>
comparison function for the macroblock decision, only used if mbd=0
@@ -5264,13 +5701,16 @@
use chroma too, doesn't work (correctly) with B frames currently
.RE
.PD 1
+.
.TP
.B nssew=<0\-100>
NSSE weight, larger weights will result in more noise,
with 0 NSSE is identical to SSE.
+.
.TP
.B predia=<-99\-6>
Diamond type and size for motion estimation pre pass
+.
.TP
.B dia=<-99\-6>
Diamond type & size for motion estimation.
@@ -5305,6 +5745,7 @@
0
.fi
.RE
+.
.TP
.B trell\ \
Trellis searched quantization.
@@ -5323,19 +5764,23 @@
sum of squared errors of the quantization
.RE
.PD 1
+.
.TP
.B cbp\ \ \ \
Rate distorted optimal coded block pattern.
Will select the coded block pattern which minimizes distortion + lambda*rate.
This can only be used together with trellis quantization.
+.
.TP
.B mv0\ \ \ \
Try to encode each MB with MV=<0,0> and choose the better one.
This has no effect if mbd=0.
+.
.TP
.B qprd\ \ \
rate distorted optimal QP for the given lambda of each macroblock, note this
needs mbd=2
+.
.TP
.B last_pred=<0\-99>
Amount of motion predictors from the previous frame
@@ -5348,6 +5793,7 @@
previous frame
.RE
.PD 1
+.
.TP
.B preme=<0\-2>
motion estimation pre-pass
@@ -5361,33 +5807,40 @@
always
.RE
.PD 1
+.
.TP
.B subq=<1\-8>
subpel refinement quality (for qpel) (default: 8).
.br
.I NOTE:
This has a significant effect on speed.
+.
.TP
.B psnr\ \ \
print the psnr (peak signal to noise ratio) for the whole video after encoding
and store the per frame psnr in a file with a name like 'psnr_hhmmss.log'.
Returned values are in dB (decibel), the higher the better.
+.
.TP
.B mpeg_quant
Use MPEG quantizers instead of H.263.
+.
.TP
.B aic\ \ \ \
ac prediction (=advanced intra prediction for H.263+)
.br
.I NOTE:
vqmin should be 8 or larger for AIC H.263+.
+.
.TP
.B aiv\ \ \ \
alternatice inter vlc for H.263+
+.
.TP
.B umv\ \ \ \
unlimited MVs (H.263+ only)
Allow encoding of abritarily long MVs.
+.
.TP
.B ibias=<-256\-256>
intra quantizer bias (256 == 1.0)
@@ -5399,6 +5852,7 @@
.I NOTE:
The H.263 MMX quantizer cannot handle positive biases (set vfdct=1 or 2),
the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
+.
.TP
.B pbias=<-256\-256>
inter quantizer bias (256 == 1.0)
@@ -5412,9 +5866,11 @@
the MPEG MMX quantizer cannot handle negative biases (set vfdct=1 or 2).
.br
Tip: a more positive bias (-32 \- -16 instead of -64) seems to improve the PSNR
+.
.TP
.B nr=<0\-100000>
noise reduction, 0 is disabled
+.
.TP
.B qns=<0\-3>
Quantizer noise shaping, reduces ringing artefacts, larger values are slower
@@ -5434,29 +5890,36 @@
try all
.RE
.PD 1
+.
.TP
.B inter_matrix=<comma separated matrix>
Use custom inter matrix.
It needs a comma separated string of 64 integers.
+.
.TP
.B intra_matrix=<comma separated matrix>
Use custom intra matrix.
It needs a comma separated string of 64 integers.
+.
.TP
.B vqmod_amp
experimental quantizer modulation
+.
.TP
.B vqmod_freq
experimental quantizer modulation
+.
.TP
.B dc\ \ \ \ \
intra DC precision in bits (default: 8).
If you specify vcodec=mpeg2video this value can be 8, 9, 10 or 11.
+.
.TP
.B cgop\ \ \
Close all GOPs.
Currently it doesn't work (yet).
.
+.
.SS nuv (\-nuvopts)
.
Nuppel video is based on rtjpeg and lzo.
@@ -5468,21 +5931,27 @@
.I NOTE:
The nuvrec documentation contains some advice and examples about the
settings to use for the most common TV encodings.
+.
.TP
.B c=<0\-20>
chrominance threshold
+.
.TP
.B l=<0\-20>
luminance threshold
+.
.TP
.B nolzo \
Disable the lzo compression.
+.
.TP
.B q=<3\-255>
Set the quality level.
+.
.TP
.B raw \ \ \
Disable rtjpeg encoding.
+.
.TP
.B rtjpeg\
Enable rtjpeg encoding.
@@ -5491,9 +5960,11 @@
.
There are three modes available: constant bitrate (CBR), fixed quantizer and
2pass.
+.
.TP
.B pass=<1|2>
Specify the pass in 2pass mode.
+.
.TP
.B bitrate=<value>
Sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second
@@ -5502,9 +5973,11 @@
If <value> is negative, XviD will use its absolute value as the target size
(in kbytes) of the video and compute the associated bitrate automagically.
(CBR or 2pass mode, default: 687 kbits/\:s)
+.
.TP
.B fixed_quant=<1\-31>
Switch to fixed quantizer mode and specify the quantizer to be used.
+.
.TP
.B me_quality=<0\-6>
This option controls the motion estimation subsystem.
@@ -5513,10 +5986,12 @@
Precision is gained at the expense of CPU time so decrease this setting if
you need realtime encoding.
(default: 6)
+.
.TP
.B interlacing
Encode the fields of interlaced video material.
Turn this option on for interlaced content.
+.
.TP
.B 4mv\ \ \ \
Use 4 motion vectors per macroblock.
@@ -5524,11 +5999,13 @@
.br
.I WARNING:
This option doesn't exist in XviD-1.0.x.
+.
.TP
.B rc_reaction_delay_factor=<value>
This parameter controls the delay in frames before the CBR rate controller
will react to bitrate changes and will try to compensate the change to obtain
a constant bitrate over an averaging range of frames.
+.
.TP
.B rc_averaging_period=<value>
Real CBR is hard to achieve.
@@ -5537,26 +6014,32 @@
amount of bits (minus a small variation).
This settings expresses the "number of frames" for which XviD averages
bitrate and tries to achieve CBR.
+.
.TP
.B rc_buffer=<value>
size of the rate control buffer
+.
.TP
.B quant_range=<1\-31>\-<1\-31>[/\:<1\-31>\-<1\-31>]
min & max quantizer for all frames (default: 2\-31, CBR mode)
.br
min & max quantizer for I/\:P frames (default: 2\-31/\:2\-31, 2pass mode)
+.
.TP
.B min_key_interval=<value>
minimum interval between keyframes (default: 0, 2pass only)
+.
.TP
.B max_key_interval=<value>
maximum interval between keyframes (default: 10*fps)
+.
.TP
.B mpeg_quant
Use MPEG quantizers instead of H.263.
For high bitrates, you will find that MPEG quantization preserves more detail.
For low bitrates, the smoothing of H.263 will give you less block noise.
When using custom matrices, MPEG must be used.
+.
.TP
.B mod_quant
Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis.
@@ -5565,23 +6048,28 @@
This will generate an illegal bitstream, and most likely not be decodable
by any MPEG4 decoder besides libavcodec or XviD.
(2pass mode only)
+.
.TP
.B greyscale
Make XviD discard chroma planes so the encoded video is greyscale only.
Note that this does not speed up encoding, it just prevents chroma data
from being written in the last stage of encoding.
+.
.TP
.B debug\ \
Save per-frame statistics in ./xvid.dbg.
This is NOT the 2pass control file.
+.
.TP
.B keyframe_boost=<0\-1000>
Shift some bits from the pool for other frame types to intra frames,
thus improving keyframe quality.
(default: 0, 2pass mode only)
+.
.TP
.B kfthreshold=<value>
(default: 10, 2pass mode only)
+.
.TP
.B kfreduction=<0\-100>
The above two settings can be used to adjust the size of keyframes that
@@ -5591,10 +6079,12 @@
The last i-frame will get treated normally.
(default: 30, 2pass mode only)
.RE
+.
.PP
.sp 1
The following options are only available with the latest stable
releases of XviD 1.0.x (api4).
+.
.TP
.B packed\
Create a bitstream which can be decoded delay-free.
@@ -5606,9 +6096,11 @@
.I WARNING:
This will also store a fake DivX version in the file so the bug
autodetection of some decoders might be confused.
+.
.TP
.B divx5bvop
generate DivX5 compatible B-frames (default: on)
+.
.TP
.B qpel\ \ \
MPEG4 uses a half pixel precision for its motion search by default.
@@ -5620,12 +6112,14 @@
quality at a fixed bitrate.
It's better to test with and without this option and see whether it
is worth activating.
+.
.TP
.B gmc\ \ \ \
Enable Global Motion Compensation, which makes XviD generate special
frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images.
Whether or not the use of this option will save bits is highly
dependent on the source material.
+.
.TP
.B trellis
Trellis Quantization is a kind of adaptive quantization method that
@@ -5634,11 +6128,13 @@
Its impact on quality is good, and if VHQ uses too much CPU for you,
this setting can be a good alternative to save a few bits (and gain
quality at fixed bitrate) at a lesser cost than with VHQ.
+.
.TP
.B cartoon
Activate this if your encoded sequence is an anime/\:cartoon.
It modifies some XviD internal thresholds so XviD takes better decisions on
frame types and motion vectors for flat looking cartoons.
+.
.TP
.B chroma_me
The usual motion estimation algorithm uses only the luminance information to
@@ -5646,6 +6142,7 @@
However for some video material, using the chroma planes can help find
better vectors.
This setting toggles the use of chroma planes for motion estimation.
+.
.TP
.B chroma_opt
Enable a chroma optimizer prefilter.
@@ -5656,6 +6153,7 @@
picture will get bigger, but the subjective image quality will raise.
Since it works with color information, you might want to turn it off when
encoding in greyscale.
+.
.TP
.B reduced
Enable encoding reduced-resolution frames.
@@ -5663,15 +6161,19 @@
.I WARNING:
The bitstream created is outside any MPEG-4 profile!
This means it most likely won't be decodable by anything except XviD.
+.
.TP
.B max_bframes=<0\-4>
maximum number of B frames to put between I/\:P frames (default: 0)
+.
.TP
.B bquant_ratio=<0\-1000>
quantizer ratio between B and non B frames, 150=1.50 (default: 150)
+.
.TP
.B bquant_offset=<-1000\-1000>
quantizer offset between B and non B frames, 100=1.00 (default: 100)
+.
.TP
.B bf_threshold=<-255\-255>
Sometimes B frames do not look good, and introduce artifacts when most of
@@ -5681,9 +6183,11 @@
This setting allows you to favorize or not, the use of B frames.
The higher the value, the higher the probability of B frames being used.
(default: 0)
+.
.TP
.B hq_ac\ \
Activates High Quality AC coefficient prediction from neighbor blocks.
+.
.TP
.B vhq=<0\-4>
The motion search algorithm is based on a search in the usual color domain
@@ -5707,6 +6211,7 @@
wide search
.RE
.PD 1
+.
.TP
.B aspect=<x/\:y | f (float value)>
Store movie aspect internally, just like MPEG files.
@@ -5714,31 +6219,39 @@
MPlayer and a few others players will play these files correctly, others
will display them with the wrong aspect.
The aspect parameter can be given as a ratio or a floating point number.
+.
.TP
.B autoaspect
Same as the aspect option, but automatically computes aspect, taking
into account all the adjustments (crop/\:expand/\:scale/\:etc.) made in the
filter chain.
+.
.TP
.B psnr\ \ \
Print the psnr (peak signal to noise ratio) for the whole video after encoding
and store the per frame psnr in a file with a name like 'psnr_hhmmss.log' in
the current directory.
Returned values are in dB (decibel), the higher the better.
+.
+.
.SS x264enc (\-x264encopts)
+.
.TP
.B bitrate=<value>
Sets the bitrate to be used in kbits/\:second (default: off).
This is required if you want a CBR (constant bitrate) encode.
+.
.TP
.B iframe=<value>
Frequency of I frames (default: 60)
+.
.TP
.B frameref=<value>
Number of previous frames used as predictors in a P-frame (default: 1)
.br
.I NOTE:
The current version of x264 (r38) hasn't yet implemented this feature.
+.
.TP
.B idrframe=<value>
Each <value> I-Frames are IDR-Frames.
@@ -5748,12 +6261,15 @@
Therefore, I-frames are not necessarily seekable. IDR-Frames restrict
subsequent P-frames from referring to any frame prior to the IDR-Frame
(default: 2)
+.
.TP
.B bframe=<value>
Number of B-Frames between I- and P-Frames (default: 0)
+.
.TP
.B deblock=<0|1>
Use deblocking filter (default: on)
+.
.TP
.B deblockalpha=<-6-6>
AlphaC0 parameter of deblocking filter.
@@ -5764,13 +6280,16 @@
edge being filtered.
A positive value reduces blocking artifacts more, but will also smear details
(default: 0)
+.
.TP
.B deblockbeta=<-6-6>
Beta parameter of deblocking filter.
Affects the maximum allowed gradient within two adjacent blocks (default: 0)
+.
.TP
.B cabac
Use CABAC (Context-Adaptive Binary Arithmetic Coding) (default: off)
+.
.TP
.B cabacidc=<value>
Initial value of CABAC IDC.
@@ -5787,6 +6306,7 @@
.br
2: high complexity
.REss
+.
.TP
.B qp_constant=<2-51>
This selects the quantizer to use.
@@ -5801,48 +6321,60 @@
This option takes effect even if you specify a cbr encode.
In such a case, the first frame encoded will use the quantization factor you
specified, but in later frames, the ratecontrol decides what quants to use.
+.
.TP
.B qp_min=<2-51>
Minimum quantizer. CBR only. 20-40 seems to be a useful range (default: 2)
+.
.TP
.B qp_max=<2-51>
Maximum quantizer. CBR only.
+.
.TP
.B qp_step=<value>
Maximum Value by which the quantizer may be incremented/decremented between
frames.
+.
.TP
.B rc_buffer_size=<value>
Size of the ratecontrol buffer. (default: 1 second's worth at the bitrate you
specified)
+.
.TP
.B rc_init_buffer=<value>
Set the initial size of ratecontrol buffer (default: 1/4 of rc_buffer_size)
.B rc_sens=<0-100>
Ratecontrol sensitivity (default: 100)
+.
.TP
.B ip_factor=<value>
Quantizer factor between I amd P frames (default: 2.0)
+.
.TP
.B pb_factor=<value>
Quantizer factor between P and B frames (default: 2.0)
+.
.TP
.B pass=<1|2>
For 2-pass mode. The first pass saves statistics.
+.
.TP
.B qcompress=<0-1>
Quantizer compression. This affects the ratecontrol: a lower value makes the
bitrate more constant, while a higher value makes the quantization parameter
more constant (default: 0.6)
+.
.TP
.B qblur=<0-1>
Temporal blur of the quantization parameter. Lower values allow the quantizer
value to jump around more; higher values force it to vary more smoothly
(default: 0.5)
+.
.TP
.B fullinter
Use all available interframe analyse methods (i4x4, psub8x8, psub16x16)
(default: 4x4, psub16x16)
+.
.TP
.B log=<-1-3>
Adjust the amount of logging info printed to the screen.
@@ -5857,6 +6389,7 @@
.br
3: PSNR, qp, frametype, size, and other stats for every frame
.REss
+.
.TP
.B psnr
Print signal-to-noise ratio statistics.
@@ -5867,27 +6400,35 @@
.\" --------------------------------------------------------------------------
.
.SH FILES
+.
.TP
/etc/\:mplayer/\:mplayer.conf
system-wide settings
+.
.TP
~/.mplayer/\:config
user settings
+.
.TP
~/.mplayer/\:input.conf
input bindings (see '\-input keylist' for full keylist)
+.
.TP
~/.mplayer/\:gui.conf
GUI configuration file
+.
.TP
~/.mplayer/\:gui.pl
GUI playlist
+.
.TP
~/.mplayer/\:font/
font directory (There must be a font.desc file and files with .RAW extension.)
+.
.TP
~/.mplayer/\:DVDkeys/
cached CSS keys
+.
.TP
Sub files are searched for in this order (for example /mnt/\:cdrom/\:movie.avi):
.RS
@@ -5905,71 +6446,92 @@
.\" --------------------------------------------------------------------------
.
.SH EXAMPLES
+.
.TP
.B Quickstart DVD playing
mplayer dvd://1
+.
.TP
.B Play in japanese with english subtitles
mplayer dvd://1 \-alang ja \-slang en
+.
.TP
.B Play only chapters 5, 6, 7
mplayer dvd://1 \-chapter 5-7
+.
.TP
.B Play only titles 5, 6, 7
mplayer dvd://5-7
+.
.TP
.B Multiangle DVD playing
mplayer dvd://1 \-dvdangle 2
+.
.TP
.B Playing from a different DVD device
mplayer dvd://1 \-dvd-device /dev/\:dvd2
+.
.TP
.B Stream from HTTP
mplayer http://mplayer.hq/\:example.avi
+.
.TP
.B Stream using RTSP
mplayer rtsp://server.example.com/\:streamName
+.
.TP
.B Convert subtitle to MPsub (to ./dump.mpsub)
mplayer dummy.avi \-sub source.sub \-dumpmpsub
+.
.TP
.B Convert subtitle to MPsub without watching the movie
mplayer /dev/\:zero \-rawvideo on:pal:fps=xx \-vc null \-vo null \-noframedrop
\-benchmark \-sub source.sub \-dumpmpsub
+.
.TP
.B Input from standard V4L
mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420
\-vo xv
+.
.TP
.B Playback on Zoran card (old style, deprecated)
mplayer \-vo zr \-vf scale=352:288 file.avi
+.
.TP
.B Playback on Zoran card (new style)
mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg file.avi
+.
.TP
.B Encoding DVD title #2, only selected chapters
mencoder dvd://2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
+.
.TP
.B Encoding DVD title #2, resizing to 640x480
mencoder dvd://2 \-vf scale=640:480 \-o title2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
+.
.TP
.B Encoding DVD title #2, resizing to 512xHHH (keep aspect ratio)
mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o title2.avi \-oac copy
\-ovc lavc \-lavcopts vcodec=mpeg4
+.
.TP
.B The same, but with libavcodec family, MPEG4 (Divx5) compression
mencoder dvd://2 \-o title2.avi \-ovc lavc
\-lavcopts vcodec=mpeg4:vhq:vbitrate=1800 \-oac copy
+.
.TP
.B The same, but with libavcodec family, MJPEG compression
mencoder dvd://2 \-o titel2.avi \-ovc lavc
\-lavcopts vcodec=mjpeg:vhq:vbitrate=1800 \-oac copy
+.
.TP
.B Encoding all *.jpg files in the current dir
mencoder "mf://*.jpg" \-mf fps=25 \-o output.avi \-ovc lavc \-lavcopts vcodec=mpeg4
+.
.TP
.B Encoding from tuner (specify a format with \-vf format)
mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw
+.
.TP
.B Encoding from a pipe
rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \-
@@ -5987,12 +6549,15 @@
explains how to create useful bug reports.
.
.
+.
.SH AUTHORS
MPlayer was initially written by Arpad Gereoffy.
See the AUTHORS file for a list of some of the many other contributors.
+.
.TP
MPlayer is (C) 2000\-2004
.B The MPlayer Team
+.
.TP
This man page is written and maintained by
.B Gabucino
@@ -6000,6 +6565,7 @@
.B Diego Biurrun
.br
.B Jonas Jermann
+.
.PP
Please send mails about it to the MPlayer-DOCS mailing list.
.\" end of file
More information about the MPlayer-DOCS
mailing list