view DOCS/man/pl/mplayer.1 @ 13348:2242f7d95b14

synced with 1.718
author paszczi
date Wed, 15 Sep 2004 15:33:52 +0000
parents dcd97985f157
children 8143ec28443d
line wrap: on
line source

.\" synced with 1.718
.\" MPlayer (C) 2000-2004 MPlayer Team
.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
.\" Tłumaczenie: Wacław "Torinthiel" Schiller (torinthiel@wp.pl)
.\"            i Maciej "Paszczi" Paszta (paszczi@go2.pl)
.\"   z wykorzystaniem poprzedniego, zrobionego przez
.\"      imoteph (imoteph@wp.pl) & Zorg (kmaterka@wp.pl)
.
.\" --------------------------------------------------------------------------
.\" Makrodefinicje
.\" --------------------------------------------------------------------------
.
.\" domyślne wcięcie to 7, nie zmieniać!
.nr IN 7
.\" określa wcięcie dla podopcji
.nr SS 5
.\" dodaje nową podopcję
.de IPs
.IP "\\$1" \n(SS
..
.\" początek pierwszego poziomu podopcji, koniec to .RE
.de RSs
.RS \n(IN+3
..
.\" początek drugiego poziomu podopcji
.de RSss
.PD 0
.RS \n(SS+3
..
.\" koniec drugiego poziomu podopcji
.de REss
.RE
.PD 1
..
.
.\" --------------------------------------------------------------------------
.\" Tytuł
.\" --------------------------------------------------------------------------
.
.TH MPlayer 1 "2004-08-27" "Projekt MPlayer" "Odtwarzacz filmów"
.
.SH NAZWA
mplayer  \- odtwarzacz filmów
.br
mencoder \- enkoder (koder) filmów
.
.\" --------------------------------------------------------------------------
.\" Składnia
.\" --------------------------------------------------------------------------
.
.SH SKŁADNIA
.na
.nh
.B mplayer
.RI [opcje]\ [ \ zbiór\  | \ URL\  | \ lista\ odtwarzania\  | \ \-\  ]
.
.br
.in
.B mplayer
'in +\n[.k]u
[opcje globalne]
.I zbiór
[opcje specyficzne] [zbiór2] [opcje specyficzne]
.
.br
.in
.B mplayer
'in +\n[.k]u
[opcje globalne]
.RI { "grupa zbiorów i opcji" }
[opcje specyficzne dla grupy]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I dvd://[tytuł | [tytuł_początkowy]\-tytuł_końcowy ]
[opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I vcd://ścieżka[/urządzenie]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I tv://[kanał]
[opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I dvb://[numer_karty@]kanał
[opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I mf://maskazbiorów
[opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I [cdda|cddb]://ścieżka[:szybkość][/urządzenie]
[opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I cue://zbiór[:ścieżka]
[opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.RI [ mms[t] | http | http_proxy | rt[s]p | ftp ] ://
[użytkownik:hasło@]\fIURL\fP[:port] [opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I sdp://plik
[opcje]
.
.br
.in
.B mplayer
'in +\n[.k]u
.I mpst://host[:port]/URL
[opcje]
.
.br
.in
.B gmplayer
[opcje]
[\-skin\ skórka]
.
.br
.B mencoder
[opcje]
.RI [ \ zbiór\  | \ URL\  | \ \-\  ]
[\-o\ zbiór]
.ad
.hy
.
.\" --------------------------------------------------------------------------
.\" Opis
.\" --------------------------------------------------------------------------
.
.SH OPIS
.B mplayer
to odtwarzacz filmów dla Linuksa (działa na wielu innych platformach i
architekturach procesora, patrz dokumentacja).
Odtwarza większość zbiorów MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4,
OGG/\:OGM, MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM i RoQ, obsługiwanych
przez wiele natywnych i binarnych kodeków.
Możesz odtwarzać VideoCD, SVCD, DVD, 3ivx, DivX 3/\:4/\:5, a nawet filmy WMV.
.PP
MPlayer obsługuje wiele sterowników wyjścia video i audio.
Pracuje z X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
Quartz, ale możesz używać GGI, SDL (i w ten sposób wszystkich ich sterowników),
VESA (we wszystkich kartach kompatybilnych z VESA, nawet bez X11), niektórych
niskopoziomowych, specyficznych dla kart sterowników (dla Matrox, 3Dfx i ATI) i
niektórych sprzętowych dekoderów MPEG, takich jak Siemens DVB, DXR2 i
DXR3/\:Hollywood+.
Większość z nich obsługuje programowe lub sprzętowe skalowanie, więc będziesz
mógł oglądać filmy na pełnym ekranie.
.PP
MPlayer obsługuje OSD do pokazywania stanu, wizualne sprzężenie ze sterowaniem
przy pomocy klawiatury i wyświetla ładne, duże, antyaliasowane i cieniowane
napisy.
Obsługiwane są czcionki europejskie/\:ISO 8859-1,2 (polskie, czeskie, angielskie
itp.), koreańskie i cyrylica oraz 12 formatów napisów (MicroDVD, SubRip, OGM,
SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS i nasz własny: MPsub)
i napisów DVD (strumienie SPU, VOBSub i Closed Captions).
.PP
.B mencoder
(Koder Filmów MPlayera) jest to prosty koder (kompresor) filmów, zaprojektowany
do kodowania filmów otwieralnych MPlayerem (patrz wyżej) do innych obsługiwanych
formatów (patrz niżej).
Potrafi kodować do DivX4, XviD, kodeków libavcodec, a dźwięk do
PCM/\:MP3/\:VBRMP3 w 1, 2 lub 3-przejściach.
Potrafi również kopiować strumieniowo, posiada potężny system filtrów
(kadrowanie, powiększanie, odwracanie, postprocesing, obracanie, skalowanie,
szum, konwersja rgb/\:yuv) i inne.
.PP
.B gmplayer
to MPlayer z graficznym interfejsem użytkownika.
Ma te same opcje co MPlayer.
.PP
.B Sprawdź również dokumentację w formacie HTML!
.
.
.\" --------------------------------------------------------------------------
.\" Sterowanie klawiaturą
.\" --------------------------------------------------------------------------
.
.SH "STEROWANIE KLAWIATURĄ"
MPlayer ma w pełni konfiguralną, sterowaną komendami, warstwę kontroli, która
pozwala Ci na sterowanie przy pomocy klawiatury, myszy, joystika lub
zdalnego sterowania (korzysta z LIRC).
Opcja \-input podpowie Ci jakie są sposoby dopasowania jej do swoich potrzeb.
.
.TP
.B kontrola podstawowa
.PD 0
.RSs
.IPs "<\- i \->"
Skacze w tył/\:w przód o 10 sekund.
.IPs "góra i dół"
Skacze w tył/\:w przód o 1 minutę.
.IPs "pgup i pgdown"
Skacze w tył/\:w przód o 10 minut.
.IPs "< i >"
Skacze w przód/\:w tył na liście odtwarzania.
.IPs "HOME i END"
następna/\:poprzednia pozycja drzewa odtwarzania z listy wyższego poziomu.
.IPs "INS i DEL"
następne/\:poprzednie alternatywne źródło (tylko lista odtwarzania ASX)
.IPs "p / SPACE"
Zatrzymuje odtwarzanie (dowolny klawisz wznawia odtwarzanie).
.IPs "q / ESC"
Zatrzymuje odtwarzanie i wychodzi.
.IPs "+ i \-"
Zmienia opóźnienia audio o +/\:\- 0.1 sekund.
.IPs "/ i *"
Zmniejsza/\:zwiększa głośność.
.IPs "9 i 0"
Zmniejsza/\:zwiększa głośność.
.IPs m\ \ \ \ 
Wycisza dźwięk.
.IPs f\ \ \ \ 
Przełącza tryb pełnoekranowy (patrz też \-fs).
.IPs T\ \ \ \ 
Przełącza tryb zostań-na-wierzchu (sprawdź również \-ontop).
.IPs "w i e"
Zmniejsza/\:zwiększa zakres trybu panoramicznego.
.IPs o\ \ \ \ 
Przełącza tryby OSD: żaden / przewijanie / przewijanie + czas /
przewijanie + czas + czas całkowity
.IPs d\ \ \ \ 
Przełącza tryby gubienia klatek: żaden / omiń wyświetlanie / omiń dekodowanie
(zobacz \-framedrop i \-hardframedrop).
.IPs v\ \ \ \ 
Przełącza wyświetlanie napisów.
.IPs "b / j"
Przełącza dostępne napisy.
.IP F\ \ \ \ 
Przełącza wyświetlanie tylko wymuszonych napisów
.IPs a\ \ \ \ 
Przełącza pozycję napisów: góra/\:środek/\:dół.
.IPs "z i x"
Zmienia opóźnienie napisów o +/\:\- 0.1 sekund.
.IPs "r i t"
Przesuwa napisy w górę/\:w dół.
.IPs i\ \ \ \ 
Ustawia znak EDL.
.RE
.PD 1
.PP
(Następujące klawisze działają tylko, jeżeli używasz wyjścia video ze sprzętową
akceleracją (xv, (x)vidix, (x)mga, etc) lub programowego filtru korekcji
(\-vf eq lub \-vf eq2).
.PP
.PD 0
.RSs
.IPs "1 i 2"
Modyfikuje kontrast.
.IPs "3 i 4"
Modyfikuje jasność.
.IPs "5 i 6"
Modyfikuje barwę (kolorów).
.IPs "7 i 8"
Modyfikuje nasycenie.
.RE
.PD 1
.
.TP
.B Kontrola GUI klawiaturą
.PD 0
.RSs
.IPs ENTER
Zaczyna odtwarzanie.
.IPs s\ \ \ \ 
Zatrzymuje odtwarzanie.
.IPs l\ \ \ \ 
Wczytuje zbiór.
.IPs c\ \ \ \ 
Przeglądarka skórek.
.IPs p\ \ \ \ 
Przełącza listę odtwarzania.
.RE
.PD 1
.
.TP
.B Kontrola wejścia TV
.PD 0
.RSs
.IPs "h i k"
Wybiera poprzedni/\:następny kanał.
.IPs n\ \ \ \ 
Zmienia normę.
.IPs u\ \ \ \ 
Zmienia listę kanałów.
.RE
.PD 1
.
.
.\" --------------------------------------------------------------------------
.\" Opcje
.\" --------------------------------------------------------------------------
.
.SH "SPOSÓB UŻYCIA"
Każda "flaga" opcji ma "przeciwflagę" do pary, np.\& dla \-fs przeciwną jest
opcja \-nofs.
.PP
Jeżeli opcja jest oznaczona jako (tylko XXX), będzie działała tylko w parze z
opcją XXX, albo jeżeli obsługa XXX została wkompilowana.
.PP
Możesz umieścić wszystkie opcje w zbiorze konfiguracyjnym, z którego MPlayer
będzie czytał przy każdym uruchomieniu.
Główny zbiór konfiguracyjny "mplayer.conf" jest w katalogu konfiguracyjnym
(np.\& /etc/\:mplayer lub /usr/\:local/\:etc/\:mplayer), a specyficzny dla
użytkownika to "~/\:.mplayer/\:config".
Opcje określone przez użytkownika unieważniają opcje z głównego zbioru, a opcje
podawane z wiersza poleceń unieważniają obie.
Składnia zbioru konfiguracyjnego to "opcja=<wartość>", wszystko po "#" uważane
jest za komentarz.
Opcje działające bez wartości mogą być włączone przez ustawienie "yes", "1" lub
"true" i wyłączone przez przypisanie im "no", "0", lub "false".
Również podopcje mogą być określane w ten sposób.
.PP
.I PRZYKŁAD:
.nf
# Używa sterownika Matrox jako domyślnego.
vo=xmga
# Uwielbiam stać na rękach gdy oglądam filmy.
flip=yes
# Dekoduje/\:koduje wielokrotne zbiory png,
# zaczynaj od mf://maskazbiorów
mf=type=png:fps=25
# Dziwne negatywy są fajne
vf=eq2=1.0:-0.8
.fi
.PP
Możesz też napisać zbiór konfiguracyjny dla konkretnego pliku.
Jeśli zamierzasz mieć zbiór konfiguracyjny dla pliku o nazwie "film.avi",
utwórz "film.avi.conf" z zawartymi w nim opcjami i umieść go
w ~/.mplayer lub w tym samym katalogu, co film.
.
.
.
.SH "OPCJE OGÓLNE"
.
.TP
.B \-codecs-file <plik> (zobacz również opcje \-afm, \-ac, \-vfm i \-vc)
Używa podanego pliku zamiast dostępnego w systemie lub wbudowanego codecs.conf.
.
.TP
.B \-include <plik\ konfiguracyjny>
Określa plik z ustawieniami, który będzie parsowany po tych domyślnych.
.
.TP
.B \-quiet \ \ 
Sprawia, że wyjście na konsolę jest mniej gadatliwe; w szczególności zapobiegnie
to wyświetleniu wiersza stanu (tzn.\& A:   0.7 V:   0.6 A-V:  0.068 ...).
Szczególnie przydatne na wolnych terminalach lub na takich, które nie obsługują
poprawnie znaku powrotu karetki (tzn.\& \\r).
.
.TP
.B \-v, \-verbose
Zwiększa poziom gadatliwości (raportowania) (więcej \-v oznacza większy poziom).
.PD 0
.RSs
.IPs 0
wiadomości czysto informacyjne (domyślne)
.IPs 1
podstawowe informacje do debugu, nagłówku avi, wartości funckji (debug inicjalizacji)
.IPs 2
drukuje indeksy avi, kawałki danych wejściowych, więcej informacji do debugu (debug odtwarzacza)
.IPs 3
drukuje wszystko związane z parserami danych wejściowych (debug parsera)
.RE
.PD 1
.
.
.
.SH "OPCJE ODTWARZACZA (TYLKO MPLAYER)"
.
.TP
.B \-autoq <jakość> (używaj z \-vf [s]pp)
Dynamicznie zmiania poziom postprocesingu w zależności od dostępnego wolnego
czasu procesora.
Numer, który wyszczególnisz, będzie najwyższym poziomem.
Najczęściej możesz używać dużych liczb.
Musisz użyć \-vf [s]pp bez parametrów, aby ta opcja działała.
.
.TP
.B \-autosync <czynnik>
Stopniowo dostosowuje synchronizację A/\:V bazując na pomiarze opóźnień audio.
Podanie \-autosync\ 0, domyślnie, spowoduje, że "czas" klatki będzie
bazował wyłącznie na pomiarze opóźnienia audio.
Podanie \-autosync\ 1 zrobi to samo, ale nieznacznie zmieni
algorytm korekcji A/\:V.
Nierówna prędkość odtwarzania filmów, które odtwarzane są dobrze z \-nosound
często może być poprawiona przez podanie liczby większej niż 1.
Im wyższa wartość tym rezultaty będą bliższe zastosowaniu \-nosound.
Spróbuj użyć \-autosync\ 30, żeby stłumić problemy spowodowanie przez sterowniki
dźwięku, które nie mają dokładnego pomiaru opóźnień audio.
Z tą wartością, jeżeli zdarzy się duże przesunięcie synchronizacji A/\:V,
wyregulowanie potrwa tylko około 1 lub 2\ sekund.
Opóźnienie reakcji na nagłe przesunięcie A/\:V powinno być jedynym ubocznym
efektem włączanie tej opcji, dla wszystkich sterowników dźwięku.
.
.TP
.B \-benchmark
Pokazuje na końcu odtwarzania statystyki użycia procesora i zgubionych klatek.
Używaj w kombinacji z \-nosound i \-vo null dla testowania szybkości kodeka
video.
.br
.I UWAGA:
Z tą opcją MPlayer ignoruje czas trwania ramki, jeśli odtwarza tylko video
(można to uznać za nielimitowane fps).
.
.TP
.B \-colorkey <numer>
Zmienia kolor kluczowy (colorkey) na wybraną wartość RGB.
0x000000 to czarny a 0xffffff to biały.
Obsługiwane tylko przez sterowniki wyjścia video cvidix, fbdev, svga, vesa,
winvidix, xmga, xvidix i xover.
.
.TP
.B \-nocolorkey
Wyłącza kolor kluczowy.
Obsługiwane tylko przez sterowniki wyjścia video cvidix, fbdev, svga, vesa,
winvidix, xmga, xvidix i xover.
.
.TP
.B \-edl <nazwa\ pliku>
Włącza decyzyjną listę edycji (ang.\& edit decision list (EDL)) podczas
odtwarzania.
Video będzie pomijane, audio będzie wyciszane i włączane zgodnie z wpisami w
podanym zbiorze.
Szczegółowe informacje zawarte są w DOCS/\:HTML/\:pl/\:edl.html.
.
.TP
.B \-edlout <nazwa\ zbioru>
Tworzy nowy zbiór i zapisuje decyzyjną listę edycji (EDL) do tego zbioru.
Podczas odtwarzania, kiedy użytkownik wciśnie "i", wpis o pominięciu dwóch
ostatnich sekund zostanie zapisany do zbioru.
Daje to punkt wyjścia, który użytkownik może później dopasować do swoich
potrzeb.
Szczegółowe informacje zawarte są w DOCS/\:HTML/\:pl/\:edl.html.
.
.TP
.B \-enqueue (tylko GUI)
Dodaje zbiory podane w wierszu poleceń do listy odtwarzania, zamiast odtwarzać
je od razu.
.
.TP
.B \-fixed-vo (KOD BETA!)
Wymusza ustawienie jednego systemu video dla wszystkich zbiorów (jedna
(de)inicjalizacja dla wszystkich zbiorów).
Dlatego też tylko jedno okno zostanie otwarte dla wszystkich zbiorów.
Obecnie działa z następującymi sterownikami: gl2, mga, svga, x11, xmga, xv,
xvidix i dfbmga.
.
.TP
.B \-framedrop (zobacz także \-hardframedrop)
Nie wyświetla niektórych klatek, by utrzymać synchronizacje A/\:V na wolnych
komputerach.
Filtry video nie będą stosowane do tych klatek.
Dla klatek B nawet dekodowanie jest całkowicie pominięte.
.
.TP
.B \-h, \-help, \-\-help
Pokazuje krótkie podsumowanie opcji.
.
.TP
.B \-hardframedrop
Większa intensywność opuszczania klatek (przerywa dekodowanie).
Prowadzi do zniekształceń obrazu!
.
.TP
.B \-identify
Pokazuje parametry zbioru w łatwo przeglądalnym formacie.
Skrypt TOOLS/\:midentify wycina inne napisy MPlayera i (mamy nadzieję)
zabezpiecza specjalne znaki przed interpretacją przez powłokę.
.
.TP
.B \-input <komendy>
Ta opcja może być używana do konfiguracji pewnych części systemu wejściowego.
Ścieżki są względem ~/\:.mplayer/.
.br
.I INFORMACJA:
Autopowtarzanie jest obecnie obsługiwane tylko przez joysticki.
.sp 1
Dostępne są polecenia:
.sp 1
.PD 0
.RSs
.IPs conf=<plik>
Określa plik konfiguracyjny warstwy kontroli, inny niż domyślny
~/\:.mplayer/\:input.conf.
Jeżeli nie podano pełnej ścieżki, pod uwagę brany jest ~/\:.mplayer/\:<plik>.
.IPs ar-delay
Opóźnienie w msek przed rozpoczęciem automatyczniego powtarzania klawisza
(0 żeby wyłączyć).
.IPs ar-rate
Ilość generowanych przyciśnięć klawisza na sekundę przy autopowtarzaniu.
.IPs keylist
Lista wszystkich klawiszy, które mogą być przypisane do komend.
.IPs cmdlist
Lista wszystkich komendy, które mogą być przypisane do klawiszy.
.IPs js-dev
Wybiera używany joystick (domyślnie: /dev/\:input/\:js0).
.IPs plik\ 
Czyta polecenia z podanego zbioru.
Opcja głównie przydatna przy kolejce FIFO.
.br
.I INFORMACJA:
Jeśli podany zbiór jest kolejką, MPlayer otwiera oba końce, więc można
kilkukrotnie napisać "echo "seek 10" > mp_pipe" i kolejka będzie działać.
.RE
.PD 1
.
.TP
.B \-lircconf <plik> (tylko z LIRC)
Wskazuje plik konfiguracyjny dla LIRC (domyślne ~/\:.lircrc).
.
.TP
.B \-list-options
Wyświetla wszystkie dostępne opcje.
.
.TP
.B \-loop <ilość>
Powtarza film <ilość> razy.
0 oznacza zawsze.
.
.TP
.B \-menu (tylko z menu OSD)
Włącza menu OSD.
.
.TP
.B \-menu-cfg <plik> (tylko z menu OSD)
Wskazuje alternatywny plik konfiguracyjny menu.conf.
.
.TP
.B \-menu-root <wartość> (tylko z menu OSD)
Wybiera menu główne.
.
.TP
.B \-noconsolecontrols
Powstrzymuje MPlayera przed czytaniem zdarzeń klawiszy ze standardowego wejścia.
Użyteczne, jeżeli dane są z niego pobierane.
Jest to automatycznie włączane, jeśli w wierszu poleceń zostanie odnaleziony \-.
Są jednak sytuacje, w których sam musisz to aktywować, np.\&
jeżeli otwierasz /dev/\:stdin (albo odpowiednik w Twoim systemie),
używasz stdin na liście odtwarzania albo zamierzasz czytać z stdin później
poprzez polecenia trybu slave loadlist i loadfile.
.
.TP
.B \-nojoystick
Wyłącza obsługę joysticka.
.
.TP
.B \-nolirc
Wyłącza obsługę LIRC.
.
.TP
.B \-nomouseinput (tylko z X11)
Wyłącza obsługę zdarzeń wciśnięcia/\:puszczenia przycisku myszki
(menu kontekstowe mozplayerxp korzysta z tej opcji).
.
.TP
.B \-nortc (tylko z RTC)
Wyłącza używanie Linux RTC (real-time clock \- /dev/\:rtc) jako mechanizmu
mierzenia czasu.
.
.TP
.B \-playlist <nazwa\ pliku>
Odtwarza zbiory według pliku listy odtwarzania (w formatach ASX, Winamp, SMIL
lub jeden zbiór w każdym wierszu).
.br
.I INFORMACJA:
Opcja ta jest uważana za pozycję wyjściową, więc opcje następujące po niej
odnoszą się tylko do zbiorów na tej liście.
.br
FIXME: Musi to być bardziej przejrzyste i dokładnie udokumentowane.
.
.TP
.B \-really-quiet (zobacz również opcję \-quiet)
Wyświetla jeszcze mniej komunikatów wyjściowych i stanu niż z opcją \-quiet.
.
.TP
.B \-rtc-device <urządzenie>
Korzysta z określonego urządzenia do synchronizacji przez RTC.
.
.TP
.B \-shuffle
Odtwarza zbiory w losowej kolejności.
.
.TP
.B \-skin <nazwa> (tylko z GUI)
Załaduje skórkę z podanego jako parametr katalogu znajdującego się pod
domyślnymi katalogami skórek, /usr/\:local/\:share/\:mplayer/\:Skin/
i ~/.mplayer/Skin.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-skin fittyfene"
Próbuje załadować /usr/\:local/\:share/\:mplayer/\:Skin/\:fittyfene,
później ~/.mplayer/\:Skin/\:fittyfene.
.RE
.PD 1
.
.TP
.B \-slave (zobacz również opcję \-input)
Ta opcja przełącza MPlayera w tryb slave, w którym można go używać jako końcówki
(backend) dla innych programów.
Zamiast przechwytywania wciśniętych klawiszy, MPlayer będzie czytał proste
polecenia ze standardowego wejścia.
.br
.I INFORMACJA:
Listę poleceń otrzymasz z \-input cmdlist, a ich opis znajdziesz
w DOCS/\:tech/\:slave.txt.
.
.TP
.B \-softsleep
Używa wysokiej jakości zegarów programowych.
Tak dokładne jak RTC, ale nie wymaga specjalnych uprawnień.
Skutkuje większym obiążeniem procesora.
.
.TP
.B \-speed <0.01\-100>
Zwalnia lub przyspiesza odtwarzanie o współczynnik podany jako parametr.
.
.TP
.B \-sstep <sek>
Wyświetla jedną klatke co <sek> sekund.
Użyteczny w pokazie slajdów.
.
.
.
.SH "OPCJE DEMUXERA/\:STRUMIENI"
.
.TP
.B \-a52drc <poziom>
Wybiera poziom Kompresji Dynamiki (Dynamic Range Compression) dla
strumieni dźwiękowych AC3.
<poziom> jest liczbą rzeczywistą od 0 do 1, gdzie 0 oznacza brak kompresji,
a 1 (wartość domyślna) oznacza pełną kompresję (głośne kawałki są przyciszane
wyciszone i vice versa).
Opcja ta jest skuteczna tylko wtedy, kiedy strumień AC3 zawiera informacje
o wymaganym zasięgu kompresji.
.
.TP
.B \-aid <ID> (przeczytaj też \-alang)
Wybiera kanał audio (MPEG: 0\-31 AVI/\:OGM: 1\-99 ASF/\:RM: 0\-127,
VOB(AC3): 128\-159 VOB(LPCM): 160\-191 MPEG-TS 17\-8190).
MPlayer wyświetli dostępne identyfikatory, jeśli jest uruchomiony w trybie
gadatliwym (\-v).
Kiedy odtwarzany jest strumień MPEG-TS, MPlayer/\:MEncoder użyje pierwszego
programu (jeżeli jest dostępny) z wybranym strumieniem.
.
.TP
.B \-alang <dwuliterowy\ kod\ kraju> (sprawdź też \-aid) (tylko DVD)
Wybiera język ścieżki dźwiękowej dźwięku DVD i próbuje otworzyć strumień audio
pasujący do podanego kodu.
MPlayer wyświetli listę dostępnych języków, jeśli jest uruchomiony w trybie
gatatliwym (\-v).
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-alang pl,en"
Odtwarza polską ścieżkę, a jeśli ta jest niedostępna to angielską.
.RE
.PD 1
.
.TP
.B \-audio-demuxer <numer> (tylko z opcją \-audiofile)
Wymusza typ demuxera audio dla \-audiofile.
Podaj ID demuxera, są one zdefiniowane w zbiorze libmpdemux/\:demuxer.h.
\-audio-demuxer 17 wymusza MP3.
.
.TP
.B \-audiofile <nazwa\ zbioru>
Otwórz audio z zewnętrznego zbioru (WAV, MP3 lub Ogg Vorbis) podczas
odtwarzania filmu.
.
.TP
.B \-audiofile-cache <kBajty>
Włącza cache dla strumienia używanego przez \-audiofile, używając określonej
ilości pamięci.
.
.TP
.B \-bandwidth <wartość> (tylko z siecią)
Określa maksymalną szerokość pasma (bitrate) strumienia sieciowego (dla
serwerów potrafiących przesyłać z różnymi szerokościami pasma).
Przydatne jeśli chcesz oglądać na żywo media ze strumieni przy wolnym
połączeniu.
.
.TP
.B \-cdrom-device <ścieżka\ do\ urządzenia>
Ustawia ścieżkę do urządzenia CD-ROM (domyślnie: /dev/\:cdrom).
.
.TP
.B \-cache <kBajty>
Ta opcja określa ile pamięci (w kBajtach) ma być użyte do wstępnego
buforowania zbioru lub URL.
Szczególnie przydatne przy powolnych nośnikach.
.
.TP
.B \-cache-min <procent>
Odtwarzanie rozpocznie się gdy bufor zostanie wypełniony w podanym stopniu.
.
.TP
.B \-cache-prefil <procent> (jeszcze nie zaimplementowane)
Jeśli bufor zostanie opróżniony MPlayer zatrzyma się i wznowi odtwarzanie gdy
bufor osiągnie zadany poziom wypełnienia.
.
.TP
.B \-cdda <opcja1:opcja2> <tylko z CDDA)
Dostosowuje możliwość czytania CD Audio MPlayera.
.sp 1
Dostępne są opcje:
.RSs
.IPs speed=<wartość>
Ustala prędkość obrotów CD.
.IPs paranoia=<0\-2>
Ustala poziom paranoi.
.RSss
0: wyłącza sprawdzanie
.br
1: sprawdza tylko overlap (domyślnie)
.br
2: pełna korekcja i weryfikacja danych
.REss
.IPs generic-dev=<wartość>
Używa podanego ogólnego urządzenia SCSI.
.IPs sector-size=<wartość>
Rozmiar bloku jednorazowego czytania.
.IPs overlap=<wartość>
Wymusza minimalne przeszukiwanie overlap podczas weryfikacji do <wartość>
sektorów.
.IPs toc-bias
Zakłada że adres początku pierwszej ścieżki zapisany w TOC będzie adresowany
jako LBA\ 0.
Niektóre sterowniki Toshiba potrzebują tego by poprawnie określić granice
ścieżek.
.IPs toc-offset=<wartość>
Dodaje <wartość> sektorów do odczytanych wartości podczas adresowania ścieżek.
Wartość może być ujemna.
.IPs (no)skip
(Nie)akceptuje niedoskonałe rekonstrukcje danych.
.RE
.
.TP
.B \-channels <numer>
Wybiera liczbę kanałów do odtwarzania (domyślnie: 2).
Jeżeli liczba kanałów wyjścia jest większa niż liczba kanałów wejścia,
zostaną wstawione puste kanały (poza miksowaniem mono na stereo, wtedy
w obydwóch kanałach wyjścia zostanie powielony kanał mono).
Jeżeli liczba kanałów wyjścia jest mniejsza od liczby kanałów wejścia,
wynik zależy od dekodera audio (\-afm).
MPlayer prosi dekoder by dekodował audio do wybranej ilości kanałów.
Od dekodera zależy jak (i czy) sobie z tym poradzi.
Jeżeli dekoder wygeneruje więcej kanałów niż potrzeba wówczas nadmiarowe zostaną
wycięte.
Opcja ta jest zazwyczaj potrzebna tylko przy odtwarzaniu filmów z dźwiękiem w
formacie AC3 (jak DVD).
W tym wypadku liba52 dekoduje i prawidłowo przerabia dźwięk na wymaganą
liczbę kanałów.
.br
.I INFORMACJA:
Opcja ta jest honorowana przez kodeki (tylko AC3), filtry (surround)
i sterowniki ao (przynajmniej OSS).
.sp 1
Dostępne są opcje:
.sp 1
.PD 0
.RSs
.IPs 2
stereo
.IPs 4
surround
.IPs 6
pełne 5.1
.RE
.PD 1
.
.TP
.B \-chapter <ID\ rozdziału[\-<ID\ końcowego\ rozdziału>] (tylko DVD)
Określa numer rozdziału od którego należy zacząć odtwarzanie.
Może też określić numer rozdziału na którym należy skończyć odtwarzanie
(domyślnie: 1).
.
.TP
.B \-cookies (tylko z siecią)
Wysyła cookies przy żądaniach HTTP.
.
.TP
.B \-cookies-file <nazwa\ zbioru> (tylko z siecią)
Czyta HTTP cookies z <nazwa zbioru> (domyślnie ~/.mozilla/ i ~/.netscape/)
i nie czytaj z miejsc standardowych.
Zakłada że zbiór jest w formacie Netscape.
.
.TP
.B \-demuxer <numer>
Wymusza typ demuxera.
Podaj ID demuxera zdefiniowane w libmpdemux/\:demuxer.h.
\-demuxer 17 wymusza MP3.
.
.TP
.B \-dumpaudio (tylko MPlayer)
Zrzuca surowy, skompresowany strumień audio do ./stream.dump
(przydatne z MPEG/\:AC3).
.
.TP
.B \-dumpfile <nazwa\ zbioru> (tylko MPlayer)
Podaje nazwę zbioru wynikowego dla opcji \-dumpaudio / \-dumpvideo /
\-dumpstream.
.
.TP
.B \-dumpstream (tylko MPlayer)
Zrzuca surowy strumień do ./stream.dump.
Przydatny gdy rippujesz z DVD lub sieci.
.
.TP
.B \-dumpvideo (tylko MPlayer)
Zrzuca surowy, skompresowany strumień video do ./stream.dump (niezbyt
przydatne).
.
.TP
.B \-dvbin <options>
Przekazuje zamiast domyślnych następujące opcje modułowi wejścia DVB:
.sp 1
.PD 0
.RSs
.IPs card=<1\-4>
Użyje karty numer 1\-4 (domyślnie: 1).
.IPs file=<nazwa\ pliku>
Czyta listę kanałów z <nazwa pliku>.
Domyślnym jest ~/.mplayer/\:channels.conf.{sat,ter,cbl} (w zależności od
Twojej karty) lub w ostateczności ~/.mplayer/\:channels.conf.
.RE
.PD 1
.
.TP
.B \-dvd-device <ścieżka\ do\ urządzenia> (tylko DVD)
Podaje ścieżkę do urządzenia DVD (domyślnie: /dev/\:dvd).
.
.TP
.B \-dvdangle <ID\ ujęcia> (tylko DVD)
Niektóre dyski DVD zawierają sceny, które mogą być oglądane z różnych ujęć.
Opcja ta informuje MPlayera, którego ujęcia ma używać (domyślnie: 1).
.
.TP
.B \-forceidx
Wymusza przebudowanie indeksu.
Użyteczny dla zbiorów z uszkodzonym indeksem (desynchornizacje A/\:V itp.).
Umożliwia wyszukiwanie w pliku.
Trwałe naprawienie indeksu możliwe jest przy pomocy MEncodera (patrz
dokumentacja)
.br
.I INFORMACJA:
Opcji tej można używać tylko jeśli dany nośnik obsługuje wyszukiwanie
(czyli nie stdin, kolejka itp.).
.
.TP
.B \-fps <liczba rzeczywista>
Zmienia prędkość odtwarzania klatek video (framerate)
Przydatne jeśli wartość w nagłówku jest zła/\:nie istnieje.
.
.TP
.B \-frames <ilość>
Odtwarza/\:konwertuje tylko pierwsze <ilość> klatek, potem wychodzi.
.
.TP
.B \-hr-mp3-seek (tylko z MP3)
Dokładne przeszukiwanie MP3.
Włączone gdy odtwarzamy z zewnętrznego zbioru MP3, gdyż potrzebujemy
znaleźć bardzo dokładną pozycję do utrzymania synchronizacji A/\:V.
Potrafi być wolne, szczególnie gdy szukamy do tyłu, ponieważ trzeba przewinąć
do samego początku by znaleźć dokładnie tę klatkę.
.
.TP
.B \-idx (patrz też opcja \-forceidx)
Przebuduje indeks AVI, jeżeli nie zostanie on znaleziony, umożliwiając
przeszukiwanie zbioru.
Przydatne przy uszkodzonych/\:niekopletnych zbiorach lub źle stworzonych
plikach.
.br
.I INFORMACJA:
Opcji tej można używać tylko jeśli dany nośnik obsługuje wyszukiwanie
(czyli nie stdin, kolejka itp.).
.
.TP
.B \-ipv4-only-proxy (tylko z siecią)
Ignoruje proxy dla adresów IPv6.
Będzie on nadal używany dla adresów IPv4.
.
.TP
.B \-loadidx <zbiór\ indeksowy>
Czyta dane indeksu video z <nazwa\ zbioru>, zapisane przez \-saveidx.
MPlayer będzie czytał indeks z podanego zbioru i używał tych danych do
przeszukiwania zamiast jakiegokolwiek indeksu bezpośrednio w zbiorze AVI.
Dodatkowo, MPlayer nie przeszkodzi w załadowaniu zbioru indeksowego
wygenerowanego z innego AVI, ale to z pewnością wywoła niemiłe rezultaty.
.br
.I INFORMACJA:
Ta opcja jest przestarzała, ponieważ MPlayer obsługuje już OpenDML.
.
.TP
.B \-mc <sekundy/\:klatkę>
maksymalna korekcja synchronizacji A-V na klatkę (w sekundach)
.
.TP
.B \-mf <opcja1:opcja2:...>
Używane przy dekodowaniu z wielu zbiorów PNG lub JPEG.
.sp 1
Dostępne są opcje:
.sp 1
.PD 0
.RSs
.IPs w=<wartość>
szerokość danych wyjściowych (domyślnie: autodetekcja)
.IPs h=<wartość>
wysokość danych wyjściowych (domyślnie: autodetekcja)
.IPs fps=<wartość>
ilość klatek na sekundę (fps) w danych wyjściowych (domyślnie: 25)
.IPs type=<wartość>
typ zbiorów wejściowych (dostępne: jpeg, png, tga i sgi)
.RE
.PD 1
.
.TP
.B \-ni (tylko AVI)
Wymusza użycie parsera do AVI bez przeplotu (pozwala odtworzyć niektóre
uszkodzone zbiory AVI).
.
.TP
.B \-nobps (tylko AVI)
Nie używa średniej ilości bajtów/\:sekundę do synchronizacji A-V.
Pomaga przy niektórych zbiorach AVI z uszkodzonym nagłówkiem.
.
.TP
.B \-noextbased
Wyłącza wybór demuxera oparty na rozszerzeniu zbioru.
Domyślnie, kiedy typ zbioru (demuxer) nie może być bezsprzecznie wykryty
(zbiór nie posiada nagłówka lub jest on niewystarczająco pewny),
rozszerzenie zbioru jest użyte do wybrania demuxera.
Zawsze wraca do wyboru demuxera w oparciu o zawartość.
.
.TP
.B \-passwd <hasło> (zobacz też opcję \-user) (tylko z siecią)
Podaje hasło dla autoryzacji HTTP.
.
.TP
.B \-prefer-ipv4
Używa IPv4 do połączeń sieciowych.
Jeśli się nie da, automatycznie przestawia na IPv6.
.
.TP
.B \-prefer-ipv6
Używa IPv6 do połączeń sieciowych.
Jeśli się nie da, automatycznie przestawia na IPv4.
.
.TP
.B \-rawaudio <opcja1:opcja2:...>
Pozwala na odtwarzanie surowych zbiorów audio.
Może też być użyta żeby odtworzyć CD z dźwiękiem innym niż 44KHz 16-bit stereo.
Do odtwarzania surowych strumieni AC3 użyj \-rawaudio on:format=0x2000.
.sp 1
Dostępne są opcje:
.sp 1
.PD 0
.RSs
.IPs on\ \ \ 
Używa demuxera surowego dźwięku.
.IPs channels=<ilość>
ilość kanałów
.IPs rate=<częstotliwść>
częstotliwość próbkowania
.IPs samplesize=<wartość>
rozmiar próbki w bajtach
.IPs bitrate=<value>
bitrate dla surowych danych audio
.IPs format=<wartość>
kod fourcc szesnastkowo
.RE
.PD 1
.
.TP
.B \-rawvideo <opcja1:opcja2:...>
Ta opcja pozwala na odtwarzanie surowych zbiorów video.
.sp 1
Dostępne są opcje:
.sp 1
.PD 0
.RSs
.IPs on\ \ \ 
Używa demuxera surowego video.
.IPs fps=<wartość>
ilość klatek na sekundę (domyślnie: 25.0)
.IPs sqcif|qcif|cif|4cif|pal|ntsc
ustawia jedną ze standardowych wielkości obrazu
.IPs w=<wartość>
szerokość obrazu w pikselach
.IPs h=<wartość>
wysokość obrazu w pikselach
.IPs y420|yv12|yuy2|y8
ustaw przestrzeń kolorów
.IPs format=<wartość>
przestrzeń kolorów (fourcc) w hex
.IPs size=<wartość>
rozmiar klatki w bajtach
.RE
.PD 1
.
.TP
.B \-rtsp-stream-over-tcp (tylko z live.com)
Używane z URLami "rtsp://" dla określenia, że nadchodzące pakiety RTP i RTCP
mają być przesyłane przez TCP (używając tego samego połączenia co RTSP).
Przydatne przy uszkodzonym połączeniu internetowym, które nie przepuszcza
pakietów UDP (zobacz http://www.live.com/\:mplayer).
.
.TP
.B \-saveidx <nazwa\ zbioru>
Wymusza przebudowanie indeksu i zapisuje go w zbiorze <nazwa\ zbioru>.
Aktualnie działa to tylko ze zbiorami AVI.
.br
.I INFORMACJA:
Ta opcja jest przestarzała, ponieważ MPlayer obsługuje już OpenDML.
.
.TP
.B \-sb <pozycja\ w\ bajtach> (patrz też opcja \-ss)
Przewija do pozycji określonej w bajtach.
Przydatne do odtwarzania z obrazów CD-ROM lub zbiorów VOB ze śmieciami na
początku.
.
.TP
.B \-srate <Hz>
Wybiera podaną częstotliwość próbkowania wyjścia, przeskalowując jeśli jest to
niezbędne.
MEncoder przekazuje tę wartość do LAME przy przepróbkowywaniu.
.
.TP
.B \-ss <czas> (patrz też opcja \-sb)
Przeskakuje do podanego czasu.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-ss 56"
Przeskakuje do 56 sekundy.
.IPs "\-ss 01:10:00"
Przeskakuje do 1\ godziny i 10\ minut.
.RE
.PD 1
.
.TP
.B \-tskeepbroken
Informuje MPlayera by nie odrzucał pakietów TS zgłoszonych w strumieniu jako
błędne.
Czasami potrzebne do odtworzenia uszkodzonych zbiorów MPEG-TS.
.
.TP
.B \-tsprobe <ilość\ bajtów>
Przy odtwarzaniu strumienia MPEG-TS, opcja ta pozawala podać jak wiele bajtów
w strumieniu MPlayer ma przeglądać w poszukiwaniu żądanych pidów audio i
video.
.
.TP
.B \-tsprog <1\-65534>
Przy odtwarzaniu strumienia MPEG-TS pozwala podać który program (jeśli jest
kilka) należy odtwarzać.
Może być użyta z \-vid i \-aid.
.
.TP
.B \-tv <opcja1:opcja2:...> (tylko z TV)
Ta opcja dostosowuje rozmaite właściwości modułu przechwytywania TV.
Żeby oglądać telewizję MPlayerem podaj "tv://" lub "tv://<numer_kanału>" albo
nawet "tv://<nazwa_kanału>" (jak ustawić <nazwę_kanału> podaje opcja channels
poniżej) jako URL filmu.
.sp 1
Dostępne są opcje:
.RSs
.IPs noaudio
bez dźwięku
.IPs driver=<wartość>
dostępne sterowniki: dummy, v4l, v4l2, bsdbt848
.IPs device=<wartość>
Podaje urządzenie TV (domyślnie: /dev/\:video0).
.IPs input=<wartość>
Wybiera wejście (domyślnie: 0 (TV) (lista jest wypisywana na konsoli).
.IPs freq=<wartość>
Podaje częstotliwość na którą należy ustawić tuner (np.\& 511.250).
Nie działa z parametrem channels.
.IPs outfmt=<wartość>
Podaje format wyjściowy tunera jako nazwę obsługiwaną przez sterownik V4L
(yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2, i420) lub dowolny format
określony wartością szesnastkową.
Jeśli chcesz poznać wszystkie dostępne formaty podaj outfmt=help.
.IPs width=<wartość>
szerokość okna wyjściowego
.IPs height=<wartość>
wysokość okna wyjściowego
.IPs fps=<wartość>
częstotliwość przechwytywania video (ile klatek na sekundę przechwytywać)
.IPs buffersize=<wartość>
maksymalny rozmiar bufora przechwytywania w megabajtach (domyślnie: dynamiczny)
.IPs norm=<wartość>
dostępne: PAL, SECAM, NTSC.
Przy v4l2 użyj poniższej opcji normid.
.IPs "normid=<wartość> (tylko v4l2)"
Lista norm TV jest wypisywana przez MPlayera.
.IPs channel=<wartość>
Ustawia tuner na kanał <wartość>.
.IPs chanlist=<wartość>
dostępne: europe-east, europe-west, us-bcast, us-cable, itp.
.IPs channels=<kanał>\-<nazwa>,<kanał>\-<nazwa>,...
Ustawia nazwy dla kanałów.
Używaj _ zamiast spacji w nazwach (albo pobaw się cudzysłowami ;-).
Nazwy kanałów będą wtedy wypisywane przez OSD, a polecenia tv_step_channel,
tv_set_channel i tv_last_channel będą dostępne z pilota (zobacz LIRC).
Nie działa z parametrem frequency.
.br
.I INFORMACJA:
Numer kanału będzie pozycją na liście kanałów, licząc od 1.
.br
.I PRZYKŁAD:
tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1
.IPs [brightness|contrast|hue|saturation]=<-100\-100>
Ustawia korekcję obrazu na karcie.
.IPs audiorate=<wartość>
Ustawia tempo bitowe przechwytywania audio.
.IPs forceaudio
Przechwytuje audio nawet gdy v4l nie zgłasza żadnych źródeł audio.
.IPs alsa\ 
Przechwytuje z ALSA.
.IPs amode=<0\-3>
Wybiera tryb audio:
.RSss
0: mono
.br
1: stereo
.br
2: język 1
.br
3: język 2
.REss
.IPs forcechan=<1\-2>
Domyślnie, liczba zapisanych kanałów audio jest automatycznie ustawiana
zgodnie z ustawieniami audio karty TV.
Ta opcja wymusza nagrywanie stereo/\:mono bez względu na opcję amode i
wartości zwracane przez v4l.
Przydatne jeśli karta TV nie jest w stanie zgłosić prawidłowego trybu audio.
.IPs adevice=<wartość>
ustawia urządzenie audio
<wartość> powinna być /dev/\:...\& dla OSS i ID sprzętu dla ALSA.
Opis podawania ID sprzętu jest w dokumentacji \-ao alsa.
.IPs audioid=<wartość>
Wybiera wyjście audio karty, jeżeli karta ma więcej niż jedno.
.IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
.IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
Te opcje ustawiają parametry miksera karty video.
Nie przyniesie to żadnych efektów, jeżeli Twoja karta go nie posiada.
Dla v4l2 50 oznacza domyślną wartość przekazaną przez sterownik karty.
.IPs immediatemode=<wartość\ logiczna>
Wartość 0 oznacza przechwytywanie i buforowanie audio i video razem
(domyślna dla MEncodera).
Wartość 1 (domyślna dla MPlayera) oznacza przechwytywanie tylko video
i pozwolenie na przesyłanie dźwięku z karty TV do karty dźwiękowej poprzez
kabel je łączący.
.IPs mjpeg
Używa sprzętowej kompresji MJPEG (jeżeli karta ma taką możliwość).
Gdy używasz tej opcji, nie musisz podawać szerokości i wysokości okna
wyjściowego, ponieważ MPlayer ustali je automatycznie z wartości decimation
(patrz poniżej).
.IPs decimation=<1,2,4>
wybierz rozmiar obrazu, który będzie skompresowany przez sprzętową kompresję
MJPEG:
.RSss
1: pełny rozmiar
    704x576    PAL
    704x480    NTSC
.br
2: średni rozmiar
    352x288    PAL
    352x240    NTSC
.br
4: mały rozmiar
    176x144    PAL
    176x120    NTSC
.REss
.IPs quality=<0\-100>
Wybiera jakość kompresji JPEG
(dla pełnego rozmiaru zalecane jest < 60).
.RE
.
.TP
.B \-user <nazwa\ użytkownika> (zobacz także opcję \-passwd) (tylko sieć)
Podaje nazwę użytkownika do uwierzytelnienia HTTP.
.
.TP
.B \-user-agent <ciąg>
Zgłasza <ciąg> jako program użytkownika (user agent) w strumieniowaniu HTTP.
.
.TP
.B \-vid <ID>
Wybiera kanał video (MPG: 0\-15 ASF: 0\-255 MPEG-TS: 17\-8190).
Przy odtwarzaniu strumienia MPEG-TS MPlayer/\:MEncoder użyje pierwszego
(dostępnego) programu z wybranym strumieniem video.
.
.TP
.B \-vivo <sub-opcje> (KOD DEBUGOWANY)
Wymusza parametry audio dla demuxera VIVO (do usuwania błędów).
.
.
.
.SH "OPCJE OSD/\:NAPISÓW"
.I INFORMACJA:
Zobacz także opis \-vf expand.
.
.TP
.B \-dumpjacosub (tylko MPlayer)
Konwertuje podane (przy pomocy opcji \-sub) napisy na oparty na czasie format
JACOsub.
Tworzy w bieżącym katalogu zbiór dumpsub.js.
.
.TP
.B \-dumpmicrodvdsub (tylko MPlayer)
Konwertuje podane (przy pomocy opcji \-sub) napisy na format
MicroDVD.
Tworzy w bieżącym katalogu zbiór dumpsub.sub.
.
.TP
.B \-dumpmpsub (tylko MPlayer)
Konwertuje podane (przy pomocy opcji \-sub) napisy na format MPlayera - MPsub.
Tworzy w bieżącym katalogu zbiór dumpsub.mpsub.
.
.TP
.B \-dumpsami (tylko MPlayer)
Konwertuje podane (przy pomocy opcji \-sub) napisy na oparty na czasie format
SAMI.
Tworzy w bieżącym katalogu zbiór dumpsub.smi
.
.TP
.B \-dumpsrtsub (tylko MPlayer)
Konwertuje podane (przy pomocy opcji \-sub) napisy na oparty na czasie format
SubViewer (SRT).
Tworzy w bieżącym katalogu zbiór dumpsub.srt.
.
.TP
.B \-dumpsub (tylko MPlayer) (KOD BETA)
Zrzuca podstrumień napisów ze strumieni VOB
Zobacz także opcje \-dump*sub i \-vobsubout*.
.
.TP
.B \-ffactor <numer> (tylko OSD)
Zmienia alphamap czcionki.
Może być:
.PD 0
.RSs
.IPs 0
zwykła biała czcionka
.IPs 0.75
bardzo wąski czarny zarys (domyślnie)
.IPs 1
wąski czarny zarys
.IPs 10
pogrubiony czarny zarys
.RE
.PD 1
.
.TP
.B \-flip-hebrew (tylko z FriBiDi)
Włącza obracanie napisów przy użyciu FriBiDi
.
.TP
.B \-font <ścieżka\ do\ zbioru\ font.desc> (tylko OSD)
Szuka czcionek OSD/\:SUB w innym katalogu (domyślny dla zwykłych czcionek:
~/\:.mplayer/\:font/\:font.desc, dla czcionek FreeType:
~/\:.mplayer/\:subfont.ttf).
.br
.I INFORMACJA:
Z FreeType, ta opcja ustala ścieżkę do zbioru czcionki tekstowej.
Z fontconfig, ta opcja podaje nazwę czcionki wg fontconfig.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
\-font ~/\:.mplayer/\:arial-14/\:font.desc
.br
\-font ~/\:.mplayer/\:arialuni.ttf
.br
\-font "Bitstream Vera Sans"
.RE
.PD 1
.
.TP
.B \-fontconfig (tylko z fontconfig)
Włącza stosowanie czcionek zarządzanych przez fontconfig.
.
.TP
.B \-forcedsubsonly
Wyświetla tylko wymuszone napisy ze strumienia napisów DVD wybranego przez
np.\& \-slang.
.
.TP
.B \-fribidi-charset <nazwa\ zestawu> (tylko z FriBiDi)
Ustala zestaw znaków który zostanie przekazany do FriBiDi przy dekodowaniu
napisów w innym formacie niż UTF-8 (domyślnie ISO8859-8).
.
.TP
.B \-ifo <zbior\ ifo\ VOBsub>
Wskazuje zbiór używany do załadowania palety i wielkości ramki napisów VOBsub.
.
.TP
.B \-noautosub
Wyłącza automatyczne ładowanie napisów.
.
.TP
.B \-osdlevel <0\-3> (tylko MPlayer)
wskazuje tryb, w którym powinien włączyć się OSD
.PD 0
.RSs
.IPs 0
tylko napisy
.IPs 1
głośność + szukanie (domyślnie)
.IPs 2
głośność + szukanie + zegar + procent
.IPs 3
głośność + szukanie + zegar + procent + całkowity czas
.RE
.PD 1
.
.TP
.B \-overlapsub
Pozwala na wyświetlenie następnego napisu gdy poprzedni jest wciąż widoczny
(domyślnie włącza tylko dla niektórych formatów).
.
.TP
.B \-sid <ID> (patrz też opcja \-slang)
Włącza wyświetlanie napisów DVD w języku podanym przez <ID> (0\-31).
MPlayer wyświetli dostępne języki, jeśli jest uruchomiony w trybie
gadatliwym (\-v).
.
.TP
.B \-slang <kod\ kraju[,kod\ kraju,...]> (sprawdź teź opcję \-sid)
Określa priorytetową listę języków napisów DVD do użycia.
Języki muszą być podane jako dwuliterowe kody krajów.
MPlayer wyświetli dostępne języki, jeśli jest uruchomiony w trybie
gadatliwym (\-v).
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-slang pl,en"
Wybiera polskie napisy, a jeśli nie są dostępne to angielskie.
.RE
.PD 1
.
.TP
.B \-spuaa <tryb> (tylko z OSD)
Ustala tryb wygładzania/\:skalowania dla DVD/\:VOBsub.
Dodanie do trybu wartości 16 wymusza skalowanie nawet gdy wielkości
oryginalnego i przeskalowanego okna są takie same.
Mozna to wykorzystać by np.\& wygładzić napisy rozmyciem gaussa.
Dostępne są tryby:
.PD 0
.RSs
.IPs 0
brak (najszybszy, bardzo brzydki)
.IPs 1
przybliżony (zepsuty?)
.IPs 2
pełny (wolny)
.IPs 3
dwuliniowy (domyślny, szybki i nienajgorszy)
.IPs 4
rozmycie Gaussa (bardzo ładne)
.RE
.PD 1
.
.TP
.B \-spualign <-1\-2> (tylko OSD)
Ustala jak powinny być wyrównane napisy SPU (DVD/\:VOBsub).
.PD 0
.RSs
.IPs -1
oryginalna pozycja
.IPs 0
wyrównaj na górze (oryginalne/\:domyślne zachowanie)
.IPs 1
wyrównaj na środku
.IPs 2
wyrównaj na dole
.RE
.PD 1
.
.TP
.B \-spugauss <0.0\-3.0> (tylko OSD)
Ustawia poziom rozmycia Gaussa przy korzystaniu z \-spuaa 4.
Wyższy oznacza większe rozmycie (domyślnie: 1.0).
.
.TP
.B \-sub <zbiórnapisów1,zbiórnapisów2,...>
Używa/\:wyświetla te zbiory napisów.
Tylko jeden zbiór może wyć wyświetlany w danej chwili.
.
.TP
.B \-sub-bg-alpha <0\-255>
Ustawia wartość kanału alfa dla napisów i tła OSD.
Większe wartości oznaczają większą przezroczystość.
0 oznacza pełną przezroczystość.
.
.TP
.B \-sub-bg-color <0\-255>
Ustawia kolor tła napisów i OSD.
Obecnie napisy są w skali szarości, więc jest to odpowiednik nasycenia koloru.
Wartość 255 oznacza biel a 0 czerń.
.
.TP
.B \-sub-demuxer <numer> (tylko \-subfile) (KOD BETA)
Wymusza typ demuxera napisów dla \-subfile.
ID demuxera takie same jak zdefiniowane w zbiorze subreader.h.
.
.TP
.B \-sub-fuzziness <tryb>
Dostosowuje niedokładność dopasowywania przy szukaniu napisów:
.PD 0
.RSs
.IPs 0
dokładne dopasowanie
.IPs 1
Wczytaj wszystkie napisy zawierające nazwę filmu.
.IPs 2
Wczytaj wszystkie napisy z aktualnego katalogu.
.RE
.PD 1
.
.TP
.B \-sub-no-text-pp
Wyłącza wszelkie przetwarzanie tekstu po wczytaniu napisów.
Stosowane w celach wyłapywania błędów.
.
.TP
.B \-subalign <0\-2> (tylko OSD)
Ustala jak napisy powinny być wyrównane do \-subpos.
.PD 0
.RSs
.IPs 0
wyrównywanie górnej krawędzi (początkowe/\:domyślne zachowanie)
.IPs 1
wyrównywanie środka
.IPs 2
wyrównywanie dolnej krawędzi.
.RE
.PD 1
.
.TP
.B \-subcc \ 
Wyświetla napisy DVD Closed Caption (CC).
NIE są to napisy VOB, są to specjalne napisy ASCII dla niesłyszących
zakodowane w strumieniu danych użytkownika VOB na większości DVD z regionu 1.
Jak dotąd niespotykane na DVD z innych regionów.
.
.TP
.B \-subcp <strona\ kodowa> (tylko iconv)
Jeśli Twój system obsługuje iconv(3), możesz użyć tej opcji by ustalić stronę
kodową napisów.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
\-subcp latin2
.br
\-subcp cp1250
.RE
.PD 1
.
.TP
.B \-subcp enca:<język>:<strona powrotna> (tylko ENCA)
Określa język stosując dwuliterowy kod, by ENCA mogła wykryć
stronę kodową automatycznie.
Jeżeli nie jesteś pewien, podaj cokolwiek i przejrzyj wyjście mplayer \-v
pod kątem dostępnych języków.
Powrotna strona kodowa określa jaką stronę stosować,
jesli autodetekcja zawiedzie.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-subcp enca:cs:latin2"
Odgadnij kodowanie, zakładając że napisy są po czesku, jeżeli się nie uda,
powróć do latin 2.
.IPs "\-subcp enca:pl:cp1250"
Odgadnij kodowanie dla polskiego, jeżeli się nie uda, powróć do cp1250.
.RE
.PD 1
.
.TP
.B \-subdelay <sek>
Opóźnienie napisów o <sek> sekund.
Może być ujemne.
.
.TP
.B \-subfile <filename> (KOD BETA)
Aktualnie bezużyteczne.
To samo co \-audiofile, ale dla strumieni napisów (OggDS?).
.
.TP
.B \-subfont-autoscale <0\-3> (tylko z obsługą FreeType)
Ustawia tryb autoskalowania.
.br
.I INFORMACJA:
0 oznacza, że text scale i OSD scale są wysokością czcionki w punktach.
.sp 1
Może być:
.sp 1
.PD 0
.RSs
.IPs 0
bez automatycznego skalowania
.IPs 1
proporcjonalny do wysokości filmu
.IPs 2
proporcjonalny do szerokości filmu
.IPs 3
proporcjonalny do przekątnej filmu (domyślnie)
.RE
.PD 1
.
.TP
.B \-subfont-blur <0\-8> (tylko FreeType)
Ustawia promień rozmycia czcionki (domyślnie: 2).
.
.TP
.B \-subfont-encoding <wartość> (tylko FreeType)
Ustawia kodowanie czcionki.
Wartość "unicode" oznacza, że będą wyświetlane wszystkie znaki ze zbioru i
będzie używany unicode (domyślnie: unicode).
.
.TP
.B \-subfont-osd-scale <0\-100> (tylko FreeType)
Ustawia współczynnik automatycznego skalowania elementów OSD (domyślnie: 6).
.
.TP
.B \-subfont-outline <0\-8> (tylko FreeType)
Ustawia grubość linii zewnętrznej czcionki (domyślnie: 2)
.
.TP
.B \-subfont-text-scale <0\-100> (tylko FreeType)
Ustawia wskaźnik automatycznego skalowania napisów jako procent rozmiaru ekranu
(domyślnie: 5).
.
.TP
.B \-subfps <tempo>
Ustawia prędkość (w klatkach/\:sek) zbioru napisów (domyślnie: jak w filmie).
.br
.I INFORMACJA:
Tylko dla zbiorów opartych na klatkach tj.\& nie format MicroDVD!
.
.TP
.B \-subpos <0\-100> (przydatne przy \-vf expand) (tylko z OSD)
Ustawia pozycję napisów na ekranie.
Jest to pozioma pozycja napisów w % wysokości ekranu.
.
.TP
.B \-subwidth <10\-100> (tylko z OSD)
Określa maksymalną szerokość napisów na ekranie.
Przydatne przy wyjściu TV.
Jest to szerokość napisów w % szerokości ekranu.
.
.TP
.B \-unicode
Informuje MPlayera by przetwarzał zbiór napisów jako unicode.
.
.TP
.B \-utf8 \ \ 
Informuje MPlayera by przetwarzał zbiór napisów jako UTF-8.
.
.TP
.B \-vobsub <zbiór\ VOBsub\ bez\ rozszerzenia>
Określa zbiory VOBsub z napisami.
Jest to pełna ścieżka do zbioru bez rozszerzenia, tj.\& bez ".idx", ".ifo" lub
".sub".
.
.TP
.B \-vobsubid <0\-31>
Określa ID napisów VOBsub.
.
.
.
.SH "OPCJE WYJŚCIA AUDIO (TYLKO MPLAYER)"
.
.TP
.B \-abs <wartość> (tylko \-ao oss) (PRZESTARZAŁE)
Zmienia wykrytą wielkość bufora sterownika audio/\:karty.
.
.TP
.B \-aofile <nazwa\ zbioru>
Zmienia domyślną nazwę zbioru dla \-ao pcm.
.
.TP
.B \-aop <list=wtyczka1,wtyczka2...:opcja1=wartość1:opcja2=wartość2...>
Określ wtyczki audio i ich opcje
(sprawdź również rozdział dokumentacji traktujący o wtyczkach audio).
.sp 1
Dostępne są opcje:
.RSs
.IPs list=[wtyczki]
oddzielona przecinkami lista wtyczek (resample, surround, format, volume,
extrastereo, volnorm, delay)
.IPs delay=<sek>
przykładowa wtyczka, nie używaj jej (tylko wtyczka delay)
.IPs format=<format>
format danych wyjściowych (tylko wtyczka format)
.IPs fout=<Hz>
częstotliwość danych wyjściowych (tylko wtyczka resample)
.IPs volume=<0\-255>
głośność (tylko wtyczka volume)
.IPs mul=<wartość>
współczynnik stereo, domyślnie: 2.5 (tylko wtyczka extrastereo)
.IPs softclip
włącza kompresję / "miękkie obcinanie (soft-clipping)" (tylko wtyczka volume)
.RE
.
.TP
.B \-delay <sekundy>
Ustawia opóźnienie dźwięku w sekundach (dodatnia lub ujemna liczba rzeczywista).
.
.TP
.B \-format <0\-8192>
Wybiera format używany przez wyjście warstwy filtrującej
(zgodnie z definicjami w libao2/\:afmt.h):
.PD 0
.RSs
.IPs 1
Mu-Law
.IPs 2
A-Law
.IPs 4
Ima-ADPCM
.IPs 8
8-bit bez znaku
.IPs 16
16-bit (little-endian) ze znakiem 
.IPs 32
16-bit (big-endian) ze znakiem
.IPs 64
8-bit ze znakiem
.IPs 128
16-bit (little-endian) bez znaku
.IPs 256
16-bit (big-endian) bez znaku
.IPs 512
MPEG (2) Audio
.IPs 1024
AC3
.IPs 4096
32-bit (little-endian) ze znakiem
.IPs 8192
32-bit (big-endian) ze znakiem
.RE
.PD 1
.
.TP
.B \-mixer <urządzenie>
Korzysta z miksera innego niż domyślny /dev/\:mixer.
Przy ALSA jest to nazwa miksera.
.
.TP
.B \-mixer-channel <linia miksera> (tylko \-ao oss i \-ao alsa)
Ta opcja mówi MPlayerowi, żeby użył innego kanału do sterowania głośnością niż
domyślne PCM.
Część możliwości dla OSS to
.B vol, pcm, line.
Żeby znaleźć pełną listę możliwości poszukaj SOUND_DEVICE_NAMES w
/usr/\:include/\:linux/\:soundcard.h.
Dla ALSA możesz użyć nazw, które, na przykład, pokazuje alsamixer, jak
.B Master, Line, PCM.
.
.TP
.B \-nowaveheader (tylko \-ao pcm)
Nie dołącza nagłówków wave.
Używany przy surowym PCM.
.
.TP
.B \-volstep <0\-100>
Ustala wielkość zmiany przy ustawianiu poziomu dźwięku miksera (w procentach
całego zakresu) (domyślnie: 3).
.
.
.
.SH "STEROWNIKI WYJŚCIOWE DŹWIĘKU (TYLKO MPLAYER)"
Sterowniki wyjścia dźwięku to interfejsy do różnych urządzeń wyjściowych
audio.
Składnia jest następująca:
.
.TP
.B \-ao <sterownik1[:podopcja1[=wartość]:...],sterownik2,...[,]>
Określa prirytetową listę sterowników wyjścia audio.
.PP
Jeżeli lista kończy się przecinkiem, MPlayer powróci do sterowników
niezawartych w wierszu poleceń.
Podopcje są opcjonalne i przeważnie mogą być pominięte.
.br
.I INFORMACJA:
Opcja \-vo help pokaże listę wkompilowanych sterowników wyjścia audio.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-ao alsa,oss,"
Spróbuje użyć sterownika ALSA, później OSS a potem pozostałych.
.IPs "\-ao alsa:mmap:noblock:device=hw=0.3"
Ustawia tryb noblock, tryb mmap-mode i nazwę urządzenia jako pierwsza karta,
czwarte urządzenie
.RE
.PD 1
.sp 1
Dostępne sterowniki wyjściowe audio:
.
.TP
.B alsa\ \ \ 
Sterownik ALSA 0.9/\:1.x.
.PD 0
.RSs
.IPs mmap\ \ \ 
Ustawia eksperymentalny tryb mmap (mmap-mode) (nie działa dla więcej niż 2 kanałów).
.IPs noblock
Ustawia tryb noblock (noblock-mode).
.IPs device=<urządzenie>
Ustawia nazwę urządzenia.
Zamiast "," w nazwie urządzenia ALSA wstaw ".", a zamiast ":" wstaw "=".
.RE
.PD 1
.
.TP
.B alsa1x (PRZESTARZAŁE)
sterownik ALSA 1.x
Zastąpiony przez ogólny sterownik alsa.
.
.TP
.B alsa9 (PRZESTARZAŁE)
sterownik ALSA 0.9
Zastąpiony przez ogólny sterownik alsa.
.
.TP
.B alsa5\ \ 
sterownik ALSA 0.5
.
.TP
.B oss\ \ \ \ 
Sterownik OSS
.PD 0
.RSs
.IPs dsp-device
Ustawia urządzenie wyjściowe dźwięku (domyślnie: /dev/\:dsp).
.RE
.PD 1
.
.TP
.B sdl\ \ \ \ 
Sterownik dla biblioteki wysoce niezależnej od platformy - SDL (Simple
Directmedia Layer).
.PD 0
.RSs
.IPs <sterownik>
Określa, jaki sterownik dźwięku ma zostać użyty przez SDL (domyślnie: SDL wybiera).
.RE
.PD 1
.
.TP
.B arts\ \ \ 
Przekazuje dźwięk przez demona Arts.
.
.TP
.B esd\ \ \ \ 
Przekazuje dźwięk przez demona ESD.
.PD 0
.RSs
.IPs <serwer>
Określa jaki serwer SDL ma zostać użyty (domyślnie: localhost).
.RE
.PD 1

.
.TP
.B jack\ \ \ \ 
Przekazuje dźwięk przez JACK (Jack Audio Connection Kit).
.
.TP
.B nas\ \ \ \ 
Przekazuje dźwięk przez NAS.
.
.TP
.B macosx (tylko Mac OS X)
Rdzenny sterownik Mac OS X.
.
.TP
.B sgi (tylko SGI)
Rdzenny sterownik SGI.
.
.TP
.B sun (tylko Sun)
Rdzenny sterownik Sun.
.PD 0
.RSs
.IPs <urządzenie>
Określa, jakie urządzenie audio ma zostać użyte (domyślnie: /dev/\:audio).
.RE
.PD 1
.
.TP
.B win32 (tylko Windows)
Rdzenny sterownik waveout Windows.
.
.TP
.B dxr2 (patrz też \-dxr2) (tylko DXR2)
Specyficzny sterownik Creative DXR2.
.
.TP
.B mpegpes (tylko DVB)
Specyficzny sterownik DVB.
.
.TP
.B null\ \ \ 
Nie przekazuje dźwięku, ale utrzymuje prędkość odtwarzania video.
Do testów wydajnościowych użyj \-nosound.
.
.TP
.B pcm (sprawdź również \-aofile)
Sterownik wyjściowy zapisujący dane w surowych (raw) plikach PCM/\:wave.
Zapisuje dźwięk do ./audiodump.wav.
.
.TP
.B plugin\ \ 
Sterownik wyjściowy wtyczki.
.
.
.
.SH "OPCJE WYJŚCIA VIDEO (TYLKO MPLAYER)"
.
.TP
.B \-aa* (tylko \-vo aa)
Możesz otrzymać listę oraz wyjaśnienia dostępnych opcji wykonując
.I mplayer \-aahelp
.
.TP
.B \-adapter <wartość>
Ustawia kartę graficzną, która otrzyma obraz.
Do poprawnego działania wymaga opcji \-vm.
Listę dostępnych kart otrzymasz stosując tę opcję z \-v.
Obecnie działa tylko z \-vo directx.
.
.TP
.B \-bpp <głębia>
Wymusza inną głębię kolorów niż wykryta.
Obsługiwane tylko przez sterowniki wyjścia video fbdev, dga, svga i vesa.
.
.TP
.B \-brightness <-100\-100>
Modyfikuje jasność wyjścia video (domyślnie: 0).
Nie wszystkie sterowniki wyjścia video to obsługują.
.
.TP
.B \-contrast <-100\-100>
Modyfikuje kontrast wyjścia video (domyślnie: 0).
Nie wszystkie sterowniki wyjścia video to obsługują.
.
.TP
.B \-dfbopts <wartość> (tylko \-vo directfb2)
Określa listę parametrów dla sterownika wyjścia video directfb.
.
.TP
.B \-display <nazwa> (tylko X11)
Podaje nazwę komputera i numer wyświetlacza serwera X, na którym chcesz
wyświetlać.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
\-display  xtest.localdomain:0
.RE
.PD 1
.
.TP
.B \-double
Włącz podwójne buforowanie.
Eliminuje migotanie dzięki przechowywaniu dwóch ramek w pamięci i wyświetlaniu
jednej, podczas gdy druga jest dekodowana.
Może mieć negatywny wpływ na OSD, ale często usuwa jego migotanie.
Potrzebuje dwukrotnie więcej pamięci, niż pojedynczy bufor, więc nie
będzie działać na kartach z bardzo małą pamięcią video.
.
.TP
.B \-dr \ \ \ 
Włącz bezpośrednie renderowanie (obsługiwane nie przez wszystkie kodeki i
wyjścia video)
.br
.I UWAGA:
Może powodować popsucie OSD/\:SUB!
.
.TP
.B \-dxr2 <opcja1:opcja2:...>
Ta opcja jest używana do kontroli sterownika wyjścia video dxr2.
.RSs
.IPs ar-mode=<wartość>
tryb proporcji (aspect ratio) (0 = normalny, 1 = panoramiczny, 2 = letterbox (domyślnie))
.IPs iec958-encoded
Ustawia tryb wyjścia iec958 na zakodowany.
.IPs iec958-decoded
Ustawia tryb wyjścia iec958 na zdekodowany (domyślne).
.IPs macrovision=<wartość>
tryb macrovision (0 = wyłączone (domyślnie), 1 = agc, 2 = agc 2 colorstripe
3 = agc 4 colorstripe)
.IPs mute\ 
wycisza dźwięk
.IPs unmute
wyłącza wyciszenie dźwięku
.IPs ucode=<wartość>
ścieżka do microcode
.RE
.RS
.sp 1
.I wyjście TV
.RE
.RSs
.IPs 75ire
włącza wyjście 7.5 IRE
.IPs no75ire
wyłącza wyjście 7.5 IRE (domyślne)
.IPs bw\ \ \ 
czarno/\:białe wyjście TV
.IPs color
kolorowe wyjście TV (domyślne)
.IPs interlaced
włącza wyjście TV z przeplotem (domyślne)
.IPs nointerlaced
wyłącza wyjście TV z przeplotem
.IPs norm=<wartość>
norma TV (ntsc (domyślna), pal, pal60, palm, paln, palnc)
.IPs square-pixel
ustawia tryb kwadratowy piksela
.IPs ccir601-pixel
ustawia tryb ccir601 piksela
.RE
.RS
.sp 1
.I nakładka (Overlay)
.RE
.RSs
.IPs cr-left=<0\-500>
Ustawia wartość obcinania z lewej (domyślnie: 50).
.IPs cr-right=<0\-500>
Ustawia wartość obcinania z prawej (domyślnie: 300).
.IPs cr-top=<0\-500>
Ustawia wartość obcinania z góry (domyślnie: 0).
.IPs cr-bottom=<0\-500>
Ustawia wartość obcinania z dołu (domyślnie: 0).
.IPs ck-[r|g|b]=<0\-255>
Ustawia czerwony (r), zielony (g) lub niebieski (b) kolor klucza nakładki.
.IPs ck-[r|g|b]min=<0\-255>
minimalna wartość odpowiedniego klucza koloru
.IPs ck-[r|g|b]max=<0\-255>
maksymalna wartość odpowiedniego klucza koloru
.IPs ignore-cache
Nie używa zapamiętanych ustawień nakładki.
.IPs update-cache
Uaktualnia zapisane ustawienia nakładki.
.IPs ol-osd
Włącza osd w nakładce.
.IPs nool-osd
Wyłącza osd w nakładce (domyślne).
.IPs ol[h|w|x|y]-cor=<-20\-20>
Modyfikuje rozmiar (h,w) i pozycję (x,y) nakładki w przypadku gdy nie pasuje
ona do okna (domyślnie: 0).
.IPs overlay
Włącza nakładkę (domyślne)
.IPs nooverlay
Włącza TVout.
.IPs overlay-ratio=<1\-2500>
Dostosowuje nakładkę (domyślnie 1000).
.RE
.
.TP
.B \-fb <urządzenie> (tylko fbdev lub DirectFB) (PRZESTARZAŁE)
Określa urządzenie bufora ramek (framebuffer).
Domyślnie używany jest /dev/\:fb0.
.
.TP
.B \-fbmode <nazwa\ trybu> (tylko fbdev)
Zmienia tryb video na opisany etykietą <nazwa trybu> w /etc/\:fb.modes.
.br
.I INFORMACJA:
Bufor ramek VESA nie obsługuje zmieniania trybu.
.
.TP
.B \-fbmodeconfig <nazwa\ zbioru> (tylko \-vo fbdev)
Używa podanego zbioru konfiguracyjnego (domyślnie: /etc/\:fb.modes).
.
.TP
.B \-forcexv (tylko \-vo sdl)
Wymusza używanie XVideo poprzez sterownik wyjścia video sdl.
.
.TP
.B \-fs (patrz też \-zoom)
Odtwarzanie pełnoekranowe (film w centrum i czarne obramowanie wokół niego).
Nie wszystkie sterowniki wyjścia video to obsługują.
.
.TP
.B \-fsmode-dontuse <0\-31> (PRZESTARZAŁE, używaj opcji \-fs)
Wypróbuj tę opcję, jeżeli masz problemy z trybem pełnoekranowym.
.
.TP
.B \-fstype <typ1,typ2,...>
Określa priorytetową listę trybów ustawień używanej warstwy pełnoekranowej.
Możesz wyłączyć tryb poprzedzając go "\-".
Jeśli masz kłopoty typu okno pełnoekranowe jest przykryte przez inne okna
wypróbuj inną kolejność.
.br
.I INFORMACJA:
\-fstype help wyświetla pełną listę dostępnych trybów.
.sp 1
Dostępne są typy:
.sp 1
.PD 0
.RSs
.IPs above
Używa zalecenia _NETWM_STATE_ABOVE jeśli jest to możliwe.
.IPs below
Używa zalecenia _NETWM_STATE_BELOW jeśli jest to możliwe.
.IPs fullscreen
Używa zalecenia _NETWM_STATE_FULLSCREEN jeśli jest to możliwe.
.IPs layer
Używa zalecenia _WIN_LAYER z domyślną warstwą.
.IPs layer=<0..15>
Używa zalecenia _WIN_LAYER z numerem warstwy.
.IPs netwm
Wymusza styl NETWM.
.IPs none\ 
Nie używa warstwy pełnoekranowej.
.IPs stays_on_top
Używa zalecenia _NETWM_STATE_STAYS_ON_TOP jeśli jest to możliwe.
.REss
.sp 1
.RS
.I PRZYKŁAD:
.RE
.PD 0
.RSs
.ISs layer,stays_on_top,above,fullscreen
Domyślna kolejność, będzie użyta w przypadku podania nieprawidłowych lub
nieobsługiwanych typów.
.IPs \-fullscreen
Naprawia przełączanie pełnego ekrany na OpenBox 1.x.
.RE
.PD 1
.
.TP
.B \-geometry x[%][:y[%]] lub [WxH][+x+y]
Ustawia gdzie na ekranie ma się początkowo znajdować wyjście.
Wielkości x i y mierzone są w pikselach od lewego górnego rogu ekranu do
lewego górnego rogu wyświetlanego obrazu, jeżeli jednak po argumencie podany
jest procent, to jest on traktowany jak procent wielkości ekranu w danym
kierunku.
Obsługuje to także standardowy format opcji \-geometry z X11.
.br
.I INFORMACJA:
Ta opcja jest obsługiwana tylko przez sterowniki wyjścia video x11, xmga, xv,
xvmc, xvidix, directx i tdfxfb.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs 50:40
Umieszcza okno w x=50, y=40
.IPs 50%:50%
Umieszcza okno na środku ekranu
.IPs 100%\ 
Umieszcza okno w śroku prawej krawędzi ekranu
.IPs 100%:100%
Umieszcza okno w prawym dolnym rogu ekranu
.RE
.PD 1
.
.TP
.B \-guiwid <ID\ okna> (patrz też \-wid) (tylko z GUI)
Przekazuje do GUI, że ma ono również używać okna X11 i przykleić je na dole
ekranu video, co jest przydatne by osadzić mini-GUI w przeglądarce
(używającej na przykład wtyczki MPlayer).
.
.TP
.B \-hue <-100\-100>
Modyfikuje barwę sygnału video (domyślnie 0).
Dzięki tej opcji możesz otrzymać kolorowy negatyw obrazu.
Nie wszystkie sterowniki wyjścia video to obsługują.
.
.TP
.B \-monitor-dotclock <zakres[,zakres,...]> (tylko \-vo fbdev i vesa)
Określa zakres dotclock lub pixelclock monitora.
.
.TP
.B \-monitor-hfreq <zakres[,zakres,...]> (tylko \-vo fbdev i vesa)
Określa zakres częstotliwości poziomej monitora.
.
.TP
.B \-monitor-vfreq <zakres[,zakres,...]> (tylko \-vo fbdev i vesa)
Określa zakres częstotliwości pionowej monitora.
.
.TP
.B \-monitoraspect <stosunek> (patrz też \-aspect)
Ustawia proporcje Twojego monitora lub ekranu TV.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
\-monitoraspect 4:3  lub 1.3333
.br
\-monitoraspect 16:9 lub 1.7777
.RE
.PD 1
.
.TP
.B \-nograbpointer
Nie przechwytuje kursora muszki po zmianie trybu video (\-vm).
Przydatne przy ustawieniach wieloekranowych.
.
.TP
.B \-nokeepaspect
Nie utrzymuje proporcji, gdy zmieniany jest rozmiar okna.
Działa obecnie tylko ze sterownikami wyjścia video x11, xv, xmga, xvidix oraz
directx.
Dodatkowo, pod X11 Twój manager okien musi rozumieć zalecenia proporcji okna.
.
.TP
.B \-noxv (tylko \-vo sdl)
Wyłącza używanie XVideo poprzez sterownik wyjścia video sdl.
.
.TP
.B \-ontop\ 
Sprawia, że okno zostaje nad innymi oknami.
Obsługiwane przez sterowniki wyjścia video używające X11, poza SDL
oraz directx i gl2 pod Windows.
.
.TP
.B \-panscan <0.0\-1.0>
Włącza tryb panoramiczny (obcina boki filmu np.\& 16:9 tak, by pasował na
ekran 4:3 bez czarnych pasków).
Zasięg kontroluje jak duża część obrazu będzie przycięta.
Działa tylko ze sterownikami wyjścia video xv, xmga, mga i xvidix.
.
.TP
.B \-refreshrate <Hz>
Ustawia częstotliwość odświeżania monitora.
Obecnie opcja ta jest obsługiwana tylko przez \-vo directx razem z \-vm.
.
.TP
.B \-rootwin
Odtwarza film w głównym oknie (tło pulpitu).
Jednak obrazki tła na pulpicie mogą przesłaniać okno filmu.
Działa tylko ze sterownikami wyjścia video x11, xv, xmga, xvidix, quartz i directx.
.
.TP
.B \-saturation <-100\-100>
Modyfikuje nasycenie sygnału wyjścia video (domyślnie: 0).
Dzięki tej opcji można uzyskać obraz w skali szarości.
Nie wszystkie sterowniki wyjścia video to obsługują.
.
.TP
.B \-screenh <piksele>
Podaje pionową rozdzielczość ekranu dla sterowników wyjścia video które nie
znają rozdzielczości ekranu, jak fbdev, x11 i TVout.
.
.TP
.B \-screenw <piksele>
Podaje poziomą rozdzielczość ekranu dla sterowników wyjścia video które nie
znają rozdzielczości ekranu, jak fbdev, x11 i TVout.
.
.TP
.B \-stop-xscreensaver (tylko X11)
Wyłącza wygaszacz ekranu przy starcie i włącza go ponownie podczas wychodzenia.
.
.TP
.B \-vm \ \ \ 
Próbuje zmienić na inny tryb video.
Obsługiwane przez sterowniki wyjścia video dga, x11, xv, sdl i directx.
Jeżeli jest ona użyta ze sterownikiem wyjścia video directx, opcje \-screenw,
\-screenh, \-bpp i \-refreshrate mogą ustawić nowy tryb wyświetlania.
.
.TP
.B \-vsync \ \ 
Włącza VBI dla sterowników wyjścia video vesa, dfbmga i svga.
.
.TP
.B \-wid <ID\ okna>] (tylko X11)
Przekazuje MPlayerow, bt dołączył się do instniejącego okna X11.
Przydatne, by osadzić MPlayera w przeglądarce (na przykład za pomocą wtyczki).
.
.TP
.B \-xineramascreen <0\-...>
W konfiguracjach Xinerama (tj.\& pojedynczy pulpit obejmujący wiele ekranów)
opcja ta przekaże MPlayerowi na którym ekranie ma wyświetlać film.
.
.TP
.B \-z <0\-9> (tylko \-vo png)
Podaje poziom kompresji dla sterownika wyjścia video png.
0 to brak kompresji, 9 to maksymalna kompresja.
.
.TP
.B \-zrbw (tylko \-vo zr)
Wyświetla czarno-biały obraz.
Dla optymalnego działania opcja ta może być łączona z "\-lavdopts gray".
.
.TP
.B \-zrcrop <[szerokość]x[wyskokość]+[x offset]+[y offset]> (tylko \-vo zr)
Wybiera partie obrazu wejściowego do odtwarzania, wielokrotne wystąpienie tej
opcji włącza tryb cinerama.
W trybie cinerama film jest rozdzielany na więcej niż jeden TV (lub rzutnik)
by stworzyć duży ekran.
Opcje pojawiające się po zastosowaniu n-tego \-zrcrop dotyczą n-tej karty
MJPEG, z których każda powinna mieć co najmniej \-zrdev poza \-zrcrop.
Przykłady są w sekcji Zr dokumentacji oraz są pokazywane przez opcję \-zrhelp.
.
.TP
.B \-zrdev <urządzenie> (tylko \-vo zr)
Określa zbiór urządzenia należący do Twojej karty MJPEG, domyślnie sterownik
ten bierze pierwsze urządzenie v4l które znajdzie.
.
.TP
.B \-zrfd (tylko \-vo zr)
Wymusza dziesiątkowanie (decimation): Dziesiątkowanie, określone przez \-zrhdec
i \-zrvdec, następuje tylko, gdy sprzęt skalujący potrafi rozciągnąć obraz do
jego oryginalnych rozmiarów.
Ta opcja wymusza dziesiątkowania.
.
.TP
.B \-zrhdec <1,2,4> (tylko \-vo zr)
Poziome dziesiątkowanie (decimation): Informuje sterownik by przekazywał tylko
co 2-gą lub 4-tą linię/\:piksel obrazu do karty MJPEG i użył urządzenia
skalującego karty do rozciągnięcia obrazu do jego oryginalnych rozmiarów.
.
.TP
.B \-zrhelp (tylko \-vo zr)
Wyświetla listę wszystkich opcji \-zr*, ich domyślną wartość oraz przykład
trybu cinerama.
.
.TP
.B \-zrnorm <norma> (tylko \-vo zr)
Wybiera normę TV PAL lub NTSC (domyślnie: nie zmieniać).
.
.TP
.B \-zrquality <1\-20> (tylko \-vo zr)
Liczba od 1 (najlepsza) do 20 (najgorsza) określająca jakość kodowania JPEG.
.
.TP
.B \-zrvdec <1,2,4> (tylko \-vo zr)
Pionowe dziesiątkowanie (decimation): Informuje sterownik by przekazywał tylko
co 2-gą lub 4-tą linię/\:piksel obrazu do karty MJPEG i użył urządzenia
skalującego karty do rozciągnięcia obrazu do jego oryginalnych rozmiarów.
.
.TP
.B \-zrxdoff <przesunięcie w osi x> (tylko \-vo zr)
Jeśli film jest mniejszy niż ekran opcja ta określa przesunięcie w poziomie
od lewego górnego rogu ekranu (domyślnie: obraz wycentrowany).
.
.TP
.B \-zrydoff <przesunięcie w osi y> (tylko \-vo zr)
Jeśli film jest mniejszy niż ekran opcja ta określa przesunięcie w pionie
od lewego górnego rogu ekranu (domyślnie: obraz wycentrowany).
.
.
.
.SH "STEROWNIKI WYJŚCIA VIDEO (TYLKO MPLAYER)"
Sterowniki wyjścia video to interfejsy do różnych urządzeń wyjściowych video.
Składnia jest następująca:
.
.TP
.B \-vo <sterownik1[:podopcja1[=wartość]:...],sterownik2,...[,]>
Określa priorytetową listę sterowników wyjścia video.
.PP
Jeżeli lista zakończona jest przecinkiem, MPlayer powróci do sterowników
niewymienionych w wierszu poleceń.
Podopcje są dodatkowe i przeważnie mogą być pominięte.
.br
.I INFORMACJA:
Opcja \-vo help pokaże listę wkompilowanych sterowników wyjścia video.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-vo xmga,xv,"
Najpierw spróbuj wykorzystać sterownik Matrox X11, później Xv i na końcu resztę.
.IPs "\-vo directx:noaccel"
Wykoszysta sterownik DirectX z wyłączonymi funkcjami przyspieszającymi.
.RE
.PD 1
.sp 1
Dostępne sterowniki wyjściowe:
.
.TP
.B xv (tylko X11)
Wykorzystuje rozszerzenie XVideo oferowane przez XFree86 4.x, aby włączyć
sprzętową akcelerację odtwarzania.
Jeżeli nie możesz skorzystać ze sterownika napisanego specjalnie dla Twojego sprzętu,
to prawdopodobnie jest najlepsza opcja.
.PD 0
.RSs
.IPs port=<numer>
Określa port XVideo.
.RE
.PD 1
.
.TP
.B x11 (tylko X11)
Sterownik wyjścia video z pamięcią dzieloną, bez sprzętowej akceleracji,
który działa gdziekolwiek, jeżeli tylko obecne jest X11.
.
.TP
.B xover (tylko X11)
Dodaje obsługę X11 dla wszystkich sterowników opartych o overlay.
Obecnie użyteczne tylko z tdfx_vid.
.PD 0
.RSs
.IPs <sterownik_vo>
Wybiera sterownik, którego należy użyć jako nakładki na X11.
.RE
.PD 1
.
.TP
.B xvmc (tylko X11, \-vc ffmpeg12mc)
Sterownik wyjścia video, który korzysta z rozszerzenia XvMC (X Video Motion
Compensation) oferowanego przez XFree86 4.x, aby przyspieszyć dekodowanie
MPEG1/\:2 i VCR2.
.PD 0
.RSs
.IPs benchmark
Nie wyświetla obrazów.
Konieczne dla prawidłowego testowania wydajności dla sterowników, które
zmieniają bufor obrazu tylko przy przerysowywaniu monitoru (nVidia).
.IPs queue
Kolejkuje ramki do wyświetlenia, aby umożliwić bardziej równoległą pracę
urządzenia video.
Może spowodować małą (nie zauważalną) stałą desynchronizację A/\:V.
.IPs sleep
Wykorzystuje funkcję sleep podczas czekania na zakończenie renderowania
(niezalecane na Linuksie).
.IPs wait\ 
Nie korzysta z funkcji sleep podczas czekania na zakończenie renderowania
(domyślne).
.RE
.PD 1
.
.TP
.B dga (tylko X11)
Odtwarza video korzystając z rozszerzenia XFree86 Direct Graphics Access.
Uważany za przeżytek.
.
.TP
.B sdl (tylko SDL) (patrz też \-forcexc, \-noxv)
Sterownik wyjścia oparty na wysoce niezależnej od platformy bibliotece SDL
(Simple Directmedia Layer).
Ponieważ SDL używa własnej warstwy X11, opcje MPlayera dotyczące X11 nie mają
tu żadnego wpływu.
.PD 0
.RSs
.IPs <sterownik>
Wybiera używany sterownik SDL.
.RE
.PD 1
.
.TP
.B vidix\ \ 
VIDIX (VIDeo Interface for *niX - interfejs video dla *niX) to interfejs do
możliwości przyspieszających w różnych kartach graficznych.
Bardzo szybki sterownik wyjścia video na kartach, które go obsługują.
.PD 0
.RSs
.IPs <podurządzenie>
Precyzuje, który sterownik VIDIX ma być wykorzystany.
Dostępne są cyberblade_vid, mach64_vid, mga_crtc2_vid,
mga_vid, nvidia_vid, pm3_vid, radeon_vid, rage128_vid i sis_vid.
.RE
.PD 1
.
.TP
.B xvidix (tylko X11)
Nakładka X11 dla VIDIX
.PD 0
.RSs
.IPs <podurządzenie>
podobnie jak dla vidix
.RE
.PD 1
.
.TP
.B cvidix\ 
Standardowa i niezależna od platformy nakładka dla VIDIX, może nawet chodzić w
konsoli tekstowej z kartami nVidia.
.PD 0
.RSs
.IPs <podurządzenie>
podobnie jak dla vidix
.RE
.PD 1
.
.TP
.B winvidix (tylko Windows)
Nakładka Windows dla VIDIX
.PD 0
.RSs
.IPs <podurządzenie>
jak dla vidix
.RE
.PD 1
.
.TP
.B directx (tylko Windows)
Sterownik wyjścia video korzystający z interfejsu DirectX.
.PD 0
.RSs
.IPs noaccel
Wyłącza sprzętową akcelerację.
Wypróbuj tę opcję, jeżeli masz problemy z wyświetlaniem.
.RE
.PD 1
.
.TP
.B quartz (tylko Mac OS X)
Sterownik wyjścia video Mac OS X Quartz.
W pewnych przypadkach, wydajniejsze może się okazać wymuszenie spakowanego
formatu wyjściowego YUV, podając np.\& \-vf format=yuy2.
.PD 0
.RSs
.IPs device_id=<numer>
Określa jakie urządzenia ma być użyte w trybie pełnoekranowym.
.RE
.PD 1
.
.TP
.B fbdev (tylko Linux)
Używa bufora ramki oferowanego przez jądro do wyświetlania obrazu.
.PD 0
.RSs
.IPs <urządzenie>
Wybiera nazwę używanego urządzenia fbdev (np.\& /dev/\:fb0) albo nazwę
podurządzenia vidix jeśli nazwa zaczyna się od vidix (np.\& vidixsis_vid włącza
sterownik sis).
.RE
.PD 1
.
.TP
.B fbdev2 (tylko Linux)
Używa bufora ramki oferowanego przez jądro do wyświetlania obrazu,
alternatywna implementacja.
.PD 0
.RSs
.IPs <urządzenie>
Wybiera nazwę używanego urządzenia fbdev (domyślnie: /dev/\:fb0).
.RE
.PD 1
.
.TP
.B vesa\ \ \ 
Bardzo ogólny sterownik wyjścia video , który powinien działać z wszystkimi
kartami obsługującymi standard VESA VBE 2.0.
.PD 0
.RSs
.IPs dga\ \ 
Włącza tryb DGA.
.IPs nodga
Wyłącza tryb DGA.
.IPs neotv_pal
Włącza wyjście TV karty NeoMagic i ustawia je na normę PAL.
.IPs neotv_ntsc
Włącza wyjście TV karty NeoMagic i ustawia je na normę NTSC.
.IPs vidix
Używa sterownika VIDIX.
.IPs lvo:\ \ 
Włącza Linux Video Overlay na trybie vesa.
.RE
.PD 1
.
.TP
.B svga\ \ \ 
Sterownik wyjścia video korzystający z biblioteki SVGA.
.PD 0
.RSs
.IPs "<tryb video>"
Ustawia określony tryb video.
Tryb może być podany w formacie <szerokość>x<wysokość>x<kolory>,
np.\& 640x480x16M lub numer trybu graficznego, np.\& 84.
.IPs bbosd
Rysuje OSD w czarnym pasku poniżej filmu (wolniejsze).
.IPs native
Wykorzystuje tylko rdzenne funkcje rysujące.
Omijane jest bezpośrednie renderowanie (direct rendering), OSD i
akceleracja sprzętowa.
.IPs retrace
Wymusza zmieanę klatki przy przerysowywaniu pionowym.
Użyteczne tylko z \-double.
Wywołuje ten sam efekt co opcja \-vsync.
.IPs sq\ \ \ 
Spróbuje wykorzystać tryb video z kwadratowymi pikselami.
.IPs vidix
Używa svga z VIDIX.
.RE
.PD 1
.
.TP
.B gl\ \ \ \ \ 
Sterownik wyjścia video OpenGL.
Bardzo prosta wersja, nie obsługuje OSD i obraz musi być mniejszy niż
maksymalny rozmiar tekstury dostępny w Twojej implementacji OpenGL.
Zamiarem było działanie na nawet najprostszych implementacjach OpenGL.
.PD 0
.RSs
.IPs (no)manyfmts
Włącza obsługę większej ilości formatów kolorów (RGB i BGR).
Wymaga wersji OpenGL >= 1.2, JESZCZE NIE DZIAŁA poprawnie.
.IPs slice-height=<0\-...>
Ilość lini kopiowana do tekstury w jednym kawałku (domyślnie: 4).
0 oznacza cały obraz.
.RE
.PD 1
.
.TP
.B gl2\ \ \ \ 
Sterownik wyjścia video OpenGL, druga generacja.
Obsługuje OSD i obrazy większe niż maksymalny rozmiar tekstury.
.
.TP
.B null\ \ \ 
Nie tworzy danych wyjściowych video.
Użyteczne dla testowania wydajności.
.
.TP
.B aa (patrz też \-aa*)
Sterownik wyjścia video ASCII art, który działa na konsoli tekstowej.
.
.TP
.B caca\ \ \ 
Sterownik wyjścia video Colour AsCii Art, który działa na konsoli tekstowej.
.
.TP
.B bl\ \ \ \ \ 
Odtwarzanie video przy użyciu protokołu Blinkenlights UDP.
Sterownik jest wysoce zależny od sprzętu.
.PD 0
.RSs
.IPs <podurządzenie>
Wybiera używane podurządzenie Blinkenlights.
Jest to coś typu arcade:host=localhost:2323 lub hdl:file=nazwa1,file=nazwa2.
Musisz podać podurządzenie.
.RE
.PD 1
.
.TP
.B ggi\ \ \ \ 
Sterownik wyjścia video dla systemu grafiki GGI.
.PD 0
.RSs
.IPs <sterownik>
Wybiera używany sterownik GGI.
.RE
.PD 1
.
.TP
.B directfb
Odtwarza video korzystając z biblioteki DirectFB.
.PD 0
.RSs
.IPs (no)input
Korzysta z kodu klawiszy DirectFB zamiast MPlayera (domyślnie: włączone).
.IPs buffermode=single|double|triple
Podwójne i potrójne buforowanie dają najlepsze efekty, jeżeli chcesz uniknąć
problemów z rozrywaniem.
Potrójny bufor jest wydajniejszy niż podwójny, jako że nie blokuje
MPlayera w trakcie czekania na przerysowanie w pionie.
Nie powinno się korzystać z pojedynczego buforowanie (domyślnie: pojedynczy).
.IPs fieldparity=top|bottom
Kontroluje kolejność wyjścia dla ramek z przeplotem (domyślnie: wyłączony).
Poprawnymi wartościami są top = najpierw górne pola, bottom = najpierw dolne
pola.
Opcja ta nie ma żadnego wpływu na progresywny materiał filmowy (większość
filmów MPEG).
Musisz włączyć tę opcję, jeżeli masz problemy z rozrywaniem/\:brakiem płynności
ruchów podczas oglądania materiału z przeplotem.
.IPs layer=N
Wymusi wybranie warstwy o ID N do odtwarzania (domyślnie: -1 - auto).
.RE
.PD 1
.
.TP
.B dfbmga\ 
Sterownik wyjścia video przeznaczony dla kart Matrox G400/\:G450/\:G550,
wykorzystujący bibliotekę DirectFB.
Włącza CRTC2 (drugi monitor), wyświetlając obraz niezależnie od pierwszego.
.PD 0
.RSs
.IPs (no)bes
Włącza Matrox BES (backend scaler - końcowy system skalujący)
(domyślnie: wyłączony).
Daje bardzo dobre rezultaty biorąc pod uwagę zarówno szybkość jak i wyjściową
jakość, jako że interpolowana obróbka obrazu jest przeprowadzana sprzętowo.
Działa tylko na wyjściu pierwszego monitora.
.IPs (no)spic
Wykorzystuje warstwę podobrazu (sub picture layer) Matroksa do wyświetlania OSD
(domyślnie: włączone).
.IPs (no)crtc2
Włącza wyjście TV na drugim wyjściu karty (domyślnie: włączone).
Jakość wyjściowa jest zadziwiająca, ponieważ jest to obraz z pełnym przeplotem
i prawidłową synchronizacja pól nieparzystych/\:parzystych.
.IPs (no)input
Wykorzystuje kod klawiatury DirectFB zamiast MPlayera (domyślnie: wyłączone).
.IPs buffermode=single|double|triple
Podwójne i potrójne buforowanie dają najlepsze efekty, jeżeli chcesz uniknąć
problemów z rozrywaniem.
Potrójny bufor jest wydajniejszy niż podwójny, jako że nie blokuje
MPlayera w trakcie czekania na przerysowanie w pionie.
Nie powinno się korzystać z pojedynczego buforowanie (domyślnie: potrójny).
.IPs fieldparity=top|bottom
Kontroluje kolejność wyjścia dla ramek z przeplotem (domyślnie: wyłączony).
Poprawnymi wartościami są top = najpierw górne pola, bottom = najpierw dolne
pola.
Opcja ta nie ma żadnego wpływu na progresywny materiał filmowy (większość
filmów MPEG).
Musisz włączyć tę opcję, jeżeli masz problemy z rozrywaniem/\:brakiem płynności
ruchów podczas oglądania materiału z przeplotem.
.IPs tvnorm=pal|ntsc|auto
Ustawia standard TV karty Matrox bez konieczności zmieniania /etc/\:directfbrc
(domyślnie: wyłączony).
Poprawne normy to: pal = PAL, ntsc = NTSC.
Specjalną wartością jest auto (automatyczne dostrojenie używając systemów
PAL/\:NTSC), ponieważ decyduje, który standard ma być wykorzystywany zwracając
uwagę na ilość klatek na sekundę filmu.
.RE
.PD 1
.
.TP
.B mga (tylko Linux)
Sterownik wyjścia video przystosowany do kart Matrox, wykorzystujący końcowy
system skalujący YUV na kartach z serii Gxxx poprzez moduł jądra.
Jeżeli posiadasz taką kartę, jest to wybór oferujący największą szybkość.
.PD 0
.RSs
.IPs <urządzenie>
Wybiera urzywane urządzenie matrox (domyślnie: /dev/\:mga_vid).
.RE
.PD 1
.
.TP
.B xmga (tylko Linux, X11)
Sterownik wyjścia video mga działający w oknie X11.
.PD 0
.RSs
.IPs <urządzenie>
Wybiera urzywane urządzenie matrox (domyślnie: /dev/\:mga_vid).
.RE
.PD 1
.
.TP
.B syncfb\ 
Sterownik wyjścia dla modułu jądra SyncFB, który umożliwia
korzystanie z takich możliwości kart Matrox Gxxx jak
sprzętowe usuwanie przeplotu, skalowanie i synchronizacja wyjścia
do pionowej częstotliwości Twojego monitora.
.
.TP
.B 3dfx (tylko Linux)
Sterownik wyjścia video specyficzny dla 3Dfx.
Sterownik ten używa bezpośrednio sprzętu 3Dfx na X11.
Obsługuje tylko 16 bpp.
FIXME: Jak jest różnica między 3dfx, tdfxfb i tdfx_vid?
.
.TP
.B tdfxfb (tylko Linux)
Sterownik ten wykorzystuje bufor ramki tdfx do wyświetlania filmów z
akceleracją YUV na kartach 3Dfx.
FIXME: Jak jest różnica między 3dfx, tdfxfb i tdfx_vid?
.PD 0
.RSs
.IPs <urządzenie>
Wybiera używane urządzenie fbdev (domyślnie: /dev/\:fb0).
.RE
.PD 1
.
.TP
.B tdfx_vid (tylko Linux)
Sterownik wyjścia video przeznaczony dla 3Dfx.
Korzysta bezpośrednio z modułu jądra tdfx_vid.
FIXME: Jak jest różnica między 3dfx, tdfxfb i tdfx_vid?
.PD 0
.RSs
.IPs <urządzenie>
Wybiera używane urządzenie fbdev (domyślnie: /dev/\:fb0).
.RE
.PD 1
.
.TP
.B dxr2 (zobacz też \-dxr2) (tylko DXR2)
Sterownik przeznaczony dla Creative DXR2.
.PD 0
.RSs
.IPs <sterownik_vo>
Wybiera podsterownik video używany jako nakładka (x11, xv).
.RE
.PD 1
.
.TP
.B dxr3 (tylko DXR3)
Sterownik wyjścia video przeznaczony dla chipu dekodującego MPEG - Sigma
Designs em8300 (Creative DXR3, Sigma Designs Hollywood Plus).
Sprawdź również filtr video lavc.
.PD 0
.RSs
.IPs overlay
Włącza overlay zamiast wyjścia TV.
.IPs prebuf
Włącza prebuforowanie.
.IPs sync
Włączą nowy silnik synchronizujący.
.IPs norm=<norma>
Określa normę TV.
.RSss
0: Nie zmienia obecnego standardu (domyślnie).
.br
1: Automatycznie dostraja używając PAL/\:NTSC.
.br
2: Automatycznie dostraja używając PAL/\:PAL-60.
.br
3: PAL
.br
4: PAL-60
.br
5: NTSC
.REss
.IPs 0\ 1\ 2\ 3\ 
Określa numer urządzenia, które ma być użyte, jeżeli masz więcej niż jedną
kartę em8300.
.RE
.PD 1
.
.TP
.B mpegpes (tylko DVB)
Sterownik wyjścia video przeznaczony dla DVB albo do zapisu zbiorów MPEG-PES.
.PD 0
.RSs
.IPs card=<1\-4>
Określa numer urządzenia, które ma być użyte, jeśli masz więcej niż jedną
kartę DVB (tylko API V3, tak jak sterowniki z serii 1.x.y).
.IPs <nazwa\ zbioru>
Jeśli nie masz karty DVB ten sterownik zapisuje zbiór w formacie MPEG-PES pod
nazwą, którą podasz (domyślnie: ./grab.mpg).
.RE
.PD 1
.
.TP
.B zr (patrz też \-zr* i \-zrhelp)
Sterownik wyjścia video przeznaczony dla wielu kart
przechwytujących/\:odtwarzających MJPEG.
.
.TP
.B zr2\ \ \ \ 
Sterownik wyjścia video drugiej generacji przeznaczony dla wielu kart
przechwytujących/\:odtwarzających MJPEG.
Zwróć również uwagę na filtr video zrmjpeg.
.PD 0
.RSs
.IPs dev=<urządzenie>
Wybiera używane urządzenie.
.IPs PAL\ \ \ 
Włacza normę video pal.
.IPs SECAM
Włącza normę video secam.
.IPs NTSC\ \ \ 
Włącza normę video ntsc.
.IPs prebuf
Włącza prebuforowanie, jeszcze nie obsługiwane.
.RE
.PD 1
.
.TP
.B md5\ \ \ \ 
Generuje dla każdej ramki obraz przy pomocy \-vo pgm i zapisuje ich sumy MD5 do
zbioru.
Przydatne przy debugowaniu.
.PD 0
.RSs
.IPs filename
Pozwala podać nazwę zbioru wyjściowego (domyślnie ./md5)
.RE
.PD 1
.
.TP
.B yuv4mpeg
Zmienia strumień video na nieskompresowaną sekwencję obrazów YUV 4:2:0
i przechowuje ją w pliku "stream.yuv" w bieżącym katalogu.
Format jest taki sam jak ten stosowany przez mjpegtools, więc jest to przydatne
jeśli chcesz poddać film obróbce przy pomocy tego pakietu.
Obsługuje formaty YV12, RGB (24 bpp) i BGR (24bpp).
.PD 0
.RSs
.IPs interlaced
Zapisuje ramki z przeplotem, najpierw górne pole.
.IPs interlaced_bf
Zapisuje ramki z przeplotem, najpierw dolne pole.
.REss
.PD 1
.RS
.sp 1
.I INFORMACJA:
Jeśli nie podasz żadnej opcji wyjście jest progresywne (czyli bez przeplotu).
.RE
.
.TP
.B gif89a\ 
Zapisuje wszystkie ramki do jednego animowanego pliku GIF w bieżącym katalogu.
Obsługuje tylko format RGB z 24 bpp, wyjście natomiast jest konwertowane do
256 kolorów.
.PD 0
.RSs
.IPs <fps>\ \ \ 
Liczba rzeczywista opisująca ilość klatek na sekundę (domyślnie: 5.0).
.IPs <nazwa\ zbioru>
Nazwa zbioru wyjściowego (domyślnie: ./out.gif).
.REss
.PD 1
.RS
.sp 1
.I INFORMACJA:
Musisz podać ilość ramek na sekundę przed nazwą zbioru, albo stanie się ona
częścią nazwy.
.sp 1
.I PRZYKŁAD:
.RE
.PD 0
.RSs
mplayer video.nut \-vo gif89a:15.0:test.gif
.RE
.PD 1
.
.TP
.B jpeg\ \ \ 
Zapisuje każdą ramkę do pliku JPEG w bieżącym katalogu.
Każdy plik dostaje jako nazwę numer ramki poprzedzony zerami.
.PD 0
.RSs
.IPs [no]progressive
Wybiera między standardowym lub progresywnym JPEG (domyślnie: noprogressive).
.IPs [no]baseline
Wybiera, czy ma używać baseline czy nie (domyślnie: baseline).
.IPs optimize=<0\-100>
współczynnik optymalizacji (domyślnie: 100)
.IPs smooth=<0\-100>
współczynnik wygładzania (domyślnie: 0)
.IPs quality=<0\-100>
współczynnik jakości (domyślnie: 75)
.IPs outdir=<wartość>
Określa katalog, w którym będą zapisywane pliki JPEG.
Jeżeli nie podano żadnej wartości, wszystkie pliki będą zapisane
w bieżącym katalogu.
.IPs subdirs=<wartość>
Jeśli podane, MPlayer stworzy poszeregowane podkatalogi z określnonym prefiksem.
Jeżeli opcja nie jest podana, żadne podkatalogi nie będą stworzone i wszystkie
pliki JPEG będą zapisane do tego samego katalogu.
.IPs maxfiles=<wartość>
Maksymalna ilość zapisanych w podkatalogach plików JPEG (jeżeli podana
jest opcja subdirs).
Wartość musi być równa lub większa niż 1 (domyślnie: 1000).
.RE
.PD 1
.
.TP
.B pgm\ \ \ \ 
Zapisuje każdą ramkę do pliku PGM w bieżącym katalogu.
Każdy plik dostaje jako nazwę numer ramki poprzedzony zerami.
Obsługuje tylko format YV12.
Wynikowy obraz ma wymiary (szerokość) x (wysokość * 1.5) oryginalnego obrazu.
Od współrzędnych 0,0 dla wysokości,szerokości zaczyna się płaszczyzna Y, od
współrzędnych 0,wysokość przez wysokość/2,szerokość/2 jesp płaszczyzna U zaś od
wyskokość/2,szerokość przez wysokość/2,szerokość/2 jest płaszczyzna V.
.
.TP
.B png (patrz też \-z)
Zapisuje każdą ramkę do pliku PNG w bieżącym katalogu.
Każdy plik dostaje jako nazwę numer ramki poprzedzony zerami.
Obsługuje formaty RGB i BGR z 24 bpp.
.
.TP
.B tga\ \ \ \ 
Zapisuje każdą ramkę do pliku TARGA w bieżącym katalogu.
Każdy plik dostaje jako nazwę numer ramki poprzedzony zerami.
Sterownik ten istnieje by dostarczać łatwy sposób bezstratnego zapisywania
obrazów bez zewnętrznej biblioteki.
Obsługuje format BGR[A], z 15, 24 i 32 bpp.
Można wymusić konkretny format filtrem video format.
.sp 1
.I PRZYKŁAD:
.RE
.PD 0
.RSs
mplayer video.nut \-vf format=bgr15 \-vo tga
.RE
.PD 1
.
.
.
.SH "OPCJE DEKODOWANIA/\:FILTROWANIA"
.
.TP
.B \-ac <[-]kodek1,[-]kodek2,...[,]>
Ustala priorytetową listę używanych kodeków audio, według ich nazw
w codecs.conf.
Użyj "-" przed nazwą kodeka aby go pominąć.
Jeżeli lista zakończona jest ',', MPlayer będzie brał pod uwagę
również niewymienione na niej kodeki.
.br
.I INFORMACJA:
Możesz pobrać listę dostępnych kodeków poprzez \-ac help.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-ac mp3acm"
Wymusza kodek MP3 l3codeca.acm.
.IPs "\-ac mad,"
Próbuje najpierw libmad, później pozostałe.
.IPs "\-ac hwac3,a52,"
Włącza sprzętowe AC3, programowy kodek AC3, potem pozostałe.
.IPs "\-ac -ffmp3,"
Pomija kodek MP3 FFmpeg.
.RE
.PD 1
.
.TP
.B \-af <filtr1[=parametr1:parametr2:...],filtr2,...>
Podaje listę oddzielanych przecinkami filtrów audio i ich opcji.
Przeczytaj również rozdział dokumentacji o filtrach audio.
.br
.I INFORMACJA:
Aby uzyskać pełną listę dostępnych filtrów audio, skorzystaj z \-af help.
.sp 1
Dostępne są filtry:
.RSs
.IPs resample[=czprób[:sloppy][:type]]
Zmienia częstotliwość próbkowania strumienia audio na podaną w Hz liczbę.
Obsługuje tylko format 16-bit little-endian.
.IPs channels[=il]
Zmienia ilość kanałów wyjścia na il.
Jeśli liczba kanałów wyjściowych jest większa niż liczba kanałów wejściowych,
wstawiane są puste kanały (poza miksowaniem z mono na stereo, wtedy kanał mono
jest powtarzany w obu kanałach wyjściowych).
Jeśli liczba kanałów wyjściowych jest mniejsza niż liczba kanałów wejściowych
to dodatkowe kanały są obcinane.
.IPs format[=bps:f]
Ustawia ilość bajtów na próbkę i format używane przy wyjściu z
warstwy filtrującej.
Opcja bps to liczba całkowita oznaczająca Bytes per sample (bajtów na próbkę).
Format f to ciąg składający się z:
.br
alaw, mulaw lub imaadpcm
.br
float lub int
.br
unsigned lub signed
.br
le be (little- lub big-endian)
.br
.IPs volume[=v:sc]
Wybiera głośność wyjścia.
Ten filtr może być włączony tylko raz na każdy strumień audio.
.RSss
v: Ustawia wzmocnienie w dB dla wszystkich kanałów w strumieniu od
wartości -200dB do +60dB (gdzie -200dB oznacza całkowite wyciszenie
a +60dB 1000-krotne wzmocnienie).
.br
sc: Włącza miękkie obcinanie (soft-clipping).
.REss
.IPs pan[=n:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...]
Dowolnie miksuje kanały, szczegóły w DOCS/\:HTML/\:pl/\:devices.html#audio-dev
.RSss
n: liczba kanałów wejściowych (1\-6)
.br
lij: Jak dużo z kanału wejściowego j jest miksowane w kanał wyjściowy i.
.REss
.IPs sub[=fc:ch]
Dodaje kanał subwoofera.
.RSss
fc: Częstotliwość graniczna filtra dolnoprzepustowego (20Hz do 300Hz)
(domyślnie: 60Hz).
.br
ch: numer kanału subwoofera
.REss
.IPs surround[=d]
Dekoder macierzowo zakodowanego dźwięku przestrzennego, działa na większości
zbiorów 2 kanałowych.
.RSss
d: opóźnienie w ms dla tylnych głośników (0ms do 1000ms) (domyślnie: 15ms).
.REss
.IPs delay[=ch1:ch2:...]
Opóźnia wyjście audio.
Podaje opóźnienia osobno dla każdego kanału w milisekundach (liczba
rzeczywista między 0 a 1000).
.IPs export[=mmapowany_zbiór[:npróbek]]
Eksportuje przychodzący sygnał do innych procesów używając mapowania pamięci
(mmap()).
.RSss
mmapowany_zbiór: Zbiór, na który należy mapować dane
(domyślnie: ~/.mplayer/\:mplayer-af_export).
.br
npróbek: ilość próbek na kanał (domyślnie 512)
.REss
.RE
.
.TP
.B \-af-adv <force=(0\-3):list=(filters)> (sprawdź też opcję \-af)
Podaje zaawansowane opcje filtrów audio:
.RSs
.IPs force=<0\-3>
Wymusza jeden z trybów wstawiania filtrów audio:
.RSss
0: całkowicie automatyczne wstawianie filtrów (domyślnie)
.br
1: Optymalizuje pod względem dokładności.
.br
2: Optymalizuje pod względem szybkości.
.br
3: Wyłącza automatyczne wstawianie filtrów.
.REss
.IPs list=<filtry>
Tak samo jak \-af.
.RE
.
.TP
.B \-afm <sterownik1,sterownik2,...>
Ustala priorytetową listę rodzin kodeków audio, zgodnie z ich nazwami
w codecs.conf.
Powraca do domyślnego, jeżeli żaden z podanych kodeków nie będzie działał.
.br
.I INFORMACJA:
Możesz pobrać listę dostępnych rodzin kodeków poprzez \-afm help.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-afm ffmpeg"
Używa najpierw kodeków FFmpeg z libavcodec.
.IPs "\-afm acm,dshow"
Próbuje najpierw kodeki Win32.
.RE
.PD 1
.
.TP
.B \-aspect <stosunek>
Zmienia proporcje filmu.
Proporcje są automatycznie wykrywane w MPEG, ale nie stosuje się to
do większości zbiorów AVI.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
\-aspect 4:3  lub \-aspect 1.3333
.br
\-aspect 16:9 lub \-aspect 1.7777
.RE
.PD 1
.
.TP
.B \-noaspect
Wyłącza automatyczne wyrównywanie proporcji filmu.
.
.TP
.B \-flip
Odwraca obraz do góry nogami.
.
.TP
.B \-lavdopts <opcja1:opcja2:...> (KOD DEBUGOWY)
Określa parametry dekodowania z libavcodec.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
\-lavdopts bug=1
.RE
.PD 1
.sp 1
.RS
Dostępne są opcje:
.RE
.RSs
.IPs bug=<wartość> 
Ręczne obejście błędów kodera:
.RSss
0: nic
.br
1: automatyczne wykrywanie błędów
.br
2 (msmpeg4v3): stare pliki msmpeg4v3 wygenerowane przez lavc (bez autodetekcji)
.br
4 (mpeg4): błąd przeplotu XviD (automatycznie wykrywany, jeśli fourcc==XVIX)
.br
8 (mpeg4): UMP4 (automatycznie wykrywanany, jeśli fourcc==UMP4)
.br
16 (mpeg4): błąd wypełnienia (padding) (automatycznie wykrywany)
.br
32 (mpeg4): błąd niedozwolonego vlc (automatycznie wykrywany przez fourcc)
.br
64 (mpeg4): błąd qpel w XviD i DivX (automatycznie wykrywany przez fourcc/\:wersję)
.br
128 (mpeg4): qpel w starym standardzie (automatycznie wykrywany przez fourcc/\:wersję)
.br
256 (mpeg4): kolejny błąd qpel (automatycznie wykrywany przez fourcc/\:wersję)
.br
512 (mpeg4): błąd rozmiaru bloku bezpośredniego qpel (automatycznie wykrywany przez fourcc/\:wersję)
.br
1024 (mpeg4): błąd wypełnienia krawędzi (automatycznie wykrywany przez fourcc/\:wersję)
.REss
.IPs debug=<wartość>
informacje debugowania:
.RSss
.br
0: wyłączone
.br
1: informacje o obrazie
.br
2: kontrola tempa
.br
4: bitstream
.br
8: typ makrobloku (MB)
.br
16: parametr kwantyzacji (QP)
.br
32: wektor ruchu
.br
0x0040: wizualizacja wektora ruchu (użyj \-noslices)
.br
0x0080: przeskakiwanie makrobloku (MB)
.br
0x0100: kod startowy
.br
0x0200: PTS
.br
0x0400: odporność na błędy
.br
0x0800: operacje kontrolne zarządzania pamięcią (H.264)
.br
0x1000: błędy
.REss
.IPs ec=<wartość> 
ukrywanie błędów:
.RSss
1: Używa silnego filtru deblokującego (deblock) dla uszkodzonych
makrobloków (MB).
.br
2: iteracyjne szukanie wektorów ruchu (MV) (wolne)
.br
3: wszystko (domyslnie)
.REss
.IPs er=<wartość>
szukanie błędów w strumieniu
.RSss
.br
0: wyłączone
.br
1: ostrożne (Powinna działać z zepsutymi koderami.)
.br
2: normalne (domyślnie) (Działa ze zgodnymi koderami.)
.br
3: agresywne (Więcej testów, może jednak sprawić problemy nawet z poprawnymi
strumieniami bitowymi.)
.br
4: bardzo agresywne
.REss
.IPs fast\ 
Korzysta z optymalizacji niestosujących się do specyfikacji i tym samym
mogących sprawić problemy (takie jak prostsza dekwantyzacja, stosowanie
domyślnej matrycy kwantyzacji, stosowanie YUV 4:2:0 i pomijanie kilku testów
na wykrycie uszkodzonych strumieni bitowych).
.IPs gray\ 
dekodowanie tylko w skali szarości (trochę szybsze niż w kolorze)
.IPs "idct=<0\-99> (zobacz także \-lavcopts)"
Żeby osiągnąć najlepszą jakość dekodowania, używaj tego samego algorytmu
idct do kodowania i dekodowania.
Może to jednak zmniejszyć dokładność.
.IPs "sb=<number> (tylko MPEG2)"
Przeskakuje podaną ilość wierszy makrobloków na dole.
.IPs "st=<number> (tylko MPEG2)"
Przeskakuje podaną ilość wierszy makrobloków na górze.
.IPs vismv=<wartość>
vismv:
.RSss
.br
0: wyłączona
.br
1: Wizualizuje przewidziane w przód wektory ruchu (MV) klatek P.
.br
2: Wizualizuje przewidziane w przód wektory ruchu (MV) klatek B.
.br
4: Wizualizuje przewidziane w tył wektory ruchu (MV) klatek B.
.REss
.IPs vstats
Wyświetla pewne statystyki i zapisuje je w zbiorze ./vstats_*.log.
.RE
.
.TP
.B \-noslices
Wyłącza rysowanie obrazu przez paski/\:kawałki o wysokości 16 pikseli,
zamiast tego rysuje wszystko za jednym razem.
Może być szybsze albo wolniejsze, zależy to od karty/\:cache'u.
Działa tylko z kodekami z rodziny libmpeg2 i libavcodec.
.
.TP
.B \-nosound
Nie koduje/\:odtwarza dźwięku.
Użyteczne do testów wydajności.
.
.TP
.B \-novideo
Nie koduje/\:odtwarza video.
.
.TP
.B \-oldpp <jakość> (tylko OpenDivX) (PRZESTARZAŁE)
Używa kodu postprocessingu z opendivx zamiast wbudowanego.
Zastąpiony przez \-pp, wewnętrzny postprocessing daje lepszą jakość i jest
szybszy.
Prawidłowy zakres wartości \-oldpp zależy od kodeka, najczęściej jest to
0\-6, gdzie 0=wyłączony, 6=powolny/\:najlepszy.
.
.TP
.B \-pp <jakość> (sprawdź także opcję \-vf pp)
Ustawia poziom postprocessingu DLL.
Ta opcja nie wpływa już na \-vf pp.
Działa tylko z Win32 DirectShow DLL, które mają wewnętrzny postprocessing.
Poprawny zakres dla wartości \-pp zależy od kodeka, najczęściej jest to
0\-6, gdzie 0=wyłączony, 6=powolny/\:najlepszy.
.
.TP
.B \-pphelp (sprawdź także opcję \-vf pp)
Pokazuje streszczenie dostępnych filtrów postprocesu i sposób ich użycia.
.
.TP
.B \-ssf <tryb>
Określa parametry SwScaler.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
\-vf scale \-ssf lgb=3.0
.RE
.PD 1
.PD 0
.RSs
.IPs lgb=<0\-100>
filtr rozmycia gaussowego (jasność)
.IPs cgb=<0\-100>
filtr rozmycia gaussowego (kolor)
.IPs ls=<0\-100>
filtr wyostrzający (jasność)
.IPs cs=<0\-100>
filtr wyostrzający (kolor)
.IPs chs=<h>
poziome przesunięcie koloru
.IPs cvs=<v>
pionowe przesunięcie koloru
.RE
.PD 1
.
.TP
.B \-stereo <tryb>
Wybiera typ wyjścia stereo MP2/\:MP3.
.PD 0
.RSs
.IPs 0
stereo
.IPs 1
lewy kanał
.IPs 2
prawy kanał
.RE
.PD 1
.
.TP
.B \-sws <typ\ programowego\ skalowania> (zobacz także \-vf scale i \-zoom)
Określa algorytm skalowania programowego dla opcji \-zoom.
Ma to wpływ na sterowniki wyjściowe video bez sprzętowej akceleracji, np.\& x11.
.sp 1
Dostępne są typy:
.sp 1
.PD 0
.RSs
.IPs 0
szybki, dwuliniowy (domyślnie)
.IPs 1
dwuliniowy
.IPs 2
dwukubiczny (dobra jakość)
.IPs 3
eksperymentalny
.IPs 4
najbliższy sąsiad (zła jakość)
.IPs 5
area
.IPs 6
jasność dwukubicznie / kolor dwuliniowo
.IPs 7
gauss
.IPs 8
sincR
.IPs 9
lanczos
.IPs 10
dwusześcienna krzywa sklejana
.RE
.PD 1
.sp 1
.RS
.I INFORMACJA:
Dla \-sws\ 2 i 7 ostrość może być ustawiona parametrem skalowania (p)
przez \-vf scale (0 (miękko) \- 100 (ostro)), dla \-sws 9, określa ona
długość filtru (1 \- 10).
.RE
.
.TP
.B \-vc <[-]kodek1,[-]kodek2,...[,]>
Ustala priorytetową listę używanych kodeków video, według ich nazw
w codecs.conf.
Użyj "-" przed nazwą kodeka aby go pominąć.
Jeżeli lista zakończona jest ',', MPlayer będzie brał pod uwagę
również niewymienione na niej kodeki.
.br
.I INFORMACJA:
Możesz pobrać listę dostępnych kodeków poprzez \-vc help.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-vc divx"
Wymusza kodek Win32/\:VFW DivX.
.IPs "\-vc divx4,"
Próbuj najpierw kodek divx4linux, później pozostałe.
.IPs "\-vc -divxds,-divx,"
Pomija kodeki Win32 DivX.
.IPs "\-vc ffmpeg12,mpeg12,"
Próbuj kodeki libavcodec MPEG1/\:2, później libmpeg2, potem inne.
.RE
.PD 1
.
.TP
.B \-vfm <sterownik1,sterownik2,...>
Ustala priorytetową listę używanych rodzin kodeków video, zgodnie z ich nazwami
w codecs.conf.
Powraca do domyślnych, jeśli żadna z podanych rodzin kodeków nie działa.
.br
.I INFORMACJA:
Możesz pobrać listę dostępnych rodzin kodeków poprzez \-vfm help.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-vfm ffmpeg,dshow,vfw"
Najpierw próbuje libavcodec, potem Directshow, potem kodeki VFW i, jeśli nadal
nic nie nie działa, pozostałe.
.IPs "\-vfm xanim"
Najpierw próbuje kodek XAnim.
.RE
.PD 1
.
.TP
.B \-x <x> (tylko MPlayer)
Skaluje obraz do szerokości <x> (jeśli jest dostępne skalowanie sprzętowe lub
programowe).
Wyłącza przeliczania proporcji.
.
.TP
.B \-xvidopts <opcia1:opcja2:...>
Podaje dodatkowe parametry przy dekodowaniu XviD.
.PD 0
.RSs
.IPs deblock-chroma
Uruchamia wewnętrzny filtr postprocessingu XviD: chroma deblock filter.
Sprawdź również opcję \-vf pp, która jest szybsza niż filtr XviD.
.IPs deblock-luma
Uruchamia wewnętrzny filtr postprocessingu XviD: luma deblock filter.
Sprawdź również opcję \-vf pp, która jest szybsza niż filtr XviD.
.IPs dr2\ \ 
Włącza bezpośrednie wyświetlanie metodą 2 (direct rendering method 2).
.IPs nodr2
Wyłącza bezpośrednie wyświetlanie metodą 2.
.IPs filmeffect
Włącza wewnętrzny efekt ziarnistości filmu (XviD).
Dodaje sztuczną ziarnistość filmu do video.
Może zwiększyć postrzegalną jakość, jednocześnie obniżając prawdziwą jakość.
Sprawdź również \-vf noise.
.RE
.PD 1
.
.TP
.B \-xy <wartość>
.PD 0
.RSs
.IPs wartość<=8
Skaluje obraz o współczynnik <wartość>.
.IPs value>8
Ustawia szerokość na <wartość> i oblicza wysokość tak, by utrzymać prawidłowe
proporcje.
.RE
.PD 1
.
.TP
.B \-y <y> (tylko MPlayer)
Skaluje obraz do wysokości <y> (jeśli jest dostępne skalowanie sprzętowe lub
programowe)
Wyłącza przeliczenia proporcji.
.
.TP
.B \-zoom\ \ 
Umożliwia skalowanie programowe, jeśli jest dostępne.
Może być użyte do wymuszenia skalowania z \-vf scale.
.br
.I INFORMACJA:
\-vf scale zignoruje \-x / \-y / \-xy / \-fs / \-aspect bez \-zoom.
.
.
.
.SH "FILTRY VIDEO"
Filtry video umożliwiają Ci modyfikację strumienia video i jego
własności.
Składnia jest następująca:
.
.TP
.B \-vf <filtr1[=parametr1:parametr2:...],filtr2,...>
Ustawia listę filtrów video i ich opcji.
.
.TP
.B \-vop <...,filtr3[=parametr1:parametr2:...],filtr2,filtr1> (PRZESTARZAŁE)
Ustawia listę filtrów video do zastosowania w
.B odwrotnej
kolejności.
Odradzane na rzecz \-vf.
.PP
Wiele parametrów jest opcjonalnych i jeżeli zostaną pominięte, ich wartości
ustawiane są na domyślne.
Użyj "-1", aby wyraźnie nakazać ustawiania wartości domyślnej.
Parametry w:h oznaczają szerokość x wysokość w pikselach, x:y oznacza pozycję
od lewego górnego rogu większego obrazu.
.br
.I INFORMACJA:
Możesz pobrać listę dostępnych filtrów video poprzez \-vf help.
.sp 1
Filtry są zorganizowane w listy.
Jest kilka poleceń zarządzających listą filtrów.
.
.TP
.B \-vf-add <filtr1[,filtr2,...]>
Dodaje podane jako parametry filtry do listy filtrów.
.
.TP
.B \-vf-pre <filtr1[,filtr2,...]>
Poprzedza listę filtrów podanymi filtrami.
.
.TP
.B \-vf-del <poz1[,poz2,...]>
Usuwa filtry na podanych pozycjach.
Pozycje rozpoczynają się od 0, ujemne liczby odnoszą się do końca listy
(-1 to ostani).
.
.TP
.B \-vf-clr
Usuwa wszystkie filtry.
.PP
Jeśli filtr to obsługuje możesz odnosić się do parametrów podając ich nazwy.
.
.TP
.B \-vf <filtr>=help
Wyświetla nazwy parametrów i zakresy wartości dla podanego filtru.
.TP
.B \-vf <filtr=nazwany_parametr1=wartość1[:nazwany_parametr2=wartość2:...]>
Ustawia nazwany parametr na podaną wartość.
Użyj on/\:off albo yes/\:no żeby ustawić parametry typu przełącznik.
.PP
Dostępne są filtry:
.
.TP
.B crop[=w:h:x:y]
Kadruje daną część partii obrazu i wyrzuca resztę.
Przydatne do usuwania czarnych obramowań z szerokoekranowych filmów.
.PD 0
.RSs
.IPs w,h
Szerokość i wysokość obcięcia, domyślnie oryginalna szerokość i wysokość.
.IPs x,y
Pozycja wycinanego obrazu, domyślnie środek.
.RE
.PD 1
.
.TP
.B cropdetect[=limit:round]
Oblicza niezbędne parametry przycinania i wyświetla propozycje na standardowe
wyjście.
.PD 0
.RSs
.IPs limit
Próg, który może być opcjonalnie podany od niczego (0) do wszystkiego (255)
(domyślnie: 24).
.br
.IPs round
Wartość, przez którą szerokość/\:wysokość powinny być podzielne (domyślnie: 16).
Offset jest automatycznie dopasowywany tak, aby wycentrować film.
Użyj 2, aby otrzymać równe wymiary (wymagane przez film 4:2:2).
16 to najlepsza wartość przy kodowaniu do większości kodeków.
.RE
.PD 1
.
.TP
.B rectangle[=w:h:x:y]
Reaguje na przyjmującą dwa parametry dyrektywę "change_rectangle" w zbiorze
input.conf.
.PD 0
.RSs
.IPs w,h
szerokość i wysokość (domyślnie: -1, maksymalny możliwy rozmiar przy którym
granice wciąż są widoczne.)
.IPs x,y
pozycja lewego górnego rogu (domyślnie: -1, najwyżej i najbardziej w lewo jak
to tylko możliwe)
.RE
.PD 1
.
.TP
.B expand[=w:h:x:y:o]
Zwiększa rozdzielczość (nie skaluje) filmu do podanej wartości i umieszcza
nieprzeskalowany obraz pod współrzędnymi x, y.
Może być użyty do umieszczenia napisów/\:OSD w otrzymanym czarnym pasku.
.RSs
.IPs w,h
Szerokość i wysokość po poszerzeniu (domyślnie: oryginalna szerokość, wysokość).
Ujemne wartości traktowane są jak zmiany oryginalnej wielkości
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IP expand=0:-50:0:0
Dodaje 50 pixeli ramki na dole obrazka.
.RE
.PD 1
.IPs x,y
pozycja oryginalnego obrazu na rozszerzonym obrazie (domyślnie: na środku)
.IPs o
wyświetlanie OSD/\:napisów
.RSss
0: wyłączone (domyślnie)
.br
1: włączone
.REss
.RE
.
.TP
.B flip\ \ \ 
Odwraca obraz do góry nogami.
Zobacz także opcję \-flip.
.
.TP
.B mirror\ 
Tworzy lustrzane odbicie względem osi Y.
.
.TP
.B rotate[=<0\-7>]
Obraca obraz o +/\:- 90 stopni.
Dla parametrów pomiędzy 4\-7 obracanie wykona się tylko jeżeli geometria filmu
jest portretem a nie krajobrazem.
.
.TP
.B scale[=w:h[:przeplot[:gub_kolor[:parametr[:presize]]]]]
Skaluje obraz (wolnym) programowym skalatorem i wykonuje konwersję
kolorów YUV<\->RGB (zobacz też \-sws).
.RSs
.IPs w,h\ \ 
Przeskalowana szerokość/\:wysokość (domyślnie: oryginalna szerokość/\:wysokość)
.br
.I INFORMACJA:
Jeżeli podano \-zoom, a podane filtry (włączając w to libvo) nie potrafią
skalować, domyślnie jest d_width/\:d_height!
.RSss
 0:   skalowana d_width/\:d_height
.br
-1:   oryginalna wysokość/\:szerokość
.br
-2:   oblicza w/\:h używając tej drugiej wartości i preskalowanych proporcji.
.br
-3:   oblicza w/\:h używając tej drugiej wartości i oryginalnych proporcji.
.REss
.IPs przeplot
Przełącza skalowanie z przeplotem.
.IPs gub_kolor
opuszcza informację o kolorach
.RSss
0: Użyje wszystkich dostępnych linii wejścia koloru.
.br
1: Użyje tylko co 2gą linię wejścia koloru.
.br
2: Użyje tylko co 4tą linię wejścia koloru.
.br
3: Użyje tylko co 8mą linię wejścia koloru.
.REss
.IPs parametr
parametr skalowania (zależnie od użytej metody)
.RSss
\-sws 2 (bicubic):  ostrość (0 (gładkie) \- 100 (wyostrzone))
.br
\-sws 7 (gaussian): ostrość (0 (gładkie) \- 100 (wyostrzone))
.br
\-sws 9 (lanczos):  długość filtra (1\-10)
.REss
.IPs presize
Skaluje do standardowych wielkości.
.RSss
qntsc:   352x240 (ćwierć ekranu NTSC)
.br
qpal:    352x288 (ćwierć ekranu PAL)
.br
ntsc:    720x480 (standardowe NTSC)
.br
pal:     720x576 (standardowe PAL)
.br
sntsc:   640x480 (NTSC z kwadratowymi pikselami)
.br
spal:    768x576 (PAL z kwadratowymi pikselami)
.REss
.RE
.
.TP
.B dsize={proporcja|w:h}
Zmienia pożądaną wielkość obrazu/\:proporcję w wybranym miejscu łańcucha
filtrów.
Proporcja może być podana jako ułamek (4/\:3) lub liczba rzeczywista (1.33).
Zamiast tego można podać dokładne wymiary wyjścia.
Proszę zauważyć, że filtr ten NIE przeskalowywuje nic samemu; on tylko ustawia
co następne skalowania (sprzętowe lub programowe) zrobią przy dostosowywaniu do
prawidłowych proporcji.
.
.TP
.B yuy2\ \ \ 
Wymusza konwersję programową YV12/\:I420 lub 422P na YUY2.
Przydatne przy kartach/\:sterownikach video, które mają wolną obsługę YV12,
ale szybką YUY2.
.
.TP
.B yvu9\ \ \ 
Wymusza programową konwersję przestrzeni kolorów YVU9 na YV12.
Odradzany na rzecz skalowania programowego.
.
.TP
.B yuvcsp\ 
Obcina wartości kolorów YUV do zakresu CCIR 601 bez przeprowadzania prawdziwej
konwersji.
.
.TP
.B rgb2bgr[=swap]
Konwersja kolorów RGB 24/\:32 <\-> BGR 24/\:32
.PD 0
.RSs
.IPs swap\ 
Dodatkowo zamienia R <\-> B.
.RE
.PD 1
.
.TP
.B palette
Konwersja przestrzeni kolorów RGB/\:BGR 8 \-> 15/\:16/\:24/\:32bpp przy użyciu
palety.
.
.TP
.B format[=fourcc]
Ograniczenie przestrzeni kolorów dla następnego filtru bez robienia żadnej
konwersji.
Stosować razem z filtrem skalującym do prawdziwej konwersji.
Listę dostępnych formatów można uzskać wywołując format=fmt=help.
.PD 0
.RSs
.IPs fourcc
nazwa formatu taka jak rgb15, bgr24, yv12, itp (domyślnie: yuy2)
.RE
.PD 1
.
.TP
.B noformat[=fourcc]
Ograniczenie przestrzeni kolorów dla następnego filtru bez robienia żadnej
konwersji.
Przeciwnie niż filtr formatu, pozwala na użycie dowolnej przestrzeni kolorów
.B z wyjątkiem
tej, którą określiłeś.
Listę dostępnych formatów można uzyskać wywołując format=fmt=help.
.PD 0
.RSs
.IPs fourcc
nazwa formatu taka jak rgb15, bgr24, yv12, itp (domyślnie: yv12)
.RE
.PD 1
.
.TP
.B pp[=filtr1[:opcja1[:opcja2...]]/\:[-]filtr2...] (zobacz także \-pphelp)
Ta opcja włącza użycie wewnętrznych filtrów postprocessingu MPlayera,
a także daje interfejs do przekazywania filtrom opcji.
Podfiltry muszą być oddzielone znakiem /.
Każdy filtr domyślnie ustawiony jest na "c" (chrominance).
Parametry akceptują prefix "-" wyłaczający opcję.
Do opcji może być dołączony znak ":" i litera by wskazać jej zakres:
.PD 0
.RSs
.IPs a
Automatycznie wyłącza filtr, gdy procesor jest zbyt wolny
.IPs c
Filtruje też kolory.
.IPs y
Nie wykonuje filtrowania kolorów (tylko jasności).
.RE
.PD 1
.sp 1
.RS
.br
.I INFORMACJA:
\-pphelp pokaże wszystkie dostępne filtry postprocessingu.
.sp 1
.I PRZYKŁAD:
.RE
.PD 0
.RSs
.IPs "\-vf pp=hb/\:vb/\:dr/\:al"
odblokowywanie poziome i pionowe, odpierścienianie i automatyczna korekcja
jasności/\:kontrastu
.IPs "\-vf pp=hb/\:vb/\:dr/\:al/\:lb"
odblokowywanie poziome i pionowe, odpierścienianie, automatyczna korekcja
jasności/\:kontrastu i usuwanie przeplotu liniowym rozmyciem.
.IPs "\-vf pp=de/\-al"
domyślne filtry bez korekty jasności/\:kontrastu
.IPs "\-vf pp=de/\:tn:1:2:3"
domyślne filtry i tymczasowy odszumiacz.
.IPs "\-vf pp=hb:y/\:vb:a \-autoq 6"
Poziome odblokowywanie jasności i odblokowywanie pionowe w zależności od
dostępnego czasu procesora.
.RE
.PD 1
.
.TP
.B spp[=jakość[qp:[:tryb]]
prosty filtr postprocessingu
.RSs
.IPs jakość
0\-6 (domyślnie: 3)
.IPs qp\ \ 
wymusza parametr kwantyzacji (domyślnie: 0, parametr QP z video)
.IPs tryb\ \ \ 
0: twardy próg (domyślne)
.br
1: miękki próg (lepsze odpierścienianie, większe rozmycie)
.RE
.
.TP
.B qp=równanie
filtr zmiany parametru kwantyzacji (QP)
.RSs
.IPs równanie
jakieś równanie postaci "2+2*sin(PI*qp)"
.RE
.
.TP
.B test\ \ \ 
Tworzy różne wzorce testowe.
.
.TP
.B rgbtest
Tworzy wzorzec testowy RGB przydatny do wykrywania pomyłek RGB/\:BGR.
Powinieneś widzieć czerwony, zielony i niebieski pasek od góry do dołu.
.
.TP
.B lavc[=jakość:fps]
Szybka programowa konwersja z YV12 na MPEG1 przy pomocy libavcodec do
stosowania z DVB/\:DXR3.
Szybsza i lepsza jakość niż \-vf fame.
.RSs
.IPs jakość
.RSss
1\-31: ustalone qscale
.br
32\-:  ustalone tempo bitowe w kBitach
.REss
.IPs fps\ \ 
wymusza fps wyjścia (liczba rzeczywista) (domyślnie: 0, wykrywanie wg wysokości)
.RE
.
.TP
.B fame\ \ \ 
Szybka programowa konwersja z YV12 na MPEG1 przy pomocy libfame do stosowania
z DVB/\:DXR3.
.
.TP
.B dvbscale[=aspekt]
Ustawia optymalne skalowanie dla kart DVB, czyli sprzętowe skalowanie osi X
i programowe wyliczanie skalowania osi Y tak, by zachować proporcje.
Użyteczne tylko w połączeniu z expand+scale
(\-vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1,lavc).
.RSs
.IPs aspect
Kontroluje proporcje, wyliczane przez wzór DVB_HEIGHT*ASPECTRATIO (domyślnie:
576*4/\:3=768), ustaw na 576*(16/\:9)=1024 dla TV 16:9.
.RE
.
.TP
.B noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
Dodaje zakłócenia.
.PD 0
.RSs
.IPs <0\-100>
zakłócenie jasności
.IPs <0\-100>
zakłócenia koloru
.IPs u
jednolite zakłócenia (w przeciwnym wypadku gaussowskie)
.IPs t
zmienne zakłócenie (wzorzec zakłóceń zmienia się między klatkami)
.IPs a
uśrednione zmienne zakłócenia (gładsze, ale o wiele wolniejsze)
.IPs h
wysoka jakość (odrobinę lepiej wygląda, odrobinę wolniejsze)
.IPs p
miesza według przypadkowego zakłócenia z (pół)regularnym wzorem
.RE
.PD 1
.
.TP
.B denoise3d[=luma:chroma:time]
Ten filtr redukuje zakłócenia obrazu wygładzając obraz, a nieruchome obrazy
stają się naprawdę nieruchome (Powinno to poprawić możliwości kompresji.).
Można podać od 0 do 3 parametrów.
Jeżeli pominiesz parametry, użyte zostaną rozsądne wartości.
.PD 0
.RSs
.IPs luma\ 
wpływ przestrzeni jasności (domyślnie = 4)
.IPs chroma
wpływ przestrzeni kolorów (domyślnie = 3)
.IPs time\ 
czas wpływu (domyślnie = 6)
.RE
.PD 1
.
.TP
.B hqdn3d[=luma:chroma:czas]
Wersja filtra denoise3d z wysoką precyzją/\:jakością.
Parametry i sposób użycia są takie same.
.
.TP
.B eq[=jasność:kontrast]
Programowy korektor z interaktywnym sterowaniem, zupełnie jak korektor
sprzętowy, dla kart/\:sterowników które nie obsługują sprzętowego sterowania
jasnością i kontrastem.
Może być także użyteczny z MEncoderem, w celu poprawy kiepsko przechwyconych
filmów, lub też w celu lekkiego zmniejszenia kontrastu, by ukryć artefakty
powstałe z winy niskiego tempa bitowego.
Początkowe wartości z przedziału -100\-100 mogą być podane w wierszu
poleceń.
.
.TP
.B eq2[=gamma:kontrast:jasność:nasycenie:rg:gg:bg:waga]
Alternatywny korektor programowy używający tabel podglądu (lookup tables,
bardzo wolne), pozwala na korekcję gamma poza zwykłą zmianą jasności
i kontrastu.
Wykorzystuje to ten sam kod optymalizowany dla MMX co \-vf eq
jeśli wszystkie wartości gamma są 1.0.
Parametry są podane jako liczby rzeczywiste.
Parametry rg, gg, bg są niezależne wartościami gamma dla czerwonej (rg),
zielonej (gg) i niebieskiej (bg) składowej obrazu.
Parametr wagi może być użyty do zmniejszenia efektu wysokiej wartości gamma na
jasnych obszarach obrazu, np.\& żeby nie zostały wzmocnione aż do czystej
bieli.
Wartość 0.0 całkowicie wyłącza korektę gamma a 1.0 zostawia ją z pełną mocą.
Domyślnie kontrast=1.0, jasność=0.0, gamma=1.0, nasycenie=1.0, waga=1.0
Zakresy wartości dla gammy to 0.1\-10, -2\-2 dla kontrastu (ujemne wartości
dają negatyw obrazu), -1\-1 dla jasności, 0\-3 dla nasycenia i 0\-1 dla wagi.
.
.TP
.B hue[=barwa:nasycenie]
Domyślne wartości to barwa=0.0, nasycenie 1.0.
Zakresy wartości to -180\-180 dla barwy, -2\-2 dla nasycenia (ujemne wartości
dają negatyw obrazu).
.
.TP
.B halfpack[=f]
Konwerteruje płaskie YUV 4:2:0 do upakowanego 4:2:2 o połowie wysokości,
zmniejszając próbkowanie jasności, ale zostawiając wszystkie próbki
barwy.
Użyteczne przy wyświetlaniu na urządzeniach o niskiej rozdzielczości, gdy
sprzętowe skalowanie jest kiepskiej jakości lub nie jest dostępne.
Może być także użyte jako prymitywne usuwanie przeplotu jasności przy bardzo
niskim zużyciu procesora.
Domyślnie, halfpack pobiera średnie z pary linii, kiedy zmniejsza próbkowanie.
Wartość 0 opcjonalnego parametru f wymusza używanie tylko parzystych linii,
zaś wartość 1 tylko nieparzystych.
Inne wartości f dają domyślne (uśredniające) zachowanie.
.
.TP
.B ilpack[=tryb]
Przy zachowywaniu video w formatach YUV 4:2:0 przeplot barw nie jest
ustawiany prawidłowo z powodu zmniejszenia ilości kanałów barw w pionie.
Filtr ten pakuje płaskie 4:2:0 w format YUY2 (4:2:2) z liniami barwy na
właściwych miejscach, żeby w każdej linii skanowania dane barwy i jasności
pochodziły z tego samego pola.
Opcjonalny argument podaje tryb próbkowania.
Domyślnie używana jest interpolacja liniowa (tryb 1).
Tryb 0 używa trybu najbliższego sąsiada (nearest-neighbor), który jest szybki,
ale niepoprawny.
.
.TP
.B harddup
Użyteczne tylko z MEncoderem.
Jeżeli harddup jest używany przy kodowaniu, wymusza umieszczenie zduplikowanych
ramek w wyjściu.
Wymaga to trochę więcej miejsca, ale jest konieczne przy tworzeniu plików MPEG
lub jeśli planujesz dalsze demuksowanie i remuksowanie strumienia video.
Parametr powinien być umieszczony na końcu łańcucha filtrów lub blisko niego,
chyba że masz dobry powód aby zrobić inaczej.
.
.TP
.B softskip
Użyteczne tylko z MEncoderem.
Softskip przesuwa moment omijania/\:opuszczania klatek sprzed początku łańcucha
filtrów, do miejsca zawierającego się gdzieś w nim.
Pozwala to działać poprawnie filtrom, które muszą mieć dostępne wszystkie klatki
(odwrócone telecine, tymczasowy odszumiacz, itp.).
Parametr powinien być umieszczony po wyżej wymienionych filtrach i
po kolejnych filtrach, które wymagają dużej mocy obliczeniowej.
.
.TP
.B decimate[=max:hi:lo:uł]
Usuwa ramki, które niewiele różnią się od poprzednich w celu zmniejszenia
framerate.
Argument max (jeśli dodatni) ustawia maksymalną ilość kolejnych ramek, które
mogą zostać usunięte, albo (gdy ujemny) minimalną odległość między usuniętymi
ramkami.
Ramka jest kandydatem do usunięcia, jeśli żaden region 8x8 nie różni się o
więcej niż hi i jeśli nie więcej niż uł obrazu (1 oznacza cały obraz) różni
się o więcej niż lo.
Wartości hi i lo odnoszą się do bloków 8x8 i reprezentują faktyczne różnice w
wartościach pikseli, więc granica 64 przekłada się na 1 jednostkę różnicy na
każdym pikselu lub to samo inaczej rozmieszczone w całym bloku.
Główne zastosowanie tego filtra to kodowanie-z-bardzo-niskim-tempem-bitowym
(np.\& strumieniowanie przez modem), ale teoretycznie może on być użyty do
naprawy filmów w których nieprawidłowo odwrócono telecine.
.
.TP
.B dint[=czułość:poziom]
Wykrywa i usuwa pierwszą klatkę z przeplotem w strumieniu video.
Wartości mogą być z zakresu 0.0 do 1.0 \- pierwszy (domyślnie 0.1) jest względną
różnicą pomiędzy sąsiadującymi pikselami, drugi (domyślnie 0.15) określa w
jakiej części klatki musi być wykryty przeplot, aby ją usunąć.
.
.TP
.B lavcdeint
Używa filtra usuwającego przeplot z biblioteki libavcodec.
.
.TP
.B kerndeint[=próg[:mapa[:kolejność[:ostr[:dwustr]]]]]
Adaptatywny deinterlacer jądra autorstwa Donald'a Graft'a.
Usuwa przeplot z części video, jeśli zostanie przekroczony konfigurowalny próg.
.PD 0
.RSs
.IPs "próg (0 - 255)"
Wartość progowa (domyślnie 10).
.IPs "mapa (0 lub 1)"
Koloruje piksele przekraczające próg na biało (domyślnie: 0).
.IPs "kolejność (0 lub 1)"
Zamienia pola jeśli 1 (domyślnie: 0).
.IPs "ostr (0 lub 1)"
Włącza dodatkowe wyostrzanie (domyślnie: 0).
.IPs "dwustr (0 lub 1)"
Włącza dwustronne wyostrzanie (domyślnie: 0).
.RE
.PD 1
.
.TP
.B unsharp=l|cWxH:ilość[:l|cWxH:ilość]
Maska zmiękczająca / rozmycie gaussa.
.RSs
.IPs l
Stosuje efekty na składowej jasności.
.IPs c
Stosuje efekty na składowych koloru.
.IPs WxH
szerokość i wysokość macierzy, nieparzysty rozmiar w obu kierunkach
(min = 3x3, max = 13x11 lub 11x13, zazwyczaj coś pomiędzy 3x3 i 7x7)
.IPs ilość
Względny współczynnik wyostrzenia/\:rozmycia obrazu
(rozsądna wartość powinna być w zakresie -1.5\-1.5).
.RSss
<0: rozmycie
.br
>0: wyostrzenie
.REss
.RE
.
.TP
.B swapuv\ 
Zamienia płaszczyzny U i V.
.
.TP
.B il=[d|i][s][:[d|i][s]]
Rozdziela przeplatane obrazy.
Celem tego filtra jest dodanie możliwości przetwarzania przeplatanych obrazów
pojedynczymi obrazami bez usuwania przeplotu.
Możesz filtrować swoje DVD z przeplotem i odtwarzać na telewizorze nie psując
przeplotu.
Podczas gdy przeplot usuwany jest na stałe (filtrami postprocesingu -
wygładzając, uśredniając, itp.), rozdzielanie przeplotu dzieli klatkę na 2 pola
(tak zwane półobrazy), można więc je przetwarzać (filtrować) niezależnie,
a następnie połączyć z powrotem w jeden obraz.
.PD 0
.RSs
.IPs d
rozdziela obraz (umieszczając jeden nad drugim)
.IPs i
łączy obraz
.IPs s
zamienia pola (parzyste i nieparzyste linie)
.RE
.PD 1
.
.TP
.B fil=[i|d]
Rozdziela przeplatane obrazy.
Ten filtr jest bardzo podobny do filtru il ale o wiele szybszy, jego główną
wadą jest to, że nie zawsze działa.
Zwłaszcza w połączeniu z innymi filtrami może utworzyć losowo pomieszane
obrazy, więc ciesz się jeśli działa, ale nie skarż się, jeśli nie działa z Twoją
kombinacją filtrów.
.PD 0
.RSs
.IPs d
Rozdziela obraz, umieszczając półobrazy obok siebie)
.IPs i
Łączy obraz
.RE
.PD 1
.
.TP
.B field[=n]
Wyciąga pojedyncze pola z przeplatanego obrazu używając arytmetyki krokowej,
aby unikać marnowania czasu procesora.
Opcjonalny argument n określa, czy wyciągać parzyste, czy nieparzyste pola
(zależnie od tego czy n jest parzyste, czy nieparzyste).
.
.TP
.B detc[=zmienna1=wartość2:zmienna2=wartość2:...]
Próbuje odwrócić proces "telecine" by uzyskać czysty strumień bez przeplotu
przy prędkości klatek filmu.
Był to pierwszy i najbardziej prymitywny filtr odwróconego telecine, który
został zaimplementowany w MPlayerze/\:MEncoderze.
Działa przez skupienie się na wzorcu telecine 3:2 i podążaniu nim tak długo, jak
to tylko możliwe.
Dlatego pasuje on doskonale dla perfekcyjnie ztelecinowanego materiału, nawet
w przypadku obecności sporej wartości szumu, ale nie zadziała po złożonej
edycji po telecinowaniu.
Filtr przestał być już rozwijany, jako że ivtc, pullup i filmdint lepiej nadają
się do większości zastosowań.
Poniższe argumenty (składnia jest opisana wyżej) mogą być użyte by kontrolować
jego działanie:
.RSs
.IPs dr
Ustawia tryb gubienia klatek.
0 (domyślnie) oznacza, że klatki
nie będą porzucane by utrzymać ustaloną wyjściową prędkość klatek.
1 oznacza, że klatki będą zawsze porzucane gdy nie było porzucania lub
łączenia telecine w poprzednich 5 klatkach.
2 oznacza, że zawsze będzie utrzymywany dokładny stosunek 5:4 klatek
wejściowych do wyjściowych.
.br
.I INFORMACJA:
Z MEncoderem używaj zawsze trybu 1 lub 2!
.IPs am
Tryb analizy.
Dostępne wartości to 0 (ustalony wzorzec z numerem klatki inicjalizującej
określony przez fr=#) i 1 (agresywne szukanie wzorca telecine).
Domyślnie jest 1.
.IPs fr
Ustawia numer początkowej klatki w sekwencji.
0\-2 to trzy następujące po sobie klatki bez przeplotu; 3 i 4 to dwie klatki
z przeplotem.
Domyślne -1 oznacza "poza sekwencją telecine".
Liczba podana tutaj odnosi się do hipotetycznej klatki przed początkiem filmu.
.IPs "tr0, tr1, tr2, tr3"
Wartości progowe używane w niektórych trybach.
.RE
.
.TP
.B ivtc[=1]
Eksperymentalny "bezstanowy" filtr odwracający telecine.
Zamiast próbować znaleźć wzorzec, jak robi to filtr detc, ivct podejmuje decyzje
niezależnie dla każdej klatki.
Daje to o wiele lepsze rezultaty na filmach, które przeszły głębokie
modyfikacje po zastosowaniu telecine, ale za to nie jest tak odporny na
zakłócenia wejściowe, np.\& podczas przechwytywania z TV.
Opcjonalny parametr (ivct=1) ma podobne działanie jak opcja dr=1 dla filtru
detc i powinien być używany tylko z MEncoderem.
Jak przy detc, musisz podać prawidłową wyjściową ilość klatek na sekundę
(\-ofps 23.976) przy używaniu MEncodera.
Dalszy rozwój ivtc jest wstrzymamy, jako że filtry pullup i filmdint
wydają się być dokładniejsze.
.
.TP
.B pullup[=jl:jr:jt:jb:sb:mp]\ 
Filtr odwracania telecine trzeciej generacji, zdolny do przetwarzania mieszanki
twardego telecine (hard-telecine) oraz progresywnej zawartości 24 i 30 fps.
Filtr pullup jest zaprojektowany, aby był skuteczniejszy niż detc czy ivtc,
poprzez wykorzystywanie kontekstu przy podejmowaniu decyzji.
Podobnie jak ivtc, pullup jest bezstanowy w sensie takim, że nie skupia się na
wzorcu i nie podąża za nim, ale zamiast tego sprawdza kolejne pola, aby
zidentyfikować podobieństwa i odbudować progresywne ramki.
Ciągle jest w fazie rozwojowej, mimo to jest całkiem dokładny.
Opcje jl, jr, jt i jb określają ile "śmieci" ma być ignorowane odpowiednio
po lewej, prawej, u góry i na dole obrazu.
Lewo/\:prawo są w jednostkach 8 pikseli, natomiast góra/\:dół są w jednostkach
2 linii.
Domyślnie jest to 8 pikseli z każdej strony.
Ustawiając opcję sb (strict breaks - stałe przerwy) na 1, zmniejsza się
szansa, że pullup stworzy niepasującą klatkę, ale może również prowadzić do
ominięcia wielu ramek podczas scen z dużą ilością ruchu.
Odwrotnie, jeśli ustawisz na -1, to pullup łatwiej będzie dopasowywał pola.
Może to pomóc przy przetwarzaniu filmu, w którym jest delikatne rozmazanie
między polami, ale może również sprawić, że w wyjściu znajdą się klatki
z przeplotem.
Opcja mp (przestrzeń metryczna) może być ustawiona na 1 lub 2, aby użyć
przestrzeni barw zamiast przestrzeni jasności dla obliczeń pullup.
Może to poprawić dokładność na bardzo czystym materiale źródłowym, ale
prawdopodobnie zmniejszy dokładność, jeśli film ma zniekształcone barwy
(efekt tęczy) lub jest on w skali szarości.
Głównym celem ustawienia mp na przestrzeń barw jest zmniejszenie obciążenia
CPU i sprawienie, aby pullup mógł być używany w czasie rzeczywistym na wolnych
maszynach.
.br
.I INFORMACJA:
Zawsze stosuj filtr softskip po pullup przy kodowaniu, aby mieć pewność,
że ten drugi będzie miał dostęp do wszystkich klatek.
Jeżeli tego nie zrobisz, doprowadzi to do błędów w wyjściu i zakończeniu
programu na skutek ograniczeń w warstwie kodeku/\:filtru.
.
.TP
.B filmdint[=options]
Filtr odwracania telecine, podobny do opisanego wyżej filtra pullup.
Projektowany do obsłużenia każdego wzorca odwracania, włączając mieszankę
miękkiego i twardego telecine oraz ograniczoną obsługę filmów, które zostały
przyspieszone lub opóźnione w stosunku do swojej prędkości początkowej.
Tylko płaszczyzna jasności jest używana przy szukaniu przerw między klatkami.
Jeśli pole nie zostanie dopasowane, jest z niego usuwany przeplot poprzez
prostą aproksymację liniową.
Jeśli źródłem jest MPEG-2 musi to być pierwszy filtr, tak by miał dostęp do
flag pola ustawionych przez dekoder MPEG-2.
W zależności od źródłowego MPEG może ujść na sucho zignorowanie tej porady,
dopóki nie widzisz licznych ostrzeżeń "Bottom-field first".
Bez opcji przeprowadza normalne usuwanie telecine i powinien być używany z
mencoder \-fps 29.97 \-ofps 23.976.
Jeśli ten filtr jest używany z mplayerem efektem będzie nierówna prędkość
odtwarzania, ale i tak jest to generalnie lepsze niż użycie pp=lb albo
całkowity brak usuwania przeplotu.
Poszczególne opcje są oddzielane znakiem /.
.RSs
.IPs crop=w:h:x:y
Tak jak filtr crop, ale szybciej i działa na mieszance twardego i miękkiego
telecine oraz gdy y nie jest wielokrotnością 4.
Jeśli x lub y wymagałyby obcinania ułamków piksela z płaszczyzn barw obszar
obcinania jest powiększany.
Zazwyczaj oznacza to że x i y muszą być parzyste.
.IPs io=ifps:ofps
Na każde ifps klatek wejściowych filtr wygeneruje ofps klatek wyjściowych.
Stosunek ifps/\:ofps powinien być taki sam jak stosunek \-fps/\-ofsp.
Może to być użyte do filtrowania filmów, które są nadawane w TV z inną
częstotliwością niż oryginalna.
.IPs luma_only=n
Jeśli n jest niezerowe, płaszczyzna barwy jest kopiowana bez zmian.
Przydatne przy telewizji próbkowanej w YV12, która ignoruje jedno z pól barwy.
.IPs mmx2=n
Na x86 jeśli n=1 używa funkcji optymalizowanych dla MMX2 zaś jeśli n=2 używa
funkcji optymalizowanych dla 3DNow!.
Gdzie indziej używa czystego C.
Jeśli nie podano tej opcji MMX2 i 3DNow! są wykrywane automatycznie, użyj tego
by wyłączyć autodetekcję.
.IPs fast=n
Duże n przyspieszy filtr kosztem dokładności.
Domyślne jest n=3.
Jeśli n jest nieparzyste, klatka bezpośrednio po klatce z zaznaczoną flagą MPEG
REPEAT_FIRST_FIELD uznawana jest za progresywną, więc filtr nie spędzi ani
chwili nad MPEG-2 z miękkim telecine.
To jest jedyny efekt tej flagi, jeśli jest dostępne MMX2 albo 3DNow!.
Bez MMX2 ani 3DNow! niezależnie czy n=0 czy n=1 to będą użyte te same
obliczenia co przy n=2 czy n=3.
Jeśli n=2 lub 3 ilość poziomów jasności używana do znalezienia przełomu
klatek jest redukowana z 256 do 128, co daje szybszy filtr bez dużej straty
dokładności.
Jeśli n=4 lub 5 to szybszy, ale o wiele mniej dokładny, algorytm jest używany
do szukania przełomu klatek.
Jest on bardziej skłonny do wykrycia dużych pionowych detali jako przeplotu.
.IPs verbose=n
Jeśli n jest niezerowe, wyświetla szczegółowe metryki dla każdej ramki.
Przydatne przy debugowaniu.
.IPs dint_thres=n
Próg usuwania przeplotu.
Używany przy usuwaniu przeplotu niedopasowanych ramek.
Duża wartość oznacza mniej usuwania przeplotu, n=256 całkowicie je wyłącza.
Domyślnie n=8.
.IPs comb_thres=n
Próg do porównywania górnego i dolnego pola.
Domyślnie 128.
.IPs diff_thres=n
Próg do wykrywania czasowych zmian pola.
Domyślnie 128.
.IPs sad_thres=n
Suma progów Całkowitej Różnicy (Absolute Difference), domyślnie 64.
.RE
.
.TP
.B softpulldown
Ten filtr prawidłowo działa tylko z MEncoderem i działa na flagach MPEG2
używanych do miękkiego telecine 3:2.
Jeśli chcesz użyć filtru ivtc lub detc na filmach, które mają częściowe miękkie
telecine to wstawienie przed nie tego filtra może sprawić że będą one
dokładniejsze.
.
.TP
.B divtc[=options]
Odwrócone telecine dla filmu bez przeplotu.
Jeżeli video z telecine 3:2 straciło jedno z pól lub usunięto z niego przeplot
metodą, która zachowuje jedno pole a interpoluje drugie, to w efekcie
otrzymamy beznadziejnej jakości film z co czwartą klatką powtórzoną.
Ten filtr szuka i opuszcza zduplikowane klatki, i przywraca oryginalną
ilość klatek na sekundę filmu (framerate).
Korzystając z tego filtru, musisz podać wartość \-ofps, które stanowi 4/\:5 fps
pliku wejściowego (23.976 jeżeli wejście jest 29.97fps).
Dostępne opcje:
.RSs
.IPs pass=1|2
Używa trybu dwuprzejściowego (two-pass).
Efektem jest lepsza jakość.
Przejście 1 analizuje film i zapisuje informacje do pliku informacyjnego.
Przejście 2 czyta ten plik i wykorzystuje go przy właściwej obróbce.
Te przejścia NIE odpowiadają przejściom 1 i 2 w procesie kodowania.
Aby wykorzystać tryb dwuprzejściowy divtc z dwuprzejściowym kodowaniem, musisz
wykonać następujące trzy kroki: 1 przejście divtc i kodera, później 2 przejście
divtc i 1 kodera, na końcu 2 przejście divtc i kodera.
.IPs file=nazwa\ pliku
Ustawia nazwę dla pliku informacyjnego kodowania 2-przebiegowego (domyślnie:
"framediff.log").
.IPs threshold=wartość
Ustawia minimalną siłę, którą musi mieć wzorzec telecine, aby filtr w niego
uwierzył (domyślnie: 0.5).
Stosuje się to do rozpoznawania fałszywych wzorców z części filmu, które są
bardzo ciemne lub prawie nieruchome.
.IPs window=ilośćklatek
Ustawia ilość poprzednich ramek, które będą przeszukiwane pod kątem
odnalezienia wzorca (domyślnie: 30).
Większa ilość zapewnia większą wiarygodność w przeszukiwaniu wzorca, jednak
krótsza przerwa skraca czas reakcji do zmian w telecine.
Ma to tylko wpływ na tryb jednoprzejściowy.
Obecnie tryb dwuprzejściowy używa ściśle określonej wartości, która obejmuje
zarówno poprzednie jak i następne klatki.
.IPs phase=0|1|2|3|4
Ustawia początkową fazę telecine dla trybu jednoprzejściowego (domyślnie: 0).
Tryb dwuprzejściowy może "wyglądać w przyszłość", dlatego korzysta z właściwej
fazy już od samego początku, podczas gry tryb jednoprzejściowy musi zgadywać.
Kiedy już ją odnajdzie, zaczyna z niej korzystać, ale ta opcja pozwala na
pozbycie się szumu na początku.
Poza tym, pierwsze przejście trybu dwuprzejściowego też korzysta z tej opcji,
więc jeżeli zachowasz wyjście to otrzymasz w efekcie stała fazę.
.IPs deghost=wartość
Ustawia próg deghostingu (0\-255 dla trybu jednoprzejściowego, -255\-255 dla
trybu dwuprzejściowego, domyślnie 0).
Jeżeli wartość jest różna od 0, tryb deghostingu jest włączony.
Opcja przeznaczona jest dla filmów, z których usunięto przeplot poprzez
zmieszanie pól, zamiast opuszczania jednego z nich.
Proces deghostingu wzmacnia wszystkie pozostałości po kompresji w zmieszanych
klatkach, wtedy parametr wartość określa granicę wyłączenia tych pikseli
z deghostingu, które różnią się od poprzedniej klatki o mniej niż wyznaczony
kres.
Jeżeli używany jest tryb dwuprzejściowy, wartość ujemna może być użyta, aby
zmusić filtr do przeanalizowania całego video na początku drugiego przejścia
w celu określenia czy zastosowanie filtru jest konieczne i wybranie albo 0,
albo wartości bezwzględnej parametru.
Podaj tę opcję dla trybu dwuprzejściowegop, przy jednoprzejściowym nie ma
to żadnego efektu.
.RE
.
.TP
.B phase=[t|b|p|a|u|T|B|A|U][:v]
Opóźnia film z przeplotem o jedno pole czasowe, tak że kolejność pól ulega
zmianie.
Zamierzonym działaniem jest naprawienie filmów w trybie PAL, które były
przechwycone z odwrotną kolejnością względem procesu przenoszenia film-video.
Przyjmowane parametry:
.RSs
.IPs t
Przechwycona kolejność pól pierwsze-górne, zmień na pierwsze-dolne.
Filtr opóźni dolne pole.
.IPs b
Przechwytuje pierwsze-dolne, zmienia na pierwsze-górne.
Filtr opóźni górne pole.
.IPs p
Przechwytuje i przenosi z taką samą kolejnością pól.
Ten tryb istnieje tylko po to, aby mogły się do niego odnieść dokumentacje
innych opcji, jeśli jednak go wybierzesz, filtr, zaskakujące, nie zrobi nic ;-)
.IPs a
Automatycznie wykrywa przechwyconą kolejność pól na podstawie ich flag, zmienia
na odwrotną.
Filtr wybiera pomiędzy trybem t a b ramka po ramce, wykorzystując flagi pól.
Jeżeli żadna informacja odnośnie pól nie jest dostępna, wtedy działa jak u.
.IPs u
Przechwytuje nieznaną lub różną kolejność, odwraca na przeciwną.
Filtr wybiera pomiędzy trybem t a b ramka po ramce, analizując obrazy i
wybierając opcję, która daje najlepsze dopasowanie pól.
.IPs T
Przechwytuje pierwsze-górne, zmienia na nieznany lub różny.
Filtr wybiera pomiędzy trybem t a b ramka po ramce na podstawie analizy obrazu.
.IPs B
Przechwytuje pierwsze-dolne, zmienia na nieznany lub różny.
Filtr wybiera pomiędzy trybem t a b ramka po ramce na podstawie analizy obrazu.
.IPs A
Przechwytuje zależnie podstawie flag pól, zmienia na nieznany lub różny.
Filtr wybiera pomiędzy trybem t a b na podstawie analizy obrazu.
Jeżeli żadna informacja odnośnie pól nie jest dostępna, wtedy działa jak U.
To jest tryb domyślny.
.IPs U
Przechwytuje nieznany lub różny i zmienia na to samo.
Filtr wybiera pomiędzy trybem t a b tylko na podstawie analizy obrazu.
.IPs v
Tryb gadatliwy.
Drukuje wybrany tryb dla każdej klatki i uśrednioną kwadratową różnicę pól
między możliwościami t, b i p.
.RE
.
.TP
.B telecine[=start]
Zastosuje proces 3:2 "telecine" by zwiększyć ilość klatek o 20%.
Najprawdopodobniej nie będzie to działało poprawnie z MPlayerem, ale może być
użyte z "mencoder \-fps 29.97 \-ofps 29.97 \-vf telecine".
Obie opcje fps są niezbędne!
(Synchronizacja A/\:V będzie popsuta, jeżeli będą one źle podane.)
Opcjonalny parametr start mówi filtrowi gdzie ma zacząć we wzorcu telecine
(0\-3).
.
.TP
.B tinterlace[=tryb]
Czasowe przeplatanie pól \- łączy pary klatek w klatkę z przeplotem,
zmniejszając o połowę szybkość klatek.
Parzyste ramki są przenoszone w górne pole, nieparzyste w dolne.
Filtr może być użyty do całkowitego odwrócenia działania tfields (w trybie 0).
Dostępne są tryby:
.PD 0
.RSs
.IPs 0
nieparzyste klatki w górne pole, parzyste w dolne, tworzy ramkę pełnej wysokości
przy połowie prędkości klatek
.IPs 1
opuszcza klatki parzyste, na wyjście przekazuje tylko nieparzyste, wysokość
pozostaje niezmieniona
.IPs 2
opuszcza klatki nieparzyste, na wyjście przekazuje tylko parzyste, wysokość
pozostaje niezmieniona
.IPs 3
poszerza każdą klatkę do pełnej wysokości i wypełnia pozostałe linie na czarno,
szybkość klatek pozostaje niezmieniona
.RE
.PD 1
.
.TP
.B tfields[=tryb]
Tymczasowy separator pola - dzieli pola na klatki, podwajając szybkość
klatek.
Podobnie jak filtr telecine, tfields będzie poprawnie działał tylko z
MEncoderem i tylko gdy oba -fps i -ofps będą ustawione na pożądaną
(podwójną) szybkość klatek!
Dostępne tryby:
.PD 0
.RSs
.IPs 0
pozostawia pola niezmienione (zaobserwujesz przeskoki/\:migotanie)
.IPs 1
interpoluje brakujące linie (stosowany algorytm może nie być zbyt dobry)
.IPs 2
przesuń pola o 1/\:4 piksela z wykorzystaniem interpolacji liniowej
(nie będzie przeskoków)
.IPs 4
przesuń pola o 1/\:4 piksela z wykorzystaniem filtru 4tap (wysoka jakość)
.RE
.PD 1
.
.TP
.B boxblur=promień:moc[:promień:moc]
rozmycie pudełkowe
.PD 0
.RSs
.IPs promień
rozmiar filtru
.IPs moc\ \ 
Jak często filtr powinien być wykorzystywany.
.RE
.PD 1
.
.TP
.B sab=pro:pf:różnKol[:pro:pf:RożnKol]
adaptatywne rozmycie figur
.PD 0
.RSs
.IPs pro\ \ \ 
siła filtru rozmycia (~0.1\-4.0) (wolniejsze jeżeli większe)
.IPs pf\ \ \ 
siła prefiltru (~0.1\-2.0)
.IPs różnKol
Jak różne piksele będą rozpatrywane.
(~0.1\-100.0)
.RE
.PD 1
.
.TP
.B smartblur=pro:siła:zakres[:pro:siła:zakres]
eleganckie rozmycie
.PD 0
.RSs
.IPs pro\ \ 
siła filtru rozmycia (~0.1\-5.0) (wolniejsze jeżeli większe)
.IPs siła\ 
rozmycie (0.0\-1.0) lub wyostrzenie (-1.0\-0.0)
.IPs zakres
filtruj wszystko (0), filtruj płaskie obszary (0\-30)
lub filtruj krawędzie (-30\-0)
.RE
.PD 1
.
.TP
.B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
korekcja perspektywy
.PD 0
.RSs
.IPs x0,y0,...
współrzędne lewego górnego, prawego górnego i prawego dolnego rogu
.IPs t\ \ \ \ 
liniowy (0) lub sześcienny resampling (1)
.RE
.PD 1
.
.TP
.B 2xsai\ \ 
Wykorzystuje podwójne skalowanie i interpolację do skalowania i wygładzania
obrazów.
.
.TP
.B 1bpp\ \ \ 
Konwersja bitmapy 1bpp do YUV/\:BGR 8/\:15/\:16/\:32
.
.TP
.B down3dright[=linie]
Przepozycjonowanie i zmiana rozmiaru obrazu stereoskopowego.
Wydobywa oba pola stereo i umieszcza je wspólnie, zmieniając im rozmiar tak,
by utrzymać proporcje filmu.
.PD 0
.RSs
.IPs linie
ilość linii wybierana ze środka obrazu (domyślnie: 12)
.RE
.PD 1
.
.TP
.B bmovl=hidden:opaque:<fifo>
Odczytuje bitmapy z FIFO i wyświetla je w oknie.
.PD 0
.RSs
.IPs hidden
ustawia domyślną wartość flagi "hidden" (wartość logiczna)
.IPs opaque
flaga przełączająca pomiędzy trybem przezroczystym i nieprzezroczystym (szybki)
.IPs fifo\ 
ścieżka/\:nazwa pliku FIFO (nazwana kolejka łącząca mplayer \-vf bmovl
z aplikacją kontrolują)
.RE
.PD 1
.sp 1
.RS
Komendy FIFO:
.RE
.PD 0
.RSs
.IPs "RGBA32 szerokość wysokość xpoz ypoz alfa czyść"
i następnie szerokość*wysokość*4 bajtów danych źródłowych RGBA32.
.IPs "ABGR32 szerokość wysokość xpoz ypoz alfa czyść"
i następnie szerokość*wysokość*4 bajtów danych źródłowych ABGR2.
.IPs "RGB24 szerokość wysokość xpoz ypoz alfa czyść"
i następnie szerokość*wysokość*3 bajtów danych źródłowych RGB32.
.IPs "BGR24 szerokość wysokość xpoz ypoz alfa czyść"
i następnie szerokość*wysokość*3 bajtów danych źródłowych BGR32.
.IPs "ALPHA szerokość wysokość xpoz ypoz alfa"
zmienia kanał alfa dla obszaru
.IPs "CLEAR szerokość wysokość xpoz ypoz"
czyści obszar
.IPs OPAQUE
Wyłącza całą przezroczystość alfa.
Prześlij "ALPHA 0 0 0 0 0", aby włączyć ją z powrotem.
.IPs HIDE\ 
ukrywa bitmapę
.IPs SHOW\ 
pokazuje bitmapę
.RE
.PD 1
.sp 1
.RS
Argumenty oznaczają:
.RE
.PD 0
.RSs
.IPs "szerokość, wysokość"
wymiary obrazu/\:obszaru
.IPs "xpoz, ypoz"
start blittingu w punkcie o współrzędnych X/Y
.IPs alfa
Ustawia różnicę alfa.
Jeżeli ustawisz na -255, możesz później wysyłać sekwencję komend ALPHA,
aby zmienić wartość na -225, -200, -175 itd.\& \- uzyskasz ciekawy efekt
przenikania ! ;)
.RSss
0:    tak jak oryginał
.br
255:  zmienia wszystko na nieprzezroczyste
.br
-255: zmienia wszystko na przezroczyste
.REss
.IPs czyść
czyści bufor przed blittingiem
.RSss
0: Obraz będzie po prostu blittowany na wierzchu starego, więc nie będziesz
musiał wysyłać 1,8MB danych RGBA32 za każdym razem, kiedy mała część ekranu
jest aktualizowana.
.br
1: czyści
.REss
.RE
.PD 1
.
.TP
.B framestep=I|[i]krok
Renderuje tylko każdą n-tą lub każdą Intra (kluczową - key) klatkę.
.sp 1
Jeżeli wywołasz ten filtr z parametrem I (duża litera), renderowane będą
tylko klatki kluczowe.
Dla DVD oznacza to zwykle co 15/\:12 ramkę (IBBPBBPBBPBBPBB),
a dla AVI każdą zmianę sceny lub każdą wartość keyint (sprawdź wartość
\-lavcopts keyint= jeżeli korzystasz z MEncodera przy kodowaniu video).
.sp 1
Kiedy klatka kluczowa zostaje znaleziona, drukowany jest ciąg znaków "I!"
i znak końca wiersza, zostawiając aktualną linię wyjścia MPlayera/\:MEncodera na
ekranie, ponieważ zawiera ona czas (w sekundach) i numer ramki klatki kluczowej
(Możesz użyć tych informacji do podzielenia zbioru AVI.).
.sp 1
Jeżeli wywołasz ten filtr ze zwykłym parametrem "krok", to tylko jedna ramka na
"krok" klatek będzie renderowana.
.sp 1
Jeżeli umieścisz "i" (mała litera) przed numerem, ciąg I! będzie wydrukowany
(podobnie jak przy opcji "I").
.sp 1
Jeżeli podasz tylko "i", wtedy nic się nie dzieje z klatkami, tylko "I!" będzie
drukowane.
.
.TP
.B tile=xtile:ytile:output:start:delta
Łączy szereg obrazów w jeden większy.
Jeżeli ominiesz parametr lub podasz wartość mniejszą niż 0, domyślna
wartość będzie użyta.
Możesz również przestać podawać opcje w każdej chwili (... \-vf tile=10:5 ...)
Dobrym pomysłem będzie umieszczenie filtra skalowania (scale) przed łączeniem
(tile) :-)
.sp 1
Dostępne parametry:
.sp 1
.PD 0
.RSs
.IPs xtile
ilość kawałków na osi X (domyślnie: 5)
.IPs ytile
ilość kawałków na osi Y (domyślnie: 5)
.IPs output
Renderuje kawałek kiedy wyjściowa ("output") ilość klatek jest osiągnięta,
gdzie "output" powinien być liczbą mniejszą niż xtile * ytile.
Brakujące kawałki są pozostawiane puste.
Możesz, na przykład, zapisać kawałek 8 * 7 co każde 50 klatek, aby uzyskiwać
obraz co 2 sekundy (przy szybkości 25 fps).
.IPs start
piksel początkowy (x/\:y) (domyślnie: 2)
.IPs delta
piksel pomiędzy 2 kawałkami (x/\:y) (domyślnie: 4)
.RE
.PD 1
.
.TP
.B delogo[=x:y:w:h:t]
Usuwa logo stacji TV, poprzez prostą interpolację sąsiednich pikseli.
Wystarczy, że ustawisz prostokąt przykrywający znak i będziesz świadkiem jak
znika (a czasami pojawi się coś o wiele brzydszego \- efekty mogą być różne).
.PD 0
.RSs
.IPs x,y
Pozycja lewego, górnego rogu logo.
.IPs w,h
Szerokość i wysokość czyszczonego prostokątu.
.IPs t
Grubość niewyraźnej krawędzi (dodana do w i h).
Kiedy ustawiona zostanie na -1, zielony prostokąt zostanie narysowany na
ekranie, aby uprościć odnalezienie właściwych parametrów x,y,w,h.
.RE
.PD 1
.
.TP
.B zrmjpeg[=opcje]
Programowy koder YV12 do MJPEG wykorzystywany przy wyjściu video zr2.
.RSs
.IPs maxheight=h|maxwidth=w
Te opcje ustawiają maksymalną szerokość i wysokość, którą karta zr może obsłużyć
(obecnie wartstwa filtrów MPlayera nie może wykryć prawidłowych wartości).
.IPs {dc10+,dc10,buz,lml33}-{PAL|NTSC}
Ustawia automatycznie maks.\& szerokość i wysokość polegając na znanych
wartościach dla duetu karta/\:tryb.
Na przykład, poprawnymi opcjami są: dc10-PAL i buz-NTSC (domyślnie: dc10+PAL)
.IPs color|bw
Wybiera kodowanie w kolorze lub czarno-białe.
To drugie jest szybsze.
Domyślnie używany jest tryb kolorowy.
.IPs hdec={1,2,4}
Poziome dziesiątkowanie 1, 2 lub 4.
.IPs vdec={1,2,4}
Pionowe dziesiątkowanie 1, 2 lub 4.
.IPs quality=1-20
Ustawia jakość kompresji JPEG [NAJLEPSZA] 1 - 20 [NAJGORSZA].
.IPs fd|nofd
Domyślnie, dziesiątkowanie jest stosowane, jeżeli sprzęt Zoran może
przeskalować wzwyż wynikowe obrazy MJPEG do ich oryginalnego rozmiaru.
Parametr fd nakazuje filtrowi zawsze stosować dziesiątkowanie (okropne).
.RE
.
.
.
.SH "OGÓLNE OPCJE KODOWANIA (TYLKO MENCODER)"
.
.TP
.B \-audio-delay <0.0\-...>
Ustawia opóźnienie audio w nagłówku.
Domyślnie jest 0.0, ujemne wartości nie działają.
Opcja nie opóźnia dźwięku podczas kodowania, ale odtwarzacz, gdy wykryje
domyślne opóźnienie audio, wyręcza Cię z użycia opcji -delay.
.
.TP
.B \-audio-density <1\-50>
Liczba kawałków audio na sekundę (domyślnie jest 2 przy kawałkach audio
o długości 0.5s).
.br
.I INFORMACJA:
Tylko dla CBR, VBR ignoruje ją gdyż dokłada kolejny pakiet w nowym kawałku.
.
.TP
.B \-audio-preload <0.0\-2.0>
Ustawia przerwę czasu buforowania audio (domyślnie: 0.5s).
.
.TP
.B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (patrz też opcja \-ss i \-sb)
Zatrzymuje kodowanie w podanym czasie lub pozycji bajtu.
.br
.I INFORMACJA:
Pozycja bajtu nie będzie dokładna, ponieważ może się on tylko
zatrzymać granicy klatki.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-endpos 56"
Koduje tylko 56 sekund.
.IPs "\-endpos 01:10:00"
Koduje tylko 1 godzinę i 10 minut.
.IPs "\-endpos 100mb"
Koduje tylko 100 MBajtów.
.RE
.PD 1
.
.TP
.B \-ffourcc <fourcc>
Można używać do wymuszenia fourcc video pliku wyjściowego.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-ffourcc div3"
Da plik wyjściowy zawierający "div3" jako video fourcc.
.RE
.PD 1
.
.TP
.B \-force-avi-aspect <0.2\-3.0>
Nadpisuje aspekt zawarty nagłówku vprp AVI OpenDML.
Opcja ta może być użyta do zmiany proporcji przy \-ovc copy.
.
.TP
.B \-info <opcja1:opcja2:...> (tylko AVI)
Wybiera informację nagłówka otrzymywanego pliku AVI.
.sp 1
Dostępne opcje:
.RSs
.IPs help\ 
Pokazuje ten opis.
.IPs name=<wartość>
tytuł pliku
.IPs artist=<wartość>
artysta lub autor pliku
.IPs genre=<wartość>
oryginalna kategoria pracy
.IPs subject=<wartość>
treść pliku
.IPs copyright=<wartość>
informacja o prawach autorskich pliku
.IPs srcform=<wartość>
oryginalna forma cyfrowego materiału
.IPs comment=<wartość>
ogólna uwaga na temat pliku
.RE
.
.TP
.B \-noautoexpand
Nie umieszcza automatycznie filtru expand w łańcuchu filtrów MEncodera.
Przydatne do kontrolowania, w którym momencie łańcucha napisy są renderowane
podczas włączania napisów na sztywno do filmu.
.
.TP
.B \-noencodedups
Nie koduje zduplikowanych klatek w duplikacie; w wyjściu umieszcza
klatki zero bajtowe do wskazania duplikatów.
Klatki zero bajtowe będą, tak czy inaczej, zapisane, chyba że filtr lub koder
zdolny do kodowania zduplikowanego jest załadowany.
Obecnie nadaje się do tego tylko filtr harddup.
.
.TP
.B \-noodml (tylko \-of avi)
Nie zapisuje indeksu OpenDML dla plików AVI >1GB.
.
.TP
.B \-noskip
Nie opuszcza klatek.
.
.TP
.B \-o <nazwa\ pliku>
Zapisuje wyjście do podanego pliku, zamiast domyślnego "test.avi".
.
.TP
.B \-oac <nazwa\ kodeka>
Koduje podanym kodekiem audio (brak wartości domyślnej).
.br
.I INFORMACJA:
Użyj -oac help, aby otrzymać listę dostępnych kodeków.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-oac copy"
Nie koduje, tylko kopiuje strumień.
.IPs "\-oac pcm"
Koduje do odkompresowanego PCM.
.IPs "\-oac mp3lame"
Koduje do MP3 (używa Lame).
.IPs "\-oac lavc"
Koduje kodekiem z libavcodec.
.RE
.PD 1
.
.TP
.B \-of <format> (KOD BETA!)
Koduje do wybranego formatu (domyślnie: AVI).
.br
.I INFORMACJA:
Użyj \-of help, aby otrzymać listę dostępnych formatów.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-of avi"
Koduje do AVI (domyślne).
.IPs "\-of mpeg"
Koduje do MPEG.
.IPs "\-of rawvideo"
surowy strumień video (bez muksowania - tylko jeden strumień video)
.RE
.PD 1
.
.TP
.B \-ofps <fps>
Ustawia ilość klatek na sekundę (fps) w wyjściowym pliku,
wartość może być różna niż w pliku źródłowym.
PArametr musi być ustawiony dla zmiennego fps (ASF, niektóre MOV) i plików
progresywnych (29.97fps ztelecinowane MPEG).
.
.TP
.B \-ovc <nazwa\ kodeka>
Koduje z podanym kodekiem video (brak domyślnej wartości).
.br
.I INFORMACJA:
Użyj \-ovc help, aby otrzymać listę dostępnych kodeków.
.sp 1
.I PRZYKŁAD:
.PD 0
.RSs
.IPs "\-ovc copy"
Nie koduje, tylko kopiuje strumień.
.IPs "\-ovc divx4"
Kduje do DivX4/\:DivX5.
.IPs "\-ovc raw"
Koduje do nieskompesowanego formatu (użyj \-vf format, aby wybrać).
.IPs "\-ovc lavc"
Koduje z kodekiem libavcodec.
.RE
.PD 1
.
.TP
.B \-passlogfile <nazwa\ pliku>
W dwuprzebiegowym kodowaniu, zrzuca informacje o pierwszym przejściu do
<nazwa pliku> zamiast domyślnego divx2pass.log.
.
.TP
.B \-skiplimit <wartość>
Określa maksymalną liczbę pominiętych klatek po zakodowaniu jednej
(\-noskiplimit daje nieograniczoną liczbę).
.
.TP
.B \-vobsubout <nazwa\ bazy>
Określa podstawową nazwę wyjściowych plików .idx i .sub.
Wyłączy to renderowanie napisów w kodowanym filmie i przekieruje je do plików
napisów VOBsub.
.
.TP
.B \-vobsuboutid <langid>
Wybiera dwu literowy kod języka napisów.
Unieważnia to, co jest czytane z DVD lub pliku .ifo.
.
.TP
.B \-vobsuboutindex <index>
Określa indeks napisów w pliku wyjściowym (domyślnie: 0).
.
.
.
.SH "OPCJE SPECYFICZNE DLA KODEKA (TYLKO MENCODER)"
Możesz określić specyficzne parametry kodowania dla kodeka, korzystając
z poniższej składni:
.
.TP
.B \-<codec>opts <opcja1[=wartość],opcja2,...>
.
.PP
Gdzie <codec> to: lavc, xvidenc, divx4, lame lub x264enc
.
.
.SS divx4 (\-divx4opts)
DivX4 jest uważany za przestarzały i obsługiwany tylko dla kompletności.
Aby uzyskać szczegółowe informacje o opcjach DivX4, przeczytaj źródła,
większość opcji nie jest tu opisana.
.
.TP
.B help\ \ \ 
wyświetla pomoc
.
.TP
.B br=<wartość>
określa bitrate
.RSs
.IPs 4\-16000
(w kbit)
.IPs 16001\-24000000
(w bit)
.RE
.
.TP
.B key=<wartość>
maksymalna przerwa między kluczowymi klatkami (w klatkach)
.
.TP
.B deinterlace
włącza usuwanie przeplotu (unikaj tej opcji, DivX4 ma pełno błędów)
.
.TP
.B q=<1\-5>
jakość (1\-najszybszy, 5\-najlepszy)
.
.TP
.B min_quant=<1\-31>
minimalny kwantyzator (quantizer)
.
.TP
.B max_quant=<1\-31>
maksywalny kwantyzator
.
.TP
.B rc_period=<wartość>
współczynnik kontroli czasu
.
.TP
.B rc_reaction_period=<wartość>
współczynnik kontroli czasu reakcji
.
.TP
.B rc_reaction_ratio=<wartość>
współczynnik kontroli proporcji reakacji
.
.TP
.B crispness=<0\-100>
określa chropowatość/\:gładkość
.
.TP
.B pass=<1\-2>
Z tą opcją możesz kodować dwuprzejściowo pliki DivX4.
Najpierw koduj z pass=1, później, z tymi samymi parametrami, koduj z pass=2.
.
.TP
.B vbrpass=<0\-2>
Nadpisuje argument pass i wykorzystuje bibliotekę XviD VBR zamiast DivX4 VBR.
Dostępne są następujące opcje:
.RSs
.IPs 0
kodowanie jednoprzejściowe (tak jak przy pominięciu pass linii poleceń)
.IPs 1
Analizuje (pierwsze) przejście dwuprzejściowego kodowania.
Wynikowy plik AVI może być przekierowany do /dev/\:null.
.IPs 2
Ostateczne (drugie) przejście dwuprzejściowego kodowania.
.RE
.
.
.SS lame (\-lameopts)
.
.TP
.B help\ \ \ 
wyświetla pomoc
.
.TP
.B vbr=<0\-4>
metoda zmiennego bitrate
.PD 0
.RSs
.IPs 0
cbr
.IPs 1
mt
.IPs 2
rh (domyślne)
.IPs 3
abr
.IPs 4
mtrh
.RE
.PD 1
.
.TP
.B abr\ \ \ \ 
średni bitrate
.
.TP
.B cbr\ \ \ \ 
stały bitrate.
Wymusza również tryb CBR kodując na kolejnych trybach ustawień ABR
.
.TP
.B br=<0\-1024>
określa bitrate w kBit (tylko CBR i ABR)
.
.TP
.B q=<0\-9>
jakość (0\-najwyższa, 9\-najniższa) (tylko VBR)
.
.TP
.B aq=<0\-9>
jakość algorytmiczna (0\-najlepsza/\:najwolniejsze, 9\-najgorsza/\:najszybsze)
.
.TP
.B ratio=<1\-100>
współczynnik kompresji
.
.TP
.B vol=<0\-10>
ustawia głośność wejścia audio
.
.TP
.B mode=<0\-3>
(domyślne: auto)
.PD 0
.RSs
.IPs 0
stereo
.IPs 1
joint-stereo
.IPs 2
dualchannel
.IPs 3
mono
.RE
.PD 1
.
.TP
.B padding=<0\-2>
.PD 0
.RSs
.IPs 0
nie
.IPs 1
wszystko
.IPs 2
dostraja
.RE
.PD 1
.
.TP
.B fast\ \ \ 
przełącza na szybsze kodowanie kolejnych trybów ustawień VBR, nieznacznie
niższa jakość i większe wartości bitrate.
.
.TP
.B highpassfreq=<częstotliwość>
Ustawia częstotliwość w Hz wysokoprzejściowego filtrowania (highpass filtering).
Częstotliwości poniżej podanej będą obcinane.
Wartość -1 wyłączy filtrowanie, wartość 0
pozwoli LAME wykryć wartości automatycznie.
.
.TP
.B lowpassfreq=<częstotliwość>
Ustawia częstotliwość w Hz niskoprzejściowego filtrowania (lowpass filtering).
Częstotliwości powyżej podanej będą obcinane.
Wartość -1 wyłączy filtrowanie, wartość 0
pozwoli LAME wykryć wartości automatycznie.
.
.TP
.B preset=<wartość>
wartości ustawień
.RSs
.IPs medium
Kodowanie VBR, dobra jakość, wartości bitrate 150\-180 kbps.
.IPs standard
Kodowanie VBR, wysoka jakość, wartości bitrate 170\-210 kbps.
.IPs extreme
Kodowanie VBR, bardzo wysoka jakość, wartości bitrate 200\-240 kbps.
.IPs insane
Kodowanie CBR, najwyższa ustawiona jakość, bitrate 320 kbps.
.IPs <8\-320>
Kodowanie ABR z uśrednioną wartością podanego bitrate.
.RE
.sp 1
.RS
.I PRZYKŁAD:
.RE
.PD 0
.RSs
.IPs fast:preset=standard
dla większości ludzi i typów muzyki już całkiem wysoka jakość.
.IPs cbr:preset=192
koduje z ustawieniami ABR na wymuszonym, stałym bitrate wynoszącym 192 kbps.
.IPs preset=172
kodowanie z ustawieniami ABR przy średnim bitrate 172 kbps.
.IPs preset=extreme
dla ludzi z niewiarygodnie dobrym słuchem i podobnym wyposażeniem.
.IPs preset=help
drukuje dodatkowe opcje i informacje o ustawieniach.
.RE
.PD 1
.
.
.SS lavc (\-lavcopts)
Wiele opcji lavc jest wyspecjalizowanych i skąpo udokumentowanych.
Szczegółowe informacje znajdziesz w źródłach.
.PP
.I PRZYKŁAD:
.PD 0
.RSs
.IPs vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
.RE
.PD 1
.
.TP
.B acodec=<wartość>
Kodek audio (domyślnie: mp2):
.PD 0
.RSs
.IPs mp2
MPEG Layer 2
.IPs mp3
MPEG Layer 3
.IPs ac3
AC3
.IPs adpcm_ima_wav
IMA Adaptive PCM (4bity na próbkę, kompresja w stosunku 4:1)
.RE
.PD 1
.
.TP
.B abitrate=<wartość>
Bitrate dźwięku w kBit (domyślnie 224).
.
.TP
.B atag=<wartość>
Wykorzystuje określony znacznik formatu dźwięku systemu Windows (np.\&
atag=0x55).
.
.TP
.B bit_exact
Wykorzystuje tylko algorytmy bitowo dokładne (poza (i)dct).
Ponadto bit_exact wyłącza kilka funkcji optymalizacyjnych i dlatego też
powinien być stosowany tylko do testów regresyjnych, które wymagają plików
identycznych binarnie, nawet jeżeli zmienia się wersja kodera.
Opcja ta ignoruje również nagłówek user_data w strumieniach MPEG-4.
Nie korzystaj z tego parametru, chyba że wiesz co robisz.
.
.TP
.B threads=<1\-8>
Maksymalna liczba użytych wątków (domyślnie: 1).
Może mieć delikatnie negatywny wpływ na przewidywanie ruchu.
.RE
.
.TP
.B vcodec=<wartość>
Wykorzystuje podany kodek (domyślnie: mpeg4):
.PD 0
.RSs
.IPs mjpeg
Motion JPEG
.IPs ljpeg
Lossless JPEG
.IPs h263\ 
H.263
.IPs h263p
H.263 Plus
.IPs mpeg4
DivX 4/\:5
.IPs msmpeg4
DivX 3
.IPs msmpeg4v2
MS MPEG4v2
.IPs wmv1
Windows Media Video, wersja 1 (AKA WMV7)
.IPs wmv2
Windows Media Video, wersja 2 (AKA WMV8)
.IPs rv10
stary kodek RealVideo
.IPs mpeg1video
MPEG1 video
.IPs mpeg2video
MPEG2 video
.IPs huffyuv
HuffYUV
.IPs asv1
ASUS Video v1
.IPs asv2
ASUS Video v2
.IPs ffv1
bezstratny kodek video FFmpeg
.RE
.PD 1
.
.TP
.B vqmin=<1\-31>
minimalny kwantyzator (quantizer) (przejście\ 1/\:2)
.RSs
.IPs 1
Nie zalecane (bardzo duży plik, mała różnica w jakości i dziwne efekty uboczne:
msmpeg4, h263 będą słabej jakości, kontrola tempa będzie szwankowała co w
rezultacie da wyjście niższej jakości i niektóre dekodery nie będą w stanie
sobie z nim poradzić).
.IPs 2
Zalecane do normalnego kodowania mpeg4/\:mpeg1video (domyślne).
.IPs 3
Zalecane dla h263(p)/\:msmpeg4.
Powodem wyboru 3 a nie 2 jest fakt, że ten drugi może prowadzić do przepełnień
(będzie to naprawione dla h263(p) przez zmianę kwantyzatora o MB w przyszłości,
msmpeg4 nie może być poprawiony ponieważ nie obsługuje tego).
.RE
.
.TP
.B lmin=<0.01\-255.0>
Minimalny mnożnik lagrange dla kontroli tempa, prawdopodobnie chcesz, żeby był
równy lub mniejszy niż vqmin (domyślnie: 2.0).
.RE
.
.TP
.B lmax=<0.01\-255.0>
maksymalny mnożnik lagrange dla kontroli tempa (domyślnie: 31.0)
.RE
.
.TP
.B vqscale=<1\-31>
Stały kwantyzator /\: stała jakość kodowania (włącza tryb stałego kwantyzatora).
Niższa wartość oznacza lepszą jakość ale większy plik wynikowy
(domyślnie: 0 (wyłączony)).
1 nie jest zalecaną wartością (sprawdź vqmin a uzyskasz więcej informacji).
.
.TP
.B vqmax=<1\-31>
maksymalny kwantyzator (przejście\ 1/\:2) 10\-31 jest rozsądnym zakresem
(domyślnie: 31)
.
.TP
.B mbqmin=<1\-31>
minimalny kwantyzator makrobloku (przejście\ 1/\:2) (domyślnie: 2)
.
.TP
.B mbqmax=<1\-31>
maksymalny kwantyzator makrobloku (przejście\ 1/\:2) (domyślnie: 31)
.
.TP
.B vqdiff=<1\-31>
maksymalna różnica kwantyzatora między ramkami I a P (przejście\ 1/\:2)
(domyślnie: 3)
.
.TP
.B vmax_b_frames=<0\-4>
maksymalna ilość ramek B między klatkami innymi niż B:
.PD 0
.RSs
.IPs 0
brak klatek B (domyślnie)
.IPs 0\-2
rozsądny zakres dla MPEG4
.RE
.PD 1
.
.TP
.B vme=<0\-5>
metoda szacowania ruchu
.br
.I INFORMACJA:
Wartości 0\-3 obecnie ignorują ilość zużytych Bitów,
więc jakość może być niska.
Dostępne są metody:
.PD 0
.RSs
.IPs 0
żadna (bardzo niska jakość)
.IPs 1
pełna (powolna)
.IPs 2
log (niska jakość)
.IPs 3
phods (niska jakość)
.IPs 4
EPZS (domyślna)
.IPs 5
X1 (eksperymentalna)
.RE
.PD 1
.
.TP
.B me_range=<0\-9999>
ustawia zakres przeszukiwania przy szacowaniu ruchu, 0 (domyślnie) oznacza
nieograniczony
.
.TP
.B mbd=<0\-2>
Algorytm decyzyjny makrobloku (tryb wysokiej jakości), koduje każdy makroblok
we wszystkich trybach i wybiera ten najlepszy.
Metoda ta jest powolna, ale jej rezultatem jest lepsza jakość i mniejsza
objętość pliku.
.PD 0
.RSs
.IPs 0
korzysta z mbcmp (domyślnie)
.IPs 1
wybiera tryb MB, który wymaga najmniejszej ilości bitów (=vhq)
.IPs 2
wybiera tryb MB, który ma powoduje najmniejsze zniekształcenia tempa
.RE
.PD 1
.
.TP
.B vhq\ \ \ \ 
Działa tak samo jak mbd=1, trzymany ze względu na kompatybilność.
.
.TP
.B v4mv\ \ \ 
Zezwala na 4 wektory ruchu w każdym makrobloku (trochę lepsza jakość).
.
.TP
.B obmc\ \ \ 
kompensacja ruchu nachodzących na siebie bloków (H.263+)
.
.TP
.B loop\ \ \ 
filtr pętli (H.263+)
nie działa
.
.TP
.B inter_threshold <-1000\-1000>
Na razie nie robi kompletnie nic.
.
.TP
.B keyint=<0\-300>
maksymalna przerwa między ramkami kluczowymi w ramkach.
Klatki kluczowe są potrzebne przy przeszukiwaniu, jako że przeszukiwane są
tylko klatki kluczowe, potrzebują jednak one trochę więcej miejsca niż zwykłe
klatki, więc większe wartości dadzą w rezultacie mniejszy plik, ale mniej
precyzyjne przeszukiwanie, 0 oznacza brak klatek kluczowych.
Wartości >300 nie są zalecane, ponieważ jakość może być zła w zależności od
dekodera, kodera i szczęścia.
Dla utrzymania zgodności z MPEG1/\:2/\:4 wartości powinny być <=132.
(domyślnie: 250 albo jedna klatka kluczowa co dziesięć sekund w filmie 25fps)
.
.TP
.B sc_threshold=<-1000000\-1000000>
Próg do wykrywania zmiany sceny.
Libavcodec wstawia klatkę kluczową jeżeli wykryje zmianę sceny.
Tą opcją możesz określić czułość tej detekcji.
-1000000 oznacza, że zmiana sceny wykrywana jest w każdej klatce, 1000000
oznacza, że żadne zmiany nie będą wykryte (domyślnie 0).
.
.TP
.B vb_strategy=<0\-1>
strategia wyboru między ramkami I/\:P/\:B (przejście\ 2):
.RSs
.IPs 0
zawsze używa maksymalnej ilości klatek B (domyślnie)
.IPs 1
unika klatek B w scenach z dużą ilością ruchu (sprawi, że bitrate może być źle
przewidziany)
.RE
.
.TP
.B vpass=<1\-2>
Włącza wewnętrzny tryb dwuprzejściowy, podawaj tylko, jeżeli chcesz
korzystać z kodowania dwuprzejściowego (domyślnie: wyłączony).
.PD 0
.RSs
.IPs 1
pierwsze przejście
.IPs 2
drugie przejście
.RE
.PD 1
.sp 1
.RS
huffyuv:
.RE
.PD 0
.RSs
.IPs "pierwsze przejście"
Zachowuje statystyki.
.IPs "drugie przejście"
Koduje z optymalną tablicą Huffmana opartą o wyniki pierwszego przejścia.
.RE
.PD 1
.
.TP
.B aspect=<x/\:y>
Przechowuje proporcje wewnętrznie, podobnie jak pliki MPEG.
O wiele lepsze rozwiązanie niż ponowne skalowanie, ponieważ nie spada jakość.
Tylko MPlayer będzie odtwarzał te pliki poprawnie, inne odtwarzacze wyświetlą
je w złych proporcjach.
Parametr proporcji może być podany jako stosunek lub liczba rzeczywista.
.sp 1
.RS
.I Przykład:
.RE
.RSs
.PD 0
.IPs "aspect=16/\:9 lub aspect=1.78"
.PD 1
.RE
.
.TP
.B autoaspect
Podobnie jak opcja aspect, ale proporcja wyliczana jest automatycznie, biorąc
pod uwagę wszystkie filtry dostrajające (crop/\:expand/\:scale/\:itp) podane w
łańcuchu.
.
.TP
.B vbitrate=<wartość>
określa bitrate (przejście\ 1/\:2).
Uwaga: 1kBit = 1000 Bitów.
.RSs
.IPs 4\-16000
(w kbit)
.IPs 16001\-24000000
(w bit)
.IPs 800
domyślnie
.RE
.
.TP
.B vratetol=<wartość>
przybliżona tolerancja rozmiaru pliku w kBit.
1000\-100000 jest rozsądnym zakresem.
(uwaga: 1kBit = 1000 Bitów)
(domyślnie: 8000)
.br
.I INFORMACJA:
Wartość vratetol nie powinna być zbyt duża podczas drugiego przejścia, inaczej
mogą wystąpić problemy, jeżeli wykorzystane będzie vrc_(min|max)rate.
.
.TP
.B vrc_maxrate=<wartość>
maksymalny bitrate w kbit/\:sek (przejście\ 1/\:2)
.
.TP
.B vrc_minrate=<wartość>
minimalny bitrate w kbit/\:sek (przejście\ 1/\:2)
.
.TP
.B vrc_buf_size=<wartość>
rozmiar bufora w kbit (przejście\ 1/\:2).
Dla MPEG1/\:2 określa to również rozmiar bufora vbv, użyj 327 dla VCD,
917 dla SVCD i 1835 dla DVD.
.
.TP
.B vrc_buf_aggressivity
obecnie bezużyteczne
.
.TP
.B vrc_strategy
Zarezerwowane na przyszłość.
.
.TP
.B vb_qfactor=<-31.0\-31.0>
współczynnik kwantyzatora pomiędzy klatkami B a innymi niż B (przejście\ 1/\:2)
(domyślnie: 1.25)
.
.TP
.B vi_qfactor=<-31.0\-31.0>
(przejście\ 1/\:2) (domyślnie: 0.8)
.
.TP
.B vb_qoffset=<-31.0\-31.0>
offset kwantyzatora pomiędzy klatkami B a innymi niż B (przejście\ 1/\:2)
(domyślnie: 1.25)
.
.TP
.B vi_qoffset=<-31.0\-31.0>
(przejście\ 1/\:2) (domyślnie: 0.0)
.br
jeżeli v{b|i}_qfactor > 0
.br
Kwantyzator klatek I/\:B = kwantyzator klatki P * v{b|i}_qfactor +
v{b|i}_qoffset
.br
w przeciwnym wypadku
.br
normalnie kontroluj tempo (nie blokuj kwantyzatora wg następnej klatki P)
i ustaw q= -q * v{b|i}_qfactor + v{b|i}_qoffset
.
.TP
.B \ 
Wskazówka: Aby stworzyć stały kwantyzator kodowania z różnych kwantyzatorów
dla klatek I/\:P i B, możesz wykorzystać poniższy wzór:
lmin= <ip_quant>:lmax= <ip_quant>:vb_qfactor= <b_quant/\:ip_quant>
.
.TP
.B vqblur=<0.0\-1.0> (przejście 1)
Rozmycie kwantyzatora, większe wartości uśrednią kwantyzator w czasie
(wolniejsze zmiany).
.RSs
.IPs 0.0
qblur wyłączone
.IPs 0.5
(domyślnie)
.IPs 1.0
uśrednia kwantyzator z poprzednich klatek
.RE
.
.TP
.B vqblur=<0.0\-99.0> (przejście 2)
Rozmycie gaussowe kwantyzatora, większe wartości uśrednią kwantyzator w czasie
(wolniejsze zmiany) (domyślnie: 0.5).
.
.TP
.B vqcomp=<wartość>
kompresja kwantyzatora, zależy od vrc_eq (przejście\ 1/\:2) (domyślnie: 0.5)
.
.TP
.B vrc_eq=<equation>
główne równanie kontroli tempa (przejście\ 1/\:2):
.RE
.RSs
.IPs 1\ \ \ \ 
stały bitrate
.IPs tex\ \ 
stała jakość
.IPs 1+(tex/\:avgTex-1)*qComp
przybliżone równanie starej kontroli tempa
.IPs tex^qComp
z qcomp 0.5 czy coś takiego (domyślnie)
.RE
.PP
.RS
operatory:  +,-,*,/,^
.RE
.PP
.RS
zmienne:
.RE
.RSs
.IPs tex\ \ 
złożoność tekstur
.IPs iTex,pTex
złożoność tekstur intra, nie-intra
.IPs avgTex
średnia złożoność tekstur
.IPs avgIITex
średnia złożoność tekstur intra w klatkach I
.IPs avgPITex
średnia złożoność tekstur intra w klatkach P
.IPs avgPPTex
średnia złożoność tekstur nie-intra w klatkach P
.IPs avgBPTex
średnia złożoność tekstur nie-intra w klatkach B
.IPs mv\ \ \ 
ilość bitów użytych w wektorach ruchu
.IPs fCode
maksymalna długość wektorów ruchu w skali log2
.IPs iCount
ilość makrobloków intra / ilość makrobloków
.IPs var\ \ 
złożoność przestrzenna
.IPs mcVar
złożoność czasowa
.IPs qComp
qcomp z wiersza poleceń
.IPs "isI, isP, isB"
wynosi 1 jeżeli typ obrazu to I/\:P/\:B w przeciwnym wypadku - 0
.IPs Pi,E\ 
przejrzyj swoją ulubioną książkę do matematyki
.RE
.PP
.RS
funkcje:
.RE
.RSs
.IPs max(a,b),min(a,b)
maksimum / minimum
.IPs gt(a,b)
wynosi 1 jeżeli a>b, inaczej 0
.IPs lt(a,b)
wynosi 1 jeżeli a<b, inaczej 0
.IPs eq(a,b)
wynosi 1 jeżeli a==b, inaczej 0
.IPs "sin, cos, tan, sinh, cosh, tanh, exp, log, abs"
.RE
.
.TP
.B vrc_override=<opcje>
Określona przez użytkownika jakość poszczególnych części (zakończenie, lista
płac, ..) (przejście\ 1/\:2).
Opcje to <klatka-początkowa>, <klatka-końcowa>, <jakość>[/\:<klatka-początkowa>,
<klatka-końcowa>, <jakość>[/\:...]]:
.RSs
.IPs "quality (2\-31)"
kwantyzator
.IPs "quality (-500\-0)"
korekcja jakości w %
.RE
.
.TP
.B vrc_init_cplx=<0\-1000>
początkowa złożoność (przejście\ 1)
.
.TP
.B vqsquish=<0,1>
określa jak ma się zachowywać kwantyzator między qmin a qmax (przejście\ 1/\:2):
.PD 0
.RSs
.IPs 0
używa clipping'u
.IPs 1
używa przyjemnej, różniczkowalnej funkcji (domyślnie)
.RE
.PD 1
.
.TP
.B vlelim=<-1000\-1000>
Ustawia próg eliminowania pojedynczych współczynników jasności.
Wartości ujemne będą brały pod uwagę także współczynnik dc (powinny być równe
co najmniej -4 lub niżej dla kodowania z quant=1):
.PD 0
.RSs
.IPs 0
wyłączony (domyślnie)
.IPs -4
(zalecane przez JVT)
.RE
.PD 1
.
.TP
.B vcelim=<-1000\-1000>
Ustawia próg eliminowania pojedynczych współczynników barwy.
Wartości ujemne będą brały pod uwagę także współczynnik dc (powinny być równe
co najmniej -4 lub niżej dla kodowania z quant=1):
.PD 0
.RSs
.IPs 0
wyłączony (domyślnie)
.IPs 7
(zalecane przez JVT)
.RE
.
.TP
.B vstrict=<-1,0,1>
ścisła zgodność ze standardami
.RSs
.IPs 0
wyłączona (domyślnie)
.IPs 1
zalecane tylko w przypadku, jeżeli chcesz przekazać wyjście do referencyjnego
dekodera MPEG4
.IPs -1
pozwala na niestandardowe kodowanie YV12 huffyuv encoding (o 20% mniejsze pliki,
ale nie mogą być odtwarzane przez oficjalny kodek huffyuv)
.RE
.PD 1
.
.TP
.B vdpart\ 
Dzielenie danych.
Dodaje 2 Bajty do każdego pakietu video, polepsza odporność na błędy podczas
transferu przez niepewne kanały (np.\& przesyłanie poprzez internet)
Każdy pakiet będzie kodowany w 3 oddzielnych częściach:
.PD 0
.RSs
.IPs "1. MVy"
(ruch)
.IPs "2. Współczynniki DC"
(obraz niskiej rozdzielczości)
.IPs "3. Współczyniki AC"
(szczegóły)
.RE
.PD 1
.
.TP
.B \ 
Najważniejsze są MV i DC, ich utrata jest o wiele gorsza niż utrata AC i
później 1. i 2. części.
MV i DC są o wiele mniejsze niż 3. kawałek (AC), co oznacza, że błędy będą
częściej występowały w tej ostatniej niż w dwóch pierwszych.
Dlatego, obraz będzie wyglądał o wiele lepiej z podziałem na części niż bez,
ponieważ bez błędy będą zdarzały się równo w AC/\:DC/\:MV.
.
.TP
.B vpsize=<0\-10000>
rozmiar pakietu video, poprawia odporność na błędy (sprawdź również vdpart):
.RSs
.IPs 0
wyłączone (domyślnie)
.IPs 100-1000
dobry wybór
.RE
.
.TP
.B ss\ \ \ \ \ 
tryb o strukturze plastrowej dla H.263+
.
.TP
.B gray\ \ \ 
kodowanie tylko w skali szarości (szybsze)
.
.TP
.B vfdct=<0\-10>
algorytm dct:
.PD 0
.RSs
.IPs 0
automatycznie wybiera dobry (domyślnie)
.IPs 1
fast integer
.IPs 2
accurate integer
.IPs 3
mmx
.IPs 4
mlib
.IPs 5
altivec
.IPs 6
floating point AAN
.RE
.PD 1
.
.TP
.B idct=<0\-99>
algorytm idct.
.br
.I INFORMACJA:
Z tego co wiemy te wszystkie IDCT przechodzą testy IEEE1180.
.PD 0
.RSs
.IPs 0
automatycznie wybiera dobry (domyślnie)
.IPs 1
jpeg reference integer
.IPs 2
simple
.IPs 3
simplemmx
.IPs 4
libmpeg2mmx (niedokładny, NIE UŻYWAJ do kodowania z keyint >100)
.IPs 5
ps2
.IPs 6
mlib
.IPs 7
arm
.IPs 8
altivec
.IPs 9
sh4
.RE
.PD 1
.
.TP
.B lumi_mask=<0.0\-1.0>
maskowanie jasności
.br
.I UWAGA:
Bądź ostrożny, zbyt duże wartości mogą spowodować okropne rzeczy.
.br
.I UWAGA:
Duże wartości mogą wyglądać dobrze na niektórych monitorach,
a na innych nie:
.RSs
.IPs 0.0
wyłączone (domyślnie)
.IPs 0.0\-0.3
rozsądny zakres
.RE
.
.TP
.B dark_mask=<0.0\-1.0>
maskowanie ciemności
.br
.I UWAGA:
Bądź ostrożny, zbyt duże wartości mogą spowodować okropne rzeczy.
.br
.I UWAGA:
Duże wartości mogą wyglądać dobrze na niektórych monitorach, a na
innych / TV / TFT nie:
.RSs
.IPs 0.0
wyłączone (domyślnie)
.IPs 0.0\-0.3
rozsądny zakres
.RE
.
.TP
.B tcplx_mask=<0.0\-1.0>
maskowanie złożoności czasowej (domyślnie: 0.0 (wyłączone))
.
.TP
.B scplx_mask=<0.0\-1.0>
Maskowanie złożoności przestrzennej.
Większe wartości pomagają przy blokowaniu, jeżeli żadne filtr odblokowania nie
jest stosowany prze dekodowaniu.
.br
.I WSKAZÓWKA:
Usuń wszystkie czarne krawędzie, jako że zmniejszają one jakość
makrobloków (aktualne nawet bez scplx_mask).
.RSs
.IPs 0.0
wyłączone (domyślnie)
.IPs 0.0\-0.5
rozsądny zakres
.RE
.
.TP
.B p_mask=<0.0\-1.0>
Maskowanie inter MB (domyślnie: 0.0 (wyłączone))
.
.TP
.B naq\ \ \ \ 
Normalizuje przystosowywalną kwantyzację (eksperymentalne).
Podczas korzystania z przystosowywalnej kwantyzacji (*_mask), średni
kwantyzatory na MB może już nie odpowiadać żądanemu kwantyzatorowi na poziomie
klatki.
Naq spróbuje dostroić kwantyzatory na MB by utrzymać prawidłową średnią.
.
.TP
.B ildct\ \ 
używa dct z przeplotem
.
.TP
.B ilme\ \ \ 
Używa metody przewidywania ruchu z przeplotem (wzajemnie wykluczający
się z qpel).
.
.TP
.B alt\ \ \ \ 
korzysta z alternatywnej scantable
.
.TP
.B top=<-1\-1>\ \ \ 
.RSs
.IPs -1
automatycznie
.IPs 0
najpierw dolne pole
.IPs 1
najpierw górne pole
.RE
.
.TP
.B format=<wartość>
.RSs
.IPs YV12
domyślny
.IPs 444P
dla ffv1
.IPs 422P
dla huffyuv, bezstratnego jpeg i ffv1
.IPs 411P,YVU9
dla bezstratnego jpeg i ffv1
.IPs BGR32
dla bezstratnego jpeg i ffv1
.RE
.
.TP
.B pred\ \ \ 
(dla huffyuv)
.PD 0
.RSs
.IPs 0
przewidywanie lewej
.IPs 1
czyste/\:gradientowe przewidywanie
.IPs 2
przewidywanie mediany
.RE
.PD 1
.
.TP
.B pred\ \ \ 
(dla bezstratnego JPEG)
.PD 0
.RSs
.IPs 0
przewidywanie lewej
.IPs 1
przewidywanie górnej
.IPs 2
przewidywanie górnej-lewej
.IPs 3
płaszczyznowe/\:gradientowe przewidywanie
.IPs 6
przewidywanie średniej
.RE
.PD 1
.
.TP
.B coder\ \ 
(dla ffv1)
.PD 0
.RSs
.IPs 0
kodowanie vlc (golomb rice)
.IPs 1
kodowanie arytmetyczne (cabac)
.RE
.PD 1
.
.TP
.B context
(dla ffv1)
.PD 0
.RSs
.IPs 0
model małego kontekstu
.IPs 1
model dużego kontekstu
.RE
.PD 1
.
.TP
.B qpel\ \ \ 
Używa kompensacji ruchu quarter pel (wzajemnie wykluczający się z ilme).
Wskazówka: Przydatne tylko dla kodowanie z wysokim bitrate.
.
.TP
.B ildctcmp=<0\-2000>
funkcja porównawcza przy podejmowaniu decyzji dla przeplatanego dct
.
.TP
.B precmp=<0\-2000>
funkcja porównawcza dla wstępnego przejścia przewidywania ruchu
.
.TP
.B cmp=<0\-2000>
funkcja porównawcza dla przewidywania ruchu full pel
.
.TP
.B subcmp=<0\-2000>
funkcja porównawcza dla przewidywania ruchu sub pel
.
.TP
.B mbcmp=<0\-2000>
funkcja porównawcza przy podejmowaniu decyzji dla makrobloku,
wykorzystywana tylko, jeżeli mbd=0
.PD 0
.RSs
.IPs "0 (SAD)"
suma bezwzględnych różnic, szybka (domyślnie)
.IPs "1 (SSE)"
suma kwadratu błędów
.IPs "2 (SATD)"
suma bezwzględnych różnic poddanych tranformacji hadamard
.IPs "3 (DCT)"
suma bezwzględnych różnic poddanych tranformacji dct
.IPs "4 (PSNR)"
suma kwadratów błędów kwantyzacji (nie używaj, niska jakość)
.IPs "5 (BIT)"
ilość bitów wymaganych przez blok
.IPs "6 (RD)"
optymalne pod względem zniekształceń tempa, powolne
.IPs "7 (ZERO)"
0
.IPs "8 (VSAD)"
suma bezwzględnych różnic pionowych
.IPs "9 (VSSE)"
suma kwadratów różnic pionowych
.IPs "10 (NSSE)"
suma kwadratów różnic zachowująca szumy
.IPs +256\ 
wykorzystuje też barwę, obecnie nie działa (prawidłowo) z klatkami typu B
.RE
.PD 1
.
.TP
.B nsse_weight=<0\-100>
Waga NSSE, większe wartości zaowocują większymi szumami, wartość 0 dla NSSE
jest równoważna z SSE.
.
.TP
.B predia=<-99\-6>
Typ i rozmiar diamentu dla wstępnego przejścia przewidywania ruchu
.
.TP
.B dia=<-99\-6>
Typ i rozmiar diamentu dla przewidywania ruchu
.br
.I INFORMACJA:
Rozmiary normalnych diamentów i tych przystosowujących kształty nie mają
takiego samego efektu.
.RSs
.IPs -3
diament przystosowujący kształt (szybkie) o rozmiarze 3
.IPs -2
diament przystosowujący kształt (szybkie) o rozmiarze 2
.IPs -1
eksperymentalne
.IPs  1
normalny diament o rozmiarze=1 (domyślnie) =diament typu EPZS
.nf
.ne
      0
     000
      0
.fi
.IPs 2
normalny diament o rozmiarze=2
.nf
.ne
      0
     000
    00000
     000
      0
.fi
.RE
.
.TP
.B trell\ \ 
Kwantyzacja przeszukiwana kratowo.
Funkcja ta znajdzie optymalne kodowanie dla każdego bloku 8x8.
Kwantyzacja przeszukiwana kratowo jest po prostu dobrą optymalizacją, w sensie
PSNR kontra bitrate (zakładając, że nie będzie żadnych błędów zaokrągleń
mogących powstać w skutek działania IDCT, czyli oczywiście nie w tym przypadku).
Po prostu znajduje blok dla minimalnej ilości błędów i bitów*lambda.
.PD 0
.RSs
.IPs lambda
zmienna uzależniona od parametru kwantyzacji (QP)
.IPs bits\ 
ilość bitów potrzebna do zakodowania bloku
.IPs error
suma kwadratów błędów kwantyzacji
.RE
.PD 1
.
.TP
.B cbp\ \ \ \ 
Zakodowany wzór bloku optymalny pod względem zniekształceń tempa.
Znajdzie taki wzór, który zminimalizuje zniekształcenia + tempo+lambda.
Opcja ta może być używana tylko w połączeniu z kwantyzacja kratową.
.
.TP
.B mv0\ \ \ \ 
Spróbuje zakodować każdy MB z MV=<0,0> i wybierze lepszy.
Nie ma to znaczenia jeżeli mbd=0.
.
.TP
.B qprd (tylko z mbd=2) 
parametr kwantyzacji (QP) optymalny pod względem zniekształceń tempa dla
lambda podanej dla każdego makrobloku
.
.TP
.B last_pred=<0\-99>
Ilość przewidywaczy ruchu z poprzedniej ramki
.PD 0
.RSs
.IPs 0
(domyślnie)
.IPs a
wykorzysta makroblokowy kwadrat o wymiarach 2a+1 x 2a+1 wektorów przewidywaczy ruchu
z poprzedniej ramki
.RE
.PD 1
.
.TP
.B preme=<0\-2>
wstępne przejście przewidywania ruchu
.PD 0
.RSs
.IPs 0
wyłączone
.IPs 1
tylko po klatkach I (domyślnie)
.IPs 2
zawsze
.RE
.PD 1
.
.TP
.B subq=<1\-8>
jakość udoskonalenia subpel (dla qpel) (domyślnie: 8 (wysoka jakość)).
.br
.I INFORMACJA:
Ma to poważny wpływ na szybkość.
.
.TP
.B psnr\ \ \ 
Drukuje PSNR (wartość szczytowa proporcji sygnału do szumu) dla całego filmu
po kodowaniu i przechowuje PSNR dla każdej klatki w pliku o nazwie
typu "psnr_hhmmss.log".
Zwracane wartości są w dB (decybelach), im wyższe tym lepsze.
.
.TP
.B mpeg_quant
Wykorzystuje kwantyzatory MPEG zamiast H.263.
.
.TP
.B aic\ \ \ \ 
przewidywanie ac (=zaawansowane przewidywanie intra dla H.263+)
.br
.I INFORMACJA:
vqmin powinno być równe 8 lub większe dla AIC H.263+.
.
.TP
.B aiv\ \ \ \ 
alternatywne inter vlc dla H.263+
.
.TP
.B umv\ \ \ \ 
nieograniczona liczba MV (tylko H.263+)
Zezwala na kodowanie z dowolnie długimi MV.
.
.TP
.B ibias=<-256\-256>
bias kwantyzatora intra (256 odpowiada 1.0, domyślny kwantyzator w stylu MPEG: 96,
domyślny kwantyzator w stylu H.263: 0)
.I INFORMACJA:
Kwantyzator MMX H.263 nie umie obsłużyć dodatnich wartości bias (ustaw
vfdct=1 lub 2),
kwantyzator MMX MPEG nie umie obsłużyć ujemnych wartości bias (ustaw
vfdct=1 lub 2).
.
.TP
.B pbias=<-256\-256>
bias kwantyzatora inter (256 odpowiada 1.0, domyślny kwantyzator w stylu MPEG: 0,
domyślny kwantyzator w stylu H.263: -64)
.I INFORMACJA:
Kwantyzator MMX H.263 nie umie obsłużyć dodatnich wartości bias (ustaw
vfdct=1 lub 2),
kwantyzator MMX MPEG nie umie obsłużyć ujemnych wartości bias (ustaw
vfdct=1 lub 2).
.br
.I WSKAZÓWKA:
Większa wartość bias (-32 \- -16 zamiast -64) wydaje się polepszać PSNR.
.
.TP
.B nr=<0\-100000>
redukcja szumów, 0 oznacza wyłączoną
.
.TP
.B qns=<0\-3>
Kształtowanie szumu kwantyzatora, ogranicza dźwięczące pozostałości, większe
wartości są wolniejsze, ale nie koniecznie wpłyną na polepszenie jakości.
Opcja może i powinna być używana razem z kwantyzacją kratową, w takim przypadku
kwantyzacja kratowa (optymalna dla stałej wagi) będzie wykorzystana jako
punkt startowy dla przeszukiwania iteracyjnego.
.PD 0
.RSs
.IPs 0
wyłączone (domyślnie)
.IPs 1
obniża tylko bezwzględną wartość współczynników
.IPs 2
zmienia tylko współczynniki przed ostatnim niezerowym współczynnikiem + 1
.IPs 3
spróbuje wszystkiego
.RE
.PD 1
.
.TP
.B inter_matrix=<matryca oddzielona przecinkami>
Wykorzystuje zdefiniowaną przez użytkownika matrycę inter.
Wymaga łańcucha oddzielonych przecinkami 64 liczb całkowitych.
.
.TP
.B intra_matrix=<matryca oddzielona przecinkami>
Wykorzystuje zdefiniowaną przez użytkownika matrycę intra.
Wymaga łańcucha oddzielonych przecinkami 64 liczb całkowitych.
.
.TP
.B vqmod_amp
eksperymentalna modulacja kwantyzatora
.
.TP
.B vqmod_freq
eksperymentalna modulacja kwantyzatora
.
.TP
.B dc\ \ \ \ \ 
Precyzja intra DC podana w bitach (domyślnie: 8).
Jeżeli podasz vcodec=mpeg2video, może przyjąć wartości 8, 9, 10 lub 11.
.
.TP
.B cgop\ \ \ 
Zamyka wszystkie GOPy.
Obecnie nie działa (jeszcze).
.
.
.SS nuv (\-nuvopts)
.
Video Nuppel jest oparte na rtjpeg i lzo.
Domyślnie najpierw ramki są kodowane przez rtjpeg, potem kompresowane przez lzo.
Ale oba przejścia mogą być włączone lub nie.
Czyli właściwie możesz stworzyć wyjście w formacie raw i420, spakowane przez
lzo i420, rtjpeg, lub domyślne spakowane przez lzo rtjpeg.
.br
.I INFORMACJA:
Dokumentacja nuvrec zawiera kilka porad i przykładów obrazujących użycie
różnych ustawień dla najbardziej popularnych kodowań TV.
.
.TP
.B c=<0\-20>
zakres barw
.
.TP
.B l=<0\-20>
zakres jasności
.
.TP
.B nolzo \ 
Wyłącza kompresję lzo.
.
.TP
.B q=<3\-255>
Ustawia poziom jakości.
.
.TP
.B raw \ \ \ 
Wyłącza kodowanie rtjpeg.
.
.TP
.B rtjpeg\ 
Włącza kodowanie rtjpeg.
.
.
.SS xvidenc (\-xvidencopts)
.
Dostępne są trzy tryby: stały bitrate (CBR), ustalony kwantyzator
i dwuprzejściowy.
.
.TP
.B pass=<1|2>
Określa przejście w trybie dwuprzejściowym.
.
.TP
.B bitrate=<wartość>
Ustawia żądany bitrate w kbit/\:sekundę jeżeli <16000
lub w bit/\:sekundę jeżeli >16000.
Jeśli <wartość> jest ujemna, XviD użyje jej wartości bezwzględnej jako
docelowej wielkości zbioru (w kilobajtach) i automatycznie wyliczy bitrate.
(CBR lub tryb dwuprzejściowy, domyślnie: 687 kbits/\:s)
.
.TP
.B fixed_quant=<1\-31>
Przełącza w tryb ustalonego kwantyzatora i określa jego wielkość.
.
.TP
.B me_quality=<0\-6>
Opcja ta kontroluje podsystem przewidywania ruchu.
Im wyższa wartość, tym przewidywanie będzie dokładniejsze.
Im lepsze przewidywanie tym lepsza kompresja.
Precyzja jest osiągana kosztem mocy obliczeniowej, więc zmniejsz jej wartość,
jeżeli masz zamiar kodować w czasie rzeczywistym.
(domyślnie: 6)
.
.TP
.B interlacing
Koduje pola filmu z przeplotem.
Jeżeli korzystasz z materiału filmowego z przeplotem, włącz tę opcję.
.br
.I INFORMACJA:
Jeśli chciałbyś przeskalować film, potrzebowałbyś filtru skalującego,
który wiedziałby, że ma do czyniena z materiałem zawierającym przeplot,
możesz go uruchomić przez -vf scale=<szerokość>:<wysokość>:1.
.
.TP
.B 4mv\ \ \ \ 
Korzysta z 4 wektorów ruchu na makroblok.
Może dać lepszą kompresję kosztem wolniejszego kodowania.
.br
.I UWAGA:
Parametr ten jest już uznawany za przestarzały w XviD-1.0.x, jako że wszystko
jest teraz realizowane przez opcję me_quality.
Kiedy me_quality > 4, 4mv jest uruchamiane.
.
.TP
.B rc_reaction_delay_factor=<wartość>
Ten parametr określa ilość ramek, jaką przeczeka kontroler tempa CBR
zanim zareaguje na zmianę wartości bitrate i będzie próbował wyrównać zmianę,
tak aby uzyskać stały bitrate na uśredniającym zakresie klatek.
.
.TP
.B rc_averaging_period=<wartość>
Prawdziwe CBR jest trudne do osiągnięcia.
Zależnie od materiału filmowego, bitrate może być zmienny i trudny do
przewidzenia.
Dlatego XviD wykorzystuje okres uśredniający, dla którego gwarantuje zadaną
ilość bitów (minus mała różnica).
To ustawienie wyraża "ilość klatek", dla których XviD uśrednia bitrate i próbuje
osiągnąć CBR.
.
.TP
.B rc_buffer=<wartość>
rozmiar bufora kontroli tempa
.
.TP
.B quant_range=<1\-31>\-<1\-31>[/\:<1\-31>\-<1\-31>]
Tryb CBR: min.\& i maks.\& kwantyzator dla wszystkich klatek (domyślnie: 2\-31)
.br
Tryb dwuprzejściowy: min.\& i maks.\& kwantyzator dla klatek I/P
(domyślnie: 2\-31/\:2\-31)
.br
.I UWAGA:
Ta opcja jest odradzana w XviD-1.0.x i jest zastąpiona przez
opcje [min|max]_[i|p|b]quant.
.
.TP
.B min_key_interval=<wartość>
minimalna przerwa między klatkami kluczowymi
(domyślnie: 0, tylko tryb dwuprzejściowy)
.
.TP
.B max_key_interval=<wartość>
maksymalna przerwa między klatkami kluczowymi (domyślnie: 10*fps)
.
.TP
.B mpeg_quant
Używa kwantyzatorów MPEG zamiast H.263.
Dla wysokich wartości bitrate, zauważysz, że kwantyzacja MPEG zachowa więcej
szczegółów.
Dla niskich wartości bitrate, wygładzanie H.263 da w rezultacie mniej szumu
blokowego.
Kiedy wykorzystywane są określone przez użytkownika matryce, musi być
wykorzystywany MPEG.
.br
.I UWAGA:
Ta opcja jest odradzana w XviD-1.0.x i jest zastąpiona przez opcję quant_type.
.
.TP
.B mod_quant
Decyduje czy wykorzystywać kwantyzatory MPEG czy H.263 na podstawia badania
klatka po klatce (tylko tryb dwuprzejściowy).
.br
.I UWAGA:
Wygeneruje to nieprawidłowy stumień bitów, którego prawdopodobnie nie jest w
stanie zdekodować żaden dekoder MPEG4 poza libavcodec albo XviD.
(tylko tryb dwuprzejściowy)
.br
.I UWAGA:
Ta opcja jest odradzana w XviD-1.0.x.
.
.TP
.B keyframe_boost=<0\-1000>
Przesuwa kilka bitów z ramek innego rodzaju do klatek intra,
polepszając przez to jakość klatek kluczowych.
(domyślnie: 0, tylko tryb dwuprzejściowy)
.
.TP
.B kfthreshold=<wartość>
(domyślnie: 10, tylko tryb dwuprzejściowy)
.
.TP
.B kfreduction=<0\-100>
Powyższe dwa parametry mogą być wykorzystane do określenia rozmiaru klatek
kluczowych, których położenie uważasz za zbyt bliskie do pierwszej (w rzędzie).
kfthreshold ustawia zakres, w którym klatki kluczowe są redukowane, a
kfreduction określa ich redukcję bitrate'ową.
Ostatnia klatka I jest traktowana normalnie.
(domyślnie: 30, tylko tryb dwuprzejściowy)
.
.TP
.B greyscale
Sprawia, że XviD ignoruje przestrzeń kolorów, więc wynikowy film jest
w skali szarości.
Zauważ, że nie przyspiesza to kodowania, zapobiega to tylko zapisaniu
danych kolorów w ostatniej fazie kodowania.
.
.TP
.B debug\ \ 
Zapisuje statystyki każdej ramki w ./xvid.dbg.
(To nie jest plik kontroli trybu dwuprzejściowego).
.RE
.
.PP
.sp 1
Poniższe opcje są dostępne tylko w najnowszych stabilnych
wersjach XviD 1.0.x (api4).
.
.TP
.B packed\ 
Tworzy strumień który może być dekodowany bez opóźnień.
.br
.I UWAGA:
Stworzy to niepoprawny strumień bitów i NIE BĘDZIE on odtwarzany przez
dekodery ISO-MPEG4 poza DivX/\:libavcodec/\:XviD.
.br
.I UWAGA:
Zapisuje to także fałszywą wersję DivX do pliku,
więc autodedetekcja błędów niektórych dekoderów może się gubić.
.
.TP
.B divx5bvop
Wygeneruje kompatybilne z DivX5 klatki B (domyślnie: włączone).
.
.TP
.B max_bframes=<0\-4>
maksymalna ilość klatek B umieszczonych pomiędzy klatkami I/\:P (domyślnie: 0)
.
.TP
.B bquant_ratio=<0\-1000>
proporcja kwantyzatora między ramkami typu B i pozostałymi, 150=1.50
(domyślnie: 150)
.
.TP
.B bquant_offset=<-1000\-1000>
współczynnik offsetu kwantyzatora pomiędzy klatkami B a pozostałymi,
100=1.00 (domyślnie: 100)
.
.TP
.B bf_threshold=<-255\-255>
Czasami klatki B nie wyglądają dobrze i występują na nich zniekształcenia,
kiedy większość klatki jest statyczna a tylko małe strefy zawierają
dużo ruchu (w statycznej scenie z gadającym człowiekiem, jego
usta będą najprawdopodobniej wyglądały źle, jeśli całe tło jest
całkowicie statyczne).
Ten parametr umożliwia Ci określenie, jaki priorytet użycia klatek B
ma być ustawiony.
Im wyższa wartość,tym większe prawdopodobieństwo użycia klatek B.
(domyślnie: 0)
.
.TP
.B frame_drop_ratio=<0\-100> (tylko z ax_bframes=0)
Ten parametr umożliwia tworzenie strumieni video ze zmienną szybkością klatek.
Jeśli różnica między bieżącą a poprzednią klatką
jest niższa lub równa od ustawionego przez ten parametr progu,
klatka nie będzie kodowana (tzw. n-vop zostanie wstawiany w strumień).
Przy odtwarzaniu, natrafienie na n-vop, powoduje wyświetlenie poprzedniej
klatki.
.br
.I OSTRZEŻENIE:
Odtwarzanie z tym parametrem może spowodować, że film będzie poszarpany, więc
używaj go na swoją własną odpowiedzialność!
.
.TP
.B qpel\ \ \ 
MPEG4 domyślnie używa precyzji co do połowy piksela przy wyszukiwaniu ruchu.
Standard proponuje tryb, w którym kodery mogą korzystać z precyzji quarter
pixel (co do ćwierć piskela).
Opcja to przeważnie sprawia, że obraz jest ostrzejszy.
Niestety ma to duży wpływ na wartość bitrate i czasami wykorzystanie wyższej
wartości spowoduje otrzymanie gorszego obrazu przy stałym bitrate.
Najlepiej jest sprawdzić rezultat z i bez tej opcji, i samemu zdecydować czy
jest warta włączenia.
.
.TP
.B gmc\ \ \ \ 
Włącza Globalną Kompensację Ruchu, która sprawia, że XviD generuje specjalne
klatki (klatki GMC), które są dobrze przystosowane do
przesuwania/\:przybliżonia/\:obracania obrazów.
To, czy włączenie tej opcji zaoszczędzi bity zależy od materiału filmowego.
.
.TP
.B trellis
Kwantyzacja kratowa (Trellis Quantization) jest rodzajem metody kwantyzacji
adaptatywnej, która zachowuje bity poprzez modyfikację skwantyzowanych
współczynników, tak aby lepiej ulagały kompresji przez koder entropii.
Dobrze wpływa na poprawę jakości, a jeśli VHQ używa wg Ciebie zbyt dużo mocy
obliczeniowej, ta opcja może być dobrą alternatywą zaoszczędzającą
kilku bitów (i poprawiającą jakość przy stałym bitrate) przy mniejszym
obciążeniu niż VHQ.
.
.TP
.B cartoon
Włącz tę opcję, jeżeli kodowana sekwencja jest rysunkowa.
Modyfikuje ona kilka wewnętrznych progów XviD, tak że te podejmuje
lepsze decyzje o typie ramek i wektorach ruchu dla płaskich rysunków.
.
.TP
.B quant_type=<h263|mpeg>
Ustawia typ wykorzystywanego kwantyzatora.
Dla wysokich wartości bitrate, kwantyzacja MPEG zachowa więcej szczegółów.
Dla niskich wartości bitrate, wygładzanie H.263 da mniej szumów blokowych.
Jeśli używasz własnych macierzy, musi być ustawiona kwantyzacja MPEG.
.
.TP
.B chroma_me
Zwykły algorytm przewidywania ruchu używa tylko informacji o jasności
dla znalezienia najlepszego wektora ruchu.
Jednakże dla niektórych filmów, wykorzystanie przestrzeni kolorów pozwoli
znaleźć lepsze wektory.
Ten parametr włącza wykorzystanie przestrzeni barw do przewidywania ruchu.
.
.TP
.B chroma_opt
Uruchamia prefiltr optymalizacji barw.
Poczaruje to trochę nad danymi o kolorach żeby zmniejszyć widoczny na
krawędziach efekt schodów.
Poprawia jakość kosztem prędkości kodowania.
Z natury zmniejsza PSNR, jako że podnosi matematyczne odchylenie od
oryginalnego obrazu, ale poprawia subiektywną jakość obrazu.
Jako że działa na informacji o kolorach, możesz chcieć to wyłączyć jeśli
kodujesz w skali szarości.
.
.TP
.B hq_ac\ \ 
Włącza lepsze przewidywania składowej AC z sąsiednich bloków.
.
.TP
.B vhq=<0\-4>
Algorytm wyszukiwania ruchu jest oparty na szukaniu w zwykłej domenie koloru i
próbuje znaleźć wektor ruchu, który zminimalizuje różnice między ramką
odniesienia a zakodowaną.
Z tym parametrem XviD użyje również domenę częstotliwości (DCT),
aby szukać wektora ruchu, który nie tylko zminimalizuje różnicę przestrzenną,
ale również długość kodowania bloku.
Od najszybszego do najwolniejszego:
.PD 0
.RSs
.IPs 0
wyłączone (domyślnie)
.IPs 1
decyzja dotycząca trybu (inter/\:intra MB)
.IPs 2
ograniczone przeszukiwanie
.IPs 3
średnie przeszukiwanie
.IPs 4
szerokie przeszukiwanie
.RE
.PD 1
.
.TP
.B min_iquant=<0\-31>
minimalny kwantyzator klatek I (domyślnie: 2)
.
.TP
.B max_iquant=<0\-31>
maksymalny kwantyzator klatek I (domyślnie: 31)
.
.TP
.B min_pquant=<0\-31>
minimalny kwantyzator klatek P (domyślnie: 2)
.
.TP
.B max_pquant=<0\-31>
maksymalny kwantyzator klatek P (domyślnie: 31)
.
.TP
.B min_bquant=<0\-31>
minimalny kwantyzator klatek B (domyślnie: 2)
.
.TP
.B max_bquant=<0\-31>
maksymalny kwantyzator klatek B (domyślnie: 31)
.
.TP
.B quant_intra_matrix=<nazwa\ pliku>
Wczytuje plik z określoną macierzą intra.
Możesz stworzyć taki plik edytorem macierzy xvid4conf.
.
.TP
.B quant_inter_matrix=<nazwa\ pliku>
Wczytuje plik z określoną macierzą inter.
Możesz stworzyć taki plik edytorem macierzy xvid4conf.
.
.TP
.B curve_compression_high=<0\-100>
Ten parametr pozwala XviD'owi na przekazanie określonego procentu bitów ze scen
o wysokiej wartości bitrate do rezerwy bitowej.
Możesz również skorzystać z tej opcji, jeśli masz klip z tak dużą ilością
bitów przeznaczoną na sceny o wysokiej wartości bitrate, że sceny z niższą wartością
wyglądają źle (domyslnie: 0).
.
.TP
.B curve_compression_low=<0\-100>
Ten parametr pozwala XviD'owi na przekazanie określonego procentu dodatkowych
bitów do scen z niską wartością bitrate z całego klipu.
Opcja ta może być przydatna, jeżeli masz kilka scen z niską wartością bitrate,
które są ciągle blokowe (domyślnie: 0).
.
.TP
.B overflow_control_strength=<0\-100>
Podczas pierwszego przebiegu w kodowaniu dwuprzebiegowym obliczana jest
przeskalowana krzywa bitrate.
Różnica między oczekiwaną krzywą a wynikową otrzymaną podczas kodowania
nazywana jest overflow (przepełnienie - przyp. tłumacza).
Oczywiście dwuprzebiegowy kontroler tempa stara się
zniwelować tę różnicę przez rozpraszanie jej na kolejne klatki.
Ten parametr kontroluje ile overflow jest rozpraszane za każdym razem,
kiedy pojawia się nowa klatka.
Niskie wartości pozwalają na leniwą kontrolę overflow, wielkie różnice
są kompensowane wolniej (może to doprowadzić do braku precyzji
przy małych filmach).
Wyższe wartości sprawiają, że redystrybucja bitów jest gwałtowniejsza,
czasami zbyt gwałtowna, jeśli ustawisz opcję na zbyt wysoką,
co może doprowadzić do powstania zniekształceń (domyślnie: 5).
.br
.I INFORMACJA:
Ten parametr ma duży wpływ na jakość, baw się nim ostrożnie!
.
.TP
.B max_overflow_improvement=<0\-100>
Podczas alokacji bitów w klatce, kontrola overflow może zwiększyć jej rozmiar.
Parametr ten określa maksymalny procent rozmiaru o jaki kontrola overflow
może zwiekszyć klatkę, w porównaniu z idealną alokacją krzywej (domyślnie: 5).
.
.TP
.B max_overflow_degradation=<0\-100>
Podczas alokacji bitów w klatce, kontrola overflow może zmniejszyć jej rozmiar.
Parametr ten określa maksymalny procent rozmiaru o jaki kontrola overflow
może zmniejszyć klatkę, w porównaniu z idealną alokacją krzywej (domyślnie: 5).
.
.TP
.B container_frame_overhead=<0..>
Określa średnią nadwyżkę (overhead) przypadającą na klatkę w bajtach.
Przeważnie użytkownicy określają żadany bitrate bez brania pod uwagę
nadwyżki na ramkę video.
Ta mała ale (przeważnie) stała nadwyżka może spowodować, że docelowy rozmiar
pliku zostanie przekroczony.
XviD pozwala użytkownikom na ustawienie wielkości nadwyżki
przypadającej na klatkę, którą generuje ramka video (podaj tylko
uśrednioną wartość na ramkę).
0 ma specjalne znaczenie, pozwala XviD'owi na użycie jego własnych
wartości domyślnych (domyślnie: 24 - średnia nadwyżka AVI).
.
.TP
.B par=<tryb>
Określa tryb Współczynnika Proporcji Piksela (Pixel Aspect Ratio - PAR)
(nie mylić z Współczynnikiem Proporcji Obrazu (Display Aspect Ratio - DAR)).
PAR to stosunek szerokości do wysokości pojedynczego piksela.
Więc oba są związane: DAR = PAR * (szerokość/wysokość).
.br
MPEG4 określa 5 współczynników proporcji piksela i jeden rozszerzony,
dający szansę na podanie konkretnego współczynnika proporcji piksela.
Może być podany jeden z 5 standardowych trybów:
.PD 0
.RSs
.IPs vga11
zwyczajny PAR dla PC
Piksele są jednostką kwadratową.
.IPs pal43
standard dla PAL - 4:3 PAR
Piksele są prostokątami.
.IPs pal169
jak wyżej
.IPs ntsc43
jak wyżej
.IPs ntsc169
jak wyżej (Nie zapomnij podać dokładnego współczynnika.)
.IPs ext\ \ 
Pozwala na określenie własnego współczynnika proporcji piksela przez par_width
i par_height.
.RE
.PD 1
.br
.I INFORMACJA:
Ogólnie ustawienie opcji aspect i autoaspect jest wystarczające.
.
.TP
.B par_width=<1\-255> (tylko z par=ext)
Określa szerokość zadeklarowanego współczynnika proporcji piksela.
.
.TP
.B par_height=<1\-255> (tylko z par=ext)
Określa wysokość szerokość zadeklarowanego współczynnika proporcji piksela.
.
.TP
.B aspect=<x/\:y | f (wartość rzeczywista)>
Przechowuje proporcje wewnętrznie, podobnie jak pliki MPEG.
O wiele lepsze rozwiązanie niż ponowne skalowanie, ponieważ nie spada jakość.
Tylko MPlayer i kilka innych odtwarzaczy będą interpretowały te pliki poprawnie,
inne wyświetlą je w złych proporcjach.
Parametr proporcji może być podany jako proporcja lub liczba rzeczywista.
.
.TP
.B autoaspect
Podobnie jak opcja aspect, ale proporcja wyliczana jest automatycznie, biorąc
pod uwagę wszystkie filtry dostrajające (crop/\:expand/\:scale/\:itp.) podane w
łańcuchu.
.
.TP
.B psnr\ \ \ 
Drukuje PSNR (wartość szczytowa proporcji sygnału do szumu) dla całego filmu po
kodowaniu i przechowuje PSNR dla każdej klatki w pliku o nazwie typu
"psnr_hhmmss.log" w bieżącym katalogu.
Zwracane wartości są w dB (decybelach), im wyższe tym lepsze.
.
.
.SS x264enc (\-x264encopts)
.
.TP
.B bitrate=<wartość>
Ustawia użyty bitrate w kbit/\:sekunda (domyślnie: wyłączone).
Ta opcja jest konieczna, jeżeli chcesz kodować z CBR (stały bitrate).
.
.TP
.B iframe=<wartość>
Częstotliwość występowania klatek I (domyślnie: 60)
.
.TP
.B frameref=<wartość>
Ilość poprzednich klatek wykorzystanych do przewidywania w klatkach P
(domyślnie: 1).
Może to wywołać niewielkie zmiany w bitrate i PSNR.
Niektóre dekodery nie radzą sobie z dużymi wartościami frameref.
.
.TP
.B idrframe=<wartość>
Każde <wartość> klatek I jest klatkami IDR (domyślnie: 2).
W H.264 klatki I niekoniecznie przeskakują zamknięty GOP, ponieważ jest
dozwolone dla klatki P, aby była przewidziana z większej liczby poprzedzających 
ją klatek niż tylko jedna (sprawdź też opcję frameref).
Dlatego też niekoniecznie da się przewijać do klatek I.
Ramki IDR ograniczają odnoszenie się klatki P do jakiejkolwiek ramki
poprzedzającej klatkę IDR.
.
.TP
.B bframe=<wartość>
liczba klatek B pomiędzy klatkami I i P (domyślnie: 0)
.
.TP
.B deblock=<0|1>
Wykorzystuje filtr deblokujący (deblock) (domyślnie: włączony).
.
.TP
.B deblockalpha=<-6\-6>
Parametr AlphaC0 dla filtru deblokującego (deblock) (domyślnie: 0).
Opcja ta dostosowuje zakresy dla filtru deblokującego H.264.
Po pierwsze parametr ten określa maksymalną ilość zmian jaką filtr może
nanieść na pojedynczy piksel.
Po drugie opcja ta ma wpływ na próg filtrowanej różnicy występującej na krawędzi.
Wartość dodatnia ogranicza blokujące szumy, ale rozmywa również detale.
.
.TP
.B deblockbeta=<-6\-6>
Parametr Beta filtru deblokującego (deblock) (domyślnie: 0).
Ma wpływ na maksymalny, dozwolony gradient między dwoma przylegającymi blokami.
.
.TP
.B cabac\ \ \ 
Wykorzystuje CABAC (Context-Adaptive Binary Arithmetic Coding).
.
.TP
.B cabacidc=<wartość>
Wartość początkowa CABAC IDC.
Koder musi wybrać kontekst dla każdego bloku, który koduje, Jednak dla
pierwszego bloku w klatce, nie ma żadnych poprzedzających go bloków.
Dostosowanie tego parametru może zmienić bitrate o ułamek procenta,
ale nie ma bezpośrednego wpływu na zniekształcenie.
.RSs
-1: Koder wybiera kontekst, zazwyczaj 0 (domyślne).
.br
0: niska złożoność
.br
1: średnia złożoność
.br
2: wysoka złożoność
.REss
.
.TP
.B qp_constant=<2\-51>
Określa, który kwantyzator zostanie użyty, 20\-40 to użyteczny zakres
(domyślnie: 26).
Niższe wartości to lepsze odwzorowanie, ale większe parametry bitrate.
Zauważ, że kwantyzacja w H.264 działa inaczej niż w MPEG[124].
Parametr kwantyzacji (QP) H.264 jest w skali logarytmicznej.
Dla przykładu, różnica w bitrate pomiędzy QP=20 a QP=40 to współczynnik
około 10.
Przydatne kwantyzatory w H.264 są większe niż w MPEG[124].
.
.TP
.B qp_min=<2\-51> (tylko CBR)
Minimalny kwantyzator, 15\-35 to użyteczny zakres (domyślnie: 10).
.
.TP
.B qp_max=<2\-51>  (tylko CBR)
maksymalny kwantyzator (domyślnie: 51)
.
.TP
.B qp_step=<wartość>
Maksymalna wartość o jaką kwantyzator może być zwiększony/zmniejszony
pomiędzy klatkami.
.
.TP
.B rc_buffer_size=<wartość>
rozmiar bufora kontroli tempa (domyślnie: 1 sekunda przy określonym bitrate)
.
.TP
.B rc_init_buffer=<wartość>
Ustawia początkowego bufora kontroli tempa (domyślnie: 1/4 rc_buffer_size)
.
.TP
.B rc_sens=<0\-100>
czułość kontroli tempa (domyślnie: 4)
.
.TP
.B ip_factor=<wartość>
współczynnik kwantyzatora między klatkami I a P (domyślnie: 2.0)
.
.TP
.B pb_factor=<wartość>
współczynnik kwantyzatora między klatkami P a B (domyślnie: 2.0)
.
.TP
.B pass=<1|2>
Uruchamia tryb dwuprzejściowy.
Pierwsze przejście zachowuje statystyki.
.
.TP
.B qcompress=<0\-1>
Kompresja kwantyzatora (domyślnie: 0.6).
Wpływa na kontrolę tempa: niższa wartość sprawia, że bitrate
jest bardziej stały, podczas gdy wyższa, sprawia, że parametr kwantyzacji
jest bardziej stały.
.
.TP
.B qblur=<0\-99>
Tymczasowe rozmazanie parametru kwantyzacji (domyślnie: 0.5).
Niższe wartości pozwalają na większe skoki wartości kwantyzatora,
wyższe zmuszają go do delikatniejszych zmian.
.
.TP
.B fullinter
Wykorzystuje wszystkie dostępne metody analizy inter-klatek (i4x4, psub8x8, psub16x16)
(domyślnie: 4x4, psub16x16).
.
.TP
.B log=<-1\-3>
Określa ilość informacji drukowanych na ekranie.
.RSs
-1: żadne
.br
 0: Wyświetla tylko błędy.
.br
 1: ostrzeżenia
.br
 2: PSNR, czas kodowania i inne statystyki analiz po skończonym kodowaniu
 (domyślne)
.br
 3: PSNR, QP, typ klatki, rozmiar i inne statystyki dla każdej klatki
.REss
.
.TP
.B psnr\ \ \ 
Drukuje statystyki stosunku sygnału do szumu.
.
.
.\" --------------------------------------------------------------------------
.\" Pliki
.\" --------------------------------------------------------------------------
.
.SH PLIKI
.
.TP
/usr/\:local/\:etc/\:mplayer/\:mplayer.conf
główny plik ustawień
.
.TP
~/.mplayer/\:config
ustawienia użytkownika
.
.TP
~/.mplayer/\:input.conf
ustawienia wejścia (pełną listę wyświetla '\-input keylist')
.
.TP
~/.mplayer/\:gui.conf
plik konfiguracyjny GUI
.
.TP
~/.mplayer/\:gui.pl
playlista GUI
.
.TP
~/.mplayer/\:font/
katalog czcionki (Musi znajdować się tutaj plik font.desc i plik z
rozszerzeniem .RAW.)
.
.TP
~/.mplayer/\:DVDkeys/
Zkrakowane klucze CSS
.
.TP
Zakładając, że odtwarzana jest /ścieżka/\:do/\:film.avi, MPlayer będzie szukał
napisów w następującej kolejności:
.RSs
/ścieżka/\:do/\:film.sub
.br
~/.mplayer/\:sub/\:film.sub
.br
~/.mplayer/\:default.sub
.RE
.PD 1
.
.
.\" --------------------------------------------------------------------------
.\" Przykłady
.\" --------------------------------------------------------------------------
.
.SH PRZYKŁADY
.
.TP
.B Szybki start odtwarzania DVD:
mplayer dvd://1
.
.TP
.B Odtwarza w japońskim z angielskimi napisami:
mplayer dvd://1 \-alang ja \-slang en
.
.TP
.B Odtwarza tylko rozdziały 5, 6, 7:
mplayer dvd://1 \-chapter 5-7
.
.TP
.B Odtwarza tylko tytuły 5, 6, 7:
mplayer dvd://5-7
.
.TP
.B Odtwarza DVD z różnych ujęć:
mplayer dvd://1 \-dvdangle 2
.
.TP
.B Odtwarza z innego urządzenia DVD:
mplayer dvd://1 \-dvd-device /dev/\:dvd2
.
.TP
.B Strumień z HTTP:
mplayer http://mplayer.hq/\:przyklad.avi
.
.TP
.B Strumień używający RTSP:
mplayer rtsp://serwer.przyklad.com/\:nazwaStrumienia
.
.TP
.B Konwertuje napisy do formatu MPsub:
mplayer test.avi \-sub zródło.sub \-dumpmpsub
.
.TP
.B Konwertuje napisy do formatu MPsub bez konieczności oglądania filmu:
mplayer /dev/\:zero \-rawvideo on:pal:fps=xx \-vc null \-vo null \-noframedrop
\-benchmark \-sub źródło.sub \-dumpmpsub
.
.TP
.B Wejście z domyślnego V4L:
mplayer tv:// \-tv driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420
\-vo xv
.
.TP
.B Odtwarzanie na kartach Zoran (w starym stylu, odradzane):
mplayer \-vo zr \-vf scale=352:288 plik.avi
.
.TP
.B Odtwarzanie na kartach Zoran (w nowym stylu):
mplayer \-vo zr2 \-vf scale=352:288,zrmjpeg plik.avi
.
.TP
.B Kodowanie tytułu #2 DVD, tylko wybrane rozdziały:
mencoder dvd://2 \-chapter 10-15 \-o tytul2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
.
.TP
.B Kodowanie tytułu #2 DVD, zmiana rozmiaru do 640x480:
mencoder dvd://2 \-vf scale=640:480 \-o tytul2.avi \-oac copy \-ovc lavc \-lavcopts vcodec=mpeg4
.
.TP
.B Kodowanie tytułu #2 DVD, zmiana rozmiaru do 512xHHH (zachowuje proporcje):
mencoder dvd://2 \-vf scale \-zoom \-xy 512 \-o tytul2.avi \-oac copy
\-ovc lavc \-lavcopts vcodec=mpeg4
.
.TP
.B To samo, ale z bitrate ustawionym na 1800kBit i optymalizowanymi makroblokami:
mencoder dvd://2 \-o tytuł2.avi \-oac copy \-ovc lavc
\-lavcopts vcodec=mpeg4:mbd=1:vbitrate=1800
.
.TP
.B To samo, ale z kompresją MJPEG:
mencoder dvd://2 \-o tytul2.avi \-ovc lavc
\-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 \-oac copy
.
.TP
.B Kodowanie wszystkich plików *.jpg w bieżącym katalogu:
mencoder "mf://*.jpg" \-mf fps=25 \-o wyjscie.avi \-ovc lavc \-lavcopts vcodec=mpeg4
.
.TP
.B Kodowanie z tunera (określ format poprzez \-vf format):
mencoder \-tv driver=v4l:width=640:height=480 tv:// \-o tv.avi \-ovc raw
.
.TP
.B Kodowanie z potoku:
rar p test-SVCD.rar | mencoder \-ovc lavc \-lavcopts vcodec=mpeg4:vbitrate=800 \-ofps 24 \-
.
.
.\" --------------------------------------------------------------------------
.\" Błędy, autorzy, standardowa adnotacja
.\" --------------------------------------------------------------------------
.
.SH BŁĘDY
Jeśli jakiś znajdziesz, zgłoś go nam, ale przedtem upewnij się, że przeczytałeś
całą dokumentację.
Wiele błędów jest skutkiem nieprawidłoych ustawień lub użycia złych parametrów.
Sekcja zgłoszeń błędów w dokumentacji (DOCS/\:HTML/\:pl/\:bugreports.html) opisuje
sposób tworzenia przydatnych zgłoszeń błędów.
.
.
.
.SH AUTORZY
MPlayer został stworzony przez Arpad'a Gereöffy.
Lista niektórych z wielu uczestników znajduje się w zbiorze AUTHORS.
.PP
MPlayer (C) 2000\-2004  Załoga MPlayera
.PP
Głównymi autorami tej strony są Gabucino, Jonas Jermann i Diego Biurrun.
Obecnie opiekuje się nią Diego Biurrun.
Proszę przesyłać wszelkie maile o niej na listę dyskusyjną MPlayer-DOCS.
.
.
.
.SH "OD TŁUMACZY"
Strona przetłumaczona przez Wacława Schillera <torinthiel@wp.pl> i
Macieja Pasztę <paszczi@go2.pl>.
W tłumaczeniu wykorzystano fragmenty pracy
Adriana Pawlika <imoteph@wp.pl> i Konrada Materki <kmaterka@wp.pl>
.PP
Tłumaczenie może zawierać liczne błędy, niektóre słowa mogły być
przetłumaczone błędnie lub nie powinny być tłumaczone.
Jeśli zauważysz jakiś błąd, prześlij informację o nim (i ewentualnie łatkę) do
tłumaczy lub na listę dyskusyjną MPlayer-DOCS.
.\" end of file