sync 1.717

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@13333 b3059339-0415-0410-9bf9-f77b7e298cf2

1 files changed, 180 insertions, 53 deletions

diff --git a/DOCS/man/pl/mplayer.1 b/DOCS/man/pl/mplayer.1
index 308f08c1bf..8301160f1a 100644
--- a/DOCS/man/pl/mplayer.1
+++ b/DOCS/man/pl/mplayer.1
@@ -1,4 +1,4 @@
-.\" synced with 1.708
+.\" synced with 1.717
 .\" 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)
@@ -2297,11 +2297,6 @@ Wykoszysta sterownik DirectX z wyłączonymi funkcjami przyspieszającymi.
 .RE
 .PD 1
 .sp 1
-FIXME: W dokumentacji uwzględnić podopcje dla x11, xover, dga, sdl, vidix,
-xvidix, fbdev, fbdev2, vesa, null, aa, bl, ggi, mga, xmga, syncfb, 3dfx,
-tdfx_vid, tdfxfb, dxr2, dxr3, mpegpes, zr, zr2, yuv4mpeg, gif89a, jpeg, pgm,
-png, tga.
-.sp 1
 Dostępne sterowniki wyjściowe:
 .
 .TP
@@ -2326,6 +2321,12 @@ który działa gdziekolwiek, jeżeli tylko obecne jest X11.
 .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)
@@ -2357,11 +2358,17 @@ Odtwarza video korzystając z rozszerzenia XFree86 Direct Graphics Access.
 Uważany za przeżytek.
 .
 .TP
-.B sdl (tylko SDL)
+.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\ \ 
@@ -2434,11 +2441,25 @@ Określa jakie urządzenia ma być użyte w trybie pełnoekranowym.
 .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\ \ \ 
@@ -2450,10 +2471,14 @@ kartami obsługującymi standard VESA VBE 2.0.
 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
-FIXME: udokumentować
-.IPs lvo\ \ 
-FIXME: udokumentować
+Używa sterownika VIDIX.
+.IPs lvo:\ \ 
+Włącza Linux Video Overlay na trybie vesa.
 .RE
 .PD 1
 .
@@ -2491,7 +2516,7 @@ maksymalny rozmiar tekstury dostępny w Twojej implementacji OpenGL.
 Zamiarem było działanie na nawet najprostszych implementacjach OpenGL.
 .PD 0
 .RSs
-.IPs manyfmts
+.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\-...>
@@ -2511,7 +2536,7 @@ Nie tworzy danych wyjściowych video.
 Użyteczne dla testowania wydajności.
 .
 .TP
-.B aa\ \ \ \ \ 
+.B aa (patrz też \-aa*)
 Sterownik wyjścia video ASCII art, który działa na konsoli tekstowej.
 .
 .TP
@@ -2522,10 +2547,24 @@ Sterownik wyjścia video Colour AsCii Art, który działa na konsoli tekstowej.
 .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
@@ -2604,10 +2643,22 @@ uwagę na ilość klatek na sekundę filmu.
 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\ 
@@ -2619,29 +2670,41 @@ 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.
+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.
-Działa w połączeniu z modułem jądra.
+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 x11
-Włącza overlay.
-.IPs xv
-Włącza overlay.
+.IPs <sterownik_vo>
+Wybiera podsterownik video używany jako nakładka (x11, xv).
 .RE
 .PD 1
 .
@@ -2673,7 +2736,7 @@ Określa normę TV.
 .br
 5: NTSC
 .REss
-.IPs device=<numer>
+.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
@@ -2681,12 +2744,15 @@ kartę em8300.
 .
 .TP
 .B mpegpes (tylko DVB)
-Sterownik wyjścia video przeznaczony dla 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
 .
@@ -2700,6 +2766,20 @@ przechwytujących/\:odtwarzających MJPEG.
 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\ \ \ \ 
@@ -2719,11 +2799,47 @@ 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 każdą ramkę do pliku GIF w bieżącym katalogu.
-Każdy plik dostaje jako nazwę numer ramki poprzedzony zerami.
+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\ \ \ 
@@ -2760,16 +2876,34 @@ Wartość musi być równa lub większa niż 1 (domyślnie: 1000).
 .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\ \ \ \ 
+.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
 .
 .
 .
@@ -3043,7 +3177,7 @@ strumieniami bitowymi.)
 .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, pomijanie kilku testów
