comparison DOCS/hu/mplayer.1 @ 9332:a604236b0dd6

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