vo_gl suboption doc improved
[mplayer.git] / DOCS / man / en / mplayer.1
1 .\" $Revision$
2 .\" MPlayer (C) 2000-2004 MPlayer Team
3 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
4 .
5 .\" --------------------------------------------------------------------------
6 .\" Macro definitions
7 .\" --------------------------------------------------------------------------
8 .
9 .\" default indentation is 7, don't change!
10 .nr IN 7
11 .\" define indentation for suboptions
12 .nr SS 5
13 .\" add new suboption
14 .de IPs
15 .IP "\\$1" \n(SS
16 ..
17 .\" begin of first level suboptions, end with .RE
18 .de RSs
19 .RS \n(IN+3
20 ..
21 .\" begin of 2nd level suboptions
22 .de RSss
23 .PD 0
24 .RS \n(SS+3
25 ..
26 .\" end of 2nd level suboptions
27 .de REss
28 .RE
29 .PD 1
30 ..
31 .
32 .\" --------------------------------------------------------------------------
33 .\" Title
34 .\" --------------------------------------------------------------------------
35 .
36 .TH MPlayer 1 "2004-01-16" "The MPlayer Project" "The Movie Player For Linux"
37 .
38 .SH NAME
39 mplayer  \- Movie Player for Linux
40 .br
41 mencoder \- Movie Encoder for Linux
42 .
43 .\" --------------------------------------------------------------------------
44 .\" Synopsis
45 .\" --------------------------------------------------------------------------
46 .
47 .SH SYNOPSIS
48 .na
49 .nh
50 .B mplayer
51 .RI [options]\ [ \ file\  | \ URL\  | \ playlist\  | \ \-\  ]
52 .br
53 .B mplayer
54 'in +\n[.k]u
55 [global options]
56 .I file1
57 [specific options] [file2] [specific options]
58 .br
59 .in
60 .B mplayer
61 'in +\n[.k]u
62 [global options]
63 .RI { "group of files and options" }
64 [group specific options]
65 .br
66 .in
67 .B mplayer
68 'in +\n[.k]u
69 .RI [ mms[t] | http | http_proxy | rt[s]p | ftp ] ://
70 [user:passwd@]\fIURL\fP[:port] [options]
71 .br
72 .in
73 .B mplayer
74 'in +\n[.k]u
75 .I dvd://title
76 [options]
77 .br
78 .in
79 .B mplayer
80 'in +\n[.k]u
81 .I vcd://track[/device]
82 [options]
83 .br
84 .in
85 .B mplayer
86 'in +\n[.k]u
87 .I tv://[channel]
88 [options]
89 .br
90 .in
91 .B mplayer
92 'in +\n[.k]u
93 .I mf://filemask
94 [options]
95 .br
96 .in
97 .B mplayer
98 'in +\n[.k]u
99 .I [cdda|cddb]://track[:speed][/device]
100 [options]
101 .br
102 .in
103 .B mplayer
104 'in +\n[.k]u
105 .I cue://file[:track]
106 [options]
107 .br
108 .in
109 .B mplayer
110 'in +\n[.k]u
111 .I sdp://file
112 [options]
113 .br
114 .in
115 .B mplayer
116 'in +\n[.k]u
117 .I mpst://host[:port]/URL
118 [options]
119 .br
120 .in
121 .B mplayer
122 'in +\n[.k]u
123 .I dvb://channel
124 [options]
125 .br
126 .in
127 .B mencoder
128 [options]
129 .RI [ \ file\  | \ URL\  | \ \-\  ]
130 [\-o\ file]
131 .br
132 .B gmplayer
133 [options]
134 [\-skin\ skin]
135 .ad
136 .hy
137 .
138 .\" --------------------------------------------------------------------------
139 .\" Description
140 .\" --------------------------------------------------------------------------
141 .
142 .SH DESCRIPTION
143 .B mplayer
144 is a movie player for LINUX (runs on many other Unices and non\-x86 CPUs, see
145 the documentation).
146 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, OGG/\:OGM,
147 VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
148 native, XAnim, and Win32 DLL codecs.
149 You can watch VideoCD, SVCD, DVD, 3ivx, DivX\ 3/\:4/\:5 and even WMV movies,
150 too (without using the avifile library).
151 .PP
152 Another great feature of MPlayer is the wide range of supported output
153 drivers.
154 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
155 Quartz, but you can also use GGI, SDL (and all their drivers), VESA (on every
156 VESA compatible card, even without X11), some low level card-specific drivers
157 (for Matrox, 3Dfx and ATI) and some hardware MPEG decoder boards, such as the
158 Siemens DVB, DXR2 and DXR3/\:Hollywood+.
159 Most of them support software or hardware scaling, so you can enjoy movies in
160 fullscreen.
161 .PP
162 MPlayer has an onscreen display (OSD) for status information, nice big
163 antialiased shaded subtitles and visual feedback for keyboard controls.
164 European/\:ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
165 fonts are supported along with 11 subtitle formats (MicroDVD, SubRip,
166 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
167 DVD subtitles (SPU streams, VobSub and Closed Captions).
168 .PP
169 .B mencoder
170 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
171 MPlayer-playable movies (see above) to other MPlayer-playable formats (see
172 below).
173 It encodes to DivX4, XviD, one of the libavcodec codecs and PCM/\:MP3/\:VBRMP3
174 audio in 1, 2 or 3\ passes.
175 Furthermore it has stream copying abilities, a powerful plugin system (crop,
176 expand, flip, postprocess, rotate, scale, noise, rgb/\:yuv conversion) and
177 more.
178 .PP
179 .B gmplayer
180 is MPlayer with a graphical user interface.
181 It has the same options as MPlayer.
182 .PP
183 .B Also see the HTML documentation!
184 .
185 .
186 .\" --------------------------------------------------------------------------
187 .\" Keyboard control
188 .\" --------------------------------------------------------------------------
189 .
190 .SH "KEYBOARD CONTROL"
191 MPlayer has a fully configurable, command driven, control layer
192 which allow you to control MPlayer using keyboard, mouse, joystick
193 or remote control (using lirc).
194 .br
195 The default configuration file for the input system is
196 ~/.mplayer/\:input.conf but it can be overriden
197 using the \-input conf option.
198 .br
199 These keys may/\:may not work, depending on your video output driver.
200 .TP
201 .B general control
202 .PD 0
203 .RSs
204 .IPs "<\- and \->"
205 seek backward/\:forward 10 seconds
206 .IPs "up and down"
207 seek backward/\:forward  1 minute
208 .IPs "pgup and pgdown"
209 seek backward/\:forward 10 minutes
210 .IPs "< and >"
211 backward/\:forward in playlist
212 .IPs "HOME and END"
213 go to next/\:previous playtree entry in the parent list
214 .IPs "INS and DEL"
215 go to next/\:previous alternative source (asx playlist only)
216 .IPs "p / SPACE"
217 pause movie (any key unpauses)
218 .IPs "q / ESC"
219 stop playing and quit
220 .IPs "+ and -"
221 adjust audio delay by +/\:- 0.1 second
222 .IPs "/ and *"
223 decrease/\:increase volume
224 .IPs "9 and 0"
225 decrease/\:increase volume
226 .IPs m\ \ \ \ 
227 mute sound
228 .IPs f\ \ \ \ 
229 toggle fullscreen
230 .IPs T\ \ \ \ 
231 toggle stay-on-top.
232 Supported by drivers which use X11, except SDL, as well as directx and gl2 under Windows.
233 .IPs "w and e"
234 decrease/\:increase panscan range
235 .IPs o\ \ \ \ 
236 toggle between OSD states: none / seek / seek+timer
237 .IPs d\ \ \ \ 
238 toggle between frame dropping states:  none / skip display / skip decoding
239 (see \-framedrop and \-hardframedrop)
240 .IPs v\ \ \ \ 
241 toggle subtitle visibility
242 .IPs j\ \ \ \ 
243 switch subtitle language
244 .IP F\ \ \ \ 
245 toggle display of "forced subtitles"
246 .IPs a\ \ \ \ 
247 toggle subtitle aligment: top/middle/bottom
248 .IPs "z and x"
249 adjust subtitle delay by +/\:- 0.1 second
250 .IPs "r and t"
251 adjust subtitle position
252 .IPs i\ \ \ \ 
253 set EDL mark
254 .RE
255 .PD 1
256 .PP
257 (The following keys are valid only when using a hardware accelerated video
258 output (xv, (x)vidix, (x)mga, etc), or the software equalizer filter
259 (\-vf eq or \-vf eq2).
260 .PP
261 .PD 0
262 .RSs
263 .IPs "1 and 2"
264 adjust contrast
265 .IPs "3 and 4"
266 adjust brightness
267 .IPs "5 and 6"
268 adjust hue
269 .IPs "7 and 8"
270 adjust saturation
271 .RE
272 .PD 1
273 .
274 .TP
275 .B GUI keyboard control
276 .PD 0
277 .RSs
278 .IPs ENTER
279 start playing
280 .IPs s\ \ \ \ 
281 stop playing
282 .IPs l\ \ \ \ 
283 load file
284 .IPs c\ \ \ \ 
285 skin browser
286 .IPs p\ \ \ \ 
287 toggle playlist
288 .RE
289 .PD 1
290 .
291 .TP
292 .B TV input control
293 .PD 0
294 .RSs
295 .IPs "h and k"
296 select previous/\:next channel
297 .IPs n\ \ \ \ 
298 change norm
299 .IPs u\ \ \ \ 
300 change channel list
301 .RE
302 .PD 1
303 .
304 .
305 .\" --------------------------------------------------------------------------
306 .\" Options
307 .\" --------------------------------------------------------------------------
308 .
309 .SH "USAGE"
310 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
311 \-fs option is \-nofs.
312 .PP
313 You can put all of the options in a configuration file which will be read
314 every time MPlayer is run.
315 The system-wide configuration file 'mplayer.conf' is in your configuration
316 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
317 specific one is '~/\:.mplayer/\:config'.
318 User specific options override system-wide options and options given on the
319 command line override either.
320 The syntax of the configuration files is 'option=<value>', everything after
321 a '#' is considered a comment.
322 Options that work without values can be enabled by setting them to 'yes'
323 or '1' and disabled by setting them to 'no' or '0'.
324 Even suboptions can be specified in this way.
325 .PP
326 .I EXAMPLE:
327 .br
328 # Use Matrox driver by default.
329 .br
330 vo=xmga
331 .br
332 # I love practicing handstands while watching videos.
333 .br
334 flip=yes
335 .br
336 # Decode/\:encode multiple files from png,
337 .br
338 # start with mf://filemask
339 .br
340 mf=type=png:fps=25
341 .br
342 # Eerie negative images are cool.
343 .br
344 vf=eq2=1.0:-0.8
345 .PP
346 You can also write file-specific configuration files.
347 If you wish to have a configuration file for a file called 'movie.avi', create a file
348 named 'movie.avi.conf' with the file-specific options in it and put it in
349 ~/.mplayer or in the same directory as the file.
350 .
351 .
352 .SH "GENERAL OPTIONS"
353 .TP
354 .B \-codecs-file <filename>
355 Use the specified file instead of system wide installed or builtin codecs.conf.
356 See also \-afm, \-ac, \-vfm and \-vc.
357 .TP
358 .B \-include <configuration\ file>
359 Specify configuration file to be parsed after the default ones.
360 .TP
361 .B \-quiet \ \ 
362 With this option the status line (i.e. A:   0.7 V:   0.6 A-V:  0.068 ...)
363 will not be displayed.
364 Particularly useful on slow terminals or broken ones that do not properly
365 handle carriage return (i.e. \\r).
366 .TP
367 .B \-v, \-verbose
368 Increment verbose level (more \-v means more verbosity).
369 .
370 .PD 0
371 .RSs
372 .IPs 0
373 only some informational output (default)
374 .IPs 1
375 some basic debug infos, avi header, function values (init debug)
376 .IPs 2
377 print avi indexes, chunk inputs, more debug infos (player debug)
378 .IPs 3
379 prints everything related to input parsers (parser debug)
380 .RE
381 .PD 1
382 .
383 .
384 .
385 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
386 .TP
387 .B \-autoq <quality> (use with \-vf [s]pp)
388 Dynamically changes the level of postprocessing depending on available spare
389 CPU time.
390 The number you specify will be the maximum level used.
391 Usually you can use some big number.
392 You have to use \-vf [s]pp without parameters in order to use this.
393 .TP
394 .B \-autosync <factor>
395 Gradually adjusts the A/\:V sync based on audio delay measurements.
396 Specifying \-autosync\ 0, the default, will cause frame timing to be based
397 entirely on audio delay measurements.
398 Specifying \-autosync\ 1 will do the same, but will subtly change the A/\:V
399 correction algorithm used.
400 An uneven video frame rate in a movie which plays fine with \-nosound can
401 often be helped by setting this to an integer value greater than 1.
402 The higher the value, the closer the timing will be to \-nosound.
403 Try \-autosync\ 30 to smooth out problems with sound drivers which do
404 not implement a perfect audio delay measurement.
405 With this value, if large A/\:V sync offsets occur, they will only take about
406 1 or 2\ seconds to settle out.
407 This delay in reaction time to sudden A/\:V offsets should be the only
408 side-effect of turning this option on, for all sound drivers.
409 .TP
410 .B \-benchmark
411 Prints some statistics on CPU usage and dropped frames at the end.
412 Use in combination with \-nosound and \-vo null for benchmarking only the
413 video codec.
414 .br
415 .I NOTE:
416 With this option MPlayer will also ignore frame duration when playing
417 only video (you can think of that as infinite fps).
418 .TP
419 .B \-colorkey <number>
420 Changes the colorkey to an RGB value of your choice.
421 0x000000 is black and 0xffffff is white.
422 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
423 xover video out drivers.
424 .TP
425 .B \-nocolorkey
426 Disables colorkeying.
427 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix and
428 xover video out drivers.
429 .TP
430 .B \-edl <filename>
431 Enables edit decision list (EDL) actions during playback.
432 Video will be skipped over and audio will be muted and unmuted according to
433 the entries in the given file.
434 See DOCS/HTML/en/edl.html for details on how to use this.
435 .TP
436 .B \-edlout <filename>
437 Creates a new file and writes edit decision list (EDL) records to that file.
438 During playback, when the user hits 'i', an entry to skip over the last two
439 seconds of playback will be written to the file.
440 This provides a starting point from which the user can fine-tune EDL entries
441 later.
442 See DOCS/HTML/en/edl.html for details.
443 .TP
444 .B \-enqueue (GUI only)
445 Enqueue files given on the command line in the playlist instead of playing them
446 immediately.
447 .TP
448 .B \-fixed-vo (BETA CODE!)
449 Enforces a fixed video system for multiple files (one (un)initialisation for
450 all files).
451 Therefore only one window will be opened for all files.
452 Currently the following drivers are fixed-vo compliant: gl2, mga, svga, x11,
453 xmga, xv and xvidix.
454 .TP
455 .B \-framedrop (also see \-hardframedrop)
456 Skip displaying some frames to maintain A/\:V sync on slow systems.
457 Video filters are not applied to such frames.
458 For B frames even decoding is skipped completely.
459 .TP
460 .B \-h, \-help, \-\-help
461 Show short summary of options.
462 .TP
463 .B \-hardframedrop
464 More intense frame dropping (breaks decoding).
465 Leads to image distortion!
466 .TP
467 .B \-identify
468 Show file parameters in easy parsable format.
469 The wrapper script TOOLS/midentify suppresses the other MPlayer output and
470 (hopefully) shellescapes the filenames.
471 .TP
472 .B \-input <commands>
473 This option can be used to configure certain parts of the input system.
474 Paths are relative to ~/\:.mplayer/.
475 .br
476 .I NOTE:
477 Autorepeat is currently only supported by joysticks.
478
479 Available commands are:
480
481 .PD 0
482 .RSs
483 .IPs conf=<file>
484 Read alternative input.conf.
485 If given without pathname, ~/\:.mplayer is assumed.
486 .IPs ar-delay
487 Delay in msec before we start to autorepeat a key (0 to disable).
488 .IPs ar-rate
489 How many key presses per second when we autorepeat.
490 .IPs keylist
491 Prints all keys that can be bound.
492 .IPs cmdlist
493 Prints all commands that can be bound.
494 .IPs js-dev
495 Specifies the joystick device to use (default is /dev/\:input/\:js0).
496 .IPs file\ 
497 Read commands from the given file.
498 Mostly useful with a fifo.
499 .br
500 .I NOTE:
501 When the given file is a fifo MPlayer opens both ends so you can do
502 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
503 .RE
504 .PD 1
505 .
506 .TP
507 .B \-lircconf <file>
508 Specifies a configuration file for LIRC (Linux Infrared Remote Control, see
509 http://www.lirc.org) if you don't like the default ~/\:.lircrc.
510 .TP
511 .B \-list-options
512 Prints out all the available options.
513 .TP
514 .B \-loop <number>
515 Loops movie playback <number> times.
516 0 means forever.
517 .TP
518 .B \-menu (BETA CODE)
519 Turn on OSD menu support.
520 .TP
521 .B \-menu-cfg <file> (BETA CODE)
522 Use an alternative menu.conf.
523 .TP
524 .B \-menu-root <value> (BETA CODE)
525 Specify the main menu.
526 .TP
527 .B \-nojoystick
528 Turns off joystick support.
529 Default is on, if compiled in.
530 .TP
531 .B \-nolirc
532 Turns off LIRC support.
533 .TP
534 .B \-nomouseinput
535 Disable mouse button press/release input (mozplayerxp's context menu relies
536 on this option).
537 .TP
538 .B \-nortc \ \ 
539 Turns off usage of the Linux RTC (real-time clock \- /dev/\:rtc) as timing
540 mechanism.
541 .TP
542 .B \-playlist <file>
543 Play files according to a playlist (1 file per row or Winamp or ASX format).
544 .br
545 .I NOTE:
546 This option is considered an entry so options found after it will apply
547 only to the elements of this playlist.
548 .TP
549 .B \-really-quiet
550 Display even less output and status messages.
551 .TP
552 .B \-shuffle
553 Play files in random order.
554 .TP
555 .B \-skin <skin\ directory> (GUI only)
556 Load skin from the given directory (WITHOUT path name).
557
558 .I EXAMPLE:
559 .PD 0
560 .RSs
561 .IPs "\-skin fittyfene"
562 tries Skin/fittyfene.
563 It first checks
564 /usr/local/share/mplayer/
565 and afterwards ~/.mplayer/.
566 .RE
567 .PD 1
568 .
569 .TP
570 .B \-slave \ \ 
571 This option switches on slave mode.
572 This is intended for use of MPlayer as a backend to other programs.
573 Instead of intercepting keyboard events, MPlayer will read simplistic command
574 lines from its stdin.
575 .TP
576 .B \-softsleep
577 Uses high quality software timers.
578 As precise as the RTC without requiring special privileges.
579 Comes at the price of higher CPU consumption.
580 .TP
581 .B \-speed <0.01\-100>
582 Set playback speed rate.
583 .TP
584 .B \-sstep <sec>
585 Specifies seconds between displayed frames.
586 Useful for slideshows.
587 .TP
588 .B \-use-stdin
589 The standard input (aka. stdin) will be used to read data instead of key
590 events.  If you open /dev/stdin (or the equivalent on your system), use stdin
591 in a playlist or intend to read from stdin later on via the loadfile or
592 loadlist commands you
593 .B need
594 this option.
595 .
596 .
597 .SH "DEMUXER/STREAM OPTIONS"
598 .TP
599 .B \-aid <id> (also see \-alang option)
600 Select audio channel [MPEG: 0\-31 AVI/\:OGM: 1\-99 ASF/\:RM: 0\-127
601 VOB(AC3): 128\-159 VOB(LPCM): 160\-191 MPEG-TS 17\-8190].
602 MPlayer prints the available IDs when running in verbose (\-v) mode.
603 When playing an MPEG-TS stream, MPlayer/Mencoder will use the first program 
604 (if present) with the chosen audio stream.
605 .TP
606 .B \-alang <two letter\ country\ code> (also see \-aid option)
607 Works only for DVD playback.
608 It selects the DVD audio language and always tries to play audio streams whose
609 language matches the given code.
610 For the list of available languages, use with the \-v option and look at the
611 output.
612
613 .I EXAMPLE:
614 .PD 0
615 .RSs
616 .IPs "\-alang hu,en"
617 Plays Hungarian and falls back to English if Hungarian is not available.
618 .RE
619 .PD 1
620 .
621 .TP
622 .B \-audio-demuxer <number> (\-audiofile only)
623 Force audio demuxer type for \-audiofile.
624 Give the demuxer ID as defined in libmpdemux/demuxer.h.
625 Use \-audio-demuxer 17 to force .mp3 detection.
626 .TP
627 .B \-audiofile <filename>
628 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
629 movie.
630 .TP
631 .B \-audiofile-cache <kBytes>
632 Enables caching for the stream used by \-audiofile, using the specified
633 amount of memory.
634 .TP
635 .B \-bandwidth <value>
636 Specify the maximum bandwidth for network streaming (for servers that are
637 able to send content in different bitrates).
638 Useful if you want to watch live streamed media behind a slow connection.
639 .TP
640 .B \-cdrom-device <path\ to\ device>
641 Override default CDROM drive name /dev/\:cdrom.
642 .TP
643 .B \-cache <kBytes>
644 This option specifies how much memory (in kBytes) to use when precaching a
645 file/\:URL.
646 Especially useful on slow media (default is \-nocache).
647 .TP
648 .B \-cdda <option1:option2>
649 This option can be used to tune the CD Audio reading feature of MPlayer.
650
651 Available options are:
652 .
653 .RSs
654 .IPs speed=<value>
655 set CD spin speed
656 .IPs paranoia=<0\-2>
657 set paranoia level
658 .RSss
659 0: disable checking
660 .br
661 1: overlap checking only (default)
662 .br
663 2: full data correction and verification
664 .REss
665 .IPs generic-dev=<value>
666 use specified generic SCSI device
667 .IPs sector-size=<value>
668 atomic read size
669 .IPs overlap=<value>
670 force minimum overlap search during verification to <value> sectors.
671 .IPs toc-bias
672 Assume that the beginning offset of track 1 as reported in the TOC will be
673 addressed as LBA\ 0.
674 Some Toshiba drives need this for getting track boundaries correct.
675 .IPs toc-offset=<value>
676 Add <value> sectors to the values reported when addressing tracks.
677 May be negative.
678 .IPs (no)skip
679 (never) accept imperfect data reconstruction.
680 .RE
681 .
682 .TP
683 .B \-channels <number>
684 Change the number of playback channels, defaults to '2' if not specified.
685 If the number of output channels is bigger than the number of input channels
686 empty channels are inserted (unless mixing from mono to stereo, then the mono
687 channel is repeated in both output channels).
688 If the number of output channels is smaller than the number of input channels,
689 results depend on the audio decoder (\-afm).
690 MPlayer asks the decoder to decode the audio into as many channels as
691 specified.
692 Now it's up to the decoder to fulfill the requirement.
693 If the decoder outputs more channels than requested, the exceeding channels
694 are truncated.
695 This is usually only important when playing videos with AC3 audio (like DVDs).
696 In that case liba52 does the decoding by default and correctly downmixes the
697 audio into the requested number of channels.
698 .br
699 .I NOTE:
700 This option is honored by codecs (AC3 only) filters (surround) and ao drivers
701 (OSS at least).
702
703 Available options are:
704
705 .PD 0
706 .RSs
707 .IPs 2
708 stereo
709 .IPs 4
710 surround
711 .IPs 6
712 full 5.1
713 .RE
714 .PD 1
715 .
716 .TP
717 .B \-chapter <chapter\ id>[\-<end\ chapter\ id>]
718 Specify which chapter to start playing at.
719 Optionally specify which chapter to end playing at (default: 1).
720 Examples can be found below.
721 .TP
722 .B \-cookies
723 Send cookies when making HTTP requests.
724 .TP
725 .B \-cookies-file <filename>
726 Read HTTP cookies from this file.
727 The file is assumed to be in Netscape format.
728 If you use this option, MPlayer will not look for cookies in ~/.netscape/
729 and ~/.mozilla/.
730 .TP
731 .B \-demuxer <number>
732 Force demuxer type.
733 Give the demuxer ID as defined in libmpdemux/demuxer.h.
734 Use \-demuxer 17 to force .mp3 detection.
735 .TP
736 .B \-dumpaudio (MPLAYER only)
737 Dumps raw compressed audio stream to ./\:stream.dump (useful with mpeg/\:ac3).
738 .TP
739 .B \-dumpfile <filename> (MPLAYER only)
740 Specify which file MPlayer should dump to.
741 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
742 .TP
743 .B \-dumpstream (MPLAYER only)
744 Dumps the raw stream to ./\:stream.dump.
745 Useful when ripping from DVD or network.
746 .TP
747 .B \-dumpvideo (MPLAYER only)
748 Dump raw compressed video stream to ./\:stream.dump (not very usable).
749 .TP
750 .B \-dvbin <options>
751 Pass the following parameters to the DVB input module, in order to override
752 the default ones:
753
754 .PD 0
755 .RSs
756 .IPs card=<1\-4>
757 Specifies using card number 1\-4 (default: 1).
758 .IPs file=<file>
759 Instructs MPlayer to read the channels list from <file>.
760 Default is ~/.mplayer/channels.conf.{sat,ter,cbl} (based on your card type)
761 or ~/.mplayer/channels.conf as a last resort.
762 .RE
763 .PD 1
764 .
765 .TP
766 .B \-dvd-device <path\ to\ device>
767 Override default DVD device name /dev/\:dvd.
768 .TP
769 .B \-dvdangle <angle\ id>
770 Some DVD discs contain scenes that can be viewed from multiple angles.
771 Here you can tell MPlayer which angles to use (default: 1).
772 Examples can be found below.
773 .TP
774 .B \-forceidx
775 Force rebuilding of INDEX.
776 Useful for files with broken index (desyncs, etc).
777 Seeking will be possible.
778 You can fix the index permanently with MEncoder (see the documentation).
779 .br
780 .I NOTE:
781 You can only use this option if the underlying media supports seeking
782 (i.e.\& not with stdin, pipe, etc).
783 .TP
784 .B \-fps <value>
785 Override video framerate (if value is wrong/\:missing in the header) (float
786 number).
787 .TP
788 .B \-frames <number>
789 Play/\:convert only first <number> frames, then quit.
790 .TP
791 .B \-hr-mp3-seek (MP3 only)
792 Hi-res mp3 seeking.
793 Default is: enabled when playing from external MP3 file, as we need to seek
794 to the very exact position to keep A/\:V sync.
795 It can be slow especially when seeking backwards \- it has to rewind to the
796 beginning to find the exact frame.
797 .TP
798 .B \-idx (also see \-forceidx)
799 Rebuilds INDEX of the AVI if no INDEX was found,
800 thus allowing seeking.
801 Useful with broken/\:incomplete downloads, or badly created AVIs.
802 .br
803 .I NOTE:
804 You can only use this option if the underlying media supports seeking
805 (i.e.\& not with stdin, pipe, etc).
806 .TP
807 .B \-ipv4-only-proxy
808 Skip the proxy for IPv6 addresses.
809 It will still be used for IPv4 connections.
810 .TP
811 .B \-loadidx <filename>
812 The file name from which to read the video INDEX data, as saved by \-saveidx.
813 MPlayer will read the index from filename and use this data for seeking.
814 This data will override any index data contained in the AVI itself.
815 Further, MPlayer won't prevent you from loading an index file generated
816 from a different AVI, but this is sure to cause unfavorable results.
817 .br
818 .I NOTE:
819 This option is obsolete, because MPlayer has OpenDML support.
820 .TP
821 .B \-mc <seconds/frame>
822 Maximum A-V sync correction per frame (in seconds).
823 .TP
824 .B \-mf <option1:option2:...>
825 Used when decoding from multiple PNG or JPEG files.
826
827 Available options are:
828
829 .PD 0
830 .RSs
831 .IPs w=<value>
832 width of the output (autodetect)
833 .IPs h=<value>
834 height of the output (autodetect)
835 .IPs fps=<value>
836 fps of the output (default: 25)
837 .IPs type=<value>
838 type of input files (available types: jpeg, png, tga, sgi)
839 .RE
840 .PD 1
841 .
842 .TP
843 .B \-ni (AVI only)
844 Force usage of non-interleaved AVI parser (fixes playing
845 of some bad AVI files).
846 .TP
847 .B \-nobps (AVI only)
848 Do not use average byte/\:sec value for A-V sync (AVI).
849 Helps with some AVI files with broken header.
850 .TP
851 .B \-noextbased
852 Disables filename-extension based demuxer selection.
853 By default, when file type (demuxer) cannot be detected reliably
854 (the file has no header or it is not reliable enough), the filename
855 extension is used to select demuxer.  It always falls back to content-based
856 demuxer selection.
857 .TP
858 .B \-passwd <password> (see \-user option too)
859 Specify password for http authentication.
860 .TP
861 .B \-prefer-ipv4
862 Use IPv4 on network connections.
863 Falls back to IPv6 automatically.
864 .TP
865 .B \-prefer-ipv6
866 Use IPv6 on network connections.
867 Falls back to IPv4 automatically.
868 .TP
869 .B \-rawaudio <option1:option2:...>
870 This option lets you play raw audio files.
871 It may also be used to play audio CDs which are not 44KHz 16Bit stereo.
872
873 Available options are:
874
875 .PD 0
876 .RSs
877 .IPs on\ \ \ 
878 use raw audio demuxer
879 .IPs channels=<value>
880 number of channels
881 .IPs rate=<value>
882 rate in samples per second
883 .IPs samplesize=<value>
884 sample size in byte
885 .IPs format=<value>
886 fourcc in hex
887 .RE
888 .PD 1
889 .
890 .TP
891 .B \-rawvideo <option1:option2:...>
892 This option lets you play raw video files.
893
894 Available options are:
895
896 .PD 0
897 .RSs
898 .IPs on\ \ \ 
899 use raw video demuxer
900 .IPs fps=<value>
901 rate in frames per second, default 25.0
902 .IPs sqcif|qcif|cif|4cif|pal|ntsc
903 set standard image size
904 .IPs w=<value>
905 image width in pixels
906 .IPs h=<value>
907 image height in pixels
908 .IPs y420|yv12|yuy2|y8
909 set colorspace
910 .IPs format=<value>
911 colorspace (fourcc) in hex
912 .IPs size=<value>
913 frame size in Bytes
914 .RE
915 .PD 1
916 .
917 .TP
918 .B \-rtsp-stream-over-tcp
919 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
920 packets be streamed over TCP (using the same TCP connection as RTSP).
921 This option may be useful if you have a broken Internet connection that does
922 not pass incoming UDP packets (see http://www.live.com/mplayer/).
923 .TP
924 .B \-saveidx <filename>
925 Force rebuilding of INDEX and output to a separate file specified by the
926 argument filename.
927 Currently this only works with AVI files.
928 .br
929 .I NOTE:
930 This option is obsolete, because MPlayer has OpenDML support.
931 .TP
932 .B \-sb <byte\ position> (see \-ss option too)
933 Seek to byte position.
934 Useful for playback from CDROM images / .VOB files with junk at the beginning.
935 .TP
936 .B \-srate <Hz>
937 Selects the given output sampling rate, resampling if necessary.
938 MEncoder passes this value to lame for resampling.
939 .TP
940 .B \-ss <time> (see \-sb option too)
941 Seek to given time position.
942
943 .I EXAMPLE:
944 .PD 0
945 .RSs
946 .IPs "\-ss 56"
947 seeks to 56 seconds
948 .IPs "\-ss 01:10:00"
949 seeks to 1\ hour 10\ min
950 .RE
951 .PD 1
952 .
953 .TP
954 .B \-tskeepbroken 
955 Tells MPlayer not to discard TS packets reported as broken in the stream.
956 Sometimes needed to play corrupted MPEG-TS files.
957 .
958 .TP
959 .B \-tsprog <1\-65534>
960 When playing an MPEG-TS stream, you can specify with this option which  
961 program (if present) you want to play. Can be used with \-vid and \-aid.
962 .
963 .TP
964 .B \-tsprobe <byte\ position>
965 When playing an MPEG-TS stream, this option lets you specify how many 
966 bytes in the stream you want MPlayer to search for the desired
967 audio and video pids.
968 .
969 .TP
970 .B \-tv <option1:option2:...>
971 This option tunes various properties of the TV capture module.
972 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>' 
973 or even 'tv://<channel_name> (see option channels for channel_name below)
974 as a movie URL.
975 .br
976 .I NOTE:
977 MPlayer doesn't accept colons so type dots instead in the device ID
978 (e.g.\& hw.0,0 instead of hw:0,0).
979 .br
980 Be advised that although you can select any samplerate when using ALSA,
981 the LAME audio codec is able to encode only the 'standard' samplerates.
982 You'll get an .avi file with no sound when you choose an odd
983 samplerate and use this codec.
984
985 Available options are:
986 .
987 .RSs
988 .IPs noaudio
989 no sound
990 .IPs driver=<value>
991 available: dummy, v4l, v4l2, bsdbt848
992 .IPs device=<value>
993 Specify other device than the default /dev/\:video0.
994 .IPs input=<value>
995 Specify other input than the default 0 (Television) (see output for a list)
996 .IPs freq=<value>
997 Specify the frequency to set the tuner to (e.g.\& 511.250).
998 Not compatible with channels parameter.
999 .IPs outfmt=<value>
1000 Specify the output format of the tuner with a preset value supported by the
1001 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
1002 arbitrary format given as hex value.
1003 Try outfmt=help for a list of all available formats.
1004 .IPs width=<value>
1005 width of the output window
1006 .IPs height=<value>
1007 height of the output window
1008 .IPs fps=<value>
1009 framerate at which to capture video (frames per second)
1010 .IPs buffersize=<value>
1011 maximum size of the capture buffer in megabytes (default: dynamical)
1012 .IPs norm=<value>
1013 available: PAL, SECAM, NTSC. For v4l2 use the normid option below.
1014 .IPs normid=<value>
1015 v4l2 only. See MPlayer output for a list of available TV norms.
1016 .IPs channel=<value>
1017 Set tuner to <value> channel.
1018 .IPs chanlist=<value>
1019 available: europe-east, europe-west, us-bcast, us-cable, etc
1020 .IPs channels=<channel>\-<name>,<channel>\-<name>,...
1021 Set names for channels.
1022 Use _ for spaces in names (or play with quoting ;-).
1023 The channel names will then be written using OSD, and the commands tv_step_channel,
1024 tv_set_channel and tv_last_channel will then be usable using a remote (see lirc).
1025 Not compatible with frequency parameter.
1026 Warning: The channel number will then be the position in the 'channels' list,
1027 beginning with 1.
1028 Example: use tv://1, tv://2, tv://TV1, tv_set_channel 1, tv_set_channel 2, tv_set_channel TV1, etc.
1029 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
1030 set the color equalizer on the card
1031 .IPs audiorate=<value>
1032 set audio capture bitrate
1033 .IPs forceaudio
1034 capture audio even if there are no audio sources reported by v4l
1035 .IPs alsa\ 
1036 capture from ALSA
1037 .IPs amode=<0\-3>
1038 choose an audio mode:
1039 .RSss
1040 0: mono
1041 .br
1042 1: stereo
1043 .br
1044 2: language 1
1045 .br
1046 3: language 2
1047 .REss
1048 .IPs forcechan=<1\-2>
1049 By default, the count of recorded audio channels is determined automatically
1050 by querying the audio mode from the tv card.
1051 This option allows to force stereo/\:mono recording regardless of the amode
1052 option and the values returned by v4l.
1053 This can be used for troubleshooting when the tv card is unable to report the
1054 current audio mode.
1055 .IPs adevice=<value>
1056 set an audio device
1057 .RSss
1058 /dev/\:...\& for OSS
1059 .br
1060 hardware ID for ALSA
1061 .REss
1062 .IPs audioid=<value>
1063 choose an audio output of the capture card, if it has more of them
1064 .IPs [volume|bass|treble|balance]=<0\-65535>
1065 .IPs [volume|bass|treble|balance]=<0\-100>
1066 These options set parameters of the mixer on the video capture card.
1067 They will have no effect, if your card doesn't have one.
1068 For v4l1, 0\-65535 is a valid range.
1069 For v4l2, the valid range is 0 to 100, and 50 maps to the default value of the
1070 control, as reported by the driver.
1071 .IPs immediatemode=<bool>
1072 A value of 0 means capture and buffer audio and video together
1073 (default for MEncoder).
1074 A value of 1 (default for MPlayer) means to do video capture only and let the
1075 audio go through a loopback cable from the TV card to the soundcard.
1076 .IPs mjpeg
1077 Use hardware mjpeg compression (if the card supports it). 
1078 When using this option, you do not need to specify the width and height
1079 of the output window, because MPlayer will determine it automatically 
1080 from the decimation value (see below).
1081 .IPs decimation=<1,2,4>
1082 choose the size of the picture that will be compressed by hardware
1083 mjpeg compression:
1084 .RSss
1085 1: full size
1086     704x576    PAL
1087     704x480    NTSC
1088 .br
1089 2: medium size
1090     352x288    PAL
1091     352x240    NTSC
1092 .br
1093 4: small size
1094     176x144    PAL
1095     176x120    NTSC
1096 .REss
1097 .IPs quality=<0\-100>
1098 choose the quality of the jpeg compression
1099 .br
1100 (quality < 60 recommended for full size)
1101 .RE
1102 .
1103 .TP
1104 .B \-user <user name> (see \-passwd option too)
1105 Specify user name for http authentication.
1106 .TP
1107 .B \-user-agent <string>
1108 Use string as User-Agent for HTTP streaming.
1109 .TP
1110 .B \-vid <id>
1111 Select video channel [MPG: 0\-15 ASF: 0\-255 MPEG-TS: 17\-8190].
1112 When playing an MPEG-TS stream, MPlayer/Mencoder will use the first program 
1113 (if present) with the chosen video stream.
1114 .TP
1115 .B \-vivo <sub-options> (DEBUG CODE)
1116 Force audio parameters for the .vivo demuxer (for debugging purposes).
1117 .
1118 .
1119 .SH "OSD/SUB OPTIONS"
1120 .I NOTE:
1121 See \-vf expand too.
1122 .TP
1123 .B \-dumpjacosub (MPLAYER only)
1124 Convert the given subtitle (specified with the \-sub option) to the time-based
1125 JACOsub subtitle format.
1126 Creates a dumpsub.js file in the current directory.
1127 .TP
1128 .B \-dumpmicrodvdsub (MPLAYER only)
1129 Convert the given subtitle (specified with the \-sub option) to the
1130 MicroDVD subtitle format.
1131 Creates a dumpsub.sub file in the current directory.
1132 .TP
1133 .B \-dumpmpsub (MPLAYER only)
1134 Convert the given subtitle (specified with the \-sub option) to MPlayer's
1135 subtitle format, MPsub.
1136 Creates a dump.mpsub file in the current directory.
1137 .TP
1138 .B \-dumpsami (MPLAYER only)
1139 Convert the given subtitle (specified with the \-sub option) to the time-based
1140 SAMI subtitle format.
1141 Creates a dumpsub.smi file in the current directory.
1142 .TP
1143 .B \-dumpsrtsub (MPLAYER only)
1144 Convert the given subtitle (specified with the \-sub option) to the time-based
1145 SubViewer (SRT) subtitle format.
1146 Creates a dumpsub.srt file in the current directory.
1147 .TP
1148 .B \-dumpsub (MPLAYER only) (BETA CODE)
1149 Dumps the subtitle substream from VOB streams.
1150 See \-dump*sub and \-vobsubout* options too.
1151 .TP
1152 .B \-ffactor <number>
1153 Resample alphamap of the font.
1154 Can be:
1155 .
1156 .PD 0
1157 .RSs
1158 .IPs 0
1159 plain white fonts
1160 .IPs 0.75
1161 very narrow black outline (default)
1162 .IPs 1
1163 narrow black outline
1164 .IPs 10
1165 bold black outline
1166 .RE
1167 .PD 1
1168 .
1169 .TP
1170 .B \-flip-hebrew
1171 Turns on flipping subtitles using FriBiDi.
1172 .TP
1173 .B \-font <path\ to\ font.desc\ file>
1174 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
1175 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
1176 ~/.mplayer/\:subfont.ttf).
1177 .br
1178 .I NOTE:
1179 With FreeType, this option determines path to the text font file.
1180 .br
1181 With Fontconfig, this option determines the fontconfig font name.
1182
1183 .I EXAMPLE:
1184 .PD 0
1185 .RSs
1186 \-font ~/\:.mplayer/\:arial-14/\:font.desc
1187 .br
1188 \-font ~/\:.mplayer/\:arialuni.ttf
1189 .br
1190 \-font 'Bitstream Vera Sans'
1191 .RE
1192 .PD 1
1193 .
1194 .TP
1195 .B \-fontconfig
1196 Enables the usage of fontconfig managed fonts.
1197 .TP
1198 .B \-forcedsubsonly
1199 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
1200 \-slang.
1201 .TP
1202 .B \-fribidi-charset <charset\ name>
1203 Specifies the charset that will be passed to FriBiDi when decoding a non-UTF8
1204 subtitles (default: ISO8859-8).
1205 .TP
1206 .B \-ifo <vobsub\ ifo\ file>
1207 Indicate the file that will be used to load palette and frame size for VOBSUB
1208 subtitles.
1209 .TP
1210 .B \-noautosub
1211 Turns off automatic loading of subtitle files.
1212 .TP
1213 .B \-osdlevel <0\-3> (MPLAYER only)
1214 Specifies which mode the OSD should start in.
1215 .
1216 .PD 0
1217 .RSs
1218 .IPs 0
1219 subtitles only
1220 .IPs 1
1221 volume + seek (default)
1222 .IPs 2
1223 volume + seek + timer + percentage
1224 .IPs 3
1225 volume + seek + timer + percentage + total time
1226 .RE
1227 .PD 1
1228 .
1229 .TP
1230 .B \-overlapsub
1231 Allows the next subtitle to be displayed while the current one is
1232 still visible (default is to enable the support only for specific
1233 formats).
1234 .TP
1235 .B \-sid <id> (also see \-slang option)
1236 Turns on DVD subtitle displaying.
1237 Also, you MUST specify a number which corresponds to a DVD subtitle language
1238 (0\-31).
1239 For the list of available subtitles, use with the \-v option and look at the
1240 output.
1241 .TP
1242 .B \-slang <two\ letter\ country\ code> (also see \-sid option)
1243 For DVD playback, turns on/\:selects DVD subtitle language.
1244 For the list of available subtitles, use with the \-v option and look at the
1245 output.
1246 .br
1247 Otherwise, determines an optional subtitle suffix which gets a higher
1248 priority when searching for subtitles.
1249
1250 .I EXAMPLE:
1251 .PD 0
1252 .RSs
1253 .IPs "\-slang hu,en"
1254 Selects Hungarian and falls back to English if Hungarian is not available.
1255 .RE
1256 .PD 1
1257 .
1258 .TP
1259 .B \-spuaa <mode>
1260 Antialiasing/scaling mode for DVD/VobSub.
1261 A value of 16 may be added to mode in order to force scaling even
1262 when original and scaled frame size already match, for example to
1263 smooth subtitles with the gaussian blur.
1264 The available modes are:
1265 .PD 0
1266 .RSs
1267 .IPs 0
1268 none (fastest, very ugly)
1269 .IPs 1
1270 approximate (broken?)
1271 .IPs 2
1272 full (slow)
1273 .IPs 3
1274 bilinear (default, fast and not too bad)
1275 .IPs 4
1276 uses swscaler gaussian blur (looks very good)
1277 .RE
1278 .PD 1
1279 .
1280 .TP
1281 .B \-spualign <-1\-2>
1282 Specify how spu (DVD/VobSub) subtitles should be aligned.
1283 Values are the same as for \-subalign, with the extra choice -1 for original
1284 position.
1285 .TP
1286 .B \-spugauss <0.0\-3.0>
1287 Variance parameter of gaussian used by \-spuaa 4.
1288 Higher means more blur.
1289 The default is 1.0.
1290 .TP
1291 .B \-sub <subtitlefile1,subtitlefile2,...>
1292 Use/\:display these subtitle files.
1293 Only one file can be displayed at the same time and the files can be
1294 switched with 'j'. 
1295 .TP
1296 .B \-sub-bg-alpha <0\-255>
1297 Specify the alpha channel value for subtitles and OSD backgrounds.
1298 Big values mean more transparency.
1299 The 0 value is an exception and means completly transparent.
1300 .TP
1301 .B \-sub-bg-color <0\-255>
1302 Specify the color value for subtitles and OSD backgrounds.
1303 Currently subtitles are grayscale so this value is equivalente to the
1304 intensity of the color.
1305 The 255 value means white and 0 black.
1306 .TP
1307 .B \-sub-demuxer <number> (\-subfile only) (BETA CODE)
1308 Force subtitle demuxer type for \-subfile.
1309 Give the demuxer ID as defined in subreader.h.
1310 .TP
1311 .B \-sub-fuzziness <mode>
1312 Adjust matching fuzziness when searching for subtitles:
1313 .PD 0
1314 .RSs
1315 .IPs 0
1316 exact match
1317 .IPs 1
1318 load all subs containing movie name
1319 .IPs 2
1320 load all subs in the current directory
1321 .RE
1322 .PD 1
1323 .
1324 .TP
1325 .B \-sub-no-text-pp
1326 Disables any kind of text post processing done after loading the subtitles.
1327 Used for debug purposes.
1328 .TP
1329 .B \-subalign <0\-2>
1330 Specify how subtitles should be aligned with subpos.
1331 0 means align at top (original/default behavior), 1 means align at center, and
1332 2 means align at bottom.
1333 .TP
1334 .B \-subcc \ 
1335 Display DVD Closed Caption (CC) subtitles.
1336 These are NOT the VOB subtitles, these are special ASCII subtitles for the
1337 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
1338 CC subtitles have not been spotted on DVDs from other regions so far.
1339 .TP
1340 .B \-subcp <codepage>
1341 If your system supports iconv(3), you can use this option to
1342 specify codepage of the subtitle.
1343
1344 .I EXAMPLE:
1345 .PD 0
1346 .RSs
1347 \-subcp latin2
1348 .br
1349 \-subcp cp1250
1350 .RE
1351 .PD 1
1352 .
1353 .TP
1354 .B \-subdelay <sec>
1355 Delays subtitles by <sec> seconds.
1356 Can be negative.
1357 .TP
1358 .B \-subfile <filename> (BETA CODE)
1359 Currently useless.
1360 Same as \-audiofile, but for subtitle streams (OggDS?).
1361 .TP
1362 .B \-subfont-autoscale <0\-3> (FreeType only)
1363 Sets the autoscale mode.
1364 .br
1365 .I NOTE:
1366 Zero means that text-scale and osd-scale are font heights in points.
1367
1368 The mode can be:
1369
1370 .PD 0
1371 .RSs
1372 .IPs 0
1373 no autoscale
1374 .IPs 1
1375 proportional to movie height
1376 .IPs 2
1377 proportional to movie width
1378 .IPs 3
1379 proportional to movie diagonal (default)
1380 .RE
1381 .PD 1
1382 .
1383 .TP
1384 .B \-subfont-blur <0\-8> (FreeType only)
1385 Sets the font blur radius (default: 2).
1386 .TP
1387 .B \-subfont-encoding <value> (FreeType only)
1388 Sets the font encoding.
1389 When set to 'unicode', all the glyphs from the font file will be rendered and
1390 unicode will be used (default: unicode).
1391 .TP
1392 .B \-subfont-osd-scale <0\-100> (FreeType only)
1393 Sets the osd elements autoscale coefficient (default: 6).
1394 .TP
1395 .B \-subfont-outline <0\-8> (FreeType only)
1396 Sets the font outline thickness (default: 2).
1397 .TP
1398 .B \-subfont-text-scale <0\-100> (FreeType only)
1399 Sets the subtitle text autoscale coefficient (percentage of the
1400 screen size) (default: 5).
1401 .TP
1402 .B \-subfps <rate>
1403 Specify frame/\:sec rate of subtitle file (float number),
1404 default: the same fps as the movie.
1405 .br
1406 .I NOTE:
1407 ONLY for frame-based SUB files, i.e.\& NOT MicroDVD format.
1408 .TP
1409 .B \-subpos <0\-100> (useful with \-vf expand)
1410 Specify the position of subtitles on the screen.
1411 The value is the vertical position of the subtitle in % of the screen height.
1412 .TP
1413 .B \-subwidth <10\-100>
1414 Specify the maximum width of subtitles on the screen.
1415 Useful for TV-out.
1416 The value is the width of the subtitle in % of the screen width.
1417 .TP
1418 .B \-unicode
1419 Tells MPlayer to handle the subtitle file as UNICODE.
1420 .TP
1421 .B \-utf8 \ \ 
1422 Tells MPlayer to handle the subtitle file as UTF8.
1423 .TP
1424 .B \-vobsub <vobsub\ file\ without\ extension>
1425 Specify the VobSub files that are to be used for subtitle.
1426 This is the full pathname without extensions, i.e.\& without
1427 the '.idx', '.ifo' or '.sub'.
1428 .TP
1429 .B \-vobsubid <0\-31>
1430 Specify the VobSub subtitle id.
1431 .
1432 .
1433 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
1434 .TP
1435 .B \-abs <value> (OBSOLETE)
1436 Override audio driver/\:card buffer size detection, \-ao oss only
1437 .TP
1438 .B \-ao <driver1[:device],driver2,...[,]>
1439 Specify a priority list of audio output drivers (optionally with device) to be
1440 used.
1441 With SDL 'device' is valid, too, it means subdriver then.
1442 .br
1443 .I NOTE:
1444 To get a full list of available drivers, see \-ao help.
1445 .br
1446 If the list has a trailing ',' it will fallback to drivers not listed.
1447
1448 .I EXAMPLE:
1449 .PD 0
1450 .RSs
1451 .IPs "\-ao oss:/\:dev/\:dsp2,oss:/\:dev/\:dsp1,"
1452 try to use OSS with the specified sound devices and fallback to others if it
1453 fails
1454 .IPs "\-ao sdl:esd"
1455 specify the SDL subdriver
1456 .RE
1457 .PD 1
1458 .
1459 .TP
1460 .B \-aofile <filename>
1461 Filename for \-ao pcm.
1462 .TP
1463 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...>
1464 Specify audio plugin(s) and their options (see documentation too).
1465
1466 Available options are:
1467 .
1468 .RSs
1469 .IPs list=[plugins]
1470 comma separated list of plugins (resample, surround, format, volume,
1471 extrastereo, volnorm)
1472 .IPs delay=<sec>
1473 example plugin, do not use.
1474 .IPs format=<format>
1475 output format (format plugin only)
1476 .IPs fout=<Hz>
1477 output frequency (resample plugin only)
1478 .IPs volume=<0\-255>
1479 volume (volume plugin only)
1480 .IPs mul=<value>
1481 stereo coefficient (default: 2.5) (extrastereo plugin only)
1482 .IPs softclip
1483 compressor / 'soft-clipping' capabilities (volume plugin only)
1484 .RE
1485 .
1486 .TP
1487 .B \-delay <sec>
1488 Audio delay in seconds (may be +/\:- float value).
1489 .TP
1490 .B \-format <0\-8192>
1491 Select the format used for output from the filter layer (according to the
1492 defines in libao2/afmt.h):
1493 .
1494 .PD 0
1495 .RSs
1496 .IPs 1
1497 Mu-Law
1498 .IPs 2
1499 A-Law
1500 .IPs 4
1501 Ima-ADPCM
1502 .IPs 8
1503 Signed 8-bit
1504 .IPs 16
1505 Unsigned 8-bit
1506 .IPs 32
1507 Unsigned 16-bit (Little-Endian)
1508 .IPs 64
1509 Unsigned 16-bit (Big-Endian)
1510 .IPs 128
1511 Signed  16-bit (Little-Endian)
1512 .IPs 256
1513 Signed 16-bit (Big-Endian)
1514 .IPs 512
1515 MPEG (2) Audio
1516 .IPs 1024
1517 AC3
1518 .IPs 4096
1519 Signed 32-bit (Little-Endian)
1520 .IPs 8192
1521 Signed 32-bit (Big-Endian)
1522 .RE
1523 .PD 1
1524 .
1525 .TP
1526 .B \-mixer <device>
1527 This option will tell MPlayer to use a different device for mixing than
1528 /dev/\:mixer.
1529 .TP      
1530 .B \-mixer-channel <mixer line> (\-ao oss only)
1531 This option will tell MPlayer to use a different channel for controlling
1532 volume than the default PCM.
1533 Options include
1534 .B vol, pcm, line.
1535 For a complete list of options look for SOUND_DEVICE_NAMES in
1536 /usr/include/linux/soundcard.h.
1537 .TP
1538 .B \-nowaveheader (\-ao pcm only)
1539 Don't include wave header.
1540 Used for RAW PCM.
1541 .
1542 .
1543 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
1544 .TP
1545 .B \-aa* (\-vo aa only)
1546 You can get a list and an explanation of available options executing
1547 .I mplayer \-aahelp
1548 .TP
1549 .B \-adapter <value> (\-vo directx only)
1550 Set the graphics card that will receive the image.
1551 Needs the \-vm option to work.
1552 You can get a list of available cards when you run this option with \-v.
1553 .TP
1554 .B \-bpp <depth>
1555 Use different color depth than autodetect.
1556 Not all \-vo drivers support it (fbdev, dga2, svga, vesa).
1557 .TP
1558 .B \-brightness <-100\-100>
1559 Adjust brightness of video output (default 0).
1560 It changes intensity of RGB components of video signal from black to white
1561 screen.
1562 .TP
1563 .B \-contrast <-100\-100>
1564 Adjust contrast of video output (default 0).
1565 Works in similar manner as brightness.
1566 .TP
1567 .B \-dfbopts <value> (\-vo directfb only)
1568 Specify a parameter list for the directfb driver.
1569 .TP
1570 .B \-display <name>
1571 Specify the hostname and display number of the X server you want to display
1572 on.
1573
1574 .I EXAMPLE:
1575 .PD 0
1576 .RSs
1577 \-display xtest.localdomain:0
1578 .RE
1579 .PD 1
1580 .
1581 .TP
1582 .B \-double
1583 Enables doublebuffering.
1584 Fixes flicker by storing two frames in memory, and displaying one while
1585 decoding another.
1586 Can affect OSD.
1587 Needs twice the memory of a single buffer, so it won't work on cards with
1588 very little video memory.
1589 .TP
1590 .B \-dr \ \ \ 
1591 Turns on direct rendering (not supported by all codecs and video outputs)
1592 (default is off).
1593 Warning: may cause OSD/\:SUB corruption!
1594 .TP
1595 .B \-dxr2 <option1:option2:...>
1596 This option is used to control the dxr2 driver.
1597 .
1598 .RSs
1599 .IPs ar-mode=<value>
1600 aspect ratio mode (0 = normal, 1 = pan scan, 2 = letterbox (default))
1601 .IPs iec958-encoded
1602 iec958 output mode
1603 .IPs iec958-decoded
1604 set iec958 output mode to decoded (default)
1605 .IPs macrovision=<value>
1606 macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
1607 3 = agc 4 colorstripe)
1608 .IPs mute\ 
1609 mute sound output
1610 .IPs unmute
1611 unmute sound output
1612 .IPs ucode=<value>
1613 path to the microcode
1614 .RE
1615 .RS
1616
1617 .I TV Out
1618 .RE
1619 .RSs
1620 .IPs 75ire
1621 enable 7.5 IRE output mode
1622 .IPs no75ire
1623 disable 7.5 IRE output mode (default)
1624 .IPs bw\ \ \ 
1625 b/\:w TV output
1626 .IPs color
1627 color TV output (default)
1628 .IPs interlaced
1629 interlaced TV output (default)
1630 .IPs nointerlaced
1631 disable interlaced TV output
1632 .IPs norm=<value>
1633 TV norm (ntsc (default), pal, pal60, palm, paln, palnc)
1634 .IPs square-pixel
1635 set pixel mode to square
1636 .IPs ccir601-pixel
1637 set pixel mode to ccir601
1638 .RE
1639 .RS
1640
1641 .I Overlay
1642 .RE
1643 .RSs
1644 .IPs cr-left=<0\-500>
1645 set the left cropping value (default: 50)
1646 .IPs cr-right=<0\-500>
1647 set the right cropping value (default: 300)
1648 .IPs cr-top=<0\-500>
1649 set the top cropping value (default: 0)
1650 .IPs cr-bottom=<0\-500>
1651 set the bottom cropping value (default: 0)
1652 .IPs ck-[r|g|b]=<0\-255>
1653 set the r(ed), g(reen) or b(lue) gain of the overlay color-key
1654 .IPs ck-[r|g|b]min=<0\-255>
1655 minimum value for the respective color key
1656 .IPs ck-[r|g|b]max=<0\-255>
1657 maximum value for the respective color key
1658 .IPs ignore-cache
1659 ignore cached overlay settings
1660 .IPs update-cache
1661 update cached overlay settings
1662 .IPs ol-osd
1663 enable overlay onscreen display
1664 .IPs nool-osd
1665 disable overlay onscreen display (default)
1666 .IPs ol[h|w|x|y]-cor=<-20\-20>
1667 adjust the overlay size (h,w) and position (x,y) in case it doesn't match the
1668 window perfectly (default: 0)
1669 .IPs overlay
1670 activate overlay (default)
1671 .IPs nooverlay
1672 activate TVout
1673 .IPs overlay-ratio=<1\-2500>
1674 tune the overlay (default 1000)
1675 .RE
1676 .
1677 .TP
1678 .B \-fb <device> (fbdev or DirectFB only) (OBSOLETE)
1679 Specifies the framebuffer device to use.
1680 By default it uses /dev/\:fb0.
1681 .TP
1682 .B \-fbmode <modename> (fbdev only)
1683 Change video mode to the one that is labelled as <modename> in
1684 /etc/\:fb.modes.
1685 .br
1686 .I NOTE:
1687 VESA framebuffer doesn't support mode changing.
1688 .TP
1689 .B \-fbmodeconfig <filename> (fbdev only)
1690 Use this configuration file instead of the default /etc/\:fb.modes.
1691 Only valid for the fbdev driver.
1692 .TP
1693 .B \-forcexv (SDL only)
1694 Force using XVideo.
1695 .TP
1696 .B \-fs \ \ \ 
1697 Fullscreen playing (centers movie, and makes black
1698 bands around it).
1699 Toggle it with the 'f' key (not all video outputs support it).
1700 See also \-zoom.
1701 .TP
1702 .B \-fsmode-dontuse <0\-31> (OBSOLETE) (use \-fs option)
1703 Try this option if you still experience fullscreen problems.
1704 .TP
1705 .B \-fstype <type1,type2,...>
1706 Specify a priority list of fullscreen layer setting modes to be
1707 used.
1708 The available types are:
1709
1710 .PD 0
1711 .RSs
1712 .IPs above
1713 Use _NETWM_STATE_ABOVE hint if available.
1714 .IPs below
1715 Use _NETWM_STATE_BELOW hint if available.
1716 .IPs fullscreen
1717 Use _NETWM_STATE_FULLSCREEN hint if available.
1718 .IPs layer
1719 Use _WIN_LAYER hint with default layer.
1720 .IPs layer=<0..15>
1721 Use _WIN_LAYER hint with layer number.
1722 .IPs netwm
1723 Force NETWM style.
1724 .IPs none\ 
1725 Don't set fullscreen window layer.
1726 .IPs stays_on_top
1727 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
1728 .RE
1729 .PD 1
1730 .TP
1731 .B \ 
1732 You can negate the modes by prefixing them with '-'.
1733 .br
1734 The default order is layer,stays_on_top,above,fullscreen.
1735 It will be used as a fallback in case of specifying incorrect
1736 or unsupported modes.
1737 .br
1738 OpenBox 1.x users have to use \-fstype \-fullscreen
1739 to achieve working fs switching.
1740 .br
1741 If you experience problems with fullscreen window being covered by other
1742 windows try using a different order.
1743 .br
1744 .I NOTE:
1745 See \-fstype help for a full list of available modes.
1746 .TP
1747 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
1748 Adjust where the output is on the screen initially.
1749 The x and y specifications are in pixels measured from the top-left of the
1750 screen to the top-left of the image being displayed, however if a percentage
1751 sign is given after the argument it turns the value into a percentage of the
1752 screen size in that direction.
1753 It also supports the standard option format to the standard X \-geometry
1754 option.
1755 The values given must be integers.
1756 .br
1757 .I NOTE:
1758 This option is only supported by vo x11, xmga, xv, xvmc, xvidix,
1759 directx and tdfxfb.
1760
1761 .I EXAMPLE:
1762 .PD 0
1763 .RSs
1764 .IPs 50:40
1765 Places the window at x=50, y=40.
1766 .IPs 50%:50%
1767 Places the window in the middle of the screen.
1768 .IPs 100%\ 
1769 Places the window at the middle of the right edge of the screen.
1770 .IPs 100%:100%
1771 Places the window at the bottom right corner of the screen.
1772 .RE
1773 .PD 1
1774 .
1775 .TP
1776 .B \-guiwid <window\ id>
1777 This tells the GUI to also use an X11 window and stick itself to the bottom
1778 of the video, which is useful to embed a mini-GUI in a browser (with the
1779 MPlayer plugin for instance).
1780 .TP
1781 .B \-hue <-100\-100>
1782 Adjust hue of video signal (default: 0).
1783 You can get colored negative of image with this option.
1784 .TP
1785 .B \-jpeg <option1:option2:...> (\-vo jpeg only)
1786 Specify options for the JPEG output.
1787 .br
1788 Available options are:
1789
1790 .PD 0
1791 .RSs
1792 .IPs [no]progressive
1793 Specify standard or progressive JPEG.
1794 .IPs [no]baseline
1795 Specify use of baseline or not.
1796 .IPs optimize=<value>
1797 Optimization factor [0\-100]
1798 .IPs smooth=<value>
1799 Smooth factor [0\-100]
1800 .IPs quality=<value>
1801 Quality factor [0\-100]
1802 .IPs outdir=<value>
1803 Directory to save the JPEG files
1804 .RE
1805 .PD 1
1806 .
1807 .TP
1808 .B \-monitor-dotclock <dotclock\ (or\ pixelclock) range> (fbdev and vesa only)
1809 Look into etc/\:example.conf for further information and in
1810 DOCS/\:HTML/\:en/\:devices.html#video-dev.
1811 .TP
1812 .B \-monitor-hfreq <horizontal frequency range> (fbdev and vesa only)
1813 .TP
1814 .B \-monitor-vfreq <vertical frequency range> (fbdev and vesa only)
1815 .TP
1816 .B \-monitoraspect <ratio>
1817 Set aspect ratio of your monitor or TV screen.
1818 See also \-aspect for movie aspect.
1819
1820 .I EXAMPLE:
1821 .PD 0
1822 .RSs
1823 \-monitoraspect 4:3  or 1.3333
1824 .br
1825 \-monitoraspect 16:9 or 1.7777
1826 .RE
1827 .PD 1
1828 .
1829 .TP
1830 .B \-nograbpointer
1831 Do not grab mouse pointer after VidMode change (\-vm), useful for multihead
1832 setup.
1833 .TP
1834 .B \-nokeepaspect
1835 Do not keep window aspect ratio when resizing X11 windows (Works currently only
1836 with \-vo x11, xv, xmga and xvidix and your window manager needs to understand
1837 window aspect hints.).
1838 .TP
1839 .B \-noxv (SDL only)
1840 Disables XVideo SDL driver.
1841 .TP
1842 .B \-ontop 
1843 Makes the player window stay on top other windows.
1844 Supported by drivers which use X11, except SDL, as well as directx and gl2 under Windows.
1845 .TP
1846 .B \-panscan <0.0\-1.0>
1847 Enables Pan & Scan functionality, i.e.\& in order to display a 16:9 movie
1848 on a 4:3 display, the sides of the movie are cropped to get a 4:3 image
1849 which fits the screen.
1850 This function works only with the xv, xmga, mga and xvidix video out drivers.
1851 .br
1852 The range controls how much of the image is cropped.
1853 .TP
1854 .B \-refreshrate <Hz>
1855 Set the monitor refreshrate in Hz.
1856 Currently only supported by \-vo directx combined with the \-vm option.
1857 .TP
1858 .B \-rootwin
1859 Play movie in the root window (desktop background) instead of opening
1860 a new one.
1861 Works only with x11, xv, xmga and xvidix drivers.
1862 .TP
1863 .B \-saturation <-100\-100>
1864 Adjust saturation of video output (default: 0).
1865 You can get grayscale output with this option.
1866 .TP
1867 .B \-screenh <pixels> \-screenw <pixels>
1868 If you use an output driver which can't know the resolution of the screen
1869 (fbdev/\:x11 and/\:or TVout) this is where you can specify the horizontal and
1870 vertical resolution.
1871 .PP
1872 .B \-screenh <pixels>
1873 .br
1874 .B \-screenw <pixels>
1875 .TP
1876 If you use an output driver which can't know the resolution of the screen
1877 (fbdev/\:x11 and/\:or TVout) this is where you can specify the horizontal and
1878 vertical resolution.
1879 .TP
1880 .B \-screenh <pixels>
1881 .B \-screenw <pixels>
1882 .br
1883 If you use an output driver which can't know the resolution of the screen
1884 (fbdev/\:x11 and/\:or TVout) this is where you can specify the horizontal and
1885 vertical resolution.
1886 .TP
1887 .B \-stop-xscreensaver
1888 Turns off xscreensaver at startup and turns it on again on exit.
1889 .TP
1890 .B \-vm \ \ \ 
1891 Try to change to a better video mode.
1892 dga, x11/\:xv (XF86VidMode) and sdl output drivers support it.
1893 If it is used with the directx video output driver the \-screenw,
1894 \-screenh, \-bpp and \-refreshrate options can be used to set
1895 the new display mode.
1896 .TP
1897 .B \-vsync \ \ 
1898 Enables VBI for vesa.
1899 .TP
1900 .B \-wid <window\ id>
1901 This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a
1902 browser (with the plugger extension for instance).
1903 .TP
1904 .B \-xineramascreen <0\-...>
1905 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
1906 displays) this option tells MPlayer which screen to display movie on.
1907 .TP
1908 .B \-z <0\-9>
1909 Specifies compression level for PNG output (\-vo png)
1910 .
1911 .PD 0
1912 .RSs
1913 .IPs 0
1914 no compression
1915 .IPs 9
1916 max compression
1917 .RE
1918 .PD 1
1919 .
1920 .TP
1921 .B \-zrbw (\-vo zr only)
1922 Display in black and white (for optimal performance, this option can be
1923 combined with the 'decode only in black and white' option for codecs
1924 belonging to the FFmpeg family).
1925 .TP
1926 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
1927 Select a part of the input image for display, multiple occurences of this
1928 option switch on cinerama mode.
1929 In cinerama mode the movie is distributed over more than one TV (or beamer) to
1930 create a larger screen.
1931 Options appearing after the n-th \-zrcrop apply to the n-th MJPEG card, each
1932 card should at least have a \-zrdev in addition to the \-zrcrop.
1933 For examples, see the output of \-zrhelp and the Zr section of the
1934 documentation.
1935 .TP
1936 .B \-zrdev <device> (\-vo zr only)
1937 Specify the device special file that belongs to your MJPEG card, by default
1938 this driver takes the first v4l device it can find.
1939 .TP
1940 .B \-zrfd (\-vo zr only)
1941 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
1942 happens if the hardware scaler can stretch the image to its original size.
1943 Use this option to force decimation.
1944 .TP
1945 .B \-zrhelp (\-vo zr only)
1946 Display a list of all \-zr* options, their default values and an example of
1947 cinerama mode.
1948 .TP
1949 .B \-zrnorm <norm> (\-vo zr only)
1950 Specify norm PAL/\:NTSC, the default is 'no change'.
1951 .TP
1952 .B \-zrquality <1\-20> (\-vo zr only)
1953 A number from 1 to 20 representing the jpeg encoding quality.
1954 1 gives the best quality and 20 gives very bad quality.
1955 .TP
1956 .B \-zrvdec <1,2,4> \-zrhdec <1,2,4> (\-vo zr only)
1957 Vertical/\:horizontal decimation: Ask the driver to send only every 2nd or 4th
1958 line/\:pixel of the input image to the MJPEG card and use the scaler of the
1959 MJPEG card to strech the image to its original size.
1960 .TP
1961 .B \-zrxdoff <x display offset>, \-zrydoff <y display offset> (\-vo zr only)
1962 If the movie is smaller than the TV screen, these options control the position
1963 of the movie relative to the upper left corner of the screen.
1964 The movie is centered by default.
1965 .
1966 .
1967 .SH "DECODING/FILTERING OPTIONS"
1968 .TP
1969 .B \-ac <[-]codec1,[-]codec2,...[,]>
1970 Specify a priority list of audio codecs to be used, according to their codec
1971 name in codecs.conf.
1972 Use a '-' before the codec name to omit it.
1973 .br
1974 .I NOTE:
1975 See \-ac help for a full list of available codecs.
1976 .br
1977 If the list has a trailing ',' it will fallback to codecs not listed.
1978
1979 .I EXAMPLE:
1980 .PD 0
1981 .RSs
1982 .IPs "\-ac mp3acm"
1983 force l3codeca.acm MP3 codec
1984 .IPs "\-ac mad,"
1985 try libmad first, then fallback to others
1986 .IPs "\-ac hwac3,a52,"
1987 try hardware AC3 passthrough, then software AC3 codec, then others
1988 .IPs "\-ac -ffmp3,"
1989 try other codecs except FFmpeg's MP3 decoder
1990 .RE
1991 .PD 1
1992 .
1993 .TP
1994 .B \-af <plugin1[=options],plugin2,...>
1995 Activate a comma separated list of audio filters and their options.
1996 .br
1997 Available filters are:
1998 .
1999 .RSs
2000 .IPs resample[=srate[:sloppy][:type]]
2001 Changes the sample rate of the audio stream to an integer srate (Hz).
2002 It only supports the 16 bit little endian format.
2003 .IPs channels[=nch]
2004 Change the number of channels to nch output channels.
2005 If the number of output channels is bigger than the number of input channels
2006 empty channels are inserted (except mixing from mono to stereo, then the mono
2007 channel is repeated in both of the output channels).
2008 If the number of output channels is smaller than the number of input channels
2009 the exceeding channels are truncated.
2010 .IPs format[=bps,f]
2011 Select the format f and bytes per sample bps used for output from the
2012 filter layer.
2013 The option bps is an integer and denotes Bytes per sample.
2014 The format f is a string containing a concatenated mix of:
2015 .br
2016 alaw, mulaw or imaadpcm
2017 .br
2018 float or int
2019 .br
2020 unsigned or signed
2021 .br
2022 le or be (little or big endian)
2023 .br
2024 .IPs volume[=v:sc]
2025 Select the output volume level.
2026 This filter is not reentrant and can therefore only be enabled once for every
2027 audio stream.
2028 .RSss
2029 v: desired gain in dB for all channels in the stream.
2030 The gain can be set from -200dB to +40dB (where -200dB mutes the sound
2031 completely and +40dB equals a gain of 1000).
2032 .br
2033 sc: enable soft clipping.
2034 .REss
2035 .IPs pan[=n:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...]
2036 Mixes channels arbitrarily, see DOCS/HTML/en/devices.html#audio-dev for details.
2037 .RSss
2038 n: number of output channels (1\-6).
2039 .br
2040 lij: how much of input channel j is mixed into output channel i.
2041 .REss
2042 .IPs sub[=fc:ch]
2043 Add sub-woofer channel.
2044 .RSss
2045 fc: Cutoff frequency for low-pass filter (20Hz to 300Hz) default is 60Hz.
2046 .br
2047 ch: channel number for the sub-channel.
2048 .REss
2049 .IPs surround[=d]
2050 Decoder for matrix encoded surround sound, works on many 2 channel files.
2051 .RSss
2052 d: delay time in ms for the rear speakers (0ms to 1000ms) default is 15ms.
2053 .REss
2054 .IPs delay[=ch1:ch2:...]
2055 Delays the sound output.
2056 Specify the delay separately for each channel in milliseconds (floating point
2057 number between 0 and 1000).
2058 .IPs export[=mmapped_file[:nsamples]]
2059 Exports the incoming signal to other processes using memory mapping (mmap()).
2060 .RSss
2061 mmapped_file: File to map data to (default: ~/.mplayer/mplayer-af_export).
2062 .br
2063 nsamples: number of samples per channel (default: 512)
2064 .REss
2065 .RE
2066 .
2067 .TP
2068 .B \-af-adv <force=(0\-3):list=(filters)> (see \-af option too)
2069 Specify advanced audio filter options:
2070 .
2071 .RSs
2072 .IPs force=<0\-3>
2073 Forces the insertion of audio filters to one of the following:
2074 .RSss
2075 0: Completely automatic insertion of filters (default)
2076 .br
2077 1: Optimize for accuracy
2078 .br
2079 2: Optimize for speed
2080 .br
2081 3: Turn off auto
2082 .REss
2083 .IPs list=<filters>
2084 Same as \-af (see \-af option).
2085 .RE
2086 .
2087 .TP
2088 .B \-afm <driver1,driver2,...>
2089 Specify a priority list of audio drivers to be used, according to their driver
2090 name in codecs.conf.
2091 It falls back to default if none is ok.
2092 .br
2093 .I NOTE:
2094 See \-afm help for a full list of available drivers.
2095
2096 .I EXAMPLE:
2097 .PD 0
2098 .RSs
2099 .IPs "\-afm ffmpeg"
2100 try FFmpeg's libavcodec (mp1/\:2/\:3) codecs first
2101 .IPs "\-afm acm,dshow"
2102 try Win32 codecs first
2103 .RE
2104 .PD 1
2105 .
2106 .TP
2107 .B \-aspect <ratio>
2108 Override aspect ratio of movies.
2109 It's autodetected on MPEG files, but can't be autodetected on most AVI files.
2110
2111 .I EXAMPLE:
2112 .PD 0
2113 .RSs
2114 \-aspect 4:3  or \-aspect 1.3333
2115 .br
2116 \-aspect 16:9 or \-aspect 1.7777
2117 .RE
2118 .PD 1
2119 .
2120 .TP
2121 .B \-noaspect
2122 Disable automatic movie aspect ratio compensation.
2123 .TP
2124 .B \-flip \ 
2125 Flip image upside-down.
2126 .TP
2127 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
2128 If decoding with libavcodec, you can specify its parameters here.
2129
2130 .I EXAMPLE:
2131 .PD 0
2132 .RSs
2133 \-lavdopts bug=1
2134 .RE
2135 .PD 1
2136
2137 .RS
2138 .I NOTE:
2139 Just add the values of the things you want to enable.
2140 .br
2141 Available options are:
2142 .RE
2143 .
2144 .RSs
2145 .IPs ec\ \ \ 
2146 error concealment:
2147 .RSss
2148 1: use strong deblock filter for damaged MBs
2149 .br
2150 2: iterative MV search (slow)
2151 .br
2152 3: all (default)
2153 .REss
2154 .IPs er=<value>
2155 error resilience:
2156 .RSss
2157 .br
2158 0: disabled
2159 .br
2160 1: careful (should work with broken encoders)
2161 .br
2162 2: normal (default) (works with compliant encoders)
2163 .br
2164 3: agressive (more checks but might cause problems even for valid bitstreams)
2165 .br
2166 4: very agressive
2167 .REss
2168 .IPs debug=<value>
2169 debug:
2170 .RSss
2171 .br
2172 0: disabled
2173 .br
2174 1: picture info
2175 .br
2176 2: rate control
2177 .br
2178 4: bitstream
2179 .br
2180 8: MB type
2181 .br
2182 16: QP
2183 .br
2184 32: Motion vector
2185 .br
2186 0x0040: Motion vector visualization (use \-noslices)
2187 .br
2188 0x0080: MB skip
2189 .br
2190 0x0100: startcode
2191 .br
2192 0x0200: PTS
2193 .br
2194 0x0400: error resilience
2195 .br
2196 0x0800: memory management control operations (H264)
2197 .br
2198 0x1000: bugs
2199 .REss
2200 .IPs vismv=<value>
2201 vismv:
2202 .RSss
2203 .br
2204 0: disabled
2205 .br
2206 1: visualize forward predicted MVs of P frames
2207 .br
2208 2: visualize forward predicted MVs of B frames
2209 .br
2210 4: visualize backward predicted MVs of B frames
2211 .REss
2212 .IPs bug=<value>
2213 manually work around encoder bugs:
2214 .RSss
2215 0: nothing
2216 .br
2217 1: autodetect bugs (default)
2218 .br
2219 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetect)
2220 .br
2221 4 (mpeg4): XviD interlacing bug (autodetected if fourcc==XVIX) 
2222 .br
2223 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
2224 .br
2225 16 (mpeg4): padding bug (autodetected)
2226 .br
2227 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
2228 .br
2229 64 (mpeg4): XviD and DivX qpel bug (autodetected per fourcc/ver)
2230 .br
2231 128 (mpeg4): old standard qpel (autodetected per fourcc/ver)
2232 .br
2233 256 (mpeg4): another qpel bug (autodetected per fourcc/ver)
2234 .br
2235 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/ver)
2236 .br
2237 1024 (mpeg4): edge padding bug (autodetected per fourcc/ver)
2238 .REss
2239 .IPs idct=<0\-99>
2240 (see lavcopts)
2241 For best decoding quality use the same idct algorithm for decoding and encoding.
2242 This may come at a price in accuracy, though.
2243 .IPs gray\ 
2244 grayscale only decoding (a bit faster than with color)
2245 .RE
2246 .
2247 .TP
2248 .B \-noslices
2249 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
2250 whole frame in a single run.
2251 May be faster or slower, depending on card/\:cache.
2252 It has effect only with libmpeg2 and libavcodec codecs.
2253 .TP
2254 .B \-nosound
2255 Do not play/\:encode sound.
2256 .TP
2257 .B \-novideo
2258 Do not play/\:encode video.
2259 .TP
2260 .B \-oldpp <quality> (OBSOLETE)
2261 Use the opendivx postprocessing code instead of the internal one.
2262 Superseded by \-pp, the internal postprocessing offers better
2263 quality and performance.
2264 .
2265 The valid range of \-oldpp values varies by codec, mostly
2266 0\-6, where 0=disable 6=slowest/\:best.
2267 .TP
2268 .B \-pp <quality> (see \-vf pp option too!)
2269 Set postprocess level of the DLL.
2270 This option is NO LONGER USABLE with MPlayer's postprocess filter, but only
2271 with Win32 DirectShow DLLs which have internal postprocessing routines.
2272 .
2273 The valid range of \-pp values varies by codec, mostly
2274 0\-6, where 0=disable 6=slowest/\:best.
2275 .TP
2276 .B \-pphelp (see \-vf pp option too)
2277 Show a summary about the available postprocess filters and their usage.
2278 .TP
2279 .B \-ssf <mode>
2280 Specifies SwScaler parameters.
2281
2282 .I EXAMPLE:
2283 .PD 0
2284 .RSs
2285 \-vf scale \-ssf lgb=3.0
2286 .RE
2287 .PD 1
2288 .
2289 .PD 0
2290 .RSs
2291 .IPs lgb=<0\-100>
2292 Gaussian blur filter (luma)
2293 .IPs cgb=<0\-100>
2294 Gaussian blur filter (chroma)
2295 .IPs ls=<0\-100>
2296 sharpen filter (luma)
2297 .IPs cs=<0\-100>
2298 sharpen filter (chroma)
2299 .IPs chs=<h>
2300 chroma horizontal shifting
2301 .IPs cvs=<v>
2302 chroma vertical shifting
2303 .RE
2304 .PD 1
2305 .
2306 .TP
2307 .B \-stereo <mode>
2308 Select type of MP2/\:MP3 stereo output.
2309 .
2310 .PD 0
2311 .RSs
2312 .IPs 0
2313 Stereo
2314 .IPs 1
2315 Left channel
2316 .IPs 2
2317 Right channel
2318 .RE
2319 .PD 1
2320 .
2321 .TP
2322 .B \-sws <software\ scaler\ type> (see \-vf scale option too)
2323 This option sets the quality (and speed, respectively) of the software scaler,
2324 with the \-zoom option.
2325 For example with x11 or other outputs which lack hardware acceleration.
2326 Possible settings are:
2327 .br
2328 .I NOTE:
2329 For \-sws\ 2 and 7, the sharpness can be set with the scaling parameter (p)
2330 of \-vf scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter
2331 length (1 \- 10).
2332
2333 .PD 0
2334 .RSs
2335 .IPs 0
2336 fast bilinear (default)
2337 .IPs 1
2338 bilinear
2339 .IPs 2
2340 bicubic (good quality)
2341 .IPs 3
2342 experimental
2343 .IPs 4
2344 nearest neighbour (bad quality)
2345 .IPs 5
2346 area
2347 .IPs 6
2348 luma bicubic / chroma bilinear
2349 .IPs 7
2350 gauss
2351 .IPs 8
2352 sincR
2353 .IPs 9
2354 lanczos
2355 .IPs 10
2356 bicubic spline
2357 .RE
2358 .PD 1
2359 .
2360 .TP
2361 .B \-vc <[-]codec1,[-]codec2,...[,]>
2362 Specify a priority list of video codecs to be used, according to their codec
2363 name in codecs.conf.
2364 Use a '-' before the codec name to omit it.
2365 .br
2366 .I NOTE:
2367 See \-vc help for a full list of available codecs.
2368 .br
2369 If the list has a trailing ',' it will fallback to codecs not listed.
2370
2371 .I EXAMPLE:
2372 .PD 0
2373 .RSs
2374 .IPs "\-vc divx"
2375 force Win32/\:VFW DivX codec, no fallback
2376 .IPs "\-vc divx4,"
2377 try divx4linux codec first, then fallback to others
2378 .IPs "\-vc -divxds,-divx,"
2379 try other codecs except Win32 DivX codecs
2380 .IPs "\-vc ffmpeg12,mpeg12,"
2381 try libavcodec's MPEG1/\:2 codec, then libmpeg2, then others
2382 .RE
2383 .PD 1
2384 .
2385 .TP
2386 .B \-vfm <driver1,driver2,...>
2387 Specify a priority list of video codecs to be used, according to their
2388 names in codecs.conf.
2389 It falls back to default if none is ok.
2390 .br
2391 .I NOTE:
2392 If libdivxdecore support was compiled in, then odivx and divx4 now contains
2393 just the same DivX4 codec, but different APIs to reach it.
2394 For difference between them and when to use which, check the DivX4 section in
2395 the documentation.
2396 .br
2397 See \-vfm help for a full list of available drivers.
2398
2399 .I EXAMPLE:
2400 .PD 0
2401 .RSs
2402 .IPs "\-vfm ffmpeg,dshow,vfw"
2403 try the libavcodec, then Directshow, then VFW codecs and fallback to the
2404 others, if still none is ok
2405 .IPs "\-vfm xanim"
2406 try XAnim codecs first
2407 .RE
2408 .PD 1
2409 .
2410 .TP
2411 .B \-x <x> (MPLAYER only)
2412 Scale image to x width (if sw/\:hw scaling available).
2413 Disables aspect calculations.
2414 .TP
2415 .B \-xvidopts <option1:option2:...>
2416 Specify additional parameters when decoding with XviD.
2417 .
2418 .PD 0
2419 .RSs
2420 .IPs deblock-chroma
2421 Activate XviD internal postprocessing filter: chroma deblock filter.
2422 See also \-vf pp, which is faster than XviD's own filter.
2423 .IPs deblock-luma
2424 Activate XviD internal postprocessing filter: luma deblock filter.
2425 See also \-vf pp, which is faster than XviD's own filter.
2426 .IPs dr2\ \ 
2427 Activate direct rendering method 2.
2428 .IPs nodr2
2429 Deactivate direct rendering method 2.
2430 .IPs filmeffect
2431 Activate XviD internal film grain effect.
2432 Adds artificial film grain to the video. 
2433 May increase perceived quality, while lowering true quality.
2434 Also see \-vf noise.
2435 .RE
2436 .PD 1
2437 .
2438 .TP
2439 .B \-xy <value>
2440 .PD 0
2441 .RSs
2442 .IPs value<=8
2443 Scale image by factor <value>.
2444 .IPs value>8
2445 Set width to value and calculate height to keep correct aspect ratio.
2446 .RE
2447 .PD 1
2448 .
2449 .TP
2450 .B \-y <y> (MPLAYER only)
2451 Scale image to y height (if sw/\:hw scaling available).
2452 Disables aspect calculations.
2453 .TP
2454 .B \-zoom \ 
2455 Allow software scaling, where available.
2456 Could be used to force scaling with \-vf scale.
2457 .br
2458 .I NOTE:
2459 \-vf scale will IGNORE options \-x / \-y / \-xy / \-fs / \-aspect without
2460 \-zoom.
2461 .
2462 .
2463 .SH "VIDEO FILTERS"
2464 Video filter are plugins that allow you to modify the video stream and its
2465 properties.
2466 The syntax is:
2467 .TP
2468 .B \-vf <filter1[=parameters],filter2,...>
2469 Setup a chain of video filters.
2470 .TP
2471 .B \-vop <...,filter3[=parameters],filter2,filter1> (OBSOLETE)
2472 Setup a chain of video filters, to be applied in
2473 .B reverse
2474 order.
2475 Deprecated in favor of \-vf.
2476 .PP
2477 The parameters are optional and if omitted, some of them are set to default
2478 values.
2479 Use '-1' to keep the default value.
2480 Parameters w:h means width x height in pixels, x:y means x;y position counted
2481 from the upper left corner of the bigger image.
2482 .br
2483 .I NOTE:
2484 To get a full list of available filters, see \-vf help.
2485
2486 Filters are managed in lists.
2487 There are a few commands to manage the filter list.
2488 .TP
2489 .B \-vf-add <filter1[,filter2,...]>
2490 Appends the filters given as arguments to the filter list.
2491 .TP
2492 .B \-vf-pre <filter1[,filter2,...]>
2493 Prepends the filters given as arguments to the filter list.
2494 .TP
2495 .B \-vf-del <index1[,index2,...]>
2496 Deletes the filters at the given indexes.
2497 Index numbers start at 0, negative numbers address the end of the
2498 list (-1 is the last).
2499 .TP
2500 .B \-vf-clr
2501 Completely empties the filter list.
2502 .PP
2503 With filters that support it, you can access parameters by their name.
2504 .TP
2505 .B \-vf <filter>=help
2506 Prints the parameter names and parameter value ranges for a particular
2507 filter.
2508 .TP
2509 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
2510 Sets a named parameter to the given value.
2511 Use on and off or yes and no to set flag parameters.
2512 .PP
2513 Available filters are:
2514 .
2515 .TP
2516 .B crop[=w:h:x:y]
2517 Crops the given part of the image and discards the rest.
2518 Useful to remove black bands from widescreen movies.
2519 .PD 0
2520 .RSs
2521 .IPs w,h
2522 Cropped width and height, defaults to original width and height.
2523 .IPs x,y
2524 Position of the cropped picture, defaults to center.
2525 .RE
2526 .PD 1
2527 .TP
2528 .B cropdetect[=0\-255]
2529 Calculates necessary cropping parameters and prints the recommended parameters
2530 to stdout.
2531 The threshold can be optionally specified from nothing (0) to everything
2532 (255).
2533 (default: 24)
2534 .TP
2535 .B rectangle[=w:h:x:y]
2536 The plugin responds to the input.conf directive 'change_rectangle'
2537 that takes two parameters.
2538 .PD 0
2539 .RSs
2540 .IPs w,h
2541 width and height (default: -1, maximum possible width where boundaries
2542 are still visible.
2543 .IPs x,y
2544 top left corner position (default: -1, uppermost leftmost)
2545 .RE
2546 .PD 1
2547 .TP
2548 .B expand[=w:h:x:y:o]
2549 Expands (not scales) movie resolution to the given value and places the
2550 unscaled original at coordinates x, y.
2551 Can be used for placing subtitles/\:OSD in the resulting black bands.
2552 .RSs
2553 .IPs w,h
2554 expanded width,height (default: original width,height).
2555 Negative values for w and h are treated as offsets to the original size.
2556
2557 .I EXAMPLE:
2558 .PD 0
2559 .RSs
2560 .IP expand=0:-50:0:0
2561 adds a 50 pixel border to the bottom of the picture
2562 .RE
2563 .PD 1
2564 .IPs x,y
2565 position of original image on the expanded image (default: center)
2566 .IPs o
2567 OSD/subtitle rendering
2568 .RSss
2569 0: disable (default)
2570 .br
2571 1: enable
2572 .REss
2573 .RE
2574 .TP
2575 .B flip\ \ \ 
2576 Flips the image upside down.
2577 See also option \-flip.
2578 .TP
2579 .B mirror\ 
2580 Mirrors the image on the Y axis.
2581 .TP
2582 .B rotate[=<0\-7>]
2583 Rotates and flips (optional) the image +/\:- 90 degrees.
2584 For parameters between 4\-7 rotation is only done if the movie's geometry is
2585 portrait and not landscape.
2586 .TP
2587 .B scale[=w:h[:interlaced[:chr_drop[:param[:presize]]]]]
2588 Scales the image with the software scaler (slow) and performs a YUV<\->RGB
2589 colorspace conversion (also see \-sws option).
2590 .RSs
2591 .IPs w,h\ \ 
2592 scaled width/height (default: original width/height)
2593 .br
2594 .I NOTE:
2595 If \-zoom is used, and underlying filters (including libvo) are
2596 incapable of scaling, it defaults to d_width/\:d_height!
2597 .RSss
2598  0:   scaled d_width/\:d_height
2599 .br
2600 -1:   original width/\:height
2601 .br
2602 -2:   Calculate w/\:h using the other dimension and the prescaled aspect ratio.
2603 .br
2604 -3:   Calculate w/\:h using the other dimension and the original aspect ratio.
2605 .REss
2606 .IPs interlaced
2607 Toggle interlaced scaling.
2608 .IPs chr_drop
2609 chroma skipping
2610 .RSss
2611 0: use all available input lines for chroma
2612 .br
2613 1: use only every 2. input line for chroma
2614 .br
2615 2: use only every 4. input line for chroma
2616 .br
2617 3: use only every 8. input line for chroma
2618 .REss
2619 .IPs param
2620 scaling parameter (depends upon the scaling method used)
2621 .RSss
2622 \-sws 2 (bicubic):  sharpness (0 (soft) \- 100 (sharp))
2623 .br
2624 \-sws 7 (gaussian): sharpness (0 (soft) \- 100 (sharp))
2625 .br
2626 \-sws 9 (lanczos):  filter length (1\-10)
2627 .REss
2628 .IPs presize
2629 Scale to preset sizes.
2630 .RSss
2631 qntsc:   352x240 (NTSC quarter screen)
2632 .br
2633 qpal:    352x288 (PAL quarter screen)
2634 .br
2635 ntsc:    720x480 (standard NTSC)
2636 .br
2637 pal:     720x576 (standard PAL)
2638 .br
2639 sntsc:   640x480 (square pixel NTSC)
2640 .br
2641 spal:    768x576 (square pixel PAL)
2642 .REss
2643 .RE
2644 .TP
2645 .B dsize={aspect|w:h}
2646 Changes the intended display size/aspect at an arbitrary point in the
2647 filter chain.
2648 Aspect can be given as a fraction (4/3) or floating point number
2649 (1.33).
2650 Alternatively, you may specify the exact display width and height
2651 desired.
2652 Note that this filter does NOT do any scaling itself; it just affects
2653 what later scalers (software or hardware) will do when auto-scaling to
2654 correct aspect.
2655 .TP
2656 .B yuy2\ \ \ 
2657 Forces software YV12/\:I420 or 422P to YUY2 conversion.
2658 Useful for video cards/\:drivers with slow YV12 but fast YUY2 support.
2659 .TP
2660 .B yvu9\ \ \ 
2661 Forces software YVU9 to YV12 colorspace conversion.
2662 Deprecated in favor of the software scaler.
2663 .TP
2664 .B yuvcsp\ 
2665 Clamps YUV color values to the CCIR 601 range without doing real conversion.
2666 .TP
2667 .B rgb2bgr[=swap]
2668 RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion.
2669 .PD 0
2670 .RSs
2671 .IPs swap
2672 Also perform  R <\-> B swapping.
2673 .RE
2674 .PD 1
2675 .TP
2676 .B palette
2677 RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette.
2678 .TP
2679 .B format[=fourcc]
2680 Restricts the colorspace for the next filter without doing any conversion.
2681 Use together with the scale filter for a real conversion.
2682 For a list of available formats see format=fmt=help.
2683 .PD 0
2684 .RSs
2685 .IPs fourcc
2686 format name like rgb15, bgr24, yv12, etc (default: yuy2)
2687 .RE
2688 .PD 1
2689 .TP
2690 .B noformat[=fourcc]
2691 Restricts the colorspace for the next filter without doing any conversion.
2692 Unlike the format filter, this will allow any colorspace 
2693 .B except
2694 the one you specify.
2695 For a list of available formats see noformat=fmt=help.
2696 .PD 0
2697 .RSs
2698 .IPs fourcc
2699 format name like rgb15, bgr24, yv12, etc (default: yv12)
2700 .RE
2701 .PD 1
2702 .TP
2703 .B pp[=filter1[:option1[:option2...]]/[-]filter2...] (see \-pphelp too)
2704 This option enables usage of MPlayer's internal postprocessing filter,
2705 and also gives an interface where you can pass options to the named filter.
2706 To get a list of available filters, use \-pphelp.
2707 Note that each sub-filter must be separated with a / sign.
2708 .br
2709 Each filter defaults to 'c' (chrominance).
2710 .br
2711 The keywords accept a '-' prefix to disable the option.
2712 .br
2713 A ':' followed by a letter may be appended to the option to indicate its
2714 scope:
2715 .PD 0
2716 .RSs
2717 .IPs a
2718 Automatically switches the filter off if the CPU is too slow.
2719 .IPs c
2720 Do chrominance filtering, too.
2721 .IPs y
2722 Do not do chrominance filtering (only luminance filtering).
2723 .RE
2724 .PD 1
2725
2726 .RS
2727 .I EXAMPLE:
2728 .RE
2729 .PD 0
2730 .RSs
2731 .IPs "\-vf pp=hb/vb/dr/al"
2732 horizontal and vertical deblocking, deringing and automatic
2733 brightness/\:contrast
2734 .IPs "\-vf pp=hb/vb/dr/al/lb"
2735 horizontal and vertical deblocking, deringing, automatic
2736 brightness/\:contrast and linear blend deinterlacer
2737 .IPs "\-vf pp=de/-al"
2738 default filters without brightness/\:contrast correction
2739 .IPs "\-vf pp=de/tn:1:2:3"
2740 Enable default filters & temporal denoiser.
2741 .IPs "\-vf pp=hb:y/vb:a \-autoq 6"
2742 Deblock horizontal only luminance and switch vertical deblocking on or
2743 off automatically depending on available CPU time.
2744 .RE
2745 .PD 1
2746 .TP
2747 .B spp[=quality[:qp[:mode]]]
2748 simple postprocessing filter
2749 .RSs
2750 .IPs quality
2751 0\-6 (default: 3)
2752 .IPs qp\ \ \ 
2753 force quantization parameter (default: 0, use qp from video)
2754 .IPs mode\ \ \ 
2755 0: hard thresholding (default)
2756 .br
2757 1: soft thresholding (better deringing, but blurrier)
2758 .RE
2759 .TP
2760 .B qp=equation
2761 qp change filter
2762 .RSs
2763 .IPs equation
2764 some equation like "2+2*sin(PI*qp)"
2765 .RE
2766 .TP
2767 .B test\ \ \ 
2768 Generate various test patterns.
2769 .TP
2770 .B rgbtest
2771 Generate an RGB test pattern useful for detecting RGB vs BGR issues.
2772 You should see a red, green and blue stripe from top to bottom.
2773 .TP
2774 .B lavc[=quality:fps]
2775 Fast software YV12 to MPEG1 conversion with libavcodec for use with DVB/\:DXR3.
2776 Faster and of better quality than \-vf fame.
2777 .RSs
2778 .IPs quality
2779 .RSss
2780 1\-31: fixed qscale
2781 .br
2782 32\-:  fixed bitrate in kBits
2783 .REss
2784 .IPs fps\ \ 
2785 force output fps (float value) (default: 0, autodetect based on height)
2786 .RE
2787 .TP
2788 .B fame\ \ \ 
2789 Fast software YV12 to MPEG1 conversion with libfame for use with DVB/\:DXR3.
2790 .TP
2791 .B dvbscale[=aspect]
2792 Set up optimal scaling for DVB cards, scaling the X axis in hardware and
2793 calculating the Y axis scaling in software to keep aspect.
2794 It's only useful together with expand+scale
2795 (\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc).
2796 .RSs
2797 .IPs aspect
2798 control aspect ratio, calculate as DVB_HEIGHT*ASPECTRATIO (default:
2799 576*4/3=768), set it to 576*(16/9)=1024 for a 16:9 TV.
2800 .RE
2801 .TP
2802 .B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
2803 Adds noise.
2804 .PD 0
2805 .RSs
2806 .IPs <0\-100>
2807 luma noise
2808 .IPs <0\-100>
2809 chroma noise
2810 .IPs u
2811 uniform noise (gaussian otherwise)
2812 .IPs t
2813 temporal noise (noise pattern changes between frames)
2814 .IPs a
2815 averaged temporal noise (smoother, but a lot slower)
2816 .IPs h
2817 high quality (slightly better looking, slightly slower)
2818 .IPs p
2819 mix random noise with a (semi)regular pattern
2820 .RE
2821 .PD 1
2822 .
2823 .TP
2824 .B denoise3d[=luma:chroma:time]
2825 This filter aims to reduce image noise producing smooth images and making still
2826 images really still (This should enhance compressibility.).
2827 It can be given from 0 to 3 parameters.  If you omit a parameter, a reasonable
2828 value will be inferred.
2829 .PD 0
2830 .RSs
2831 .IPs luma\ 
2832 spatial luma strength (default = 4)
2833 .IPs chroma
2834 spatial chroma strength (default = 3)
2835 .IPs time\ 
2836 temporal strength (default = 6)
2837 .RE
2838 .PD 1
2839 .TP
2840 .B hqdn3d[=luma:chroma:time]
2841 High precision/\:quality version of the denoise3d filter.
2842 Parameters and usage are the same.
2843 .TP
2844 .B eq[=bright:cont]
2845 Software equalizer with interactive controls just like the hardware
2846 equalizer, for cards/\:drivers that do not support brightness and
2847 contrast controls in hardware.
2848 Might also be useful with MEncoder, either for fixing poorly captured
2849 movies, or for slightly reducing contrast to mask artifacts and get by
2850 with lower bitrates.
2851 Initial values in the range -100\-100 may be given on the command line.
2852 .TP
2853 .B eq2[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
2854 Alternative software equalizer that uses lookup tables (very slow),
2855 allowing gamma correction in addition to simple brightness
2856 and contrast adjustment.
2857 Note that it uses the same MMX optimized code as \-vf eq if all
2858 gamma values are 1.0.
2859 The parameters are given as floating point values.
2860 Parameters rg, gg, bg are the independent gamma values for the Red, Green
2861 and Blue components.
2862 The weight parameter can be used to reduce the effect of a high gamma value on
2863 bright image areas, e.g.\& keep them from getting overamplified and just plain
2864 white.
2865 A value of 0.0 turns the gamma correction all the way down while 1.0 leaves it
2866 at its full strength.
2867 Defaults are gamma=1.0, contrast=1.0, brightness=0.0, saturation=1.0,
2868 weight=1.0.
2869 Value ranges are 0.1\-10 for gamma, -2\-2 for contrast (negative values result
2870 in a negative image), -1\-1 for brightness, 0\-3 for saturation and 0\-1 for
2871 weight.
2872 .TP
2873 .B hue[=hue:saturation]
2874 Defaults are hue=0.0, saturation=1.0.
2875 Value ranges are -180\-180 for hue, -2\-2 for saturation (negative values result
2876 in a negative chroma).
2877 .TP
2878 .B halfpack[=f]
2879 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but
2880 keeping all chroma samples.
2881 Useful for output to low-resolution display devices when hardware downscaling
2882 is poor quality or is not available.
2883 Can also be used as a primitive luma-only deinterlacer with very low cpu
2884 usage.
2885 By default, halfpack averages pairs of lines when downsampling.
2886 The optional parameter f can be 0 to only use even lines, or 1 to only use
2887 odd lines.
2888 Any other value for f gives the default (averaging) behavior.
2889 .TP
2890 .B ilpack[=mode]
2891 When interlaced video is stored in YUV 4:2:0 formats, chroma
2892 interlacing does not line up properly due to vertical downsampling of
2893 the chroma channels.
2894 This filter packs the planar 4:2:0 data into YUY2 (4:2:2) format with
2895 the chroma lines in their proper locations, so that in any given
2896 scanline, the luma and chroma data both come from the same field.
2897 The optional argument selects the sampling mode.
2898 By default, linear interpolation (mode 1) is used.
2899 Mode 0 uses nearest-neighbor sampling, which is fast but incorrect.
2900 .TP
2901 .B decimate[=max:hi:lo:frac]
2902 Drops frames that don't differ greatly from the previous frame in
2903 order to reduce framerate.
2904 The argument max (if positive) sets the maximum number of consecutive
2905 frames which can be dropped, or (if negative) the minimum interval
2906 between dropped frames.
2907 A frame is a candidate for dropping if no 8x8 region differs by more
2908 than a threshold of hi, and if not more than frac portion (1 meaning
2909 the whole image) differs by more than a threshold of lo.
2910 Values of hi and lo are for 8x8 pixel blocks and represent actual
2911 pixel value differences, so a threshold of 64 corresponds to 1 unit of
2912 difference for each pixel, or the same spread out differently over the
2913 block.
2914 The main use of this filter is for very-low-bitrate encoding (e.g.\&
2915 streaming over dialup modem), but it could in theory be used for
2916 fixing movies that were inverse-telecined incorrectly.
2917 .TP
2918 .B dint[=sense:level]
2919 Detects and drops first of interlaced frames in video stream.
2920 Values can be from 0.0 to 1.0 \- first (default 0.1) is relative difference
2921 between neighbor pixels, second (default 0.15) is what part of image have to
2922 be detected as interlaced to drop the frame.
2923 .TP
2924 .B lavcdeint
2925 Use libavcodec's deinterlace filter.
2926 .TP
2927 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
2928 Donald Graft's adaptive kernel deinterlacer.
2929 Deinterlaces parts of a video if a configurable threshold is exceeded.
2930 .PD 0
2931 .RSs
2932 .IPs "thresh (0 - 255)"
2933 Threshold (default 10).
2934 .IPs "map (0 or 1)"
2935 Paint pixels which exceed the threshold white (default: 0).
2936 .IPs "order (0 or 1)"
2937 Swap fields if 1 (default: 0).
2938 .IPs "sharp (0 or 1)"
2939 Enable additional sharpening (default: 0).
2940 .IPs "twoway (0 or 1)"
2941 Enable twoway sharpening (default: 0).
2942 .RE
2943 .PD 1
2944 .TP
2945 .B unsharp=l|cWxH:amount[:l|cWxH:amount]
2946 Unsharp mask / gaussian blur.
2947 .RSs
2948 .IPs l
2949 Apply effect on luma component.
2950 .IPs c
2951 Apply effect on chroma components.
2952 .IPs WxH
2953 width and height of the matrix, odd sized in both directions
2954 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7)
2955 .IPs amount
2956 Relative amount of sharpness/\:blur to add to the image
2957 (a sane range should be -1.5\-1.5).
2958 .RSss
2959 <0: blur
2960 .br
2961 >0: sharpen
2962 .REss
2963 .RE
2964 .TP
2965 .B swapuv\ 
2966 Swap U & V plane.
2967 .TP
2968 .B il=[d|i][s][:[d|i][s]]
2969 (de)interleaves lines.
2970 The goal of this filter is to add the ability to process interlaced images
2971 pre-field without deinterlacing them.
2972 You can filter your interlaced DVD and play it on a TV without breaking the
2973 interlacing.
2974 While deinterlacing (with the postprocessing filter) removes interlacing
2975 permanently (by smoothing, averaging, etc) deinterleaving splits the frame into
2976 2 fields (so called half pictures), so you can process (filter) them
2977 independently and then re-interleave them.
2978 .PD 0
2979 .RSs
2980 .IPs d
2981 deinterleave (placing one above the other)
2982 .IPs i
2983 interleave
2984 .IPs s
2985 swap fields (exchange even & odd lines)
2986 .RE
2987 .PD 1
2988 .TP
2989 .B fil=[i|d]
2990 (de)interleaves lines.
2991 This filter is very similar to the il filter but much faster, the main
2992 disadvantage is that it doesn't always work.
2993 Especially if combined with other filters it may produce randomly messed
2994 up images, so be happy if it works but don't complain if it doesn't for
2995 your combination of filters. 
2996 .PD 0
2997 .RSs
2998 .IPs d
2999 Deinterleave fields, placing them side by side.
3000 .IPs i
3001 Interleave fields again (reversing the effect of fil=d).
3002 .RE
3003 .PD 1
3004 .TP
3005 .B field[=n]
3006 Extracts a single field from an interlaced image using stride arithmetic
3007 to avoid wasting CPU time.
3008 The optional argument n specifies whether to extract the even or the odd
3009 field (depending on whether n is even or odd).
3010 .TP
3011 .B detc[=var1=value2:var2=value2:...]
3012 Attempts to reverse the 'telecine' process to recover a clean,
3013 non-interlaced stream at film framerate.
3014 This filter is still experimental but seems to be usable.
3015 Please be aware that there is absolutely no use in this filter
3016 unless you see interlacing when playing the movie!
3017 The following arguments (see syntax above) may be used to control
3018 its behavior:
3019 .RSs
3020 .IPs dr
3021 Set the frame dropping mode.
3022 0 (default) means don't drop frames to maintain fixed output framerate.
3023 1 means always drop a frame when there have been no drops or telecine
3024 merges in the past 5 frames.
3025 2 means always maintain exact 5:4 input to output frame ratio.
3026 .I NOTE:
3027 Use mode 1 with MEncoder.
3028 .IPs am
3029 Analysis mode.
3030 Available values are 0 (fixed pattern with initial frame number
3031 specified by fr=#) and 1 (agressive search for telecine pattern).
3032 Default is 1.
3033 .IPs fr
3034 Set initial frame number in sequence.
3035 0\-2 are the three clean progressive frames; 3 and 4 are the two
3036 interlaced frames.
3037 The default, -1, means 'not in telecine sequence'.
3038 The number specified here is the type for the imaginary previous
3039 frame before the movie starts.
3040 .IPs "tr0, tr1, tr2, tr3"
3041 Threshold values to be used in certain modes.
3042 .RE
3043 .TP
3044 .B ivtc[=1]
3045 Experimental 'stateless' inverse telecine filter.
3046 Rather than trying to lock on to a pattern like the detc filter does,
3047 ivtc makes its decisions independently for each frame.
3048 This will give much better results for material that has undergone
3049 heavy editing after telecine was applied, but as a result it is not as
3050 forgiving of noisy input, for example TV capture.
3051 The optional parameter (ivtc=1) corresponds to the dr=1 option for the
3052 detc filter, and should be used with MEncoder but not with MPlayer.
3053 As with detc, you must specify the correct output framerate (\-ofps
3054 23.976) when using MEncoder.
3055 .TP
3056 .B pullup\ 
3057 Third-generation pulldown reversal (inverse telecine) filter,
3058 capable of handling mixed hard-telecine, 24 fps progressive, and 30
3059 fps progressive content.
3060 The pullup filter is designed to be much more robust than detc or
3061 ivtc, but it is still under development.
3062 No configuration options are available yet.
3063 As the underlying pulldown reversal engine is designed to take
3064 advantage of the new features in MPlayer G2, the current
3065 implementation in G1 is meant to serve mainly as a testbed.
3066 .I NOTE:
3067 Presently pullup lacks any way to cap the output framerate, so
3068 during 30 fps progressive sequences or stills, it will output more
3069 than 24 fps, meaning you'll have trouble if you use it with mencoder
3070 \-ofps 23.976.
3071 .TP
3072 .B filmdint[=options]
3073 Inverse telecine filter, similar to the pullup filter above.
3074 It is designed to handle any pulldown pattern, including mixed soft and
3075 hard telecine and limited support for movies that are slowed down or sped
3076 up from their original framerate for TV.
3077 Only the luma plane is used to find the frame breaks.
3078 If a field has no match, it is deinterlaced with simple linear
3079 approximation.
3080 If the source is MPEG-2, and this must be the first filter to allow
3081 access to the field-flags set by the MPEG-2 decoder.
3082 Depending on the source mpeg, you may be fine ignoring this advice, as
3083 long as you do not see lots of "Bottom-first field" warnings.
3084 With no options it does normal inverse telecine, and should be used
3085 together with mencoder \-fps 29.97 \-ofps 23.976.
3086 When this filter is used with mplayer, it will result in an uneven
3087 framerate during playback, but it is still generally better than using
3088 pp=lb or no deinterlacing at all.
3089 Multiple options can be specified separated by /.
3090 .RSs
3091 .IPs crop=w:h:x:y
3092 Just like the crop filter, but faster, and works on mixed hard and soft
3093 telecined content as well as when y is not a multiple of 4.
3094 If x or y would require cropping fractional pixels from the chroma
3095 planes, the crop area is extended.
3096 This usually means that x and y must be even.
3097 .IPs io=ifps:ofps
3098 For each ifps input frames the filter will output ofps frames.
3099 The ratio of ifps/ofps should match the \-fps/\-ofps ratio.
3100 This could be used to filter movies that are broadcast on TV at a frame
3101 rate different from their original frame rate.
3102 .IPs luma_only=n
3103 If n is nonzero, the chroma plane is copied unchanged.
3104 This is useful for YV12 sampled TV, which discards one of the chroma
3105 fields.
3106 .IPs mmx2=n
3107 On x86, if n=1, use MMX2 optimized functions, if n=2, use 3DNow!
3108 optimized functions, othewise, use plain C.
3109 If this option is not specified, MMX2 and 3DNow! are auto-detected, use
3110 this option to override auto-detection.
3111 .IPs fast=n
3112 The larger n will speed up the filter at the expense of accuracy.
3113 The default value is n=3.
3114 If n is odd, a frame immediately following a frame marked with the
3115 REPEAT_FIRST_FIELD mpeg flag is assumed to be progressive, thus filter
3116 will not spend any time on soft-telecined MPEG-2 content.
3117 This is the only effect of this flag if MMX2 or 3DNow! is available.
3118 Without MMX2 and 3DNow, if n=0 or 1, the same calculations will be used
3119 as with n=2 or 3.
3120 If n=2 or 3, the number of luma levels used to find the frame breaks is
3121 reduced from 256 to 128, which results in a faster filter without losing
3122 much accuracy.
3123 If n=4 or 5, a faster, but much less accurate metric will be used to
3124 find the frame breaks, which is more likely to misdetect high vertical
3125 detail as interlaced content.
3126 .IPs verbose=n
3127 If n is nonzero, print the detailed metrics for each frame.
3128 Useful for debugging.
3129 .IPs dint_thres=n
3130 Deinterlace threshold.
3131 Used during de-interlacing of unmatched frames.
3132 Larger value means less deinterlacing, use n=256 to completely turn off
3133 deinterlacing.
3134 Default is n=8.
3135 .IPs comb_thres=n
3136 Threshold for comparing a top and bottom fields.
3137 Defaults to 128.
3138 .IPs diff_thres=n
3139 Threshold to detect temporal change of a field.
3140 Default is 128.
3141 .IPs sad_thres=n
3142 Sum of Absolute Difference threshold, default is 64.
3143 .RE
3144 .TP
3145 .B softpulldown
3146 This filter works only correct with MEncoder and acts on the MPEG2 flags
3147 used for soft 3:2 pulldown (soft telecine).
3148 If you want to use the ivtc or detc filter on movies that are partly soft
3149 telecined, inserting this filter before them should make them more reliable.
3150 Currently only libmpeg2 exports the needed flags.
3151 If used on material that does not set them, the filter does nothing.
3152 .TP
3153 .B phase=[t|b|p|a|u|T|B|A|U][:v]
3154 Delay interlaced video by one field time so that the field order
3155 changes.
3156 The intended use is to fix PAL movies that have been captured with the
3157 opposite field order to the film-to-video transfer.
3158 The options are:
3159 .RSs
3160 .IPs t
3161 Capture field order top-first, transfer bottom-first.
3162 Filter will delay the bottom field.
3163 .IPs b
3164 Capture bottom-first, transfer top-first.
3165 Filter will delay the top field.
3166 .IPs p
3167 Capture and transfer with the same field order.
3168 This mode only exists for the documentation of the other options to refer to,
3169 but if you actually select it, the filter will faithfully do nothing ;-)
3170 .IPs a
3171 Capture field order determined automatically by field flags, transfer opposite.
3172 Filter selects among t and b modes on a frame by frame basis using field flags.
3173 If no field information is available, then this works just like u.
3174 .IPs u
3175 Capture unknown or varying, transfer opposite.
3176 Filter selects among t and b on a frame by frame basis by analyzing the
3177 images and selecting the alternative that produces best match between the
3178 fields.
3179 .IPs T
3180 Capture top-first, transfer unknown or varying.
3181 Filter selects among t and p using image analysis.
3182 .IPs B
3183 Capture bottom-first, transfer unknown or varying.
3184 Filter selects among b and p using image analysis.
3185 .IPs A
3186 Capture determined by field flags, transfer unknown or varying.
3187 Filter selects among t, b and p using field flags and image analysis.
3188 If no field information is available, then this works just like U.
3189 This is the default mode.
3190 .IPs U
3191 Both capture and transfer unknown or varying.
3192 Filter selects among t, b and p using image analysis only.
3193 .IPs v
3194 Verbose operation.
3195 Prints the selected mode for each frame and the average squared difference
3196 between fields for t, b, and p alternatives.
3197 .RE
3198 .TP
3199 .B telecine[=start]
3200 Apply 3:2 'telecine' process to increase framerate by 20%.
3201 This most likely will not work correctly with MPlayer, but it can
3202 be used with 'mencoder \-fps 29.97 \-ofps 29.97 \-vf telecine'.
3203 Both fps options are essential!
3204 (A/V sync will break if they are wrong.)
3205 The optional start parameter tells the filter where in the telecine
3206 pattern to start (0\-3).
3207 .TP
3208 .B tinterlace[=mode]
3209 Temporal field interlacing \- merge pairs of frames into an interlaced
3210 frame, halving the framerate. Even frames are moved into the upper
3211 field, odd frames to the lower field. This can be used to fully reverse
3212 the effect of the tfields filter (in mode 0). Available modes are:
3213 .PD 0
3214 .RSs
3215 .IPs 0
3216 odd frames into upper field, even to lower, generating a full-height
3217 frame at half the framerate
3218 .IPs 1
3219 only output odd frames, even frames are dropped, height unchanged
3220 .IPs 2
3221 only output even frames, odd frames are dropped, height unchanged
3222 .IPs 3
3223 expand each frame to full height, but pad alternate lines with black,
3224 framerate unchanged
3225 .RE
3226 .PD 1
3227 .TP
3228 .B tfields[=mode]
3229 Temporal field separation \- split fields into frames, doubling the
3230 output framerate.
3231 Like the telecine filter, tfields will only work properly with
3232 MEncoder, and only if both \-fps and \-ofps are set to the
3233 desired (double) framerate!
3234 Available modes are:
3235 .PD 0
3236 .RSs
3237 .IPs 0
3238 leave fields unchanged (this will jump/flicker)
3239 .IPs 1
3240 interpolate missing lines (the algorithm used might not be so good)
3241 .IPs 2
3242 translate fields by 1/4 pixel with linear interp (no jump)
3243 .IPs 4
3244 translate fields by 1/4 pixel with 4tap filter (higher quality)
3245 .RE
3246 .PD 1
3247 .TP
3248 .B boxblur=radius:power[:radius:power]
3249 box blur
3250 .PD 0
3251 .RSs
3252 .IPs radius
3253 size of the filter
3254 .IPs power
3255 How often the filter should be applied.
3256 .RE
3257 .PD 1
3258 .TP
3259 .B sab=rad:pf:colorDiff[:rad:pf:colorDiff]
3260 shape adaptive blur
3261 .PD 0
3262 .RSs
3263 .IPs rad\ \ \ 
3264 blur filter strength (~0.1\-4.0) (slower if larger)
3265 .IPs pf\ \ \ 
3266 prefilter strength (~0.1\-2.0)
3267 .IPs colorDiff
3268 How different the pixels are allowed to be considered.
3269 (~0.1\-100.0)
3270 .RE
3271 .PD 1
3272 .TP
3273 .B smartblur=rad:strength:thresh[:rad:strength:thresh]
3274 smart blur
3275 .PD 0
3276 .RSs
3277 .IPs rad\ \ 
3278 blur filter strength (~0.1\-5.0) (slower if larger)
3279 .IPs strength
3280 blur (0.0\-1.0) or sharpen (-1.0\-0.0)
3281 .IPs thresh
3282 filter all (0), filter flat areas (0\-30) or filter edges (-30\-0)
3283 .RE
3284 .PD 1
3285 .TP
3286 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
3287 perspective correction
3288 .PD 0
3289 .RSs
3290 .IPs x0,y0,...
3291 coordinates of the top left, top right, bottom left, bottom right corners
3292 .IPs t\ \ \ \ 
3293 linear (0) or cubic resampling (1)
3294 .RE
3295 .PD 1
3296 .TP
3297 .B 2xsai\ \ 
3298 Use the 2x scale and interpolate algorithm for scaling and smoothing images.
3299 .TP
3300 .B 1bpp\ \ \ 
3301 1bpp bitmap to YUV/BGR 8/15/16/32 conversion
3302 .TP
3303 .B down3dright[=lines]
3304 Reposition and resize stereoscopic images.
3305 Extracts both stereo fields and places them side by side, resizing
3306 them to maintain the original movie aspect.
3307 .PD 0
3308 .RSs
3309 .IPs lines
3310 number of lines to select from the middle of the image (default: 12)
3311 .RE
3312 .PD 1
3313 .TP
3314 .B bmovl=hidden:opaque:<fifo>
3315 Read bitmaps from a FIFO and display them in a window.
3316 .
3317 .PD 0
3318 .RSs
3319 .IPs hidden
3320 sets the default value of the 'hidden' flag (boolean)
3321 .IPs opaque
3322 flag switching between alphablended (transparent) and opaque (fast) mode
3323 .IPs fifo\ 
3324 path/filename for the FIFO (named pipe connecting mplayer \-vf bmovl to the
3325 controlling application)
3326 .RE
3327 .PD 1
3328
3329 .RS
3330 FIFO commands are:
3331 .RE
3332 .PD 0
3333 .RSs
3334 .IPs "RGBA32 width height xpos ypos alpha clear"
3335 followed by width*height*4 Bytes of raw RGBA32 data.
3336 .IPs "ABGR32 width height xpos ypos alpha clear"
3337 followed by width*height*4 Bytes of raw ABGR32 data.
3338 .IPs "RGB24 width height xpos ypos alpha clear"
3339 followed by width*height*3 Bytes of raw RGB32 data.
3340 .IPs "BGR24 width height xpos ypos alpha clear"
3341 followed by width*height*3 Bytes of raw BGR32 data.
3342 .IPs "ALPHA width height xpos ypos alpha"
3343 change alpha for area
3344 .IPs "CLEAR width height xpos ypos"
3345 clear area
3346 .IPs OPAQUE
3347 disable all alpha transparency.
3348 Send "ALPHA 0 0 0 0 0" to enable it again.
3349 .IPs HIDE\ 
3350 hide bitmap
3351 .IPs SHOW\ 
3352 show bitmap
3353 .RE
3354 .PD 1
3355
3356 .RS
3357 Arguments are:
3358 .RE
3359 .PD 0
3360 .RSs
3361 .IPs "width, height"
3362 size of image/area
3363 .IPs "xpos, ypos"
3364 start blitting at X/Y position   
3365 .IPs alpha
3366 set alpha difference.
3367 If you set this to -255 you can then send a sequence of ALPHA-commands to set
3368 the area to -225, -200, -175 etc for a nice fade-in-effect! ;)
3369 .RSss
3370 0:    same as original
3371 .br
3372 255:  makes everything opaque
3373 .br
3374 -255: makes everything transparent
3375 .REss
3376 .IPs clear
3377 clear the framebuffer before blitting.
3378 .RSss
3379 0: The image will just be blitted on top of the old one, so you don't need to
3380 send 1,8MB of RGBA32 data everytime a small part of the screen is updated.
3381 .br
3382 1: clear
3383 .REss
3384 .RE
3385 .PD 1
3386 .TP
3387 .B framestep=I|[i]step
3388 Renders only every nth frame or every Intra (key) frame.
3389
3390 If you call the filter with I (uppercase) as the parameter, then ONLY 
3391 keyframes are rendered.
3392 For DVDs it generally means one in every 15/12  frames (IBBPBBPBBPBBPBB),
3393 for AVI it means every scene change or every keyint value (see \-lavcopts
3394 keyint= value if you use MEncoder to encode the video).
3395
3396 When a key frame is found, an 'I!' string followed by a newline character is
3397 printed, leaving the current line of mplayer/mencoder output on the screen,
3398 because it contains the time (in seconds) and frame number of the keyframe
3399 (You can use this information to split the AVI.).
3400
3401 If you call the filter with a numeric parameter 'step' then only one in
3402 every 'step' frames is rendered.
3403
3404 If you put an 'i' (lowercase) before the number then an I! is printed 
3405 (like the I parameter).
3406
3407 If you give only the i then nothing is done to the frames, only I! is 
3408 printed.
3409 .TP
3410 .B tile=xtile:ytile:output:start:delta
3411 Tile a series of images into a single, bigger image.
3412 If you omit a parameter or use a value less than 0, then the default
3413 value is used. You can also stop when you're OK (... \-vf tile=10:5 ...)
3414 .
3415 It is probably a good idea to put the scale filter before the tile :-)
3416 .br
3417 The parameters are:
3418
3419 .PD 0
3420 .RSs
3421 .IPs xtile
3422 number of tiles on the x axis (default: 5)
3423 .IPs ytile
3424 number of tiles on the y axis (default: 5)
3425 .IPs output
3426 Render the tile when 'output' number of frames are reached, where 'output'
3427 should be a number less than xtile * ytile.
3428 Missing tiles are left blank.
3429 You could, for example, write an 8 * 7 tile every 50 frames to have one
3430 image every 2 seconds @ 25 fps.
3431 .IPs start  
3432 pixel at the start (x/y) (default: 2)
3433 .IPs delta
3434 pixel between 2 tiles, (x/y) (default: 4)
3435 .RE
3436 .PD 1
3437 .TP
3438 .B delogo[=x:y:w:h:t]
3439 Suppresses a TV station logo by a simple interpolation of the
3440 surrounding pixels. Just set a rectangle covering the logo and watch
3441 it disappear (and sometimes something even uglier appear \- your
3442 mileage may vary).
3443 .PD 0
3444 .RSs
3445 .IPs x,y
3446 Position of the top left corner of the logo.
3447 .IPs w,h
3448 Width and height of the cleared rectangle.
3449 .IPs t
3450 Thickness of the fuzzy edge of the rectangle (added to w and h). When
3451 set to -1, a green rectangle is drawn on the screen to simplify finding
3452 the right x,y,w,h parameters.
3453 .RE
3454 .PD 1
3455 .TP
3456 .B zrmjpeg[=options]
3457 Software YV12 to MJPEG encoder for use with the zr2 video
3458 output device.
3459 .RSs
3460 .IPs maxheight=h|maxwidth=w
3461 These options set the maximum width and height the zr card
3462 can handle (the MPlayer filter layer currently cannot query those).
3463 .IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
3464 Use these options to set maxwidth and maxheight automatically to the 
3465 values known for card/mode combo.
3466 For example, valid options are: dc10-PAL and buz-NTSC (default: dc10+PAL)
3467 .IPs color|bw
3468 Select color or black and white encoding.
3469 Black and white encoding is faster.
3470 Color is the default.
3471 .IPs hdec={1,2,4}
3472 Horizontal decimation 1, 2 or 4.
3473 .IPs vdec={1,2,4}
3474 Vertical decimation 1, 2 or 4.
3475 .IPs quality=1-20
3476 Set JPEG compression quality [BEST] 1 - 20 [VERY BAD].
3477 .IPs fd|nofd
3478 By default, decimation is only performed if the Zoran hardware
3479 can upscale the resulting MJPEG images to the original size.
3480 The option fd instructs the filter to always perform the requested
3481 decimation (ugly).
3482 .RE
3483 .
3484 .
3485 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
3486 Video output drivers are interfaces to different output facilities.
3487 The syntax is:
3488 .TP
3489 .B \-vo <driver1[:option],driver2,...[,]>
3490 Specify a priority list of video output drivers to be used.
3491 .PP
3492 If the list has a trailing ',' it will fall back to drivers not listed on the
3493 command line.
3494 Suboptions are optional and can mostly be omitted.
3495 .br
3496 .I NOTE:
3497 See \-vo help for a list of compiled-in drivers.
3498
3499 .I EXAMPLE:
3500 .PD 0
3501 .RSs
3502 .IPs "\-vo xmga,xv,"
3503 Try the Matrox X11 driver, then the Xv driver, then others.
3504 .br
3505 .IPs "\-vo directx:noaccel"
3506 Uses the DirectX driver with acceleration features turned off.
3507 .RE
3508 .PD 1
3509 .
3510
3511 Available output drivers are:
3512 .
3513 .TP
3514 .B xv (X11 only)
3515 Uses the XVideo extension of XFree86 4.x to enable hardware
3516 accelerated playback.
3517 If you cannot use a hardware specific driver, this is probably
3518 the best option.
3519 .PD 0
3520 .RSs
3521 .IPs port=<number>
3522 Select a specific XVideo port.
3523 .RE
3524 .PD 1
3525 .TP
3526 .B x11 (X11 only)
3527 Shared memory output driver without hardware acceleration that
3528 works whenever X11 is present.
3529 .TP
3530 .B xover (X11 only)
3531 Adds X11 support to all overlay based video output drivers.
3532 Currently only supported by tdfx_vid.
3533 .TP
3534 .B xvmc (X11 only)
3535 This video output driver employs the XvMC (X Video Motion Compensation)
3536 extension of XFree86 4.x.
3537 .TP
3538 .B dga (X11 only)
3539 Output video through the XFree86 Direct Graphics Access extension.
3540 Considered obsolete.
3541 .TP
3542 .B sdl\ \ \ \ 
3543 Highly platform independent SDL (Simple Directmedia Layer) library
3544 output driver.
3545 .TP
3546 .B vidix\ \ 
3547 VIDIX (VIDeo Interface for *niX) is an interface to the
3548 video acceleration features of different graphics cards.
3549 Very fast output driver on cards that support it.
3550 .TP
3551 .B xvidix (X11 only)
3552 VIDIX running under X11.
3553 .TP
3554 .B cvidix\ 
3555 VIDIX running in a console.
3556 .TP
3557 .B winvidix (Windows only)
3558 Windows version of the VIDIX driver.
3559 .TP
3560 .B directx (Windows only)
3561 Output driver that uses the DirectX interface.
3562 .PD 0
3563 .RSs
3564 .IPs noaccel
3565 Turns off hardware acceleration.
3566 Try this option if you have display problems.
3567 .RE
3568 .PD 1
3569 .TP
3570 .B quartz (Mac OS X only)
3571 Mac OS X Quartz output driver.
3572 .TP
3573 .B fbdev (Linux only)
3574 Uses the kernel framebuffer to output video.
3575 .TP
3576 .B fbdev2 (Linux only)
3577 Uses the kernel framebuffer to output video,
3578 alternative implementation.
3579 .TP
3580 .B vesa\ \ \ 
3581 Very general output driver that should work on any VESA VBE 2.0
3582 compatible card.
3583 .PD 0
3584 .RSs
3585 .IPs dga\ \ 
3586 Turns on DGA mode.
3587 .IPs nodga
3588 Turns off DGA mode.
3589 .IPs vidix
3590 FIXME: document this
3591 .IPs lvo\ \ 
3592 FIXME: document this
3593 .RE
3594 .PD 1
3595 .TP
3596 .B svga\ \ \ 
3597 Output video using the SVGA library.
3598 .TP
3599 .B gl\ \ \ \ \ 
3600 OpenGL output driver.
3601 Very simple version, no OSD support and video size must be smaller than
3602 the maximum texture size of your OpenGL implementation.
3603 Intended to work even with the most simple OpenGL implementations.
3604 .PD 0
3605 .RSs
3606 .IPs manyfmts
3607 Enables support for more (RGB and BGR) color formats.
3608 Needs OpenGL version >= 1.2, NOT yet WORKING correctly.
3609 .IPs slice-height=<0\-...>
3610 Number of lines copied to texture in one piece (default: 4).
3611 0 for whole image.
3612 .RE
3613 .PD 1
3614 .TP
3615 .B gl2\ \ \ \ 
3616 OpenGL output driver, second generation.
3617 Supports OSD and videos larger than maximum texture size.
3618 .TP
3619 .B null\ \ \ 
3620 Produces no video output.
3621 Useful for benchmarking.
3622 .TP
3623 .B aa\ \ \ \ \ 
3624 ASCII art output driver that works on a text console.
3625 .TP
3626 .B caca\ \ \ 
3627 Colour AsCii Art output driver that works on a text console.
3628 .TP
3629 .B bl\ \ \ \ \ 
3630 Video playback using the Blinkenlights UDP protocol.
3631 This driver is highly hardware specific.
3632 .TP
3633 .B ggi\ \ \ \ 
3634 Output driver for the GGI graphics system.
3635 .TP
3636 .B directfb
3637 Play video using the DirectFB library.
3638 .PD 0
3639 .RSs
3640 .IPs (no)input
3641 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
3642 .IPs buffermode=single|double|triple
3643 Double and triple buffering give best results if you want to avoid tearing issues.
3644 Triple buffering is more efficent than double buffering as it doesn't block MPlayer
3645 while waiting for the vertical retrace.
3646 Single buffering should be avoided (default: single).
3647 .IPs fieldparity=top|bottom
3648 Control the output order for interlaced frames (default: disabled).
3649 Valid values are top = top fields first, bottom = bottom fields first.
3650 This option doesn't have any effect on progressive film material
3651 like most MPEG movies are.
3652 You need to enable this option if you have tearing issues/unsmooth
3653 motions watching interlaced film material.
3654 .IPs layer=N
3655 Will force layer with id N for playback (default: -1 - auto).
3656 .RE
3657 .PD 1
3658 .TP
3659 .B dfbmga\ 
3660 Matrox G400/G450/G550 specific output driver that uses the DirectFB library.
3661 Enables CRTC2 (second head), displaying video independently of the first head.
3662 .PD 0
3663 .RSs
3664 .IPs (no)bes
3665 Enable the use of the Matrox BES (backend scaler) (default: disabled).
3666 Gives very good results concerning speed and output quality as interpolated
3667 picture processing is done in hardware.
3668 Works only on the primary head.
3669 .IPs (no)spic
3670 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
3671 .IPs (no)crtc2
3672 Turn on TV-out on the second head (default: enabled).
3673 The output quality is amazing as it's a full interlaced picture
3674 with proper sync to every odd/even field.
3675 .IPs (no)input
3676 Use the DirectFB instead of the MPlayer keyboard code (default: disabled).
3677 .IPs buffermode=single|double|triple
3678 Double and triple buffering give best results if you want to avoid tearing issues.
3679 Triple buffering is more efficent than double buffering as it doesn't block MPlayer
3680 while waiting for the vertical retrace.
3681 Single buffering should be avoided (default: triple).
3682 .IPs fieldparity=top|bottom
3683 Control the output order for interlaced frames (default: disabled).
3684 Valid values are top = top fields first, bottom = bottom fields first.
3685 This option doesn't have any effect on progressive film material
3686 like most MPEG movies are.
3687 You need to enable this option if you have tearing issues/unsmooth
3688 motions watching interlaced film material.
3689 .IPs tvnorm=pal|ntsc|auto
3690 Will set the TV norm of the Matrox card without the need
3691 for modifying /etc/\:directfbrc (default: disabled).
3692 Valid norms are pal = PAL, ntsc = NTSC.
3693 Special norm is auto (auto-adjust using PAL/NTSC) because it decides
3694 which norm to use by looking at the frame rate of the movie.
3695 .RE
3696 .PD 1
3697 .TP
3698 .B mga (Linux only)
3699 Matrox specific output driver that makes use of the YUV back
3700 end scaler on Gxxx cards through a kernel module.
3701 If you have a Matrox card, this is the fastest option.
3702 .TP
3703 .B xmga (Linux, X11 only)
3704 The mga output driver, running in an X11 window.
3705 .TP
3706 .B syncfb\ 
3707 Video output driver for the SyncFB kernel module, which provides
3708 special hardware features of Matrox Gxxx cards like hardware
3709 deinterlacing, scaling and synchronizing your video output to
3710 the vertical retrace of your monitor.
3711 .TP
3712 .B 3dfx (Linux only)
3713 This driver employs the tdfx framebuffer driver to play movies with
3714 YUV acceleration.
3715 .TP
3716 .B tdfx_vid (Linux only)
3717 3Dfx specific output driver.
3718 Works in conjunction with a kernel module.
3719 .TP
3720 .B dxr2\ \ \ 
3721 Creative DXR2 specific output driver.
3722 Also see the -dxr2 option.
3723 .PD 0
3724 .RSs
3725 .IPs x11
3726 Enables overlay.
3727 .IPs xv
3728 Enables overlay.
3729 .RE
3730 .PD 1
3731 .TP
3732 .B dxr3\ \ \ 
3733 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
3734 Hollywood Plus) specific output driver.
3735 Also see the lavc video filter.
3736 .PD 0
3737 .RSs
3738 .IPs overlay
3739 Activates the overlay instead of TVOut.
3740 .IPs prebuf
3741 Turns on prebuffering.
3742 .IPs sync
3743 Will turn on the new sync-engine.
3744 .IPs norm=<norm>
3745 Specifies the TV norm.
3746 .RSss
3747 0: Does not change current norm (default).
3748 .br
3749 1: Auto-adjust using PAL/NTSC.
3750 .br
3751 2: Auto-adjust using PAL/PAL-60.
3752 .br
3753 3: PAL
3754 .br
3755 4: PAL-60
3756 .br
3757 5: NTSC
3758 .REss
3759 .IPs device=<number>
3760 Specifies the device number to use if you have more than one em8300 card.
3761 .RE
3762 .PD 1
3763 .TP
3764 .B mpegpes
3765 DVB specific output driver.
3766 .TP
3767 .B zr\ \ \ \ \ 
3768 Output driver for a number of MJPEG capture/playback cards.
3769 Also see the -zr* options and -zrhelp.
3770 .TP
3771 .B zr2\ \ \ \ 
3772 Output driver for a number of MJPEG capture/playback cards, second generation.
3773 Also see the zrmjpeg video filter.
3774 .TP
3775 .B md5\ \ \ \ 
3776 Writes md5sums for each frame into a file called 'md5' in the
3777 current directory.
3778 Useful for debugging.
3779 .TP
3780 .B yuv4mpeg
3781 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
3782 images and stores it in a file called 'stream.yuv' in the current
3783 directory.
3784 Useful if you want to process the video with the mjpegtools suite.
3785 .TP
3786 .B gif89a\ 
3787 Output each frame into a GIF file in the current directory.
3788 Each file takes the frame number padded with leading zeros as name.
3789 .TP
3790 .B jpeg\ \ \ 
3791 Output each frame into a JPEG file in the current directory.
3792 Each file takes the frame number padded with leading zeros as name.
3793 .TP
3794 .B pgm\ \ \ \ 
3795 Output each frame into a PGM file in the current directory.
3796 Each file takes the frame number padded with leading zeros as name.
3797 .TP
3798 .B png\ \ \ \ 
3799 Output each frame into a PNG file in the current directory.
3800 Each file takes the frame number padded with leading zeros as name.
3801 .TP
3802 .B tga\ \ \ \ 
3803 Output each frame into a Targa file in the current directory.
3804 Each file takes the frame number padded with leading zeros as name.
3805 .
3806 .
3807 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
3808 .TP
3809 .B \-audio-delay <0.0\-...>
3810 Sets the audio delay field in the header.
3811 Default is 0.0, negative values do not work.
3812 This does not delay the audio while encoding, but the player will see the
3813 default audio delay, sparing you the use of the \-delay option.
3814 .TP
3815 .B \-audio-density <1\-50>
3816 Number of audio chunks per second (default is 2 for 0.5s long audio chunks).
3817 .br
3818 .I NOTE:
3819 CBR only, VBR ignores this as it puts each packet in a new chunk.
3820 .TP
3821 .B \-audio-preload <0.0\-2.0>
3822 Sets up audio buffering time interval (default: 0.5s).
3823 .TP
3824 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see \-ss and \-sb option too)
3825 Stop encoding at given time or byte position.
3826 Can be specified in many ways:
3827 .br
3828 .I NOTE:
3829 Byte position won't be accurate, as it can only stop at
3830 a frame boundary.
3831
3832 .I EXAMPLE:
3833 .PD 0
3834 .RSs
3835 .IPs "\-endpos 56"
3836 encode only 56 seconds
3837 .IPs "\-endpos 01:10:00"
3838 encode only 1 hour 10 minutes
3839 .IPs "\-endpos 100mb"
3840 encode only 100 MBytes
3841 .RE
3842 .PD 1
3843 .
3844 .TP
3845 .B \-ffourcc <fourcc>
3846 Can be used to override the video fourcc of the output file.
3847
3848 .I EXAMPLE:
3849 .PD 0
3850 .RSs
3851 .IPs "\-ffourcc div3"
3852 will have the output file contain 'div3' as video fourcc.
3853 .RE
3854 .PD 1
3855 .
3856 .TP
3857 .B \-force-avi-aspect <0.2\-3.0>
3858 Override the aspect stored in the AVI OpenDML vprp header.
3859 This can be used to change the aspect ratio with \-ovc copy.
3860 .TP
3861 .B \-info <option1:option2:...> (AVI only)
3862 Specify the info header of the resulting AVI file.
3863 .br
3864 Available options are:
3865 .
3866 .RSs
3867 .IPs help\ 
3868 show this description
3869 .IPs name=<value>
3870 title of the subject of the file
3871 .IPs artist=<value>
3872 artist or author of the original subject of the file
3873 .IPs genre=<value>
3874 original work category
3875 .IPs subject=<value>
3876 contents of the file
3877 .IPs copyright=<value>
3878 copyright information for the file
3879 .IPs srcform=<value>
3880 original form of the material that was digitized
3881 .IPs comment=<value>
3882 general comments about the file or the subject of the file
3883 .RE
3884 .
3885 .TP
3886 .B \-noautoexpand
3887 Do not automatically insert the expand filter into the MEncoder filter chain.
3888 Useful to control at which point of the filter chain subtitles are rendered
3889 when hardcoding subtitles onto a movie.
3890 .TP
3891 .B \-noskip
3892 Do not skip frames.
3893 .TP
3894 .B \-o <filename>
3895 Outputs to the given filename, instead of the default 'test.avi'.
3896 .TP
3897 .B \-oac <codec name>
3898 Encode with the given audio codec.
3899 Use \-oac help to get a list of available codecs.
3900 (no default set)
3901
3902 .I EXAMPLE:
3903 .PD 0
3904 .RSs
3905 .IPs "\-oac copy"
3906 no encoding, just streamcopy
3907 .IPs "\-oac pcm"
3908 encode to uncompressed PCM
3909 .IPs "\-oac mp3lame"
3910 encode to MP3 (using Lame)
3911 .IPs "\-oac lavc"
3912 encode with a libavcodec codec
3913 .RE
3914 .PD 1
3915 .
3916 .TP
3917 .B \-of <format> (BETA CODE!)
3918 Encode to the specified format.
3919 Use \-of help to get a list of available formats.
3920
3921 .I EXAMPLE:
3922 .PD 0
3923 .RSs
3924 .IPs "\-of avi"
3925 encode to avi (default)
3926 .IPs "\-of mpeg"
3927 encode to mpeg
3928 .IPs "\-of rawvideo"
3929 raw video stream (no muxing - video only, one stream only)
3930 .RE
3931 .PD 1
3932 .
3933 .TP
3934 .B \-ofps <fps>
3935 The output file will have different frame/\:sec than the source.
3936 You MUST set it for variable fps (asf, some mov) and progressive
3937 (29.97fps telecined mpeg) files.
3938 .TP
3939 .B \-ovc <codec name>
3940 Encode with the given video codec.
3941 Use \-ovc help to get a list of available codecs.
3942 (no default set)
3943
3944 .I EXAMPLE:
3945 .PD 0
3946 .RSs
3947 .IPs "\-ovc copy"
3948 no encoding, just streamcopy
3949 .IPs "\-ovc divx4"
3950 encode to DivX4/\:DivX5
3951 .IPs "\-ovc raw"
3952 encode to arbitrary uncompressed format (use \-vf format to select)
3953 .IPs "\-ovc lavc"
3954 encode with a libavcodec codecs
3955 .RE
3956 .PD 1
3957 .
3958 .TP
3959 .B \-passlogfile <filename>
3960 When encoding in 2pass mode, MEncoder dumps first pass' informations
3961 to the given file instead of the default divx2pass.log.
3962 .TP
3963 .B \-skiplimit <value>
3964 Maximum skippable frames after non-skipped one
3965 (\-noskiplimit for unlimited number).
3966 .TP
3967 .B \-vobsubout <basename>
3968 Specify the basename for the output .idx and .sub files.
3969 This turns off subtitle rendering in the encoded movie and diverts it to
3970 Vobsub subtitle files.
3971 .TP
3972 .B \-vobsuboutid <langid>
3973 Specify the language two letter code for the subtitles.
3974 This overrides what is read from the DVD or the .ifo file.
3975 .TP
3976 .B \-vobsuboutindex <index>
3977 Specify the index of the subtitles in the output files.
3978 (default: 0)
3979 .
3980 .
3981 .SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
3982 You can specify codec specific encoding parameters using the following
3983 syntax:
3984 .TP
3985 .B \-<codec>opts <option1[=value],option2,...>
3986 .RE
3987 .br
3988 .PP
3989 Where <codec> may be: lavc, xvidenc, divx4, lame
3990 .
3991 .
3992 .SS divx4 (\-divx4opts)
3993 DivX4 is obsolete and only supported for completeness.
3994 For details about DivX4 options, read the source, most options are not
3995 described here.
3996 .TP
3997 .B help\ \ \ 
3998 get help
3999 .TP
4000 .B br=<value>
4001 specify bitrate
4002 .RSs
4003 .IPs 4\-16000
4004 (in kbit)
4005 .IPs 16001\-24000000
4006 (in bit)
4007 .RE
4008 .TP
4009 .B key=<value>
4010 maximum keyframe interval (in frames)
4011 .TP
4012 .B deinterlace
4013 enable deinterlacing (avoid it, DivX4 is buggy)
4014 .TP
4015 .B q=<1\-5>
4016 quality (1\-fastest, 5\-best)
4017 .TP
4018 .B min_quant=<1\-31>
4019 minimum quantizer
4020 .TP
4021 .B max_quant=<1\-31>
4022 maximum quantizer
4023 .TP
4024 .B rc_period=<value>
4025 rate control period
4026 .TP
4027 .B rc_reaction_period=<value>
4028 rate control reaction period
4029 .TP
4030 .B rc_reaction_ratio=<value>
4031 rate control reaction ratio
4032 .TP
4033 .B crispness=<0\-100>
4034 specify crispness/\:smoothness
4035 .TP
4036 .B pass=<1\-2>
4037 With this you can encode 2pass DivX4 files.
4038 First encode with pass=1, then with the same parameters, encode with
4039 pass=2.
4040 .TP
4041 .B vbrpass=<0\-2>
4042 Override the pass argument and use XviD VBR Library instead of DivX4 VBR.
4043 Available options are:
4044 .
4045 .RSs
4046 .IPs 0
4047 one pass encoding (as in not putting pass on the command line)
4048 .IPs 1
4049 Analysis (first) pass of two pass encoding.
4050 The resulting AVI file can be directed to /dev/null.
4051 .IPs 2
4052 Final (second) pass of two pass encoding.
4053 .RE
4054 .
4055 .
4056 .SS lame (\-lameopts)
4057 .
4058 .TP
4059 .B help\ \ \ 
4060 get help
4061 .TP
4062 .B vbr=<0\-4>
4063 variable bitrate method
4064 .PD 0
4065 .RSs
4066 .IPs 0
4067 cbr
4068 .IPs 1
4069 mt
4070 .IPs 2
4071 rh (default)
4072 .IPs 3
4073 abr
4074 .IPs 4
4075 mtrh
4076 .RE
4077 .PD 1
4078 .TP
4079 .B abr\ \ \ \ 
4080 average bitrate
4081 .TP
4082 .B cbr\ \ \ \ 
4083 constant bitrate.
4084 .br
4085 Forces also CBR mode encoding on subsequent ABR presets modes
4086 .TP
4087 .B br=<0\-1024>
4088 specify bitrate in kBit (CBR and ABR only)
4089 .TP
4090 .B q=<0\-9>
4091 quality (0\-highest, 9\-lowest) (only for VBR)
4092 .TP
4093 .B aq=<0\-9>
4094 algorithmic quality (0\-best/\:slowest, 9\-worst/\:fastest)
4095 .TP
4096 .B ratio=<1\-100>
4097 compression ratio
4098 .TP
4099 .B vol=<0\-10>
4100 set audio input gain
4101 .TP
4102 .B mode=<0\-3>
4103 (default: auto)
4104 .PD 0
4105 .RSs
4106 .IPs 0
4107 stereo
4108 .IPs 1
4109 joint-stereo
4110 .IPs 2
4111 dualchannel
4112 .IPs 3
4113 mono
4114 .RE
4115 .PD 1
4116 .TP
4117 .B padding=<0\-2>
4118 .PD 0
4119 .RSs
4120 .IPs 0
4121 no
4122 .IPs 1
4123 all
4124 .IPs 2
4125 adjust
4126 .RE
4127 .PD 1
4128 .TP
4129 .B fast\ \ \ 
4130 switch on faster encoding on subsequent VBR presets modes, slightly lower 
4131 quality and higher bitrates.
4132 .TP
4133 .B highpassfreq=<freq>
4134 Set a highpass filtering frequency in Hz.
4135 Frequencies below the specified one will be cut off.
4136 A value of -1 will disable filtering, a value of 0
4137 will let lame choose values automatically.
4138 .TP
4139 .B lowpassfreq=<freq>
4140 Set a lowpass filtering frequency in Hz.
4141 Frequencies above the specified one will be cut off.
4142 A value of -1 will disable filtering, a value of 0
4143 will let lame choose values automatically.
4144 .TP
4145 .B preset=<value>
4146 preset values
4147 .RSs
4148 .IPs medium
4149 VBR encoding, good quality, 150\-180 kbps bitrate range.
4150 .IPs standard
4151 VBR encoding, high quality, 170\-210 kbps bitrate range.
4152 .IPs extreme
4153 VBR encoding, very high quality, 200\-240 kbps bitrate range.
4154 .IPs insane
4155 CBR encoding, highest preset quality, 320 kbps bitrate.
4156 .IPs <8\-320>
4157 ABR encoding at average given kbps bitrate.
4158 .RE
4159
4160 .RS
4161 .I EXAMPLE:
4162 .RE
4163 .PD 0
4164 .RSs
4165 .IPs fast:preset=standard
4166 for most people on most music and already quite high in quality.
4167 .IPs cbr:preset=192
4168 encode with ABR presets at a 192 kbps forced constant bitrate.
4169 .IPs preset=172
4170 encode with ABR presets at a 172 kbps average bitrate.
4171 .IPs preset=extreme
4172 for people with extremely good hearing and similar equipment.
4173 .IPs preset=help
4174 print additional options and informations on presets settings.
4175 .RE
4176 .PD 1
4177 .
4178 .
4179 .SS lavc (\-lavcopts)
4180 Many lavc options are very specialized and tersely documented.
4181 Read the source for full details.
4182 .PP
4183 .I EXAMPLE:
4184 .PD 0
4185 .RSs
4186 .IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
4187 .RE
4188 .PD 1
4189 .
4190 .TP
4191 .B acodec=<value>
4192 Audio codec (default: mp2):
4193 .PD 0
4194 .RSs
4195 .IPs mp2
4196 MPEG Layer 2
4197 .IPs mp3
4198 MPEG Layer 3
4199 .IPs ac3
4200 AC3
4201 .IPs adpcm_ima_wav
4202 IMA Adaptive PCM (4bits per sample, 4:1 compression)
4203 .RE
4204 .PD 1
4205 .TP
4206 .B abitrate=<value>
4207 Audio bitrate in kBit (default 224).
4208 .TP
4209 .B atag=<value>
4210 Use the specified Windows audio format tag (e.g.\& atag=0x55).
4211 .TP
4212 .B bit_exact
4213 Use only bit exact algorithms (except (i)dct).
4214 Additionally bit_exact disables several optimizations and thus
4215 should only be used for regression tests, which need binary
4216 identical files even if the encoder version changes.
4217 This also suppresses the user_data header in MPEG-4 streams.
4218 Do not use this option unless you know exactly what you are doing.
4219 .TP
4220 .B vcodec=<value>
4221 use the specified codec (default: mpeg4):
4222 .PD 0
4223 .RSs
4224 .IPs mjpeg
4225 Motion JPEG
4226 .IPs ljpeg
4227 Lossless JPEG
4228 .IPs h263\ 
4229 H263
4230 .IPs h263p
4231 H263 Plus
4232 .IPs mpeg4
4233 DivX 4/\:5
4234 .IPs msmpeg4
4235 DivX 3
4236 .IPs msmpeg4v2
4237 MS MPEG4v2
4238 .IPs wmv1
4239 Windows Media Video, version 1 (aka WMV7)
4240 .IPs wmv2
4241 Windows Media Video, version 2 (aka WMV8)
4242 .IPs rv10
4243 an old RealVideo codec
4244 .IPs mpeg1video
4245 MPEG1 video
4246 .IPs mpeg2video
4247 MPEG2 video
4248 .IPs huffyuv
4249 HuffYUV
4250 .IPs asv1
4251 ASUS Video v1
4252 .IPs asv2
4253 ASUS Video v2
4254 .IPs ffv1
4255 FFmpeg's lossless video codec
4256 .RE
4257 .PD 1
4258 .TP
4259 .B vqmin=<1\-31>
4260 minimum quantizer (pass\ 1/\:2)
4261 .RSs
4262 .IPs 1
4263 Not recommended (much larger file, little quality difference and weird side
4264 effects: msmpeg4, h263 will be very low quality, ratecontrol will be confused
4265 resulting in lower quality and some decoders will not be able to decode it).
4266 .IPs 2
4267 Recommended for normal mpeg4/mpeg1video encoding (default).
4268 .IPs 3
4269 Recommended for h263(p)/msmpeg4.  The reason for preferring 3 over 2 is that
4270 2 could lead to overflows (this will be fixed for h263(p) by changing the
4271 quantizer per MB in the future, msmpeg4 cannot be fixed as it does not support
4272 that).
4273 .RE
4274 .TP
4275 .B lmin=<0.01\-255.0>
4276 Minimum lagrange multiplier for ratecontrol, you probably want it to be
4277 equal to or lower than vqmin. (default: 2.0)
4278 .RE
4279 .TP
4280 .B lmax=<0.01\-255.0>
4281 Maximum lagrange multiplier for ratecontrol. (default: 31.0)
4282 .RE
4283 .TP
4284 .B vqscale=<1\-31>
4285 Constant quantizer /\: constant quality encoding (selects fixed quantizer mode).
4286 A lower value means better quality but larger files (default: 0 (disabled)).
4287 1 is not recommended (see \-vqmin for details).
4288 .TP
4289 .B vqmax=<1\-31>
4290 maximum quantizer (pass\ 1/\:2) 10\-31 should be a sane range (default: 31)
4291 .TP
4292 .B mbqmin=<1\-31>
4293 minimum macroblock quantizer (pass\ 1/\:2) (default: 2)
4294 .TP
4295 .B mbqmax=<1\-31>
4296 maximum macroblock quantizer (pass\ 1/\:2) (default: 31)
4297 .TP
4298 .B vqdiff=<1\-31>
4299 maximum quantizer difference between I or P frames (pass\ 1/\:2) (default: 3)
4300 .TP
4301 .B vmax_b_frames=<0\-4>
4302 maximum number of B frames between non B frames:
4303 .PD 0
4304 .RSs
4305 .IPs 0
4306 no B frames (default)
4307 .IPs 0\-2
4308 sane range for MPEG4
4309 .RE
4310 .PD 1
4311 .TP
4312 .B vme=<0\-5>
4313 motion estimation method.
4314 .I NOTE:
4315 0\-3 currently ignores the amount of Bits spent,
4316 so quality may be low.
4317 Available methods are:
4318 .PD 0
4319 .RSs
4320 .IPs 0
4321 none (very low quality)
4322 .IPs 1
4323 full (slow)
4324 .IPs 2
4325 log (low quality)
4326 .IPs 3
4327 phods (low quality)
4328 .IPs 4
4329 EPZS (default)
4330 .IPs 5
4331 X1 (experimental)
4332 .RE
4333 .PD 1
4334 .TP
4335 .B me_range=<0\-9999>
4336 motion estimation search range, 0 (default) means unlimited
4337 .TP
4338 .B mbd=<0\-2>
4339 Macroblock decision algorithm (high quality mode), encode each macro
4340 block in all modes and choose the best.
4341 This is slow but results in better quality and file size.
4342 .PD 0
4343 .RSs
4344 .IPs 0
4345 use mbcmp (default)
4346 .IPs 1
4347 select the MB mode which needs the fewest bits (=vhq)
4348 .IPs 2
4349 select the MB mode which has the best rate distortion
4350 .RE
4351 .PD 1
4352 .TP
4353 .B vhq
4354 Same as mbd=1, kept for compatibility reasons.
4355 .TP
4356 .B v4mv\ \ \ 
4357 Allow 4 motion vectors per macroblock (slightly better quality).
4358 (default: disabled)
4359 .TP
4360 .B obmc\ \ \ 
4361 overlapped block motion compensation (H263+)
4362 .TP
4363 .B loop\ \ \ 
4364 loop filter (H263+)
4365 note, this is broken
4366 .TP
4367 .B inter_threshold <-1000\-1000>
4368 Does absolutely nothing at the moment.
4369 .TP
4370 .B keyint=<0\-300>
4371 maximum interval between keyframes in frames.
4372 Keyframes are needed for seeking as seeking is only possible to a keyframe but
4373 keyframes need more space than other frames so larger numbers here mean
4374 slightly smaller files, but less precise seeking, 0 means no key frames.
4375 Values >300 are not recommended as the quality might be bad depending upon
4376 decoder, encoder and luck.
4377 For a strict MPEG1/\:2/\:4 compliance this would have to be <=132.
4378 (default: 250 or one key frame every ten seconds in a 25fps movie)
4379 .TP
4380 .B sc_threshold=<-1000000\-1000000>
4381 Threshold for scene change detection.
4382 Libavcodec inserts a keyframe when it detects a scene change. 
4383 You can specify the sensitivity of the detection with this option.
4384 -1000000 means there is a scene change detected at every frame, 1000000 means
4385 no scene changes are detected (default 0).
4386 .TP
4387 .B vb_strategy=<0\-1>
4388 strategy to choose between I/\:P/\:B frames (pass\ 2):
4389 .RSs
4390 .IPs 0
4391 always use the maximum number of B frames (default)
4392 .IPs 1
4393 avoid B frames in high motion scenes (will cause bitrate misprediction)
4394 .RE
4395 .TP
4396 .B vpass=<1\-2>
4397 Activates internal two pass mode, only specify if you wish to use two pass
4398 encoding (default: disabled).
4399 .PD 0
4400 .RSs
4401 .IPs 1
4402 first pass
4403 .IPs 2
4404 second pass
4405 .RE
4406 .PD 1
4407
4408 .RS
4409 huffyuv:
4410 .RE
4411 .PD 0
4412 .RSs
4413 .IPs pass 1
4414 saves statistics
4415 .IPs pass 2
4416 encodes with an optimal Huffman table based upon pass 1 statistics.
4417 .RE
4418 .PD 1
4419 .TP
4420 .B aspect=<x/y>
4421 Store movie aspect internally, just like MPEG files.
4422 Much nicer solution than rescaling, because quality isn't decreased.
4423 Only MPlayer will play these files correctly, other players will display
4424 them with wrong aspect.
4425 The aspect parameter can be given as a ratio or a floating point number.
4426
4427 .RS
4428 .I EXAMPLE:
4429 .RE
4430 .RSs
4431 .PD 0
4432 .IPs "aspect=16/9 or aspect=1.78"
4433 .PD 1
4434 .RE
4435 .TP
4436 .B autoaspect
4437 Same as the aspect option, but automatically computes aspect, taking
4438 into account all the adjustments (crop/expand/scale/etc.) made in the
4439 filter chain.
4440 .TP
4441 .B vbitrate=<value>
4442 specify bitrate (pass\ 1/\:2).  Warning: 1kBit = 1000 Bits.
4443 .RSs
4444 .IPs 4\-16000
4445 (in kbit)
4446 .IPs 16001\-24000000
4447 (in bit)
4448 .IPs 800
4449 default
4450 .RE
4451 .TP
4452 .B vratetol=<value>
4453 approximated filesize tolerance in kBit. 1000\-100000 is a sane range.
4454 (warning: 1kBit = 1000 Bits)
4455 (default: 8000)
4456 .TP
4457 .B vrc_maxrate=<value>
4458 maximum bitrate in kbit/\:sec (pass\ 1/\:2)
4459 .TP
4460 .B vrc_minrate=<value>
4461 minimum bitrate in kbit/\:sec (pass\ 1/\:2)
4462 .TP
4463 .B vrc_buf_size=<value>
4464 buffer size in kbit (pass\ 1/\:2).
4465 For MPEG1/2 this also sets the vbv buffer size, use 327 for VCD,
4466 917 for SVCD and 1835 for DVD.
4467 .I NOTE:
4468 vratetol should not be too large during the second pass or there might
4469 be problems if vrc_(min|max)rate is used.
4470 .TP
4471 .B vrc_buf_aggressivity
4472 currently useless
4473 .TP
4474 .B vrc_strategy
4475 Dummy, reserved for future use.
4476 .TP
4477 .B vb_qfactor=<-31.0\-31.0>
4478 quantizer factor between B and non B frames (pass\ 1/\:2) (default: 1.25)
4479 .TP
4480 .B vi_qfactor=<-31.0\-31.0>
4481 (pass\ 1/\:2) (default: 0.8)
4482 .TP
4483 .B vb_qoffset=<-31.0\-31.0>
4484 quantizer offset between B and non B frames (pass\ 1/\:2) (default: 1.25)
4485 .TP
4486 .B vi_qoffset=<-31.0\-31.0>
4487 (pass\ 1/\:2) (default: 0.0)
4488 .br
4489 if v{b|i}_qfactor > 0
4490 .br
4491 I/\:B-Frame quantizer = P-Frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset
4492 .br
4493 else
4494 .br
4495 do normal ratecontrol (dont lock to next P frame quantizer) and
4496 set q= -q * v{b|i}_qfactor + v{b|i}_qoffset
4497 .TP
4498 .B \ 
4499 Tip: To do constant quantizer encoding with different quantizers for
4500 I/P and B frames you can use:
4501 lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/ip_quant>
4502 .TP
4503 .B vqblur=<0.0\-1.0> (pass 1)
4504 Quantizer blur, larger values will average the quantizer more over
4505 time (slower change).
4506 .RSs
4507 .IPs 0.0
4508 qblur disabled
4509 .IPs 0.5
4510 (default)
4511 .IPs 1.0
4512 average the quantizer over all previous frames
4513 .RE
4514 .TP
4515 .B vqblur=<0.0\-99.0> (pass 2)
4516 Quantizer gaussian blur, larger values will average the quantizer more
4517 over time (slower change) (default: 0.5).
4518 .TP
4519 .B vqcomp=<value>
4520 quantizer compression, depends upon vrc_eq (pass\ 1/\:2) (default: 0.5)
4521 .TP
4522 .B vrc_eq=<equation>
4523 main ratecontrol equation (pass\ 1/\:2):
4524 .RE
4525 .RSs
4526 .IPs 1\ \ \ \ 
4527 constant bitrate
4528 .IPs tex\ \ 
4529 constant quality
4530 .IPs 1+(tex/\:avgTex-1)*qComp
4531 approximately the equation of the old ratecontrol code
4532 .IPs tex^qComp
4533 with qcomp 0.5 or something like that (default)
4534 .RE
4535 .PP
4536 .RS
4537 infix operators: +,-,*,/,^
4538 .RE
4539 .PP
4540 .RS
4541 variables:
4542 .RE
4543 .RSs
4544 .IPs tex\ \ 
4545 texture complexity
4546 .IPs iTex,pTex
4547 intra, non intra texture complexity
4548 .IPs avgTex
4549 average texture complexity
4550 .IPs avgIITex
4551 average intra texture complexity in I frames
4552 .IPs avgPITex
4553 average intra texture complexity in P frames
4554 .IPs avgPPTex
4555 average non intra texture complexity in P frames
4556 .IPs avgBPTex
4557 average non intra texture complexity in B frames
4558 .IPs mv\ \ \ 
4559 Bits used for motion vectors
4560 .IPs fCode
4561 maximum length of motion vector in log2 scale
4562 .IPs iCount
4563 number of intra macro blocks / number of macro blocks
4564 .IPs var\ \ 
4565 spatial complexity
4566 .IPs mcVar
4567 temporal complexity
4568 .IPs qComp
4569 qcomp from the command line
4570 .IPs "isI, isP, isB"
4571 is 1 if picture type is I/\:P/\:B else 0
4572 .IPs Pi,E\ 
4573 see your favorite math book
4574 .RE
4575 .PP
4576 .RS
4577 functions:
4578 .RE
4579 .RSs
4580 .IPs max(a,b),min(a,b)
4581 maximum / minimum
4582 .IPs gt(a,b)
4583 is 1 if a>b, 0 otherwise
4584 .IPs lt(a,b)
4585 is 1 if a<b, 0 otherwise
4586 .IPs eq(a,b)
4587 is 1 if a==b, 0 otherwise
4588 .IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
4589 .RE
4590 .
4591 .TP
4592 .B vrc_override=<options>
4593 User specified quality for specific parts (ending, credits, ..) (pass\ 1/\:2).
4594 The options are <start-frame>, <end-frame>, <quality>[/\:<start-frame>,
4595 <end-frame>, <quality>[/...]]:
4596 .RSs
4597 .IPs "quality (2\-31)"
4598 quantizer
4599 .IPs "quality (-500\-0)"
4600 quality correction in %
4601 .RE
4602 .TP
4603 .B vrc_init_cplx=<0\-1000>
4604 initial complexity (pass\ 1)
4605 .TP
4606 .B vqsquish=<0,1>
4607 specify how to keep the quantizer between qmin and qmax (pass\ 1/\:2):
4608 .PD 0
4609 .RSs
4610 .IPs 0
4611 use clipping
4612 .IPs 1
4613 use a nice differentiable function (default)
4614 .RE
4615 .PD 1
4616 .TP
4617 .B vlelim=<-1000\-1000>
4618 single coefficient elimination threshold for luminance.
4619 Negative values will also consider the dc coefficient (should be at least -4
4620 or lower for encoding at quant=1):
4621 .PD 0
4622 .RSs
4623 .IPs 0
4624 disabled (default)
4625 .IPs -4
4626 (JVT recommendation)
4627 .RE
4628 .PD 1
4629 .TP
4630 .B vcelim=<-1000\-1000>
4631 single coefficient elimination threshold for chrominance.
4632 Negative values will also consider the dc coefficient (should be at least -4
4633 or lower for encoding at quant=1):
4634 .PD 0
4635 .RSs
4636 .IPs 0
4637 disabled (default)
4638 .IPs 7
4639 (JVT recommendation)
4640 .RE
4641 .TP
4642 .B vstrict=<-1,0,1>
4643 strict standard compliance
4644 .RSs
4645 .IPs 0
4646 disabled (default)
4647 .IPs 1
4648 only recommended if you want to feed the output into the mpeg4 reference
4649 decoder
4650 .IPs -1
4651 allows non-standard YV12 huffyuv encoding (20% smaller files, but cannot be
4652 played by the official huffyuv codec)
4653 .RE
4654 .PD 1
4655 .TP
4656 .B vdpart\ 
4657 data partitioning.
4658 Adds 2 Bytes per video packet, improves error-resistance when transferring over
4659 unreliable channels (eg.\& streaming over the internet)
4660 Each video packet will be encoded in 3 separate partitions:
4661 .PD 0
4662 .RSs
4663 .IPs "1. MVs"
4664 (movement)
4665 .IPs "2. DC coefficients"
4666 (low res picture)
4667 .IPs "3. AC coefficients"
4668 (details)
4669 .RE
4670 .PD 1
4671 .TP
4672 .B \ 
4673 MV & DC are most important, loosing them looks far worse than loosing
4674 the AC and the 1. & 2. partition.
4675 (MV&DC) are far smaller than the 3. partition (AC) meaning that errors
4676 will hit the AC partition much more often than the MV&DC partitions.
4677 Thus, the picture will look better with partitioning than without,
4678 as without partitioning an error will trash AC/DC/MV equally.
4679 .TP
4680 .B vpsize=<0\-10000>
4681 video packet size, improves error-resistance (see \-vdpart option too):
4682 .RSs
4683 .IPs 0
4684 disabled (default)
4685 .IPs 100-1000
4686 good choice
4687 .RE
4688 .TP
4689 .B ss\ \ \ \ \ 
4690 slice structured mode for H263+
4691 .TP
4692 .B gray\ \ \ 
4693 grayscale only encoding (faster) (default: disabled)
4694 .TP
4695 .B vfdct=<0\-10>
4696 dct algorithm:
4697 .PD 0
4698 .RSs
4699 .IPs 0
4700 automatically select a good one (default)
4701 .IPs 1
4702 fast integer
4703 .IPs 2
4704 accurate integer
4705 .IPs 3
4706 mmx
4707 .IPs 4
4708 mlib
4709 .IPs 5
4710 altivec
4711 .IPs 6
4712 floating point AAN
4713 .RE
4714 .PD 1
4715 .TP
4716 .B idct=<0\-99>
4717 idct algorithm.
4718 .I NOTE:
4719 To the best of our knowledge all these IDCTs do pass the IEEE1180 tests.
4720 .PD 0
4721 .RSs
4722 .IPs 0
4723 automatically select a good one (default)
4724 .IPs 1
4725 jpeg reference integer
4726 .IPs 2
4727 simple
4728 .IPs 3
4729 simplemmx
4730 .IPs 4
4731 libmpeg2mmx (inaccurate, DON'T USE for encoding with keyint >100)
4732 .IPs 5
4733 ps2
4734 .IPs 6
4735 mlib
4736 .IPs 7
4737 arm
4738 .IPs 8
4739 altivec
4740 .IPs 9
4741 sh4
4742 .RE
4743 .PD 1
4744 .TP
4745 .B lumi_mask=<0.0\-1.0>
4746 luminance masking.
4747 Warning: Be careful, too large values can cause disastrous things.
4748 Warning2: Large values might look good on some monitors but may look horrible
4749 on other monitors:
4750 .RSs
4751 .IPs 0.0
4752 disabled (default)
4753 .IPs 0.0\-0.3
4754 sane range
4755 .RE
4756 .TP
4757 .B dark_mask=<0.0\-1.0>
4758 darkness masking.
4759 Warning: be careful, too large values can cause disasterous things.
4760 Warning2: large values might look good on some monitors but may look horrible
4761 on other monitors / TV / TFT:
4762 .RSs
4763 .IPs 0.0
4764 disabled (default)
4765 .IPs 0.0\-0.3
4766 sane range
4767 .RE
4768 .TP
4769 .B tcplx_mask=<0.0\-1.0>
4770 temporal complexity masking (default: 0.0 (disabled))
4771 .TP
4772 .B scplx_mask=<0.0\-1.0>
4773 spatial complexity masking.
4774 Larger values help against blockiness, if no deblocking filter is used for
4775 decoding.
4776 Tip: Crop any black borders completely as they will reduce the quality
4777 of the macro blocks (also applies without scplx_mask).
4778 .RSs
4779 .IPs 0.0
4780 disabled (default)
4781 .IPs 0.0\-0.5
4782 sane range
4783 .RE
4784 .TP
4785 .B p_mask=<0.0\-1.0>
4786 inter MB masking (default: 0.0 (disabled))
4787 .TP
4788 .B naq\ \ \ \ 
4789 Normalize adaptive quantization (experimental).
4790 When using adaptive quantization (*_mask), the average per-MB quantizer may no
4791 longer match the requested frame-level quantizer.
4792 Naq will attempt to adjust the per-MB quantizers to maintain the proper
4793 average.
4794 .TP
4795 .B ildct\ \ 
4796 use interlaced dct
4797 .TP
4798 .B ilme\ \ \ 
4799 use interlaced motion estimation
4800 .TP
4801 .B alt\ \ \ \ 
4802 use alternative scantable
4803 .TP
4804 .B top=<-1\-1>\ \ \ 
4805 .RSs
4806 .IPs -1
4807 automatic
4808 .IPs 0
4809 bottom field first
4810 .IPs 1
4811 top field first
4812 .RE
4813 .TP
4814 .B format=<value>
4815 .RSs
4816 .IPs YV12
4817 default
4818 .IPs 444P
4819 for ffv1
4820 .IPs 422P
4821 for huffyuv, lossless jpeg and ffv1
4822 .IPs 411P,YVU9
4823 for lossless jpeg and ffv1
4824 .IPs BGR32
4825 for lossless jpeg and ffv1
4826 .RE
4827 .TP
4828 .B pred
4829 (for huffyuv)
4830 .PD 0
4831 .RSs
4832 .IPs 0
4833 left prediction
4834 .IPs 1
4835 plane/gradient prediction
4836 .IPs 2
4837 median prediction
4838 .RE
4839 .PD 1
4840 .TP
4841 .B pred
4842 (for lossless jpeg)
4843 .PD 0
4844 .RSs
4845 .IPs 0
4846 left prediction
4847 .IPs 1
4848 top prediction
4849 .IPs 2
4850 topleft prediction
4851 .IPs 3
4852 plane/gradient prediction
4853 .IPs 6
4854 mean prediction
4855 .RE
4856 .PD 1
4857 .TP
4858 .B coder
4859 (for ffv1)
4860 .PD 0
4861 .RSs
4862 .IPs 0
4863 vlc coding (golomb rice)
4864 .IPs 1
4865 arithmetic coding (cabac)
4866 .RE
4867 .PD 1
4868 .TP
4869 .B context
4870 (for ffv1)
4871 .PD 0
4872 .RSs
4873 .IPs 0
4874 small context model
4875 .IPs 1
4876 large context model
4877 .RE
4878 .PD 1
4879 .TP
4880 .B qpel\ \ \ 
4881 use quarter pel motion compensation
4882 Tip: This seems only useful for high bitrate encodings.
4883 .TP
4884 .B ildctcmp=<0\-2000>
4885 comparison function for interlaced dct decision
4886 .TP
4887 .B precmp=<0\-2000>
4888 comparison function for motion estimation pre pass
4889 .TP
4890 .B cmp=<0\-2000>
4891 comparison function for full pel motion estimation
4892 .TP
4893 .B subcmp=<0\-2000>
4894 comparison function for sub pel motion estimation
4895 .TP
4896 .B mbcmp=<0\-2000>
4897 comparison function for the macroblock decision, only used if mbd=0
4898 .PD 0
4899 .RSs
4900 .IPs "0 (SAD)"
4901 sum of absolute differences, fast (default)
4902 .IPs "1 (SSE)"
4903 sum of squared errors
4904 .IPs "2 (SATD)"
4905 sum of absolute hadamard transformed differences
4906 .IPs "3 (DCT)"
4907 sum of absolute dct transformed differences
4908 .IPs "4 (PSNR)"
4909 sum of the squared quantization errors (don't use, low quality)
4910 .IPs "5 (BIT)"
4911 number of bits needed for the block
4912 .IPs "6 (RD)"
4913 rate distortion optimal, slow
4914 .IPs "7 (ZERO)"
4915 0
4916 .IPs "8 (VSAD)"
4917 sum of absolute vertical differences 
4918 .IPs "9 (VSSE)"
4919 sum of squared vertical differences
4920 .IPs +256\ 
4921 use chroma too, doesn't work (correctly) with B frames currently
4922 .RE
4923 .PD 1
4924 .TP
4925 .B predia=<-99\-6>
4926 Diamond type and size for motion estimation pre pass
4927 .TP
4928 .B dia=<-99\-6>
4929 Diamond type & size for motion estimation.
4930 .I NOTE:
4931 The sizes of the normal diamonds and shape adaptive ones don't have
4932 the same meaning.
4933 .RSs
4934 .IPs -3
4935 shape adaptive (fast) diamond with size 3
4936 .IPs -2
4937 shape adaptive (fast) diamond with size 2
4938 .IPs -1
4939 experimental
4940 .IPs  1
4941 normal size=1 diamond (default) =EPZS type diamond
4942 .nf
4943 .ne
4944       0 
4945      000
4946       0 
4947 .fi
4948 .br
4949 .IPs 2
4950 normal size=2 diamond
4951 .nf
4952 .ne
4953       0  
4954      000 
4955     00000
4956      000 
4957       0  
4958 .fi
4959 .RE
4960 .TP
4961 .B trell\ \ 
4962 Trellis searched quantization.
4963 This will find the optimal encoding for each 8x8 block.
4964 Trellis searched quantization is quite simple a optimal quantization in the PSNR
4965 vs bitrate sense (assuming that there would be no rounding errors introduced 
4966 by the IDCT, which is obviously not the case) it simply finds a block for
4967 the minimum of error and lambda*bits.
4968 .PD 0
4969 .RSs
4970 .IPs lambda
4971 qp dependant constant
4972 .IPs bits\ 
4973 amount of bits needed to encode the block
4974 .IPs error
4975 sum of squared errors of the quantization
4976 .RE
4977 .PD 1
4978 .TP
4979 .B cbp\ \ \ \ 
4980 Rate distorted optimal coded block pattern
4981 will select the coded block pattern which minimizes distortion + lambda*rate
4982 this can only be used together with trellis quantization
4983 .TP
4984 .B mv0\ \ \ \ 
4985 try to encode each MB with MV=<0,0> and choose the better one
4986 this has no effect if mbd=0
4987 .TP
4988 .B qprd\ \ \ 
4989 rate distorted optimal QP for the given lambda of each macroblock
4990 .TP
4991 .B last_pred=<0\-99>
4992 Amount of motion predictors from the previous frame
4993 .PD 0
4994 .RSs
4995 .IPs 0
4996 (default)
4997 .IPs a
4998 will use 2a+1 x 2a+1 macro block square of motion vector predictors from the
4999 previous frame
5000 .RE
5001 .PD 1
5002 .TP
5003 .B preme=<0\-2> 
5004 motion estimation pre-pass
5005 .PD 0
5006 .RSs
5007 .IPs 0
5008 disabled
5009 .IPs 1
5010 only after I frames (default)
5011 .IPs 2
5012 always
5013 .RE
5014 .PD 1
5015 .TP
5016 .B subq=<1\-8>
5017 subpel refinement quality (for qpel) (default: 8).
5018 .I NOTE:
5019 This has a significant effect on speed.
5020 .TP
5021 .B psnr\ \ \ 
5022 print the psnr (peak signal to noise ratio) for the whole video after encoding
5023 and store the per frame psnr in a file with a name like 'psnr_hhmmss.log'.
5024 Returned values are in dB (decibel), the higher the better.
5025 .TP
5026 .B mpeg_quant
5027 use MPEG quantizers instead of H.263.
5028 (default: disabled) (i.e.\& use H.263 quantizers)
5029 .TP
5030 .B aic\ \ \ \ 
5031 ac prediction (=advanced intra prediction for H.263+)
5032 .I NOTE:
5033 vqmin should be 8 or larger for AIC H263+.
5034 .TP
5035 .B aiv\ \ \ \ 
5036 alternatice inter vlc for H.263+
5037 .TP
5038 .B umv\ \ \ \ 
5039 unlimited MVs (H.263+ only)
5040 Allow encoding of abritarily long MVs.
5041 .TP
5042 .B ibias=<-256\-256>
5043 intra quantizer bias (256 == 1.0)
5044 .br
5045 mpeg style quantizer default: 96
5046 .br
5047 h263 style quantizer default: 0
5048 .br
5049 .I NOTE:
5050 The h263 MMX quantiz