+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)
@@ -3373,7 +3507,7 @@ 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).
+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.
@@ -3388,7 +3522,7 @@ input.conf.
 .RSs
 .IPs w,h
 szerokość i wysokość (domyślnie: -1, maksymalny możliwy rozmiar przy którym
-granice wciąż są widoczne).
+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)
@@ -3402,14 +3536,14 @@ 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ść)
+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
+Dodaje 50 pixeli ramki na dole obrazka.
 .RE
 .PD 1
 .IPs x,y
@@ -3463,13 +3597,13 @@ Przełącza skalowanie z przeplotem.
 .IPs gub_kolor
 opuszcza informację o kolorach
 .RSss
-0: użyje wszystkich dostępnych linii wejścia koloru
+0: Użyje wszystkich dostępnych linii wejścia koloru.
 .br
-1: użyje tylko co 2gą linię wejścia koloru
+1: Użyje tylko co 2gą linię wejścia koloru.
 .br
-2: użyje tylko co 4tą linię wejścia koloru
+2: Użyje tylko co 4tą linię wejścia koloru.
 .br
-3: użyje tylko co 8mą linię wejścia koloru
+3: Użyje tylko co 8mą linię wejścia koloru.
 .REss
 .IPs parametr
 parametr skalowania (zależnie od użytej metody)
@@ -4419,7 +4553,7 @@ 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
+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
@@ -6513,9 +6647,8 @@ Częstotliwość występowania klatek I (domyślnie: 60)
 .B frameref=<wartość>
 Ilość poprzednich klatek wykorzystanych do przewidywania w klatkach P
 (domyślnie: 1).
-.br
-.I INFORMACJA:
-Do obecnej wersji x264 r38 obsługa tej opcji nie została zaimplementowana.
+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ść>
@@ -6580,20 +6713,14 @@ 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].
-.br
-.I INFORMACJA:
-Ta opcja ma wpływ nawet, jeżeli wybierzesz kodowanie w CBR.
-W takim wypadku, pierwsza kodowana klatka użyje współczynnika kwantyzacji,
-jaki podałeś, ale w następnych klatkach kontrola tempa zadecyduje jakie
-kwanty wybrać.
 .
 .TP
 .B qp_min=<2\-51> (tylko CBR)
-Minimalny kwantyzator, 20-40 to użyteczny zakres (domyślnie: 2).
+Minimalny kwantyzator, 15\-35 to użyteczny zakres (domyślnie: 10).
 .
 .TP
 .B qp_max=<2\-51>  (tylko CBR)
-Maksymalny kwantyzator.
+maksymalny kwantyzator (domyślnie: 51)
 .
 .TP
 .B qp_step=<wartość>
@@ -6610,7 +6737,7 @@ 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: 100)
+czułość kontroli tempa (domyślnie: 4)
 .
 .TP
 .B ip_factor=<wartość>
@@ -6633,11 +6760,10 @@ jest bardziej stały, podczas gdy wyższa, sprawia, że parametr kwantyzacji
 jest bardziej stały.
 .
 .TP
-.B qblur=<0\-1>
+.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
@@ -6650,17 +6776,18 @@ Określa ilość informacji drukowanych na ekranie.
 .RSs
 -1: żadne
 .br
- 0: błędy (dla debugowania x264)
+ 0: Wyświetla tylko błędy.
 .br
  1: ostrzeżenia
 .br
- 2: PSNR i inne statystyki analiz po skończonym kodowaniu (domyślne)
+ 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
+.B psnr\ \ \ 
 Drukuje statystyki stosunku sygnału do szumu.
 .
 .
@@ -6671,7 +6798,7 @@ Drukuje statystyki stosunku sygnału do szumu.
 .SH PLIKI
 .
 .TP
-/usr/\:/local\:etc/\:mplayer/\:mplayer.conf
+/usr/\:local/\:etc/\:mplayer/\:mplayer.conf
 główny plik ustawień
 .
 .TP
@@ -6719,7 +6846,7 @@ napisów w następującej kolejności:
 .SH PRZYKŁADY
 .
 .TP
-.B szybki start odtwarzania DVD:
+.B Szybki start odtwarzania DVD:
 mplayer dvd://1
 .
 .TP
@@ -6791,7 +6918,7 @@ 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
+.B To samo, ale z kompresją MJPEG:
 mencoder dvd://2 \-o tytul2.avi \-ovc lavc
 \-lavcopts vcodec=mjpeg:mbd=1:vbitrate=1800 \-oac copy
 .