diff options
author | diego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2004-08-28 17:35:32 +0000 |
---|---|---|
committer | diego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2004-08-28 17:35:32 +0000 |
commit | df93a9ddc894c4a4bae16523822e9dfa92434ca7 (patch) | |
tree | d0736e201b129462b695ce825859c0faf320cc82 | |
parent | f9e3624bbb383cf10f993935d5771889555a16b0 (diff) |
Consistently insert lines with only "." between options.
Greatly improves readability.
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@13176 b3059339-0415-0410-9bf9-f77b7e298cf2
-rw-r--r-- | DOCS/man/en/mplayer.1 | 604 |
1 files changed, 585 insertions, 19 deletions
diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1 index 9713a80420..8cb1dd38e2 100644 --- a/DOCS/man/en/mplayer.1 +++ b/DOCS/man/en/mplayer.1 @@ -49,12 +49,14 @@ mencoder \- movie encoder .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 @@ mencoder \- movie encoder [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 @@ or remote control (with LIRC). 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 @@ named 'movie.avi.conf' with the file-specific options in it and put it in ~/.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 @@ prints everything related to input parsers (parser debug) . . .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 @@ 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. @@ -397,6 +418,7 @@ 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. @@ -406,23 +428,27 @@ video codec. .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 @@ seconds of playback will be written to the file. 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 @@ all files). 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 @@ several 'echo "seek 10" > mp_pipe' and the pipe will stay valid. .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 @@ 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 \-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 @@ 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 \-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 @@ Instead of intercepting keyboard events, MPlayer will read commands from stdin. .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 @@ and 1 (which is the default) means full compression (make loud passages more 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 @@ VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190). 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 @@ Plays Hungarian and falls back to English if Hungarian is not available. 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 @@ full 5.1 .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 @@ or ~/.mplayer/\:channels.conf as a last resort. .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 @@ You can fix the index permanently with MEncoder (see the documentation). .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 @@ 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 \-idx (also see \-forceidx) Rebuilds index of files if no index was found, allowing seeking. @@ -809,10 +885,12 @@ Useful with broken/\:incomplete downloads, or badly created files. .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 @@ 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. @@ -849,10 +929,12 @@ input file type (available: jpeg, png, tga, sgi) .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 @@ 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 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 @@ 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.live.com/\:mplayer/). +. .TP .B \-saveidx <filename> Force index rebuilding and dump the index to <filename>. @@ -936,14 +1023,17 @@ 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> (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 @@ or even 'tv://<channel_name> (see option channels for channel_name below) as a movie URL. .sp 1 Available options are: -. .RSs .IPs noaudio no sound @@ -1104,56 +1193,66 @@ Choose the quality of the JPEG compression .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 @@ bold black outline .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 @@ With fontconfig, this option determines the fontconfig font name. .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 @@ volume + seek + timer + percentage + total time 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 @@ align at bottom .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 @@ Load all subs in the current directory. .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 @@ Display DVD Closed Caption (CC) subtitles. 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 @@ Guess the encoding for Polish, fall back to cp1250. .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 @@ proportional to movie diagonal (default) .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 @@ compressor / 'soft-clipping' capabilities (volume plugin only) .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 @@ signed 32-bit (big-endian) .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 @@ 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. +. .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 @@ Try the ALSA driver, then the OSS driver, then others. 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 @@ Sets the device name. 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 @@ OSS audio output driver 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 @@ decoding another. 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 @@ Tune the overlay (default: 1000). .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 @@ Change video mode to the one that is labeled as <modename> in .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 @@ unsupported modes are specified. 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 @@ Places the window at the bottom right corner of the screen. 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 @@ Must be equal to or larger than 1 (default: 1000). .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 @@ Set the aspect ratio of your monitor or TV screen. .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 @@ Supported by the dga, x11, xv, sdl and directx video output drivers. If used with the directx video output driver the \-screenw, \-screenh, \-bpp and \-refreshrate options can be used to set the new display mode. +. .TP .B \-vsync \ \ Enables VBI for the vesa, dfbmga and svga video output drivers. +. .TP .B \-wid <window\ id> (also see \-guiwid) (X11 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 @@ Options appearing after the n-th \-zrcrop apply to the n-th MJPEG card, each card should at least have a \-zrdev in addition to the \-zrcrop. For examples, see the output of \-zrhelp and the Zr section of the documentation. +. .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 @@ Try the Matrox X11 driver, then the Xv driver, then others. 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 @@ the best option. 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 @@ Do not use sleep function while waiting for rendering to finish (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 @@ Available subdevice drivers are cyberblade_vid, mach64_vid, mga_crtc2_vid, 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 @@ X11 frontend for VIDIX same as vidix .RE .PD 1 +. .TP .B cvidix\ Generic and platform independent VIDIX frontend, can even run in a @@ -2195,6 +2402,7 @@ textconsole with nVidia cards. same as vidix .RE .PD 1 +. .TP .B winvidix (Windows only) Windows frontend for VIDIX @@ -2204,6 +2412,7 @@ Windows frontend for VIDIX same as vidix .RE .PD 1 +. .TP .B directx (Windows only) Video output driver that uses the DirectX interface. @@ -2214,6 +2423,7 @@ Turns off hardware acceleration. 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 @@ packed YUV output format, with e.g.\& \-vf format=yuy2. 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 FIXME: document this .RE .PD 1 +. .TP .B svga\ \ \ Play video using the SVGA library. @@ -2272,6 +2486,7 @@ Try to select a video mode with square pixels. Use svga with VIDIX. .RE .PD 1 +. .TP .B gl\ \ \ \ \ OpenGL video output driver. @@ -2288,27 +2503,34 @@ Number of lines copied to texture in one piece (default: 4). 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 @@ motions watching interlaced film material. 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 @@ 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. +. .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. 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 TV norm. 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 @@ 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). .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 @@ Useful for debugging. 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 @@ images and stores it in a file called 'stream.yuv' in the current 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 @@ try other codecs except FFmpeg's MP3 decoder 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 @@ nsamples: number of samples per channel (default: 512) .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 @@ It's autodetected on MPEG files, but can't be autodetected on most AVI files. .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 @@ Just add the values of the things you want to enable. .br Available options are: .RE -. .RSs .IPs ec\ \ \ error concealment: @@ -2793,13 +3035,16 @@ 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 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 @@ quality and performance. . 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 @@ with Win32 DirectShow DLLs which have internal postprocessing routines. . 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 @@ Specifies SwScaler parameters. \-vf scale \-ssf lgb=3.0 .RE .PD 1 -. .PD 0 .RSs .IPs lgb=<0\-100> @@ -2850,7 +3097,6 @@ chroma vertical shifting .TP .B \-stereo <mode> Select type of MP2/\:MP3 stereo output. -. .PD 0 .RSs .IPs 0 @@ -2955,10 +3201,10 @@ Try XAnim codecs first. .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 @@ Set width to value and calculate height to keep correct aspect ratio. .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 @@ Could be used to force scaling with \-vf scale. \-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 @@ To get a full list of available filters, see \-vf help. .sp 1 Filters are managed in lists. There are a few commands to manage the filter list. +. .TP .B \-vf-add <filter1[,filter2,...]> Appends the filters given as arguments to the filter list. +. .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 @@ Cropped width and height, defaults to original width and height. 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 @@ to stdout. 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 @@ are still visible. 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 @@ OSD/\:subtitle rendering 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 @@ sntsc: 640x480 (square pixel NTSC) 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 @@ desired. 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 @@ RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion. 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 @@ For a list of available formats see format=fmt=help. 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 @@ For a list of available formats see noformat=fmt=help. 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 @@ Deblock horizontal only luminance 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 @@ -3300,6 +3573,7 @@ force quantization parameter (default: 0, use qp from video) .br 1: soft thresholding (better deringing, but blurrier) .RE +. .TP .B qp=equation qp change filter @@ -3307,13 +3581,16 @@ qp change filter .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 @@ Faster and of better quality than \-vf fame. .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 @@ It's only useful together with expand+scale 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 @@ spatial chroma strength (default = 3) 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 @@ Might also be useful with MEncoder, either for fixing poorly captured 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 @@ weight=1.0. 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 @@ By default, halfpack averages pairs of lines when downsampling. 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 @@ scanline, the luma and chroma data both come from the same field. 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 @@ files or if you plan to demux and remux the video stream after 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 @@ This allows filters which need to see all frames (inverse telecine, 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 @@ block. 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 additional sharpening (default: 0). 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 @@ Relative amount of sharpness/\:blur to add to the image >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 @@ interleave swap fields (exchange even & odd lines) .RE .PD 1 +. .TP .B fil=[i|d] (de)interleaves lines. @@ -3564,12 +3860,14 @@ Deinterleave fields, placing them side by side. 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 @@ frame before the movie starts. .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 @@ As with detc, you must specify the correct output framerate (\-ofps 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 @@ Always follow pullup with the softskip filter when encoding to ensure 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 @@ Default is 128. .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 @@ 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 @@ -3834,6 +4138,7 @@ 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%. @@ -3843,6 +4148,7 @@ Both fps options are essential! (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 @@ expand each frame to full height, but pad alternate lines with black, 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 linear interp (no jump) 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 @@ size of the filter 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 @@ How different the pixels are allowed to be considered. (~0.1\-100.0) .RE .PD 1 +. .TP .B smartblur=rad:strength:thresh[:rad:strength:thresh] smart blur @@ -3922,6 +4232,7 @@ blur (0.0\-1.0) or sharpen (-1.0\-0.0) 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 @@ coordinates of the top left, top right, bottom left, bottom right corners 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 @@ them to maintain the original movie aspect. 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 @@ send 1,8MB of RGBA32 data everytime a small part of the screen is updated. .REss .RE .PD 1 +. .TP .B framestep=I|[i]step Renders only every nth frame or every Intra (key) frame. @@ -4046,6 +4361,7 @@ If you put an 'i' (lowercase) before the number then an I! is printed .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 at the start (x/\:y) (default: 2) 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 @@ When set to -1, a green rectangle is drawn on the screen to 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 @@ decimation (ugly). .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 @@ will have the output file contain 'div3' as video fourcc. .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 @@ general comments about the work 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 @@ raw video stream (no muxing - video only, one stream only) 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 @@ encode with a libavcodec codecs .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 @@ Where <codec> may be: lavc, xvidenc, divx4, lame, x264 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 @@ specify bitrate .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 @@ Final (second) pass of two pass encoding. .TP .B help\ \ \ get help +. .TP .B vbr=<0\-4> variable bitrate method @@ -4397,29 +4744,37 @@ abr 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 @@ dualchannel mono .RE .PD 1 +. .TP .B padding=<0\-2> .PD 0 @@ -4447,22 +4803,26 @@ all 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 @@ AC3 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 @@ should only be used for regression tests, which need binary 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 @@ ASUS Video v2 FFmpeg's lossless video codec .RE .PD 1 +. .TP .B vqmin=<1\-31> minimum quantizer (pass\ 1/\:2) @@ -4597,32 +4963,40 @@ The reason for preferring 3 over 2 is that 2 could lead to overflows (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 @@ no B frames (default) sane range for MPEG4 .RE .PD 1 +. .TP .B vme=<0\-5> motion estimation method. @@ -4658,9 +5033,11 @@ EPZS (default) 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 needs the fewest bits (=vhq) 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 @@ Values >300 are not recommended as the quality might be bad depending upon 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 @@ Libavcodec inserts a keyframe when it detects a scene change. 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 @@ always use the maximum number of B frames (default) .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 @@ Encodes with an optimal Huffman table based upon statistics from the first pass. .RE .PD 1 +. .TP .B aspect=<x/\:y> Store movie aspect internally, just like MPEG files. @@ -4759,11 +5146,13 @@ The aspect parameter can be given as a ratio or a floating point number. .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 @@ Warning: 1kBit = 1000 Bits. .IPs 800 default .RE +. .TP .B vratetol=<value> approximated filesize tolerance in kBit. @@ -4786,32 +5176,41 @@ approximated filesize tolerance in kBit. .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 @@ else .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 @@ qblur disabled .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 @@ quantizer .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 clipping 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 @@ disabled (default) (JVT recommendation) .RE .PD 1 +. .TP .B vcelim=<-1000\-1000> Sets single coefficient elimination threshold for chrominance. @@ -4968,6 +5376,7 @@ disabled (default) .IPs 7 (JVT recommendation) .RE +. .TP .B vstrict=<-1,0,1> strict standard compliance @@ -4982,6 +5391,7 @@ allows non-standard YV12 huffyuv encoding (20% smaller files, but cannot be played by the official huffyuv codec) .RE .PD 1 +. .TP .B vdpart\ data partitioning. @@ -4998,6 +5408,7 @@ Each video packet will be encoded in 3 separate partitions: (details) .RE .PD 1 +. .TP .B \ MV & DC are most important, loosing them looks far worse than loosing @@ -5006,6 +5417,7 @@ the AC and the 1. & 2. partition. 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 @@ disabled (default) .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 @@ altivec floating point AAN .RE .PD 1 +. .TP .B idct=<0\-99> idct algorithm. @@ -5072,6 +5488,7 @@ altivec sh4 .RE .PD 1 +. .TP .B lumi_mask=<0.0\-1.0> luminance masking @@ -5088,6 +5505,7 @@ disabled (default) .IPs 0.0\-0.3 sane range .RE +. .TP .B dark_mask=<0.0\-1.0> darkness masking @@ -5104,9 +5522,11 @@ disabled (default) .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 @@ disabled (default) .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 @@ When using adaptive quantization (*_mask), the average per-MB quantizer may no longer match the requested frame-level quantizer. Naq will attempt to adjust the per-MB quantizers to maintain the proper average. +. .TP .B ildct\ \ use interlaced dct +. .TP .B ilme\ \ \ Use interlaced motion estimation (mutually exclusive with qpel). +. .TP .B alt\ \ \ \ use alternative scantable +. .TP .B top=<-1\-1>\ \ \ .RSs @@ -5151,6 +5577,7 @@ bottom field first .IPs 1 top field first .RE +. .TP .B format=<value> .RSs @@ -5165,6 +5592,7 @@ for lossless jpeg and ffv1 .IPs BGR32 for lossless jpeg and ffv1 .RE +. .TP .B pred\ \ \ (for huffyuv) @@ -5178,6 +5606,7 @@ plane/\:gradient prediction median prediction .RE .PD 1 +. .TP .B pred\ \ \ (for lossless JPEG) @@ -5195,6 +5624,7 @@ plane/\:gradient prediction mean prediction .RE .PD 1 +. .TP .B coder\ \ (for ffv1) @@ -5206,6 +5636,7 @@ vlc coding (golomb rice) arithmetic coding (cabac) .RE .PD 1 +. .TP .B context (for ffv1) @@ -5217,22 +5648,28 @@ small context model 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 @@ noise preserving sum of squared differences 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 @@ normal size=2 diamond 0 .fi .RE +. .TP .B trell\ \ Trellis searched quantization. @@ -5323,19 +5764,23 @@ amount of bits needed to encode the block 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 @@ will use 2a+1 x 2a+1 macro block square of motion vector predictors from the previous frame .RE .PD 1 +. .TP .B preme=<0\-2> motion estimation pre-pass @@ -5361,33 +5807,40 @@ only after I frames (default) 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 @@ H.263 style quantizer default: 0 .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 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). .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 @@ only change coefficients before the last non zero coefficient + 1 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 @@ default lzo compressed rtjpeg. .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 @@ Enable rtjpeg encoding. . 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 >16000. 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 @@ The more precise the motion estimation is, the more bits can be saved. 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 @@ This might give better compression, but slows down encoding. .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 @@ That's why XviD uses an averaging period for which it guarantees a given 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 @@ Decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis. 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 @@ kfreduction determines the bitrate reduction they get. The last i-frame will get treated normally. (default: 30, 2pass mode only) .RE +. .PP .sp 1 The following options are only available with the latest stable releases of XviD 1.0.x (api4). +. .TP .B packed\ Create a bitstream which can be decoded delay-free. @@ -5606,9 +6096,11 @@ decodable by ISO-MPEG4 decoders except DivX/\:libavcodec/\:XviD. .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 @@ higher bitrate use will prevent it from giving a better image 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 @@ compressible by the entropy encoder. 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 @@ find the best motion vector. 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 @@ It reduces PSNR by nature, as the mathematical deviation to the original 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 @@ Enable encoding reduced-resolution frames. .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 @@ surrounding the man and his mouth is completly static). 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 @@ medium search 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 @@ Much nicer solution than rescaling, because quality isn't decreased. 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 @@ frame before it (see the frameref option). 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 @@ Secondly, this parameter affects the threshold for difference across the 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 @@ directly affect distortion. .br 2: high complexity .REss +. .TP .B qp_constant=<2-51> This selects the quantizer to use. @@ -5801,48 +6321,60 @@ Useful quantizers in H.264 tend to be very large compared to mpeg[124]. 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 @@ Adjust the amount of logging info printed to the screen. .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 @@ Print signal-to-noise ratio statistics. .\" -------------------------------------------------------------------------- . .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 @@ Sub files are searched for in this order (for example /mnt/\:cdrom/\:movie.avi): .\" -------------------------------------------------------------------------- . .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 @@ The bug reporting section of the documentation (DOCS/\:HTML/\:en/\:bugreports.ht 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 @@ This man page is written and maintained by .B Diego Biurrun .br .B Jonas Jermann +. .PP Please send mails about it to the MPlayer-DOCS mailing list. .\" end of file |