Mercurial > mplayer.hg
comparison DOCS/en/mplayer.1 @ 9382:1b3444713694
Move English files to en/ subdirectory.
author | diego |
---|---|
date | Mon, 10 Feb 2003 00:00:00 +0000 |
parents | DOCS/mplayer.1@33974bf4870b |
children | f9a1701af199 |
comparison
equal
deleted
inserted
replaced
9381:007a1bdce1f4 | 9382:1b3444713694 |
---|---|
1 .\" MPlayer (C) 2000-2003 Arpad Gereoffy | |
2 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann | |
3 .\" | |
4 .\" Run this to get a html version of the man page: | |
5 .\" cat mplayer.1 | sed s/SS\ 20/SS\ 4/ | groff -man -Thtml - > manpage.html | |
6 .\" Run this to get a text version of the man page: | |
7 .\" groff -m man -Tascii mplayer.1 | col -bx > manpage.txt | |
8 .\" | |
9 . | |
10 .\" -------------------------------------------------------------------------- | |
11 .\" Macro definitions | |
12 .\" -------------------------------------------------------------------------- | |
13 . | |
14 .\" default indentation is 7, don't change! | |
15 .nr IN 7 | |
16 .\" define indentation for suboptions | |
17 .nr SS 20 | |
18 .\" add new suboption | |
19 .de IPs | |
20 .IP "\\$1" \n(SS | |
21 .. | |
22 .\" begin of first level suboptions, end with .RE | |
23 .de RSs | |
24 .RS \n(IN+3 | |
25 .. | |
26 .\" begin of 2nd level suboptions | |
27 .de RSss | |
28 .PD 0 | |
29 .RS \n(SS+3 | |
30 .. | |
31 .\" end of 2nd level suboptions | |
32 .de REss | |
33 .RE | |
34 .PD 1 | |
35 .. | |
36 . | |
37 .\" -------------------------------------------------------------------------- | |
38 .\" Title | |
39 .\" -------------------------------------------------------------------------- | |
40 . | |
41 .TH MPlayer 1 "2003-01-11" | |
42 . | |
43 .SH NAME | |
44 mplayer \- Movie Player for Linux | |
45 .br | |
46 mencoder \- Movie Encoder for Linux | |
47 | |
48 .\" -------------------------------------------------------------------------- | |
49 .\" Synopsis | |
50 .\" -------------------------------------------------------------------------- | |
51 . | |
52 .SH SYNOPSIS | |
53 .na | |
54 .nh | |
55 .B mplayer | |
56 .RI [options]\ [ \ file\ | \ URL\ | \ playlist\ | \ -\ ] | |
57 .br | |
58 .B mplayer | |
59 'in +\n[.k]u | |
60 [global options] | |
61 .I file1 | |
62 [specific options] [file2] [specific options] | |
63 .br | |
64 .in | |
65 .B mplayer | |
66 'in +\n[.k]u | |
67 [global options] | |
68 .RI { "group of files and options" } | |
69 [group specific options] | |
70 .br | |
71 .in | |
72 .B mplayer | |
73 'in +\n[.k]u | |
74 .RI [ dvd | vcd | cdda | cddb | tv ] ://title | |
75 [options] | |
76 .br | |
77 .in | |
78 .B mplayer | |
79 'in +\n[.k]u | |
80 .RI [ mms[t] | http | http_proxy | rt[s]p ] :// | |
81 [user:passwd@]\fIURL\fP[:port] [options] | |
82 .br | |
83 .in | |
84 .B mencoder | |
85 [options] | |
86 .RI [ \ file\ | \ URL\ | \ -\ ] | |
87 [\-o\ file] | |
88 .br | |
89 .B gmplayer | |
90 [options] | |
91 [\-skin\ skin] | |
92 .ad | |
93 .hy | |
94 | |
95 .\" -------------------------------------------------------------------------- | |
96 .\" Description | |
97 .\" -------------------------------------------------------------------------- | |
98 . | |
99 .SH DESCRIPTION | |
100 .B mplayer | |
101 is a movie player for LINUX (runs on many other Unices and non\-x86 CPUs, see | |
102 the documentation). | |
103 It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, OGG/\:OGM, | |
104 VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many | |
105 native, XAnim, and Win32 DLL codecs. | |
106 You can watch VideoCD, SVCD, DVD, 3ivx, DivX\ 3/\:4/\:5 and even WMV movies, | |
107 too (without using the avifile library). | |
108 .PP | |
109 Another great feature of MPlayer is the wide range of supported output | |
110 drivers. | |
111 It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you | |
112 can also use GGI, SDL (and this way all their drivers), VESA (on every VESA | |
113 compatible card, even without X11), some low level card-specific drivers (for | |
114 Matrox, 3Dfx and ATI) and some hardware MPEG decoder boards, such as the | |
115 Siemens DVB, DXR2 and DXR3/\:Hollywood+. | |
116 Most of them support software or hardware scaling, so you can enjoy movies in | |
117 fullscreen. | |
118 .PP | |
119 MPlayer has an onscreen display (OSD) for status information, nice big | |
120 antialiased shaded subtitles and visual feedback for keyboard controls. | |
121 European/\:ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean | |
122 fonts are supported along with 10 subtitle formats (MicroDVD, SubRip, | |
123 SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub and our own: MPsub) and | |
124 DVD subtitles (SPU streams, VobSub and Closed Captions). | |
125 .PP | |
126 .B mencoder | |
127 (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode | |
128 MPlayer-playable movies (see above) to other MPlayer-playable formats (see | |
129 below). | |
130 It encodes to DivX4, XviD, one of the libavcodec codecs and PCM/\:MP3/\:VBRMP3 | |
131 audio in 1, 2 or 3\ passes. | |
132 Furthermore it has stream copying abilities, a powerful plugin system (crop, | |
133 expand, flip, postprocess, rotate, scale, noise, rgb/\:yuv conversion) and | |
134 more. | |
135 .PP | |
136 .B gmplayer | |
137 is MPlayer with a graphical user interface. | |
138 It has the same options as MPlayer. | |
139 | |
140 | |
141 .\" -------------------------------------------------------------------------- | |
142 .\" Options | |
143 .\" -------------------------------------------------------------------------- | |
144 . | |
145 .SH "GENERAL NOTES" | |
146 .B Also see the HTML documentation! | |
147 .PP | |
148 Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the | |
149 \-fs option is \-nofs. | |
150 .PP | |
151 You can put all of the options in a configuration file which will be read | |
152 every time mplayer is run. | |
153 The system-wide configuration file 'mplayer.conf' is in your configuration | |
154 directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user | |
155 specific one is '~/\:.mplayer/\:config'. | |
156 User specific options override system\-wide options and options given on the | |
157 command line override either. | |
158 The syntax of the configuration files is 'option=<value>', everything after a | |
159 \'#' is considered a comment. | |
160 Options that work without values can be enabled by setting them to 'yes' or | |
161 \'1' and disabled by setting them to 'no' or '0'. | |
162 Even suboptions can be specified in this way. | |
163 | |
164 .I EXAMPLE: | |
165 .br | |
166 # Use Matrox driver by default. | |
167 .br | |
168 vo=xmga | |
169 .br | |
170 # I love practicing handstands while watching videos. | |
171 .br | |
172 flip=yes | |
173 .br | |
174 # Decode/\:encode multiple files from png, start with -mf on | |
175 .br | |
176 mf= type=png:fps=25 | |
177 | |
178 You can also write file-specific configuration files. | |
179 If you wish to have a config file for a file called 'movie.avi', create a file | |
180 named 'movie.avi.conf' with the file-specific options in it and put it in | |
181 ~/.mplayer or in the same directory as the file. | |
182 | |
183 .SH "PLAYER OPTIONS (MPLAYER ONLY)" | |
184 .TP | |
185 .B \-, \-use-stdin | |
186 Read data from stdin. | |
187 The \-idx option does not work in conjunction with this. | |
188 .TP | |
189 .B \-autoq <quality> (use with \-vop pp) | |
190 Dynamically changes the level of postprocessing depending on available spare | |
191 CPU time. | |
192 The number you specify will be the maximum level used. | |
193 Usually you can use some big number. | |
194 You have to use \-vop pp without parameters in order to use this. | |
195 .TP | |
196 .B \-autosync <factor> | |
197 Gradually adjusts the A/\:V sync based on audio delay measurements. | |
198 Specifying \-autosync\ 0, the default, will cause frame timing to be based | |
199 entirely on audio delay measurements. | |
200 Specifying \-autosync\ 1 will do the same, but will subtly change the A/\:V | |
201 correction algorithm used. | |
202 An uneven video frame rate in a movie which plays fine with \-nosound can | |
203 often be helped by setting this to an integer value greater than 1. | |
204 The higher the value, the closer the timing will be to -nosound. | |
205 Try \-autosync\ 30 to smooth out problems with sound drivers which do | |
206 not implement a perfect audio delay measurement. | |
207 With this value, if large A/\:V sync offsets occur, they will only take about | |
208 1 or 2\ seconds to settle out. | |
209 This delay in reaction time to sudden A/\:V offsets should be the only | |
210 side-effect of turning this option on, for all sound drivers. | |
211 .TP | |
212 .B \-benchmark | |
213 Prints some statistics on CPU usage and dropped frames at the end. | |
214 Use in combination with \-nosound and \-vo null for benchmarking only the | |
215 video codec. | |
216 .TP | |
217 .B \-edl <filename> | |
218 Enables edit decision list (EDL) actions during playback. | |
219 Video will be skipped over and audio will be muted and unmuted according to | |
220 the entries in the given file. | |
221 See DOCS/documentation.html#edl for details on how to use this. | |
222 .TP | |
223 .B \-edlout <filename> | |
224 Creates a new file and writes edit decision list (EDL) records to that file. | |
225 During playback, when the user hits 'i', an entry to skip over the last two | |
226 seconds of playback will be written to the file. | |
227 This provides a starting point from which the user can fine-tune EDL entries | |
228 later. | |
229 See DOCS/documentation.html#edl for details. | |
230 .TP | |
231 .B \-enqueue (GUI only) | |
232 Enqueue files given on the command line in the playlist instead of playing them | |
233 immediately. | |
234 .TP | |
235 .B \-fixed-vo (BETA CODE!) | |
236 Enforces a fixed video system for multiple files (one (un)initialisation for | |
237 all files). | |
238 Therefore only one window will be opened for all files. | |
239 Currently the following drivers are fixed-vo compliant: x11, xv, xvidix, xmga, | |
240 gl2, and svga. | |
241 .TP | |
242 .B \-framedrop (also see \-hardframedrop) | |
243 Skip displaying some frames to maintain A/\:V sync on slow systems. | |
244 Video filters are not applied to such frames. | |
245 For B frames even decoding is skipped completely. | |
246 .TP | |
247 .B \-h, \-help, \-\-help | |
248 Show short summary of options. | |
249 .TP | |
250 .B \-hardframedrop | |
251 More intense frame dropping (breaks decoding). | |
252 Leads to image distortion! | |
253 .TP | |
254 .B \-identify | |
255 Show file parameters in easy parsable format. | |
256 The wrapper script TOOLS/midentify suppresses the other mplayer output and | |
257 (hopefully) shellescapes the filenames. | |
258 .TP | |
259 .B \-input <commands> | |
260 This option can be used to configure certain parts of the input system. | |
261 Paths are relative to ~/\:.mplayer/. | |
262 | |
263 .I NOTE: | |
264 .br | |
265 Autorepeat is currently only supported by joysticks. | |
266 .br | |
267 Available commands are: | |
268 | |
269 .PD 0 | |
270 .RSs | |
271 .IPs conf=<file> | |
272 Read alternative input.conf. | |
273 If given without pathname, ~/\:.mplayer is assumed. | |
274 .IPs ar\-delay | |
275 Delay in msec before we start to autorepeat a key (0 to disable). | |
276 .IPs ar\-rate | |
277 How many key presses per second when we autorepeat. | |
278 .IPs keylist | |
279 Prints all keys that can be bound. | |
280 .IPs cmdlist | |
281 Prints all commands that can be bound. | |
282 .IPs js\-dev | |
283 Specifies the joystick device to use (default is /dev/\:input/\:js0). | |
284 .IPs file | |
285 Read commands from the given file. | |
286 Mostly useful with a fifo. | |
287 .RE | |
288 .PD 1 | |
289 . | |
290 .TP | |
291 .B \-lircconf <file> | |
292 Specifies a configuration file for LIRC (Linux Infrared Remote Control, see | |
293 http://www.lirc.org) if you don't like the default ~/\:.lircrc. | |
294 .TP | |
295 .B \-loop <number> | |
296 Loops movie playback <number> times. | |
297 0 means forever. | |
298 .TP | |
299 .B \-menu (BETA CODE) | |
300 Turn on OSD menu support. | |
301 .TP | |
302 .B \-menu-root <value> (BETA CODE) | |
303 Specify the main menu. | |
304 .TP | |
305 .B \-menu-cfg <file> (BETA CODE) | |
306 Use an alternative menu.conf. | |
307 .TP | |
308 .B \-nojoystick | |
309 Turns off joystick support. | |
310 Default is on, if compiled in. | |
311 .TP | |
312 .B \-nolirc | |
313 Turns off LIRC support. | |
314 .TP | |
315 .B \-nortc \ \ | |
316 Turns off usage of the Linux RTC (real-time clock \- /dev/\:rtc) as timing | |
317 mechanism. | |
318 .TP | |
319 .B \-playlist <file> | |
320 Play files according to a playlist (1 file per row or Winamp or ASX format). | |
321 .TP | |
322 .B \-quiet \ \ | |
323 Display less output and status messages. | |
324 .TP | |
325 .B \-really\-quiet \ \ | |
326 Display even less output and status messages. | |
327 .TP | |
328 .B \-sdp | |
329 Specifies that the input file is a SDP ('Session Description Protocol') | |
330 file that describes an RTP session (see http://www.live.com/mplayer/). | |
331 .TP | |
332 .B \-shuffle \ \ | |
333 Play files in random order. | |
334 .TP | |
335 .B \-skin <skin\ directory> (BETA CODE) | |
336 Load skin from the given directory (WITHOUT path name). | |
337 | |
338 .I EXAMPLE: | |
339 .PD 0 | |
340 .RSs | |
341 .IPs "\-skin fittyfene" | |
342 tries Skin/fittyfene. | |
343 It first checks | |
344 /usr/local/share/mplayer/ | |
345 and afterwards ~/.mplayer/. | |
346 .RE | |
347 .PD 1 | |
348 . | |
349 .TP | |
350 .B \-slave \ \ | |
351 This option switches on slave mode. | |
352 This is intended for use of MPlayer as a backend to other programs. | |
353 Instead of intercepting keyboard events, MPlayer will read simplistic command | |
354 lines from its stdin. | |
355 The section | |
356 .B SLAVE MODE PROTOCOL | |
357 explains the syntax. | |
358 .TP | |
359 .B \-softsleep | |
360 Uses high quality software timers. | |
361 As precise as the RTC without requiring special privileges. | |
362 Comes at the price of higher CPU consumption. | |
363 .TP | |
364 .B \-speed <0.01\-100> | |
365 Set playback speed rate. | |
366 .TP | |
367 .B \-sstep <sec> | |
368 Specifies seconds between displayed frames. | |
369 Useful for slideshows. | |
370 | |
371 | |
372 .SH "DEMUXER/STREAM OPTIONS" | |
373 .TP | |
374 .B \-aid <id> (also see \-alang option) | |
375 Select audio channel [MPEG: 0\-31 AVI/\:OGM: 1\-99 ASF/\:RM: 0\-127 | |
376 VOB(AC3): 128\-159 VOB(LPCM): 160\-191] | |
377 MPlayer prints the available IDs when running in verbose (-v) mode. | |
378 .TP | |
379 .B \-alang <two letter\ country\ code> (also see \-aid option) | |
380 Works only for DVD playback. | |
381 It selects the DVD audio language and always tries to play audio streams whose | |
382 language matches the given code. | |
383 For the list of available languages, use with the \-v option and look at the | |
384 output. | |
385 | |
386 .I EXAMPLE: | |
387 .PD 0 | |
388 .RSs | |
389 .IPs "\-alang hu,en" | |
390 Plays Hungarian and falls back to English if Hungarian is not available. | |
391 .RE | |
392 .PD 1 | |
393 . | |
394 .TP | |
395 .B \-audio\-demuxer <number> (\-audiofile only) | |
396 Force audio demuxer type for \-audiofile. | |
397 Give the demuxer ID as defined in demuxers.h. | |
398 Use \-audio\-demuxer 17 to force .mp3 detection. | |
399 .TP | |
400 .B \-audiofile <filename> | |
401 Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a | |
402 movie. | |
403 .TP | |
404 .B \-bandwidth <value> | |
405 Specify the maximum bandwidth for network streaming (for servers that are | |
406 able to send content in different bitrates). | |
407 Usefull if you want to watch live streamed media behind a slow connection. | |
408 .TP | |
409 .B \-cdrom\-device <path\ to\ device> | |
410 Override default CDROM drive name /dev/\:cdrom. | |
411 .TP | |
412 .B \-cache <kbytes> | |
413 This option specifies how much memory (in kbytes) to use when precaching a | |
414 file/\:URL. | |
415 Especially useful on slow media (default is \-nocache). | |
416 .TP | |
417 .B \-cdda <option1:option2> | |
418 This option can be used to tune the CD Audio reading feature of MPlayer. | |
419 .br | |
420 Available options are: | |
421 . | |
422 .RSs | |
423 .IPs speed=<value> | |
424 set CD spin speed | |
425 .IPs paranoia=<0\-2> | |
426 set paranoia level | |
427 .RSss | |
428 0: disable checking | |
429 .br | |
430 1: overlap checking only (default) | |
431 .br | |
432 2: full data correction and verification | |
433 .REss | |
434 .IPs generic-dev=<value> | |
435 use specified generic SCSI device | |
436 .IPs sector-size=<value> | |
437 atomic read size | |
438 .IPs overlap=<value> | |
439 force minimum overlap search during verification to <value> sectors. | |
440 .IPs toc-bias | |
441 Assume that the beginning offset of track 1 as reported in the TOC will be | |
442 addressed as LBA\ 0. | |
443 Some Toshiba drives need this for getting track boundaries correct. | |
444 .IPs toc-offset=<value> | |
445 Add <value> sectors to the values reported when addressing tracks. | |
446 May be negative. | |
447 .IPs (no)skip | |
448 (never) accept imperfect data reconstruction. | |
449 .RE | |
450 . | |
451 .TP | |
452 .B \-channels <number> | |
453 Change the number of playback channels, defaults to '2' if not specified. | |
454 If the number of output channels is bigger than the number of input channels | |
455 empty channels are inserted (unless mixing from mono to stereo, then the mono | |
456 channel is repeated in both output channels). | |
457 If the number of output channels is smaller than the number of input channels, | |
458 results depend on the audio decoder (\-afm). | |
459 MPlayer asks the decoder to decode the audio into as many channels as | |
460 specified. | |
461 Now it's up to the decoder to fulfill the requirement. | |
462 If the decoder outputs more channels than requested, the exceeding channels | |
463 are truncated. | |
464 This is usually only important when playing videos with AC3 audio (like DVDs). | |
465 In that case liba52 does the decoding by default and correctly downmixes the | |
466 audio into the requested number of channels. | |
467 | |
468 .I NOTE: | |
469 .br | |
470 This option is honored by codecs (AC3 only) filters (surround) and ao drivers | |
471 (OSS at least). | |
472 .br | |
473 Available options are: | |
474 | |
475 .PD 0 | |
476 .RSs | |
477 .IPs 2 | |
478 Stereo | |
479 .IPs 4 | |
480 Surround | |
481 .IPs 6 | |
482 Full 5.1 | |
483 .RE | |
484 .PD 1 | |
485 . | |
486 .TP | |
487 .B \-chapter <chapter\ id>[-<end\ chapter\ id>] | |
488 Specify which chapter to start playing at. | |
489 Optionally specify which chapter to end playing at (default: 1). | |
490 Examples can be found below. | |
491 .TP | |
492 .B \-csslib <filename> | |
493 (old-style DVD option) This option is used to override the default location of | |
494 libcss.so. | |
495 .TP | |
496 .B \-cuefile <filename> (see \-vcd too) | |
497 Play (S)VCD from CDRwin's (bin/cue fileformat) disk image, described by the | |
498 specified file. | |
499 .TP | |
500 .B \-demuxer <number> | |
501 Force demuxer type. | |
502 Give the demuxer ID as defined in demuxers.h. | |
503 Use \-demuxer 17 to force .mp3 detection. | |
504 .TP | |
505 .B \-dumpaudio (MPLAYER only) | |
506 Dumps raw compressed audio stream to ./\:stream.dump (useful with mpeg/\:ac3). | |
507 .TP | |
508 .B \-dumpfile <filename> (MPLAYER only) | |
509 Specify which file MPlayer should dump to. | |
510 Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream. | |
511 .TP | |
512 .B \-dumpstream (MPLAYER only) | |
513 Dumps the raw stream to ./\:stream.dump. | |
514 Useful when ripping from DVD or network. | |
515 .TP | |
516 .B \-dumpvideo (MPLAYER only) | |
517 Dump raw compressed video stream to ./\:stream.dump (not very usable). | |
518 .TP | |
519 .B \-dvd <title\ id> | |
520 Tell MPlayer which movies (specified by title id) to play. | |
521 For example sometimes '1' is a trailer, and '2' is the real movie. | |
522 | |
523 .I NOTE: | |
524 .br | |
525 Sometimes deinterlacing is required for DVD playback, | |
526 see the \-vop pp=0x20000 option. | |
527 .TP | |
528 .B \-dvd\-device <path\ to\ device> | |
529 Override default DVD device name /dev/\:dvd. | |
530 .TP | |
531 .B \-dvdangle <angle\ id> | |
532 Some DVD discs contain scenes that can be viewed from multiple angles. | |
533 Here you can tell MPlayer which angles to use (default: 1). | |
534 Examples can be found below. | |
535 .TP | |
536 .B \-dvdauth <DVD\ device> | |
537 (old-style DVD option) Turns on DVD authentication using the given device. | |
538 .TP | |
539 .B \-dvdkey <CSS\ key> | |
540 (old-style DVD option) When decoding a VOB file copied undecrypted from DVD, | |
541 this option gives the CSS key needed to decrypt the VOB (the key is printed | |
542 when authenticating with the DVD drive using \-dvdauth). | |
543 .TP | |
544 .B \-dvdnav (BETA CODE!) | |
545 Force usage of libdvdnav. | |
546 .TP | |
547 .B \-forceidx | |
548 Force rebuilding of INDEX. | |
549 Useful for files with broken index (desyncs, etc). | |
550 Seeking will be possible. | |
551 You can fix the index permanently with MEncoder (see the documentation). | |
552 .TP | |
553 .B \-fps <value> | |
554 Override video framerate (if value is wrong/\:missing in the header) (float | |
555 number). | |
556 .TP | |
557 .B \-frames <number> | |
558 Play/\:convert only first <number> frames, then quit. | |
559 .TP | |
560 .B \-hr\-mp3\-seek (.MP3 only) | |
561 Hi\-res mp3 seeking. | |
562 Default is: enabled when playing from external MP3 file, as we need to seek | |
563 to the very exact position to keep A/\:V sync. It can be slow especially when | |
564 seeking backwards \- it has to rewind to the beginning to find the exact | |
565 frame. | |
566 .TP | |
567 .B \-idx (also see \-forceidx) | |
568 Rebuilds INDEX of the AVI if no INDEX was found, | |
569 thus allowing seeking. | |
570 Useful with broken/\:incomplete downloads, or badly created AVIs. | |
571 .TP | |
572 .B \-mc <seconds/frame> | |
573 Maximum A-V sync correction per frame (in seconds). | |
574 .TP | |
575 .B \-mf <option1:option2:...> | |
576 Used when decoding from multiple PNG or JPEG files. | |
577 .br | |
578 Available options are: | |
579 | |
580 .PD 0 | |
581 .RSs | |
582 .IPs on\ \ \ | |
583 turns on multifile support | |
584 .IPs w=<value> | |
585 width of the output (autodetect) | |
586 .IPs h=<value> | |
587 height of the output (autodetect) | |
588 .IPs fps=<value> | |
589 fps of the output (default: 25) | |
590 .IPs type=<value> | |
591 type of input files (available types: jpeg, png, tga) | |
592 .RE | |
593 .PD 1 | |
594 . | |
595 .TP | |
596 .B \-ni (.AVI only) | |
597 Force usage of non\-interleaved AVI parser (fixes playing | |
598 of some bad AVI files). | |
599 .TP | |
600 .B \-nobps (.AVI only) | |
601 Do not use average byte/\:sec value for A\-V sync (AVI). | |
602 Helps with some AVI files with broken header. | |
603 .TP | |
604 .B \-noextbased | |
605 Disables filename-extension based demuxer selection. | |
606 By default, when file type (demuxer) cannot be detected reliably | |
607 (the file has no header or it is not reliable enough), the filename | |
608 extension is used to select demuxer. It always falls back to content-based | |
609 demuxer selection. | |
610 .TP | |
611 .B \-passwd <password> (see \-user option too) | |
612 Specify password for http authentication. | |
613 .TP | |
614 .B \-rawaudio <option1:option2:...> | |
615 This option lets you play raw audio files. | |
616 It may also be used to play audio CDs which are not 44KHz 16Bit stereo. | |
617 .br | |
618 Available options are: | |
619 | |
620 .PD 0 | |
621 .RSs | |
622 .IPs on\ \ \ | |
623 use raw audio demuxer | |
624 .IPs channels=<value> | |
625 number of channels | |
626 .IPs rate=<value> | |
627 rate in samples per second | |
628 .IPs samplesize=<value> | |
629 sample size in byte | |
630 .IPs format=<value> | |
631 fourcc in hex | |
632 .RE | |
633 .PD 1 | |
634 . | |
635 .TP | |
636 .B \-rawvideo <option1:option2:...> | |
637 This option lets you play raw video files. | |
638 .br | |
639 Available options are: | |
640 | |
641 .PD 0 | |
642 .RSs | |
643 .IPs on\ \ \ | |
644 use raw video demuxer | |
645 .IPs fps=<value> | |
646 rate in frames per second, default 25.0 | |
647 .IPs sqcif|qcif|cif|4cif|pal|ntsc | |
648 set standard image size | |
649 .IPs w=<value> | |
650 image width in pixels | |
651 .IPs h=<value> | |
652 image height in pixels | |
653 .IPs y420|yv12|yuy2|y8 | |
654 set colorspace | |
655 .IPs format=<value> | |
656 colorspace (fourcc) in hex | |
657 .IPs size=<value> | |
658 frame size in bytes | |
659 .RE | |
660 .PD 1 | |
661 . | |
662 .TP | |
663 .B \-rtsp-stream-over-tcp | |
664 Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP | |
665 packets be streamed over TCP (using the same TCP connection as RTSP). | |
666 This option may be useful if you have a broken Internet connection that does | |
667 not pass incoming UDP packets (see http://www.live.com/mplayer/). | |
668 .TP | |
669 .B \-skipopening | |
670 Skip DVD opening (dvdnav only). | |
671 .TP | |
672 .B \-sb <byte\ position> (see \-ss option too) | |
673 Seek to byte position. | |
674 Useful for playback from CDROM images / .VOB files with junk at the beginning. | |
675 .TP | |
676 .B \-srate <Hz> | |
677 Forces the given audio playback rate, changing video speed to keep a-v sync. | |
678 MEncoder passes this value to lame for resampling. | |
679 .TP | |
680 .B \-ss <time> (see \-sb option too) | |
681 Seek to given time position. | |
682 | |
683 .I EXAMPLE: | |
684 .PD 0 | |
685 .RSs | |
686 .IPs "\-ss 56" | |
687 seeks to 56 seconds | |
688 .IPs "\-ss 01:10:00" | |
689 seeks to 1\ hour 10\ min | |
690 .RE | |
691 .PD 1 | |
692 . | |
693 .TP | |
694 .B \-tv <option1:option2:...> | |
695 This option enables the TV grabbing feature of MPlayer. | |
696 | |
697 .I NOTE: | |
698 .br | |
699 MPlayer doesn't accept colons so type dots instead in the device ID | |
700 (e.g.\& hw.0,0 instead of hw:0,0). | |
701 .br | |
702 Be advised that although you can select any samplerate when using ALSA, | |
703 the LAME audio codec is able to encode only the 'standard' samplerates. | |
704 You'll get an .avi file with no sound when you choose an odd | |
705 samplerate and use this codec. | |
706 .br | |
707 Available options are: | |
708 . | |
709 .RSs | |
710 .IPs on\ \ \ | |
711 use TV input | |
712 .IPs noaudio | |
713 no sound | |
714 .IPs driver=<value> | |
715 available: dummy, v4l, bsdbt848 | |
716 .IPs device=<value> | |
717 Specify other device than the default /dev/\:video0. | |
718 .IPs input=<value> | |
719 Specify other input than the default 0 (Television) (see output for a list) | |
720 .IPs freq=<value> | |
721 Specify the frequency to set the tuner to (e.g.\& 511.250). | |
722 Not compatible with channels parameter. | |
723 .IPs outfmt=<value> | |
724 output format of the tuner (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, | |
725 i420) | |
726 .IPs width=<value> | |
727 width of the output window | |
728 .IPs height=<value> | |
729 height of the output window | |
730 .IPs fps=<value> | |
731 framerate at which to capture video (frames per second) | |
732 .IPs buffersize=<value> | |
733 maximum size of the capture buffer in megabytes (default: dynamical) | |
734 .IPs norm=<value> | |
735 available: PAL, SECAM, NTSC | |
736 .IPs channel=<value> | |
737 Set tuner to <value> channel. | |
738 .IPs chanlist=<value> | |
739 available: europe-east, europe-west, us-bcast, us-cable, etc | |
740 .IPs channels=<channel>\-<name>,<channel>\-<name>,... | |
741 Set names for channels. | |
742 Use _ for spaces in names (or play with quoting ;-). | |
743 The channel names will then be written using OSD, and the commands tv_step_channel, | |
744 tv_set_channel and tv_last_channel will then be usable using a remote (see lirc). | |
745 Not compatible with frequency parameter. | |
746 Warning: The channel number will then be the position in the 'channels' list, | |
747 beginning with 1. | |
748 Example: use tv://1, tv://2, tv_set_channel 1, tv_set_channel 2, etc. | |
749 .IPs audiorate=<value> | |
750 set audio capture bitrate | |
751 .IPs forceaudio | |
752 capture audio even if there are no audio sources reported by v4l | |
753 .IPs alsa | |
754 capture from ALSA | |
755 .IPs amode=<0\-3> | |
756 choose an audio mode: | |
757 .RSss | |
758 0: mono | |
759 .br | |
760 1: stereo | |
761 .br | |
762 2: language 1 | |
763 .br | |
764 3: language 2 | |
765 .REss | |
766 .IPs forcechan=<1\-2> | |
767 By default, the count of recorded audio channels is determined automatically | |
768 by querying the audio mode from the tv card. | |
769 This option allows to force stereo/\:mono recording regardless of the amode | |
770 option and the values returned by v4l. | |
771 This can be used for troubleshooting when the tv card is unable to report the | |
772 current audio mode. | |
773 .IPs adevice=<value> | |
774 set an audio device | |
775 .RSss | |
776 /dev/\:...\& for OSS | |
777 .br | |
778 hardware ID for ALSA | |
779 .REss | |
780 .IPs audioid=<value> | |
781 choose an audio output of the capture card, if it has more of them | |
782 .IPs "[volume|bass|treble|balance]=<0\-65535>" | |
783 These options set parameters of the mixer on the video capture card. | |
784 They will have no effect, if your card doesn't have one. | |
785 .IPs immediatemode=<bool> | |
786 A value of 0 means capture and buffer audio and video together | |
787 (default for mencoder). | |
788 A value of 1 (default for mplayer) means to do video capture only and let the | |
789 audio go through a loopback cable from the TV card to the soundcard. | |
790 .RE | |
791 . | |
792 .TP | |
793 .B \-user <user name> (see \-passwd option too) | |
794 Specify user name for http authentication. | |
795 .TP | |
796 .B \-vcd <track> | |
797 Play video CD track from a device or image file (see \-cuefile). | |
798 .TP | |
799 .B \-vid <id> | |
800 Select video channel [MPG: 0\-15 ASF: 0\-255]. | |
801 .TP | |
802 .B \-vivo <sub\-options> (DEBUG CODE) | |
803 Force audio parameters for the .vivo demuxer (for debugging purposes). | |
804 | |
805 | |
806 .SH "OSD/SUB OPTIONS" | |
807 .I NOTE: | |
808 .br | |
809 See \-vop expand too. | |
810 .TP | |
811 .B \-dumpmicrodvdsub (MPLAYER only) | |
812 Convert the given subtitle (specified with the \-sub option) to the | |
813 MicroDVD subtitle format. | |
814 Creates a dumpsub.sub file in the current directory. | |
815 .TP | |
816 .B \-dumpmpsub (MPLAYER only) | |
817 Convert the given subtitle (specified with the \-sub option) to MPlayer's | |
818 subtitle format, MPsub. | |
819 Creates a dump.mpsub file in the current directory. | |
820 .TP | |
821 .B \-dumpsrtsub (MPLAYER only) | |
822 Convert the given subtitle (specified with the \-sub option) to the time-based | |
823 SubViewer (SRT) subtitle format. | |
824 Creates a dumpsub.srt file in the current directory. | |
825 .TP | |
826 .B \-dumpjacosub (MPLAYER only) | |
827 Convert the given subtitle (specified with the \-sub option) to the time-based | |
828 JACOsub subtitle format. | |
829 Creates a dumpsub.js file in the current directory. | |
830 .TP | |
831 .B \-dumpsami (MPLAYER only) | |
832 Convert the given subtitle (specified with the \-sub option) to the time-based | |
833 SAMI subtitle format. | |
834 Creates a dumpsub.smi file in the current directory. | |
835 .TP | |
836 .B \-dumpsub (MPLAYER only) (BETA CODE) | |
837 Dumps the subtitle substream from VOB streams. | |
838 See -dump*sub and -vobsubout* options too. | |
839 .TP | |
840 .B \-ifo <vobsub\ ifo\ file> | |
841 Indicate the file that will be used to load palette and frame size for VOBSUB | |
842 subtitles. | |
843 .TP | |
844 .B \-ffactor <number> | |
845 Resample alphamap of the font. | |
846 Can be: | |
847 | |
848 .PD 0 | |
849 .RSs | |
850 .IPs 0\ \ \ \ | |
851 plain white fonts | |
852 .IPs 0.75\ \ | |
853 very narrow black outline (default) | |
854 .IPs 1\ \ \ \ | |
855 narrow black outline | |
856 .IPs 10\ \ \ | |
857 bold black outline | |
858 .RE | |
859 .PD 1 | |
860 . | |
861 .TP | |
862 .B \-font <path\ to\ font.desc\ file> | |
863 Search for the OSD/\:SUB fonts in an alternative directory (default for normal | |
864 fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts: | |
865 ~/.mplayer/\:subfont.ttf). | |
866 | |
867 .I NOTE: | |
868 .br | |
869 With FreeType, this option determines path to the text font file. | |
870 .br | |
871 The \-subfont-* options are available only with FreeType support compiled in. | |
872 | |
873 .I EXAMPLE: | |
874 .PD 0 | |
875 .RSs | |
876 \-font ~/\:.mplayer/\:arial\-14/\:font.desc | |
877 .br | |
878 \-font ~/\:.mplayer/\:arialuni.ttf | |
879 .RE | |
880 .PD 1 | |
881 . | |
882 .TP | |
883 .B \-noautosub | |
884 Turns off automatic loading of subtitle files. | |
885 .TP | |
886 .B \-overlapsub | |
887 Enables overlapping subtitles support for all subtitles formats. | |
888 .TP | |
889 .B \-nooverlapsub | |
890 Disables overlapping subtitles support for all subtitles formats (default | |
891 behaviour is to enable the support only for specific formats). | |
892 .TP | |
893 .B \-osdlevel <0\-3> (MPLAYER only) | |
894 Specifies which mode the OSD should start in. | |
895 | |
896 .PD 0 | |
897 .RSs | |
898 .IPs 0 | |
899 subtitles only | |
900 .IPs 1 | |
901 volume + seek (default) | |
902 .IPs 2 | |
903 volume + seek + timer + percentage | |
904 .IPs 3 | |
905 volume + seek + timer + percentage + total time | |
906 .RE | |
907 .PD 1 | |
908 . | |
909 .TP | |
910 .B \-sid <id> (also see \-slang option) | |
911 Turns on DVD subtitle displaying. | |
912 Also, you MUST specify a number which corresponds to a DVD subtitle language | |
913 (0\-31). | |
914 For the list of available subtitles, use with the \-v option and look at the | |
915 output. | |
916 .TP | |
917 .B \-slang <two\ letter\ country\ code> (also see \-sid option) | |
918 Works only for DVD playback. | |
919 Turns on/\:selects DVD subtitle language. | |
920 For the list of available subtitles, use with the \-v option and look at the | |
921 output. | |
922 | |
923 .I EXAMPLE: | |
924 .PD 0 | |
925 .RSs | |
926 .IPs "\-slang hu,en" | |
927 Selects Hungarian and falls back to English if Hungarian is not available. | |
928 .RE | |
929 .PD 1 | |
930 . | |
931 .TP | |
932 .B \-sub <subtitle\ file> | |
933 Use/\:display this subtitle file. | |
934 .TP | |
935 .B \-sub-bg-alpha <0\-255> | |
936 Specify the alpha channel value for subtitles and OSD backgrounds. | |
937 Big values mean more transparency. | |
938 The 0 value is an exception and means completly transparent. | |
939 .TP | |
940 .B \-sub-bg-color <0\-255> | |
941 Specify the color value for subtitles and OSD backgrounds. | |
942 Currently subtitles are grayscale so this value is equivalente to the | |
943 intensity of the color. | |
944 The 255 value means white and 0 black. | |
945 .TP | |
946 .B \-subcc \ | |
947 Display DVD Closed Caption (CC) subtitles. | |
948 These are NOT the VOB subtitles, these are special ASCII subtitles for the | |
949 hearing impaired encoded in the VOB userdata stream on most region 1 DVDs. | |
950 CC subtitles have not been spotted on DVDs from other regions so far. | |
951 .TP | |
952 .B \-subcp <codepage> | |
953 If your system supports iconv(3), you can use this option to | |
954 specify codepage of the subtitle. | |
955 | |
956 .I EXAMPLE: | |
957 .PD 0 | |
958 .RSs | |
959 \-subcp latin2 | |
960 .br | |
961 \-subcp cp1250 | |
962 .RE | |
963 .PD 1 | |
964 . | |
965 .TP | |
966 .B \-sub\-demuxer <number> (BETA CODE) | |
967 Force subtitle demuxer type for \-subfile. | |
968 .TP | |
969 .B \-subdelay <sec> | |
970 Delays subtitles by <sec> seconds. | |
971 Can be negative. | |
972 .TP | |
973 .B \-subfont-autoscale <0\-3> | |
974 Sets the autoscale mode. | |
975 | |
976 .I NOTE: | |
977 .br | |
978 Zero means that text-scale and osd-scale are font heights in points. | |
979 .br | |
980 The mode can be: | |
981 | |
982 .PD 0 | |
983 .RSs | |
984 .IPs 0 | |
985 no autoscale | |
986 .IPs 1 | |
987 proportional to movie height | |
988 .IPs 2 | |
989 proportional to movie width | |
990 .IPs 3 | |
991 proportional to movie diagonal (default) | |
992 .RE | |
993 .PD 1 | |
994 . | |
995 .TP | |
996 .B \-subfont-blur <0\-8> | |
997 Sets the font blur radius (default: 2). | |
998 .TP | |
999 .B \-subfont-encoding <value> | |
1000 Sets the font encoding. | |
1001 When set to 'unicode', all the glyphs from the font file will be rendered and | |
1002 unicode will be used (default: unicode). | |
1003 .TP | |
1004 .B \-subfont-osd-scale <0\-100> | |
1005 Sets the osd elements autoscale coefficient (default: 6). | |
1006 .TP | |
1007 .B \-subfont-outline <0\-8> | |
1008 Sets the font outline thickness (default: 2). | |
1009 .TP | |
1010 .B \-subfont-text-scale <0\-100> | |
1011 Sets the subtitle text autoscale coefficient (percentage of the | |
1012 screen size) (default: 5). | |
1013 .TP | |
1014 .B \-subfps <rate> | |
1015 Specify frame/\:sec rate of subtitle file (float number), | |
1016 default: the same fps as the movie. | |
1017 | |
1018 .I NOTE: | |
1019 .br | |
1020 ONLY for frame\-based SUB files, i.e.\& NOT MicroDVD format. | |
1021 .TP | |
1022 .B \-subfile <filename> (BETA CODE) | |
1023 Currently useless. | |
1024 Same as \-audiofile, but for subtitle streams (OggDS?). | |
1025 .TP | |
1026 .B \-subpos <0\-100> (useful with \-vop expand) | |
1027 Specify the position of subtitles on the screen. | |
1028 The value is the vertical position of the subtitle in % of the screen height. | |
1029 .TP | |
1030 .B \-subalign <0\-2> | |
1031 Specify how subtitles should be aligned with subpos. | |
1032 0 means align at top (original/default behavior), 1 means align at center, and | |
1033 2 means align at bottom. | |
1034 .TP | |
1035 .B \-subwidth <10\-100> | |
1036 Specify the maximum width of subtitles on the screen. | |
1037 Useful for TV-out. | |
1038 The value is the width of the subtitle in % of the screen width. | |
1039 .TP | |
1040 .B \-unicode | |
1041 Tells MPlayer to handle the subtitle file as UNICODE. | |
1042 .TP | |
1043 .B \-utf8 \ \ | |
1044 Tells MPlayer to handle the subtitle file as UTF8. | |
1045 .TP | |
1046 .B \-sub-no-text-pp | |
1047 Disables any kind of text post processing done after loading the subtitles. | |
1048 Used for debug purposes. | |
1049 .TP | |
1050 .B \-vobsub <vobsub\ file\ without\ extension> | |
1051 Specify the VobSub files that are to be used for subtitle. | |
1052 This is the full pathname without extensions, i.e.\& without the '.idx', | |
1053 \'.ifo' or '.sub'. | |
1054 .TP | |
1055 .B \-vobsubid <0-31> | |
1056 Specify the VobSub subtitle id. | |
1057 .TP | |
1058 .B \-spualign <-1\-2> | |
1059 Specify how spu (DVD/VobSub) subtitles should be aligned. | |
1060 Values are the same as for -subpos, with the extra choice -1 for original | |
1061 position. | |
1062 .TP | |
1063 .B \-spuaa <mode> | |
1064 Antialiasing/scaling mode for DVD/VobSub. A value of 16 may be added | |
1065 to mode in order to force scaling even when original and scaled frame | |
1066 size already match, for example to smooth subtitles with the gaussian | |
1067 blur. The available modes are: | |
1068 .PD 0 | |
1069 .RSs | |
1070 .IPs 0 | |
1071 none (fastest, very ugly) | |
1072 .IPs 1 | |
1073 approximate (broken?) | |
1074 .IPs 2 | |
1075 full (slow) | |
1076 .IPs 3 | |
1077 bilinear (default, fast and not too bad) | |
1078 .IPs 4 | |
1079 uses swscaler gaussian blur (looks very good) | |
1080 .RE | |
1081 .PD 1 | |
1082 . | |
1083 .TP | |
1084 .B \-spugauss <0.0\-3.0> | |
1085 Variance parameter of gaussian used by -spuaa 4. Higher means more | |
1086 blur. The default is 1.0. | |
1087 | |
1088 | |
1089 .SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)" | |
1090 .TP | |
1091 .B \-abs <value> (OBSOLETE) | |
1092 Override audio driver/\:card buffer size detection, \-ao oss only | |
1093 .TP | |
1094 .B \-af <plugin1,plugin2,plugin3[=options],...> | |
1095 Activate a comma separated list of audio filters and their options. | |
1096 .br | |
1097 Available filters are: | |
1098 . | |
1099 .RSs | |
1100 .IPs resample[=srate[:sloppy][:type]] | |
1101 Changes the sample rate of the audio stream to an integer srate (Hz). | |
1102 It only supports the 16 bit little endian format. | |
1103 .IPs channels[=nch] | |
1104 Change the number of channels to nch output channels. | |
1105 If the number of output channels is bigger than the number of input channels | |
1106 empty channels are inserted (except mixing from mono to stereo, then the mono | |
1107 channel is repeated in both of the output channels). | |
1108 If the number of output channels is smaller than the number of input channels | |
1109 the exceeding channels are truncated. | |
1110 .IPs format[=bps,f] | |
1111 Select the format f and bits per sample bps used for output from the | |
1112 filter layer. | |
1113 The option bps is an integer and denotes bytes per sample. | |
1114 The format f is a string containing a concatenated mix of: | |
1115 .br | |
1116 alaw, mulaw or imaadpcm | |
1117 .br | |
1118 float or int | |
1119 .br | |
1120 unsigned or signed | |
1121 .br | |
1122 le or be (little or big endian) | |
1123 .br | |
1124 .IPs "volume[=v:sc]" | |
1125 Select the output volume level. | |
1126 This filter is not reentrant and can therefore only be enabled once for every | |
1127 audio stream. | |
1128 .RSss | |
1129 v: desired gain in dB for all channels in the stream. | |
1130 The gain can be set from -200dB to +40dB (where -200dB mutes the sound | |
1131 completely and +40dB equals a gain of 1000). | |
1132 .br | |
1133 sc: enable soft clipping. | |
1134 .REss | |
1135 .IPs "pan[=n:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...]" | |
1136 Mixes channels arbitrarily, see DOCS/sound.html for details. | |
1137 .RSss | |
1138 n: number of output channels (1 - 6). | |
1139 .br | |
1140 lij: how much of input channel j is mixed into output channel i. | |
1141 .REss | |
1142 .IPs "sub[=fc:ch]" | |
1143 Add sub-woofer channel. | |
1144 .RSss | |
1145 fc: Cutoff frequency for low-pass filter (20Hz to 300Hz) default is 60Hz. | |
1146 .br | |
1147 ch: channel number for the sub-channel. | |
1148 .REss | |
1149 .IPs "surround[=d]" | |
1150 Decoder for matrix encoded surround sound, works on many 2 channel files. | |
1151 .RSss | |
1152 d: delay time in ms for the rear speakers (0ms to 1000ms) default is 15ms. | |
1153 .REss | |
1154 .IPs delay[=ch1:ch2:...] | |
1155 Delays the sound output. | |
1156 Specify the delay separately for each channel in milliseconds (floating point | |
1157 number between 0 and 1000). | |
1158 .RE | |
1159 . | |
1160 .TP | |
1161 .B \-af-adv <force=(0\-3):list=(filters)> (see -af option too) | |
1162 Specify advanced audio filter options: | |
1163 . | |
1164 .RSs | |
1165 .IPs force=<0-3> | |
1166 Forces the insertion of audio filters to one of the following: | |
1167 .RSss | |
1168 0: Completely automatic insertion of filters (default) | |
1169 .br | |
1170 1: Optimize for speed | |
1171 .br | |
1172 2: Optimize for accuracy | |
1173 .br | |
1174 3: Turn off auto | |
1175 .REss | |
1176 .IPs list=<filters> | |
1177 Same as -af (see -af option). | |
1178 .RE | |
1179 . | |
1180 .TP | |
1181 .B \-ao <driver1[:device],driver2,...[,]> | |
1182 Specify a priority list of audio output drivers (optionally with device) to be | |
1183 used. | |
1184 \'device' is valid with SDL, too, it means subdriver then. | |
1185 | |
1186 .I NOTE: | |
1187 .br | |
1188 To get a full list of available drivers, see \-ao help. | |
1189 .br | |
1190 If the list has a trailing ',' it will fallback to drivers not listed. | |
1191 | |
1192 .I EXAMPLE | |
1193 .PD 0 | |
1194 .RSs | |
1195 .IPs "\-ao oss:/\:dev/\:dsp2,oss:/\:dev/\:dsp1," | |
1196 try to use OSS with the specified sound devices and fallback to others if it | |
1197 fails | |
1198 .IPs "\-ao sdl:esd" | |
1199 specify the SDL subdriver | |
1200 .RE | |
1201 .PD 1 | |
1202 . | |
1203 .TP | |
1204 .B \-aofile <filename> | |
1205 Filename for \-ao pcm. | |
1206 .TP | |
1207 .B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...> | |
1208 Specify audio plugin(s) and their options (see documentation too). | |
1209 .br | |
1210 Available options are: | |
1211 . | |
1212 .RSs | |
1213 .IPs list=[plugins] | |
1214 comma separated list of plugins (resample, surround, format, volume, | |
1215 extrastereo, volnorm) | |
1216 .IPs delay=<sec> | |
1217 example plugin, do not use. | |
1218 .IPs format=<format> | |
1219 output format (format plugin only) | |
1220 .IPs fout=<Hz> | |
1221 output frequency (resample plugin only) | |
1222 .IPs volume=<0\-255> | |
1223 volume (volume plugin only) | |
1224 .IPs mul=<value> | |
1225 stereo coefficient (default: 2.5) (extrastereo plugin only) | |
1226 .IPs softclip | |
1227 compressor / 'soft\-clipping' capabilities (volume plugin only) | |
1228 .RE | |
1229 . | |
1230 .TP | |
1231 .B \-delay <sec> | |
1232 Audio delay in seconds (may be +/\:\- float value). | |
1233 .TP | |
1234 .B \-format <0\-8192> | |
1235 Select the format used for output from the filter layer (according to the | |
1236 defines in libao2/afmt.h): | |
1237 | |
1238 .PD 0 | |
1239 .RSs | |
1240 .IPs 1 | |
1241 Mu-Law | |
1242 .IPs 2 | |
1243 A-Law | |
1244 .IPs 4 | |
1245 Ima-ADPCM | |
1246 .IPs 8 | |
1247 Signed 8-bit | |
1248 .IPs 16 | |
1249 Unsigned 8-bit | |
1250 .IPs 32 | |
1251 Unsigned 16-bit (Little-Endian) | |
1252 .IPs 64 | |
1253 Unsigned 16-bit (Big-Endian) | |
1254 .IPs 128 | |
1255 Signed 16-bit (Little-Endian) | |
1256 .IPs 256 | |
1257 Signed 16-bit (Big-Endian) | |
1258 .IPs 512 | |
1259 MPEG (2) Audio | |
1260 .IPs 1024 | |
1261 AC3 | |
1262 .IPs 4096 | |
1263 Signed 32-bit (Little-Endian) | |
1264 .IPs 8192 | |
1265 Signed 32-bit (Big-Endian) | |
1266 .RE | |
1267 .PD 1 | |
1268 . | |
1269 .TP | |
1270 .B \-mixer <device> | |
1271 This option will tell MPlayer to use a different device for mixing than | |
1272 /dev/\:mixer. | |
1273 .TP | |
1274 .B \-nowaveheader (-ao pcm only) | |
1275 Don't include wave header. | |
1276 Used for RAW PCM. | |
1277 | |
1278 | |
1279 .SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)" | |
1280 .TP | |
1281 .B \-aa* (\-vo aa only) | |
1282 You can get a list and an explanation of available options executing | |
1283 .I mplayer \-aahelp | |
1284 .TP | |
1285 .B \-bpp <depth> | |
1286 Use different color depth than autodetect. | |
1287 Not all \-vo drivers support it (fbdev, dga2, svga, vesa). | |
1288 .TP | |
1289 .B \-brightness <\-100\-100> | |
1290 Adjust brightness of video output (default 0). | |
1291 It changes intensity of RGB components of video signal from black to white | |
1292 screen. | |
1293 .TP | |
1294 .B \-contrast <\-100\-100> | |
1295 Adjust contrast of video output (default 0). | |
1296 Works in similar manner as brightness. | |
1297 .TP | |
1298 .B \-dfbopts <value> (\-vo directfb2 only) | |
1299 Specify a parameter list for the directfb driver. | |
1300 .TP | |
1301 .B \-display <name> | |
1302 Specify the hostname and display number of the X server you want to display | |
1303 on. | |
1304 | |
1305 .I EXAMPLE: | |
1306 .PD 0 | |
1307 .RSs | |
1308 \-display xtest.localdomain:0 | |
1309 .RE | |
1310 .PD 1 | |
1311 . | |
1312 .TP | |
1313 .B \-double | |
1314 Enables doublebuffering. | |
1315 Fixes flicker by storing two frames in memory, and displaying one while | |
1316 decoding another. | |
1317 Can affect OSD. | |
1318 Needs twice the memory of a single buffer, so it won't work on cards with | |
1319 very little video memory. | |
1320 .TP | |
1321 .B \-dr \ \ \ | |
1322 Turns on direct rendering (not supported by all codecs and video outputs) | |
1323 (default is off). | |
1324 Warning: may cause OSD/\:SUB corruption! | |
1325 .TP | |
1326 .B \-dxr2 <option1:option2:...> | |
1327 This option is used to control the dxr2 driver. | |
1328 Note: The lavc filter is now auto inserted if you try to play a non MPEG1/2 | |
1329 format so all formats supported by MPlayer should play out of the box (if | |
1330 you have the CPU power needed to encode on the fly). | |
1331 The overlay chipset used on the dxr2 is of pretty bad quality but the default | |
1332 settings should work for everybody. | |
1333 The OSD may be usable with the overlay (not on TV) by drawing it in the | |
1334 colorkey. | |
1335 With the default colorkey settings you may get variable results, usually you | |
1336 will see the colorkey around the characters or some other funny effect. | |
1337 But if you properly adjust the colorkey settings you should be able to get | |
1338 acceptable results. | |
1339 . | |
1340 .RSs | |
1341 .IPs ar-mode=<value> | |
1342 aspect ratio mode (0 = normal, 1 = pan scan, 2 = letterbox (default)) | |
1343 .IPs iec958\-encoded/\:decoded | |
1344 iec958 output mode | |
1345 .IPs mute | |
1346 mute sound output | |
1347 .IPs ucode=<value> | |
1348 path to the microcode | |
1349 .RE | |
1350 .RS | |
1351 | |
1352 .I TV Out | |
1353 .RE | |
1354 .RSs | |
1355 .IPs 75ire | |
1356 enable 7.5 IRE | |
1357 .IPs bw\ \ \ | |
1358 b/\:w TV output | |
1359 .IPs color | |
1360 color TV output | |
1361 .IPs interlaced | |
1362 interlaced TV output | |
1363 .IPs macrovision=<value> | |
1364 macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe, | |
1365 3 = agc 4 colorstripe) | |
1366 .IPs norm=<value> | |
1367 TV norm (ntsc (default), pal,pal60,palm,paln,palnc) | |
1368 .IPs square/\:ccir601\-pixel | |
1369 TV pixel mode | |
1370 .RE | |
1371 .RS | |
1372 | |
1373 .I Overlay | |
1374 .RE | |
1375 .RSs | |
1376 .IPs cr-[left|right|top|bot]=<\-20\-20> | |
1377 adjust the overlay cropping | |
1378 .IPs ck-[rgb]min=<0\-255> | |
1379 minimum value for the color key | |
1380 .IPs ck-[rgb]max=<0\-255> | |
1381 maximum value for the color key | |
1382 .IPs ck-[rgb]=<0\-255> | |
1383 color key values | |
1384 .IPs ignore\-cache | |
1385 do not use the VGA cache | |
1386 .IPs ol-osd | |
1387 enable the osd hack on the overlay | |
1388 .IPs ol[hwxy]\-cor=<value> | |
1389 adjust the overlay size and position in case it doesn't match the window | |
1390 perfectly | |
1391 .IPs overlay | |
1392 enable the overlay | |
1393 .IPs overlay-ratio=<1\-2500> | |
1394 tune the overlay (default 1000) | |
1395 .IPs update\-cache | |
1396 recreate the VGA cache | |
1397 .RE | |
1398 . | |
1399 .TP | |
1400 .B \-fb <device> (fbdev or DirectFB only) | |
1401 Specifies the framebuffer device to use. | |
1402 By default it uses /dev/\:fb0. | |
1403 .TP | |
1404 .B \-fbmode <modename> (fbdev only) | |
1405 Change video mode to the one that is labelled as <modename> in | |
1406 /etc/\:fb.modes. | |
1407 | |
1408 .I NOTE: | |
1409 .br | |
1410 VESA framebuffer doesn't support mode changing. | |
1411 .TP | |
1412 .B \-fbmodeconfig <filename> (fbdev only) | |
1413 Use this configuration file instead of the default /etc/\:fb.modes. | |
1414 Only valid for the fbdev driver. | |
1415 .TP | |
1416 .B \-forcexv (SDL only) | |
1417 Force using XVideo. | |
1418 .TP | |
1419 .B \-fs \ \ \ | |
1420 Fullscreen playing (centers movie, and makes black | |
1421 bands around it). | |
1422 Toggle it with the 'f' key (not all video outputs support it). | |
1423 See also \-zoom. | |
1424 .TP | |
1425 .B \-fsmode-dontuse <0-31> (OBSOLETE) (use \-fs option) | |
1426 Try this option if you still experience fullscreen problems. | |
1427 .TP | |
1428 .B \-fstype <type1,type2,...> | |
1429 Specify a priority list of fullscreen layer setting modes to be | |
1430 used. | |
1431 | |
1432 The default order is "layer,stays_on_top,above,fullscreen". It will be used | |
1433 as a fallback in case of specifying incorrect or unsupported modes. | |
1434 .br | |
1435 If you experience problems with fullscreen window being covered by other | |
1436 windows try using different order. | |
1437 | |
1438 .I NOTE: | |
1439 .br | |
1440 See \-fstype help for a full list of available modes. | |
1441 .TP | |
1442 .B \-geometry x[%][:y[%]] or [WxH][+x+y] | |
1443 Adjust where the output is on the screen initially. | |
1444 The x and y specifications are in pixels measured from the top-right of the | |
1445 screen to the top-right of the image being displayed, however if a percentage | |
1446 sign is given after the argument it turns the value into a percentage of the | |
1447 screen size in that direction. | |
1448 It also supports the standard option format to the standard X \-geometry | |
1449 option. | |
1450 The values given must be integers. | |
1451 | |
1452 Note: This option is only supported by a few vo's, including tdfxfb, fbdev and | |
1453 xv. | |
1454 | |
1455 .I EXAMPLE: | |
1456 .PD 0 | |
1457 .RSs | |
1458 .IPs 50:40 | |
1459 Places the window at x=50, y=40 | |
1460 .IPs 50%:50% | |
1461 Places the window in the middle of the screen | |
1462 .IPs 100% | |
1463 Places the window at the top left corner of the screen | |
1464 .IPs 100%:100% | |
1465 Places the window at the bottom left corner of the screen | |
1466 .RE | |
1467 .PD 1 | |
1468 . | |
1469 .TP | |
1470 .B \-guiwid <window\ id> | |
1471 This tells the GUI to also use an X11 window and stick itself to the bottom | |
1472 of the video, which is useful to embed a mini-GUI in a browser (with the | |
1473 mplayerplug-in for instance). | |
1474 .TP | |
1475 .B \-hue <\-100\-100> | |
1476 Adjust hue of video signal (default: 0). | |
1477 You can get colored negative of image with this option. | |
1478 .TP | |
1479 .B \-icelayer <0\-15> (icewm only) | |
1480 Sets the layer of the fullscreen window of mplayer for icewm. | |
1481 | |
1482 .PD 0 | |
1483 .RSs | |
1484 .IPs 0 | |
1485 Desktop | |
1486 .IPs 2 | |
1487 Below | |
1488 .IPs 4 | |
1489 Normal | |
1490 .IPs 6 | |
1491 OnTop | |
1492 .IPs 8 | |
1493 Dock | |
1494 .IPs 10 | |
1495 AboveDock | |
1496 .IPs 12 | |
1497 Menu (default) | |
1498 .RE | |
1499 .PD 1 | |
1500 . | |
1501 .TP | |
1502 .B \-jpeg <option1:option2:...> (\-vo jpeg only) | |
1503 Specify options for the JPEG output. | |
1504 .br | |
1505 Available options are: | |
1506 | |
1507 .PD 0 | |
1508 .RSs | |
1509 .IPs [no]progressive | |
1510 Specify standard or progressive JPEG. | |
1511 .IPs [no]baseline | |
1512 Specify use of baseline or not. | |
1513 .IPs optimize=<value> | |
1514 Optimization factor [0-100] | |
1515 .IPs smooth=<value> | |
1516 Smooth factor [0-100] | |
1517 .IPs quality=<value> | |
1518 Quality factor [0-100] | |
1519 .IPs outdir=<value> | |
1520 Directory to save the JPEG files | |
1521 .RE | |
1522 .PD 1 | |
1523 . | |
1524 .TP | |
1525 .B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (fbdev and vesa only) | |
1526 Look into etc/\:example.conf for further information and in DOCS/\:video.html. | |
1527 .TP | |
1528 .B \-monitor_hfreq <horizontal frequency range> (fbdev and vesa only) | |
1529 .TP | |
1530 .B \-monitor_vfreq <vertical frequency range> (fbdev and vesa only) | |
1531 .TP | |
1532 .B \-monitoraspect <ratio> | |
1533 Set aspect ratio of your monitor or TV screen. | |
1534 See also \-aspect for movie aspect. | |
1535 | |
1536 .I EXAMPLE: | |
1537 .PD 0 | |
1538 .RSs | |
1539 \-monitoraspect 4:3 or 1.3333 | |
1540 .br | |
1541 \-monitoraspect 16:9 or 1.7777 | |
1542 .RE | |
1543 .PD 1 | |
1544 . | |
1545 .TP | |
1546 .B \-nograbpointer | |
1547 Do not grab mouse pointer after VidMode change (\-vm), useful for multihead | |
1548 setup. | |
1549 | |
1550 .TP | |
1551 .B \-nokeepaspect | |
1552 Do not keep window aspect ratio when resizing X11 windows (Works currently only | |
1553 with \-vo x11, xv, xmga and xvidix and your window manager needs to understand | |
1554 window aspect hints.). | |
1555 | |
1556 .TP | |
1557 .B \-noslices | |
1558 Disable drawing video by 16-pixel height slices/\:bands, instead draws the | |
1559 whole frame in a single run. | |
1560 May be faster or slower, depending on card/\:cache. | |
1561 It has effect only with libmpeg2 and libavcodec codecs. | |
1562 .TP | |
1563 .B \-panscan <0.0\-1.0> | |
1564 Enables Pan & Scan functionality, i.e.\& in order to display a 16:9 movie | |
1565 on a 4:3 display, the sides of the movie are cropped to get a 4:3 image | |
1566 which fits the screen. | |
1567 This function works only with the xv, xmga, mga and xvidix video out drivers. | |
1568 .br | |
1569 The range controls how much of the image is cropped. | |
1570 .TP | |
1571 .B \-rootwin | |
1572 Play movie in the root window (desktop background) instead of opening | |
1573 a new one. | |
1574 Works only with x11, xv, xmga and xvidix drivers. | |
1575 .TP | |
1576 .B \-saturation <\-100\-100> | |
1577 Adjust saturation of video output (default: 0). | |
1578 You can get grayscale output with this option. | |
1579 .TP | |
1580 .B \-screenw <pixels> \-screenh <pixels> | |
1581 If you use an output driver which can't know the resolution of the screen | |
1582 (fbdev/\:x11 and/\:or TVout) this is where you can specify the horizontal and | |
1583 vertical resolution. | |
1584 .TP | |
1585 .B \-stop_xscreensaver | |
1586 Turns off xscreensaver at startup and turns it on again on exit. | |
1587 .TP | |
1588 .B \-vm \ \ \ | |
1589 Try to change to a better video mode. | |
1590 dga, x11/\:xv (XF86VidMode) and sdl output drivers support it. | |
1591 .TP | |
1592 .B \-vo <driver1[:device],driver2,...[,]> | |
1593 Specify a priority list of video output drivers (optionally with device) to be | |
1594 used. | |
1595 \'device' is valid with SDL and GGI, too, it means subdriver then. | |
1596 | |
1597 .I NOTE: | |
1598 .br | |
1599 See \-vo help for a full list of available drivers. | |
1600 .br | |
1601 If the list has a trailing ',' it will fallback to drivers not listed. | |
1602 | |
1603 .I EXAMPLE: | |
1604 .PD 0 | |
1605 .RSs | |
1606 .IPs "\-vo xmga,xv," | |
1607 Try Matrox kernel driver, then Xv driver, then others | |
1608 .br | |
1609 .IPs "\-vo sdl:aalib" | |
1610 specify the SDL subdriver | |
1611 .RE | |
1612 .PD 1 | |
1613 . | |
1614 .TP | |
1615 .B \-vsync \ \ | |
1616 Enables VBI for vesa. | |
1617 .TP | |
1618 .B \-wid <window\ id> | |
1619 This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a | |
1620 browser (with the plugger extension for instance). | |
1621 .TP | |
1622 .B \-xineramascreen <0\-...> | |
1623 In Xinerama configurations (i.e.\& a single desktop that spans across multiple | |
1624 displays) this option tells MPlayer which screen to display movie on. | |
1625 .TP | |
1626 .B \-z <0\-9> | |
1627 Specifies compression level for PNG output (-vo png) | |
1628 | |
1629 .PD 0 | |
1630 .RSs | |
1631 .IPs 0 | |
1632 no compression | |
1633 .IPs 9 | |
1634 max compression | |
1635 .RE | |
1636 .PD 1 | |
1637 . | |
1638 .TP | |
1639 .B \-zrbw (\-vo zr only) | |
1640 Display in black and white (for optimal performance, this option can be | |
1641 combined with the 'decode only in black and white' option for codecs | |
1642 belonging to the FFmpeg family). | |
1643 .TP | |
1644 .B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only) | |
1645 Select a part of the input image for display, multiple occurences of this | |
1646 option switch on cinerama mode. | |
1647 In cinerama mode the movie is distributed over more than one TV (or beamer) to | |
1648 create a larger screen. | |
1649 Options appearing after the n\-th \-zrcrop apply to the n\-th MJPEG card, each | |
1650 card should at least have a \-zrdev in addition to the \-zrcrop. | |
1651 For examples, see the output of \-zrhelp and the Zr section of the | |
1652 documentation. | |
1653 .TP | |
1654 .B \-zrdev <device> (\-vo zr only) | |
1655 Specify the device special file that belongs to your MJPEG card, by default | |
1656 this driver takes the first v4l device it can find. | |
1657 .TP | |
1658 .B \-zrfd (\-vo zr only) | |
1659 Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only | |
1660 happens if the hardware scaler can stretch the image to its original size. | |
1661 Use this option to force decimation. | |
1662 .TP | |
1663 .B \-zrhelp (\-vo zr only) | |
1664 Display a list of all \-zr* options, their default values and an example of | |
1665 cinerama mode. | |
1666 .TP | |
1667 .B \-zrnorm <norm> (\-vo zr only) | |
1668 Specify norm PAL/\:NTSC, the default is 'no change'. | |
1669 .TP | |
1670 .B \-zrquality <1\-20> (\-vo zr only) | |
1671 A number from 1 to 20 representing the jpeg encoding quality. | |
1672 1 gives the best quality and 20 gives very bad quality. | |
1673 .TP | |
1674 .B \-zrvdec <1,2,4> \-zrhdec <1,2,4> (\-vo zr only) | |
1675 Vertical/\:horizontal decimation: Ask the driver to send only every 2nd or 4th | |
1676 line/\:pixel of the input image to the MJPEG card and use the scaler of the | |
1677 MJPEG card to strech the image to its original size. | |
1678 .TP | |
1679 .B \-zrxdoff <x display offset>, \-zrydoff <y display offset> (\-vo zr only) | |
1680 If the movie is smaller than the TV screen, these options control the position | |
1681 of the movie relative to the upper left corner of the screen. | |
1682 The movie is centered by default. | |
1683 | |
1684 | |
1685 .SH "DECODING/FILTERING OPTIONS" | |
1686 .TP | |
1687 .B \-ac <[-]codec1,[-]codec2,...[,]> | |
1688 Specify a priority list of audio codecs to be used, according to their codec | |
1689 name in codecs.conf. | |
1690 Use a '-' before the codec name to omit it. | |
1691 | |
1692 .I NOTE: | |
1693 .br | |
1694 See \-ac help for a full list of available codecs. | |
1695 .br | |
1696 If the list has a trailing ',' it will fallback to codecs not listed. | |
1697 | |
1698 .I EXAMPLE: | |
1699 .PD 0 | |
1700 .RSs | |
1701 .IPs "\-ac mp3acm" | |
1702 force l3codeca.acm MP3 codec | |
1703 .IPs "\-ac mad," | |
1704 try libmad first, then fallback to others | |
1705 .IPs "\-ac hwac3,a52," | |
1706 try hardware AC3 passthrough, then software AC3 codec, then others | |
1707 .IPs "\-ac -ffmp3," | |
1708 try other codecs except FFmpeg's MP3 decoder | |
1709 .RE | |
1710 .PD 1 | |
1711 . | |
1712 .TP | |
1713 .B \-afm <driver1,driver2,...> | |
1714 Specify a priority list of audio drivers to be used, according to their driver | |
1715 name in codecs.conf. | |
1716 It falls back to default if none is ok. | |
1717 | |
1718 .I NOTE: | |
1719 .br | |
1720 See \-afm help for a full list of available drivers. | |
1721 | |
1722 .I EXAMPLE: | |
1723 .PD 0 | |
1724 .RSs | |
1725 .IPs "\-afm ffmpeg" | |
1726 try FFmpeg's libavcodec (mp1/\:2/\:3) codecs first | |
1727 .IPs "\-afm acm,dshow" | |
1728 try Win32 codecs first | |
1729 .RE | |
1730 .PD 1 | |
1731 . | |
1732 .TP | |
1733 .B \-aspect <ratio> | |
1734 Override aspect ratio of movies. | |
1735 It's autodetected on MPEG files, but can't be autodetected on most AVI files. | |
1736 | |
1737 .I EXAMPLE: | |
1738 .PD 0 | |
1739 .RSs | |
1740 \-aspect 4:3 or \-aspect 1.3333 | |
1741 .br | |
1742 \-aspect 16:9 or \-aspect 1.7777 | |
1743 .RE | |
1744 .PD 1 | |
1745 . | |
1746 .TP | |
1747 .B \-flip \ | |
1748 Flip image upside\-down. | |
1749 .TP | |
1750 .B \-lavdopts <option1:option2:...> (DEBUG CODE) | |
1751 If decoding with a codec from libavcodec, you can specify its parameters here. | |
1752 | |
1753 .I EXAMPLE: | |
1754 .PD 0 | |
1755 .RSs | |
1756 \-lavdopts bug=1 | |
1757 .RE | |
1758 .PD 1 | |
1759 | |
1760 .RS | |
1761 .I NOTE: | |
1762 .br | |
1763 Just add the values of the things you want to enable. | |
1764 .br | |
1765 Available options are: | |
1766 .RE | |
1767 . | |
1768 .RSs | |
1769 .IPs ec\ \ \ | |
1770 error concealment: | |
1771 .RSss | |
1772 1: use strong deblock filter for damaged MBs | |
1773 .br | |
1774 2: iterative MV search (slow) | |
1775 .br | |
1776 3: all (default) | |
1777 .REss | |
1778 .IPs er=<value> | |
1779 error resilience: | |
1780 .RSss | |
1781 .br | |
1782 0: disabled | |
1783 .br | |
1784 1: careful (should work with broken encoders) | |
1785 .br | |
1786 2: normal (default) (works with compliant encoders) | |
1787 .br | |
1788 3: agressive (more checks but might cause problems even for valid bitstreams) | |
1789 .br | |
1790 4: very agressive | |
1791 .REss | |
1792 .IPs bug=<value> | |
1793 manually work around encoder bugs: | |
1794 .RSss | |
1795 0: nothing | |
1796 .br | |
1797 1: autodetect bugs (default) | |
1798 .br | |
1799 2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetect) | |
1800 .br | |
1801 4 (mpeg4): xvid interlacing bug (autodetected if fourcc==XVIX) | |
1802 .br | |
1803 8 (mpeg4): UMP4 (autodetected if fourcc==UMP4) | |
1804 .br | |
1805 16 (mpeg4): padding bug | |
1806 .br | |
1807 32 (mpeg4): illegal vlc bug (autodetected per fourcc) | |
1808 .br | |
1809 64 (mpeg4): XVID and DIVX qpel bug (autodetected) | |
1810 .REss | |
1811 .IPs idct=<0\-99> | |
1812 (see lavcopts) | |
1813 .IPs gray | |
1814 grayscale only decoding (a bit faster than with color) | |
1815 .RE | |
1816 . | |
1817 .TP | |
1818 .B \-noaspect | |
1819 Disable automatic movie aspect ratio compensation. | |
1820 .TP | |
1821 .B \-nosound | |
1822 Do not play/\:encode sound. | |
1823 .TP | |
1824 .B \-pp <quality> (see \-vop pp option too!) | |
1825 Set postprocess level of the DLL. | |
1826 This option is NO LONGER USABLE with MPlayer's postprocess filter, but only | |
1827 with Win32 DirectShow DLLs which have internal postprocessing routine. | |
1828 | |
1829 The valid range of \-pp value vary on codecs, mostly | |
1830 0\-6, where 0=disable 6=slowest/\:best. | |
1831 .TP | |
1832 .B \-pphelp (see \-vop pp option too) | |
1833 Show a summary about the available postprocess filters and their usage. | |
1834 .TP | |
1835 .B \-ssf <mode> | |
1836 Specifies SwScaler parameters. | |
1837 | |
1838 .I EXAMPLE | |
1839 .PD 0 | |
1840 .RSs | |
1841 \-vop scale \-ssf lgb=3.0 | |
1842 .RE | |
1843 .PD 1 | |
1844 | |
1845 .PD 0 | |
1846 .RSs | |
1847 .IPs lgb=<0\-100> | |
1848 Gaussian blur filter (luma) | |
1849 .IPs cgb=<0\-100> | |
1850 Gaussian blur filter (chroma) | |
1851 .IPs ls=<0\-100> | |
1852 sharpen filter (luma) | |
1853 .IPs cs=<0\-100> | |
1854 sharpen filter (chroma) | |
1855 .IPs chs=<h> | |
1856 chroma horizontal shifting | |
1857 .IPs cvs=<v> | |
1858 chroma vertical shifting | |
1859 .RE | |
1860 .PD 1 | |
1861 . | |
1862 .TP | |
1863 .B \-stereo <mode> | |
1864 Select type of MP2/\:MP3 stereo output. | |
1865 | |
1866 .PD 0 | |
1867 .RSs | |
1868 .IPs 0 | |
1869 Stereo | |
1870 .IPs 1 | |
1871 Left channel | |
1872 .IPs 2 | |
1873 Right channel | |
1874 .RE | |
1875 .PD 1 | |
1876 . | |
1877 .TP | |
1878 .B \-sws <software\ scaler\ type> (see \-vop scale option too) | |
1879 This option sets the quality (and speed, respectively) of the software scaler, | |
1880 with the \-zoom option. | |
1881 For example with x11 or other outputs which lack hardware acceleration. | |
1882 Possible settings are: | |
1883 | |
1884 .I NOTE: | |
1885 .br | |
1886 For \-sws\ 2 and 7, the sharpness can be set with the scaling parameter (p) | |
1887 of \-vop scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter | |
1888 length (1 \- 10). | |
1889 | |
1890 .PD 0 | |
1891 .RSs | |
1892 .IPs 0 | |
1893 fast bilinear (default) | |
1894 .IPs 1 | |
1895 bilinear | |
1896 .IPs 2 | |
1897 bicubic (good quality) | |
1898 .IPs 3 | |
1899 experimental | |
1900 .IPs 4 | |
1901 nearest neighbour (bad quality) | |
1902 .IPs 5 | |
1903 area | |
1904 .IPs 6 | |
1905 luma bicubic / chroma bilinear | |
1906 .IPs 7 | |
1907 gauss | |
1908 .IPs 8 | |
1909 sincR | |
1910 .IPs 9 | |
1911 lanczos | |
1912 .IPs 10 | |
1913 bicubic spline | |
1914 .RE | |
1915 .PD 1 | |
1916 . | |
1917 .TP | |
1918 .B \-vc <[-]codec1,[-]codec2,...[,]> | |
1919 Specify a priority list of video codecs to be used, according to their codec | |
1920 name in codecs.conf. | |
1921 Use a '-' before the codec name to omit it. | |
1922 | |
1923 .I NOTE: | |
1924 .br | |
1925 See \-vc help for a full list of available codecs. | |
1926 .br | |
1927 If the list has a trailing ',' it will fallback to codecs not listed. | |
1928 | |
1929 .I EXAMPLE: | |
1930 .PD 0 | |
1931 .RSs | |
1932 .IPs "\-vc divx" | |
1933 force Win32/\:VFW DivX codec, no fallback | |
1934 .IPs "\-vc divx4," | |
1935 try divx4linux codec first, then fallback to others | |
1936 .IPs "\-vc -divxds,-divx," | |
1937 try other codecs except Win32 DivX codecs | |
1938 .IPs "\-vc ffmpeg12,mpeg12," | |
1939 try libavcodec's MPEG1/\:2 codec, then libmpeg2, then others | |
1940 .RE | |
1941 .PD 1 | |
1942 . | |
1943 .TP | |
1944 .B \-vfm <driver1,driver2,...> | |
1945 Specify a priority list of video drivers to be used, according to their driver | |
1946 name in codecs.conf. | |
1947 It falls back to default if none is ok. | |
1948 | |
1949 .I NOTE: | |
1950 .br | |
1951 If libdivxdecore support was compiled in, then odivx and divx4 now contains | |
1952 just the same DivX4 codec, but different APIs to reach it. | |
1953 For difference between them and when to use which, check the DivX4 section in | |
1954 the documentation. | |
1955 .br | |
1956 See \-vfm help for a full list of available drivers. | |
1957 | |
1958 .I EXAMPLE: | |
1959 .PD 0 | |
1960 .RSs | |
1961 .IPs "\-vfm ffmpeg,dshow,vfw" | |
1962 try the libavcodec, then Directshow, then VFW codecs and fallback to the | |
1963 others, if still none is ok | |
1964 .IPs "\-vfm xanim" | |
1965 try XAnim codecs first | |
1966 .RE | |
1967 .PD 1 | |
1968 . | |
1969 .TP | |
1970 .B \-vop <...,filter3[=options],filter2,filter1> | |
1971 Activate a comma separated list of video filters and their options in reverse | |
1972 order. | |
1973 | |
1974 .I NOTE: | |
1975 .br | |
1976 The parameters are optional and if omitted, some of them are set to default | |
1977 values. | |
1978 Use -1 to keep the default value. | |
1979 Parameters w:h means width x height in pixels, x:y means x;y position counted | |
1980 from the upper left corner of the bigger image. | |
1981 .br | |
1982 To get a full list of available plugins, see \-vop help. | |
1983 .br | |
1984 Available filters are: | |
1985 . | |
1986 .RSs | |
1987 .IPs crop[=w:h:x:y] | |
1988 Crops the given part of the image and discards the rest. | |
1989 Useful to remove black bands from widescreen movies. | |
1990 .IPs cropdetect[=0\-255] | |
1991 Calculates necessary cropping parameters and prints the recommended parameters | |
1992 to stdout. | |
1993 The threshold can be optionally specified from nothing (0) to everything | |
1994 (255). | |
1995 (default: 24) | |
1996 .IPs rectangle[=w:h:x:y] | |
1997 Draws a rectangle of the requested width and height at the specified | |
1998 coordinates over the image (used to test crop). | |
1999 (default: maximum w/\:h, upper left x/\:y position) | |
2000 .IPs expand[=w:h:x:y:o] | |
2001 Expands (not scales) movie resolution to the given value and places the | |
2002 unscaled original at coordinates x y. Negative values for w and h are | |
2003 treated as offsets to the original size. For example, expand=0:-50:0:0 | |
2004 adds a 50 pixel border to the bottom of the picture. | |
2005 Can be used for placing subtitles/\:OSD in the resulting black bands (default: | |
2006 original w/\:h, centered x/\:y). | |
2007 The last parameter (de)activates OSD rendering (default: 0=disabled). | |
2008 .IPs flip | |
2009 Flips the image upside down. | |
2010 See also option \-flip. | |
2011 .IPs mirror | |
2012 Flips the image on Y axis. | |
2013 .IPs rotate[=<0-7>] | |
2014 Rotates and flips (optional) the image +/\:\- 90 degrees. | |
2015 For parameters between 4-7 rotation is only done if the movie's geometry is | |
2016 portrait and not landscape. | |
2017 .IPs scale[=w:h[:c[:p]]] | |
2018 Scales the image with the software scaler (slow) and performs a YUV<\->RGB | |
2019 colorspace conversion (see \-sws option too). | |
2020 The value 0 is used for scaled (aspect) destination w/\:h. | |
2021 (default: original w/\:h, destination w/\:h with \-zoom) Optionaly chroma | |
2022 skipping (c from 0\-3) and scaling parameters can be specified. | |
2023 (see the \-sws option for details) | |
2024 .IPs yuy2 | |
2025 Forces software YV12/\:I420 or 422P to YUY2 conversion. | |
2026 .IPs rgb2bgr[=swap] | |
2027 RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion with optional R <\-> B | |
2028 swapping. | |
2029 .IPs palette | |
2030 RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette. | |
2031 .IPs format[=fourcc] | |
2032 Restricts the colorspace for next filter. | |
2033 It does not do any conversion. | |
2034 Use together with the scale filter for a real conversion. | |
2035 .IPs pp[=filter1[:option1[:option2...]]/[-]filter2...] (see \-pphelp too) | |
2036 This option enables usage of MPlayer's internal postprocessing filter, | |
2037 and also gives an interface where you can pass options to the named filter. | |
2038 To get a list of available filters, use \-pphelp. | |
2039 .br | |
2040 Note that each sub-filter must be separated with a / sign. | |
2041 .br | |
2042 Each filter defaults to 'c' (chrominance). | |
2043 .br | |
2044 The keywords accept a '\-' prefix to disable the option. | |
2045 .br | |
2046 A ':' followed by a letter may be appended to the option to indicate its | |
2047 scope: | |
2048 .RSss | |
2049 a: Automatically switches the filter off if the CPU is too slow. | |
2050 .br | |
2051 c: Do chrominance filtering, too. | |
2052 .br | |
2053 y: Do not do chrominance filtering (only luminance filtering). | |
2054 .REss | |
2055 | |
2056 .RS | |
2057 .I EXAMPLES: | |
2058 .RE | |
2059 .RSss | |
2060 .br | |
2061 \-vop pp=hb/vb/dr/al/lb | |
2062 .br | |
2063 \-vop pp=hb/vb/dr/al | |
2064 .br | |
2065 Default filters without brightness/\:contrast correction: | |
2066 .br | |
2067 \-vop pp=de/\-al | |
2068 .br | |
2069 Enable default filters & temporal denoiser: | |
2070 .br | |
2071 \-vop pp=de/tn:1:2:3 | |
2072 .br | |
2073 Deblock horizontal only luminance and switch vertical deblocking on or | |
2074 off automatically depending on available CPU time: | |
2075 .br | |
2076 \-vop pp=hb:y/vb:a \-autoq 6 | |
2077 .REss | |
2078 .IPs lavc[=quality:fps] | |
2079 Realtime MPEG1 encoder for use with DVB/\:DXR3 (libavcodec) | |
2080 .IPs fame | |
2081 Realtime MPEG1 encoder for use with DVB/\:DXR3 (libfame) | |
2082 .IPs dvbscale[=aspect] | |
2083 Set up optimal scaling for DVB cards. | |
2084 (aspect = DVB_HEIGHT*ASPECTRATIO, default: 768) | |
2085 .IPs "noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]" | |
2086 Adds noise | |
2087 .RSss | |
2088 <0\-100>: luma noise | |
2089 .br | |
2090 <0\-100>: chroma noise | |
2091 .br | |
2092 u: uniform noise | |
2093 .br | |
2094 t: temporal noise | |
2095 .br | |
2096 a: averaged temporal noise | |
2097 .br | |
2098 h: high quality | |
2099 .br | |
2100 p: mix random noise with a (semi)regular pattern | |
2101 .REss | |
2102 .IPs "denoise3d[=luma:chroma:time]" | |
2103 This filter aims to reduce image noise producing smooth images and making still | |
2104 images really still (This should enhance compressibility.). | |
2105 It can be given from 0 to 3 parameters. If you omit a parameter, a reasonable | |
2106 value will be inferred. | |
2107 .RSss | |
2108 luma: spatial luma strength (default = 4) | |
2109 .br | |
2110 chroma: spatial chroma strength (default = 3) | |
2111 .br | |
2112 time: temporal strength (default = 6) | |
2113 .REss | |
2114 .IPs eq[=bright:cont] | |
2115 Activates the software equalizer with interactive controls like the hardware | |
2116 eq controls. | |
2117 The values can be from -100 to 100. | |
2118 .IPs eq2[=gamma:contrast:brightness:saturation:rg:gg:bg] | |
2119 Alternative software equalizer that uses lookup tables (very slow), | |
2120 allowing gamma correction in addition to simple brightness, | |
2121 contrast and saturation adjustment. Note that it uses the same MMX | |
2122 optimized code as -vop eq if all gamma values are 1.0! | |
2123 The parameters are given as floating point values. | |
2124 Defaults are gamma=1.0, contrast=1.0, brightness=0.0 and saturation=1.0. | |
2125 Parameters rg, gg, bg are the independent gamma values for the Red, Green | |
2126 and Blue components, all default to 1.0. | |
2127 The values are 0.1\-10 for gammas, -2\-2 for contrast (negative values result | |
2128 in negative image) -1\-1 for brightness and 0\-3 for saturation. | |
2129 .IPs halfpack[=f] | |
2130 Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but | |
2131 keeping all chroma samples. | |
2132 Useful for output to low-resolution display devices when hardware downscaling | |
2133 is poor quality or is not available. | |
2134 Can also be used as a primitive luma-only deinterlacer with very low cpu | |
2135 usage. | |
2136 By default, halfpack averages pairs of lines when downsampling. | |
2137 The optional parameter f can be 0 to only use even lines, or 1 to only use | |
2138 odd lines. | |
2139 Any other value for f gives the default (averaging) behavior. | |
2140 .IPs dint[=sense:level] | |
2141 Detects and drops first of interlaced frames in video stream. | |
2142 Values can be from 0.0 to 1.0 - first (default 0.1) is relative difference | |
2143 between neighbor pixels, second (default 0.15) is what part of image have to | |
2144 be detected as interlaced to drop the frame. | |
2145 .IPs lavcdeint | |
2146 Use libavcodec's deinterlace filter. | |
2147 .IPs "unsharp=l|cWxH:amount[:l|cWxH:amount]" | |
2148 Unsharp mask / gaussian blur. | |
2149 .RSss | |
2150 l: apply effect on luma component | |
2151 .br | |
2152 c: apply effect on chroma components | |
2153 .br | |
2154 WxH: width and height of the matrix, odd sized in both directions | |
2155 (min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7) | |
2156 .br | |
2157 amount: relative amount of sharpness / blur to add to the image | |
2158 (amount < 0 = blur, amount > 0 = sharpen, usually something between -1.5 and | |
2159 1.5) | |
2160 .REss | |
2161 .IPs swapuv | |
2162 Swap U & V plane. | |
2163 .IPs "il=[d|i][s][:[d|i][s]]" | |
2164 (de)interleaves lines. | |
2165 The goal of this filter is to add ability of processing interlaced images | |
2166 pre-field without deinterlacing it. | |
2167 You can filter your interlaced dvd and playback on TV without breaking the | |
2168 interlacing. | |
2169 While deinterlacing (with the post processing filter) removes the interlacing | |
2170 permamently (by smoothing averaging etc) deinterleaving splits the frame into | |
2171 2 fields (so called half pictures), so you can process (filter) them | |
2172 independently and then re-interleave them. | |
2173 .RSss | |
2174 d: deinterleave | |
2175 .br | |
2176 i: interleave | |
2177 .br | |
2178 s: swap fields (exchange even & odd lines) | |
2179 .REss | |
2180 .IPs "field[=n]" | |
2181 Extracts a single field from interlaced image using stride arithmetic | |
2182 to avoid wasting cpu time. The optional argument n specifies whether | |
2183 to extract the even or the odd field (depending on whether n is even | |
2184 or odd). | |
2185 .IPs "boxblur=radius:power[:radius:power]" | |
2186 box blur | |
2187 .RSss | |
2188 radius: size of the filter | |
2189 .br | |
2190 power: how often the filter should be applied | |
2191 .REss | |
2192 .IPs "sab=rad:pfilter:cDiff[:rad:pfilter:cDiff]" | |
2193 shape adaptive blur | |
2194 .RSss | |
2195 rad: blur filter strength (~0.1\-4.0) (slower if larger) | |
2196 .br | |
2197 pfilter: prefilter strength (~0.1\-2.0) | |
2198 .br | |
2199 cDiff: how different the pixels are allowed to be to be considered | |
2200 (~0.1-100.0) | |
2201 .REss | |
2202 .IPs "smartblur=rad:strength:thresh[:rad:strength:thresh]" | |
2203 smart blur | |
2204 .RSss | |
2205 rad: blur filter strength (~0.1\-5.0) (slower if larger) | |
2206 .br | |
2207 strength: blur (0.0\-1.0) or sharpen (-1.0\-0.0) | |
2208 .br | |
2209 thresh: filter all (0), filter flat areas (0\-30) or filter edges (-30\-0) | |
2210 .REss | |
2211 .IPs "perspective=x0:y0:x1:y1:x2:y2:x3:y3:t" | |
2212 perspective correcture | |
2213 .RSss | |
2214 x0,y0,...: coordinates of the top left, top right, bottom left, bottom right | |
2215 corners | |
2216 .br | |
2217 t: linear (0) or cubic resampling (1) | |
2218 .REss | |
2219 .IPs 2xsai | |
2220 Use the 2x scale and interpolate algorithm for scaling and smoothing images. | |
2221 .IPs 1bpp | |
2222 1bpp bitmap to YUV/BGR 8/15/16/32 conversion | |
2223 .IPs "bmovl=hidden:opaque:<fifo>" | |
2224 Read bitmaps from a FIFO and display them in window. | |
2225 . | |
2226 .RSss | |
2227 hidden: sets the default value of the 'hidden' flag (boolean) | |
2228 .br | |
2229 opaque: flag switching between alphablended (transparent) and opaque (fast) | |
2230 mode | |
2231 .br | |
2232 fifo: path/filename for the FIFO (named pipe connecting mplayer -vop bmovl | |
2233 to the controlling application) | |
2234 .REss | |
2235 | |
2236 .RS | |
2237 FIFO commands are: | |
2238 .RE | |
2239 .RSss | |
2240 RGBA32 width height xpos ypos alpha clear | |
2241 .br | |
2242 followed by width*height*4 bytes of raw RGBA32 data. | |
2243 | |
2244 ABGR32 width height xpos ypos alpha clear | |
2245 .br | |
2246 followed by width*height*4 bytes of raw ABGR32 data. | |
2247 | |
2248 RGB24 width height xpos ypos alpha clear | |
2249 .br | |
2250 followed by width*height*3 bytes of raw RGB32 data. | |
2251 | |
2252 BGR24 width height xpos ypos alpha clear | |
2253 .br | |
2254 followed by width*height*3 bytes of raw BGR32 data. | |
2255 | |
2256 ALPHA width height xpos ypos alpha | |
2257 .br | |
2258 change alpha for area | |
2259 | |
2260 CLEAR width height xpos ypos | |
2261 .br | |
2262 clear area | |
2263 | |
2264 OPAQUE | |
2265 .br | |
2266 disable all alpha transparency. | |
2267 Send "ALPHA 0 0 0 0 0" to enable it again. | |
2268 | |
2269 HIDE | |
2270 .br | |
2271 hide bitmap | |
2272 | |
2273 SHOW | |
2274 .br | |
2275 show bitmap | |
2276 .REss | |
2277 | |
2278 .RS | |
2279 Arguments are: | |
2280 .RE | |
2281 .RSss | |
2282 width, height: size of image/area | |
2283 .br | |
2284 xpos, ypos: start blitting at X/Y position | |
2285 .br | |
2286 alpha: set alpha difference. | |
2287 0 means same as original, 255 makes everything | |
2288 opaque, -255 makes everything transparent. | |
2289 If you set this to -255 you can then send a sequence of ALPHA-commands to set | |
2290 the area to -225, -200, -175 etc for a nice fade-in-effect! ;) | |
2291 .br | |
2292 clear: clear the framebuffer before blitting. | |
2293 1 means clear, if 0, the image will just be blitted on top of the old one, so | |
2294 you don't need to send 1,8MB of RGBA32 data everytime a small part of the | |
2295 screen is updated. | |
2296 .REss | |
2297 .RE | |
2298 . | |
2299 .TP | |
2300 .B \-x <x> (MPLAYER only) | |
2301 Scale image to x width (if sw/\:hw scaling available). | |
2302 Disables aspect calculations. | |
2303 .TP | |
2304 .B \-xvidopts <option1:option2:...> | |
2305 Specify additional parameters when decoding with XviD. | |
2306 | |
2307 .PD 0 | |
2308 .RSs | |
2309 .IPs dr2\ \ | |
2310 Activate direct rendering method 2. | |
2311 .IPs nodr2 | |
2312 Deactivate direct rendering method 2. | |
2313 .RE | |
2314 .PD 1 | |
2315 . | |
2316 .TP | |
2317 .B \-xy <x> | |
2318 .PD 0 | |
2319 .RSs | |
2320 .IPs "x<=8" | |
2321 Scale image by factor <x>. | |
2322 .IPs "x>8\ " | |
2323 Set width to <x> and calculate height to keep correct aspect ratio. | |
2324 .RE | |
2325 .PD 1 | |
2326 . | |
2327 .TP | |
2328 .B \-y <y> (MPLAYER only) | |
2329 Scale image to y height (if sw/\:hw scaling available). | |
2330 Disables aspect calculations. | |
2331 .TP | |
2332 .B \-zoom \ | |
2333 Allow software scaling, where available. | |
2334 Could be used to force scaling with \-vop scale. | |
2335 | |
2336 .I NOTE: | |
2337 .br | |
2338 \-vop scale will IGNORE options \-x / \-y / \-xy / \-fs / \-aspect without | |
2339 \-zoom. | |
2340 | |
2341 | |
2342 .SH "ENCODING OPTIONS (MENCODER ONLY)" | |
2343 .TP | |
2344 .B \-audio-density <1\-50> | |
2345 Number of audio chunks per second (default is 2 for 0.5s long audio chunks). | |
2346 | |
2347 .I NOTE: | |
2348 .br | |
2349 CBR only, VBR ignores this as it puts each packet in a new chunk. | |
2350 .TP | |
2351 .B \-audio-delay <0.0\-...> | |
2352 Sets the audio delay field in the header. | |
2353 Default is 0.0, negative values do not work. | |
2354 This does not delay the audio while encoding, but the player will see the | |
2355 default audio delay, sparing you the use of the \-delay option. | |
2356 .TP | |
2357 .B \-audio-preload <0.0\-2.0> | |
2358 Sets up audio buffering time interval (default: 0.5s). | |
2359 .TP | |
2360 .B \-divx4opts <option1:option2:...> | |
2361 If encoding to DivX4, you can specify its parameters here. | |
2362 .br | |
2363 Available options are: | |
2364 . | |
2365 .RSs | |
2366 .IPs help | |
2367 get help | |
2368 .IPs br=<value> | |
2369 specify bitrate in | |
2370 .RSss | |
2371 kbit <4\-16000> or | |
2372 .br | |
2373 bit <16001\-24000000> | |
2374 .REss | |
2375 .IPs key=<value> | |
2376 maximum keyframe interval (in frames) | |
2377 .IPs deinterlace | |
2378 enable deinterlacing (avoid it, DivX4 is buggy) | |
2379 .IPs q=<1\-5> | |
2380 quality (1\-fastest, 5\-best) | |
2381 .IPs min_quant=<1\-31> | |
2382 minimum quantizer | |
2383 .IPs max_quant=<1\-31> | |
2384 maximum quantizer | |
2385 .IPs rc_period=<value> | |
2386 rate control period | |
2387 .IPs rc_reaction_period=<value> | |
2388 rate control reaction period | |
2389 .IPs rc_reaction_ratio=<value> | |
2390 rate control reaction ratio | |
2391 .IPs crispness=<0\-100> | |
2392 specify crispness/\:smoothness | |
2393 .IPs pass=<1\-2> | |
2394 With this you can encode 2pass DivX4 files. | |
2395 First encode with pass=1, then with the same parameters, encode with | |
2396 pass=2. | |
2397 .IPs vbrpass=<0\-2> | |
2398 Override the pass argument and use XviD VBR Library instead of DivX4 | |
2399 VBR. | |
2400 Available options are: | |
2401 . | |
2402 .RSss | |
2403 0: one pass encoding (as in not putting pass on the command line) | |
2404 .br | |
2405 1: Analysis (first) pass of two pass encoding. | |
2406 The resulting AVI file can be directed to /dev/null. | |
2407 .br | |
2408 2: Final (second) pass of two pass encoding. | |
2409 .REss | |
2410 .RE | |
2411 . | |
2412 .TP | |
2413 .B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see \-ss and \-sb option too) | |
2414 Stop encoding at given time or byte position. | |
2415 Can be specified in many ways: | |
2416 | |
2417 .I NOTE: | |
2418 .br | |
2419 Byte position won't be accurate, as it can only stop at | |
2420 a frame boundary. | |
2421 | |
2422 .I EXAMPLE: | |
2423 .PD 0 | |
2424 .RSs | |
2425 .IPs "\-endpos 56" | |
2426 encode only 56 seconds | |
2427 .IPs "\-endpos 01:10:00" | |
2428 encode only 1 hour 10 minutes | |
2429 .IPs "\-endpos 100mb" | |
2430 encode only 100 MBytes | |
2431 .RE | |
2432 .PD 1 | |
2433 . | |
2434 .TP | |
2435 .B \-ffourcc <fourcc> | |
2436 Can be used to override the video fourcc of the output file. | |
2437 | |
2438 .I EXAMPLE: | |
2439 .PD 0 | |
2440 .RSs | |
2441 .IPs "-ffourcc div3" | |
2442 will have the output file contain 'div3' as video fourcc. | |
2443 .RE | |
2444 .PD 1 | |
2445 . | |
2446 .TP | |
2447 .B \-include <configuration\ file> | |
2448 Specify configuration file to be parsed after the default ones. | |
2449 .TP | |
2450 .B \-info <option1:option2:...> (.AVI only) | |
2451 Specify the info header of the resulting .AVI file. | |
2452 .br | |
2453 Available options are: | |
2454 . | |
2455 .RSs | |
2456 .IPs help | |
2457 show this description | |
2458 .IPs name=<value> | |
2459 title of the subject of the file | |
2460 .IPs artist=<value> | |
2461 artist or author of the original subject of the file | |
2462 .IPs genre=<value> | |
2463 original work category | |
2464 .IPs subject=<value> | |
2465 contents of the file | |
2466 .IPs copyright=<value> | |
2467 copyright information for the file | |
2468 .IPs srcform=<value> | |
2469 original form of the material that was digitized | |
2470 .IPs comment=<value> | |
2471 general comments about the file or the subject of the file | |
2472 .RE | |
2473 . | |
2474 .TP | |
2475 .B \-lameopts <option1:option2:...> | |
2476 If encoding to MP3 with libmp3lame, you can specify its parameters here. | |
2477 .br | |
2478 Available options are: | |
2479 . | |
2480 .RSs | |
2481 .IPs help | |
2482 get help | |
2483 .IPs vbr=<0\-4> | |
2484 variable bitrate method | |
2485 .RSss | |
2486 0: cbr | |
2487 .br | |
2488 1: mt | |
2489 .br | |
2490 2: rh(default) | |
2491 .br | |
2492 3: abr | |
2493 .br | |
2494 4: mtrh | |
2495 .REss | |
2496 .IPs abr\ \ | |
2497 average bitrate | |
2498 .IPs cbr\ \ | |
2499 constant bitrate. | |
2500 .br | |
2501 Forces also CBR mode encoding on subsequent ABR presets modes | |
2502 .IPs br=<0\-1024> | |
2503 specify bitrate in kBit (CBR and ABR only) | |
2504 .IPs q=<0\-9> | |
2505 quality (0-highest, 9-lowest) (only for VBR) | |
2506 .IPs aq=<0\-9> | |
2507 algorithmic quality (0-best/\:slowest, 9-worst/\:fastest) | |
2508 .IPs ratio=<1\-100> | |
2509 compression ratio | |
2510 .IPs vol=<0\-10> | |
2511 set audio input gain | |
2512 .IPs mode=<0\-3> | |
2513 (default: auto) | |
2514 .RSss | |
2515 0: stereo | |
2516 .br | |
2517 1: joint-stereo | |
2518 .br | |
2519 2: dualchannel | |
2520 .br | |
2521 3: mono | |
2522 .REss | |
2523 .IPs padding=<0\-2> | |
2524 .RSss | |
2525 0: no | |
2526 .br | |
2527 1: all | |
2528 .br | |
2529 2: adjust | |
2530 .REss | |
2531 .IPs fast | |
2532 switch on faster encoding on subsequent VBR presets modes, slightly lower | |
2533 quality and higher bitrates. | |
2534 .IPs preset=<value> | |
2535 provide the highest possible quality settings. | |
2536 .RSss | |
2537 medium: VBR encoding, good quality, 150\-180 kbps bitrate range. | |
2538 .br | |
2539 standard: VBR encoding, high quality, 170\-210 kbps bitrate range. | |
2540 .br | |
2541 extreme: VBR encoding, very high quality, 200\-240 kbps bitrate range. | |
2542 .br | |
2543 insane: CBR encoding, highest preset quality, 320 kbps bitrate. | |
2544 .br | |
2545 <8-320>: ABR encoding at average given kbps bitrate. | |
2546 .br | |
2547 .REss | |
2548 .RE | |
2549 | |
2550 .I EXAMPLE: | |
2551 .PD 0 | |
2552 .RSs | |
2553 .IPs "\-lameopts fast:preset=standard" | |
2554 for most people on most music and already quite high in quality. | |
2555 .IPs "\-lameopts cbr:preset=192" | |
2556 encode with ABR presets at a 192 kbps forced constant bitrate. | |
2557 .IPs "\-lameopts preset=172" | |
2558 encode with ABR presets at a 172 kbps average bitrate. | |
2559 .IPs "\-lameopts preset=extreme" | |
2560 for people with extremely good hearing and similar equipment. | |
2561 .IPs "\-lameopts preset=help" | |
2562 print additional options and informations on presets settings. | |
2563 .RE | |
2564 .PD 1 | |
2565 . | |
2566 .TP | |
2567 .B \-lavcopts <option1:option2:...> | |
2568 If encoding with a codec from libavcodec, you can specify its parameters | |
2569 here. | |
2570 | |
2571 .I EXAMPLE: | |
2572 .PD 0 | |
2573 .RSs | |
2574 \-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 | |
2575 .RE | |
2576 .PD 1 | |
2577 | |
2578 .RS | |
2579 Available options are: | |
2580 .RE | |
2581 . | |
2582 .RSs | |
2583 .IPs vcodec=<value> | |
2584 use the specified codec (there is no default, you must specify it): | |
2585 .RSss | |
2586 mjpeg: Motion JPEG | |
2587 .br | |
2588 h263: H263 | |
2589 .br | |
2590 h263p: H263 Plus | |
2591 .br | |
2592 mpeg4: DivX 4/\:5 | |
2593 .br | |
2594 msmpeg4: DivX 3 | |
2595 .br | |
2596 rv10: an old RealVideo codec | |
2597 .br | |
2598 mpeg1video: MPEG1 video :) | |
2599 .REss | |
2600 .IPs vqmin=<1\-31> | |
2601 minimum quantizer (pass\ 1/\:2) (default: 2) | |
2602 .IPs vqscale=<1\-31> | |
2603 constant quantizer (selects fixed quantizer mode) (default: 0 (disabled)) | |
2604 .IPs vqmax=<1\-31> | |
2605 maximum quantizer (pass\ 1/\:2) (default: 31) | |
2606 .IPs mbqmin=<1\-31> | |
2607 minimum macroblock quantizer (pass\ 1/\:2) (default: 2) | |
2608 .IPs mbqmax=<1\-31> | |
2609 maximum macroblock quantizer (pass\ 1/\:2) (default: 31) | |
2610 .IPs vqdiff=<1\-31> | |
2611 maximum quantizer difference between I or P frames (pass\ 1/\:2) (default: 3) | |
2612 .IPs vmax_b_frames=<0\-4> | |
2613 maximum number of B frames between non B frames: | |
2614 .RSss | |
2615 0: no B frames (default) | |
2616 .br | |
2617 0\-2: sane range | |
2618 .REss | |
2619 .IPs vme=<0\-5> | |
2620 motion estimation method: | |
2621 .RSss | |
2622 0: none (very lq) | |
2623 .br | |
2624 1: full (slow) | |
2625 .br | |
2626 2: log (lq) | |
2627 .br | |
2628 3: phods (lq) | |
2629 .br | |
2630 4: EPZS (default) | |
2631 .br | |
2632 5: X1 (experimental) | |
2633 .REss | |
2634 .IPs vhq\ \ | |
2635 high quality mode, encode each macro block in all modes an choose the smallest | |
2636 (slow). | |
2637 (default: HQ disabled) | |
2638 .IPs v4mv | |
2639 4 motion vectors per macroblock (slightly better quality). | |
2640 (default: disabled) | |
2641 .IPs keyint=<0\-300> | |
2642 interval between keyframes in frames. | |
2643 Larger numbers mean slightly smaller files, but less precise seeking, 0 means | |
2644 no key frames and values >300 aren't recommended. | |
2645 For a strict mpeg1/\:2/\:4 compliance this would have to be <=132. | |
2646 (default: 250 or one key frame every ten seconds in a 25fps movie) | |
2647 .IPs vb_strategy=<0\-1> | |
2648 strategy to choose between I/\:P/\:B frames (pass\ 2): | |
2649 .RSss | |
2650 0: always use the maximum number of B frames (default) | |
2651 .br | |
2652 1: avoid B frames in high motion scenes (bitrate mispredictions) | |
2653 .REss | |
2654 .IPs vpass=<1\-2> | |
2655 Activates internal 2pass mode (default: disabled): | |
2656 .RSss | |
2657 1: first pass | |
2658 .br | |
2659 2: second pass | |
2660 .REss | |
2661 .IPs aspect=<x/y> | |
2662 Store movie aspect internally, just like MPEG files. | |
2663 Much nicer solution than rescaling, because quality isn't decreased. | |
2664 Only MPlayer will play these files correctly, other players will display | |
2665 them with wrong aspect. | |
2666 The aspect parameter can be given as a ratio or a floating point number. | |
2667 Example: | |
2668 .RSss | |
2669 aspect=16/9, aspect=1.78 | |
2670 .REss | |
2671 .IPs vbitrate=<value> | |
2672 specify bitrate (pass\ 1/\:2) in | |
2673 .RSss | |
2674 kBit <4\-16000> or | |
2675 .br | |
2676 Bit <16001\-24000000> | |
2677 .br | |
2678 (warning: 1kBit = 1000 Bits) | |
2679 .br | |
2680 (default: 800) | |
2681 .REss | |
2682 .IPs vratetol=<value> | |
2683 approximated filesize tolerance in kbit. | |
2684 (warning: 1kBit = 1000 Bits) | |
2685 (default: 8000) | |
2686 .IPs vrc_maxrate=<value> | |
2687 maximum bitrate in kbit/\:sec (pass\ 1/\:2) | |
2688 .IPs vrc_minrate=<value> | |
2689 minimum bitrate in kbit/\:sec (pass\ 1/\:2) | |
2690 .IPs vrc_buf_size=<value> | |
2691 buffer size in kbit (pass\ 1/\:2). | |
2692 Note: vratetol should not be too large during the second pass or there might | |
2693 be problems if vrc_(min|max)rate is used. | |
2694 .IPs vb_qfactor=<-31.0\-31.0> | |
2695 quantizer factor between B and non B frames (pass\ 1/\:2) (default: 1.25) | |
2696 .IPs vi_qfactor=<-31.0\-31.0> | |
2697 (pass\ 1/\:2) (default: 0.8) | |
2698 .IPs vb_qoffset=<-31.0\-31.0> | |
2699 quantizer offset between B and non B frames (pass\ 1/\:2) (default: 1.25) | |
2700 .IPs vi_qoffset=<-31.0\-31.0> | |
2701 (pass\ 1/\:2) (default: 0.0) | |
2702 .br | |
2703 if v{b|i}_qfactor > 0 | |
2704 .br | |
2705 I/\:B-Frame quantizer = P-Frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset | |
2706 .br | |
2707 else | |
2708 .br | |
2709 do normal ratecontrol (dont lock to next P frame quantizer) and set | |
2710 q= -q * v{b|i}_qfactor + v{b|i}_qoffset | |
2711 .IPs vqblur=<0.0\-1.0> | |
2712 quantizer blur (pass1): | |
2713 .RSss | |
2714 0.0: qblur disabled | |
2715 .br | |
2716 0.5 (default) | |
2717 .br | |
2718 1.0: average the quantizer over all previous frames, larger values will | |
2719 average the quantizer more over time (slower change) | |
2720 .REss | |
2721 .IPs vqblur=<0.0\-99.0> | |
2722 quantizer gaussian blur, larger values will average the quantizer more over | |
2723 time (slower change) (pass2) (default: 0.5) | |
2724 .IPs vqcomp=<value> | |
2725 quantizer compression, depends upon vrc_eq (pass\ 1/\:2) (default: 0.5) | |
2726 .IPs vrc_eq=<equation> | |
2727 main ratecontrol equation (pass\ 1/\:2): | |
2728 | |
2729 1: constant bitrate | |
2730 .br | |
2731 tex: constant quality | |
2732 .br | |
2733 1+(tex/\:avgTex-1)*qComp: approximately the equation of the old ratecontrol | |
2734 code | |
2735 .br | |
2736 tex^qComp: with qcomp 0.5 or something like that (default) | |
2737 | |
2738 infix operators: +,-,*,/,^ | |
2739 | |
2740 variables: | |
2741 .br | |
2742 tex: texture complexity | |
2743 .br | |
2744 iTex,pTex: intra, non intra texture complexity | |
2745 .br | |
2746 avgTex: average texture complexity | |
2747 .br | |
2748 avgIITexaverage: intra texture complexity in I frames | |
2749 .br | |
2750 avgPITexaverage: intra texture complexity in P frames | |
2751 .br | |
2752 avgPPTexaverage: non intra texture complexity in P frames | |
2753 .br | |
2754 avgBPTexaverage: non intra texture complexity in B frames | |
2755 .br | |
2756 mv: bits used for MVs | |
2757 .br | |
2758 fCode: maximum length of MV in log2 scale | |
2759 .br | |
2760 iCount: number of intra MBs / number of MBs | |
2761 .br | |
2762 var: spatial complexity | |
2763 .br | |
2764 mcVar: temporal complexity | |
2765 .br | |
2766 qComp: qcomp from the command line | |
2767 .br | |
2768 isI, isP, isB: is 1 if picture type is I/\:P/\:B else 0 | |
2769 .br | |
2770 Pi,E: see your favorite math book | |
2771 | |
2772 functions: | |
2773 .br | |
2774 max(a,b),min(a,b): maximum / minimum | |
2775 .br | |
2776 gt(a,b): is 1 if a>b, 0 otherwise | |
2777 .br | |
2778 lt(a,b): is 1 if a<b, 0 otherwise | |
2779 .br | |
2780 eq(a,b): is 1 if a==b,0 otherwise | |
2781 .br | |
2782 sin, cos, tan, sinh, cosh, tanh, exp, log, abs | |
2783 . | |
2784 .IPs vrc_override=<options> | |
2785 User specified quality for specific parts (pass\ 1/\:2). | |
2786 The options are <start-frame, end-frame, quality[/\:start-frame, end-frame, | |
2787 quality[/...]]>: | |
2788 .RSss | |
2789 quality 2\-31: quantizer | |
2790 .br | |
2791 quality \-500\-0: quality correcture in % | |
2792 .REss | |
2793 .IPs vrc_init_cplx=<0\-1000> | |
2794 initial complexity (pass\ 1) | |
2795 .IPs vqsquish=<0\-1> | |
2796 specify how to keep the quantizer between qmin and qmax (pass\ 1/\:2): | |
2797 .RSss | |
2798 0: use cliping | |
2799 .br | |
2800 1: use a nice differentiable function (default) | |
2801 .REss | |
2802 .IPs vlelim=<-1000\-1000> | |
2803 single coefficient elimination threshold for luminance. | |
2804 Negative values will also consider the dc coefficient (should be at least -4 | |
2805 or lower for encoding | |
2806 at quant=1): | |
2807 .RSss | |
2808 0: disabled (default) | |
2809 .br | |
2810 -4 (JVT recommendation) | |
2811 .REss | |
2812 .IPs vcelim=<-1000\-1000> | |
2813 single coefficient elimination threshold for chrominance. | |
2814 Negative values will also consider the dc coefficient (should be at least -4 | |
2815 or lower for encoding at quant=1): | |
2816 .RSss | |
2817 0 disabled (default) | |
2818 .br | |
2819 7 (JVT recommendation) | |
2820 .REss | |
2821 .IPs vstrict=<-1\-1> | |
2822 (strict) standard compliance. | |
2823 .RSss | |
2824 0: disabled (default) | |
2825 .br | |
2826 1: only recommended if you want to feed the output into the mpeg4 | |
2827 reference decoder | |
2828 .br | |
2829 -1: allows non-standard YV12 huffyuv encoding (20% smaller files, but | |
2830 can't be played back by the official huffyuv codec) | |
2831 .REss | |
2832 .IPs vdpart | |
2833 data partitioning. | |
2834 Adds 2 byte per video packet, improves error-resistance when transfering over | |
2835 unreliable channels (eg.\& streaming over the internet) | |
2836 .IPs vpsize=<0\-10000> | |
2837 video packet size, improves error-resistance (see \-vdpart option too): | |
2838 .RSss | |
2839 0: disabled (default) | |
2840 .br | |
2841 100-1000: good choice | |
2842 .REss | |
2843 .IPs gray | |
2844 grayscale only encoding (faster) (default: disabled) | |
2845 .IPs vfdct=<0\-10> | |
2846 dct algorithm: | |
2847 .RSss | |
2848 0: automatically select a good one (default) | |
2849 .br | |
2850 1: fast integer | |
2851 .br | |
2852 2: accurate integer | |
2853 .br | |
2854 3: mmx | |
2855 .br | |
2856 4: mlib | |
2857 .REss | |
2858 .IPs idct=<0\-99> | |
2859 idct algorithm. | |
2860 Note: all these IDCTs do pass the IEEE1180 tests afaik: | |
2861 .RSss | |
2862 0: automatically select a good one (default) | |
2863 .br | |
2864 1: jpeg reference integer | |
2865 .br | |
2866 2: simple | |
2867 .br | |
2868 3: simplemmx | |
2869 .br | |
2870 4: libmpeg2mmx (inaccurate, DONT USE for encoding with keyint >100) | |
2871 .br | |
2872 5: ps2 | |
2873 .br | |
2874 6: mlib | |
2875 .br | |
2876 7: arm | |
2877 .REss | |
2878 .IPs lumi_mask=<0.0\-1.0> | |
2879 luminance masking. | |
2880 Warning: be careful, too large values can cause disasterous things. | |
2881 Warning2: large values might look good on some monitors but may look horrible | |
2882 on other monitors: | |
2883 .RSss | |
2884 0.0: disabled (default) | |
2885 .br | |
2886 0.0\-0.3: sane range | |
2887 .REss | |
2888 .IPs dark_mask=<0.0\-1.0> | |
2889 darkness masking. | |
2890 Warning: be careful, too large values can cause disasterous things. | |
2891 Warning2: large values might look good on some monitors but may look horrible | |
2892 on other monitors / TV / TFT: | |
2893 .RSss | |
2894 0.0: disabled (default) | |
2895 .br | |
2896 0.0\-0.3: sane range | |
2897 .REss | |
2898 .IPs tcplx_mask=<0.0\-1.0> | |
2899 temporal complexity masking (default: 0.0 (disabled)) | |
2900 .IPs scplx_mask=<0.0\-1.0> | |
2901 spatial complexity masking. | |
2902 Larger values help against blockiness, if no deblocking filter is used for | |
2903 decoding. | |
2904 Crop any black borders to get better quality: | |
2905 .RSss | |
2906 0.0: disabled (default) | |
2907 .br | |
2908 0.0\-0.5: sane range | |
2909 .REss | |
2910 .IPs naq\ \ | |
2911 Normalize adaptive quantization (experimental). | |
2912 When using adaptive quantization (*_mask), the average per-MB quantizer may no | |
2913 longer match the requested frame-level quantizer. | |
2914 Naq will attempt to adjust the per-MB quantizers to maintain the proper | |
2915 average. | |
2916 .IPs ildct | |
2917 use interlaced dct | |
2918 .IPs format=<value> | |
2919 .RSss | |
2920 YV12: default | |
2921 .br | |
2922 422P: for huffyuv | |
2923 .REss | |
2924 .IPs pred | |
2925 (for huffyuv) | |
2926 .RSss | |
2927 0: left prediction | |
2928 .br | |
2929 1: plane/gradient prediction | |
2930 .br | |
2931 2: median prediction | |
2932 .REss | |
2933 .IPs qpel | |
2934 use quarter pel motion compensation | |
2935 .IPs precmp=<0\-2000> | |
2936 comparison function for motion estimation pre pass | |
2937 .IPs cmp=<0\-2000> | |
2938 comparison function for full pel motion estimation | |
2939 .IPs subcmp=<0\-2000> | |
2940 comparison function for sub pel motion estimation | |
2941 .RSss | |
2942 0 (SAD): sum of absolute differences, fast (default) | |
2943 .br | |
2944 1 (SSE): sum of squared errors | |
2945 .br | |
2946 2 (SATD): sum of absolute hadamard transformed differences | |
2947 .br | |
2948 3 (DCT): sum of absolute dct transformed differences | |
2949 .br | |
2950 4 (PSNR): sum of the squared quantization errors | |
2951 .br | |
2952 5 (BIT): number of bits needed for the block | |
2953 .br | |
2954 6 (RD): rate distoration optimal, slow | |
2955 .br | |
2956 7 (ZERO): 0 | |
2957 .br | |
2958 +256: use chroma too, doesnt work with b frames currently | |
2959 .REss | |
2960 .IPs predia=<\-99\-6> | |
2961 Diamond type and size for motion estimation pre pass | |
2962 .IPs dia=<\-99\-6> | |
2963 Diamond type & size for motion estimation. | |
2964 Note: The sizes of the normal diamonds and shape adaptive ones dont have the same meaning | |
2965 .RSss | |
2966 \-3: shape adaptive (fast) diamond with size 3 | |
2967 .br | |
2968 \-2: shape adaptive (fast) diamond with size 2 | |
2969 .br | |
2970 \-1: experimental | |
2971 .br | |
2972 1: normal size=1 diamond (default) =EPZS type diamond | |
2973 .nf | |
2974 .ne | |
2975 0 | |
2976 000 | |
2977 0 | |
2978 .fi | |
2979 .br | |
2980 2: normal size=2 diamond | |
2981 .nf | |
2982 .ne | |
2983 0 | |
2984 000 | |
2985 00000 | |
2986 000 | |
2987 0 | |
2988 .fi | |
2989 .REss | |
2990 .IPs trell | |
2991 Trellis quantization. | |
2992 This will find the optimal encoding for each 8x8 block. | |
2993 Trellis quantization is quite simple a optimal quantization in the PSNR vs | |
2994 bitrate sense (assuming that there would be no rounding errors introduced | |
2995 by the IDCT, which is obviously not the case) it simply finds a block for | |
2996 the minimum of error and lambda*bits. | |
2997 .RSss | |
2998 lambda: qp dependant constant | |
2999 .br | |
3000 bits: amount of bits needed to encode the block | |
3001 .br | |
3002 error: sum of squared errors of the quantization | |
3003 .REss | |
3004 .IPs last_pred=<0\-99> | |
3005 Amount of motion predictors from the previous frame | |
3006 .RSss | |
3007 0: (default) | |
3008 .br | |
3009 a: will use 2a+1 x 2a+1 MB square of MV predictors from the previous frame | |
3010 .REss | |
3011 .IPs preme=<0\-2> | |
3012 motion estimation pre-pass | |
3013 .RSss | |
3014 0: disabled | |
3015 .br | |
3016 1: only after I frames (default) | |
3017 .br | |
3018 2: always | |
3019 .REss | |
3020 .IPs subq=<1\-8> | |
3021 subpel refinement quality (for qpel) (default: 8). | |
3022 Note: this has a significant effect on the speed | |
3023 .IPs psnr | |
3024 print the psnr (peak signal to noise ratio) for the whole video after encoding | |
3025 and store the per frame psnr in a file with name like 'psnr_012345.log'. | |
3026 .IPs mpeg_quant | |
3027 use MPEG quantizers instead of H.263. | |
3028 (default: disabled) (i.e.\& use H.263 quantizers) | |
3029 .RE | |
3030 . | |
3031 .TP | |
3032 .B \-noskip | |
3033 Do not skip frames. | |
3034 .TP | |
3035 .B \-o <filename> | |
3036 Outputs to the given filename, instead of the default 'test.avi'. | |
3037 .TP | |
3038 .B \-oac <codec name> | |
3039 Encode with the given audio codec. | |
3040 Use \-ovc help to get a list of available codecs. | |
3041 (no default set) | |
3042 | |
3043 .I EXAMPLE: | |
3044 .PD 0 | |
3045 .RSs | |
3046 .IPs "-oac copy" | |
3047 no encoding, just streamcopy | |
3048 .IPs "-oac pcm" | |
3049 encode to uncompressed PCM | |
3050 .IPs "-oac mp3lame" | |
3051 encode to MP3 (using Lame) | |
3052 .RE | |
3053 .PD 1 | |
3054 . | |
3055 .TP | |
3056 .B \-of <format> (BETA CODE!) | |
3057 Encode to the specified format. | |
3058 Use \-of help to get a list of available formats. | |
3059 | |
3060 .I EXAMPLE: | |
3061 .PD 0 | |
3062 .RSs | |
3063 .IPs "-of avi" | |
3064 encode to avi (default) | |
3065 .IPs "-of mpeg" | |
3066 encode to mpeg | |
3067 .RE | |
3068 .PD 1 | |
3069 . | |
3070 .TP | |
3071 .B \-ofps <fps> | |
3072 The output file will have different frame/\:sec than the source. | |
3073 You MUST set it for variable fps (asf, some mov) and progressive | |
3074 (29.97fps telecined mpeg) files. | |
3075 .TP | |
3076 .B \-ovc <codec name> | |
3077 Encode with the given video codec. | |
3078 Use \-ovc help to get a list of available codecs. | |
3079 (no default set) | |
3080 | |
3081 .I EXAMPLE: | |
3082 .PD 0 | |
3083 .RSs | |
3084 .IPs "\-ovc copy" | |
3085 no encoding, just streamcopy | |
3086 .IPs "\-ovc divx4" | |
3087 encode to DivX4/\:DivX5 | |
3088 .IPs "\-ovc rawrgb" | |
3089 encode to uncompressed RGB24 | |
3090 .IPs "\-ovc lavc" | |
3091 encode with a libavcodec codecs | |
3092 .RE | |
3093 .PD 1 | |
3094 . | |
3095 .TP | |
3096 .B \-passlogfile <filename> | |
3097 When encoding in 2pass mode, MEncoder dumps first pass' informations | |
3098 to the given file instead of the default divx2pass.log. | |
3099 .TP | |
3100 .B \-skiplimit <value> | |
3101 Maximal skipable frames after non-skipped one | |
3102 (-noskiplimit for unlimited number). | |
3103 .TP | |
3104 .B \-v, \-\-verbose | |
3105 Increment verbose level (more \-v means more verbosity). | |
3106 | |
3107 .PD 0 | |
3108 .RSs | |
3109 .IPs 0 | |
3110 only some informal output (default) | |
3111 .IPs 1 | |
3112 some basic debug infos, avi header, function values (init debug) | |
3113 .IPs 2 | |
3114 print avi indexes, chunk inputs, more debug infos (player debug) | |
3115 .IPs 3 | |
3116 prints everything related to input parsers (parser debug) | |
3117 .RE | |
3118 .PD 1 | |
3119 . | |
3120 .TP | |
3121 .B \-vobsubout <basename> | |
3122 Specify the basename for the output .idx and .sub files. | |
3123 This turns off subtitle rendering in the encoded movie and diverts it to | |
3124 Vobsub subtitle files. | |
3125 .TP | |
3126 .B \-vobsuboutindex <index> | |
3127 Specify the index of the subtitles in the output files. | |
3128 (default: 0) | |
3129 .TP | |
3130 .B \-vobsuboutid <langid> | |
3131 Specify the language two letter code for the subtitles. | |
3132 This overrides what is read from the DVD or the .ifo file. | |
3133 .TP | |
3134 .B \-xvidencopts <option1:option2:...> | |
3135 If encoding to XviD, you can specify its parameters here. | |
3136 .br | |
3137 There's three modes available: constant bitrate (CBR), fixed quantizer and | |
3138 2pass. | |
3139 .br | |
3140 Available options are: | |
3141 . | |
3142 .RSs | |
3143 .IPs pass=<1|2> | |
3144 specify the pass in 2pass mode | |
3145 .IPs bitrate=<value> | |
3146 sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second | |
3147 if >16000 | |
3148 (CBR or 2pass mode, default=687 kbits/s) | |
3149 .IPs fixed_quant=<1\-31> | |
3150 switch to fixed quantizer mode and specify the quantizer to be used | |
3151 .IPs me_quality=<0\-6> | |
3152 specify the motion detection quality (default=4) | |
3153 .IPs 4mv | |
3154 use 4 motion vectors per macro-block, might give better compression at the | |
3155 cost of a slower encoding (default=off) | |
3156 .IPs rc_reaction_delay_factor=<value> | |
3157 specify how fast the rate control reacts, lower values are faster | |
3158 .IPs rc_averaging_period=<value> | |
3159 period to reach the required average | |
3160 .IPs rc_buffer=<value> | |
3161 size of the rate control buffer | |
3162 .IPs quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>] | |
3163 min & max quantizer for all frames (default=2\-31, CBR mode) | |
3164 .br | |
3165 min & max quantizer for I/P frames (default=2\-31/2\-31, 2pass mode) | |
3166 .IPs min_key_interval=<value> | |
3167 minimum interval between key frames (default=0, 2pass only) | |
3168 .IPs max_key_interval=<value> | |
3169 maximum interval between key frames (default=10*fps) | |
3170 .IPs mpeg_quant | |
3171 use MPEG quantizers instead of H.263 (default=off) | |
3172 .IPs mod_quant | |
3173 decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis. | |
3174 (default=off, 2pass mode only) | |
3175 .IPs lumi_mask | |
3176 use a lumimasking algorithm (default=off, seems buggy) | |
3177 .IPs hintedme | |
3178 save Motion Estimation vectors to a file during the first pass and reuse this | |
3179 file during the second (default=off, 2pass mode only, seems buggy) | |
3180 .IPs hintfile | |
3181 specify the temporary file to be used by the 'hintedme' option | |
3182 (default= \./xvid_hint_me.dat, 2pass mode only) | |
3183 .IPs debug | |
3184 save per-frame statistics in xvid.dbg (default=off) | |
3185 .br | |
3186 this is *not* the 2pass control file | |
3187 .IPs keyframe_boost=<0\-1000> | |
3188 (default=0, 2pass mode only) | |
3189 .IPs kfthreshold=<value> | |
3190 (default=10, 2pass mode only) | |
3191 .IPs kfreduction=<0\-100> | |
3192 (default=30, 2pass mode only) | |
3193 .RE | |
3194 | |
3195 | |
3196 .\" -------------------------------------------------------------------------- | |
3197 .\" Keyboard control | |
3198 .\" -------------------------------------------------------------------------- | |
3199 . | |
3200 .SH "KEYBOARD CONTROL" | |
3201 .I NOTE: | |
3202 .br | |
3203 MPlayer has a fully configurable, command driven, control layer | |
3204 which allow you to control MPlayer using keyboard, mouse, joystick | |
3205 or remote control (using lirc). | |
3206 .br | |
3207 The default configuration file for the input system is | |
3208 ~/.mplayer/\:input.conf but it can be overriden | |
3209 using the \-input conf option. | |
3210 .br | |
3211 These keys may/\:may not work, depending on your video output driver. | |
3212 .TP | |
3213 .B general control | |
3214 .PD 0 | |
3215 .RSs | |
3216 .IPs "<\- and \->" | |
3217 seek backward/\:forward 10 seconds | |
3218 .IPs "up and down" | |
3219 seek backward/\:forward 1 minute | |
3220 .IPs "pgup and pgdown" | |
3221 seek backward/\:forward 10 minutes | |
3222 .IPs "< and >" | |
3223 backward/\:forward in playlist | |
3224 .IPs "HOME and END" | |
3225 go to next/\:previous playtree entry in the parent list | |
3226 .IPs "INS and DEL" | |
3227 go to next/\:previous alternative source (asx playlist only) | |
3228 .IPs "p / SPACE" | |
3229 pause movie (any key unpauses) | |
3230 .IPs "q / ESC" | |
3231 stop playing and quit | |
3232 .IPs "+ and \-" | |
3233 adjust audio delay by +/\:\- 0.1 second | |
3234 .IPs "/ and *" | |
3235 decrease/\:increase volume | |
3236 .IPs "9 and 0" | |
3237 decrease/\:increase volume | |
3238 .IPs m\ \ \ \ | |
3239 mute sound | |
3240 .IPs f\ \ \ \ | |
3241 toggle fullscreen | |
3242 .IPs "w and e" | |
3243 decrease/\:increase panscan range | |
3244 .IPs o\ \ \ \ | |
3245 toggle between OSD states: none / seek / seek+timer | |
3246 .IPs d\ \ \ \ | |
3247 toggle frame dropping | |
3248 .IPs v\ \ \ \ | |
3249 toggle subtitle visibility | |
3250 .IPs j\ \ \ \ | |
3251 switch subtitle language | |
3252 .IPs a\ \ \ \ | |
3253 toggle subtitle aligment: top/middle/bottom | |
3254 .IPs "z and x" | |
3255 adjust subtitle delay by +/\:\- 0.1 second | |
3256 .IPs "r and t" | |
3257 adjust subtitle position | |
3258 .IPs "i" | |
3259 set EDL mark | |
3260 | |
3261 .PP | |
3262 (The following keys are valid only when using \-vo xv or | |
3263 \-vo [vesa|fbdev]:vidix or \-vo xvidix \-vo (x)mga or \-vc divxds (slow).) | |
3264 | |
3265 .IPs "1 and 2" | |
3266 adjust contrast | |
3267 .IPs "3 and 4" | |
3268 adjust brightness | |
3269 .IPs "5 and 6" | |
3270 adjust hue | |
3271 .IPs "7 and 8" | |
3272 adjust saturation | |
3273 .RE | |
3274 .PD 1 | |
3275 . | |
3276 .TP | |
3277 .B GUI keyboard control | |
3278 .PD 0 | |
3279 .RSs | |
3280 .IPs "ENTER" | |
3281 start playing | |
3282 .IPs s\ \ \ \ | |
3283 stop playing | |
3284 .IPs l\ \ \ \ | |
3285 load file | |
3286 .IPs c\ \ \ \ | |
3287 skin browser | |
3288 .IPs p\ \ \ \ | |
3289 toggle playlist | |
3290 .RE | |
3291 .PD 1 | |
3292 . | |
3293 .TP | |
3294 .B TV input control | |
3295 .PD 0 | |
3296 .RSs | |
3297 .IPs "h and k" | |
3298 select previous/\:next channel | |
3299 .IPs n\ \ \ \ | |
3300 change norm | |
3301 .IPs u\ \ \ \ | |
3302 change channel list | |
3303 .RE | |
3304 .PD 1 | |
3305 . | |
3306 .TP | |
3307 .B DVDNAV input control | |
3308 .PD 0 | |
3309 .RSs | |
3310 .IPs "K,J,H,L" | |
3311 browse up/\:down/\:left/\:right | |
3312 .IPs M\ \ \ \ | |
3313 jump to main menu | |
3314 .IPs S\ \ \ \ | |
3315 select | |
3316 .RE | |
3317 .PD 1 | |
3318 | |
3319 | |
3320 .\" -------------------------------------------------------------------------- | |
3321 .\" Slave mode protocol | |
3322 .\" -------------------------------------------------------------------------- | |
3323 . | |
3324 .SH "SLAVE MODE PROTOCOL" | |
3325 If the \-slave option is given, playback is controlled by a | |
3326 line\-based protocol. | |
3327 Each line must contain one command otherwise one of the following tokens: | |
3328 .TP | |
3329 .B Commands | |
3330 .RSs | |
3331 .IPs "seek <value> [type=<0/\:1/\:2>]" | |
3332 Seek to some place in the movie. | |
3333 Type 0 is a relative seek of +/\:- <value> seconds. | |
3334 Type 1 seek to <value> % in the movie. | |
3335 Type 2 is a seek to an absolute position of <value> seconds. | |
3336 .IPs "audio_delay <value>" | |
3337 Adjust the audio delay of value seconds | |
3338 .IPs quit | |
3339 Quit MPlayer | |
3340 .IPs pause | |
3341 Pause/\:unpause the playback | |
3342 .IPs grap_frames | |
3343 Somebody know ? | |
3344 .IPs "pt_step <value> [force=<value>]" | |
3345 Go to next/\:previous entry in the playtree. | |
3346 .IPs "pt_up_step <value> [force=<value>]" | |
3347 Like pt_step but it jumps to next/\:previous in the parent list. | |
3348 .IPs "alt_src_step <value>" | |
3349 When more than one source is available it selects the next/\:previous one | |
3350 (only supported by asx playlist). | |
3351 .IPs "sub_delay <value> [abs=<value>]" | |
3352 Adjust the subtitles delay of +/\:- <value> seconds or set it to <value> | |
3353 seconds when abs is non zero. | |
3354 .IPs "osd [level=<value>]" | |
3355 Toggle osd mode or set it to level when level > 0. | |
3356 .IPs "volume <dir>" | |
3357 Increase/\:decrease volume | |
3358 .IPs "[contrast|brightness|hue|saturation] <\-100\-100> [abs=<value>]" | |
3359 Set/\:Adjust video parameters. | |
3360 .IPs "frame_drop [type=<value>]" | |
3361 Toggle/\:Set frame dropping mode. | |
3362 .IPs "sub_visibility" | |
3363 Toggle subtitle visibility. | |
3364 .IPs "sub_pos <value>" | |
3365 Adjust subtitles position. | |
3366 .IPs vo_fullscreen | |
3367 Switch to fullscreen mode. | |
3368 .IPs "tv_step_channel <dir>" | |
3369 Select next/\:previous tv channel. | |
3370 .IPs "tv_step_norm" | |
3371 Change TV norm. | |
3372 .IPs "tv_step_chanlist" | |
3373 Change channel list. | |
3374 .IPs "gui_[loadsubtitle|about|play|stop]" | |
3375 GUI actions | |
3376 .RE | |
3377 | |
3378 | |
3379 .\" -------------------------------------------------------------------------- | |
3380 .\" Files | |
3381 .\" -------------------------------------------------------------------------- | |
3382 . | |
3383 .SH FILES | |
3384 .TP | |
3385 /etc/\:mplayer/\:mplayer.conf | |
3386 system\-wide settings | |
3387 .TP | |
3388 ~/.mplayer/\:config | |
3389 user settings | |
3390 .TP | |
3391 ~/.mplayer/\:input.conf | |
3392 input bindings (see '\-input keylist' for full keylist) | |
3393 .TP | |
3394 ~/.mplayer/\:gui.conf | |
3395 GUI configuration file | |
3396 .TP | |
3397 ~/.mplayer/\:gui.pl | |
3398 GUI playlist | |
3399 .TP | |
3400 ~/.mplayer/\:font/ | |
3401 font directory (There must be a font.desc file and files with .RAW extension.) | |
3402 .TP | |
3403 ~/.mplayer/\:DVDkeys/ | |
3404 cracked CSS keys | |
3405 .PD 0 | |
3406 .TP | |
3407 Sub files | |
3408 are searched for in this priority (for example /mnt/\:movie/\:movie.avi): | |
3409 .RSs | |
3410 /mnt/\:cdrom/\:movie.sub | |
3411 .br | |
3412 ~/.mplayer/\:sub/\:movie.sub | |
3413 .br | |
3414 ~/.mplayer/\:default.sub | |
3415 .RE | |
3416 .PD 1 | |
3417 | |
3418 | |
3419 .\" -------------------------------------------------------------------------- | |
3420 .\" Examples | |
3421 .\" -------------------------------------------------------------------------- | |
3422 . | |
3423 .SH EXAMPLES | |
3424 .TP | |
3425 .B Quickstart DVD playing | |
3426 mplayer \-dvd 1 | |
3427 .TP | |
3428 .B Play in japanese with english subtitles | |
3429 mplayer \-dvd 1 \-alang ja \-slang en | |
3430 .TP | |
3431 .B Play only chapters 5, 6, 7 | |
3432 mplayer \-dvd 1 \-chapter 5\-7 | |
3433 .TP | |
3434 .B Multiangle DVD playing | |
3435 mplayer \-dvd 1 \-dvdangle 2 | |
3436 .TP | |
3437 .B Playing from a different DVD device | |
3438 mplayer \-dvd 1 \-dvd\-device /dev/\:dvd2 | |
3439 .TP | |
3440 .B Old style DVD (VOB) playing | |
3441 mplayer \-dvdauth /dev/\:dvd /mnt/\:dvd/\:VIDEO_TS/\:VTS_02_4.VOB | |
3442 .TP | |
3443 .B Stream from HTTP | |
3444 mplayer http://mplayer.hq/\:example.avi | |
3445 .TP | |
3446 .B Stream using RTSP | |
3447 mplayer rtsp://server.example.com/\:streamName | |
3448 .TP | |
3449 .B Convert subtitle to MPsub (to ./\:dump.mpsub) | |
3450 mplayer dummy.avi \-sub source.sub \-dumpmpsub | |
3451 .TP | |
3452 .B Input from standard V4L | |
3453 mplayer \-tv on:driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 | |
3454 \-vo xv | |
3455 .TP | |
3456 .B Encoding DVD title #2, only selected chapters | |
3457 mencoder \-dvd 2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc divx4 | |
3458 .TP | |
3459 .B Encoding DVD title #2, resizing to 640x480 | |
3460 mencoder \-dvd 2 \-vop scale=640:480 \-o title2.avi \-oac copy \-ovc divx4 | |
3461 .TP | |
3462 .B Encoding DVD title #2, resizing to 512xHHH (keep aspect ratio) | |
3463 mencoder \-dvd 2 \-vop scale \-zoom \-xy 512 \-o title2.avi \-oac copy | |
3464 \-ovc divx4 | |
3465 .TP | |
3466 .B The same, but with libavcodec family, MPEG4 (Divx5) compression | |
3467 mencoder \-dvd 2 \-o title2.avi \-ovc lavc | |
3468 \-lavcopts vcodec=mpeg4:vhq:vbitrate=1800 \-oac copy | |
3469 .TP | |
3470 .B The same, but with libavcodec family, MJPEG compression | |
3471 mencoder \-dvd 2 \-o titel2.avi \-ovc lavc | |
3472 \-lavcopts vcodec=mjpeg:vhq:vbitrate=1800 \-oac copy | |
3473 .TP | |
3474 .B Encoding all *.jpg files in the current dir | |
3475 mencoder \\*.jpg \-mf on:fps=25 \-o output.avi \-ovc divx4 | |
3476 .TP | |
3477 .B Encoding from tuner | |
3478 mencoder \-tv on:driver=v4l:width=640:height=480 \-o tv.avi \-ovc rawrgb | |
3479 .TP | |
3480 .B Encoding from a pipe | |
3481 rar p test-SVCD.rar | mencoder \-ovc divx4 \-divx4opts br=800 \-ofps 24 | |
3482 \-\- \- | |
3483 .TP | |
3484 .B Encoding multiple *.vob files | |
3485 cat *.vob | mencoder <options> \- | |
3486 | |
3487 | |
3488 .\" -------------------------------------------------------------------------- | |
3489 .\" Bugs, authors, standard disclaimer | |
3490 .\" -------------------------------------------------------------------------- | |
3491 . | |
3492 .SH BUGS | |
3493 Probably. | |
3494 PLEASE, double-check the documentation (especially bugreports.html), | |
3495 the FAQ and the mail archive before! | |
3496 .br | |
3497 Send your complete bug reports to the MPlayer-users mailing list at | |
3498 <mplayer-users@mplayerhq.hu>. | |
3499 We love complete bug reports :) | |
3500 | |
3501 | |
3502 .SH AUTHORS | |
3503 Check documentation. | |
3504 .TP | |
3505 MPlayer is (C) 2000\-2003 | |
3506 .B Arpad Gereoffy | |
3507 .TP | |
3508 This man page is written and maintained by | |
3509 .B Gabucino | |
3510 .br | |
3511 .B Diego Biurrun | |
3512 .br | |
3513 .B Jonas Jermann | |
3514 .PP | |
3515 Please send mails about it to the MPlayer-users mailing list. | |
3516 | |
3517 | |
3518 .SH "STANDARD DISCLAIMER" | |
3519 Use only at your own risk! | |
3520 There may be errors and inaccuracies that could be damaging to your system or | |
3521 your eye. | |
3522 Proceed with caution, and although this is highly unlikely, the authors don't | |
3523 take any responsibility for that! | |
3524 .\" end of file |