Mercurial > mplayer.hg
diff 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 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/DOCS/hu/mplayer.1 Sat Feb 08 00:00:00 2003 +0000 @@ -0,0 +1,3474 @@ +.\" MPlayer (C) 2000-2003 Arpad Gereoffy +.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann +.\" Hungarian translation/maintaining by Gabucino. +.\" +.\" Run this to get a html version of the man page: +.\" cat mplayer.1 | sed s/SS\ 20/SS\ 4/ | groff -man -Thtml - > manpage.html +.\" Run this to get a text version of the man page: +.\" groff -m man -Tascii mplayer.1 | col -bx > manpage.txt +.\" +. +.\" -------------------------------------------------------------------------- +.\" Macro definitions +.\" -------------------------------------------------------------------------- +. +.\" default indentation is 7, don't change! +.nr IN 7 +.\" define indentation for suboptions +.nr SS 20 +.\" add new suboption +.de IPs +.IP "\\$1" \n(SS +.. +.\" begin of first level suboptions, end with .RE +.de RSs +.RS \n(IN+3 +.. +.\" begin of 2nd level suboptions +.de RSss +.PD 0 +.RS \n(SS+3 +.. +.\" end of 2nd level suboptions +.de REss +.RE +.PD 1 +.. +. +.\" -------------------------------------------------------------------------- +.\" Title +.\" -------------------------------------------------------------------------- +. +.TH MPlayer 1 "2003-02-03" +. +.SH NAME +mplayer \- Filmlelátszó Linux alá +.br +mencoder \- Filmenkóder Linux alá + +.\" -------------------------------------------------------------------------- +.\" Synopsis +.\" -------------------------------------------------------------------------- +. +.SH SZINTAXIS +.na +.nh +.B mplayer +.RI [opciók]\ [ \ file\ | \ URL\ | \ lejátszáslista\ | \ -\ ] +.br +.B mplayer +'in +\n[.k]u +[globális opciók] +.I file1 +[specifikus opciók] [file2] [specifikus opciók] +.br +.in +.B mplayer +'in +\n[.k]u +[globális opciók] +.RI { "file-ok csoportja és opcióik" } +[csopotspecifikus opciók] +.br +.in +.B mplayer +'in +\n[.k]u +.RI [ dvd | vcd | cdda | cddb | tv ] ://sáv +[opciók] +.br +.in +.B mplayer +'in +\n[.k]u +.RI [ mms[t] | http | http_proxy | rt[s]p ] :// +[felh.név:jelszó@]\fIURL\fP[:port] [opciók] +.br +.in +.B mencoder +[opciók] +.RI [ \ file\ | \ URL\ | \ -\ ] +[\-o\ file] +.br +.B gmplayer +[opciók] +[\-skin\ skin] +.ad +.hy + +.\" -------------------------------------------------------------------------- +.\" Description +.\" -------------------------------------------------------------------------- +. +.SH DESCRIPTION +.B mplayer +egy LINUXON működő videolejátszó (fut sok más Unix-on és akár nem-x86 +processzorokon is. Lásd a 6-os fejezetet). Le tudja játszani a legtöbb +MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, OGG/\:OGM, VIVO, FLI, +NuppelVideo, yuv4mpeg, FILM, RoQ és PVA file-t és ezekhez felsorakoztat +jónéhány natív, XAnim, RealPlayer, és Win32 codecet. vele VideoCD-t, SVCD-t, +DVD-t, 3ivx-et, RealMedia-t, és DivX\ 3/\:4/\:5-öt is (és ezekhez egyáltalán +nincs szüksége az avifile csomagra). +.PP +Az MPlayer másik óriási tulajdonsága a megjelenítési módok széles választéka. +Működik X11, Xv, DGA, OpenGL, SVGAlib, fbdev, aalib, DirectFB, sőt SDL-lel vagy +GGI-vel is (beleértve ezáltal az SDL/GGI drivereit is), és néhány +alacsonyszintű kártyaspecifikus driver (Matrox, 3dfx, Radeon, Mach64, +Permedia3) is használható! Legtöbbjük támogat szoftveres vagy hardveres +nagyítást, így a teljesképernyős mód is elérhető. +.PP +Az MPlayer támogat továbbá hardveres MPEG kártyákkal történő +dekódolást/megjelenítést, így például a DVB és DXR3/\:Hollywood+ kártyákon! +.PP +Az MPlayernek van onscreen display (OSD) funkciója is státuszinformációk +megjelenítésére, szép élsímított árnyékolt betűtipusokkal. Európai/\:ISO +8859-1,2 (Magyar, Angol, Cseh, stb), cirill és kóreai betűtipusok is +támogatottak 10 szöveges, (MicroDVD, SubRip, SubViewer, Sami, VPlayer, RT, SSA, +AQTitle, JACOsub és a sajátunk: MPsub) valamint DVD feliratokkal (SPU +stream-ek, VobSub és Closed Caption). +.PP +.B mencoder +egy egyszerű film enkóder, az MPlayer által lejátszható filmek (lásd fent) +más, MPlayer által támogatott formátumokba történő átalakítására. Jelenleg +DivX4, XviD, vagy a libavcodec codec-jeivel tud tömöríteni, PCM/\:MP3/\:VBRMP3 +audioval, 1, 2 vagy 3\ menetben. +Ezenkívül tud stream-et másolni, plugineket kezelni (crop, expand, flip, +postprocess, rotate, scale, noise, rgb/\:yuv konverzió), és még rengeteg +egyebet. +.PP +.B gmplayer +egy grafikus felhasználói interface az MPlayerhez. Ugyanazokat az opciókat +támogatja mint az MPlayer. + + +.\" -------------------------------------------------------------------------- +.\" Opciók +.\" -------------------------------------------------------------------------- +. +.SH "ÁLTALÁNOS INFORMÁCIÓK" +.B Nézd meg a HTML dokumentációban is! +.PP +Mindent 'flag' tipusú opciónak megvan a 'noflag' ellenpárja is, azaz az +\-fs opció ellenpárja a \-nofs. +.PP +Az összes opció betehető egy konfiguráció file-ba, melyet az mplayer +minden indulásnál beolvas. +A rendszerszintű konfigurációs file 'mplayer.conf' a konfigurációkat tartalmazó +könyvtárban van +(pl.\& /etc/\:mplayer vagy /usr/\:local/\:etc/\:mplayer), a felhasználószintű +helye pedig '~/\:.mplayer/\:config'. +A felhasználóspecifikus opciók felülbírálják a rendszerszintűeket, a +parancssorban megadottak pedig mindkettőt. +A konfigurációs file szintaxisa 'opció=<érték>', \'#' jeltől számitva +minden kommentként van kezelve. +Az olyan opciók melyek egyébként érték megadása nélkül használandóak, itt +az 'igen' vagy 'nem', illetve '1' és '0' értékeket fogadják el. +Még az al-opciók is paraméterezhetőek ily módon. + +.I PÉLDA: +.br +# Alapállapotban a Matrox meghajtó használata. +.br +vo=xmga +.br +# Imádok filmek közben kézenállni. +.br +flip=igen +.br +# Több PNG file dekódolása +.br +mf= type=png:fps=25 + +File-specifikus konfigurációs file-okat is írhatsz. +Ha például a 'movie.avi' file-hoz szeretnél konfigurációs file-t, úgy hozz +létre egy 'movie.avi.conf' nevű file-t az opciókkal, és tedd a ~/.mplayer +könyvtárba, vagy a file mellé. + +.SH "LEJÁTSZÁSI OPCIÓK (CSAK MPLAYER)" +.TP +.B \-, \-use-stdin +Adat olvasása a stdin-ről. +Az \-idx opció nem használható ilyenkor. +.TP +.B \-autoq <minőség> (használd a \-vop pp mellett) +Dinamikusan változtatja a postprocessing értékét a maradék CPU idő +függvényében. A megadott szám lesz a maximálisan használandó érték. Általában +célravezető nagy számok beírása. +Ezen opció használatához elengedhetetlen a \-vop pp opció paraméterek nélküli +használata. +.TP +.B \-autosync <faktor> +A/\:V szinkron pontosítása a mért különbség alapján. +Az \-autosync\ 0 opció megadása egyenértékű az alapállapottal, ami szerint +az időzítés teljes egészében az audio kártya által közölt értéken fog működni. +Az \-autosync\ 1 elvégzi ugyanezt, de valamelyest megváltoztatja a használt +A/\:V korrekciós algoritmust. +Olyan, páratlan számú frame rate-ű filmeknél, melyek a -nosound opcióval +helyesen játszódnak le, hasznos lehet ezen opció használata egy 1-nél nagyobb +értékkel. +Minél nagyobb az érték, az időzítés annál közelebb lesz a -nosound-hoz. +Az \-autosync\ 30 opciót érdemes kipróbálni, amennyiben a hangkártya +meghajtója nem, vagy hibásan támogatja az audio késlekedés mérését. +Ezen érték megadásával, ha nagy az A/\:V szinkron értéke, 1-2 másodperc +alatt helyreáll a helyes szinkron. +.TP +.B \-benchmark +A lejátszás végén CPU statisztikák kiírása. +A \-nosound és \-vo null opciókkal együtt a video codec sebességének +mérésére használható. +.TP +.B \-edl <filenév> +Edit decision list (EDL) használatának bekapcsolása. +A megadott file-ban szereplő értékek szerint bizonyos helyek átugrása, illetve +a hang elnémítása a videoban. +Lásd a DOCS/documentation.html#edl fejezetet a részletekhez. +.TP +.B \-edlout <filenév> +Új edit decision list (EDL) file létrehozása, és értékek rögzítése. +Lejátszás közben az 'i' billentyű megnyomására egy bejegyzés íródik a megadott +file-ba, mely szerint az elmúlt 2 másodpercet át kell ugrani. +Ez egy kiindulópontot ad az így keletkező bejegyzések finomhangolásához. +Lásd a DOCS/documentation.html#edl fejezetet a részletekhez. +.TP +.B \-fixed-vo (BÉTA KÓD!) +A video rendszer egy javított változatának használata, mely több file +lejátszásakor nyújt előnyöket. +Csak egy ablak lesz nyitva az összes file-nak. +Jelenleg a következő meghajtók fixed-vo támogatottak: x11, xv, xvidix, xmga, +gl2, és svga. +.TP +.B \-framedrop (lásd mág \-hardframedrop) +Néhány képkocka megjelenítésének hanyagolása, hogy lassú rendszereken is +megfelelő legyen az A/\:V szinkron. +.TP +.B \-h, \-help, \-\-help +Rövid segítő szöveg kiírása. +.TP +.B \-hardframedrop +Intenzívebb képkockaeldobás (a dekódolási minőség rovására). +Torz képekhez vezet! +.TP +.B \-identify +A file paramétereinek kiírása emészthető formában. +A TOOLS/midentify wrapper script eltünteti a maradék kimenetet, és +(remélhetőleg) shell escape-eli a fileneveket. +.TP +.B \-input <parancsok> +Ez az opció használható az input rendszer bizonyos paramétereinek +beállítására. Az útvonalak a ~/\:.mplayer/ könyvtárhoz viszonyulnak. + +.I MEGJEGYZÉS: +.br +Az autorepeat jelenleg csak joystick-ekkel működik. +.br +A rendelkezésre álló parancsok listája: + +.PD 0 +.RSs +.IPs conf=<file> +Alternatív input.conf file beolvasása. +Ha útvonal nincs megadva, a ~/\:.mplayer könyvtár lesz használva. +.IPs ar\-delay +Autorepeat előtti késleltetés megadása milliszekundumban (0: kikapcsolás). +.IPs ar\-rate +Billentyű/másodperc érték megadása autorepeat használata esetén. +.IPs keylist +Az összes használható billentyű listájának kiírása. +.IPs cmdlist +Az összes használható parancs kiírása. +.IPs js\-dev +Használandó joystick megadása (alapállapot: /dev/\:input/\:js0). +.IPs file +Parancsok beolvasása a megadott file-ból. Leginkább fifo megadása +esetén hasznos. +.RE +.PD 1 +. +.TP +.B \-lircconf <file> +LIRC (Linux Infrared Remote Control) konfigurációs file megadása, ha +nem tetszik az alapértelmezett ~/\:.lircrc. +.TP +.B \-loop <szám> +Film lejátszása <szám>szor. +A 0 érték végtelent jelent. +.TP +.B \-menu (BÉTA KÓD) +OSD menu támogatás bekapcsolása. +.TP +.B \-menu-root <érték> (BÉTA KÓD) +Főmenű megadása. +.TP +.B \-menu-cfg <file> (BÉTA KÓD) +Alternatív menu.conf file használata. +.TP +.B \-nojoystick +Joystick támogatás kikapcsolása. +Alapállapotban bekapcsolva. +.TP +.B \-nolirc +LIRC támogatás kikapcsolása. +.TP +.B \-nortc \ \ +A Linux RTC használatának kikapcsolása, mint időzítő mechanizmus. +.TP +.B \-playlist <file> +File-ok lejátszása lejátszási lista használatával (1 file/sor, vagy Winamp +illetve ASX formátum). +.TP +.B \-quiet \ \ +Kevesebb kimeneti és státusz üzenet kiírása. +.TP +.B \-really\-quiet \ \ +Még kevesebb üzenet kiírása. +.TP +.B \-sdp +Annak megadása hogy a bemeneti file SDP tipusú ('Session Description Protocol'), +mely egy RTP session-t ír le (lásd http://www.live.com/mplayer/). +.TP +.B \-shuffle \ \ +File-ok lejátszása véletlenszerű sorrendben. +.TP +.B \-skin <skin\ könyvtár> (BÉTA KÓD) +Skin betöltése a megadott könyvtárból (útvonalnév NÉLKÜL). + +.I PÉLDA: +.PD 0 +.RSs +.IPs "\-skin fittyfene" +megpróbálja a Skin/fittyfenét. +Először az +/usr/local/share/mplayer/ +könyvtárban, majd a ~/.mplayer/ könyvtárban. +.RE +.PD 1 +. +.TP +.B \-slave \ \ +Ez az opció bekapcsolja a slave módot. +Ennek az opciónak a célja hogy más programok (frontendek) is tudják használni +az MPlayert. +Billentyűzet lenyomások figyelése helyett az MPlayer egyszerű parancsokat +vár a standard bemeneten. +The section +.B A SLAVE MÓD PROTOKOLLJA +című fejezet elmagyarázza a szintaxist. +.TP +.B \-softsleep +Jobb minőségű szoftveres időzítés használata. +Olyan pontos mint az RTC, de nem igényel root jogosultságot. +Az ár a megnövekedett CPU igény. +.TP +.B \-speed <0.01\-100> +Lejátszási sebesség beállítása. +.TP +.B \-sstep <sec> +Másodpercek a képkockák megjelenítése között. +Slideshow-oknál hatásos. + + +.SH "DEMUXER/STREAM OPCIÓK" +.TP +.B \-aid <id> (lásd még az \-alang opciót) +Audio csatorna kiválasztása [MPEG: 0\-31 AVI/\:OGM: 1\-99 ASF/\:RM: 0\-127 +VOB(AC3): 128\-159 VOB(LPCM): 160\-191] +Az MPlayer kiírja a használható ID-ket mikor bővebb kimenetű (-v) módban +fut. +.TP +.B \-alang <kétbetűs\ országkód> (lásd még az \-aid opciót) +Csak DVD lejátszásnál használható. +Mindig a megadott nyelvű audio sávok lejátszására való törekvés. +A rendelkezésre álló nyelvek listáva a \-v opcióval, és a kimenet +átnézésével tekinthető meg. + +.I PÉLDA: +.PD 0 +.RSs +.IPs "\-alang hu,en" +Magyar nyelvű szöveg használata, vagy angol, ha nem áll magyar rendelkezésre. +.RE +.PD 1 +. +.TP +.B \-audio\-demuxer <szám> (csak \-audiofile opcióval) +Az \-audiofile opcióhoz használandó audio demuxer megadása. +Az opció a demuxers.h-ban található ID-k egyike. +Használd az \-audio\-demuxer 17 opciót ha például mp3 file-t akarsz +kényszeríteni. +.TP +.B \-audiofile <filenév> +Audio lejátszása külső file-ból (WAV, MP3, vagy Ogg Vorbis), filmnézés +közben. +.TP +.B \-bandwidth <érték> +Maximális sávszélesség megadása hálózati lejátszáshoz (olyan szerverekkel +használható, melyek képesek különböző sávszélességen küldeni igény +szerint). +.TP +.B \-cdrom\-device <útvonal\ az\ egységhez> +Az alapértelmezett /dev/\:cdrom egység használatának felülbírálása. +.TP +.B \-cache <kbyte> +Ezzel az opcióval megadható hogy mennyi memória (kbyte-ban) legyen használva +gyorsítótárnak. +Különösen hasznos lassú médián (alapértelmezett: \-nocache). +.TP +.B \-cdda <opció1:opció2> +Ezzel az opcióval lehet az MPlayer CD audio olvasási képességét finomhangolni. +.br +A rendelkezésre álló opciók: +. +.RSs +.IPs sebesség=<érték> +CD pörgetési sebesség állítása +.IPs paranoia=<0\-2> +paranoia szint állítása +.RSss +0: ellenőrzés kikapcsolása +.br +1: csak overlap ellenőrzés (alapértelmezett) +.br +2: teljes adatjavítás és ellenőrzés +.REss +.IPs generic-dev=<érték> +megadott SCSI egység használata +.IPs sector-size=<érték> +atomi olvasás mérete +.IPs overlap=<érték> +ellenőrzés esetén az overlap keresés legalacsonyabb értékének állítása +<érték> szektorszámra. +.IPs toc-bias +Annak feltételezése, hogy a TOC-ban 1-es számmal szereplő sáv kezdő +offset-ét LBA\ 0-ként címezzük-e. +Néhány Toshiba meghajtónak szüksége van erre hogy a sávok határai +jók legyenek. +.IPs toc-offset=<érték> +<érték> darab szektor hozzáadása a jelentett értékhez. Lehet negatív. +.IPs (no)skip +(soha) ne fogadjon el hibás adatrekonstrukciót. +.RE +. +.TP +.B \-channels <szám> +Hangcsatornák számának megváltoztatása, ha nincs megadva, alapban 2. +Ha a kimeneti csatornák száma nagyobb mint a hang csatornáinak száma, +akkor üres csatornák lesznek beillesztve (kivéve mono-ról sztereóra +mixelés esetén).Ha a kimeneti csatornák száma kevesebb mint a bemeneté, +az eredmény az audió dekódertől függ (\-afm). +Az MPlayer megmondja a dekódernek hogy annyi csatornán dekódoljon, +amennyit ez az opció megad. +Innentől a dekóderen múlik ennek teljesítése. Ha a dekóder több csatorán +akar adni mint ami meg lett adva, a limitet túllépő csatornák törlődnek. +Ez akkor fontos ha AC3-as hanggal ellátott videót nézel (pl DVD). +Ebben az esetben a liba52 dekódol, és lemixeli az audiót a kért számú +csatornára. + +.br +A rendelkezésre álló opciók: + +.PD 0 +.RSs +.IPs 2 +Sztereó +.IPs 4 +Térhatás +.IPs 6 +Teljes 5.1 +.RE +.PD 1 +. +.TP +.B \-chapter <fejezet\ id>[-<utolsó\ fejezet\ id>] +Itt adható meg, hogy a lejátszás mely fejezetnél kezdődjön. Opcionálisan az +is megadható, hogy melyiknél végződjön (alapban: 1). +Példákat lásd alább. +.TP +.B \-csslib <filenév> +(régi tipusú DVD opció) Ezzel az opcióval felül lehet bírálni a libcss.so +alapértelmezett helyét. +.TP +.B \-cuefile <filenév> (lásd még \-vcd) +(S)VCD lejátszása a CDRwin (bin/cue) image-éből, amit az itt megadott +file ír le. +.TP +.B \-demuxer <szám> +Használandó demuxer tipusának felülbírálata. +A demuxers.h file-ban leírt ID-k lehetnek a paraméterek. +Használd a \-demuxer 17 opciót az MP3 detektálás kényszerítésére. +.TP +.B \-dumpaudio (csak MPLAYER) +Nyers, tömörített audio stream kiírása a ./\:stream.dump file-ba +(MPEG/\:AC3-nál hasznos). +.TP +.B \-dumpfile <filenév> (csak MPLAYER) +Itt adható meg hogy az MPlayer melyik file-ba dumpoljon. +Együtt használandó a \-dumpaudio / \-dumpvideo / \-dumpstream opciókkal. +.TP +.B \-dumpstream (csak MPLAYER) +Nyers, tömörítetlen stream kiírása a ./\:stream.dump file-ba. +Hasznos DVD rippeléshez, vagy hálozati lejátszáshoz. +.TP +.B \-dumpvideo (csak MPLAYER) +Nyers, tömörítetlen video stream kiírása a ./\:stream.dump file-ba +(nem túl hasznos) +.TP +.B \-dvd <cím\ id> +Megadja az MPlayernek hogy mely ID-vel ellátott filmeket játssza le. +Például néha az '1'-es egy előzetes, és a '2'-es az igazi film. + +.I MEGJEGYZÉS: +.br +Néha a deinterlace-elés szükséges a DVD lejátszáshoz, +lásd a \-vop pp=0x20000 opciót. +.TP +.B \-dvd\-device <útvonal\ az\ egységhez> +Alapértelmezett /dev/\:dvd egységnév felülbírálata. +.TP +.B \-dvdangle <szög\ id> +Néhány DVD lemezen egyes jelenetek több szemszögből is megtekinthetők. +Itt adható meg az MPlayer-nek, hogy mely szögeket jelenítse meg +(alapban: 1). +Példákat lásd alább. +.TP +.B \-dvdauth <DVD\ egység> +(régi tipusú DVD opció) Bekapcsolja a DVD autentikációt a megadott egységre. +.TP +.B \-dvdkey <CSS\ kulcs> +(régi tipusú DVD opció) Egy DVD-ről dekódolatlanul HDD-re másolt VOB file +lejátszásához szükséges ez az opció, mely megadja a dekódoláshoz +szükséges CSS kulcsot (amelyet a \-dvdauth opcióval történő autentikációval +lehet megszerezni). +.TP +.B \-dvdnav (BÉTA KÓD) +libdvdnav használatának kényszerítése. +.TP +.B \-forceidx +INDEX újraépítésének kényszerítése. +Hibás AVI-k lejátszásánál hasznos, a tekerés bekapcsolásához. +Az ilyen file-okat a MEncoder-rel lehet maradandóan javítani (lásd a +dokumentációt. +.TP +.B \-fps <érték> +A video framerate-jének felülbírálata (ha a fejlécben nem, vagy rosszul +szerepel) (lebegőpontos szám). +.TP +.B \-frames <szám> +Csak a megadott számú képkocka lejátszása/konvertálása. +.TP +.B \-hr\-mp3\-seek (csak .MP3) +Magas pontosságú MP3 tekerés. +Alapban csak külső MP3 file-ból történő lejátszásnál van bekapcsolva, +mivel ilyenkor a pontos helyre kell tekerni az A/\:V szinkronhoz. Főleg +akkor lehet lassú ha hátrafelé kell tekerni, mivel ilyenkor a file elejétől +újra kell számolni a frame-eket. +.TP +.B \-idx (lásd még \-forceidx) +AVI INDEX újraépítése, ha hiányzik, így a tekerés lehetővé tétele. +Hasznos hibás/\:folyamatban lévő letöltésekhez, vagy rosszul +létrehozott file-okhoz. +.TP +.B \-mc <másodperc/frame> +Maximális A-V szinkron javítás egy képkocka alatt. +.TP +.B \-mf <opció1:opció2:...> +Több PNG vagy JPEG file-ból történő dekódolásnál használatos. +.br +A rendelkezésre álló opciók: + +.PD 0 +.RSs +.IPs on\ \ \ +multifile támogatás bekapcsolása +.IPs w=<érték> +a kimenet szélessége (autodetekt) +.IPs h=<érték> +a kimenet magassága (autodetekt) +.IPs fps=<érték> +kimenet fps-e (alapban: 25) +.IPs type=<érték> +bemeneti file-ok tipusa (használható: jpeg, png, tga) +.RE +.PD 1 +. +.TP +.B \-ni (csak .AVI) +Non\-interleaved AVI parser használata (néhány hibás file lejátszásánál segít. +.TP +.B \-nobps (csak .AVI) +Ne haszálja az AVI byte/\:sec értékét az A\-V szinkronhoz (AVI). +Hibás fejlécű AVI-knál használatos. +.TP +.B \-noextbased +Kikapcsolja a kiterjesztés alapján történő demuxerkiválasztást. +Alapban mikor olyan file-t kell betölteni melyet nem lehet megbízhatóan +detektálni, a file kiterjesztése alapján töltődik be a megfelelő +demuxer. Sikertelenség esetén visszalép a tartalom alapján történő +detektáláshoz. +.TP +.B \-passwd <jelszó> (lásd még \-user opció) +Jelszó megadása HTTP autentikációhoz. +.TP +.B \-rawaudio <opció1:opció2:...> +Ezzel az opcióval le lehet játszani nyers audio file-okat. +Használható olyan audio CD-k lejátszásához, melyek nem 44kHz 16bit sztereók. +.br +A használható opciók: + +.PD 0 +.RSs +.IPs on\ \ \ +nyers audio demuxer használata +.IPs channels=<érték> +csatornák száma +.IPs rate=<érték> +frekvencia +.IPs samplesize=<érték> +minták mérete byte-ban +.IPs format=<érték> +fourcc hexában +.RE +.PD 1 +. +.TP +.B \-rawvideo <opció1:opció2:...> +Ezzel az opcióval le lehet játszani nyers video file-okat. +.br +A használható opciók: + +.PD 0 +.RSs +.IPs on\ \ \ +nyers video demuxer bekapcsolása +.IPs fps=<érték> +képkocka/másodperc, alapban 25.0 +.IPs sqcif|qcif|cif|4cif|pal|ntsc +képszabvány tipusa +.IPs w=<érték> +kép szélessége pixelben +.IPs h=<érték> +kép magassága pixelben +.IPs y420|yv12|yuy2|y8 +colorspace beállítása +.IPs format=<érték> +colorspace (fourcc) hexában +.IPs size=<érték> +képkockák mérete byte-ban +.RE +.PD 1 +. +.TP +.B \-rtsp-stream-over-tcp +'rtsp://' URL-ekkel használandó, azt adja meg hogy a bejövő RTP és RTCP +csomagok TCP-n keresztül jöjjenek. Olyan internet kapcsolat esetében +hasznos, amely nem engedi be az UDP csomagokat. +(lásd http://www.live.com/mplayer/). +.TP +.B \-skipopening +DVD megnyitás átlépése (csak dvdnav). +.TP +.B \-sb <byte\ pozíció> (lásd még \-ss opció) +Byte pozícióra tekerés. +CDROM image-ek, vagy olyan VOB file-ok lejátszásánál hasznos, melyek elején +szemét van. +.TP +.B \-srate <Hz> +A megadott audio lejátszási ráta kényszerítése, egyben a video lejátszás +sebességének megváltoztatásával. A MEncoder ezt az értéket átadja a lame-nak +mintavételezésre. +.TP +.B \-ss <idő> (lásd még \-sb opció) +Megadott időponthoz tekerés. + +.I PÉLDA: +.PD 0 +.RSs +.IPs "\-ss 56" +tekerés 56 másodperchez +.IPs "\-ss 01:10:00" +tekerés 1\ óra 10\ perchez +.RE +.PD 1 +. +.TP +.B \-tv <opció1:opció2:...> +Ez az opció bekapcsolja az MPlayer TV grabbelő részét. + +.I MEGJEGYZÉS: +.br +Az MPlayer nem fogad el kettőspontokat, igy azok helyett pontokat kell +használni a device ID-ben (tehát hw:0,0 helyett hw.0,0) +.br +Figyelem: bár itt bármilyen audio frekvenciát ki lehet választani, +a LAME audio codec csak a szabványosakba képes kódolni. Nem szabványos +frekvenciák esetén hang nélküli AVI lesz az eredmény. +.br +A használható opciók: +. +.RSs +.IPs on\ \ \ +TV bemenet bekapcsolása +.IPs noaudio +hang kikapcsolása +.IPs driver=<érték> +használható: dummy, v4l, bsdbt848 +.IPs device=<érték> +Az alap /dev/\:video0 egység használatának felülbírálata. +.IPs input=<érték> +Az alap 0 (Televízió) bemenet helyett más kiválasztása (listához lásd a +kimenetet) +.IPs freq=<érték> +A tuner megadott frekvenciára történő állítása (pl. 511.250> +Nem használható a channels opcióval. +.IPs outfmt=<érték> +A tuner kimeneti formátumának megváltoztatása +(yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) +.IPs width=<érték> +a kimeneti ablak szélessége +.IPs height=<érték> +a kimeneti ablak magassága +.IPs fps=<érték> +a video capture-elés framerátája (képkocka/másodperc) +.IPs buffersize=<érték> +a capture buffer maximális mérete megabyte-ban (alapban: dinamikus) +.IPs norm=<érték> +használható: PAL, SECAM, NTSC +.IPs channel=<érték> +A tuner <érték> csatornára állítása. +.IPs chanlist=<érték> +használható: europe-east, europe-west, us-bcast, us-cable, stb +.IPs channels=<csatorna>\-<név>,<csatorna>\-<név>,... +Csatornák elnevezése. +Sorköz helyett használd a _ karaktert. +A csatornák nevei OSD-vel ki lesznek írva, és a tv_step_channel, tv_set_channel, +és tv_last_channel parancsok távirányítóval is használhatóak lesznek +(lásd lirc). +Nem kompatibilis a freq opcióval. +Vigyázat: a csatornák száma ilyenkor a 'channels' listában elfoglalt +pozíciójuk lesz, 1-el kezdődően. +Például: tv://1, tv://2, tv_set_channel 1, tv_set_channel 2, stb. +.IPs audiorate=<érték> +audio capture-elés bitrátája +.IPs forceaudio +audio felvétele akkor is, ha a v4l szerint nincs audio bemenet +.IPs alsa +felvétel ALSA-ról +.IPs amode=<0\-3> +audio mód választás: +.RSss +0: mono +.br +1: sztereó +.br +2: 1-es nyelv +.br +3: 2-es nyelv +.REss +.IPs forcechan=<1\-2> +Alapban a felvett audio csatornák száma a tv kártya lekérdezésével derül ki. +Ezzel az opcióval felül lehet bírálnia a visszaadott értéket. +.IPs adevice=<érték> +megadott audio bemenet használata +.RSss +/dev/\:...\& OSS-hez +.br +hardware ID ALSA-hoz +.REss +.IPs audioid=<érték> +a felvevőkártya audio kimenetei közötti választás, ha több van +.IPs "[volume|bass|treble|balance]=<0\-65535>" +Ezekkel az opciókkal a felvevőkártya mixerének egyes paraméterei állíthatók. +Ha nincs neki, az opció hatástalan. +.IPs immediatemode=<bool> +A 0-ás érték az audio és video egyszerre felvételét jelenti (mencoder-nél +alap). Az 1-es érték (mplayer-nél alap) csak video felvételt jelent, az audio +külső kábelen fog menni. +.RE +. +.TP +.B \-user <felhasználóné> (lásd a \-passwd opciót) +Felhasználónév megadása HTTP autentikációhoz. +.TP +.B \-vcd <sáv> +Megadott video CD sáv lejátszása egységről, vagy image fileból +(lásd a \-cuefile opciót) +.TP +.B \-vid <id> +Video csatorna kiválasztása [MPG: 0\-15 ASF: 0\-255]. +.TP +.B \-vivo <al\-opciók> (DEBUG KÓD) +A .vivo demuxer audio paramétereinek felülbírálata (hibakereső célokra). + + +.SH "OSD/SUB OPCIÓK" +.I MEGJEGYZÉS: +.br +Lásd még a \-vop expand opciót. +.TP +.B \-dumpmicrodvdsub (csak MPLAYER) +A használt felirat (amit a \-sub opció ad meg) MicroDVD formátumba +konvertálása. +A jelenlegi könyvtárban hoz létre egy dumpsub.sub file-t. +.TP +.B \-dumpmpsub (csak MPLAYER) +A használt felirat (amit a \-sub opció ad meg) MPsub formátumba +konvertálása. +A jelenlegi könyvtárban hoz létre egy dump.mpsub file-t. +.TP +.B \-dumpsrtsub (csak MPLAYER) +A használt felirat (amit a \-sub opció ad meg) idő alapú SubViewer formátumba +konvertálása. +A jelenlegi könyvtárban hoz létre egy dumpsub.srt file-t. +.TP +.B \-dumpjacosub (csak MPLAYER) +A használt felirat (amit a \-sub opció ad meg) idő alapú JACOsub formátumba +konvertálása. +A jelenlegi könyvtárban hoz létre egy dumpsub.js file-t. +.TP +.B \-dumpsami (MPLAYER only) +A használt felirat (amit a \-sub opció ad meg) idő alapú SAMI formátumba +konvertálása. +A jelenlegi könyvtárban hoz létre egy dumpsub.smi file-t. +.TP +.B \-dumpsub (csak MPLAYER) (BÉTA KÓD) +VOB stream-ekből a felirat stream kimentése. +Lásd még -dump*sub és -vobsubout* opciókat is. +.TP +.B \-ifo <vobsub\ ifo\ file> +Itt adható meg hogy a VOBSUB feliratfile paletta és frame adatai melyik +file-ban tárolódnak. +.TP +.B \-ffactor <szám> +Font alphamap-jának megadása. +Lehetséges: + +.PD 0 +.RSs +.IPs 0\ \ \ \ +egyszerű fehér betűk +.IPs 0.75\ \ +nagyon halvány fekete körvonal (alap) +.IPs 1\ \ \ \ +vékony fekete körvonal +.IPs 10\ \ \ +vastag fekete körvonal +.RE +.PD 1 +. +.TP +.B \-font <útvonal\ a\ font.desc\ filehoz> +Az OSD/\:SUB betűtipusok megadott könyvtárban történő keresése +(normál fontoknál alapértelmezett: +~/\:.mplayer/\:font/\:font.desc, FreeType fontokhoz: ~/.mplayer/\:subfont.ttf). + +.I MEGJEGYZÉS: +.br +FreeType-nál, ez az opció a file nevét adja meg. +.br +A \-subfont-* opciók csak FreeType támogatással használhatóak. + +.I PÉLDA: +.PD 0 +.RSs +\-font ~/\:.mplayer/\:arial\-14/\:font.desc +.br +\-font ~/\:.mplayer/\:arialuni.ttf +.RE +.PD 1 +. +.TP +.B \-noautosub +Automatikus feliratkeresés és betöltés kikapcsolása. +.TP +.B \-overlapsub +Overlapping támogatás bekapcsolása minden feliratformátumhoz. +.TP +.B \-nooverlapsub +Overlapping támogatás kikapcsolása minden feliratformátumhoz (alapban +csak néhány formátumnál van bekapcsolva). +.TP +.B \-osdlevel <0\-3> (csak MPLAYER) +Megadja hogy mely OSD módban induljon az MPlayer. + +.PD 0 +.RSs +.IPs 0 +csak feliratok +.IPs 1 +hangerő + tekerés (alap) +.IPs 2 +hangerő + tekerés + idő + százalék +.IPs 3 +hangerő + tekerés + idő + százalék + teljes időtartam +.RE +.PD 1 +. +.TP +.B \-sid <id> (lásd még \-slang opció) +DVD felirat megjelenítésének bekapcsolása. +Meg kell adnod egy számot amely a választott nyelvre mutat (0\-31). +A használható feliratok listájához a \-v opcióval indítsd a lejátszást, +és figyeld a kimenetet. +.TP +.B \-slang <két\ betűs\ országkód> (lásd még \-sid opció) +Csak DVD lejátszásnál használható. +Bekapcsolja a DVD feliratok megjelenítését. +A használható feliratok listájához a \-v opcióval indítsd a lejátszást, +és figyeld a kimenetet. + +.I PÉLDA: +.PD 0 +.RSs +.IPs "\-slang hu,en" +Lehetőség szerint magyar, ha nincs akkor angol felirat használata. +.RE +.PD 1 +. +.TP +.B \-sub <felirat\ file> +Adott feliratfile használata. +.TP +.B \-sub-bg-alpha <0\-255> +Megadott alpha érték használata a feliratokhoz és OSD-hez. +A nagyobb érték nagyobb átlátszóságot jelent. +A 0 érték kivétel, ez jelenti a teljes átlátszóságot. +.TP +.B \-sub-bg-color <0\-255> +Megadott szín érték használata a feliratok és OSD hátteréhez. +Jelenleg a feliratok feketefehérek, így ez az intenzitást szabályozza. +A 255-ös érték fehéret, a 0 feketét jelent. +.TP +.B \-subcc \ +DVD Closed Caption (CC) feliratok megjelenítése. +Ezek nem VOB feliratok, hanem ASCII-k. Az 1-es régiókódú lemezeken +haszálatosak. +.TP +.B \-subcp <kódlap> +Ha a rendszered támogatja az iconv(3) használatát, ezzel az opcióval +meg lehet adni a felirat kódlapját. + +.I PÉLDA: +.PD 0 +.RSs +\-subcp latin2 +.br +\-subcp cp1250 +.RE +.PD 1 +. +.TP +.B \-sub\-demuxer <szám> (BÉTA KÓD) +Felirat demuxer tipusának felülbírálata a \-subfile opcióhoz. +.TP +.B \-subdelay <mp> +Feliratok <mp> másodperccel történő késleltetése. +Lehet negatív is. +.TP +.B \-subfont-autoscale <0\-3> +Az automatikus feliratátméterezés módja. + +.I MEGJEGYZÉS: +.br +A 0 azt jelenti, hogy a text-scale és osd-scale a font magassága pontban. +.br +A módok: + +.PD 0 +.RSs +.IPs 0 +automatikus átméretezés kikapcsolása +.IPs 1 +proporcionális a film magasságához +.IPs 2 +proporcionális a film szélességéhez +.IPs 3 +proporcionális a film átlójához (alap) +.RE +.PD 1 +. +.TP +.B \-subfont-blur <0\-8> +A font elmosásának átmérője (alapban: 2). +.TP +.B \-subfont-encoding <érték> +A font enkódolásának beállítása. Alapban: unicode. +.TP +.B \-subfont-osd-scale <0\-100> +Az OSD elemek autoscale értéke (alapban: 6). +.TP +.B \-subfont-outline <0\-8> +A font körvonalának vastagsága (alapban: 2). +.TP +.B \-subfont-text-scale <0\-100> +A felirat autoscale értéke (a képernyőméret százalékában) (alapban: 5). +.TP +.B \-subfps <ráta> +A frame/\:mp értéke a felirat file-nak (lebegőpontos szám). Alapban: a +film fps-ével megegyező. + +.I MEGJEGYZÉS: +.br +Csak frame alapú feliratokhoz, azaz a MicroDVD formátumhoz NEM. +.TP +.B \-subfile <filenév> (BÉTA KÓD) +Jelenleg haszontalan. +Ugyanaz mint az \-audiofile, de felirat stream-ekhez (OggDS?). +.TP +.B \-subpos <0\-100> (a \-vop expand opcióval hasznos) +A feliratok képernyőn elfoglalt helye. +Az érték a képernyő magasságának megadott százaléka, ahol a felirat +legyen. +.TP +.B \-subalign <0\-2> +Megadja hogy a feliratok merre legyenek rendezve. +A 0 a képernyő felső része, az 1 a közepe, a 2 az alsó része. +.TP +.B \-subwidth <10\-100> +Megadja a feliratok maximális szélességét. +Hasznos a TV kimenethez. +Az érték a felirat szélessége százalékban, a képernyő szélességéhez +viszonyítva. +.TP +.B \-unicode +Megadja az MPlayer-nek, hogy a feliratot UNICODE-ként kezelje. +.TP +.B \-utf8 \ \ +Megadja az MPlayer-nek, hogy a feliratot UTF8-ként kezelje. +.TP +.B \-sub-no-text-pp +Kikapcsol mindenféle szöveg útómunkálatot a felirat betöltése után. +Hibakeresői célra használatos. +.TP +.B \-vobsub <vobsub\ file\ kiterjesztés\ nélkül> +Megadja hogy mely VobSub file-okat kell betölteni. +Ez a teljes útvonal és filenév, de kiterjesztések nélkül, tehát +\'.idx', '.ifo', '.sub' elhagyandó. +.TP +.B \-vobsubid <0-31> +A VobSub felirat ID-je itt adható meg. +.TP +.B \-spualign <-1\-2> +Megadja hogy az spu (DVD/VobSub) feliratok hogyan legyenek helyezve. +Az értékek ugyanazok mint a -subpos esetén, illetve a -1 az eredeti +helyet jelenti. +.TP +.B \-spuaa <mód> +Antialias/nagyítása a DVD/VobSub-nak. A módhoz 16 hozzáadása azt +eredményezi hogy a nagyítás akkor is megtörténik, ha az eredeti és +a nagyított méret ugyanakkora. Például a feliratok gaussian blur-ral +történő elmosásához. A használható módok: +.PD 0 +.RSs +.IPs 0 +nincs (leggyorsabb, jó ocsmány) +.IPs 1 +körülbelül (hibás?) +.IPs 2 +teljes (lassú) +.IPs 3 +bilineáris (alap, gyors, és nem rossz) +.IPs 4 +swscaler gaussian blur-jának használata (nagyon szép) +.RE +.PD 1 +. +.TP +.B \-spugauss <0.0\-3.0> +Az -spuaa 4 opció által használt gaussian blue paramétere. Alapértelmezett: +1.0. + + +.SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)" +.TP +.B \-abs <value> (OBSOLETE) +Override audio driver/\:card buffer size detection, \-ao oss only +.TP +.B \-af <plugin1,plugin2,plugin3[=options],...> +Activate a comma separated list of audio filters and their options. +.br +Available filters are: +. +.RSs +.IPs resample[=srate[:sloppy][:type]] +Changes the sample rate of the audio stream to an integer srate (Hz). +It only supports the 16 bit little endian format. +.IPs channels[=nch] +Change the number of channels to nch output channels. +If the number of output channels is bigger than the number of input channels +empty channels are inserted (except mixing from mono to stereo, then the mono +channel is repeated in both of the output channels). +If the number of output channels is smaller than the number of input channels +the exceeding channels are truncated. +.IPs format[=bps,f] +Select the format f and bits per sample bps used for output from the +filter layer. +The option bps is an integer and denotes bytes per sample. +The format f is a string containing a concatenated mix of: +.br +alaw, mulaw or imaadpcm +.br +float or int +.br +unsigned or signed +.br +le or be (little or big endian) +.br +.IPs "volume[=v:sc]" +Select the output volume level. +This filter is not reentrant and can therefore only be enabled once for every +audio stream. +.RSss +v: desired gain in dB for all channels in the stream. +The gain can be set from -200dB to +40dB (where -200dB mutes the sound +completely and +40dB equals a gain of 1000). +The default gain is -20dB. +.br +sc: enable soft clipping. +.REss +.IPs "pan[=n:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...]" +Mixes channels arbitrarily, see DOCS/sound.html for details. +.RSss +n: number of output channels (1 - 6). +.br +lij: how much of input channel j is mixed into output channel i. +.REss +.IPs "sub[=fc:ch]" +Add sub-woofer channel. +.RSss +fc: Cutoff frequency for low-pass filter (20Hz to 300Hz) default is 60Hz. +.br +ch: channel number for the sub-channel. +.REss +.IPs "surround[=d]" +Decoder for matrix encoded surround sound, works on many 2 channel files. +.RSss +d: delay time in ms for the rear speakers (0ms to 1000ms) default is 15ms. +.REss +.IPs delay[=ch1:ch2:...] +Delays the sound output. +Specify the delay separately for each channel in milliseconds (floating point +number between 0 and 1000). +.RE +. +.TP +.B \-af-adv <force=(0\-3):list=(filters)> (see -af option too) +Specify advanced audio filter options: +. +.RSs +.IPs force=<0-3> +Forces the insertion of audio filters to one of the following: +.RSss +0: Completely automatic insertion of filters (default) +.br +1: Optimize for speed +.br +2: Optimize for accuracy +.br +3: Turn off auto +.REss +.IPs list=<filters> +Same as -af (see -af option). +.RE +. +.TP +.B \-ao <driver1[:device],driver2,...[,]> +Specify a priority list of audio output drivers (optionally with device) to be +used. +\'device' is valid with SDL, too, it means subdriver then. + +.I NOTE: +.br +To get a full list of available drivers, see \-ao help. +.br +If the list has a trailing ',' it will fallback to drivers not listed. + +.I EXAMPLE +.PD 0 +.RSs +.IPs "\-ao oss:/\:dev/\:dsp2,oss:/\:dev/\:dsp1," +try to use OSS with the specified sound devices and fallback to others if it +fails +.IPs "\-ao sdl:esd" +specify the SDL subdriver +.RE +.PD 1 +. +.TP +.B \-aofile <filename> +Filename for \-ao pcm. +.TP +.B \-aop <list=plugin1,plugin2...:option1=value1:opt2=val2...> +Specify audio plugin(s) and their options (see documentation too). +.br +Available options are: +. +.RSs +.IPs list=[plugins] +comma separated list of plugins (resample, surround, format, volume, +extrastereo, volnorm) +.IPs delay=<sec> +example plugin, do not use. +.IPs format=<format> +output format (format plugin only) +.IPs fout=<Hz> +output frequency (resample plugin only) +.IPs volume=<0\-255> +volume (volume plugin only) +.IPs mul=<value> +stereo coefficient (default: 2.5) (extrastereo plugin only) +.IPs softclip +compressor / 'soft\-clipping' capabilities (volume plugin only) +.RE +. +.TP +.B \-delay <sec> +Audio delay in seconds (may be +/\:\- float value). +.TP +.B \-format <0\-8192> +Select the format used for output from the filter layer (according to the +defines in libao2/afmt.h): + +.PD 0 +.RSs +.IPs 1 +Mu-Law +.IPs 2 +A-Law +.IPs 4 +Ima-ADPCM +.IPs 8 +Signed 8-bit +.IPs 16 +Unsigned 8-bit +.IPs 32 +Unsigned 16-bit (Little-Endian) +.IPs 64 +Unsigned 16-bit (Big-Endian) +.IPs 128 +Signed 16-bit (Little-Endian) +.IPs 256 +Signed 16-bit (Big-Endian) +.IPs 512 +MPEG (2) Audio +.IPs 1024 +AC3 +.IPs 4096 +Signed 32-bit (Little-Endian) +.IPs 8192 +Signed 32-bit (Big-Endian) +.RE +.PD 1 +. +.TP +.B \-mixer <device> +This option will tell MPlayer to use a different device for mixing than +/dev/\:mixer. +.TP +.B \-nowaveheader (-ao pcm only) +Don't include wave header. +Used for RAW PCM. + + +.SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)" +.TP +.B \-aa* (\-vo aa only) +You can get a list and an explanation of available options executing +.I mplayer \-aahelp +.TP +.B \-bpp <depth> +Use different color depth than autodetect. +Not all \-vo drivers support it (fbdev, dga2, svga, vesa). +.TP +.B \-brightness <\-100\-100> +Adjust brightness of video output (default 0). +It changes intensity of RGB components of video signal from black to white +screen. +.TP +.B \-contrast <\-100\-100> +Adjust contrast of video output (default 0). +Works in similar manner as brightness. +.TP +.B \-dfbopts <value> (\-vo directfb2 only) +Specify a parameter list for the directfb driver. +.TP +.B \-display <name> +Specify the hostname and display number of the X server you want to display +on. + +.I EXAMPLE: +.PD 0 +.RSs +\-display xtest.localdomain:0 +.RE +.PD 1 +. +.TP +.B \-double +Enables doublebuffering. +Fixes flicker by storing two frames in memory, and displaying one while +decoding another. +Can affect OSD. +Needs twice the memory of a single buffer, so it won't work on cards with +very little video memory. +.TP +.B \-dr \ \ \ +Turns on direct rendering (not supported by all codecs and video outputs) +(default is off). +Warning: may cause OSD/\:SUB corruption! +.TP +.B \-dxr2 <option1:option2:...> +This option is used to control the dxr2 driver. +Note: The lavc filter is now auto inserted if you try to play a non MPEG1/2 +format so all formats supported by MPlayer should play out of the box (if +you have the CPU power needed to encode on the fly). +The overlay chipset used on the dxr2 is of pretty bad quality but the default +settings should work for everybody. +The OSD may be usable with the overlay (not on TV) by drawing it in the +colorkey. +With the default colorkey settings you may get variable results, usually you +will see the colorkey around the characters or some other funny effect. +But if you properly adjust the colorkey settings you should be able to get +acceptable results. +. +.RSs +.IPs ar-mode=<value> +aspect ratio mode (0 = normal, 1 = pan scan, 2 = letterbox (default)) +.IPs iec958\-encoded/\:decoded +iec958 output mode +.IPs mute +mute sound output +.IPs ucode=<value> +path to the microcode +.RE +.RS + +.I TV Out +.RE +.RSs +.IPs 75ire +enable 7.5 IRE +.IPs bw\ \ \ +b/\:w TV output +.IPs color +color TV output +.IPs interlaced +interlaced TV output +.IPs macrovision=<value> +macrovision mode (0 = off (default), 1 = agc, 2 = agc 2 colorstripe, +3 = agc 4 colorstripe) +.IPs norm=<value> +TV norm (ntsc (default), pal,pal60,palm,paln,palnc) +.IPs square/\:ccir601\-pixel +TV pixel mode +.RE +.RS + +.I Overlay +.RE +.RSs +.IPs cr-[left|right|top|bot]=<\-20\-20> +adjust the overlay cropping +.IPs ck-[rgb]min=<0\-255> +minimum value for the color key +.IPs ck-[rgb]max=<0\-255> +maximum value for the color key +.IPs ck-[rgb]=<0\-255> +color key values +.IPs ignore\-cache +do not use the VGA cache +.IPs ol-osd +enable the osd hack on the overlay +.IPs ol[hwxy]\-cor=<value> +adjust the overlay size and position in case it doesn't match the window +perfectly +.IPs overlay +enable the overlay +.IPs overlay-ratio=<1\-2500> +tune the overlay (default 1000) +.IPs update\-cache +recreate the VGA cache +.RE +. +.TP +.B \-fb <device> (fbdev or DirectFB only) +Specifies the framebuffer device to use. +By default it uses /dev/\:fb0. +.TP +.B \-fbmode <modename> (fbdev only) +Change video mode to the one that is labelled as <modename> in +/etc/\:fb.modes. + +.I NOTE: +.br +VESA framebuffer doesn't support mode changing. +.TP +.B \-fbmodeconfig <filename> (fbdev only) +Use this configuration file instead of the default /etc/\:fb.modes. +Only valid for the fbdev driver. +.TP +.B \-forcexv (SDL only) +Force using XVideo. +.TP +.B \-fs \ \ \ +Fullscreen playing (centers movie, and makes black +bands around it). +Toggle it with the 'f' key (not all video outputs support it). +See also \-zoom. +.TP +.B \-fsmode-dontuse <0-31> (OBSOLETE) (use \-fs option) +Try this option if you still experience fullscreen problems. +.TP +.B \-geometry x[%][:y[%]] or [WxH][+x+y] +Adjust where the output is on the screen initially. +The x and y specifications are in pixels measured from the top-right of the +screen to the top-right of the image being displayed, however if a percentage +sign is given after the argument it turns the value into a percentage of the +screen size in that direction. +It also supports the standard option format to the standard X \-geometry +option. +The values given must be integers. + +Note: This option is only supported by a few vo's, including tdfxfb, fbdev and +xv. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs 50:40 +Places the window at x=50, y=40 +.IPs 50%:50% +Places the window in the middle of the screen +.IPs 100% +Places the window at the top left corner of the screen +.IPs 100%:100% +Places the window at the bottom left corner of the screen +.RE +.PD 1 +. +.TP +.B \-hue <\-100\-100> +Adjust hue of video signal (default: 0). +You can get colored negative of image with this option. +.TP +.B \-icelayer <0\-15> (icewm only) +Sets the layer of the fullscreen window of mplayer for icewm. + +.PD 0 +.RSs +.IPs 0 +Desktop +.IPs 2 +Below +.IPs 4 +Normal +.IPs 6 +OnTop +.IPs 8 +Dock +.IPs 10 +AboveDock +.IPs 12 +Menu (default) +.RE +.PD 1 +. +.TP +.B \-jpeg <option1:option2:...> (\-vo jpeg only) +Specify options for the JPEG output. +.br +Available options are: [no]progressive, [no]baseline, optimize, smooth, quality +and outdir. +.TP +.B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (fbdev and vesa only) +Look into etc/\:example.conf for further information and in DOCS/\:video.html. +.TP +.B \-monitor_hfreq <horizontal frequency range> (fbdev and vesa only) +.TP +.B \-monitor_vfreq <vertical frequency range> (fbdev and vesa only) +.TP +.B \-monitoraspect <ratio> +Set aspect ratio of your monitor or TV screen. +See also \-aspect for movie aspect. + +.I EXAMPLE: +.PD 0 +.RSs +\-monitoraspect 4:3 or 1.3333 +.br +\-monitoraspect 16:9 or 1.7777 +.RE +.PD 1 +. +.TP +.B \-nograbpointer +Do not grab mouse pointer after VidMode change (\-vm), useful for multihead +setup. + +.TP +.B \-nokeepaspect +Do not keep window aspect ratio when resizing X11 windows (Works currently only +with \-vo x11, xv, xmga and xvidix and your window manager needs to understand +window aspect hints.). + +.TP +.B \-noslices +Disable drawing video by 16-pixel height slices/\:bands, instead draws the +whole frame in a single run. +May be faster or slower, depending on card/\:cache. +It has effect only with libmpeg2 and libavcodec codecs. +.TP +.B \-panscan <0.0\-1.0> +Enables Pan & Scan functionality, i.e.\& in order to display a 16:9 movie +on a 4:3 display, the sides of the movie are cropped to get a 4:3 image +which fits the screen. +This function works only with the xv, xmga, mga and xvidix video out drivers. +.br +The range controls how much of the image is cropped. +.TP +.B \-rootwin +Play movie in the root window (desktop background) instead of opening +a new one. +Works only with x11, xv, xmga and xvidix drivers. +.TP +.B \-saturation <\-100\-100> +Adjust saturation of video output (default: 0). +You can get grayscale output with this option. +.TP +.B \-screenw <pixels> \-screenh <pixels> +If you use an output driver which can't know the resolution of the screen +(fbdev/\:x11 and/\:or TVout) this is where you can specify the horizontal and +vertical resolution. +.TP +.B \-stop_xscreensaver +Turns off xscreensaver at startup and turns it on again on exit. +.TP +.B \-vm \ \ \ +Try to change to a better video mode. +dga, x11/\:xv (XF86VidMode) and sdl output drivers support it. +.TP +.B \-vo <driver1[:device],driver2,...[,]> +Specify a priority list of video output drivers (optionally with device) to be +used. +\'device' is valid with SDL and GGI, too, it means subdriver then. + +.I NOTE: +.br +See \-vo help for a full list of available drivers. +.br +If the list has a trailing ',' it will fallback to drivers not listed. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-vo xmga,xv," +Try Matrox kernel driver, then Xv driver, then others +.br +.IPs "\-vo sdl:aalib" +specify the SDL subdriver +.RE +.PD 1 +. +.TP +.B \-vsync \ \ +Enables VBI for vesa. +.TP +.B \-wid <window\ id> +This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a +browser (with the plugger extension for instance). +.TP +.B \-xineramascreen <0\-...> +In Xinerama configurations (i.e.\& a single desktop that spans across multiple +displays) this option tells MPlayer which screen to display movie on. +.TP +.B \-z <0\-9> +Specifies compression level for PNG output (-vo png) + +.PD 0 +.RSs +.IPs 0 +no compression +.IPs 9 +max compression +.RE +.PD 1 +. +.TP +.B \-zrbw (\-vo zr only) +Display in black and white (for optimal performance, this option can be +combined with the 'decode only in black and white' option for codecs +belonging to the FFmpeg family). +.TP +.B \-zrcrop <[width]x[height]+[x offset]+[y offset]> (\-vo zr only) +Select a part of the input image for display, multiple occurences of this +option switch on cinerama mode. +In cinerama mode the movie is distributed over more than one TV (or beamer) to +create a larger screen. +Options appearing after the n\-th \-zrcrop apply to the n\-th MJPEG card, each +card should at least have a \-zrdev in addition to the \-zrcrop. +For examples, see the output of \-zrhelp and the Zr section of the +documentation. +.TP +.B \-zrdev <device> (\-vo zr only) +Specify the device special file that belongs to your MJPEG card, by default +this driver takes the first v4l device it can find. +.TP +.B \-zrfd (\-vo zr only) +Force decimation: Decimation, as specified by \-zrhdec and \-zrvdec, only +happens if the hardware scaler can stretch the image to its original size. +Use this option to force decimation. +.TP +.B \-zrhelp (\-vo zr only) +Display a list of all \-zr* options, their default values and an example of +cinerama mode. +.TP +.B \-zrnorm <norm> (\-vo zr only) +Specify norm PAL/\:NTSC, the default is 'no change'. +.TP +.B \-zrquality <1\-20> (\-vo zr only) +A number from 1 to 20 representing the jpeg encoding quality. +1 gives the best quality and 20 gives very bad quality. +.TP +.B \-zrvdec <1,2,4> \-zrhdec <1,2,4> (\-vo zr only) +Vertical/\:horizontal decimation: Ask the driver to send only every 2nd or 4th +line/\:pixel of the input image to the MJPEG card and use the scaler of the +MJPEG card to strech the image to its original size. +.TP +.B \-zrxdoff <x display offset>, \-zrydoff <y display offset> (\-vo zr only) +If the movie is smaller than the TV screen, these options control the position +of the movie relative to the upper left corner of the screen. +The movie is centered by default. + + +.SH "DECODING/FILTERING OPTIONS" +.TP +.B \-ac <[-]codec1,[-]codec2,...[,]> +Specify a priority list of audio codecs to be used, according to their codec +name in codecs.conf. +Use a '-' before the codec name to omit it. + +.I NOTE: +.br +See \-ac help for a full list of available codecs. +.br +If the list has a trailing ',' it will fallback to codecs not listed. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-ac mp3acm" +force l3codeca.acm MP3 codec +.IPs "\-ac mad," +try libmad first, then fallback to others +.IPs "\-ac hwac3,a52," +try hardware AC3 passthrough, then software AC3 codec, then others +.IPs "\-ac -ffmp3," +try other codecs except FFmpeg's MP3 decoder +.RE +.PD 1 +. +.TP +.B \-afm <driver1,driver2,...> +Specify a priority list of audio drivers to be used, according to their driver +name in codecs.conf. +It falls back to default if none is ok. + +.I NOTE: +.br +See \-afm help for a full list of available drivers. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-afm ffmpeg" +try FFmpeg's libavcodec (mp1/\:2/\:3) codecs first +.IPs "\-afm acm,dshow" +try Win32 codecs first +.RE +.PD 1 +. +.TP +.B \-aspect <ratio> +Override aspect ratio of movies. +It's autodetected on MPEG files, but can't be autodetected on most AVI files. + +.I EXAMPLE: +.PD 0 +.RSs +\-aspect 4:3 or \-aspect 1.3333 +.br +\-aspect 16:9 or \-aspect 1.7777 +.RE +.PD 1 +. +.TP +.B \-flip \ +Flip image upside\-down. +.TP +.B \-lavdopts <option1:option2:...> (DEBUG CODE) +If decoding with a codec from libavcodec, you can specify its parameters here. + +.I EXAMPLE: +.PD 0 +.RSs +\-lavdopts bug=1 +.RE +.PD 1 + +.RS +.I NOTE: +.br +Just add the values of the things you want to enable. +.br +Available options are: +.RE +. +.RSs +.IPs ec\ \ \ +error concealment: +.RSss +1: use strong deblock filter for damaged MBs +.br +2: iterative MV search (slow) +.br +3: all (default) +.REss +.IPs er=<value> +error resilience: +.RSss +.br +0: disabled +.br +1: careful (should work with broken encoders) +.br +2: normal (default) (works with compliant encoders) +.br +3: agressive (more checks but might cause problems even for valid bitstreams) +.br +4: very agressive +.REss +.IPs bug=<value> +manually work around encoder bugs: +.RSss +0: nothing +.br +1: autodetect bugs (default) +.br +2 (msmpeg4v3): some old lavc generated msmpeg4v3 files (no autodetect) +.br +4 (mpeg4): xvid interlacing bug (autodetected if fourcc==XVIX) +.br +8 (mpeg4): UMP4 (autodetected if fourcc==UMP4) +.br +16 (mpeg4): padding bug +.br +32 (mpeg4): illegal vlc bug (autodetected per fourcc) +.br +64 (mpeg4): XVID and DIVX qpel bug (autodetected) +.REss +.IPs idct=<0\-99> +(see lavcopts) +.IPs gray +grayscale only decoding (a bit faster than with color) +.RE +. +.TP +.B \-noaspect +Disable automatic movie aspect ratio compensation. +.TP +.B \-nosound +Do not play/\:encode sound. +.TP +.B \-pp <quality> (see \-vop pp option too!) +Set postprocess level of the DLL. +This option is NO LONGER USABLE with MPlayer's postprocess filter, but only +with Win32 DirectShow DLLs which have internal postprocessing routine. + +The valid range of \-pp value vary on codecs, mostly +0\-6, where 0=disable 6=slowest/\:best. +.TP +.B \-pphelp (see \-vop pp option too) +Show a summary about the available postprocess filters and their usage. +.TP +.B \-ssf <mode> +Specifies SwScaler parameters. + +.I EXAMPLE +.PD 0 +.RSs +\-vop scale \-ssf lgb=3.0 +.RE +.PD 1 + +.PD 0 +.RSs +.IPs lgb=<0\-100> +Gaussian blur filter (luma) +.IPs cgb=<0\-100> +Gaussian blur filter (chroma) +.IPs ls=<0\-100> +sharpen filter (luma) +.IPs cs=<0\-100> +sharpen filter (chroma) +.IPs chs=<h> +chroma horizontal shifting +.IPs cvs=<v> +chroma vertical shifting +.RE +.PD 1 +. +.TP +.B \-stereo <mode> +Select type of MP2/\:MP3 stereo output. + +.PD 0 +.RSs +.IPs 0 +Stereo +.IPs 1 +Left channel +.IPs 2 +Right channel +.RE +.PD 1 +. +.TP +.B \-sws <software\ scaler\ type> (see \-vop scale option too) +This option sets the quality (and speed, respectively) of the software scaler, +with the \-zoom option. +For example with x11 or other outputs which lack hardware acceleration. +Possible settings are: + +.I NOTE: +.br +For \-sws\ 2 and 7, the sharpness can be set with the scaling parameter (p) +of \-vop scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter +length (1 \- 10). + +.PD 0 +.RSs +.IPs 0 +fast bilinear (default) +.IPs 1 +bilinear +.IPs 2 +bicubic (good quality) +.IPs 3 +experimental +.IPs 4 +nearest neighbour (bad quality) +.IPs 5 +area +.IPs 6 +luma bicubic / chroma bilinear +.IPs 7 +gauss +.IPs 8 +sincR +.IPs 9 +lanczos +.IPs 10 +bicubic spline +.RE +.PD 1 +. +.TP +.B \-vc <[-]codec1,[-]codec2,...[,]> +Specify a priority list of video codecs to be used, according to their codec +name in codecs.conf. +Use a '-' before the codec name to omit it. + +.I NOTE: +.br +See \-vc help for a full list of available codecs. +.br +If the list has a trailing ',' it will fallback to codecs not listed. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-vc divx" +force Win32/\:VFW DivX codec, no fallback +.IPs "\-vc divx4," +try divx4linux codec first, then fallback to others +.IPs "\-vc -divxds,-divx," +try other codecs except Win32 DivX codecs +.IPs "\-vc ffmpeg12,mpeg12," +try libavcodec's MPEG1/\:2 codec, then libmpeg2, then others +.RE +.PD 1 +. +.TP +.B \-vfm <driver1,driver2,...> +Specify a priority list of video drivers to be used, according to their driver +name in codecs.conf. +It falls back to default if none is ok. + +.I NOTE: +.br +If libdivxdecore support was compiled in, then odivx and divx4 now contains +just the same DivX4 codec, but different APIs to reach it. +For difference between them and when to use which, check the DivX4 section in +the documentation. +.br +See \-vfm help for a full list of available drivers. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-vfm ffmpeg,dshow,vfw" +try the libavcodec, then Directshow, then VFW codecs and fallback to the +others, if still none is ok +.IPs "\-vfm xanim" +try XAnim codecs first +.RE +.PD 1 +. +.TP +.B \-vop <...,filter3[=options],filter2,filter1> +Activate a comma separated list of video filters and their options in reverse +order. + +.I NOTE: +.br +The parameters are optional and if omitted, some of them are set to default +values. +Use -1 to keep the default value. +Parameters w:h means width x height in pixels, x:y means x;y position counted +from the upper left corner of the bigger image. +.br +To get a full list of available plugins, see \-vop help. +.br +Available filters are: +. +.RSs +.IPs crop[=w:h:x:y] +Crops the given part of the image and discards the rest. +Useful to remove black bands from widescreen movies. +.IPs cropdetect[=0\-255] +Calculates necessary cropping parameters and prints the recommended parameters +to stdout. +The threshold can be optionally specified from nothing (0) to everything +(255). +(default: 24) +.IPs rectangle[=w:h:x:y] +Draws a rectangle of the requested width and height at the specified +coordinates over the image (used to test crop). +(default: maximum w/\:h, upper left x/\:y position) +.IPs expand[=w:h:x:y:o] +Expands (not scales) movie resolution to the given value and places the +unscaled original at coordinates x y. Negative values for w and h are +treated as offsets to the original size. For example, expand=0:-50:0:0 +adds a 50 pixel border to the bottom of the picture. +Can be used for placing subtitles/\:OSD in the resulting black bands (default: +original w/\:h, centered x/\:y). +The last parameter (de)activates OSD rendering (default: 0=disabled). +.IPs flip +Flips the image upside down. +See also option \-flip. +.IPs mirror +Flips the image on Y axis. +.IPs rotate[=<0-7>] +Rotates and flips (optional) the image +/\:\- 90 degrees. +For parameters between 4-7 rotation is only done if the movie's geometry is +portrait and not landscape. +.IPs scale[=w:h[:c[:p]]] +Scales the image with the software scaler (slow) and performs a YUV<\->RGB +colorspace conversion (see \-sws option too). +The value 0 is used for scaled (aspect) destination w/\:h. +(default: original w/\:h, destination w/\:h with \-zoom) Optionaly chroma +skipping (c from 0\-3) and scaling parameters can be specified. +(see the \-sws option for details) +.IPs yuy2 +Forces software YV12/\:I420 or 422P to YUY2 conversion. +.IPs rgb2bgr[=swap] +RGB 24/\:32 <\-> BGR 24/\:32 colorspace conversion with optional R <\-> B +swapping. +.IPs palette +RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp colorspace conversion using palette. +.IPs format[=fourcc] +Restricts the colorspace for next filter. +It does not do any conversion. +Use together with the scale filter for a real conversion. +.IPs pp[=filter1[:option1[:option2...]]/[-]filter2...] (see \-pphelp too) +This option enables usage of MPlayer's internal postprocessing filter, +and also gives an interface where you can pass options to the named filter. +To get a list of available filters, use \-pphelp. +.br +Note that each sub-filter must be separated with a / sign. +.br +Each filter defaults to 'c' (chrominance). +.br +The keywords accept a '\-' prefix to disable the option. +.br +A ':' followed by a letter may be appended to the option to indicate its +scope: +.RSss +a: Automatically switches the filter off if the CPU is too slow. +.br +c: Do chrominance filtering, too. +.br +y: Do not do chrominance filtering (only luminance filtering). +.REss + +.RS +.I EXAMPLES: +.RE +.RSss +.br +\-vop pp=hb/vb/dr/al/lb +.br +\-vop pp=hb/vb/dr/al +.br +Default filters without brightness/\:contrast correction: +.br +\-vop pp=de/\-al +.br +Enable default filters & temporal denoiser: +.br +\-vop pp=de/tn:1:2:3 +.br +Deblock horizontal only luminance and switch vertical deblocking on or +off automatically depending on available CPU time: +.br +\-vop pp=hb:y/vb:a \-autoq 6 +.REss +.IPs lavc[=quality:fps] +Realtime MPEG1 encoder for use with DVB/\:DXR3 (libavcodec) +.IPs fame +Realtime MPEG1 encoder for use with DVB/\:DXR3 (libfame) +.IPs dvbscale[=aspect] +Set up optimal scaling for DVB cards. +(aspect = DVB_HEIGHT*ASPECTRATIO, default: 768) +.IPs "noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]" +Adds noise +.RSss +<0\-100>: luma noise +.br +<0\-100>: chroma noise +.br +u: uniform noise +.br +t: temporal noise +.br +a: averaged temporal noise +.br +h: high quality +.br +p: mix random noise with a (semi)regular pattern +.REss +.IPs "denoise3d[=luma:chroma:time]" +This filter aims to reduce image noise producing smooth images and making still +images really still (This should enhance compressibility.). +It can be given from 0 to 3 parameters. If you omit a parameter, a reasonable +value will be inferred. +.RSss +luma: spatial luma strength (default = 4) +.br +chroma: spatial chroma strength (default = 3) +.br +time: temporal strength (default = 6) +.REss +.IPs eq[=bright:cont] +Activates the software equalizer with interactive controls like the hardware +eq controls. +The values can be from -100 to 100. +.IPs eq2[=gamma:cont:bright] +Alternative software equalizer that uses lookup tables (very slow), +allowing gamma correction in addition to simple brightness and +contrast adjustment. +The parameters are given as floating point values. +Defaults are gamma=1.0, contrast=1.0, and brightness=0.0. +The values are 0.1\-10 for gamma, -2\-2 for contrast (negative values result +in negative image) and -1\-1 for brightness. +.IPs halfpack[=f] +Convert planar YUV 4:2:0 to half-height packed 4:2:2, downsampling luma but +keeping all chroma samples. +Useful for output to low-resolution display devices when hardware downscaling +is poor quality or is not available. +Can also be used as a primitive luma-only deinterlacer with very low cpu +usage. +By default, halfpack averages pairs of lines when downsampling. +The optional parameter f can be 0 to only use even lines, or 1 to only use +odd lines. +Any other value for f gives the default (averaging) behavior. +.IPs dint[=sense:level] +Detects and drops first of interlaced frames in video stream. +Values can be from 0.0 to 1.0 - first (default 0.1) is relative difference +between neighbor pixels, second (default 0.15) is what part of image have to +be detected as interlaced to drop the frame. +.IPs lavcdeint +Use libavcodec's deinterlace filter. +.IPs "unsharp=l|cWxH:amount[:l|cWxH:amount]" +Unsharp mask / gaussian blur. +.RSss +l: apply effect on luma component +.br +c: apply effect on chroma components +.br +WxH: width and height of the matrix, odd sized in both directions +(min = 3x3, max = 13x11 or 11x13, usually something between 3x3 and 7x7) +.br +amount: relative amount of sharpness / blur to add to the image +(amount < 0 = blur, amount > 0 = sharpen, usually something between -1.5 and +1.5) +.REss +.IPs swapuv +Swap U & V plane. +.IPs "il=[d|i][s][:[d|i][s]]" +(de)interleaves lines. +The goal of this filter is to add ability of processing interlaced images +pre-field without deinterlacing it. +You can filter your interlaced dvd and playback on TV without breaking the +interlacing. +While deinterlacing (with the post processing filter) removes the interlacing +permamently (by smoothing averaging etc) deinterleaving splits the frame into +2 fields (so called half pictures), so you can process (filter) them +independently and then re-interleave them. +.RSss +d: deinterleave +.br +i: interleave +.br +s: swap fields (exchange even & odd lines) +.REss +.IPs "field[=n]" +Extracts a single field from interlaced image using stride arithmetic +to avoid wasting cpu time. The optional argument n specifies whether +to extract the even or the odd field (depending on whether n is even +or odd). +.IPs "boxblur=radius:power[:radius:power]" +box blur +.RSss +radius: size of the filter +.br +power: how often the filter should be applied +.REss +.IPs "sab=rad:pfilter:cDiff[:rad:pfilter:cDiff]" +shape adaptive blur +.RSss +rad: blur filter strength (~0.1\-4.0) (slower if larger) +.br +pfilter: prefilter strength (~0.1\-2.0) +.br +cDiff: how different the pixels are allowed to be to be considered +(~0.1-100.0) +.REss +.IPs "smartblur=rad:strength:thresh[:rad:strength:thresh]" +smart blur +.RSss +rad: blur filter strength (~0.1\-5.0) (slower if larger) +.br +strength: blur (0.0\-1.0) or sharpen (-1.0\-0.0) +.br +thresh: filter all (0), filter flat areas (0\-30) or filter edges (-30\-0) +.REss +.IPs "perspective=x0:y0:x1:y1:x2:y2:x3:y3:t" +perspective correcture +.RSss +x0,y0,...: coordinates of the top left, top right, bottom left, bottom right +corners +.br +t: linear (0) or cubic resampling (1) +.REss +.IPs 2xsai +Use the 2x scale and interpolate algorithm for scaling and smoothing images. +.IPs 1bpp +1bpp bitmap to YUV/BGR 8/15/16/32 conversion +.IPs "bmovl=hidden:opaque:<fifo>" +Read bitmaps from a FIFO and display them in window. +. +.RSss +hidden: sets the default value of the 'hidden' flag (boolean) +.br +opaque: flag switching between alphablended (transparent) and opaque (fast) +mode +.br +fifo: path/filename for the FIFO (named pipe connecting mplayer -vop bmovl +to the controlling application) +.REss + +.RS +FIFO commands are: +.RE +.RSss +RGBA32 width height xpos ypos alpha clear +.br +followed by width*height*4 bytes of raw RGBA32 data. + +ABGR32 width height xpos ypos alpha clear +.br +followed by width*height*4 bytes of raw ABGR32 data. + +RGB24 width height xpos ypos alpha clear +.br +followed by width*height*3 bytes of raw RGB32 data. + +BGR24 width height xpos ypos alpha clear +.br +followed by width*height*3 bytes of raw BGR32 data. + +ALPHA width height xpos ypos alpha +.br +change alpha for area + +CLEAR width height xpos ypos +.br +clear area + +OPAQUE +.br +disable all alpha transparency. +Send "ALPHA 0 0 0 0 0" to enable it again. + +HIDE +.br +hide bitmap + +SHOW +.br +show bitmap +.REss + +.RS +Arguments are: +.RE +.RSss +width, height: size of image/area +.br +xpos, ypos: start blitting at X/Y position +.br +alpha: set alpha difference. +0 means same as original, 255 makes everything +opaque, -255 makes everything transparent. +If you set this to -255 you can then send a sequence of ALPHA-commands to set +the area to -225, -200, -175 etc for a nice fade-in-effect! ;) +.br +clear: clear the framebuffer before blitting. +1 means clear, if 0, the image will just be blitted on top of the old one, so +you don't need to send 1,8MB of RGBA32 data everytime a small part of the +screen is updated. +.REss +.RE +. +.TP +.B \-x <x> (MPLAYER only) +Scale image to x width (if sw/\:hw scaling available). +Disables aspect calculations. +.TP +.B \-xvidopts <option1:option2:...> +Specify additional parameters when decoding with XviD. + +.PD 0 +.RSs +.IPs dr2\ \ +Activate direct rendering method 2. +.IPs nodr2 +Deactivate direct rendering method 2. +.RE +.PD 1 +. +.TP +.B \-xy <x> +.PD 0 +.RSs +.IPs "x<=8" +Scale image by factor <x>. +.IPs "x>8\ " +Set width to <x> and calculate height to keep correct aspect ratio. +.RE +.PD 1 +. +.TP +.B \-y <y> (MPLAYER only) +Scale image to y height (if sw/\:hw scaling available). +Disables aspect calculations. +.TP +.B \-zoom \ +Allow software scaling, where available. +Could be used to force scaling with \-vop scale. + +.I NOTE: +.br +\-vop scale will IGNORE options \-x / \-y / \-xy / \-fs / \-aspect without +\-zoom. + + +.SH "ENCODING OPTIONS (MENCODER ONLY)" +.TP +.B \-audio-density <1\-50> +Number of audio chunks per second (default is 2 for 0.5s long audio chunks). + +.I NOTE: +.br +CBR only, VBR ignores this as it puts each packet in a new chunk. +.TP +.B \-audio-delay <0.0\-...> +Sets the audio delay field in the header. +Default is 0.0, negative values do not work. +This does not delay the audio while encoding, but the player will see the +default audio delay, sparing you the use of the \-delay option. +.TP +.B \-audio-preload <0.0\-2.0> +Sets up audio buffering time interval (default: 0.5s). +.TP +.B \-divx4opts <option1:option2:...> +If encoding to DivX4, you can specify its parameters here. +.br +Available options are: +. +.RSs +.IPs help +get help +.IPs br=<value> +specify bitrate in +.RSss +kbit <4\-16000> or +.br +bit <16001\-24000000> +.REss +.IPs key=<value> +maximum keyframe interval (in frames) +.IPs deinterlace +enable deinterlacing (avoid it, DivX4 is buggy) +.IPs q=<1\-5> +quality (1\-fastest, 5\-best) +.IPs min_quant=<1\-31> +minimum quantizer +.IPs max_quant=<1\-31> +maximum quantizer +.IPs rc_period=<value> +rate control period +.IPs rc_reaction_period=<value> +rate control reaction period +.IPs rc_reaction_ratio=<value> +rate control reaction ratio +.IPs crispness=<0\-100> +specify crispness/\:smoothness +.IPs pass=<1\-2> +With this you can encode 2pass DivX4 files. +First encode with pass=1, then with the same parameters, encode with +pass=2. +.IPs vbrpass=<0\-2> +Override the pass argument and use XviD VBR Library instead of DivX4 +VBR. +Available options are: +. +.RSss +0: one pass encoding (as in not putting pass on the command line) +.br +1: Analysis (first) pass of two pass encoding. +The resulting AVI file can be directed to /dev/null. +.br +2: Final (second) pass of two pass encoding. +.REss +.RE +. +.TP +.B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see \-ss and \-sb option too) +Stop encoding at given time or byte position. +Can be specified in many ways: + +.I NOTE: +.br +Byte position won't be accurate, as it can only stop at +a frame boundary. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-endpos 56" +encode only 56 seconds +.IPs "\-endpos 01:10:00" +encode only 1 hour 10 minutes +.IPs "\-endpos 100mb" +encode only 100 MBytes +.RE +.PD 1 +. +.TP +.B \-ffourcc <fourcc> +Can be used to override the video fourcc of the output file. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "-ffourcc div3" +will have the output file contain 'div3' as video fourcc. +.RE +.PD 1 +. +.TP +.B \-include <configuration\ file> +Specify configuration file to be parsed after the default ones. +.TP +.B \-info <option1:option2:...> (.AVI only) +Specify the info header of the resulting .AVI file. +.br +Available options are: +. +.RSs +.IPs help +show this description +.IPs name=<value> +title of the subject of the file +.IPs artist=<value> +artist or author of the original subject of the file +.IPs genre=<value> +original work category +.IPs subject=<value> +contents of the file +.IPs copyright=<value> +copyright information for the file +.IPs srcform=<value> +original form of the material that was digitized +.IPs comment=<value> +general comments about the file or the subject of the file +.RE +. +.TP +.B \-lameopts <option1:option2:...> +If encoding to MP3 with libmp3lame, you can specify its parameters here. +.br +Available options are: +. +.RSs +.IPs help +get help +.IPs vbr=<0\-4> +variable bitrate method +.RSss +0: cbr +.br +1: mt +.br +2: rh(default) +.br +3: abr +.br +4: mtrh +.REss +.IPs abr\ \ +average bitrate +.IPs cbr\ \ +constant bitrate. +.br +Forces also CBR mode encoding on subsequent ABR presets modes +.IPs br=<0\-1024> +specify bitrate in kBit (CBR and ABR only) +.IPs q=<0\-9> +quality (0-highest, 9-lowest) (only for VBR) +.IPs aq=<0\-9> +algorithmic quality (0-best/\:slowest, 9-worst/\:fastest) +.IPs ratio=<1\-100> +compression ratio +.IPs vol=<0\-10> +set audio input gain +.IPs mode=<0\-3> +(default: auto) +.RSss +0: stereo +.br +1: joint-stereo +.br +2: dualchannel +.br +3: mono +.REss +.IPs padding=<0\-2> +.RSss +0: no +.br +1: all +.br +2: adjust +.REss +.IPs fast +switch on faster encoding on subsequent VBR presets modes, slightly lower +quality and higher bitrates. +.IPs preset=<value> +provide the highest possible quality settings. +.RSss +medium: VBR encoding, good quality, 150\-180 kbps bitrate range. +.br +standard: VBR encoding, high quality, 170\-210 kbps bitrate range. +.br +extreme: VBR encoding, very high quality, 200\-240 kbps bitrate range. +.br +insane: CBR encoding, highest preset quality, 320 kbps bitrate. +.br +<8-320>: ABR encoding at average given kbps bitrate. +.br +.REss +.RE + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-lameopts fast:preset=standard" +for most people on most music and already quite high in quality. +.IPs "\-lameopts cbr:preset=192" +encode with ABR presets at a 192 kbps forced constant bitrate. +.IPs "\-lameopts preset=172" +encode with ABR presets at a 172 kbps average bitrate. +.IPs "\-lameopts preset=extreme" +for people with extremely good hearing and similar equipment. +.IPs "\-lameopts preset=help" +print additional options and informations on presets settings. +.RE +.PD 1 +. +.TP +.B \-lavcopts <option1:option2:...> +If encoding with a codec from libavcodec, you can specify its parameters +here. + +.I EXAMPLE: +.PD 0 +.RSs +\-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250 +.RE +.PD 1 + +.RS +Available options are: +.RE +. +.RSs +.IPs vcodec=<value> +use the specified codec (there is no default, you must specify it): +.RSss +mjpeg: Motion JPEG +.br +h263: H263 +.br +h263p: H263 Plus +.br +mpeg4: DivX 4/\:5 +.br +msmpeg4: DivX 3 +.br +rv10: an old RealVideo codec +.br +mpeg1video: MPEG1 video :) +.REss +.IPs vqmin=<1\-31> +minimum quantizer (pass\ 1/\:2) (default: 2) +.IPs vqscale=<1\-31> +constant quantizer (selects fixed quantizer mode) (default: 0 (disabled)) +.IPs vqmax=<1\-31> +maximum quantizer (pass\ 1/\:2) (default: 31) +.IPs mbqmin=<1\-31> +minimum macroblock quantizer (pass\ 1/\:2) (default: 2) +.IPs mbqmax=<1\-31> +maximum macroblock quantizer (pass\ 1/\:2) (default: 31) +.IPs vqdiff=<1\-31> +maximum quantizer difference between I or P frames (pass\ 1/\:2) (default: 3) +.IPs vmax_b_frames=<0\-4> +maximum number of B frames between non B frames: +.RSss +0: no B frames (default) +.br +0\-2: sane range +.REss +.IPs vme=<0\-5> +motion estimation method: +.RSss +0: none (very lq) +.br +1: full (slow) +.br +2: log (lq) +.br +3: phods (lq) +.br +4: EPZS (default) +.br +5: X1 (experimental) +.REss +.IPs vhq\ \ +high quality mode, encode each macro block in all modes an choose the smallest +(slow). +(default: HQ disabled) +.IPs v4mv +4 motion vectors per macroblock (slightly better quality). +(default: disabled) +.IPs keyint=<0\-300> +interval between keyframes in frames. +Larger numbers mean slightly smaller files, but less precise seeking, 0 means +no key frames and values >300 aren't recommended. +For a strict mpeg1/\:2/\:4 compliance this would have to be <=132. +(default: 250 or one key frame every ten seconds in a 25fps movie) +.IPs vb_strategy=<0\-1> +strategy to choose between I/\:P/\:B frames (pass\ 2): +.RSss +0: always use the maximum number of B frames (default) +.br +1: avoid B frames in high motion scenes (bitrate mispredictions) +.REss +.IPs vpass=<1\-2> +Activates internal 2pass mode (default: disabled): +.RSss +1: first pass +.br +2: second pass +.REss +.IPs aspect=<x/y> +Store movie aspect internally, just like MPEG files. +Much nicer solution than rescaling, because quality isn't decreased. +Only MPlayer will play these files correctly, other players will display +them with wrong aspect. +The aspect parameter can be given as a ratio or a floating point number. +Example: +.RSss +aspect=16/9, aspect=1.78 +.REss +.IPs vbitrate=<value> +specify bitrate (pass\ 1/\:2) in +.RSss +kBit <4\-16000> or +.br +Bit <16001\-24000000> +.br +(warning: 1kBit = 1000 Bits) +.br +(default: 800) +.REss +.IPs vratetol=<value> +approximated filesize tolerance in kbit. +(warning: 1kBit = 1000 Bits) +(default: 8000) +.IPs vrc_maxrate=<value> +maximum bitrate in kbit/\:sec (pass\ 1/\:2) +.IPs vrc_minrate=<value> +minimum bitrate in kbit/\:sec (pass\ 1/\:2) +.IPs vrc_buf_size=<value> +buffer size in kbit (pass\ 1/\:2). +Note: vratetol should not be too large during the second pass or there might +be problems if vrc_(min|max)rate is used. +.IPs vb_qfactor=<-31.0\-31.0> +quantizer factor between B and non B frames (pass\ 1/\:2) (default: 1.25) +.IPs vi_qfactor=<-31.0\-31.0> +(pass\ 1/\:2) (default: 0.8) +.IPs vb_qoffset=<-31.0\-31.0> +quantizer offset between B and non B frames (pass\ 1/\:2) (default: 1.25) +.IPs vi_qoffset=<-31.0\-31.0> +(pass\ 1/\:2) (default: 0.0) +.br +if v{b|i}_qfactor > 0 +.br +I/\:B-Frame quantizer = P-Frame quantizer * v{b|i}_qfactor + v{b|i}_qoffset +.br +else +.br +do normal ratecontrol (dont lock to next P frame quantizer) and set +q= -q * v{b|i}_qfactor + v{b|i}_qoffset +.IPs vqblur=<0.0\-1.0> +quantizer blur (pass1): +.RSss +0.0: qblur disabled +.br +0.5 (default) +.br +1.0: average the quantizer over all previous frames, larger values will + average the quantizer more over time (slower change) +.REss +.IPs vqblur=<0.0\-99.0> +quantizer gaussian blur, larger values will average the quantizer more over +time (slower change) (pass2) (default: 0.5) +.IPs vqcomp=<value> +quantizer compression, depends upon vrc_eq (pass\ 1/\:2) (default: 0.5) +.IPs vrc_eq=<equation> +main ratecontrol equation (pass\ 1/\:2): + +1: constant bitrate +.br +tex: constant quality +.br +1+(tex/\:avgTex-1)*qComp: approximately the equation of the old ratecontrol +code +.br +tex^qComp: with qcomp 0.5 or something like that (default) + +infix operators: +,-,*,/,^ + +variables: +.br +tex: texture complexity +.br +iTex,pTex: intra, non intra texture complexity +.br +avgTex: average texture complexity +.br +avgIITexaverage: intra texture complexity in I frames +.br +avgPITexaverage: intra texture complexity in P frames +.br +avgPPTexaverage: non intra texture complexity in P frames +.br +avgBPTexaverage: non intra texture complexity in B frames +.br +mv: bits used for MVs +.br +fCode: maximum length of MV in log2 scale +.br +iCount: number of intra MBs / number of MBs +.br +var: spatial complexity +.br +mcVar: temporal complexity +.br +qComp: qcomp from the command line +.br +isI, isP, isB: is 1 if picture type is I/\:P/\:B else 0 +.br +Pi,E: see your favorite math book + +functions: +.br +max(a,b),min(a,b): maximum / minimum +.br +gt(a,b): is 1 if a>b, 0 otherwise +.br +lt(a,b): is 1 if a<b, 0 otherwise +.br +eq(a,b): is 1 if a==b,0 otherwise +.br +sin, cos, tan, sinh, cosh, tanh, exp, log, abs +. +.IPs vrc_override=<options> +User specified quality for specific parts (pass\ 1/\:2). +The options are <start-frame, end-frame, quality[/\:start-frame, end-frame, +quality[/...]]>: +.RSss +quality 2\-31: quantizer +.br +quality \-500\-0: quality correcture in % +.REss +.IPs vrc_init_cplx=<0\-1000> +initial complexity (pass\ 1) +.IPs vqsquish=<0\-1> +specify how to keep the quantizer between qmin and qmax (pass\ 1/\:2): +.RSss +0: use cliping +.br +1: use a nice differentiable function (default) +.REss +.IPs vlelim=<-1000\-1000> +single coefficient elimination threshold for luminance. +Negative values will also consider the dc coefficient (should be at least -4 +or lower for encoding +at quant=1): +.RSss +0: disabled (default) +.br +-4 (JVT recommendation) +.REss +.IPs vcelim=<-1000\-1000> +single coefficient elimination threshold for chrominance. +Negative values will also consider the dc coefficient (should be at least -4 +or lower for encoding at quant=1): +.RSss +0 disabled (default) +.br +7 (JVT recommendation) +.REss +.IPs vstrict=<-1\-1> +(strict) standard compliance. +.RSss +0: disabled (default) +.br +1: only recommended if you want to feed the output into the mpeg4 +reference decoder +.br +-1: allows non-standard YV12 huffyuv encoding (20% smaller files, but +can't be played back by the official huffyuv codec) +.REss +.IPs vdpart +data partitioning. +Adds 2 byte per video packet, improves error-resistance when transfering over +unreliable channels (eg.\& streaming over the internet) +.IPs vpsize=<0\-10000> +video packet size, improves error-resistance (see \-vdpart option too): +.RSss +0: disabled (default) +.br +100-1000: good choice +.REss +.IPs gray +grayscale only encoding (faster) (default: disabled) +.IPs vfdct=<0\-10> +dct algorithm: +.RSss +0: automatically select a good one (default) +.br +1: fast integer +.br +2: accurate integer +.br +3: mmx +.br +4: mlib +.REss +.IPs idct=<0\-99> +idct algorithm. +Note: all these IDCTs do pass the IEEE1180 tests afaik: +.RSss +0: automatically select a good one (default) +.br +1: jpeg reference integer +.br +2: simple +.br +3: simplemmx +.br +4: libmpeg2mmx (inaccurate, DONT USE for encoding with keyint >100) +.br +5: ps2 +.br +6: mlib +.br +7: arm +.REss +.IPs lumi_mask=<0.0\-1.0> +luminance masking. +Warning: be careful, too large values can cause disasterous things. +Warning2: large values might look good on some monitors but may look horrible +on other monitors: +.RSss +0.0: disabled (default) +.br +0.0\-0.3: sane range +.REss +.IPs dark_mask=<0.0\-1.0> +darkness masking. +Warning: be careful, too large values can cause disasterous things. +Warning2: large values might look good on some monitors but may look horrible +on other monitors / TV / TFT: +.RSss +0.0: disabled (default) +.br +0.0\-0.3: sane range +.REss +.IPs tcplx_mask=<0.0\-1.0> +temporal complexity masking (default: 0.0 (disabled)) +.IPs scplx_mask=<0.0\-1.0> +spatial complexity masking. +Larger values help against blockiness, if no deblocking filter is used for +decoding. +Crop any black borders to get better quality: +.RSss +0.0: disabled (default) +.br +0.0\-0.5: sane range +.REss +.IPs naq\ \ +Normalize adaptive quantization (experimental). +When using adaptive quantization (*_mask), the average per-MB quantizer may no +longer match the requested frame-level quantizer. +Naq will attempt to adjust the per-MB quantizers to maintain the proper +average. +.IPs ildct +use interlaced dct +.IPs format=<value> +.RSss +YV12: default +.br +422P: for huffyuv +.REss +.IPs pred +(for huffyuv) +.RSss +0: left prediction +.br +1: plane/gradient prediction +.br +2: median prediction +.REss +.IPs qpel +use quarter pel motion compensation +.IPs precmp=<0\-2000> +comparison function for motion estimation pre pass +.IPs cmp=<0\-2000> +comparison function for full pel motion estimation +.IPs subcmp=<0\-2000> +comparison function for sub pel motion estimation +.RSss +0 (SAD): sum of absolute differences, fast (default) +.br +1 (SSE): sum of squared errors +.br +2 (SATD): sum of absolute hadamard transformed differences +.br +3 (DCT): sum of absolute dct transformed differences +.br +4 (PSNR): sum of the squared quantization errors +.br +5 (BIT): number of bits needed for the block +.br +6 (RD): rate distoration optimal, slow +.br +7 (ZERO): 0 +.br ++256: use chroma too, doesnt work with b frames currently +.REss +.IPs predia=<\-99\-6> +Diamond type and size for motion estimation pre pass +.IPs dia=<\-99\-6> +Diamond type & size for motion estimation. +Note: The sizes of the normal diamonds and shape adaptive ones dont have the same meaning +.RSss +\-3: shape adaptive (fast) diamond with size 3 +.br +\-2: shape adaptive (fast) diamond with size 2 +.br +\-1: experimental +.br + 1: normal size=1 diamond (default) =EPZS type diamond +.nf +.ne + 0 + 000 + 0 +.fi +.br + 2: normal size=2 diamond +.nf +.ne + 0 + 000 + 00000 + 000 + 0 +.fi +.REss +.IPs trell +Trellis quantization. +This will find the optimal encoding for each 8x8 block. +Trellis quantization is quite simple a optimal quantization in the PSNR vs +bitrate sense (assuming that there would be no rounding errors introduced +by the IDCT, which is obviously not the case) it simply finds a block for +the minimum of error and lambda*bits. +.RSss +lambda: qp dependant constant +.br +bits: amount of bits needed to encode the block +.br +error: sum of squared errors of the quantization +.REss +.IPs last_pred=<0\-99> +Amount of motion predictors from the previous frame +.RSss +0: (default) +.br +a: will use 2a+1 x 2a+1 MB square of MV predictors from the previous frame +.REss +.IPs preme=<0\-2> +motion estimation pre-pass +.RSss +0: disabled +.br +1: only after I frames (default) +.br +2: always +.REss +.IPs subq=<1\-8> +subpel refinement quality (for qpel) (default: 8). +Note: this has a significant effect on the speed +.IPs psnr +print the psnr (peak signal to noise ratio) for the whole video after encoding +and store the per frame psnr in a file with name like 'psnr_012345.log'. +.IPs mpeg_quant +use MPEG quantizers instead of H.263. +(default: disabled) (i.e.\& use H.263 quantizers) +.RE +. +.TP +.B \-noskip +Do not skip frames. +.TP +.B \-o <filename> +Outputs to the given filename, instead of the default 'test.avi'. +.TP +.B \-oac <codec name> +Encode with the given audio codec. +Use \-ovc help to get a list of available codecs. +(no default set) + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "-oac copy" +no encoding, just streamcopy +.IPs "-oac pcm" +encode to uncompressed PCM +.IPs "-oac mp3lame" +encode to MP3 (using Lame) +.RE +.PD 1 +. +.TP +.B \-of <format> (BETA CODE!) +Encode to the specified format. +Use \-of help to get a list of available formats. + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "-of avi" +encode to avi (default) +.IPs "-of mpeg" +encode to mpeg +.RE +.PD 1 +. +.TP +.B \-ofps <fps> +The output file will have different frame/\:sec than the source. +You MUST set it for variable fps (asf, some mov) and progressive +(29.97fps telecined mpeg) files. +.TP +.B \-ovc <codec name> +Encode with the given video codec. +Use \-ovc help to get a list of available codecs. +(no default set) + +.I EXAMPLE: +.PD 0 +.RSs +.IPs "\-ovc copy" +no encoding, just streamcopy +.IPs "\-ovc divx4" +encode to DivX4/\:DivX5 +.IPs "\-ovc rawrgb" +encode to uncompressed RGB24 +.IPs "\-ovc lavc" +encode with a libavcodec codecs +.RE +.PD 1 +. +.TP +.B \-passlogfile <filename> +When encoding in 2pass mode, MEncoder dumps first pass' informations +to the given file instead of the default divx2pass.log. +.TP +.B \-skiplimit <value> +Maximal skipable frames after non-skipped one +(-noskiplimit for unlimited number). +.TP +.B \-v, \-\-verbose +Increment verbose level (more \-v means more verbosity). + +.PD 0 +.RSs +.IPs 0 +only some informal output (default) +.IPs 1 +some basic debug infos, avi header, function values (init debug) +.IPs 2 +print avi indexes, chunk inputs, more debug infos (player debug) +.IPs 3 +prints everything related to input parsers (parser debug) +.RE +.PD 1 +. +.TP +.B \-vobsubout <basename> +Specify the basename for the output .idx and .sub files. +This turns off subtitle rendering in the encoded movie and diverts it to +Vobsub subtitle files. +.TP +.B \-vobsuboutindex <index> +Specify the index of the subtitles in the output files. +(default: 0) +.TP +.B \-vobsuboutid <langid> +Specify the language two letter code for the subtitles. +This overrides what is read from the DVD or the .ifo file. +.TP +.B \-xvidencopts <option1:option2:...> +If encoding to XviD, you can specify its parameters here. +.br +There's three modes available: constant bitrate (CBR), fixed quantizer and +2pass. +.br +Available options are: +. +.RSs +.IPs pass=<1|2> +specify the pass in 2pass mode +.IPs bitrate=<value> +sets the bitrate to be used in kbits/\:second if <16000 or in bits/\:second +if >16000 +(CBR or 2pass mode, default=687 kbits/s) +.IPs fixed_quant=<1\-31> +switch to fixed quantizer mode and specify the quantizer to be used +.IPs me_quality=<0\-6> +specify the motion detection quality (default=4) +.IPs 4mv +use 4 motion vectors per macro-block, might give better compression at the +cost of a slower encoding (default=off) +.IPs rc_reaction_delay_factor=<value> +specify how fast the rate control reacts, lower values are faster +.IPs rc_averaging_period=<value> +period to reach the required average +.IPs rc_buffer=<value> +size of the rate control buffer +.IPs quant_range=<1\-31>\-<1\-31>[/<1\-31>\-<1\-31>] +min & max quantizer for all frames (default=2\-31, CBR mode) +.br +min & max quantizer for I/P frames (default=2\-31/2\-31, 2pass mode) +.IPs min_key_interval=<value> +minimum interval between key frames (default=0, 2pass only) +.IPs max_key_interval=<value> +maximum interval between key frames (default=10*fps) +.IPs mpeg_quant +use MPEG quantizers instead of H.263 (default=off) +.IPs mod_quant +decide whether to use MPEG or H.263 quantizers on a frame-by-frame basis. +(default=off, 2pass mode only) +.IPs lumi_mask +use a lumimasking algorithm (default=off, seems buggy) +.IPs hintedme +save Motion Estimation vectors to a file during the first pass and reuse this +file during the second (default=off, 2pass mode only, seems buggy) +.IPs hintfile +specify the temporary file to be used by the 'hintedme' option +(default= \./xvid_hint_me.dat, 2pass mode only) +.IPs debug +save per-frame statistics in xvid.dbg (default=off) +.br +this is *not* the 2pass control file +.IPs keyframe_boost=<0\-1000> +(default=0, 2pass mode only) +.IPs kfthreshold=<value> +(default=10, 2pass mode only) +.IPs kfreduction=<0\-100> +(default=30, 2pass mode only) +.RE + + +.\" -------------------------------------------------------------------------- +.\" Keyboard control +.\" -------------------------------------------------------------------------- +. +.SH "KEYBOARD CONTROL" +.I NOTE: +.br +MPlayer has a fully configurable, command driven, control layer +which allow you to control MPlayer using keyboard, mouse, joystick +or remote control (using lirc). +.br +The default configuration file for the input system is +~/.mplayer/\:input.conf but it can be overriden +using the \-input conf option. +.br +These keys may/\:may not work, depending on your video output driver. +.TP +.B general control +.PD 0 +.RSs +.IPs "<\- and \->" +seek backward/\:forward 10 seconds +.IPs "up and down" +seek backward/\:forward 1 minute +.IPs "pgup and pgdown" +seek backward/\:forward 10 minutes +.IPs "< and >" +backward/\:forward in playlist +.IPs "HOME and END" +go to next/\:previous playtree entry in the parent list +.IPs "INS and DEL" +go to next/\:previous alternative source (asx playlist only) +.IPs "p / SPACE" +pause movie (any key unpauses) +.IPs "q / ESC" +stop playing and quit +.IPs "+ and \-" +adjust audio delay by +/\:\- 0.1 second +.IPs "/ and *" +decrease/\:increase volume +.IPs "9 and 0" +decrease/\:increase volume +.IPs m\ \ \ \ +mute sound +.IPs f\ \ \ \ +toggle fullscreen +.IPs "w and e" +decrease/\:increase panscan range +.IPs o\ \ \ \ +toggle between OSD states: none / seek / seek+timer +.IPs d\ \ \ \ +toggle frame dropping +.IPs v\ \ \ \ +toggle subtitle visibility +.IPs j\ \ \ \ +switch subtitle language +.IPs a\ \ \ \ +toggle subtitle aligment: top/middle/bottom +.IPs "z and x" +adjust subtitle delay by +/\:\- 0.1 second +.IPs "r and t" +adjust subtitle position +.IPs "i" +set EDL mark + +.PP +(The following keys are valid only when using \-vo xv or +\-vo [vesa|fbdev]:vidix or \-vo xvidix \-vo (x)mga or \-vc divxds (slow).) + +.IPs "1 and 2" +adjust contrast +.IPs "3 and 4" +adjust brightness +.IPs "5 and 6" +adjust hue +.IPs "7 and 8" +adjust saturation +.RE +.PD 1 +. +.TP +.B GUI keyboard control +.PD 0 +.RSs +.IPs "ENTER" +start playing +.IPs s\ \ \ \ +stop playing +.IPs l\ \ \ \ +load file +.IPs c\ \ \ \ +skin browser +.IPs p\ \ \ \ +toggle playlist +.RE +.PD 1 +. +.TP +.B TV input control +.PD 0 +.RSs +.IPs "h and k" +select previous/\:next channel +.IPs n\ \ \ \ +change norm +.IPs u\ \ \ \ +change channel list +.RE +.PD 1 +. +.TP +.B DVDNAV input control +.PD 0 +.RSs +.IPs "K,J,H,L" +browse up/\:down/\:left/\:right +.IPs M\ \ \ \ +jump to main menu +.IPs S\ \ \ \ +select +.RE +.PD 1 + + +.\" -------------------------------------------------------------------------- +.\" Slave mode protocol +.\" -------------------------------------------------------------------------- +. +.SH "SLAVE MODE PROTOCOL" +If the \-slave option is given, playback is controlled by a +line\-based protocol. +Each line must contain one command otherwise one of the following tokens: +.TP +.B Commands +.RSs +.IPs "seek <value> [type=<0/\:1/\:2>]" +Seek to some place in the movie. +Type 0 is a relative seek of +/\:- <value> seconds. +Type 1 seek to <value> % in the movie. +Type 2 is a seek to an absolute position of <value> seconds. +.IPs "audio_delay <value>" +Adjust the audio delay of value seconds +.IPs quit +Quit MPlayer +.IPs pause +Pause/\:unpause the playback +.IPs grap_frames +Somebody know ? +.IPs "pt_step <value> [force=<value>]" +Go to next/\:previous entry in the playtree. +.IPs "pt_up_step <value> [force=<value>]" +Like pt_step but it jumps to next/\:previous in the parent list. +.IPs "alt_src_step <value>" +When more than one source is available it selects the next/\:previous one +(only supported by asx playlist). +.IPs "sub_delay <value> [abs=<value>]" +Adjust the subtitles delay of +/\:- <value> seconds or set it to <value> +seconds when abs is non zero. +.IPs "osd [level=<value>]" +Toggle osd mode or set it to level when level > 0. +.IPs "volume <dir>" +Increase/\:decrease volume +.IPs "[contrast|brightness|hue|saturation] <\-100\-100> [abs=<value>]" +Set/\:Adjust video parameters. +.IPs "frame_drop [type=<value>]" +Toggle/\:Set frame dropping mode. +.IPs "sub_visibility" +Toggle subtitle visibility. +.IPs "sub_pos <value>" +Adjust subtitles position. +.IPs vo_fullscreen +Switch to fullscreen mode. +.IPs "tv_step_channel <dir>" +Select next/\:previous tv channel. +.IPs "tv_step_norm" +Change TV norm. +.IPs "tv_step_chanlist" +Change channel list. +.IPs "gui_[loadsubtitle|about|play|stop]" +GUI actions +.RE + + +.\" -------------------------------------------------------------------------- +.\" Files +.\" -------------------------------------------------------------------------- +. +.SH FILES +.TP +/etc/\:mplayer/\:mplayer.conf +system\-wide settings +.TP +~/.mplayer/\:config +user settings +.TP +~/.mplayer/\:input.conf +input bindings (see '\-input keylist' for full keylist) +.TP +~/.mplayer/\:gui.conf +GUI configuration file +.TP +~/.mplayer/\:gui.pl +GUI playlist +.TP +~/.mplayer/\:font/ +font directory (There must be a font.desc file and files with .RAW extension.) +.TP +~/.mplayer/\:DVDkeys/ +cracked CSS keys +.PD 0 +.TP +Sub files +are searched for in this priority (for example /mnt/\:movie/\:movie.avi): +.RSs +/mnt/\:cdrom/\:movie.sub +.br +~/.mplayer/\:sub/\:movie.sub +.br +~/.mplayer/\:default.sub +.RE +.PD 1 + + +.\" -------------------------------------------------------------------------- +.\" Examples +.\" -------------------------------------------------------------------------- +. +.SH EXAMPLES +.TP +.B Quickstart DVD playing +mplayer \-dvd 1 +.TP +.B Play in japanese with english subtitles +mplayer \-dvd 1 \-alang ja \-slang en +.TP +.B Play only chapters 5, 6, 7 +mplayer \-dvd 1 \-chapter 5\-7 +.TP +.B Multiangle DVD playing +mplayer \-dvd 1 \-dvdangle 2 +.TP +.B Playing from a different DVD device +mplayer \-dvd 1 \-dvd\-device /dev/\:dvd2 +.TP +.B Old style DVD (VOB) playing +mplayer \-dvdauth /dev/\:dvd /mnt/\:dvd/\:VIDEO_TS/\:VTS_02_4.VOB +.TP +.B Stream from HTTP +mplayer http://mplayer.hq/\:example.avi +.TP +.B Stream using RTSP +mplayer rtsp://server.example.com/\:streamName +.TP +.B Convert subtitle to MPsub (to ./\:dump.mpsub) +mplayer dummy.avi \-sub source.sub \-dumpmpsub +.TP +.B Input from standard V4L +mplayer \-tv on:driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 +\-vo xv +.TP +.B Encoding DVD title #2, only selected chapters +mencoder \-dvd 2 \-chapter 10-15 \-o title2.avi \-oac copy \-ovc divx4 +.TP +.B Encoding DVD title #2, resizing to 640x480 +mencoder \-dvd 2 \-vop scale=640:480 \-o title2.avi \-oac copy \-ovc divx4 +.TP +.B Encoding DVD title #2, resizing to 512xHHH (keep aspect ratio) +mencoder \-dvd 2 \-vop scale \-zoom \-xy 512 \-o title2.avi \-oac copy +\-ovc divx4 +.TP +.B The same, but with libavcodec family, MPEG4 (Divx5) compression +mencoder \-dvd 2 \-o title2.avi \-ovc lavc +\-lavcopts vcodec=mpeg4:vhq:vbitrate=1800 \-oac copy +.TP +.B The same, but with libavcodec family, MJPEG compression +mencoder \-dvd 2 \-o titel2.avi \-ovc lavc +\-lavcopts vcodec=mjpeg:vhq:vbitrate=1800 \-oac copy +.TP +.B Encoding all *.jpg files in the current dir +mencoder \\*.jpg \-mf on:fps=25 \-o output.avi \-ovc divx4 +.TP +.B Encoding from tuner +mencoder \-tv on:driver=v4l:width=640:height=480 \-o tv.avi \-ovc rawrgb +.TP +.B Encoding from a pipe +rar p test-SVCD.rar | mencoder \-ovc divx4 \-divx4opts br=800 \-ofps 24 +\-\- \- +.TP +.B Encoding multiple *.vob files +cat *.vob | mencoder <options> \- + + +.\" -------------------------------------------------------------------------- +.\" Bugs, authors, standard disclaimer +.\" -------------------------------------------------------------------------- +. +.SH BUGS +Probably. +PLEASE, double-check the documentation (especially bugreports.html), +the FAQ and the mail archive before! +.br +Send your complete bug reports to the MPlayer-users mailing list at +<mplayer-users@mplayerhq.hu>. +We love complete bug reports :) + + +.SH AUTHORS +Check documentation. +.TP +MPlayer is (C) 2000\-2003 +.B Arpad Gereoffy +.TP +This man page is written and maintained by +.B Gabucino +.br +.B Diego Biurrun +.br +.B Jonas Jermann +.PP +Please send mails about it to the MPlayer-users mailing list. + + +.SH "STANDARD DISCLAIMER" +Use only at your own risk! +There may be errors and inaccuracies that could be damaging to your system or +your eye. +Proceed with caution, and although this is highly unlikely, the authors don't +take any responsibility for that! +.\" end of file