remove xvid3's quant_range, move xvid4 [min|max]_[i|p|b]quant options there instead
[mplayer.git] / DOCS / man / en / mplayer.1
1 .\" $Revision$
2 .\" MPlayer (C) 2000-2006 MPlayer Team
3 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
4 .
5 .\" --------------------------------------------------------------------------
6 .\" Macro definitions
7 .\" --------------------------------------------------------------------------
8 .
9 .\" define indentation for suboptions
10 .nr SS 5
11 .\" add new suboption
12 .de IPs
13 .IP "\\$1" \n(SS
14 ..
15 .\" begin of first level suboptions, end with .RE
16 .de RSs
17 .RS 10
18 ..
19 .\" begin of 2nd level suboptions
20 .de RSss
21 .PD 0
22 .RS \n(SS+3
23 ..
24 .\" end of 2nd level suboptions
25 .de REss
26 .RE
27 .PD 1
28 ..
29 .
30 .\" --------------------------------------------------------------------------
31 .\" Title
32 .\" --------------------------------------------------------------------------
33 .
34 .TH MPlayer 1 "2006-10-15" "The MPlayer Project" "The Movie Player"
35 .
36 .SH NAME
37 mplayer  \- movie player
38 .br
39 mencoder \- movie encoder
40 .
41 .\" --------------------------------------------------------------------------
42 .\" Synopsis
43 .\" --------------------------------------------------------------------------
44 .
45 .SH SYNOPSIS
46 .na
47 .nh
48 .B mplayer
49 [options] [file|URL|playlist|\-]
50 .
51 .br
52 .B mplayer
53 [options] file1
54 [specific options] [file2] [specific options]
55 .
56 .br
57 .B mplayer
58 [options]
59 {group of files and options}
60 [group-specific options]
61 .
62 .br
63 .B mplayer
64 [dvd|dvdnav]://[title|[start_title]\-end_title]
65 [options]
66 .
67 .br
68 .B mplayer
69 vcd://track[/device]
70 .
71 .br
72 .B mplayer
73 tv://[channel]
74 [options]
75 .
76 .br
77 .B mplayer
78 radio://[channel|frequency][/capture]
79 [options]
80 .
81 .br
82 .B mplayer
83 pvr://
84 [options]
85 .
86 .br
87 .B mplayer
88 dvb://[card_number@]channel
89 [options]
90 .
91 .br
92 .B mplayer
93 mf://filemask
94 [\-mf options] [options]
95 .
96 .br
97 .B mplayer
98 [cdda|cddb]://track[-endtrack][:speed][/device]
99 [options]
100 .
101 .br
102 .B mplayer
103 cue://file[:track]
104 [options]
105 .
106 .br
107 .B mplayer
108 [file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv]://
109 [user:pass@]URL[:port] [options]
110 .
111 .br
112 .B mplayer
113 sdp://file
114 [options]
115 .
116 .br
117 .B mplayer
118 mpst://host[:port]/URL
119 [options]
120 .
121 .br
122 .B mplayer
123 tivo://host/[list|llist|fsid]
124 [options]
125 .
126 .br
127 .B gmplayer
128 [options]
129 [\-skin\ skin]
130 .
131 .br
132 .B mencoder
133 [options] file
134 [file|URL|\-] [\-o file]
135 .
136 .br
137 .B mencoder
138 [options] file1
139 [specific options] [file2] [specific options]
140 .ad
141 .hy
142 .
143 .\" --------------------------------------------------------------------------
144 .\" Description
145 .\" --------------------------------------------------------------------------
146 .
147 .SH DESCRIPTION
148 .B mplayer
149 is a movie player for Linux (runs on many other platforms and CPU
150 architectures, see the documentation).
151 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
152 MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
153 native and binary codecs.
154 You can watch Video CD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV movies,
155 too.
156 .PP
157 MPlayer supports a wide range of video and audio output drivers.
158 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
159 Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers),
160 VESA (on every VESA-compatible card, even without X11), some low-level
161 card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder
162 boards, such as the Siemens DVB, Hauppauge PVR (IVTV), DXR2 and DXR3/\:Hollywood+.
163 Most of them support software or hardware scaling, so you can enjoy movies in
164 fullscreen mode.
165 .PP
166 MPlayer has an onscreen display (OSD) for status information, nice big
167 antialiased shaded subtitles and visual feedback for keyboard controls.
168 European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
169 fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
170 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
171 DVD subtitles (SPU streams, VOBsub and Closed Captions).
172 .PP
173 .B mencoder
174 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
175 MPlayer-playable movies (see above) to other MPlayer-playable formats (see
176 below).
177 It encodes to MPEG-4 (DivX/Xvid), one of the libavcodec codecs and
178 PCM/\:MP3/\:VBRMP3 audio in 1, 2 or 3 passes.
179 Furthermore it has stream copying abilities, a powerful filter system (crop,
180 expand, flip, postprocess, rotate, scale, noise, RGB/\:YUV conversion) and
181 more.
182 .PP
183 .B gmplayer
184 is MPlayer with a graphical user interface.
185 It has the same options as MPlayer.
186 .PP
187 Usage examples to get you started quickly can be found at the end
188 of this man page.
189 .PP
190 .B Also see the HTML documentation!
191 .
192 .
193 .\" --------------------------------------------------------------------------
194 .\" interactive control
195 .\" --------------------------------------------------------------------------
196 .
197 .SH "INTERACTIVE CONTROL"
198 MPlayer has a fully configurable, command-driven control layer
199 which allows you to control MPlayer using keyboard, mouse, joystick
200 or remote control (with LIRC).
201 See the \-input option for ways to customize it.
202 .
203 .TP
204 .B keyboard control
205 .PD 0
206 .RS
207 .IPs "<\- and \->"
208 Seek backward/\:forward 10 seconds.
209 .IPs "up and down"
210 Seek forward/\:backward 1 minute.
211 .IPs "pgup and pgdown"
212 Seek forward/\:backward 10 minutes.
213 .IPs "[ and ]"
214 Decrease/increase current playback speed by 10%.
215 .IPs "{ and }"
216 Halve/double current playback speed.
217 .IPs "backspace"
218 Reset playback speed to normal.
219 .IPs "< and >"
220 Go backward/\:forward in the playlist.
221 .IPs "ENTER"
222 Go forward in the playlist, even over the end.
223 .IPs "HOME and END"
224 next/\:previous playtree entry in the parent list
225 .IPs "INS and DEL (ASX playlist only)"
226 next/\:previous alternative source.
227 .IPs "p / SPACE"
228 Pause (pressing again unpauses).
229 .IPs ".\ \ \ \ "
230 Step forward.
231 Pressing once will pause movie, every consecutive press will play one frame
232 and then go into pause mode again (any other key unpauses).
233 .IPs "q / ESC"
234 Stop playing and quit.
235 .IPs "+ and -"
236 Adjust audio delay by +/- 0.1 seconds.
237 .IPs "/ and *"
238 Decrease/\:increase volume.
239 .IPs "9 and 0"
240 Decrease/\:increase volume.
241 .IPs "m\ \ \ \ "
242 Mute sound.
243 .IPs "_ (MPEG-TS only)"
244 Cycle through the available video tracks.
245 .IPs "# (MPEG and Matroska only)"
246 Cycle through the available audio tracks.
247 .IPs "f\ \ \ \ "
248 Toggle fullscreen (also see \-fs).
249 .IPs "T\ \ \ \ "
250 Toggle stay-on-top (also see \-ontop).
251 .IPs "w and e"
252 Decrease/\:increase pan-and-scan range.
253 .IPs "o\ \ \ \ "
254 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
255 .IPs "d\ \ \ \ "
256 Toggle frame dropping states: none / skip display / skip decoding
257 (see \-framedrop and \-hardframedrop).
258 .IPs "v\ \ \ \ "
259 Toggle subtitle visibility.
260 .IPs "j\ \ \ \ "
261 Cycle through the available subtitles.
262 .IPs "y and g"
263 Step forward/backward in the subtitle list.
264 .IPs "F\ \ \ \ "
265 Toggle displaying "forced subtitles".
266 .IPs "a\ \ \ \ "
267 Toggle subtitle alignment: top / middle / bottom.
268 .IPs "x and z"
269 Adjust subtitle delay by +/- 0.1 seconds.
270 .IPs "r and t"
271 Move subtitles up/down.
272 .IPs "i (\-edlout mode only)"
273 Set start or end of an EDL skip and write it out to the given file.
274 .IPs "s (\-vf screenshot only)"
275 Take a screenshot.
276 .IPs "S (\-vf screenshot only)"
277 Start/stop taking screenshots.
278 .IPs "I\ \ \ \ "
279 Show filename on the OSD.
280 .IPs "! and @"
281 Seek to the beginning of the previous/next chapter.
282 .RE
283 .PD 1
284 .PP
285 .RS
286 (The following keys are valid only when using a hardware accelerated video
287 output (xv, (x)vidix, (x)mga, etc), the software equalizer
288 (\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
289 .RE
290 .PP
291 .PD 0
292 .RS
293 .IPs "1 and 2"
294 Adjust contrast.
295 .IPs "3 and 4"
296 Adjust brightness.
297 .IPs "5 and 6"
298 Adjust hue.
299 .IPs "7 and 8"
300 Adjust saturation.
301 .RE
302 .PD 1
303 .PP
304 .RS
305 (The following keys are valid only when using the quartz or macosx
306 video output driver.)
307 .RE
308 .PP
309 .PD 0
310 .RS
311 .IPs "command + 0"
312 Resize movie window to half its original size.
313 .IPs "command + 1"
314 Resize movie window to its original size.
315 .IPs "command + 2"
316 Resize movie window to double its original size.
317 .IPs "command + f"
318 Toggle fullscreen (also see \-fs).
319 .IPs "command + [ and command + ]"
320 Set movie window alpha.
321 .RE
322 .PD 1
323 .PP
324 .RS
325 (The following keys are valid only when using the sdl
326 video output driver.)
327 .RE
328 .PP
329 .PD 0
330 .RS
331 .IPs "c\ \ \ \ "
332 Cycle through available fullscreen modes.
333 .IPs "n\ \ \ \ "
334 Restore original mode.
335 .RE
336 .PD 1
337 .PP
338 .RS
339 (The following keys are valid if you have a keyboard
340 with multimedia keys.)
341 .RE
342 .PP
343 .PD 0
344 .RS
345 .IPs PAUSE
346 Pause.
347 .IPs "STOP\ "
348 Stop playing and quit.
349 .IPs "PREVIOUS and NEXT"
350 Seek backward/\:forward 1 minute.
351 .RE
352 .PD 1
353 .PP
354 .RS
355 (The following keys are only valid if GUI support is compiled in
356 and will take precedence over the keys defined above.)
357 .RE
358 .PP
359 .PD 0
360 .RS
361 .IPs ENTER
362 Start playing.
363 .IPs "ESC\ \ "
364 Stop playing.
365 .IPs "l\ \ \ \ "
366 Load file.
367 .IPs "t\ \ \ \ "
368 Load subtitle.
369 .IPs "c\ \ \ \ "
370 Open skin browser.
371 .IPs "p\ \ \ \ "
372 Open playlist.
373 .IPs "r\ \ \ \ "
374 Open preferences.
375 .RE
376 .PD 1
377 .PP
378 .RS
379 (The following keys are only valid if you compiled with TV or DVB input
380 support and will take precedence over the keys defined above.)
381 .RE
382 .PP
383 .PD 0
384 .RS
385 .IPs "h and k"
386 Select previous/\:next channel.
387 .IPs "n\ \ \ \ "
388 Change norm.
389 .IPs "u\ \ \ \ "
390 Change channel list.
391 .RE
392 .PD 1
393 .PP
394 .RS
395 (The following keys are only valid if you compiled with dvdnav
396 support: they are used to navigate the menus)
397 .RE
398 .PP
399 .PD 0
400 .RS
401 .IPs "keypad 8"
402 Select button up.
403 .IPs "keypad 2"
404 Select button down.
405 .IPs "keypad 4"
406 Select button left.
407 .IPs "keypad 6"
408 Select button right.
409 .IPs "keypad 5"
410 Return to main menu.
411 .IPs "keypad 7"
412 Return to nearest menu (the order of preference is: chapter->title->root).
413 .IPs "keypad ENTER"
414 Confirm choice.
415 .RE
416 .PD 1
417 .PP
418 .RS
419 .
420 .TP
421 .B mouse control
422 .PD 0
423 .RS
424 .IPs "button 3 and button 4"
425 Seek backward/\:forward 1 minute.
426 .IPs "button 5 and button 6"
427 Decrease/\:increase volume.
428 .RE
429 .PD 1
430 .
431 .TP
432 .B joystick control
433 .PD 0
434 .RS
435 .IPs "left and right"
436 Seek backward/\:forward 10 seconds.
437 .IPs "up and down"
438 Seek forward/\:backward 1 minute.
439 .IPs "button 1"
440 Pause.
441 .IPs "button 2"
442 Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
443 .IPs "button 3 and button 4"
444 Decrease/\:increase volume.
445 .RE
446 .PD 1
447 .
448 .
449 .\" --------------------------------------------------------------------------
450 .\" Usage
451 .\" --------------------------------------------------------------------------
452 .
453 .SH "USAGE"
454 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
455 \-fs option is \-nofs.
456 .PP
457 If an option is marked as (XXX only), it will only work in combination with
458 the XXX option or if XXX is compiled in.
459 .PP
460 .I NOTE:
461 The suboption parser (used for example for \-ao pcm suboptions) supports
462 a special kind of string-escaping intended for use with external GUIs.
463 .br
464 It has the following format:
465 .br
466 %n%string_of_length_n
467 .br
468 .I EXAMPLES:
469 .br
470 mplayer \-ao pcm:file=%10%C:test.wav test.avi
471 .br
472 Or in a script:
473 .br
474 mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
475 .PP
476 .
477 .\" --------------------------------------------------------------------------
478 .\" Configuration files
479 .\" --------------------------------------------------------------------------
480 .
481 .SH "CONFIGURATION FILES"
482 You can put all of the options in configuration files which will be read
483 every time MPlayer/MEncoder is run.
484 The system-wide configuration file 'mplayer.conf' is in your configuration
485 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
486 specific one is '~/\:.mplayer/\:config'.
487 The configuration file for MEncoder is 'mencoder.conf' in your configuration
488 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the
489 user specific one is '~/\:.mplayer/\:mencoder.conf.
490 User specific options override system-wide options and options given on the
491 command line override either.
492 The syntax of the configuration files is 'option=<value>', everything after
493 a '#' is considered a comment.
494 Options that work without values can be enabled by setting them to 'yes'
495 or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
496 Even suboptions can be specified in this way.
497 .PP
498 You can also write file-specific configuration files.
499 If you wish to have a configuration file for a file called 'movie.avi', create a file
500 named 'movie.avi.conf' with the file-specific options in it and put it in
501 ~/.mplayer/.
502 You can also put the configuration file in the same directory as the file to
503 be played, as long as you give the \-use-filedir-conf option (either on the
504 command line or in your global config file).
505 .PP
506 .I EXAMPLE MPLAYER CONFIGURATION FILE:
507 .sp 1
508 .nf
509 # Use Matrox driver by default.
510 vo=xmga
511 # I love practicing handstands while watching videos.
512 flip=yes
513 # Decode/encode multiple files from PNG,
514 # start with mf://filemask
515 mf=type=png:fps=25
516 # Eerie negative images are cool.
517 vf=eq2=1.0:-0.8
518 .fi
519 .PP
520 .I "EXAMPLE MENCODER CONFIGURATION FILE:"
521 .sp 1
522 .nf
523 # Make MEncoder output to a default filename.
524 o=encoded.avi
525 # The next 4 lines allow mencoder tv:// to start capturing immediately.
526 oac=pcm=yes
527 ovc=lavc=yes
528 lavcopts=vcodec=mjpeg
529 tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000
530 # more complex default encoding option set
531 lavcopts=vcodec=mpeg4:autoaspect=1
532 lameopts=aq=2:vbr=4
533 ovc=lavc=1
534 oac=lavc=1
535 passlogfile=pass1stats.log
536 noautoexpand=1
537 subfont-autoscale=3
538 subfont-osd-scale=6
539 subfont-text-scale=4
540 subalign=2
541 subpos=96
542 spuaa=20
543 .fi
544 .
545 .\" --------------------------------------------------------------------------
546 .\" Profiles
547 .\" --------------------------------------------------------------------------
548 .
549 .SH "PROFILES"
550 To ease working with different configurations profiles can be defined in the
551 configuration files.
552 A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
553 All following options will be part of the profile.
554 A description (shown by \-profile help) can be defined with the profile-desc
555 option.
556 To end the profile, start another one or use the profile name 'default'
557 to continue with normal options.
558 .fi
559 .PP
560 .I "EXAMPLE MENCODER PROFILE:"
561 .sp 1
562 .nf
563
564 [mpeg4]
565 profile-desc="MPEG4 encoding"
566 ovc=lacv=yes
567 lavcopts=vcodec=mpeg4:vbitrate=1200
568
569 [mpeg4-hq]
570 profile-desc="HQ MPEG4 encoding"
571 profile=mpeg4
572 lavcopts=mbd=2:trell=yes:v4mv=yes
573 .fi
574 .
575 .\" --------------------------------------------------------------------------
576 .\" Options
577 .\" --------------------------------------------------------------------------
578 .
579 .SH "GENERAL OPTIONS"
580 .
581 .TP
582 .B \-codecs-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
583 Override the standard search path and use the specified file
584 instead of the builtin codecs.conf.
585 .
586 .TP
587 .B \-include <configuration file>
588 Specify configuration file to be parsed after the default ones.
589 .
590 .TP
591 .B \-list-options
592 Prints all available options.
593 .
594 .TP
595 .B \-msgcharset <charset>
596 Convert console messages to the specified character set (default: autodetect).
597 Text will be in the encoding specified with the \-\-charset configure option.
598 Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
599 .br
600 .I NOTE:
601 The option takes effect after command line parsing has finished.
602 The MPLAYER_CHARSET environment variable can help you get rid of
603 the first lines of garbled output.
604 .
605 .TP
606 .B \-msglevel <all=<level>:<module>=<level>:...>
607 Control verbosity directly for each module.
608 The 'all' module changes the verbosity of all the modules not
609 explicitly specified on the command line.
610 See '\-msglevel help' for a list of all modules.
611 .br
612 .I NOTE:
613 Messages printed before the command line is parsed can be controlled only
614 by the MPLAYER_VERBOSE environment variable, which applies to all modules.
615 .br
616 Available levels:
617 .PD 0
618 .RSs
619 .IPs "-1"
620 complete silence
621 .IPs " 0"
622 fatal messages only
623 .IPs " 1"
624 error messages
625 .IPs " 2"
626 warning messages
627 .IPs " 3"
628 short hints
629 .IPs " 4"
630 informational messages
631 .IPs " 5"
632 status messages (those hidden by \-quiet)
633 .IPs " 6"
634 verbose messages
635 .IPs " 7"
636 debug level 2
637 .IPs " 8"
638 debug level 3
639 .IPs " 9"
640 debug level 4
641 .RE
642 .PD 1
643 .
644 .TP
645 .B "\-quiet\ "
646 Make console output less verbose; in particular, prevents the status line
647 (i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
648 Particularly useful on slow terminals or broken ones which do not properly
649 handle carriage return (i.e.\& \\r).
650 .
651 .TP
652 .B \-priority <prio> (Windows only)
653 Set process priority for MPlayer according to the predefined
654 priorities available under Windows.
655 Possible values of <prio>:
656 .RSs
657 idle|belownormal|normal|abovenormal|high|realtime
658 .RE
659 .sp 1
660 .RS
661 .I WARNING:
662 Using realtime priority can cause system lockup.
663 .RE
664 .
665 .TP
666 .B \-profile <profile1,profile2,...>
667 Use the given profile(s), \-profile help displays a list of the defined profiles.
668 .
669 .TP
670 .B \-really-quiet (also see \-quiet)
671 Display even less output and status messages than with \-quiet.
672 .
673 .TP
674 .B \-show-profile <profile>
675 Show the description and content of a profile.
676 .
677 .TP
678 .B \-use-filedir-conf
679 Look for a file-specific configuration file in the same directory as
680 the file that is being played.
681 .br
682 .I WARNING:
683 May be dangerous if playing from untrusted media.
684 .
685 .TP
686 .B "\-v\ \ \ \ \ "
687 Increment verbosity level, one level for each \-v
688 found on the command line.
689 .
690 .
691 .
692 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
693 .
694 .TP
695 .B \-autoq <quality> (use with \-vf [s]pp)
696 Dynamically changes the level of postprocessing depending on the available spare
697 CPU time.
698 The number you specify will be the maximum level used.
699 Usually you can use some big number.
700 You have to use \-vf [s]pp without parameters in order for this to work.
701 .
702 .TP
703 .B \-autosync <factor>
704 Gradually adjusts the A/V sync based on audio delay measurements.
705 Specifying \-autosync 0, the default, will cause frame timing to be based
706 entirely on audio delay measurements.
707 Specifying \-autosync 1 will do the same, but will subtly change the A/V
708 correction algorithm.
709 An uneven video framerate in a movie which plays fine with \-nosound can
710 often be helped by setting this to an integer value greater than 1.
711 The higher the value, the closer the timing will be to \-nosound.
712 Try \-autosync 30 to smooth out problems with sound drivers which do
713 not implement a perfect audio delay measurement.
714 With this value, if large A/V sync offsets occur, they will only take about
715 1 or 2 seconds to settle out.
716 This delay in reaction time to sudden A/V offsets should be the only
717 side-effect of turning this option on, for all sound drivers.
718 .
719 .TP
720 .B \-benchmark
721 Prints some statistics on CPU usage and dropped frames at the end of playback.
722 Use in combination with \-nosound and \-vo null for benchmarking only the
723 video codec.
724 .br
725 .I NOTE:
726 With this option MPlayer will also ignore frame duration when playing
727 only video (you can think of that as infinite fps).
728 .
729 .TP
730 .B \-colorkey <number>
731 Changes the colorkey to an RGB value of your choice.
732 0x000000 is black and 0xffffff is white.
733 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
734 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
735 drivers.
736 .
737 .TP
738 .B \-nocolorkey
739 Disables colorkeying.
740 Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix,
741 xover, xv (see \-vo xv:ck), xvmc (see \-vo xv:ck) and directx video output
742 drivers.
743 .
744 .TP
745 .B \-correct-pts (experimental)
746 Switches MPlayer to an experimental mode where timestamps for video frames
747 are calculated differently and video filters which add new frames or
748 modify timestamps of existing ones are supported.
749 The more accurate timestamps can be visible for example when playing
750 subtitles timed to scene changes with the \-ass option.
751 Without \-correct-pts the subtitle timing will typically be off by some frames.
752 This option does not work correctly with some demuxers and codecs.
753 .
754 .TP
755 .B \-crash-debug (DEBUG CODE)
756 Automatically attaches gdb upon crash or SIGTRAP.
757 Support must be compiled in by configuring with \-\-enable-crash-debug.
758 .
759 .TP
760 .B \-edlout <filename>
761 Creates a new file and writes edit decision list (EDL) records to it.
762 During playback, the user hits 'i' to mark the start or end of a skip block.
763 This provides a starting point from which the user can fine-tune EDL entries
764 later.
765 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
766 .
767 .TP
768 .B \-enqueue (GUI only)
769 Enqueue files given on the command line in the playlist instead of playing them
770 immediately.
771 .
772 .TP
773 .B \-fixed-vo
774 Enforces a fixed video system for multiple files (one (un)initialization for
775 all files).
776 Therefore only one window will be opened for all files.
777 Currently the following drivers are fixed-vo compliant: gl, gl2, mga, svga, x11,
778 xmga, xv, xvidix and dfbmga.
779 .
780 .TP
781 .B \-framedrop (also see \-hardframedrop)
782 Skip displaying some frames to maintain A/V sync on slow systems.
783 Video filters are not applied to such frames.
784 For B-frames even decoding is skipped completely.
785 .
786 .TP
787 .B \-(no)gui
788 Enable or disable the GUI interface (default depends on binary name).
789 Only works as the first argument on the command line.
790 Does not work as a config-file option.
791 .
792 .TP
793 .B \-h, \-help, \-\-help
794 Show short summary of options.
795 .
796 .TP
797 .B \-hardframedrop
798 More intense frame dropping (breaks decoding).
799 Leads to image distortion!
800 .
801 .TP
802 .B \-identify
803 Shorthand for \-msglevel identify=4.
804 Show file parameters in an easily parseable format.
805 Also prints more detailed information about subtitle and audio
806 track languages and IDs.
807 In some cases you can get more information by using \-msglevel identify=6.
808 For example, for a DVD it will list the time length of each title, as well
809 as a disk ID.
810 The wrapper script TOOLS/\:midentify suppresses the other MPlayer output and
811 (hopefully) shellescapes the filenames.
812 .
813 .TP
814 .B \-idle (also see \-slave)
815 Makes MPlayer wait idly instead of quitting when there is no file to play.
816 Mostly useful in slave mode where MPlayer can be controlled
817 through input commands.
818 .
819 .TP
820 .B \-input <commands>
821 This option can be used to configure certain parts of the input system.
822 Paths are relative to ~/.mplayer/.
823 .br
824 .I NOTE:
825 Autorepeat is currently only supported by joysticks.
826 .sp 1
827 Available commands are:
828 .sp 1
829 .PD 0
830 .RSs
831 .IPs conf=<filename>
832 Specify input configuration file other than the default
833 ~/\:.mplayer/\:input.conf.
834 ~/\:.mplayer/\:<filename> is assumed if no full path is given.
835 .IPs ar-delay
836 Delay in milliseconds before we start to autorepeat a key (0 to disable).
837 .IPs ar-rate
838 Number of key presses to generate per second on autorepeat.
839 .IPs keylist
840 Prints all keys that can be bound to commands.
841 .IPs cmdlist
842 Prints all commands that can be bound to keys.
843 .IPs js-dev
844 Specifies the joystick device to use (default: /dev/\:input/\:js0).
845 .IPs file=<filename>
846 Read commands from the given file.
847 Mostly useful with a FIFO.
848 .br
849 .I NOTE:
850 When the given file is a FIFO MPlayer opens both ends so you can do
851 several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
852 .RE
853 .PD 1
854 .
855 .TP
856 .B \-key-fifo-size <2\-65000>
857 Specify the size of the FIFO that buffers key events (default: 10).
858 A FIFO of size n can buffer (n-1) events.
859 If it is too small some events may be lost
860 (leading to "stuck mouse buttons" and similar effects).
861 If it is too big, MPlayer may seem to hang while it
862 processes the buffered events.
863 To get the same behavior as before this option was introduced,
864 set it to 2 for Linux or 1024 for Windows.
865 .
866 .TP
867 .B \-lircconf <filename> (LIRC only)
868 Specifies a configuration file for LIRC (default: ~/.lircrc).
869 .
870 .TP
871 .B \-list-properties
872 Print a list of the available properties.
873 .
874 .TP
875 .B \-loop <number>
876 Loops movie playback <number> times.
877 0 means forever.
878 .
879 .TP
880 .B \-menu (OSD menu only)
881 Turn on OSD menu support.
882 .
883 .TP
884 .B \-menu-cfg <filename> (OSD menu only)
885 Use an alternative menu.conf.
886 .
887 .TP
888 .B \-menu-root <value> (OSD menu only)
889 Specify the main menu.
890 .
891 .TP
892 .B \-menu-startup (OSD menu only)
893 Display the main menu at MPlayer startup.
894 .
895 .TP
896 .B \-mouse-movements
897 Permit MPlayer to receive pointer events reported by the video
898 output driver (currently only derivatives of X11 are supported).
899 Necessary to select the buttons in DVD menus.
900 .
901 .TP
902 .B \-noconsolecontrols
903 Prevent MPlayer from reading key events from standard input.
904 Useful when reading data from standard input.
905 This is automatically enabled when \- is found on the command line.
906 There are situations where you have to set it manually, e.g.\&
907 if you open /dev/\:stdin (or the equivalent on your system), use stdin
908 in a playlist or intend to read from stdin later on via the loadfile or
909 loadlist slave commands.
910 .
911 .TP
912 .B \-nojoystick
913 Turns off joystick support.
914 .
915 .TP
916 .B \-nolirc
917 Turns off LIRC support.
918 .
919 .TP
920 .B \-nomouseinput (X11 only)
921 Disable mouse button press/\:release input (mozplayerxp's context menu relies
922 on this option).
923 .
924 .TP
925 .B \-rtc (RTC only)
926 Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
927 mechanism.
928 This wakes up the process every 1/1024 seconds to check the current time.
929 Useless with modern Linux kernels configured for desktop use as they already
930 wake up the process with similar accuracy when using normal timed sleep.
931 .
932 .TP
933 .B \-playing-msg <string>
934 Print out a string before starting playback.
935 The following expansions are supported:
936 .RSs
937 .IPs ${NAME}
938 Expand to the value of the property NAME.
939 .IPs $(NAME:TEXT)
940 Expand TEXT only if the property NAME is available.
941 .RE
942 .
943 .TP
944 .B \-playlist <filename>
945 Play files according to a playlist file (ASX, Winamp, SMIL, or
946 one-file-per-line format).
947 .br
948 .I NOTE:
949 This option is considered an entry so options found after it will apply
950 only to the elements of this playlist.
951 .br
952 FIXME: This needs to be clarified and documented thoroughly.
953 .
954 .TP
955 .B \-rtc-device <device>
956 Use the specified device for RTC timing.
957 .
958 .TP
959 .B \-shuffle
960 Play files in random order.
961 .
962 .TP
963 .B \-skin <name> (GUI only)
964 Loads a skin from the directory given as parameter below the default skin
965 directories, /usr/\:local/\:share/\:mplayer/\:skins/\: and ~/.mplayer/\:skins/.
966 .sp 1
967 .I EXAMPLE:
968 .PD 0
969 .RSs
970 .IPs "\-skin fittyfene"
971 Tries /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene
972 and afterwards ~/.mplayer/\:skins/\:fittyfene.
973 .RE
974 .PD 1
975 .
976 .TP
977 .B \-slave (also see \-input)
978 Switches on slave mode, in which MPlayer works as a backend for other programs.
979 Instead of intercepting keyboard events, MPlayer will read commands separated
980 by a newline (\\n) from stdin.
981 .br
982 .I NOTE:
983 See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
984 for their description.
985 .
986 .TP
987 .B \-softsleep
988 Time frames by repeatedly checking the current time instead of asking the
989 kernel to wake up MPlayer at the correct time.
990 Useful if your kernel timing is imprecise and you cannot use the RTC either.
991 Comes at the price of higher CPU consumption.
992 .
993 .TP
994 .B \-sstep <sec>
995 Skip <sec> seconds after every frame.
996 The normal framerate of the movie is kept, so playback is accelerated.
997 Since MPlayer can only seek to the next keyframe this may be inexact.
998 .
999 .
1000 .
1001 .SH "DEMUXER/STREAM OPTIONS"
1002 .
1003 .TP
1004 .B \-a52drc <level>
1005 Select the Dynamic Range Compression level for AC3 audio streams.
1006 <level> is a float value ranging from 0 to 1, where 0 means no compression
1007 and 1 (which is the default) means full compression (make loud passages more
1008 silent and vice versa).
1009 This option only shows an effect if the AC3 stream contains the required range
1010 compression information.
1011 .
1012 .TP
1013 .B \-aid <ID> (also see \-alang)
1014 Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
1015 VOB(AC3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
1016 MPlayer prints the available audio IDs when run in verbose (\-v) mode.
1017 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
1018 (if present) with the chosen audio stream.
1019 .
1020 .TP
1021 .B \-alang <language code[,language code,...]> (also see \-aid)
1022 Specify a priority list of audio languages to use.
1023 Different container formats employ different language codes.
1024 DVDs use ISO 639-1 two letter language codes, Matroska and NUT use ISO 639-2
1025 three letter language codes while OGM uses a free-form identifier.
1026 MPlayer prints the available languages when run in verbose (\-v) mode.
1027 .sp 1
1028 .I EXAMPLE:
1029 .PD 0
1030 .RSs
1031 .IPs "mplayer dvd://1 \-alang hu,en"
1032 Chooses the Hungarian language track on a DVD and falls back on English if
1033 Hungarian is not available.
1034 .IPs "mplayer \-alang jpn example.mkv"
1035 Plays a Matroska file in Japanese.
1036 .RE
1037 .PD 1
1038 .
1039 .TP
1040 .B \-audio-demuxer <[+]name> (\-audiofile only)
1041 Force audio demuxer type for \-audiofile.
1042 Use a '+' before the name to force it, this will skip some checks!
1043 Give the demuxer name as printed by \-audio-demuxer help.
1044 For backward compatibility it also accepts the demuxer ID as defined in
1045 libmpdemux/\:demuxer.h.
1046 \-audio-demuxer audio or \-audio-demuxer 17 forces MP3.
1047 .
1048 .TP
1049 .B \-audiofile <filename>
1050 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
1051 movie.
1052 .
1053 .TP
1054 .B \-audiofile-cache <kBytes>
1055 Enables caching for the stream used by \-audiofile, using the specified
1056 amount of memory.
1057 .
1058 .TP
1059 .B \-bandwidth <value> (network only)
1060 Specify the maximum bandwidth for network streaming (for servers that are
1061 able to send content in different bitrates).
1062 Useful if you want to watch live streamed media behind a slow connection.
1063 With Real RTSP streaming, it is also used to set the maximum delivery
1064 bandwidth allowing faster cache filling and stream dumping.
1065 .
1066 .TP
1067 .B \-cache <kBytes>
1068 This option specifies how much memory (in kBytes) to use when precaching a
1069 file or URL.
1070 Especially useful on slow media.
1071 .
1072 .TP
1073 .B \-nocache
1074 Turns off caching.
1075 .
1076 .TP
1077 .B \-cache-min <percentage>
1078 Playback will start when the cache has been filled up to <percentage>
1079 of the total.
1080 .
1081 .TP
1082 .B \-cache-seek-min <percentage>
1083 If a seek is to be made to a position within <percentage> of the cache size
1084 from the current position, MPlayer will wait for the cache to be filled to
1085 this position rather than performing a stream seek (default: 50).
1086 .
1087 .TP
1088 .B \-cdda <option1:option2> (CDDA only)
1089 This option can be used to tune the CD Audio reading feature of MPlayer.
1090 .sp 1
1091 Available options are:
1092 .RSs
1093 .IPs speed=<value>
1094 Set CD spin speed.
1095 .IPs paranoia=<0\-2>
1096 Set paranoia level.
1097 Values other than 0 seem to break playback of anything but the first track.
1098 .RSss
1099 0: disable checking (default)
1100 .br
1101 1: overlap checking only
1102 .br
1103 2: full data correction and verification
1104 .REss
1105 .IPs generic-dev=<value>
1106 Use specified generic SCSI device.
1107 .IPs sector-size=<value>
1108 Set atomic read size.
1109 .IPs overlap=<value>
1110 Force minimum overlap search during verification to <value> sectors.
1111 .IPs toc-bias
1112 Assume that the beginning offset of track 1 as reported in the TOC will be
1113 addressed as LBA 0.
1114 Some Toshiba drives need this for getting track boundaries correct.
1115 .IPs toc-offset=<value>
1116 Add <value> sectors to the values reported when addressing tracks.
1117 May be negative.
1118 .IPs (no)skip
1119 (Never) accept imperfect data reconstruction.
1120 .RE
1121 .
1122 .TP
1123 .B \-cdrom-device <path to device>
1124 Specify the CD-ROM device (default: /dev/\:cdrom).
1125 .
1126 .TP
1127 .B \-channels <number> (also see \-af channels)
1128 Request the number of playback channels (default: 2).
1129 MPlayer asks the decoder to decode the audio into as many channels as
1130 specified.
1131 Then it is up to the decoder to fulfill the requirement.
1132 This is usually only important when playing videos with AC3 audio (like DVDs).
1133 In that case liba52 does the decoding by default and correctly downmixes the
1134 audio into the requested number of channels.
1135 To directly control the number of output channels independently of how many
1136 channels are decoded, use the channels filter.
1137 .br
1138 .I NOTE:
1139 This option is honored by codecs (AC3 only), filters (surround) and audio
1140 output drivers (OSS at least).
1141 .sp 1
1142 Available options are:
1143 .sp 1
1144 .PD 0
1145 .RSs
1146 .IPs 2
1147 stereo
1148 .IPs 4
1149 surround
1150 .IPs 6
1151 full 5.1
1152 .RE
1153 .PD 1
1154 .
1155 .TP
1156 .B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
1157 Specify which chapter to start playing at.
1158 Optionally specify which chapter to end playing at (default: 1).
1159 .
1160 .TP
1161 .B \-cookies (network only)
1162 Send cookies when making HTTP requests.
1163 .
1164 .TP
1165 .B \-cookies-file <filename> (network only)
1166 Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
1167 and skip reading from default locations.
1168 The file is assumed to be in Netscape format.
1169 .
1170 .TP
1171 .B \-delay <sec>
1172 audio delay in seconds (positive or negative float value)
1173 .br
1174 .I NOTE:
1175 When used with MEncoder, this is not guaranteed to work correctly
1176 with \-ovc copy; use \-audio-delay instead.
1177 .
1178 .TP
1179 .B \-ignore-start
1180 Ignore the specified starting time for streams in AVI files.
1181 In MPlayer, this nullifies stream delays in files encoded with
1182 the \-audio-delay option.
1183 During encoding, this option prevents MEncoder from transferring
1184 original stream start times to the new file; the \-audio-delay option is
1185 not affected.
1186 Note that MEncoder sometimes adjusts stream starting times
1187 automatically to compensate for anticipated decoding delays, so do not
1188 use this option for encoding without testing it first.
1189 .
1190 .TP
1191 .B \-demuxer <[+]name>
1192 Force demuxer type.
1193 Use a '+' before the name to force it, this will skip some checks!
1194 Give the demuxer name as printed by \-demuxer help.
1195 For backward compatibility it also accepts the demuxer ID as defined in
1196 libmpdemux/\:demuxer.h.
1197 \-demuxer audio or \-demuxer 17 forces MP3.
1198 .
1199 .TP
1200 .B \-dumpaudio (MPlayer only)
1201 Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC3,
1202 in most other cases the resulting file will not be playable).
1203 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1204 on the command line only the last one will work.
1205 .
1206 .TP
1207 .B \-dumpfile <filename> (MPlayer only)
1208 Specify which file MPlayer should dump to.
1209 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
1210 .
1211 .TP
1212 .B \-dumpstream (MPlayer only)
1213 Dumps the raw stream to ./stream.dump.
1214 Useful when ripping from DVD or network.
1215 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1216 on the command line only the last one will work.
1217 .
1218 .TP
1219 .B \-dumpvideo (MPlayer only)
1220 Dump raw compressed video stream to ./stream.dump (not very usable).
1221 If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
1222 on the command line only the last one will work.
1223 .
1224 .TP
1225 .B \-dvbin <options> (DVB only)
1226 Pass the following parameters to the DVB input module, in order to override
1227 the default ones:
1228 .sp 1
1229 .PD 0
1230 .RSs
1231 .IPs card=<1\-4>
1232 Specifies using card number 1\-4 (default: 1).
1233 .IPs file=<filename>
1234 Instructs MPlayer to read the channels list from <filename>.
1235 Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
1236 or ~/.mplayer/\:channels.conf as a last resort.
1237 .IPs timeout=<1\-30>
1238 Maximum number of seconds to wait when trying to tune a
1239 frequency before giving up (default: 30).
1240 .RE
1241 .PD 1
1242 .
1243 .TP
1244 .B \-dvd-device <path to device> (DVD only)
1245 Specify the DVD device (default: /dev/\:dvd).
1246 You can also specify a directory that contains files previously copied directly
1247 from a DVD (with e.g.\& vobcopy).
1248 Note that using \-dumpstream is usually a better way to
1249 copy DVD titles in the first place (see the examples).
1250 .
1251 .TP
1252 .B \-dvdangle <angle ID> (DVD only)
1253 Some DVD discs contain scenes that can be viewed from multiple angles.
1254 Here you can tell MPlayer which angles to use (default: 1).
1255 .
1256 .TP
1257 .B \-edl <filename>
1258 Enables edit decision list (EDL) actions during playback.
1259 Video will be skipped over and audio will be muted and unmuted according to
1260 the entries in the given file.
1261 See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
1262 on how to use this.
1263 .
1264 .TP
1265 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
1266 Stop at given time or byte position.
1267 .br
1268 .I NOTE:
1269 Byte position is enabled only for MEncoder and will not be accurate, as it can
1270 only stop at a frame boundary.
1271 When used in conjunction with \-ss option, \-endpos time will shift forward by
1272 seconds specified with \-ss.
1273 .sp 1
1274 .I EXAMPLE:
1275 .PD 0
1276 .RSs
1277 .IPs "\-endpos 56"
1278 Stop at 56 seconds.
1279 .IPs "\-endpos 01:10:00"
1280 Stop at 1 hour 10 minutes.
1281 .IPs "\-ss 10 \-endpos 56"
1282 Stop at 1 minute 6 seconds.
1283 .IPs "\-endpos 100mb"
1284 Encode only 100 MB.
1285 .RE
1286 .PD 1
1287 .
1288 .TP
1289 .B \-forceidx
1290 Force index rebuilding.
1291 Useful for files with broken index (A/V desync, etc).
1292 This will enable seeking in files where seeking was not possible.
1293 You can fix the index permanently with MEncoder (see the documentation).
1294 .br
1295 .I NOTE:
1296 This option only works if the underlying media supports seeking
1297 (i.e.\& not with stdin, pipe, etc).
1298 .
1299 .TP
1300 .B \-fps <float value>
1301 Override video framerate.
1302 Useful if the original value is wrong or missing.
1303 .
1304 .TP
1305 .B \-frames <number>
1306 Play/\:convert only first <number> frames, then quit.
1307 .
1308 .TP
1309 .B \-hr-mp3-seek (MP3 only)
1310 Hi-res MP3 seeking.
1311 Enabled when playing from an external MP3 file, as we need to seek
1312 to the very exact position to keep A/V sync.
1313 Can be slow especially when seeking backwards since it has to rewind
1314 to the beginning to find an exact frame position.
1315 .
1316 .TP
1317 .B \-idx (also see \-forceidx)
1318 Rebuilds index of files if no index was found, allowing seeking.
1319 Useful with broken/\:incomplete downloads, or badly created files.
1320 .br
1321 .I NOTE:
1322 This option only works if the underlying media supports seeking
1323 (i.e.\& not with stdin, pipe, etc).
1324 .
1325 .TP
1326 .B \-ipv4-only-proxy (network only)
1327 Skip the proxy for IPv6 addresses.
1328 It will still be used for IPv4 connections.
1329 .
1330 .TP
1331 .B \-loadidx <index file>
1332 The file from which to read the video index data saved by \-saveidx.
1333 This index will be used for seeking, overriding any index data
1334 contained in the AVI itself.
1335 MPlayer will not prevent you from loading an index file generated
1336 from a different AVI, but this is sure to cause unfavorable results.
1337 .br
1338 .I NOTE:
1339 This option is obsolete now that MPlayer has OpenDML support.
1340 .
1341 .TP
1342 .B \-mc <seconds/frame>
1343 maximum A-V sync correction per frame (in seconds)
1344 .
1345 .TP
1346 .B \-mf <option1:option2:...>
1347 Used when decoding from multiple PNG or JPEG files.
1348 .sp 1
1349 Available options are:
1350 .sp 1
1351 .PD 0
1352 .RSs
1353 .IPs w=<value>
1354 input file width (default: autodetect)
1355 .IPs h=<value>
1356 input file height (default: autodetect)
1357 .IPs fps=<value>
1358 output fps (default: 25)
1359 .IPs type=<value>
1360 input file type (available: jpeg, png, tga, sgi)
1361 .RE
1362 .PD 1
1363 .
1364 .TP
1365 .B \-ni (AVI only)
1366 Force usage of non-interleaved AVI parser (fixes playback
1367 of some bad AVI files).
1368 .
1369 .TP
1370 .B \-nobps (AVI only)
1371 Do not use average byte/\:second value for A-V sync.
1372 Helps with some AVI files with broken header.
1373 .
1374 .TP
1375 .B \-noextbased
1376 Disables extension-based demuxer selection.
1377 By default, when the file type (demuxer) cannot be detected reliably
1378 (the file has no header or it is not reliable enough), the filename
1379 extension is used to select the demuxer.
1380 Always falls back on content-based demuxer selection.
1381 .
1382 .TP
1383 .B \-passwd <password> (also see \-user) (network only)
1384 Specify password for HTTP authentication.
1385 .
1386 .TP
1387 .B \-prefer-ipv4 (network only)
1388 Use IPv4 on network connections.
1389 Falls back on IPv6 automatically.
1390 .
1391 .TP
1392 .B \-prefer-ipv6 (IPv6 network only)
1393 Use IPv6 on network connections.
1394 Falls back on IPv4 automatically.
1395 .
1396 .TP
1397 .B \-pvr <option1:option2:...> (PVR only)
1398 This option tunes various encoding properties of the PVR capture module.
1399 It has to be used with any hardware MPEG encoder based card supported by the
1400 V4L2 driver.
1401 The Hauppauge WinTV PVR\-150/250/350/500 and all IVTV based
1402 cards are known as PVR capture cards.
1403 Be aware that only Linux 2.6.18 kernel
1404 and above is able to handle MPEG stream through V4L2 layer.
1405 For hardware capture of an MPEG stream and watching it with
1406 MPlayer/MEncoder, use 'pvr://' as a movie URL.
1407 .sp 1
1408 Available options are:
1409 .RSs
1410 .IPs aspect=<0\-3>
1411 Specify input aspect ratio:
1412 .RSss
1413 0: 1:1
1414 .br
1415 1: 4:3 (default)
1416 .br
1417 2: 16:9
1418 .br
1419 3: 2.21:1
1420 .REss
1421 .IPs arate=<32000\-48000>
1422 Specify encoding audio rate (default: 48000 Hz, available: 32000, 44100
1423 and 48000 Hz).
1424 .IPs alayer=<1\-3>
1425 Specify MPEG audio layer encoding (default: 2).
1426 .IPs abitrate=<32\-448>
1427 Specify audio encoding bitrate in kbps (default: 384).
1428 .IPs amode=<value>
1429 Specify audio encoding mode.
1430 Available preset values are 'stereo', 'joint_stereo', 'dual' and 'mono' (default: stereo).
1431 .IPs vbitrate=<value>
1432 Specify average video bitrate encoding in Mbps (default: 6).
1433 .IPs vmode=<value>
1434 Specify video encoding mode:
1435 .RSss
1436 vbr: Variable BitRate (default)
1437 .br
1438 cbr: Constant BitRate
1439 .REss
1440 .IPs vpeak=<value>
1441 Specify peak video bitrate encoding in Mbps
1442 (only useful for VBR encoding, default: 9.6).
1443 .IPs fmt=<value>
1444 Choose an MPEG format for encoding:
1445 .RSss
1446 ps:    MPEG-2 Program Stream (default)
1447 .br
1448 ts:    MPEG-2 Transport Stream
1449 .br
1450 mpeg1: MPEG-1 System Stream
1451 .br
1452 vcd:   Video CD compatible stream
1453 .br
1454 svcd:  Super Video CD compatible stream
1455 .br
1456 dvd:   DVD compatible stream
1457 .REss
1458 .RE
1459 .PD 1
1460 .
1461 .TP
1462 .B \-rawaudio <option1:option2:...>
1463 This option lets you play raw audio files.
1464 You have to use \-demuxer rawaudio as well.
1465 It may also be used to play audio CDs which are not 44kHz 16-bit stereo.
1466 For playing raw AC3 streams use \-rawaudio format=0x2000 \-demuxer rawaudio.
1467 .sp 1
1468 Available options are:
1469 .sp 1
1470 .PD 0
1471 .RSs
1472 .IPs channels=<value>
1473 number of channels
1474 .IPs rate=<value>
1475 rate in samples per second
1476 .IPs samplesize=<value>
1477 sample size in bytes
1478 .IPs bitrate=<value>
1479 bitrate for rawaudio files
1480 .IPs format=<value>
1481 fourcc in hex
1482 .RE
1483 .PD 1
1484 .
1485 .TP
1486 .B \-rawvideo <option1:option2:...>
1487 This option lets you play raw video files.
1488 You have to use \-demuxer rawvideo as well.
1489 .sp 1
1490 Available options are:
1491 .sp 1
1492 .PD 0
1493 .RSs
1494 .IPs fps=<value>
1495 rate in frames per second (default: 25.0)
1496 .IPs sqcif|qcif|cif|4cif|pal|ntsc
1497 set standard image size
1498 .IPs w=<value>
1499 image width in pixels
1500 .IPs h=<value>
1501 image height in pixels
1502 .IPs i420|yv12|yuy2|y8
1503 set colorspace
1504 .IPs format=<value>
1505 colorspace (fourcc) in hex
1506 .IPs size=<value>
1507 frame size in Bytes
1508 .REss
1509 .sp 1
1510 .RS
1511 .I EXAMPLE:
1512 .RE
1513 .PD 0
1514 .RSs
1515 .IPs "mplayer foreman.qcif -demuxer rawvideo -rawvideo qcif"
1516 Play the famous "foreman" sample video.
1517 .IPs "mplayer sample-720x576.yuv -demuxer rawvideo -rawvideo w=720:h=576"
1518 Play a raw YUV sample.
1519 .RE
1520 .PD 1
1521 .
1522 .TP
1523 .B \-rtsp-port
1524 Used with 'rtsp://' URLs to force the client's port number.
1525 This option may be useful if you are behind a router and want to forward
1526 the RTSP stream from the server to a specific client.
1527 .
1528 .TP
1529 .B \-rtsp-destination
1530 Used with 'rtsp://' URLs to force the destination IP address to be bound.
1531 This option may be useful with some RTSP server which do not
1532 send RTP packets to the right interface.
1533 If the connection to the RTSP server fails, use \-v to see
1534 which IP address MPlayer tries to bind to and try to force
1535 it to one assigned to your computer instead.
1536 .
1537 .TP
1538 .B \-rtsp-stream-over-tcp (LIVE555 only)
1539 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
1540 packets be streamed over TCP (using the same TCP connection as RTSP).
1541 This option may be useful if you have a broken internet connection that does
1542 not pass incoming UDP packets (see http://www.live555.com/\:mplayer/).
1543 .
1544 .TP
1545 .B \-saveidx <filename>
1546 Force index rebuilding and dump the index to <filename>.
1547 Currently this only works with AVI files.
1548 .br
1549 .I NOTE:
1550 This option is obsolete now that MPlayer has OpenDML support.
1551 .
1552 .TP
1553 .B \-sb <byte position> (also see \-ss)
1554 Seek to byte position.
1555 Useful for playback from CD-ROM images or VOB files with junk at the beginning.
1556 .
1557 .TP
1558 .B \-speed <0.01\-100>
1559 Slow down or speed up playback by the factor given as parameter.
1560 Not guaranteed to work correctly with \-oac copy.
1561 .
1562 .TP
1563 .B \-srate <Hz>
1564 Selects the output sample rate to be used
1565 (of course sound cards have limits on this).
1566 If the sample frequency selected is different from that
1567 of the current media, the resample or lavcresample audio filter will be inserted
1568 into the audio filter layer to compensate for the difference.
1569 The type of resampling can be controlled by the \-af-adv option.
1570 The default is fast resampling that may cause distortion.
1571 .
1572 .TP
1573 .B \-ss <time> (also see \-sb)
1574 Seek to given time position.
1575 .sp 1
1576 .I EXAMPLE:
1577 .PD 0
1578 .RSs
1579 .IPs "\-ss 56"
1580 Seeks to 56 seconds.
1581 .IPs "\-ss 01:10:00"
1582 Seeks to 1 hour 10 min.
1583 .RE
1584 .PD 1
1585 .
1586 .TP
1587 .B \-tskeepbroken
1588 Tells MPlayer not to discard TS packets reported as broken in the stream.
1589 Sometimes needed to play corrupted MPEG-TS files.
1590 .
1591 .TP
1592 .B \-tsprobe <byte position>
1593 When playing an MPEG-TS stream, this option lets you specify how many
1594 bytes in the stream you want MPlayer to search for the desired
1595 audio and video IDs.
1596 .
1597 .TP
1598 .B \-tsprog <1\-65534>
1599 When playing an MPEG-TS stream, you can specify with this option which
1600 program (if present) you want to play.
1601 Can be used with \-vid and \-aid.
1602 .
1603 .TP
1604 .B \-radio <option1:option2:...> (radio only)
1605 These options set various parameters of the radio capture module.
1606 For listening to radio with MPlayer use 'radio://<frequency>'
1607 (if channels option is not given) or 'radio://<channel_number>'
1608 (if channels option is given) as a movie URL.
1609 You can see allowed frequency range by running MPlayer with '\-v'.
1610 To start the grabbing subsystem, use 'radio://<frequency or channel>/capture'.
1611 If the capture keyword is not given you can listen to radio
1612 using the line-in cable only.
1613 Using capture to listen is not recommended due to synchronization
1614 problems, which makes this process uncomfortable.
1615 .sp 1
1616 Available options are:
1617 .RSs
1618 .IPs device=<value>
1619 Radio device to use (default: /dev/radio0 for Linux and /dev/tuner0 for *BSD).
1620 .IPs driver=<value>
1621 Radio driver to use (default: v4l2 if available, otherwise v4l).
1622 Currently, v4l and v4l2 drivers are supported.
1623 .IPs volume=<0..100>
1624 sound volume for radio device (default 100)
1625 .IPs freq_min=<value> (*BSD BT848 only)
1626 minimum allowed frequency (default: 87.50)
1627 .IPs freq_max=<value> (*BSD BT848 only)
1628 maximum allowed frequency (default: 108.00)
1629 .IPs channels=<frequency>\-<name>,<frequency>\-<name>,...
1630 Set channel list.
1631 Use _ for spaces in names (or play with quoting ;-).
1632 The channel names will then be written using OSD and the slave commands
1633 radio_step_channel and radio_set_channel will be usable for
1634 a remote control (see LIRC).
1635 If given, number in movie URL will be treated as channel position in
1636 channel list.
1637 .br
1638 .I EXAMPLE:
1639 radio://1, radio://104.4, radio_set_channel 1
1640 .IPs adevice=<value> (with radio capture enabled)
1641 Name of device to capture sound from.
1642 Without such a name capture will be disabled,
1643 even if the capture keyword appears in the URL.
1644 For ALSA devices use it in the form hw=<card>.<device>.
1645 If the device name contains a '=', the module will use
1646 ALSA to capture, otherwise OSS.
1647 .IPs arate=<value> (with radio capture enabled)
1648 Rate in samples per second (default: 44100).
1649 .br
1650 .I NOTE:
1651 When using audio capture set also \-rawaudio rate=<value> option
1652 with the same value as arate.
1653 If you have problems with sound speed (runs too quickly), try to play
1654 with different rate values (e.g.\& 48000,44100,32000,...).
1655 .IPs achannels=<value> (with radio capture enabled)
1656 Number of audio channels to capture.
1657 .RE
1658 .
1659 .TP
1660 .B \-tv <option1:option2:...> (TV/\:PVR only)
1661 This option tunes various properties of the TV capture module.
1662 For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
1663 or even 'tv://<channel_name> (see option channels for channel_name below)
1664 as a movie URL.
1665 .sp 1
1666 Available options are:
1667 .RSs
1668 .IPs noaudio
1669 no sound
1670 .IPs driver=<value>
1671 available: dummy, v4l, v4l2, bsdbt848
1672 .IPs device=<value>
1673 Specify TV device (default: /dev/\:video0).
1674 .IPs input=<value>
1675 Specify input (default: 0 (TV), see console output for available inputs).
1676 .IPs freq=<value>
1677 Specify the frequency to set the tuner to (e.g.\& 511.250).
1678 Not compatible with the channels parameter.
1679 .IPs outfmt=<value>
1680 Specify the output format of the tuner with a preset value supported by the
1681 V4L driver (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) or an
1682 arbitrary format given as hex value.
1683 Try outfmt=help for a list of all available formats.
1684 .IPs width=<value>
1685 output window width
1686 .IPs height=<value>
1687 output window height
1688 .IPs fps=<value>
1689 framerate at which to capture video (frames per second)
1690 .IPs buffersize=<value>
1691 maximum size of the capture buffer in megabytes (default: dynamical)
1692 .IPs norm=<value>
1693 For bsdbt848 and v4l, PAL, SECAM, NTSC are available.
1694 For v4l2, see the console output for a list of all available norms,
1695 also see the normid option below.
1696 .IPs "normid=<value> (v4l2 only)"
1697 Sets the TV norm to the given numeric ID.
1698 The TV norm depends on the capture card.
1699 See the console output for a list of available TV norms.
1700 .IPs channel=<value>
1701 Set tuner to <value> channel.
1702 .IPs chanlist=<value>
1703 available: europe-east, europe-west, us-bcast, us-cable, etc
1704 .IPs channels=<channel>\-<name>,<channel>\-<name>,...
1705 Set names for channels.
1706 Use _ for spaces in names (or play with quoting ;-).
1707 The channel names will then be written using OSD, and the slave commands
1708 tv_step_channel, tv_set_channel and tv_last_channel will be usable for
1709 a remote control (see LIRC).
1710 Not compatible with the frequency parameter.
1711 .br
1712 .I NOTE:
1713 The channel number will then be the position in the 'channels' list,
1714 beginning with 1.
1715 .br
1716 .I EXAMPLE:
1717 tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
1718 .IPs [brightness|contrast|hue|saturation]=<-100\-100>
1719 Set the image equalizer on the card.
1720 .IPs audiorate=<value>
1721 Set audio capture bitrate.
1722 .IPs forceaudio
1723 Capture audio even if there are no audio sources reported by v4l.
1724 .IPs "alsa\ "
1725 Capture from ALSA.
1726 .IPs amode=<0\-3>
1727 Choose an audio mode:
1728 .RSss
1729 0: mono
1730 .br
1731 1: stereo
1732 .br
1733 2: language 1
1734 .br
1735 3: language 2
1736 .REss
1737 .IPs forcechan=<1\-2>
1738 By default, the count of recorded audio channels is determined automatically
1739 by querying the audio mode from the TV card.
1740 This option allows forcing stereo/\:mono recording regardless of the amode
1741 option and the values returned by v4l.
1742 This can be used for troubleshooting when the TV card is unable to report the
1743 current audio mode.
1744 .IPs adevice=<value>
1745 Set an audio device.
1746 <value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
1747 You must replace any ':' by a '.' in the hardware ID for ALSA.
1748 .IPs audioid=<value>
1749 Choose an audio output of the capture card, if it has more than one.
1750 .IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
1751 .IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
1752 These options set parameters of the mixer on the video capture card.
1753 They will have no effect, if your card does not have one.
1754 For v4l2 50 maps to the default value of the
1755 control, as reported by the driver.
1756 .IPs immediatemode=<bool>
1757 A value of 0 means capture and buffer audio and video together
1758 (default for MEncoder).
1759 A value of 1 (default for MPlayer) means to do video capture only and let the
1760 audio go through a loopback cable from the TV card to the sound card.
1761 .IPs mjpeg
1762 Use hardware MJPEG compression (if the card supports it).
1763 When using this option, you do not need to specify the width and height
1764 of the output window, because MPlayer will determine it automatically
1765 from the decimation value (see below).
1766 .IPs decimation=<1|2|4>
1767 choose the size of the picture that will be compressed by hardware
1768 MJPEG compression:
1769 .RSss
1770 1: full size
1771     704x576    PAL
1772     704x480    NTSC
1773 .br
1774 2: medium size
1775     352x288    PAL
1776     352x240    NTSC
1777 .br
1778 4: small size
1779     176x144    PAL
1780     176x120    NTSC
1781 .REss
1782 .IPs quality=<0\-100>
1783 Choose the quality of the JPEG compression
1784 (< 60 recommended for full size).
1785 .RE
1786 .
1787 .TP
1788 .B \-user <username> (also see \-passwd) (network only)
1789 Specify username for HTTP authentication.
1790 .
1791 .TP
1792 .B \-user-agent <string>
1793 Use <string> as user agent for HTTP streaming.
1794 .
1795 .TP
1796 .B \-vid <ID>
1797 Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
1798 When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
1799 (if present) with the chosen video stream.
1800 .
1801 .TP
1802 .B \-vivo <sub-options> (DEBUG CODE)
1803 Force audio parameters for the VIVO demuxer (for debugging purposes).
1804 .
1805 .
1806 .
1807 .SH "OSD/SUBTITLE OPTIONS"
1808 .I NOTE:
1809 Also see \-vf expand.
1810 .
1811 .TP
1812 .B \-ass (FreeType only)
1813 Turn on SSA/ASS subtitle rendering.
1814 With this option, libass will be used for SSA/ASS
1815 external subtitles and Matroska tracks.
1816 You may also want to use \-embeddedfonts.
1817 .
1818 .TP
1819 .B \-ass-border-color <value>
1820 Sets the border (outline) color for text subtitles.
1821 The color format is RRGGBBAA.
1822 .
1823 .TP
1824 .B \-ass-bottom-margin <value>
1825 Adds a black band at the bottom of the frame.
1826 The SSA/ASS renderer can place subtitles there (with \-ass-use-margins).
1827 .
1828 .TP
1829 .B \-ass-color <value>
1830 Sets the color for text subtitles.
1831 The color format is RRGGBBAA.
1832 .
1833 .TP
1834 .B \-ass-font-scale <value>
1835 Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
1836 .
1837 .TP
1838 .B \-ass-force-style <[Style.]Param=Value[,...]>
1839 Override some style parameters.
1840 .sp
1841 .I EXAMPLE:
1842 .PD 0
1843 .RSs
1844 \-ass-force-style FontName=Arial,Default.Bold=1
1845 .RE
1846 .PD 1
1847 .
1848 .TP
1849 .B \-ass-line-spacing <value>
1850 Set line spacing value for SSA/ASS renderer.
1851 .
1852 .TP
1853 .B \-ass-styles <filename>
1854 Load all SSA/ASS styles found in the specified file and use them for
1855 rendering text subtitles.
1856 The syntax of the file is exactly like the
1857 [V4 Styles] / [V4+ Styles] section of SSA/ASS.
1858 .
1859 .TP
1860 .B \-ass-top-margin <value>
1861 Adds a black band at the top of the frame.
1862 The SSA/ASS renderer can place toptitles there (with \-ass-use-margins).
1863 .
1864 .TP
1865 .B \-(no)ass-use-margins
1866 Enables/disables placing toptitles and subtitles in black borders when they
1867 are available (default: no).
1868 .
1869 .TP
1870 .B \-dumpjacosub (MPlayer only)
1871 Convert the given subtitle (specified with the \-sub option) to the time-based
1872 JACOsub subtitle format.
1873 Creates a dumpsub.js file in the current directory.
1874 .
1875 .TP
1876 .B \-dumpmicrodvdsub (MPlayer only)
1877 Convert the given subtitle (specified with the \-sub option) to the
1878 MicroDVD subtitle format.
1879 Creates a dumpsub.sub file in the current directory.
1880 .
1881 .TP
1882 .B \-dumpmpsub (MPlayer only)
1883 Convert the given subtitle (specified with the \-sub option) to MPlayer's
1884 subtitle format, MPsub.
1885 Creates a dump.mpsub file in the current directory.
1886 .
1887 .TP
1888 .B \-dumpsami (MPlayer only)
1889 Convert the given subtitle (specified with the \-sub option) to the time-based
1890 SAMI subtitle format.
1891 Creates a dumpsub.smi file in the current directory.
1892 .
1893 .TP
1894 .B \-dumpsrtsub (MPlayer only)
1895 Convert the given subtitle (specified with the \-sub option) to the time-based
1896 SubViewer (SRT) subtitle format.
1897 Creates a dumpsub.srt file in the current directory.
1898 .br
1899 .I NOTE:
1900 Some broken hardware players choke on SRT subtitle files with Unix
1901 line endings.
1902 If you are unlucky enough to have such a box, pass your subtitle
1903 files through unix2dos or a similar program to replace Unix line
1904 endings with DOS/Windows line endings.
1905 .
1906 .TP
1907 .B \-dumpsub (MPlayer only) (BETA CODE)
1908 Dumps the subtitle substream from VOB streams.
1909 Also see the \-dump*sub and \-vobsubout* options.
1910 .
1911 .TP
1912 .B \-embeddedfonts (FreeType only)
1913 Enables extraction of Matroska embedded fonts.
1914 These fonts can be used for SSA/ASS subtitle
1915 rendering (\-ass option).
1916 .
1917 .TP
1918 .B \-ffactor <number> (OSD only)
1919 Resample the font alphamap.
1920 Can be:
1921 .PD 0
1922 .RSs
1923 .IPs 0
1924 plain white fonts
1925 .IPs 0.75
1926 very narrow black outline (default)
1927 .IPs 1
1928 narrow black outline
1929 .IPs 10
1930 bold black outline
1931 .RE
1932 .PD 1
1933 .
1934 .TP
1935 .B \-flip-hebrew (FriBiDi only)
1936 Turns on flipping subtitles using FriBiDi.
1937 .
1938 .TP
1939 .B \-noflip-hebrew-commas
1940 Change FriBiDi's assumptions about the placements of commas in subtitles.
1941 Use this if commas in subtitles are shown at the start of a sentence
1942 instead of at the end.
1943 .
1944 .TP
1945 .B \-font <path to font.desc file> (OSD only)
1946 Search for the OSD/\:SUB fonts in an alternative directory (default for normal
1947 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
1948 ~/.mplayer/\:subfont.ttf).
1949 .br
1950 .I NOTE:
1951 With FreeType, this option determines the path to the text font file.
1952 With fontconfig, this option determines the fontconfig font name.
1953 .sp 1
1954 .I EXAMPLE:
1955 .PD 0
1956 .RSs
1957 \-font ~/\:.mplayer/\:arial-14/\:font.desc
1958 .br
1959 \-font ~/\:.mplayer/\:arialuni.ttf
1960 .br
1961 \-font 'Bitstream Vera Sans'
1962 .RE
1963 .PD 1
1964 .
1965 .TP
1966 .B \-fontconfig (fontconfig only)
1967 Enables the usage of fontconfig managed fonts.
1968 .
1969 .TP
1970 .B \-forcedsubsonly
1971 Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
1972 \-slang.
1973 .
1974 .TP
1975 .B \-fribidi-charset <charset name> (FriBiDi only)
1976 Specifies the character set that will be passed to FriBiDi when
1977 decoding non-UTF-8 subtitles (default: ISO8859-8).
1978 .
1979 .TP
1980 .B \-ifo <VOBsub IFO file>
1981 Indicate the file that will be used to load palette and frame size for VOBsub
1982 subtitles.
1983 .
1984 .TP
1985 .B \-noautosub
1986 Turns off automatic subtitle file loading.
1987 .
1988 .TP
1989 .B \-osd-duration <time>
1990 Set the duration of the OSD messages in ms (default: 1000).
1991 .
1992 .TP
1993 .B \-osdlevel <0\-3> (MPlayer only)
1994 Specifies which mode the OSD should start in.
1995 .PD 0
1996 .RSs
1997 .IPs 0
1998 subtitles only
1999 .IPs 1
2000 volume + seek (default)
2001 .IPs 2
2002 volume + seek + timer + percentage
2003 .IPs 3
2004 volume + seek + timer + percentage + total time
2005 .RE
2006 .PD 1
2007 .
2008 .TP
2009 .B \-overlapsub
2010 Allows the next subtitle to be displayed while the current one is
2011 still visible (default is to enable the support only for specific
2012 formats).
2013 .
2014 .TP
2015 .B \-sid <ID> (also see \-slang, \-vobsubid)
2016 Display the subtitle stream specified by <ID> (0\-31).
2017 MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
2018 If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
2019 .
2020 .TP
2021 .B \-slang <language code[,language code,...]> (also see \-sid)
2022 Specify a priority list of subtitle languages to use.
2023 Different container formats employ different language codes.
2024 DVDs use ISO 639-1 two letter language codes, Matroska uses ISO 639-2
2025 three letter language codes while OGM uses a free-form identifier.
2026 MPlayer prints the available languages when run in verbose (\-v) mode.
2027 .sp 1
2028 .I EXAMPLE:
2029 .PD 0
2030 .RSs
2031 .IPs "mplayer dvd://1 \-slang hu,en"
2032 Chooses the Hungarian subtitle track on a DVD and falls back on English if
2033 Hungarian is not available.
2034 .IPs "mplayer \-slang jpn example.mkv"
2035 Plays a Matroska file with Japanese subtitles.
2036 .RE
2037 .PD 1
2038 .
2039 .TP
2040 .B \-spuaa <mode> (OSD only)
2041 Antialiasing/\:scaling mode for DVD/\:VOBsub.
2042 A value of 16 may be added to <mode> in order to force scaling even
2043 when original and scaled frame size already match.
2044 This can be employed to e.g.\& smooth subtitles with gaussian blur.
2045 Available modes are:
2046 .PD 0
2047 .RSs
2048 .IPs 0
2049 none (fastest, very ugly)
2050 .IPs 1
2051 approximate (broken?)
2052 .IPs 2
2053 full (slow)
2054 .IPs 3
2055 bilinear (default, fast and not too bad)
2056 .IPs 4
2057 uses swscaler gaussian blur (looks very good)
2058 .RE
2059 .PD 1
2060 .
2061 .TP
2062 .B \-spualign <-1\-2> (OSD only)
2063 Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
2064 .PD 0
2065 .RSs
2066 .IPs "-1"
2067 original position
2068 .IPs " 0"
2069 Align at top (original behavior, default).
2070 .IPs " 1"
2071 Align at center.
2072 .IPs " 2"
2073 Align at bottom.
2074 .RE
2075 .PD 1
2076 .
2077 .TP
2078 .B \-spugauss <0.0\-3.0> (OSD only)
2079 Variance parameter of gaussian used by \-spuaa 4.
2080 Higher means more blur (default: 1.0).
2081 .
2082 .TP
2083 .B \-sub <subtitlefile1,subtitlefile2,...>
2084 Use/\:display these subtitle files.
2085 Only one file can be displayed at the same time.
2086 .
2087 .TP
2088 .B \-sub-bg-alpha <0\-255>
2089 Specify the alpha channel value for subtitles and OSD backgrounds.
2090 Big values mean more transparency.
2091 0 means completely transparent.
2092 .
2093 .TP
2094 .B \-sub-bg-color <0\-255>
2095 Specify the color value for subtitles and OSD backgrounds.
2096 Currently subtitles are grayscale so this value is equivalent to the
2097 intensity of the color.
2098 255 means white and 0 black.
2099 .
2100 .TP
2101 .B \-sub-demuxer <[+]name> (\-subfile only) (BETA CODE)
2102 Force subtitle demuxer type for \-subfile.
2103 Use a '+' before the name to force it, this will skip some checks!
2104 Give the demuxer name as printed by \-sub-demuxer help.
2105 For backward compatibility it also accepts the demuxer ID as defined in
2106 libmpdemux/\:demuxer.h.
2107 .
2108 .TP
2109 .B \-sub-fuzziness <mode>
2110 Adjust matching fuzziness when searching for subtitles:
2111 .PD 0
2112 .RSs
2113 .IPs 0
2114 exact match
2115 .IPs 1
2116 Load all subs containing movie name.
2117 .IPs 2
2118 Load all subs in the current directory.
2119 .RE
2120 .PD 1
2121 .
2122 .TP
2123 .B \-sub-no-text-pp
2124 Disables any kind of text post processing done after loading the subtitles.
2125 Used for debug purposes.
2126 .
2127 .TP
2128 .B \-subalign <0\-2> (OSD only)
2129 Specify which edge of the subtitles should be aligned at the height
2130 given by \-subpos.
2131 .PD 0
2132 .RSs
2133 .IPs 0
2134 Align subtitle top edge (original behavior).
2135 .IPs 1
2136 Align subtitle center.
2137 .IPs 2
2138 Align subtitle bottom edge (default).
2139 .RE
2140 .PD 1
2141 .
2142 .TP
2143 .B "\-subcc \ "
2144 Display DVD Closed Caption (CC) subtitles.
2145 These are
2146 .B not
2147 the VOB subtitles, these are special ASCII subtitles for the
2148 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
2149 CC subtitles have not been spotted on DVDs from other regions so far.
2150 .
2151 .TP
2152 .B \-subcp <codepage> (iconv only)
2153 If your system supports iconv(3), you can use this option to
2154 specify the subtitle codepage.
2155 .sp 1
2156 .I EXAMPLE:
2157 .PD 0
2158 .RSs
2159 \-subcp latin2
2160 .br
2161 \-subcp cp1250
2162 .RE
2163 .PD 1
2164 .
2165 .TP
2166 .B \-subcp enca:<language>:<fallback codepage> (ENCA only)
2167 You can specify your language using a two letter language code to
2168 make ENCA detect the codepage automatically.
2169 If unsure, enter anything and watch mplayer \-v output for available
2170 languages.
2171 Fallback codepage specifies the codepage to use, when autodetection fails.
2172 .sp 1
2173 .I EXAMPLE:
2174 .PD 0
2175 .RSs
2176 .IPs "\-subcp enca:cs:latin2"
2177 Guess the encoding, assuming the subtitles are Czech, fall back on
2178 latin 2, if the detection fails.
2179 .IPs "\-subcp enca:pl:cp1250"
2180 Guess the encoding for Polish, fall back on cp1250.
2181 .RE
2182 .PD 1
2183 .
2184 .TP
2185 .B \-subdelay <sec>
2186 Delays subtitles by <sec> seconds.
2187 Can be negative.
2188 .
2189 .TP
2190 .B \-subfile <filename> (BETA CODE)
2191 Currently useless.
2192 Same as \-audiofile, but for subtitle streams (OggDS?).
2193 .
2194 .TP
2195 .B \-subfont-autoscale <0\-3> (FreeType only)
2196 Sets the autoscale mode.
2197 .br
2198 .I NOTE:
2199 0 means that text scale and OSD scale are font heights in points.
2200 .sp 1
2201 The mode can be:
2202 .sp 1
2203 .PD 0
2204 .RSs
2205 .IPs 0
2206 no autoscale
2207 .IPs 1
2208 proportional to movie height
2209 .IPs 2
2210 proportional to movie width
2211 .IPs 3
2212 proportional to movie diagonal (default)
2213 .RE
2214 .PD 1
2215 .
2216 .TP
2217 .B \-subfont-blur <0\-8> (FreeType only)
2218 Sets the font blur radius (default: 2).
2219 .
2220 .TP
2221 .B \-subfont-encoding <value> (FreeType only)
2222 Sets the font encoding.
2223 When set to 'unicode', all the glyphs from the font file will be rendered and
2224 unicode will be used (default: unicode).
2225 .
2226 .TP
2227 .B \-subfont-osd-scale <0\-100> (FreeType only)
2228 Sets the autoscale coefficient of the OSD elements (default: 6).
2229 .
2230 .TP
2231 .B \-subfont-outline <0\-8> (FreeType only)
2232 Sets the font outline thickness (default: 2).
2233 .
2234 .TP
2235 .B \-subfont-text-scale <0\-100> (FreeType only)
2236 Sets the subtitle text autoscale coefficient as percentage of the
2237 screen size (default: 5).
2238 .
2239 .TP
2240 .B \-subfps <rate>
2241 Specify the framerate of the subtitle file (default: movie fps).
2242 .br
2243 .I NOTE:
2244 Only for frame-based subtitle files, i.e.\& MicroDVD format.
2245 .
2246 .TP
2247 .B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
2248 Specify the position of subtitles on the screen.
2249 The value is the vertical position of the subtitle in % of the screen height.
2250 .
2251 .TP
2252 .B \-subwidth <10\-100> (OSD only)
2253 Specify the maximum width of subtitles on the screen.
2254 Useful for TV-out.
2255 The value is the width of the subtitle in % of the screen width.
2256 .
2257 .TP
2258 .B \-noterm-osd
2259 Disable the display of OSD messages on the console when no video output is
2260 available.
2261 .
2262 .TP
2263 .B \-term-osd-esc <escape sequence>
2264 Specify the escape sequence to use before writing an OSD message on the
2265 console.
2266 The escape sequence should move the pointer to the beginning of the line
2267 used for the OSD and clear it (default: ^[[A\\r^[[K).
2268 .
2269 .TP
2270 .B \-unicode
2271 Tells MPlayer to handle the subtitle file as unicode.
2272 .
2273 .TP
2274 .B "\-utf8 \ \ "
2275 Tells MPlayer to handle the subtitle file as UTF-8.
2276 .
2277 .TP
2278 .B \-vobsub <VOBsub file without extension>
2279 Specify a VOBsub file to use for subtitles.
2280 Has to be the full pathname without extension, i.e.\& without
2281 the '.idx', '.ifo' or '.sub'.
2282 .
2283 .TP
2284 .B \-vobsubid <0\-31>
2285 Specify the VOBsub subtitle ID.
2286 .
2287 .
2288 .
2289 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
2290 .
2291 .TP
2292 .B \-abs <value> (\-ao oss only) (OBSOLETE)
2293 Override audio driver/\:card buffer size detection.
2294 .
2295 .TP
2296 .B \-format <format> (also see the format audio filter)
2297 Select the sample format used for output from the audio filter
2298 layer to the sound card.
2299 The values that <format> can adopt are listed below in the
2300 description of the format audio filter.
2301 .
2302 .TP
2303 .B \-mixer <device>
2304 Use a mixer device different from the default /dev/\:mixer.
2305 For ALSA this is the mixer name.
2306 .
2307 .TP
2308 .B \-mixer-channel <mixer line>[,mixer index] (\-ao oss and \-ao alsa only)
2309 This option will tell MPlayer to use a different channel for controlling
2310 volume than the default PCM.
2311 Options for OSS include
2312 .B vol, pcm, line.
2313 For a complete list of options look for SOUND_DEVICE_NAMES in
2314 /usr/\:include/\:linux/\:soundcard.h.
2315 For ALSA you can use the names e.g.\& alsamixer displays, like
2316 .B Master, Line, PCM.
2317 .br
2318 .I NOTE:
2319 ALSA mixer channel names followed by a number must be specified in the
2320 <name,number> format, i.e.\& a channel labeled 'PCM 1' in alsamixer must
2321 be converted to
2322 .BR PCM,1 .
2323 .
2324 .TP
2325 .B \-softvol
2326 Force the use of the software mixer, instead of using the sound card
2327 mixer.
2328 .
2329 .TP
2330 .B \-softvol-max <10.0\-10000.0>
2331 Set the maximum amplification level in percent (default: 110).
2332 A value of 200 will allow you to adjust the volume up to a maximum of
2333 double the current level.
2334 With values below 100 the initial volume (which is 100%) will be above
2335 the maximum, which e.g.\& the OSD cannot display correctly.
2336 .
2337 .TP
2338 .B \-volstep <0\-100>
2339 Set the step size of mixer volume changes in percent of the whole range
2340 (default: 3).
2341 .
2342 .
2343 .
2344 .SH "AUDIO OUTPUT DRIVERS (MPLAYER ONLY)"
2345 Audio output drivers are interfaces to different audio output facilities.
2346 The syntax is:
2347 .
2348 .TP
2349 .B \-ao <driver1[:suboption1[=value]:...],driver2,...[,]>
2350 Specify a priority list of audio output drivers to be used.
2351 .PP
2352 If the list has a trailing ',' MPlayer will fall back on drivers not
2353 contained in the list.
2354 Suboptions are optional and can mostly be omitted.
2355 .br
2356 .I NOTE:
2357 See \-ao help for a list of compiled-in audio output drivers.
2358 .sp 1
2359 .I EXAMPLE:
2360 .PD 0
2361 .RSs
2362 .IPs "\-ao alsa,oss,"
2363 Try the ALSA driver, then the OSS driver, then others.
2364 .IPs "\-ao alsa:noblock:device=hw=0.3"
2365 Sets noblock-mode and the device-name as first card, fourth device.
2366 .RE
2367 .PD 1
2368 .sp 1
2369 Available audio output drivers are:
2370 .
2371 .TP
2372 .B "alsa\ \ \ "
2373 ALSA 0.9/1.x audio output driver
2374 .PD 0
2375 .RSs
2376 .IPs noblock
2377 Sets noblock-mode.
2378 .IPs device=<device>
2379 Sets the device name.
2380 Replace any ',' with '.' and any ':' with '=' in the ALSA device name.
2381 For hwac3 output via S/PDIF, use an "iec958" or "spdif" device, unless
2382 you really know how to set it correctly.
2383 .RE
2384 .PD 1
2385 .
2386 .TP
2387 .B "alsa5\ \ "
2388 ALSA 0.5 audio output driver
2389 .
2390 .TP
2391 .B "oss\ \ \ \ "
2392 OSS audio output driver
2393 .PD 0
2394 .RSs
2395 .IPs <dsp-device>
2396 Sets the audio output device (default: /dev/\:dsp).
2397 .IPs <mixer-device>
2398 Sets the audio mixer device (default: /dev/\:mixer).
2399 .IPs <mixer-channel>
2400 Sets the audio mixer channel (default: pcm).
2401 .RE
2402 .PD 1
2403 .
2404 .TP
2405 .B sdl (SDL only)
2406 highly platform independent SDL (Simple Directmedia Layer) library
2407 audio output driver
2408 .PD 0
2409 .RSs
2410 .IPs <driver>
2411 Explicitly choose the SDL audio driver to use (default: let SDL choose).
2412 .RE
2413 .PD 1
2414 .
2415 .TP
2416 .B "arts\ \ \ "
2417 audio output through the aRts daemon
2418 .
2419 .TP
2420 .B "esd\ \ \ \ "
2421 audio output through the ESD daemon
2422 .PD 0
2423 .RSs
2424 .IPs <server>
2425 Explicitly choose the ESD server to use (default: localhost).
2426 .RE
2427 .PD 1
2428 .
2429 .TP
2430 .B "jack\ \ \ \ "
2431 audio output through JACK (Jack Audio Connection Kit)
2432 .PD 0
2433 .RSs
2434 .IPs port=<name>
2435 Connects to the ports with the given name (default: physical ports).
2436 .IPs name=<client name>
2437 Client name that is passed to JACK (default: MPlayer [<PID>]).
2438 Useful if you want to have certain connections established automatically.
2439 .IPs (no)estimate
2440 Estimate the audio delay, supposed to make the video playback smoother
2441 (default: enabled).
2442 .RE
2443 .PD 1
2444 .
2445 .TP
2446 .B "nas\ \ \ \ "
2447 audio output through NAS
2448 .
2449 .TP
2450 .B macosx (Mac OS X only)
2451 native Mac OS X audio output driver
2452 .
2453 .TP
2454 .B openal
2455 Experimental, unfinished (will downmix to mono) OpenAL audio output driver
2456 .
2457 .TP
2458 .B sgi (SGI only)
2459 native SGI audio output driver
2460 .PD 0
2461 .RSs
2462 .IPs "<output device name>"
2463 Explicitly choose the output device/\:interface to use
2464 (default: system-wide default).
2465 For example, 'Analog Out' or 'Digital Out'.
2466 .RE
2467 .PD 1
2468 .
2469 .TP
2470 .B sun (Sun only)
2471 native Sun audio output driver
2472 .PD 0
2473 .RSs
2474 .IPs <device>
2475 Explicitly choose the audio device to use (default: /dev/\:audio).
2476 .RE
2477 .PD 1
2478 .
2479 .TP
2480 .B win32 (Windows only)
2481 native Windows waveout audio output driver
2482 .
2483 .TP
2484 .B dsound (Windows only)
2485 DirectX DirectSound audio output driver
2486 .PD 0
2487 .RSs
2488 .IPs device=<devicenum>
2489 Sets the device number to use.
2490 Playing a file with \-v will show a list of available devices.
2491 .RE
2492 .PD 1
2493 .
2494 .TP
2495 .B dxr2 (also see \-dxr2) (DXR2 only)
2496 Creative DXR2 specific output driver
2497 .
2498 .TP
2499 .B ivtv (IVTV only)
2500 IVTV specific MPEG audio output driver.
2501 Works with \-ac hwmpa only.
2502 .
2503 .TP
2504 .B mpegpes (DVB only)
2505 Audio output driver for DVB cards that writes the output to an MPEG-PES
2506 file if no DVB card is installed.
2507 .PD 0
2508 .RSs
2509 .IPs card=<1\-4>
2510 DVB card to use if more than one card is present.
2511 .IPs file=<filename>
2512 output filename
2513 .RE
2514 .PD 1
2515 .
2516 .TP
2517 .B "null\ \ \ "
2518 Produces no audio output but maintains video playback speed.
2519 Use \-nosound for benchmarking.
2520 .
2521 .TP
2522 .B "pcm\ \ \ \ "
2523 raw PCM/wave file writer audio output
2524 .PD 0
2525 .RSs
2526 .IPs (no)waveheader
2527 Include or do not include the wave header (default: included).
2528 When not included, raw PCM will be generated.
2529 .IPs file=<filename>
2530 Write the sound to <filename> instead of the default
2531 audiodump.wav.
2532 If nowaveheader is specified, the default is audiodump.pcm.
2533 .IPs "fast\ "
2534 Try to dump faster than realtime.
2535 Make sure the output does not get truncated (usually with
2536 "Too many video packets in buffer" message).
2537 It is normal that you get a "Your system is too SLOW to play this!" message.
2538 .RE
2539 .PD 1
2540 .
2541 .TP
2542 .B "plugin\ \ "
2543 plugin audio output driver
2544 .
2545 .
2546 .
2547 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
2548 .
2549 .TP
2550 .B \-adapter <value>
2551 Set the graphics card that will receive the image.
2552 You can get a list of available cards when you run this option with \-v.
2553 Currently only works with the directx video output driver.
2554 .
2555 .TP
2556 .B \-bpp <depth>
2557 Override the autodetected color depth.
2558 Only supported by the fbdev, dga, svga, vesa video output drivers.
2559 .
2560 .TP
2561 .B \-border
2562 Play movie with window border and decorations.
2563 Since this is on by default, use \-noborder to disable the standard window
2564 decorations.
2565 Supported by the directx video output driver.
2566 .
2567 .TP
2568 .B \-brightness <-100\-100>
2569 Adjust the brightness of the video signal (default: 0).
2570 Not supported by all video output drivers.
2571 .
2572 .TP
2573 .B \-contrast <-100\-100>
2574 Adjust the contrast of the video signal (default: 0).
2575 Not supported by all video output drivers.
2576 .
2577 .TP
2578 .B \-display <name> (X11 only)
2579 Specify the hostname and display number of the X server you want to display
2580 on.
2581 .sp 1
2582 .I EXAMPLE:
2583 .PD 0
2584 .RSs
2585 \-display xtest.localdomain:0
2586 .RE
2587 .PD 1
2588 .
2589 .TP
2590 .B "\-dr \ \ \ "
2591 Turns on direct rendering (not supported by all codecs and video outputs)
2592 .br
2593 .I WARNING:
2594 May cause OSD/SUB corruption!
2595 .
2596 .TP
2597 .B \-dxr2 <option1:option2:...>
2598 This option is used to control the dxr2 video output driver.
2599 .RSs
2600 .IPs ar-mode=<value>
2601 aspect ratio mode (0 = normal, 1 = pan-and-scan, 2 = letterbox (default))
2602 .IPs iec958-encoded
2603 Set iec958 output mode to encoded.
2604 .IPs iec958-decoded
2605 Set iec958 output mode to decoded (default).
2606 .IPs macrovision=<value>
2607 macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe,
2608 3 = agc 4 colorstripe)
2609 .IPs "mute\ "
2610 mute sound output
2611 .IPs unmute
2612 unmute sound output
2613 .IPs ucode=<value>
2614 path to the microcode
2615 .RE
2616 .RS
2617 .sp 1
2618 .I TV output
2619 .RE
2620 .RSs
2621 .IPs 75ire
2622 enable 7.5 IRE output mode
2623 .IPs no75ire
2624 disable 7.5 IRE output mode (default)
2625 .IPs "bw\ \ \ "
2626 b/w TV output
2627 .IPs color
2628 color TV output (default)
2629 .IPs interlaced
2630 interlaced TV output (default)
2631 .IPs nointerlaced
2632 disable interlaced TV output
2633 .IPs norm=<value>
2634 TV norm (ntsc (default), pal, pal60, palm, paln, palnc)
2635 .IPs square-pixel
2636 set pixel mode to square
2637 .IPs ccir601-pixel
2638 set pixel mode to ccir601
2639 .RE
2640 .RS
2641 .sp 1
2642 .I overlay
2643 .RE
2644 .RSs
2645 .IPs cr-left=<0\-500>
2646 Set the left cropping value (default: 50).
2647 .IPs cr-right=<0\-500>
2648 Set the right cropping value (default: 300).
2649 .IPs cr-top=<0\-500>
2650 Set the top cropping value (default: 0).
2651 .IPs cr-bottom=<0\-500>
2652 Set the bottom cropping value (default: 0).
2653 .IPs ck-[r|g|b]=<0\-255>
2654 Set the r(ed), g(reen) or b(lue) gain of the overlay color-key.
2655 .IPs ck-[r|g|b]min=<0\-255>
2656 minimum value for the respective color key
2657 .IPs ck-[r|g|b]max=<0\-255>
2658 maximum value for the respective color key
2659 .IPs ignore-cache
2660 Ignore cached overlay settings.
2661 .IPs update-cache
2662 Update cached overlay settings.
2663 .IPs ol-osd
2664 Enable overlay onscreen display.
2665 .IPs nool-osd
2666 Disable overlay onscreen display (default).
2667 .IPs ol[h|w|x|y]-cor=<-20\-20>
2668 Adjust the overlay size (h,w) and position (x,y) in case it does not
2669 match the window perfectly (default: 0).
2670 .IPs overlay
2671 Activate overlay (default).
2672 .IPs nooverlay
2673 Activate TVout.
2674 .IPs overlay-ratio=<1\-2500>
2675 Tune the overlay (default: 1000).
2676 .RE
2677 .
2678 .TP
2679 .B \-fbmode <modename> (\-vo fbdev only)
2680 Change video mode to the one that is labeled as <modename> in
2681 /etc/\:fb.modes.
2682 .br
2683 .I NOTE:
2684 VESA framebuffer does not support mode changing.
2685 .
2686 .TP
2687 .B \-fbmodeconfig <filename> (\-vo fbdev only)
2688 Override framebuffer mode configuration file (default: /etc/\:fb.modes).
2689 .
2690 .TP
2691 .B \-fs (also see \-zoom)
2692 Fullscreen playback (centers movie, and paints black bands around it).
2693 Not supported by all video output drivers.
2694 .
2695 .TP
2696 .B \-fsmode-dontuse <0\-31> (OBSOLETE, use the \-fs option)
2697 Try this option if you still experience fullscreen problems.
2698 .
2699 .TP
2700 .B \-fstype <type1,type2,...> (X11 only)
2701 Specify a priority list of fullscreen modes to be used.
2702 You can negate the modes by prefixing them with '\-'.
2703 If you experience problems like the fullscreen window being covered
2704 by other windows try using a different order.
2705 .br
2706 .I NOTE:
2707 See \-fstype help for a full list of available modes.
2708 .sp 1
2709 The available types are:
2710 .sp 1
2711 .PD 0
2712 .RSs
2713 .IPs above
2714 Use the _NETWM_STATE_ABOVE hint if available.
2715 .IPs below
2716 Use the _NETWM_STATE_BELOW hint if available.
2717 .IPs fullscreen
2718 Use the _NETWM_STATE_FULLSCREEN hint if available.
2719 .IPs layer
2720 Use the _WIN_LAYER hint with the default layer.
2721 .IPs layer=<0...15>
2722 Use the _WIN_LAYER hint with the given layer number.
2723 .IPs netwm
2724 Force NETWM style.
2725 .IPs "none\ "
2726 Do not set fullscreen window layer.
2727 .IPs stays_on_top
2728 Use _NETWM_STATE_STAYS_ON_TOP hint if available.
2729 .REss
2730 .sp 1
2731 .RS
2732 .I EXAMPLE:
2733 .RE
2734 .PD 0
2735 .RSs
2736 .IPs layer,stays_on_top,above,fullscreen
2737 Default order, will be used as a fallback if incorrect or
2738 unsupported modes are specified.
2739 .IPs \-fullscreen
2740 Fixes fullscreen switching on OpenBox 1.x.
2741 .RE
2742 .PD 1
2743 .
2744 .TP
2745 .B \-geometry x[%][:y[%]] or [WxH][+x+y]
2746 Adjust where the output is on the screen initially.
2747 The x and y specifications are in pixels measured from the top-left of the
2748 screen to the top-left of the image being displayed, however if a percentage
2749 sign is given after the argument it turns the value into a percentage of the
2750 screen size in that direction.
2751 It also supports the standard X11 \-geometry option format.
2752 If an external window is specified using the \-wid option, then the x and
2753 y coordinates are relative to the top-left corner of the window rather
2754 than the screen.
2755 .br
2756 .I NOTE:
2757 This option is only supported by the x11, xmga, xv, xvmc, xvidix,
2758 gl, gl2, directx and tdfxfb video output drivers.
2759 .sp 1
2760 .I EXAMPLE:
2761 .PD 0
2762 .RSs
2763 .IPs 50:40
2764 Places the window at x=50, y=40.
2765 .IPs 50%:50%
2766 Places the window in the middle of the screen.
2767 .IPs "100%\ "
2768 Places the window at the middle of the right edge of the screen.
2769 .IPs 100%:100%
2770 Places the window at the bottom right corner of the screen.
2771 .RE
2772 .PD 1
2773 .
2774 .TP
2775 .B \-guiwid <window ID> (also see \-wid) (GUI only)
2776 This tells the GUI to also use an X11 window and stick itself to the bottom
2777 of the video, which is useful to embed a mini-GUI in a browser (with the
2778 MPlayer plugin for instance).
2779 .
2780 .TP
2781 .B \-hue <-100\-100>
2782 Adjust the hue of the video signal (default: 0).
2783 You can get a colored negative of the image with this option.
2784 Not supported by all video output drivers.
2785 .
2786 .TP
2787 .B \-monitor-dotclock <range[,range,...]> (\-vo fbdev and vesa only)
2788 Specify the dotclock or pixelclock range of the monitor.
2789 .
2790 .TP
2791 .B \-monitor-hfreq <range[,range,...]> (\-vo fbdev and vesa only)
2792 Specify the horizontal frequency range of the monitor.
2793 .
2794 .TP
2795 .B \-monitor-vfreq <range[,range,...]> (\-vo fbdev and vesa only)
2796 Specify the vertical frequency range of the monitor.
2797 .
2798 .TP
2799 .B \-monitoraspect <ratio> (also see \-aspect)
2800 Set the aspect ratio of your monitor or TV screen.
2801 .sp 1
2802 .I EXAMPLE:
2803 .PD 0
2804 .RSs
2805 \-monitoraspect 4:3  or 1.3333
2806 .br
2807 \-monitoraspect 16:9 or 1.7777
2808 .RE
2809 .PD 1
2810 .
2811 .TP
2812 .B \-monitorpixelaspect <ratio> (also see \-aspect)
2813 Set the aspect of a single pixel of your monitor or TV screen (default: disabled).
2814 Overrides the \-monitoraspect setting.
2815 A value of 0 disables, a value of 1 means square pixels
2816 (correct for (almost?) all LCDs).
2817 .
2818 .TP
2819 .B \-nodouble
2820 Disables double buffering, mostly for debugging purposes.
2821 Double buffering fixes flicker by storing two frames in memory, and
2822 displaying one while decoding another.
2823 It can affect OSD negatively, but often removes OSD flickering.
2824 .
2825 .TP
2826 .B \-nograbpointer
2827 Do not grab the mouse pointer after a video mode change (\-vm).
2828 Useful for multihead setups.
2829 .
2830 .TP
2831 .B \-nokeepaspect
2832 Do not keep window aspect ratio when resizing windows.
2833 Only works with the x11, xv, xmga, xvidix, directx video output drivers.
2834 Furthermore under X11 your window manager has to honor window aspect hints.
2835 .
2836 .TP
2837 .B "\-ontop\ "
2838 Makes the player window stay on top of other windows.
2839 Supported by video output drivers which use X11, except SDL,
2840 as well as directx, macosx, quartz, ggi and gl2.
2841 .
2842 .TP
2843 .B \-panscan <0.0\-1.0>
2844 Enables pan-and-scan functionality (cropping the sides of e.g.\& a 16:9
2845 movie to make it fit a 4:3 display without black bands).
2846 The range controls how much of the image is cropped.
2847 Only works with the xv, xmga, mga, gl, gl2, quartz, macosx and xvidix
2848 video output drivers.
2849 .
2850 .TP
2851 .B \-panscanrange <-19.0\-99.0> (experimental)
2852 Change the range of the pan-and-scan functionality (default: 1).
2853 Positive values mean multiples of the default range.
2854 Negative numbers mean you can zoom in up to a factor of \-panscanrange+1.
2855 E.g. \-panscanrange -3 allows a zoom factor of up to 4.
2856 This feature is experimental.
2857 Do not report bugs unless you are using \-vo gl.
2858 .
2859 .TP
2860 .B \-refreshrate <Hz>
2861 Set the monitor refreshrate in Hz.
2862 Currently only supported by \-vo directx combined with the \-vm option.
2863 .
2864 .TP
2865 .B \-rootwin
2866 Play movie in the root window (desktop background).
2867 Desktop background images may cover the movie window, though.
2868 Only works with the x11, xv, xmga, xvidix, quartz, macosx and directx video output drivers.
2869 .
2870 .TP
2871 .B \-saturation <-100\-100>
2872 Adjust the saturation of the video signal (default: 0).
2873 You can get grayscale output with this option.
2874 Not supported by all video output drivers.
2875 .
2876 .TP
2877 .B \-screenh <pixels>
2878 Specify the vertical screen resolution for video output drivers which
2879 do not know the screen resolution like fbdev, x11 and TVout.
2880 .
2881 .TP
2882 .B \-screenw <pixels>
2883 Specify the horizontal screen resolution for video output drivers which
2884 do not know the screen resolution like fbdev, x11 and TVout.
2885 .
2886 .TP
2887 .B \-stop-xscreensaver (X11 only)
2888 Turns off xscreensaver at startup and turns it on again on exit.
2889 .
2890 .TP
2891 .B "\-vm \ \ \ "
2892 Try to change to a different video mode.
2893 Supported by the dga, x11, xv, sdl and directx video output drivers.
2894 If used with the directx video output driver the \-screenw,
2895 \-screenh, \-bpp and \-refreshrate options can be used to set
2896 the new display mode.
2897 .
2898 .TP
2899 .B "\-vsync \ \ "
2900 Enables VBI for the vesa, dfbmga and svga video output drivers.
2901 .
2902 .TP
2903 .B \-wid <window ID> (also see \-guiwid) (X11, OpenGL and DirectX only)
2904 This tells MPlayer to attach to an existing window.
2905 Useful to embed MPlayer in a browser (e.g.\& the plugger extension).
2906 .
2907 .TP
2908 .B \-xineramascreen <\-2\-...> (X11 only)
2909 In Xinerama configurations (i.e.\& a single desktop that spans across multiple
2910 displays) this option tells MPlayer which screen to display the movie on.
2911 A value of \-2 means fullscreen across the whole virtual display, \-1 means
2912 fullscreen on the display the window currently is on.
2913 The initial position set via the \-geometry option is relative to the
2914 specified screen.
2915 Will usually only work with "\-fstype \-fullscreen" or "\-fstype none".
2916 .
2917 .TP
2918 .B \-zrbw (\-vo zr only)
2919 Display in black and white.
2920 For optimal performance, this can be combined with '\-lavdopts gray'.
2921 .
2922 .TP
2923 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only)
2924 Select a part of the input image to display, multiple occurrences
2925 of this option switch on cinerama mode.
2926 In cinerama mode the movie is distributed over more than one TV
2927 (or beamer) to create a larger image.
2928 Options appearing after the n-th \-zrcrop apply to the n-th MJPEG card, each
2929 card should at least have a \-zrdev in addition to the \-zrcrop.
2930 For examples, see the output of \-zrhelp and the Zr section of the
2931 documentation.
2932 .
2933 .TP
2934 .B \-zrdev <device> (\-vo zr only)
2935 Specify the device special file that belongs to your MJPEG card, by default
2936 the zr video output driver takes the first v4l device it can find.
2937 .
2938 .TP
2939 .B \-zrfd (\-vo zr only)
2940 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only
2941 happens if the hardware scaler can stretch the image to its original size.
2942 Use this option to force decimation.
2943 .
2944 .TP
2945 .B \-zrhdec <1|2|4> (\-vo zr only)
2946 Horizontal decimation: Ask the driver to send only every 2nd or 4th
2947 line/\:pixel of the input image to the MJPEG card and use the scaler
2948 of the MJPEG card to stretch the image to its original size.
2949 .
2950 .TP
2951 .B \-zrhelp (\-vo zr only)
2952 Display a list of all \-zr* options, their default values and a
2953 cinerama mode example.
2954 .
2955 .TP
2956 .B \-zrnorm <norm> (\-vo zr only)
2957 Specify the TV norm as PAL or NTSC (default: no change).
2958 .
2959 .TP
2960 .B \-zrquality <1\-20> (\-vo zr only)
2961 A number from 1 (best) to 20 (worst) representing the JPEG encoding quality.
2962 .
2963 .TP
2964 .B \-zrvdec <1|2|4> (\-vo zr only)
2965 Vertical decimation: Ask the driver to send only every 2nd or 4th
2966 line/\:pixel of the input image to the MJPEG card and use the scaler
2967 of the MJPEG card to stretch the image to its original size.
2968 .
2969 .TP
2970 .B \-zrxdoff <x display offset> (\-vo zr only)
2971 If the movie is smaller than the TV screen, this option specifies the x
2972 offset from the upper-left corner of the TV screen (default: centered).
2973 .
2974 .TP
2975 .B \-zrydoff <y display offset> (\-vo zr only)
2976 If the movie is smaller than the TV screen, this option specifies the y
2977 offset from the upper-left corner of the TV screen (default: centered).
2978 .
2979 .
2980 .
2981 .SH "VIDEO OUTPUT DRIVERS (MPLAYER ONLY)"
2982 Video output drivers are interfaces to different video output facilities.
2983 The syntax is:
2984 .
2985 .TP
2986 .B \-vo <driver1[:suboption1[=value]:...],driver2,...[,]>
2987 Specify a priority list of video output drivers to be used.
2988 .PP
2989 If the list has a trailing ',' MPlayer will fall back on drivers not
2990 contained in the list.
2991 Suboptions are optional and can mostly be omitted.
2992 .br
2993 .I NOTE:
2994 See \-vo help for a list of compiled-in video output drivers.
2995 .sp 1
2996 .I EXAMPLE:
2997 .PD 0
2998 .RSs
2999 .IPs "\-vo xmga,xv,"
3000 Try the Matrox X11 driver, then the Xv driver, then others.
3001 .IPs "\-vo directx:noaccel"
3002 Uses the DirectX driver with acceleration features turned off.
3003 .RE
3004 .PD 1
3005 .sp 1
3006 Available video output drivers are:
3007 .
3008 .TP
3009 .B xv (X11 only)
3010 Uses the XVideo extension of XFree86 4.x to enable hardware
3011 accelerated playback.
3012 If you cannot use a hardware specific driver, this is probably
3013 the best option.
3014 For information about what colorkey is used and how it is drawn run MPlayer
3015 with \-v option and look out for the lines tagged with [xv common] at the
3016 beginning.
3017 .PD 0
3018 .RSs
3019 .IPs port=<number>
3020 Select a specific XVideo port.
3021 .IPs ck=<cur|use|set>
3022 Select the source from which the colorkey is taken (default: cur).
3023 .RSss
3024 .IPs cur
3025 The default takes the colorkey currently set in Xv.
3026 .IPs use
3027 Use but do not set the colorkey from MPlayer (use \-colorkey option to change
3028 it).
3029 .IPs set
3030 Same as use but also sets the supplied colorkey.
3031 .RE
3032 .IPs ck-method=<man|bg|auto>
3033 Sets the colorkey drawing method (default: man).
3034 .RSss
3035 .IPs man
3036 Draw the colorkey manually (reduces flicker in some cases).
3037 .IPs bg
3038 Set the colorkey as window background.
3039 .IPs auto
3040 Let Xv draw the colorkey.
3041 .RE
3042 .RE
3043 .PD 1
3044 .
3045 .TP
3046 .B x11 (X11 only)
3047 Shared memory video output driver without hardware acceleration that
3048 works whenever X11 is present.
3049 .
3050 .TP
3051 .B xover (X11 only)
3052 Adds X11 support to all overlay based video output drivers.
3053 Currently only supported by tdfx_vid.
3054 .PD 0
3055 .RSs
3056 .IPs <vo_driver>
3057 Select the driver to use as source to overlay on top of X11.
3058 .RE
3059 .PD 1
3060 .
3061 .TP
3062 .B xvmc (X11 with \-vc ffmpeg12mc only)
3063 Video output driver that uses the XvMC (X Video Motion Compensation)
3064 extension of XFree86 4.x to speed up MPEG-1/2 and VCR2 decoding.
3065 .PD 0
3066 .RSs
3067 .IPs port=<number>
3068 Select a specific XVideo port.
3069 .IPs (no)benchmark
3070 Disables image display.
3071 Necessary for proper benchmarking of drivers that change
3072 image buffers on monitor retrace only (nVidia).
3073 Default is not to disable image display (nobenchmark).
3074 .IPs (no)bobdeint
3075 Very simple deinterlacer.
3076 Might not look better than \-vf tfields=1,
3077 but it is the only deinterlacer for xvmc (default: nobobdeint).
3078 .IPs (no)queue
3079 Queue frames for display to allow more parallel work of the video hardware.
3080 May add a small (not noticeable) constant A/V desync (default: noqueue).
3081 .IPs (no)sleep
3082 Use sleep function while waiting for rendering to finish
3083 (not recommended on Linux) (default: nosleep).
3084 .IPs ck=cur|use|set
3085 Same as \-vo xv:ck (see \-vo xv).
3086 .IPs ck-method=man|bg|auto
3087 Same as \-vo xv:ck-method (see \-vo xv).
3088 .RE
3089 .PD 1
3090 .
3091 .TP
3092 .B dga (X11 only)
3093 Play video through the XFree86 Direct Graphics Access extension.
3094 Considered obsolete.
3095 .
3096 .TP
3097 .B sdl (SDL only)
3098 Highly platform independent SDL (Simple Directmedia Layer) library
3099 video output driver.
3100 Since SDL uses its own X11 layer, MPlayer X11 options do not have
3101 any effect on SDL.
3102 .PD 0
3103 .RSs
3104 .IPs driver=<driver>
3105 Explicitly choose the SDL driver to use.
3106 .IPs (no)forcexv
3107 Use XVideo through the sdl video output driver (default: forcexv).
3108 .IPs (no)hwaccel
3109 Use hardware accelerated scaler (default: hwaccel).
3110 .RE
3111 .PD 1
3112 .
3113 .TP
3114 .B "vidix\ \ "
3115 VIDIX (VIDeo Interface for *niX) is an interface to the
3116 video acceleration features of different graphics cards.
3117 Very fast video output driver on cards that support it.
3118 .PD 0
3119 .RSs
3120 .IPs <subdevice>
3121 Explicitly choose the VIDIX subdevice driver to use.
3122 Available subdevice drivers are cyberblade_vid.so, mach64_vid.so,
3123 mga_crtc2_vid.so, mga_vid.so, nvidia_vid.so, pm3_vid.so,
3124 radeon_vid.so, rage128_vid.so, sis_vid.so and unichrome_vid.so.
3125 .RE
3126 .PD 1
3127 .
3128 .TP
3129 .B xvidix (X11 only)
3130 X11 frontend for VIDIX
3131 .PD 0
3132 .RSs
3133 .IPs <subdevice>
3134 same as vidix
3135 .RE
3136 .PD 1
3137 .
3138 .TP
3139 .B "cvidix\ "
3140 Generic and platform independent VIDIX frontend, can even run in a
3141 text console with nVidia cards.
3142 .PD 0
3143 .RSs
3144 .IPs <subdevice>
3145 same as vidix
3146 .RE
3147 .PD 1
3148 .
3149 .TP
3150 .B winvidix (Windows only)
3151 Windows frontend for VIDIX
3152 .PD 0
3153 .RSs
3154 .IPs <subdevice>
3155 same as vidix
3156 .RE
3157 .PD 1
3158 .
3159 .TP
3160 .B directx (Windows only)
3161 Video output driver that uses the DirectX interface.
3162 .PD 0
3163 .RSs
3164 .IPs noaccel
3165 Turns off hardware acceleration.
3166 Try this option if you have display problems.
3167 .RE
3168 .PD 1
3169 .
3170 .TP
3171 .B quartz (Mac OS X only)
3172 Mac OS X Quartz video output driver.
3173 Under some circumstances, it might be more efficient to force a
3174 packed YUV output format, with e.g.\& \-vf format=yuy2.
3175 .PD 0
3176 .RSs
3177 .IPs device_id=<number>
3178 Choose the display device to use in fullscreen.
3179 .IPs fs_res=<width>:<height>
3180 Specify the fullscreen resolution (useful on slow systems).
3181 .RE
3182 .PD 1
3183 .
3184 .TP
3185 .B macosx (Mac OS X 10.4 or 10.3.9 with QuickTime 7)
3186 Mac OS X CoreVideo video output driver
3187 .PD 0
3188 .RSs
3189 .IPs device_id=<number>
3190 Choose the display device to use in fullscreen.
3191 .RE
3192 .PD 1
3193 .
3194 .TP
3195 .B fbdev (Linux only)
3196 Uses the kernel framebuffer to play video.
3197 .PD 0
3198 .RSs
3199 .IPs <device>
3200 Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
3201 name of the VIDIX subdevice if the device name starts with 'vidix'
3202 (e.g.\& 'vidixsis_vid' for the sis driver).
3203 .RE
3204 .PD 1
3205 .
3206 .TP
3207 .B fbdev2 (Linux only)
3208 Uses the kernel framebuffer to play video,
3209 alternative implementation.
3210 .PD 0
3211 .RSs
3212 .IPs <device>
3213 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
3214 .RE
3215 .PD 1
3216 .
3217 .TP
3218 .B "vesa\ \ \ "
3219 Very general video output driver that should work on any VESA VBE 2.0
3220 compatible card.
3221 .PD 0
3222 .RSs
3223 .IPs "dga\ \ "
3224 Turns on DGA mode.
3225 .IPs nodga
3226 Turns off DGA mode.
3227 .IPs neotv_pal
3228 Activate the NeoMagic TV out and set it to PAL norm.
3229 .IPs neotv_ntsc
3230 Activate the NeoMagic TV out and set it to NTSC norm.
3231 .IPs vidix
3232 Use the VIDIX driver.
3233 .IPs "lvo:\ \ \ "
3234 Activate the Linux Video Overlay on top of VESA mode.
3235 .RE
3236 .PD 1
3237 .
3238 .TP
3239 .B "svga\ \ \ "
3240 Play video using the SVGA library.
3241 .PD 0
3242 .RSs
3243 .IPs "<video mode>"
3244 Specify video mode to use.
3245 The mode can be given in a <width>x<height>x<colors> format,
3246 e.g.\& 640x480x16M or be a graphics mode number, e.g.\& 84.
3247 .IPs bbosd
3248 Draw OSD into black bands below the movie (slower).
3249 .IPs native
3250 Use only native drawing functions.
3251 This avoids direct rendering, OSD and hardware acceleration.
3252 .IPs retrace
3253 Force frame switch on vertical retrace.
3254 Usable only with \-double.
3255 It has the same effect as the \-vsync option.
3256 .IPs "sq\ \ \ "
3257 Try to select a video mode with square pixels.
3258 .IPs vidix
3259 Use svga with VIDIX.
3260 .RE
3261 .PD 1
3262 .
3263 .TP
3264 .B "gl\ \ \ \ \ "
3265 OpenGL video output driver, simple version.
3266 Video size must be smaller than
3267 the maximum texture size of your OpenGL implementation.
3268 Intended to work even with the most basic OpenGL implementations,
3269 but also makes use of newer extensions, which allow support for more
3270 colorspaces and direct rendering.
3271 Please use \-dr if it works with your OpenGL implementation,
3272 since for higher resolutions this provides a
3273 .B big
3274 speedup.
3275 The code performs very few checks, so if a feature does not work, this
3276 might be because it is not supported by your card/OpenGL implementation
3277 even if you do not get any error message.
3278 Use glxinfo or a similar tool to display the supported OpenGL extensions.
3279 .PD 0
3280 .RSs
3281 .IPs (no)manyfmts
3282 Enables support for more (RGB and BGR) color formats (default: enabled).
3283 Needs OpenGL version >= 1.2.
3284 .IPs slice-height=<0\-...>
3285 Number of lines copied to texture in one piece (default: 4).
3286 0 for whole image.
3287 .br
3288 .I NOTE:
3289 If YUV colorspace is used (see yuv suboption), special rules apply:
3290 .RSss
3291 If the decoder uses slice rendering (see \-noslices), this setting
3292 has no effect, the size of the slices as provided by the decoder is used.
3293 .br
3294 If the decoder does not use slice rendering, the default is 16.
3295 .RE
3296 .IPs (no)osd
3297 Enable or disable support for OSD rendering via OpenGL (default: enabled).
3298 This option is for testing; to disable the OSD use \-osdlevel 0 instead.
3299 .IPs (no)scaled-osd
3300 Changes the way the OSD behaves when the size of the
3301 window changes (default: disabled).
3302 When enabled behaves more like the other video output drivers,
3303 which is better for fixed-size fonts.
3304 Disabled looks much better with FreeType fonts and uses the
3305 borders in fullscreen mode.
3306 Does not work correctly with ass subtitles (see \-ass).
3307 .IPs osdcolor=<0xRRGGBB>
3308 Color for OSD (default: 0xffffff, corresponds to white).
3309 .IPs (no)aspect
3310 Enable or disable aspect scaling and pan-and-scan support (default: enabled).
3311 Disabling might increase speed.
3312 .IPs rectangle=<0,1,2>
3313 Select usage of rectangular textures which saves video RAM, but often is
3314 slower (default: 0).
3315 .RSss
3316 0: Use power-of-two textures (default).
3317 .br
3318 1: Use the GL_ARB_texture_rectangle extension.
3319 .br
3320 2: Use the GL_ARB_texture_non_power_of_two extension.
3321 In some cases only supported in software and thus very slow.
3322 .RE
3323 .IPs (no)glfinish
3324 Call glFinish() before swapping buffers.
3325 Slower but in some cases more correct output (default: disabled).
3326 .IPs swapinterval=<n>
3327 Minimum interval between two buffer swaps, counted in
3328 displayed frames (default: 1).
3329 1 is equivalent to enabling VSYNC, 0 to disabling VSYNC.
3330 Values below 0 will leave it at the system default.
3331 This limits the framerate to (horizontal refresh rate / n).
3332 Requires GLX_SGI_swap_control support to work.
3333 With some (most/all?) implementations this only works in fullscreen mode.
3334 .IPs yuv=<n>
3335 Select the type of YUV to RGB conversion.
3336 .RSss
3337 0: Use software conversion (default).
3338 Compatible with all OpenGL versions.
3339 Provides brightness, contrast and saturation control.
3340 .br
3341 1: Use register combiners.
3342 This uses an nVidia-specific extension (GL_NV_register_combiners).
3343 At least three texture units are needed.
3344 Provides saturation and hue control.
3345 This method is fast but inexact.
3346 .br
3347 2: Use a fragment program.
3348 Needs the GL_ARB_fragment_program extension and at least three texture units.
3349 Provides brightness, contrast, saturation and hue control.
3350 .br
3351 3: Use a fragment program using the POW instruction.
3352 Needs the GL_ARB_fragment_program extension and at least three texture units.
3353 Provides brightness, contrast, saturation, hue and gamma control.
3354 Gamma can also be set independently for red, green and blue.
3355 Method 4 is usually faster.
3356 .br
3357 4: Use a fragment program with additional lookup.
3358 Needs the GL_ARB_fragment_program extension and at least four texture units.
3359 Provides brightness, contrast, saturation, hue and gamma control.
3360 Gamma can also be set independently for red, green and blue.
3361 .br
3362 5: Use ATI-specific method (for older cards).
3363 This uses an ATI-specific extension (GL_ATI_fragment_shader - not
3364 GL_ARB_fragment_shader!).
3365 At least three texture units are needed.
3366 Provides saturation and hue control.
3367 This method is fast but inexact.
3368 .br
3369 6: Use a 3D texture to do conversion via lookup.
3370 Needs the GL_ARB_fragment_program extension and at least four texture units.
3371 Extremely slow (software emulation) on some (all?) ATI cards since it uses
3372 a texture with border pixels.
3373 Provides brightness, contrast, saturation, hue and gamma control.
3374 Gamma can also be set independently for red, green and blue.
3375 Speed depends more on GPU memory bandwidth than other methods.
3376 .RE
3377 .IPs lscale=<n>
3378 Select the scaling function to use for luminance scaling.
3379 Only valid for yuv modes 2, 3, 4 and 6.
3380 .RSss
3381 0: Use simple linear filtering (default).
3382 .br
3383 1: Use bicubic filtering (better quality).
3384 Needs one additional texture unit.
3385 Older cards will not be able to handle this for chroma at least in fullscreen mode.
3386 .RE
3387 .IPs cscale=<n>
3388 Select the scaling function to use for chrominance scaling.
3389 For details see lscale.
3390 .IPs customprog=<filename>
3391 Load a custom fragment program from <filename>.
3392 See TOOLS/edgedect.fp for an example.
3393 .IPs customtex=<filename>
3394 Load a custom "gamma ramp" texture from <filename>.
3395 This can be used in combination with yuv=4 or with the customprog option.
3396 .IPs (no)customtlin
3397 If enabled (default) use GL_LINEAR interpolation, otherwise use GL_NEAREST
3398 for customtex texture.
3399 .IPs (no)customtrect
3400 If enabled, use texture_rectangle for customtex texture.
3401 Default is disabled.
3402 .REss
3403 .RE
3404 .PD 1
3405 .
3406 .TP
3407 .B "gl2\ \ \ \ "
3408 OpenGL video output driver, second generation.
3409 Supports OSD and videos larger than the maximum texture size.
3410 .PD 0
3411 .RSs
3412 .IPs (no)glfinish
3413 same as gl (default: enabled)
3414 .IPs yuv=<n>
3415 Select the type of YUV to RGB conversion.
3416 If set to anything except 0 OSD will be disabled and brightness, contrast and
3417 gamma setting is only available via the global X server settings.
3418 Apart from this the values have the same meaning as for \-vo gl.
3419 .REss
3420 .
3421 .TP
3422 .B "null\ \ \ "
3423 Produces no video output.
3424 Useful for benchmarking.
3425 .
3426 .TP
3427 .B "aa\ \ \ \ \ "
3428 ASCII art video output driver that works on a text console.
3429 You can get a list and an explanation of available suboptions executing
3430 .I mplayer \-vo aa:help
3431 .
3432 .TP
3433 .B "caca\ \ \ "
3434 Color ASCII art video output driver that works on a text console.
3435 .
3436 .TP
3437 .B "bl\ \ \ \ \ "
3438 Video playback using the Blinkenlights UDP protocol.
3439 This driver is highly hardware specific.
3440 .PD 0
3441 .RSs
3442 .IPs <subdevice>
3443 Explicitly choose the Blinkenlights subdevice driver to use.
3444 It is something like arcade:host=localhost:2323 or
3445 hdl:file=name1,file=name2.
3446 You must specify a subdevice.
3447 .RE
3448 .PD 1
3449 .
3450 .TP
3451 .B "ggi\ \ \ \ "
3452 GGI graphics system video output driver
3453 .PD 0
3454 .RSs
3455 .IPs <driver>
3456 Explicitly choose the GGI driver to use.
3457 Replace any ',' that would appear in the driver string by a '.'.
3458 .RE
3459 .PD 1
3460 .
3461 .TP
3462 .B directfb
3463 Play video using the DirectFB library.
3464 .PD 0
3465 .RSs
3466 .IPs (no)input
3467 Use the DirectFB instead of the MPlayer keyboard code (default: enabled).
3468 .IPs buffermode=single|double|triple
3469 Double and triple buffering give best results if you want to avoid tearing issues.
3470 Triple buffering is more efficient than double buffering as it does
3471 not block MPlayer while waiting for the vertical retrace.
3472 Single buffering should be avoided (default: single).
3473 .IPs fieldparity=top|bottom
3474 Control the output order for interlaced frames (default: disabled).
3475 Valid values are top = top fields first, bottom = bottom fields first.
3476 This option does not have any effect on progressive film material
3477 like most MPEG movies are.
3478 You need to enable this option if you have tearing issues or unsmooth
3479 motions watching interlaced film material.
3480 .IPs layer=N
3481 Will force layer with ID N for playback (default: -1 - auto).
3482 .IPs dfbopts=<list>
3483 Specify a parameter list for DirectFB.
3484 .RE
3485 .PD 1
3486 .
3487 .TP
3488 .B "dfbmga\ "
3489 Matrox G400/\:G450/\:G550 specific video output driver that uses the
3490 DirectFB library to make use of special hardware features.
3491 Enables CRTC2 (second head), displaying video independently of the first head.
3492 .PD 0
3493 .RSs
3494 .IPs (no)input
3495 same as directfb (default: disabled)
3496 .IPs buffermode=single|double|triple
3497 same as directfb (default: triple)
3498 .IPs fieldparity=top|bottom
3499 same as directfb
3500 .IPs (no)bes
3501 Enable the use of the Matrox BES (backend scaler) (default: disabled).
3502 Gives very good results concerning speed and output quality as interpolated
3503 picture processing is done in hardware.
3504 Works only on the primary head.
3505 .IPs (no)spic
3506 Make use of the Matrox sub picture layer to display the OSD (default: enabled).
3507 .IPs (no)crtc2
3508 Turn on TV-out on the second head (default: enabled).
3509 The output quality is amazing as it is a full interlaced picture
3510 with proper sync to every odd/\:even field.
3511 .IPs tvnorm=pal|ntsc|auto
3512 Will set the TV norm of the Matrox card without the need
3513 for modifying /etc/\:directfbrc (default: disabled).
3514 Valid norms are pal = PAL, ntsc = NTSC.
3515 Special norm is auto (auto-adjust using PAL/\:NTSC) because it decides
3516 which norm to use by looking at the framerate of the movie.
3517 .RE
3518 .PD 1
3519 .
3520 .TP
3521 .B mga (Linux only)
3522 Matrox specific video output driver that makes use of the YUV back
3523 end scaler on Gxxx cards through a kernel module.
3524 If you have a Matrox card, this is the fastest option.
3525 .PD 0
3526 .RSs
3527 .IPs <device>
3528 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
3529 .RE
3530 .PD 1
3531 .
3532 .TP
3533 .B xmga (Linux, X11 only)
3534 The mga video output driver, running in an X11 window.
3535 .PD 0
3536 .RSs
3537 .IPs <device>
3538 Explicitly choose the Matrox device name to use (default: /dev/\:mga_vid).
3539 .RE
3540 .PD 1
3541 .
3542 .TP
3543 .B "syncfb\ "
3544 Video output driver for the SyncFB kernel module, which provides
3545 special hardware features of Matrox Gxxx cards like hardware
3546 deinterlacing, scaling and synchronizing your video output to
3547 the vertical retrace of your monitor.
3548 .
3549 .TP
3550 .B 3dfx (Linux only)
3551 3dfx specific video output driver.
3552 This driver directly uses the 3dfx hardware on top of X11.
3553 Only 16 bpp are supported.
3554 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
3555 .
3556 .TP
3557 .B tdfxfb (Linux only)
3558 This driver employs the tdfx framebuffer driver to play movies with
3559 YUV acceleration on 3dfx cards.
3560 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
3561 .PD 0
3562 .RSs
3563 .IPs <device>
3564 Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
3565 .RE
3566 .PD 1
3567 .
3568 .TP
3569 .B tdfx_vid (Linux only)
3570 3dfx specific video output driver.
3571 This driver directly uses the tdfx_vid kernel module.
3572 FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
3573 .PD 0
3574 .RSs
3575 .IPs <device>
3576 Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
3577 .RE
3578 .PD 1
3579 .
3580 .TP
3581 .B dxr2 (also see \-dxr2) (DXR2 only)
3582 Creative DXR2 specific video output driver.
3583 .PD 0
3584 .RSs
3585 .IPs <vo_driver>
3586 Output video subdriver to use as overlay (x11, xv).
3587 .RE
3588 .PD 1
3589 .
3590 .TP
3591 .B dxr3 (DXR3 only)
3592 Sigma Designs em8300 MPEG decoder chip (Creative DXR3, Sigma Designs
3593 Hollywood Plus) specific video output driver.
3594 Also see the lavc video filter.
3595 .PD 0
3596 .RSs
3597 .IPs overlay
3598 Activates the overlay instead of TVOut.
3599 .IPs prebuf
3600 Turns on prebuffering.
3601 .IPs "sync\ "
3602 Will turn on the new sync-engine.
3603 .IPs norm=<norm>
3604 Specifies the TV norm.
3605 .RSss
3606 0: Does not change current norm (default).
3607 .br
3608 1: Auto-adjust using PAL/\:NTSC.
3609 .br
3610 2: Auto-adjust using PAL/\:PAL-60.
3611 .br
3612 3: PAL
3613 .br
3614 4: PAL-60
3615 .br
3616 5: NTSC
3617 .REss
3618 .IPs <0\-3>
3619 Specifies the device number to use if you have more than one em8300 card.
3620 .RE
3621 .PD 1
3622 .
3623 .TP
3624 .B ivtv (IVTV only)
3625 Conexant CX23415 (iCompression iTVC15) or Conexant CX23416 (iCompression
3626 iTVC16) MPEG decoder chip (Hauppauge WinTV PVR-150/250/350/500)
3627 specific video output driver for TV-Out.
3628 Also see the lavc video filter.
3629 .PD 0
3630 .RSs
3631 .IPs device
3632 Explicitly choose the MPEG decoder device name to use (default: /dev/video16).
3633 .IPs output
3634 Explicitly choose the TV-Out output to be used for the video signal.
3635 .RE
3636 .PD 1
3637 .
3638 .TP
3639 .B mpegpes (DVB only)
3640 Video output driver for DVB cards that writes the output to an MPEG-PES file
3641 if no DVB card is installed.
3642 .PD 0
3643 .RSs
3644 .IPs card=<1\-4>
3645 Specifies the device number to use if you have more than one DVB output card
3646 (V3 API only, such as 1.x.y series drivers).
3647 .IPs <filename>
3648 output filename (default: ./grab.mpg)
3649 .RE
3650 .PD 1
3651 .
3652 .TP
3653 .B zr (also see \-zr* and \-zrhelp)
3654 Video output driver for a number of MJPEG capture/\:playback cards.
3655 .
3656 .TP
3657 .B zr2 (also see the zrmjpeg video filter)
3658 Video output driver for a number of MJPEG capture/\:playback cards,
3659 second generation.
3660 .PD 0
3661 .RSs
3662 .IPs dev=<device>
3663 Specifies the video device to use.
3664 .IPs norm=<PAL|NTSC|SECAM|auto>
3665 Specifies the video norm to use (default: auto).
3666 .IPs (no)prebuf
3667 (De)Activate prebuffering, not yet supported.
3668 .RE
3669 .PD 1
3670 .
3671 .TP
3672 .B "md5sum\ "
3673 Calculate MD5 sums of each frame and write them to a file.
3674 Supports RGB24 and YV12 colorspaces.
3675 Useful for debugging.
3676 .PD 0
3677 .RSs
3678 .IPs outfile=<value>
3679 Specify the output filename (default: ./md5sums).
3680 .RE
3681 .PD 1
3682 .
3683 .TP
3684 .B yuv4mpeg
3685 Transforms the video stream into a sequence of uncompressed YUV 4:2:0
3686 images and stores it in a file (default: ./stream.yuv).
3687 The format is the same as the one employed by mjpegtools, so this is
3688 useful if you want to process the video with the mjpegtools suite.
3689 It supports the YV12, RGB (24 bpp) and BGR (24 bpp) format.
3690 You can combine it with the \-fixed-vo option to concatenate files
3691 with the same dimensions and fps value.
3692 .PD 0
3693 .RSs
3694 .IPs interlaced
3695 Write the output as interlaced frames, top field first.
3696 .IPs interlaced_bf
3697 Write the output as interlaced frames, bottom field first.
3698 .IPs file=<filename>
3699 Write the output to <filename> instead of the default stream.yuv.
3700 .REss
3701 .PD 1
3702 .RS
3703 .sp 1
3704 .I NOTE:
3705 If you do not specify any option the output is progressive
3706 (i.e.\& not interlaced).
3707 .RE
3708 .
3709 .TP
3710 .B "gif89a\ "
3711 Output each frame into a single animated GIF file in the current directory.
3712 It supports only RGB format with 24 bpp and the output is converted to 256
3713 colors.
3714 .PD 0
3715 .RSs
3716 .IPs <fps>
3717 Float value to specify framerate (default: 5.0).
3718 .IPs <filename>
3719 Specify the output filename (default: ./out.gif).
3720 .REss
3721 .PD 1
3722 .RS
3723 .sp 1
3724 .I NOTE:
3725 You must specify the framerate before the filename or the framerate will
3726 be part of the filename.
3727 .sp 1
3728 .I EXAMPLE:
3729 .RE
3730 .PD 0
3731 .RSs
3732 mplayer video.nut \-vo gif89a:fps=15.0:filename=test.gif
3733 .RE
3734 .PD 1
3735 .
3736 .TP
3737 .B "jpeg\ \ \ "
3738 Output each frame into a JPEG file in the current directory.
3739 Each file takes the frame number padded with leading zeros as name.
3740 .PD 0
3741 .RSs
3742 .IPs [no]progressive
3743 Specify standard or progressive JPEG (default: noprogressive).
3744 .IPs [no]baseline
3745 Specify use of baseline or not (default: baseline).
3746 .IPs optimize=<0\-100>
3747 optimization factor (default: 100)
3748 .IPs smooth=<0\-100>
3749 smooth factor (default: 0)
3750 .IPs quality=<0\-100>
3751 quality factor (default: 75)
3752 .IPs outdir=<dirname>
3753 Specify the directory to save the JPEG files to (default: ./).
3754 .IPs subdirs=<prefix>
3755 Create numbered subdirectories with the specified prefix to
3756 save the files in instead of the current directory.
3757 .IPs maxfiles=<value> (subdirs only)
3758 Maximum number of files to be saved per subdirectory.
3759 Must be equal to or larger than 1 (default: 1000).
3760 .RE
3761 .PD 1
3762 .
3763 .TP
3764 .B "pnm\ \ \ \ "
3765 Output each frame into a PNM file in the current directory.
3766 Each file takes the frame number padded with leading zeros as name.
3767 It supports PPM, PGM and PGMYUV files in both raw and ASCII mode.
3768 Also see pnm(5), ppm(5) and pgm(5).
3769 .PD 0
3770 .RSs
3771 .IPs "ppm\ \ "
3772 Write PPM files (default).
3773 .IPs "pgm\ \ "
3774 Write PGM files.
3775 .IPs pgmyuv
3776 Write PGMYUV files.
3777 PGMYUV is like PGM, but it also contains the U and V plane, appended at the
3778 bottom of the picture.
3779 .IPs "raw\ \ "
3780 Write PNM files in raw mode (default).
3781 .IPs ascii
3782 Write PNM files in ASCII mode.
3783 .IPs outdir=<dirname>
3784 Specify the directory to save the PNM files to (default: ./).
3785 .IPs subdirs=<prefix>
3786 Create numbered subdirectories with the specified prefix to
3787 save the files in instead of the current directory.
3788 .IPs maxfiles=<value> (subdirs only)
3789 Maximum number of files to be saved per subdirectory.
3790 Must be equal to or larger than 1 (default: 1000).
3791 .RE
3792 .PD 1
3793 .
3794 .TP
3795 .B "png\ \ \ \ "
3796 Output each frame into a PNG file in the current directory.
3797 Each file takes the frame number padded with leading zeros as name.
3798 24bpp RGB and BGR formats are supported.
3799 .PD 0
3800 .RSs
3801 .IPs z=<0-9>
3802 Specifies the compression level.
3803 0 is no compression, 9 is maximum compression.
3804 .RE
3805 .PD 1
3806 .
3807 .TP
3808 .B "tga\ \ \ \ "
3809 Output each frame into a Targa file in the current directory.
3810 Each file takes the frame number padded with leading zeros as name.
3811 The purpose of this video output driver is to have a simple lossless
3812 image writer to use without any external library.
3813 It supports the BGR[A] color format, with 15, 24 and 32 bpp.
3814 You can force a particular format with the format video filter.
3815 .sp 1
3816 .I EXAMPLE:
3817 .RE
3818 .PD 0
3819 .RSs
3820 mplayer video.nut \-vf format=bgr15 \-vo tga
3821 .RE
3822 .PD 1
3823 .
3824 .
3825 .
3826 .SH "DECODING/FILTERING OPTIONS"
3827 .
3828 .TP
3829 .B \-ac <[-|+]codec1,[-|+]codec2,...[,]>
3830 Specify a priority list of audio codecs to be used, according to their codec
3831 name in codecs.conf.
3832 Use a '-' before the codec name to omit it.
3833 Use a '+' before the codec name to force it, this will likely crash!
3834 If the list has a trailing ',' MPlayer will fall back on codecs not
3835 contained in the list.
3836 .br
3837 .I NOTE:
3838 See \-ac help for a full list of available codecs.
3839 .sp 1
3840 .I EXAMPLE:
3841 .PD 0
3842 .RSs
3843 .IPs "\-ac mp3acm"
3844 Force the l3codeca.acm MP3 codec.
3845 .IPs "\-ac mad,"
3846 Try libmad first, then fall back on others.
3847 .IPs "\-ac hwac3,a52,"
3848 Try hardware AC3 passthrough, software AC3, then others.
3849 .IPs "\-ac hwdts,"
3850 Try hardware DTS passthrough, then fall back on others.
3851 .IPs "\-ac -ffmp3,"
3852 Skip FFmpeg's MP3 decoder.
3853 .RE
3854 .PD 1
3855 .
3856 .TP
3857 .B \-af-adv <force=(0\-7):list=(filters)> (also see \-af)
3858 Specify advanced audio filter options:
3859 .RSs
3860 .IPs force=<0\-7>
3861 Forces the insertion of audio filters to one of the following:
3862 .RSss
3863 0: Use completely automatic filter insertion.
3864 .br
3865 1: Optimize for accuracy (default).
3866 .br
3867 2: Optimize for speed.
3868 .I Warning:
3869 Some features in the audio filters may silently fail,
3870 and the sound quality may drop.
3871 .br
3872 3: Use no automatic insertion of filters and no optimization.
3873 .I Warning:
3874 It may be possible to crash MPlayer using this setting.
3875 .br
3876 4: Use automatic insertion of filters according to 0 above,
3877 but use floating point processing when possible.
3878 .br
3879 5: Use automatic insertion of filters according to 1 above,
3880 but use floating point processing when possible.
3881 .br
3882 6: Use automatic insertion of filters according to 2 above,
3883 but use floating point processing when possible.
3884 .br
3885 7: Use no automatic insertion of filters according to 3 above,
3886 and use floating point processing when possible.
3887 .REss
3888 .IPs list=<filters>
3889 Same as \-af.
3890 .RE
3891 .
3892 .TP
3893 .B \-afm <driver1,driver2,...>
3894 Specify a priority list of audio codec families to be used, according
3895 to their codec name in codecs.conf.
3896 Falls back on the default codecs if none of the given codec families work.
3897 .br
3898 .I NOTE:
3899 See \-afm help for a full list of available codec families.
3900 .sp 1
3901 .I EXAMPLE:
3902 .PD 0
3903 .RSs
3904 .IPs "\-afm ffmpeg"
3905 Try FFmpeg's libavcodec codecs first.
3906 .IPs "\-afm acm,dshow"
3907 Try Win32 codecs first.
3908 .RE
3909 .PD 1
3910 .
3911 .TP
3912 .B \-aspect <ratio> (also see \-zoom)
3913 Override movie aspect ratio, in case aspect information is
3914 incorrect or missing in the file being played.
3915 .sp 1
3916 .I EXAMPLE:
3917 .PD 0
3918 .RSs
3919 \-aspect 4:3  or \-aspect 1.3333
3920 .br
3921 \-aspect 16:9 or \-aspect 1.7777
3922 .RE
3923 .PD 1
3924 .
3925 .TP
3926 .B \-noaspect
3927 Disable automatic movie aspect ratio compensation.
3928 .
3929 .TP
3930 .B "\-flip \ "
3931 Flip image upside-down.
3932 .
3933 .TP
3934 .B \-lavdopts <option1:option2:...> (DEBUG CODE)
3935 Specify libavcodec decoding parameters.
3936 Separate multiple options with a colon.
3937 .sp 1
3938 .I EXAMPLE:
3939 .PD 0
3940 .RSs
3941 \-lavdopts gray:skiploopfilter=all:skipframe=nonref
3942 .RE
3943 .PD 1
3944 .sp 1
3945 .RS
3946 Available options are:
3947 .RE
3948 .RSs
3949 .IPs bitexact
3950 Only use bit-exact algorithms in all decoding steps (for codec testing).
3951 .IPs bug=<value>
3952 Manually work around encoder bugs.
3953 .RSss
3954 0: nothing
3955 .br
3956 1: autodetect bugs (default)
3957 .br
3958 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetection)
3959 .br
3960 4 (mpeg4): Xvid interlacing bug (autodetected if fourcc==XVIX)
3961 .br
3962 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4)
3963 .br
3964 16 (mpeg4): padding bug (autodetected)
3965 .br
3966 32 (mpeg4): illegal vlc bug (autodetected per fourcc)
3967 .br
3968 64 (mpeg4): Xvid and DivX qpel bug (autodetected per fourcc/\:version)
3969 .br
3970 128 (mpeg4): old standard qpel (autodetected per fourcc/\:version)
3971 .br
3972 256 (mpeg4): another qpel bug (autodetected per fourcc/\:version)
3973 .br
3974 512 (mpeg4): direct-qpel-blocksize bug (autodetected per fourcc/\:version)
3975 .br
3976 1024 (mpeg4): edge padding bug (autodetected per fourcc/\:version)
3977 .REss
3978 .IPs debug=<value>
3979 Display debugging information.
3980 .RSss
3981 .br
3982 0: disabled
3983 .br
3984 1: picture info
3985 .br
3986 2: rate control
3987 .br
3988 4: bitstream
3989 .br
3990 8: macroblock (MB) type
3991 .br
3992 16: per-block quantization parameter (QP)
3993 .br
3994 32: motion vector
3995 .br
3996 0x0040: motion vector visualization (use \-noslices)
3997 .br
3998 0x0080: macroblock (MB) skip
3999 .br
4000 0x0100: startcode
4001 .br
4002 0x0200: PTS
4003 .br
4004 0x0400: error resilience
4005 .br
4006 0x0800: memory management control operations (H.264)
4007 .br
4008 0x1000: bugs
4009 .br
4010 0x2000: Visualize quantization parameter (QP), lower QP are tinted greener.
4011 .br
4012 0x4000: Visualize block types.
4013 .REss
4014 .IPs ec=<value>
4015 Set error concealment strategy.
4016 .RSss
4017 1: Use strong deblock filter for damaged MBs.
4018 .br
4019 2: iterative motion vector (MV) search (slow)
4020 .br
4021 3: all (default)
4022 .REss
4023 .IPs er=<value>
4024 Set error resilience strategy.
4025 .RSss
4026 .br
4027 0: disabled
4028 .br
4029 1: careful (Should work with broken encoders.)
4030 .br
4031 2: normal (default) (Works with compliant encoders.)
4032 .br
4033 3: aggressive (More checks, but might cause problems even for valid bitstreams.)
4034 .br
4035 4: very aggressive
4036 .REss
4037 .IPs "fast (MPEG-2 only)"
4038 Enable optimizations which do not comply to the specification and might
4039 potentially cause problems, like simpler dequantization, assuming use
4040 of the default quantization matrix, assuming YUV 4:2:0 and skipping a few
4041 checks to detect damaged bitstreams.
4042 .IPs "gray\ "
4043 grayscale only decoding (a bit faster than with color)
4044 .IPs "idct=<0\-99> (see \-lavcopts)"
4045 For best decoding quality use the same IDCT algorithm for decoding and encoding.
4046 This may come at a price in accuracy, though.
4047 .IPs lowres=<number>[,<w>]
4048 Decode at lower resolutions.
4049 Low resolution decoding is not supported by all codecs, and it will
4050 often result in ugly artifacts.
4051 This is not a bug, but a side effect of not decoding at full resolution.
4052 .RSss
4053 .br
4054 0: disabled
4055 .br
4056 1: 1/2 resolution
4057 .br
4058 2: 1/4 resolution
4059 .br
4060 3: 1/8 resolution
4061 .REss
4062 .RS
4063 If <w> is specified lowres decoding will be used only if the width of the
4064 video is major than or equal to <w>.
4065 .RE
4066 .IPs "sb=<number> (MPEG-2 only)"
4067 Skip the given number of macroblock rows at the bottom.
4068 .IPs "st=<number> (MPEG-2 only)"
4069 Skip the given number of macroblock rows at the top.
4070 .IPs skiploopfilter=<skipvalue> (H.264 only)
4071 Skips the loop filter (AKA deblocking) during H.264 decoding.
4072 Since the filtered frame is supposed to be used as reference
4073 for decoding dependent frames this has a worse effect on quality
4074 than not doing deblocking on e.g.\& MPEG-2 video.
4075 But at least for high bitrate HDTV this provides a big speedup with
4076 no visible quality loss.
4077 .sp 1
4078 <skipvalue> can be either one of the following:
4079 .RSss
4080 .br
4081 none: Never skip.
4082 .br
4083 default: Skip useless processing steps (e.g.\& 0 size packets in AVI).
4084 .br
4085 nonref: Skip frames that are not referenced (i.e.\& not used for
4086 decoding other frames, the error cannot "build up").
4087 .br
4088 bidir: Skip B-Frames.
4089 .br
4090 nonkey: Skip all frames except keyframes.
4091 .br
4092 all: Skip all frames.
4093 .REss
4094 .IPs skipidct=<skipvalue> (MPEG1/2 only)
4095 Skips the IDCT step.
4096 This degrades quality a lot of in almost all cases
4097 (see skiploopfilter for available skip values).
4098 .IPs skipframe=<skipvalue>
4099 Skips decoding of frames completely.
4100 Big speedup, but jerky motion and sometimes bad artifacts
4101 (see skiploopfilter for available skip values).
4102 .IPs threads=<1\-8>
4103 number of threads to use for decoding (default: 1)
4104 .IPs vismv=<value>
4105 Visualize motion vectors.
4106 .RSss
4107 .br
4108 0: disabled
4109 .br
4110 1: Visualize forward predicted MVs of P-frames.
4111 .br
4112 2: Visualize forward predicted MVs of B-frames.
4113 .br
4114 4: Visualize backward predicted MVs of B-frames.
4115 .REss
4116 .IPs vstats
4117 Prints some statistics and stores them in ./vstats_*.log.
4118 .RE
4119 .
4120 .TP
4121 .B \-noslices
4122 Disable drawing video by 16-pixel height slices/\:bands, instead draws the
4123 whole frame in a single run.
4124 May be faster or slower, depending on video card and available cache.
4125 It has effect only with libmpeg2 and libavcodec codecs.
4126 .
4127 .TP
4128 .B \-nosound
4129 Do not play/\:encode sound.
4130 Useful for benchmarking.
4131 .
4132 .TP
4133 .B \-novideo
4134 Do not play/\:encode video.
4135 In many cases this will not work, use \-vc null \-vo null instead.
4136 .
4137 .TP
4138 .B \-pp <quality> (also see \-vf pp)
4139 Set the DLL postprocess level.
4140 This option is no longer usable with \-vf pp.
4141 It only works with Win32 DirectShow DLLs with internal postprocessing routines.
4142 The valid range of \-pp values varies by codec, it is mostly
4143 0\-6, where 0=disable, 6=slowest/\:best.
4144 .
4145 .TP
4146 .B \-pphelp (also see \-vf pp)
4147 Show a summary about the available postprocess filters and their usage.
4148 .
4149 .TP
4150 .B \-ssf <mode>
4151 Specifies software scaler parameters.
4152 .sp 1
4153 .I EXAMPLE:
4154 .PD 0
4155 .RSs
4156 \-vf scale \-ssf lgb=3.0
4157 .RE
4158 .PD 1
4159 .PD 0
4160 .RSs
4161 .IPs lgb=<0\-100>
4162 gaussian blur filter (luma)
4163 .IPs cgb=<0\-100>
4164 gaussian blur filter (chroma)
4165 .IPs ls=<-100\-100>
4166 sharpen filter (luma)
4167 .IPs cs=<-100\-100>
4168 sharpen filter (chroma)
4169 .IPs chs=<h>
4170 chroma horizontal shifting
4171 .IPs cvs=<v>
4172 chroma vertical shifting
4173 .RE
4174 .PD 1
4175 .
4176 .TP
4177 .B \-stereo <mode>
4178 Select type of MP2/\:MP3 stereo output.
4179 .PD 0
4180 .RSs
4181 .IPs 0
4182 stereo
4183 .IPs 1
4184 left channel
4185 .IPs 2
4186 right channel
4187 .RE
4188 .PD 1
4189 .
4190 .TP
4191 .B \-sws <software scaler type> (also see \-vf scale and \-zoom)
4192 Specify the software scaler algorithm to be used with the \-zoom option.
4193 This affects video output drivers which lack hardware acceleration, e.g.\& x11.
4194 .sp 1
4195 Available types are:
4196 .sp 1
4197 .PD 0
4198 .RSs
4199 .IPs 0
4200 fast bilinear
4201 .IPs 1
4202 bilinear
4203 .IPs 2
4204 bicubic (good quality) (default)
4205 .IPs 3
4206 experimental
4207 .IPs 4
4208 nearest neighbor (bad quality)
4209 .IPs 5
4210 area
4211 .IPs 6
4212 luma bicubic / chroma bilinear
4213 .IPs 7
4214 gauss
4215 .IPs 8
4216 sincR
4217 .IPs 9
4218 lanczos
4219 .IPs 10
4220 natural bicubic spline
4221 .RE
4222 .PD 1
4223 .sp 1
4224 .RS
4225 .I NOTE:
4226 Some \-sws options are tunable.
4227 The description of the scale video filter has further information.
4228 .RE
4229 .
4230 .TP
4231 .B \-vc <[-|+]codec1,[-|+]codec2,...[,]>
4232 Specify a priority list of video codecs to be used, according to their codec
4233 name in codecs.conf.
4234 Use a '-' before the codec name to omit it.
4235 Use a '+' before the codec name to force it, this will likely crash!
4236 If the list has a trailing ',' MPlayer will fall back on codecs not
4237 contained in the list.
4238 .br
4239 .I NOTE:
4240 See \-vc help for a full list of available codecs.
4241 .sp 1
4242 .I EXAMPLE:
4243 .PD 0
4244 .RSs
4245 .IPs "\-vc divx"
4246 Force Win32/\:VfW DivX codec, no fallback.
4247 .IPs "\-vc -divxds,-divx,"
4248 Skip Win32 DivX codecs.
4249 .IPs "\-vc ffmpeg12,mpeg12,"
4250 Try libavcodec's MPEG-1/2 codec, then libmpeg2, then others.
4251 .RE
4252 .PD 1
4253 .
4254 .TP
4255 .B \-vfm <driver1,driver2,...>
4256 Specify a priority list of video codec families to be used, according
4257 to their names in codecs.conf.
4258 Falls back on the default codecs if none of the given codec families work.
4259 .br
4260 .I NOTE:
4261 See \-vfm help for a full list of available codec families.
4262 .sp 1
4263 .I EXAMPLE:
4264 .PD 0
4265 .RSs
4266 .IPs "\-vfm ffmpeg,dshow,vfw"
4267 Try the libavcodec, then Directshow, then VfW codecs and fall back
4268 on others, if they do not work.
4269 .IPs "\-vfm xanim"
4270 Try XAnim codecs first.
4271 .RE
4272 .PD 1
4273 .
4274 .TP
4275 .B \-x <x> (also see \-zoom) (MPlayer only)
4276 Scale image to width <x> (if software/\:hardware scaling is available).
4277 Disables aspect calculations.
4278 .
4279 .TP
4280 .B \-xvidopts <option1:option2:...>
4281 Specify additional parameters when decoding with Xvid.
4282 .br
4283 .I NOTE:
4284 Since libavcodec is faster than Xvid you might want to use the libavcodec
4285 postprocessing filter (\-vf pp) and decoder (\-vfm ffmpeg) instead.
4286 .sp 1
4287 Xvid's internal postprocessing filters:
4288 .PD 0
4289 .RSs
4290 .IPs deblock-chroma (also see \-vf pp)
4291 chroma deblock filter
4292 .IPs deblock-luma (also see \-vf pp)
4293 luma deblock filter
4294 .IPs dering-luma (also see \-vf pp)
4295 luma deringing filter
4296 .IPs dering-chroma (also see \-vf pp)
4297 chroma deringing filter
4298 .IPs filmeffect (also see \-vf noise)
4299 Adds artificial film grain to the video.
4300 May increase perceived quality, while lowering true quality.
4301 .RE
4302 .sp 1
4303 .RS
4304 rendering methods:
4305 .RE
4306 .PD 0
4307 .RSs
4308 .IPs "dr2\ \ "
4309 Activate direct rendering method 2.
4310 .IPs nodr2
4311 Deactivate direct rendering method 2.
4312 .RE
4313 .PD 1
4314 .
4315 .TP
4316 .B \-xy <value> (also see \-zoom)
4317 .PD 0
4318 .RSs
4319 .IPs value<=8
4320 Scale image by factor <value>.
4321 .IPs value>8
4322 Set width to value and calculate height to keep correct aspect ratio.
4323 .RE
4324 .PD 1
4325 .
4326 .TP
4327 .B \-y <y> (also see \-zoom) (MPlayer only)
4328 Scale image to height <y> (if software/\:hardware scaling is available).
4329 Disables aspect calculations.
4330 .
4331 .TP
4332 .B "\-zoom\ \ "
4333 Allow software scaling, where available.
4334 This will allow scaling with output drivers (like x11, fbdev) that
4335 do not support hardware scaling where MPlayer disables scaling by
4336 default for performance reasons.
4337 .
4338 .
4339 .
4340 .SH "AUDIO FILTERS"
4341 Audio filters allow you to modify the audio stream and its properties.
4342 The syntax is:
4343 .
4344 .TP
4345 .B \-af <filter1[=parameter1:parameter2:...],filter2,...>
4346 Setup a chain of audio filters.
4347 .PP
4348 .I NOTE:
4349 To get a full list of available audio filters, see \-af help.
4350 .PP
4351 Available filters are:
4352 .
4353 .TP
4354 .B resample[=srate[:sloppy[:type]]]
4355 Changes the sample rate of the audio stream.
4356 Can be used if you have a fixed frequency sound card or if you are
4357 stuck with an old sound card that is only capable of max 44.1kHz.
4358 This filter is automatically enabled if necessary.
4359 It only supports 16-bit integer and float in native-endian format as input.
4360 .br
4361 .I NOTE:
4362 With MEncoder, you need to also use \-srate <srate>.
4363 .PD 0
4364 .RSs
4365 .IPs <srate>
4366 output sample frequency in Hz.
4367 The valid range for this parameter is 8000 to 192000.
4368 If the input and output sample frequency are the same or if this
4369 parameter is omitted the filter is automatically unloaded.
4370 A high sample frequency normally improves the audio quality,
4371 especially when used in combination with other filters.
4372 .IPs <sloppy>
4373 Allow (1) or disallow (0) the output frequency to differ slightly
4374 from the frequency given by <srate> (default: 1).
4375 Can be used if the startup of the playback is extremely slow.
4376 .IPs <type>
4377 Selects which resampling method to use.
4378 .RSss
4379 0: linear interpolation (fast, poor quality especially when upsampling)
4380 .br
4381 1: polyphase filterbank and integer processing
4382 .br
4383 2: polyphase filterbank and floating point processing (slow, best quality)
4384 .REss
4385 .PD 1
4386 .RE
4387 .sp 1
4388 .RS
4389 .I EXAMPLE:
4390 .RE
4391 .PD 0
4392 .RSs
4393 .IPs "mplayer \-af resample=44100:0:0"
4394 would set the output frequency of the resample filter to 44100Hz using
4395 exact output frequency scaling and linear interpolation.
4396 .RE
4397 .PD 1
4398 .
4399 .TP
4400 .B lavcresample[=srate[:length[:linear[:count[:cutoff]]]]]
4401 Changes the sample rate of the audio stream to an integer <srate> in Hz.
4402 It only supports the 16-bit native-endian format.
4403 .br
4404 .I NOTE:
4405 With MEncoder, you need to also use \-srate <srate>.
4406 .PD 0
4407 .RSs
4408 .IPs <srate>
4409 the output sample rate
4410 .IPs <length>
4411 length of the filter with respect to the lower sampling rate (default: 16)
4412 .IPs <linear>
4413 if 1 then filters will be linearly interpolated between polyphase entries
4414 .IPs <count>
4415 log2 of the number of polyphase entries
4416 (..., 10->1024, 11->2048, 12->4096, ...)
4417 (default: 10->1024)
4418 .IPs <cutoff>
4419 cutoff frequency (0.0-1.0), default set depending upon filter length
4420 .RE
4421 .PD 1
4422 .
4423 .TP
4424 .B sweep[=speed]
4425 Produces a sine sweep.
4426 .PD 0
4427 .RSs
4428 .IPs <0.0\-1.0>
4429 Sine function delta, use very low values to hear the sweep.
4430 .RE
4431 .PD 1
4432 .
4433 .TP
4434 .B sinesuppress[=freq:decay]
4435 Remove a sine at the specified frequency.
4436 Useful to get rid of the 50/60Hz noise on low quality audio equipment.
4437 It probably only works on mono input.
4438 .PD 0
4439 .RSs
4440 .IPs <freq>
4441 The frequency of the sine which should be removed (in Hz) (default: 50)
4442 .IPs <decay>
4443 Controls the adaptivity (a larger value will make the filter adapt to
4444 amplitude and phase changes quicker, a smaller value will make the
4445 adaptation slower) (default: 0.0001).
4446 Reasonable values are around 0.001.
4447 .RE
4448 .PD 1
4449 .
4450 .TP
4451 .B hrtf[=flag]
4452 Head-related transfer function: Converts multichannel audio to
4453 2 channel output for headphones, preserving the spatiality of the sound.
4454 .sp 1
4455 .PD 0
4456 .RS
4457 .IPs "Flag  Meaning"
4458 .IPs "m     matrix decoding of the rear channel"
4459 .IPs "s     2-channel matrix decoding"
4460 .IPs "0     no matrix decoding (default)"
4461 .RE
4462 .PD 1
4463 .
4464 .TP
4465 .B equalizer=[g1:g2:g3:...:g10]
4466 10 octave band graphic equalizer, implemented using 10 IIR band pass filters.
4467 This means that it works regardless of what type of audio is being played back.
4468 The center frequencies for the 10 bands are:
4469 .sp 1
4470 .PD 0
4471 .RS
4472 .IPs "No. frequency"
4473 .IPs "0    31.25 Hz"
4474 .IPs "1    62.50 Hz"
4475 .IPs "2   125.00 Hz"
4476 .IPs "3   250.00 Hz"
4477 .IPs "4   500.00 Hz"
4478 .IPs "5    1.00 kHz"
4479 .IPs "6    2.00 kHz"
4480 .IPs "7    4.00 kHz"
4481 .IPs "8    8.00 kHz"
4482 .IPs "9   16.00 kHz"
4483 .RE
4484 .PD 1
4485 .sp 1
4486 .RS
4487 If the sample rate of the sound being played is lower than the center
4488 frequency for a frequency band, then that band will be disabled.
4489 A known bug with this filter is that the characteristics for the
4490 uppermost band are not completely symmetric if the sample
4491 rate is close to the center frequency of that band.
4492 This problem can be worked around by upsampling the sound
4493 using the resample filter before it reaches this filter.
4494 .RE
4495 .PD 0
4496 .RSs
4497 .IPs <g1>:<g2>:<g3>:...:<g10>
4498 floating point numbers representing the gain in dB
4499 for each frequency band (-12\-12)
4500 .RE
4501 .sp 1
4502 .RS
4503 .I EXAMPLE:
4504 .RE
4505 .RSs
4506 .IPs "mplayer \-af equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi"
4507 Would amplify the sound in the upper and lower frequency region
4508 while canceling it almost completely around 1kHz.
4509 .RE
4510 .PD 1
4511 .
4512 .TP
4513 .B channels=nch[:nr:from1:to1:from2:to2:from3:to3:...]
4514 Can be used for adding, removing, routing and copying audio channels.
4515 If only <nch> is given the default routing is used, it works as
4516 follows: If the number of output channels is bigger than the number of
4517 input channels empty channels are inserted (except mixing from mono to
4518 stereo, then the mono channel is repeated in both of the output
4519 channels).
4520 If the number of output channels is smaller than the number
4521 of input channels the exceeding channels are truncated.
4522 .PD 0
4523 .RSs
4524 .IPs <nch>
4525 number of output channels (1\-6)
4526 .IPs "<nr>\ "
4527 number of routes (1\-6)
4528 .IPs <from1:to1:from2:to2:from3:to3:...>
4529 Pairs of numbers between 0 and 5 that define where to route each channel.
4530 .RE
4531 .sp 1
4532 .RS
4533 .I EXAMPLE:
4534 .RE
4535 .RSs
4536 .IPs "mplayer \-af channels=4:4:0:1:1:0:2:2:3:3 media.avi"
4537 Would change the number of channels to 4 and set up 4 routes that
4538 swap channel 0 and channel 1 and leave channel 2 and 3 intact.
4539 Observe that if media containing two channels was played back, channels
4540 2 and 3 would contain silence but 0 and 1 would still be swapped.
4541 .IPs "mplayer \-af channels=6:4:0:0:0:1:0:2:0:3 media.avi"
4542 Would change the number of channels to 6 and set up 4 routes
4543 that copy channel 0 to channels 0 to 3.
4544 Channel 4 and 5 will contain silence.
4545 .RE
4546 .PD 1
4547 .
4548 .TP
4549 .B format[=format] (also see \-format)
4550 Convert between different sample formats.
4551 Automatically enabled when needed by the sound card or another filter.
4552 .PD 0
4553 .RSs
4554 .IPs <format>
4555 Sets the desired format.
4556 The general form is 'sbe', where 's' denotes the sign (either 's' for signed
4557 or 'u' for unsigned), 'b' denotes the number of bits per sample (16, 24 or 32)
4558 and 'e' denotes the endianness ('le' means little-endian, 'be' big-endian
4559 and 'ne' the endianness of the computer MPlayer is running on).
4560 Valid values (amongst others) are: 's16le', 'u32be' and 'u24ne'.
4561 Exceptions to this rule that are also valid format specifiers: u8, s8,
4562 floatle, floatbe, floatne, mulaw, alaw, mpeg2, ac3 and imaadpcm.
4563 .RE
4564 .PD 1
4565 .
4566 .TP
4567 .B volume[=v[:sc]]
4568 Implements software volume control.
4569 Use this filter with caution since it can reduce the signal
4570 to noise ratio of the sound.
4571 In most cases it is best to set the level for the PCM sound to max,
4572 leave this filter out and control the output level to your
4573 speakers with the master volume control of the mixer.
4574 In case your sound card has a digital PCM mixer instead of an analog
4575 one, and you hear distortion, use the MASTER mixer instead.
4576 If there is an external amplifier connected to the computer (this
4577 is almost always the case), the noise level can be minimized by
4578 adjusting the master level and the volume knob on the amplifier
4579 until the hissing noise in the background is gone.
4580 .br
4581 This filter has a second feature: It measures the overall maximum
4582 sound level and prints out that level when MPlayer exits.
4583 This volume estimate can be used for setting the sound level in
4584 MEncoder such that the maximum dynamic range is utilized.
4585 .br
4586 .I NOTE:
4587 This filter is not reentrant and can therefore only be enabled
4588 once for every audio stream.
4589 .PD 0
4590 .RSs
4591 .IPs "<v>\ \ "
4592 Sets the desired gain in dB for all channels in the stream
4593 from -200dB to +60dB, where -200dB mutes the sound
4594 completely and +60dB equals a gain of 1000 (default: 0).
4595 .IPs "<sc>\ "
4596 Turns soft clipping on (1) or off (0).
4597 Soft-clipping can make the sound more smooth if very
4598 high volume levels are used.
4599 Enable this option if the dynamic range of the
4600 loudspeakers is very low.
4601 .br
4602 .I WARNING:
4603 This feature creates distortion and should be considered a last resort.
4604 .RE
4605 .sp 1
4606 .RS
4607 .I EXAMPLE:
4608 .RE
4609 .RSs
4610 .IPs "mplayer \-af volume=10.1:0 media.avi"
4611 Would amplify the sound by 10.1dB and hard-clip if the
4612 sound level is too high.
4613 .RE
4614 .PD 1
4615 .
4616 .TP
4617 .B pan=n[:L00:L01:L02:...L10:L11:L12:...Ln0:Ln1:Ln2:...]
4618 Mixes channels arbitrarily.
4619 Basically a combination of the volume and the channels filter
4620 that can be used to down-mix many channels to only a few,
4621 e.g.\& stereo to mono or vary the "width" of the center
4622 speaker in a surround sound system.
4623 This filter is hard to use, and will require some tinkering
4624 before the desired result is obtained.
4625 The number of options for this filter depends on
4626 the number of output channels.
4627 An example how to downmix a six-channel file to two channels with
4628 this filter can be found in the examples section near the end.
4629 .PD 0
4630 .RSs
4631 .IPs "<n>\ \ "
4632 number of output channels (1\-6)
4633 .IPs <Lij>
4634 How much of input channel i is mixed into output channel j (0\-1).
4635 So in principle you first have n numbers saying what to do with the
4636 first input channel, then n numbers that act on the second input channel
4637 etc.
4638 If you do not specify any numbers for some input channels, 0 is assumed.
4639 .RE
4640 .sp 1
4641 .RS
4642 .I EXAMPLE:
4643 .RE
4644 .RSs
4645 .IPs "mplayer \-af pan=1:0.5:0.5 media.avi"
4646 Would down-mix from stereo to mono.
4647 .IPs "mplayer \-af pan=3:1:0:0.5:0:1:0.5 media.avi"
4648 Would give 3 channel output leaving channels 0 and 1 intact,
4649 and mix channels 0 and 1 into output channel 2 (which could
4650 be sent to a subwoofer for example).
4651 .RE
4652 .PD 1
4653 .
4654 .TP
4655 .B sub[=fc:ch]
4656 Adds a subwoofer channel to the audio stream.
4657 The audio data used for creating the subwoofer channel is
4658 an average of the sound in channel 0 and channel 1.
4659 The resulting sound is then low-pass filtered by a 4th order
4660 Butterworth filter with a default cutoff frequency of 60Hz
4661 and added to a separate channel in the audio stream.
4662 .br
4663 .I Warning:
4664 Disable this filter when you are playing DVDs with Dolby
4665 Digital 5.1 sound, otherwise this filter will disrupt
4666 the sound to the subwoofer.
4667 .PD 0
4668 .RSs
4669 .IPs "<fc>\ "
4670 cutoff frequency in Hz for the low-pass filter (20Hz to 300Hz) (default: 60Hz)
4671 For the best result try setting the cutoff frequency as low as possible.
4672 This will improve the stereo or surround sound experience.
4673 .IPs "<ch>\ "
4674 Determines the channel number in which to insert the sub-channel audio.
4675 Channel number can be between 0 and 5 (default: 5).
4676 Observe that the number of channels will automatically
4677 be increased to <ch> if necessary.
4678 .RE
4679 .sp 1
4680 .RS
4681 .I EXAMPLE:
4682 .RE
4683 .RSs
4684 .IPs "mplayer \-af sub=100:4 \-channels 5 media.avi"
4685 Would add a sub-woofer channel with a cutoff frequency of
4686 100Hz to output channel 4.
4687 .RE
4688 .PD 1
4689 .
4690 .TP
4691 .B "center\ "
4692 Creates a center channel from the front channels.
4693 May currently be low quality as it does not implement a
4694 high-pass filter for proper extraction yet, but averages and
4695 halves the channels instead.
4696 .PD 0
4697 .RSs
4698 .IPs "<ch>\ "
4699 Determines the channel number in which to insert the center channel.
4700 Channel number can be between 0 and 5 (default: 5).
4701 Observe that the number of channels will automatically
4702 be increased to <ch> if necessary.
4703 .RE
4704 .PD 1
4705 .
4706 .TP
4707 .B surround[=delay]
4708 Decoder for matrix encoded surround sound like Dolby Surround.
4709 Many files with 2 channel audio actually contain matrixed surround sound.
4710 Requires a sound card supporting at least 4 channels.
4711 .PD 0
4712 .RSs
4713 .IPs <delay>
4714 delay time in ms for the rear speakers (0 to 1000) (default: 20)
4715 This delay should be set as follows: If d1 is the distance
4716 from the listening position to the front speakers and d2 is the distance
4717 from the listening position to the rear speakers, then the delay should
4718 be set to 15ms if d1 <= d2 and to 15 + 5*(d1-d2) if d1 > d2.
4719 .RE
4720 .sp 1
4721 .RS
4722 .I EXAMPLE:
4723 .RE
4724 .RSs
4725 .IPs "mplayer \-af surround=15 \-channels 4 media.avi"
4726 Would add surround sound decoding with 15ms delay for the sound to the
4727 rear speakers.
4728 .RE
4729 .PD 1
4730 .
4731 .TP
4732 .B delay[=ch1:ch2:...]
4733 Delays the sound to the loudspeakers such that the sound from the
4734 different channels arrives at the listening position simultaneously.
4735 It is only useful if you have more than 2 loudspeakers.
4736 .PD 0
4737 .RSs
4738 .IPs ch1,ch2,...
4739 The delay in ms that should be imposed on each channel
4740 (floating point number between 0 and 1000).
4741 .RE
4742 .PD 1
4743 .sp 1
4744 .RS
4745 To calculate the required delay for the different channels do as follows:
4746 .IP 1. 3
4747 Measure the distance to the loudspeakers in meters in relation
4748 to your listening position, giving you the distances s1 to s5
4749 (for a 5.1 system).
4750 There is no point in compensating for the subwoofer (you will not hear the
4751 difference anyway).
4752 .IP 2. 3
4753 Subtract the distances s1 to s5 from the maximum distance,
4754 i.e.\& s[i] = max(s) - s[i]; i = 1...5.
4755 .IP 3.
4756 Calculate the required delays in ms as d[i] = 1000*s[i]/342; i = 1...5.
4757 .RE
4758 .PD 0
4759 .sp 1
4760 .RS
4761 .I EXAMPLE:
4762 .RE
4763 .RSs
4764 .IPs "mplayer \-af delay=10.5:10.5:0:0:7:0 media.avi"
4765 Would delay front left and right by 10.5ms, the two rear channels
4766 and the sub by 0ms and the center channel by 7ms.
4767 .RE
4768 .PD 1
4769 .
4770 .TP
4771 .B export[=mmapped_file[:nsamples]]
4772 Exports the incoming signal to other processes using memory mapping (mmap()).
4773 Memory mapped areas contain a header:
4774 .sp 1
4775 .nf
4776 int nch                      /*number of channels*/
4777 int size                     /*buffer size*/
4778 unsigned long long counter   /*Used to keep sync, updated every
4779                                time new data is exported.*/
4780 .fi
4781 .sp 1
4782 The rest is payload (non-interleaved) 16 bit data.
4783 .PD 0
4784 .RSs
4785 .IPs <mmapped_file>
4786 file to map data to (default: ~/.mplayer/\:mplayer-af_export)
4787 .IPs <nsamples>
4788 number of samples per channel (default: 512)
4789 .RE
4790 .sp 1
4791 .RS
4792 .I EXAMPLE:
4793 .RE
4794 .RSs
4795 .IPs "mplayer \-af export=/tmp/mplayer-af_export:1024 media.avi"
4796 Would export 1024 samples per channel to '/tmp/mplayer-af_export'.
4797 .RE
4798 .PD 1
4799 .
4800 .TP
4801 .B extrastereo[=mul]
4802 (Linearly) increases the difference between left and right channels
4803 which adds some sort of "live" effect to playback.
4804 .PD 0
4805 .RSs
4806 .IPs <mul>
4807 Sets the difference coefficient (default: 2.5).
4808 0.0 means mono sound (average of both channels), with 1.0 sound will be
4809 unchanged, with -1.0 left and right channels will be swapped.
4810 .RE
4811 .PD 1
4812 .
4813 .TP
4814 .B volnorm[=method:target]
4815 Maximizes the volume without distorting the sound.
4816 .PD 0
4817 .RSs
4818 .IPs <method>
4819 Sets the used method.
4820 .RSss
4821 1: Use a single sample to smooth the variations via the standard
4822 weighted mean over past samples (default).
4823 .br
4824 2: Use several samples to smooth the variations via the standard
4825 weighted mean over past samples.
4826 .REss
4827 .IPs <target>
4828 Sets the target amplitude as a fraction of the maximum for the
4829 sample type (default: 0.25).
4830 .RE
4831 .PD 1
4832 .
4833 .TP
4834 .B ladspa=file:label[:controls...]
4835 Load a LADSPA (Linux Audio Developer's Simple Plugin API) plugin.
4836 This filter is reentrant, so multiple LADSPA plugins can be used at once.
4837 .PD 0
4838 .RSs
4839 .IPs <file>
4840 Specifies the LADSPA plugin library file.
4841 If LADSPA_PATH is set, it searches for the specified file.
4842 If it is not set, you must supply a fully specified pathname.
4843 .IPs <label>
4844 Specifies the filter within the library.
4845 Some libraries contain only one filter, but others contain many of them.
4846 Entering 'help' here, will list all available filters within the specified
4847 library, which eliminates the use of 'listplugins' from the LADSPA SDK.
4848 .IPs <controls>
4849 Controls are zero or more floating point values that determine the
4850 behavior of the loaded plugin (for example delay, threshold or gain).
4851 In verbose mode (add \-v to the MPlayer command line), all available controls
4852 and their valid ranges are printed.
4853 This eliminates the use of 'analyseplugin' from the LADSPA SDK.
4854 .RE
4855 .PD 1
4856 .
4857 .TP
4858 .B "comp\ \ \ "
4859 Compressor/expander filter usable for microphone input.
4860 Prevents artifacts on very loud sound and raises the volume on
4861 very low sound.
4862 This filter is untested, maybe even unusable.
4863 .
4864 .TP
4865 .B "gate\ \ \ "
4866 Noise gate filter similar to the comp audio filter.
4867 This filter is untested, maybe even unusable.
4868 .
4869 .TP
4870 .B karaoke
4871 Simple voice removal filter exploiting the fact that voice is
4872 usually recorded with mono gear and later 'center' mixed onto
4873 the final audio stream.
4874 Beware that this filter will turn your signal into mono.
4875 Works well for 2 channel tracks; do not bother trying it
4876 on anything but 2 channel stereo.
4877 .
4878 .
4879 .
4880 .SH "VIDEO FILTERS"
4881 Video filters allow you to modify the video stream and its properties.
4882 The syntax is:
4883 .
4884 .TP
4885 .B \-vf <filter1[=parameter1:parameter2:...],filter2,...>
4886 Setup a chain of video filters.
4887 .
4888 .TP
4889 .B \-vop <...,filter2[=parameter1:parameter2:...],filter1> (OBSOLETE)
4890 Setup a chain of video filters, to be applied in
4891 .B reverse
4892 order.
4893 Deprecated in favor of \-vf.
4894 .PP
4895 Many parameters are optional and set to default values if omitted.
4896 To explicitly use a default value set a parameter to '-1'.
4897 Parameters w:h means width x height in pixels, x:y means x;y position counted
4898 from the upper left corner of the bigger image.
4899 .br
4900 .I NOTE:
4901 To get a full list of available video filters, see \-vf help.
4902 .sp 1
4903 Video filters are managed in lists.
4904 There are a few commands to manage the filter list.
4905 .
4906 .TP
4907 .B \-vf-add <filter1[,filter2,...]>
4908 Appends the filters given as arguments to the filter list.
4909 .
4910 .TP
4911 .B \-vf-pre <filter1[,filter2,...]>
4912 Prepends the filters given as arguments to the filter list.
4913 .
4914 .TP
4915 .B \-vf-del <index1[,index2,...]>
4916 Deletes the filters at the given indexes.
4917 Index numbers start at 0, negative numbers address the end of the
4918 list (-1 is the last).
4919 .
4920 .TP
4921 .B \-vf-clr
4922 Completely empties the filter list.
4923 .PP
4924 With filters that support it, you can access parameters by their name.
4925 .
4926 .TP
4927 .B \-vf <filter>=help
4928 Prints the parameter names and parameter value ranges for a particular
4929 filter.
4930 .
4931 .TP
4932 .B \-vf <filter=named_parameter1=value1[:named_parameter2=value2:...]>
4933 Sets a named parameter to the given value.
4934 Use on and off or yes and no to set flag parameters.
4935 .PP
4936 Available filters are:
4937 .
4938 .TP
4939 .B crop[=w:h:x:y]
4940 Crops the given part of the image and discards the rest.
4941 Useful to remove black bands from widescreen movies.
4942 .PD 0
4943 .RSs
4944 .IPs <w>,<h>
4945 Cropped width and height, defaults to original width and height.
4946 .IPs <x>,<y>
4947 Position of the cropped picture, defaults to center.
4948 .RE
4949 .PD 1
4950 .
4951 .TP
4952 .B cropdetect[=limit:round]
4953 Calculates necessary cropping parameters and prints the recommended parameters
4954 to stdout.
4955 .PD 0
4956 .RSs
4957 .IPs <limit>
4958 Threshold, which can be optionally specified from nothing (0) to
4959 everything (255) (default: 24).
4960 .br
4961 .IPs <round>
4962 Value which the width/\:height should be divisible by (default: 16).
4963 The offset is automatically adjusted to center the video.
4964 Use 2 to get only even dimensions (needed for 4:2:2 video).
4965 16 is best when encoding to most video codecs.
4966 .RE
4967 .PD 1
4968 .
4969 .TP
4970 .B rectangle[=w:h:x:y]
4971 The plugin responds to the input.conf directive 'change_rectangle'
4972 that takes two parameters.
4973 .PD 0
4974 .RSs
4975 .IPs <w>,<h>
4976 width and height (default: -1, maximum possible width where boundaries
4977 are still visible.)
4978 .IPs <x>,<y>
4979 top left corner position (default: -1, uppermost leftmost)
4980 .RE
4981 .PD 1
4982 .
4983 .TP
4984 .B expand[=w:h:x:y:o:a:r]
4985 Expands (not scales) movie resolution to the given value and places the
4986 unscaled original at coordinates x, y.
4987 Can be used for placing subtitles/\:OSD in the resulting black bands.
4988 .RSs
4989 .IPs <w>,<h>
4990 Expanded width,height (default: original width,height).
4991 Negative values for w and h are treated as offsets to the original size.
4992 .sp 1
4993 .I EXAMPLE:
4994 .PD 0
4995 .RSs
4996 .IP expand=0:-50:0:0
4997 Adds a 50 pixel border to the bottom of the picture.
4998 .RE
4999 .PD 1