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