synced with 1.749 + random fixes

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

1 files changed, 128 insertions, 79 deletions

diff --git a/DOCS/man/pl/mplayer.1 b/DOCS/man/pl/mplayer.1
index d09b544594..a525800963 100644
--- a/DOCS/man/pl/mplayer.1
+++ b/DOCS/man/pl/mplayer.1
@@ -198,6 +198,9 @@ szum, konwersja rgb/\:yuv) i inne.
 to MPlayer z graficznym interfejsem użytkownika.
 Ma te same opcje co MPlayer.
 .PP
+Przykłady jak korzystać z programu znajdziesz na końcu tej strony
+podręcznika man.
+.PP
 .B Sprawdź również dokumentację w formacie HTML!
 .
 .
@@ -371,7 +374,7 @@ Używa podanego pliku zamiast dostępnego w systemie lub wbudowanego codecs.conf.
 Określa plik z ustawieniami, który będzie parsowany po tych domyślnych.
 .
 .TP
-.B \-quiet \ \ 
+.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ą
@@ -1409,11 +1412,11 @@ Ustala jak powinny być wyrównane napisy SPU (DVD/\:VOBsub).
 .IPs -1
 oryginalna pozycja
 .IPs 0
-wyrównaj na górze (oryginalne/\:domyślne zachowanie)
+Wyrównaj na górze (oryginalne/\:domyślne zachowanie).
 .IPs 1
-wyrównaj na środku
+Wyrównaj na środku.
 .IPs 2
-wyrównaj na dole
+Wyrównaj na dole.
 .RE
 .PD 1
 .
@@ -2820,7 +2823,7 @@ Pozwala podać nazwę zbioru wyjściowego (domyślnie ./md5)
 .
 .TP
 .B md5sum\ 
-Oblicza sumę md5 każdej klatki i zapisuje je wszystkie do pliku.
+Oblicza sumy MD5 każdej klatki i zapisuje je do pliku.
 Obsługuje przestrzenie kolorów RGB24 i YV12.
 Przydatne przy debugowaniu.
 .PD 0
@@ -2897,7 +2900,7 @@ współczynnik jakości (domyślnie: 75)
 .IPs outdir=<nazwa\ katalogu>
 Określa katalog, w którym będą zapisywane pliki JPEG (domyślnie: ./).
 .IPs subdirs=<wartość>
-Jeśli podane, MPlayer stworzy poszeregowane podkatalogi z określnonym prefiksem.
+Jeśli podane, MPlayer stworzy ponumerowane 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ść>
@@ -2911,11 +2914,8 @@ Wartość musi być równa lub większa niż 1 (domyślnie: 1000).
 .B pnm\ \ \ \ 
 Zapisuje każdą ramkę do pliku PNM w bieżącym katalogu.
 Każdy plik dostaje jako nazwę numer ramki poprzedzony zerami.
-Obsługuje pliki PPM, PGM i PGMYUV w trybie surowym (raw) i ASCII. Zobacz również 
-.BR pnm (5),
-.BR ppm (5)
-i
-.BR pgm (5).
+Obsługuje pliki PPM, PGM i PGMYUV w trybie surowym (raw) i ASCII.
+Zobacz również pnm(5),ppm (5) i pgm(5).
 .PD 0
 .RSs
 .IPs ppm
@@ -2932,10 +2932,9 @@ Zapisuje pliki PNM w trybie surowym (raw) (domyślnie).
 Zapisuje pliki PNM w trybie ASCII.
 .IPs outdir=<nazwa\ katalogu>
 Określa katalog, w którym będą zachowane pliki PNM (domyślnie: ./).
-.IPs subdirs=<wartość>
-MPlayer utworzy ponumerowane podkatalogi z podanym prefiksem.
-Domyślnie żadne podkatalogi nie zostaną stworzone
-a wszystkie pliki PNM zostaną zapisane w tym samym katalogu.
+.IPs subdirs=<prefiks>
+Tworzy ponumerowane podkatalogi z określonym prefiksem, gdzie zachowa
+pliki zamiast zapisywać je bieżącego katalogu.
 .IPs maxfiles=<wartość> (tylko z subdirs)
 Maksymalna ilość plików PNM jakie będą zachowane w każdym podkatalogu.
 Wartość musi być większa lub równa 1 (domyślnie: 1000).
@@ -3222,7 +3221,7 @@ informacje debugowania:
 .IPs ec=<wartość> 
 ukrywanie błędów:
 .RSss
-1: Używa silnego filtru deblokującego (deblock) dla uszkodzonych
+1: Używa silnego filtru odblokowywującego (deblock) dla uszkodzonych
 makrobloków (MB).
 .br
 2: iteracyjne szukanie wektorów ruchu (MV) (wolne)
@@ -3255,6 +3254,21 @@ dekodowanie tylko w skali szarości (trochę szybsze niż w kolorze)
 Żeby osiągnąć najlepszą jakość dekodowania, używaj tego samego algorytmu
 idct do kodowania i dekodowania.
 Może to jednak zmniejszyć dokładność.
+.IPs lowres=<numer> 
+Dekoduje w niskiej rozdzielczości.
+Dekodowanie w niskiej rozdzielczości nie jest obsługiwane przez wszystkie
+kodeki i często powoduje pojawienie się okropnych zniekształceń. Nie jest
+to żaden błąd, a jedynie efekty uboczny niedekodowania w pełnej rozdzielczości.
+.RSss
+.br
+0: wyłączone
+.br
+1: 1/2 rozdzielczości
+.br
+2: 1/4 rozdzielczości
+.br
+3: 1/8 rozdzielczości
+.REss
 .IPs "sb=<number> (tylko MPEG2)"
 Przeskakuje podaną ilość wierszy makrobloków na dole.
 .IPs "st=<number> (tylko MPEG2)"
@@ -3830,7 +3844,7 @@ prosty filtr postprocessingu
 .IPs jakość
 0\-6 (domyślnie: 3)
 .IPs qp\ \ 
-wymusza parametr kwantyzacji (domyślnie: 0, parametr QP z video)
+Wymusza parametr kwantyzacji (domyślnie: 0, parametr QP z video).
 .IPs tryb\ \ \ 
 0: twardy próg (domyślne)
 .br
@@ -4442,17 +4456,17 @@ 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
+Przesunie nieparzyste klatki w górne pole, parzyste w dolne, tworząc 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
+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
+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
+Poszerza każdą klatkę do pełnej wysokości i wypełnia pozostałe linie na czarno;
+szybkość klatek pozostaje niezmieniona.
 .RE
 .PD 1
 .
@@ -4467,14 +4481,14 @@ Dostępne tryby:
 .PD 0
 .RSs
 .IPs 0
-pozostawia pola niezmienione (zaobserwujesz przeskoki/\:migotanie)
+Pozostawia pola niezmienione. (Zaobserwujesz przeskoki/\:migotanie.)
 .IPs 1
-interpoluje brakujące linie (stosowany algorytm może nie być zbyt dobry)
+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)
+Przesunie pola o 1/4 piksela z wykorzystaniem interpolacji liniowej
+(bez przeskoków).
 .IPs 4
-przesuń pola o 1/\:4 piksela z wykorzystaniem filtru 4tap (wysoka jakość)
+Przesunie pola o 1/4 piksela z wykorzystaniem filtru 4tap (wysoka jakość).
 .RE
 .PD 1
 .
@@ -4495,26 +4509,26 @@ Jak często filtr powinien być wykorzystywany.
 adaptatywne rozmycie figur
 .PD 0
 .RSs
-.IPs pro\ \ \ 
+.IPs <pro>
 siła filtru rozmycia (~0.1\-4.0) (wolniejsze jeżeli większe)
-.IPs pf\ \ \ 
+.IPs <pf>\
 siła prefiltru (~0.1\-2.0)
-.IPs różnKol
-Jak różne piksele będą rozpatrywane.
-(~0.1\-100.0)
+.IPs <różnKol>
+Maksymalna różnicą między pikselami, która będzie jeszcze rozpatrywana
+(~0.1\-100.0).
 .RE
 .PD 1
 .
 .TP
-.B smartblur=pro:siła:zakres[:pro:siła:zakres]
+.B smartblur=promień:siła:zakres[:promień:siła:zakres]
 eleganckie rozmycie
 .PD 0
 .RSs
-.IPs pro\ \ 
+.IPs <promień> 
 siła filtru rozmycia (~0.1\-5.0) (wolniejsze jeżeli większe)
-.IPs siła\ 
+.IPs <siła>
 rozmycie (0.0\-1.0) lub wyostrzenie (-1.0\-0.0)
-.IPs zakres
+.IPs <zakres>
 filtruj wszystko (0), filtruj płaskie obszary (0\-30)
 lub filtruj krawędzie (-30\-0)
 .RE
@@ -4522,7 +4536,7 @@ lub filtruj krawędzie (-30\-0)
 .
 .TP
 .B perspective=x0:y0:x1:y1:x2:y2:x3:y3:t
-korekcja perspektywy
+Popraw perspektywę w filmach, niekręconych prostopadle do obrzu.
 .PD 0
 .RSs
 .IPs x0,y0,...
@@ -4534,8 +4548,8 @@ liniowy (0) lub sześcienny resampling (1)
 .
 .TP
 .B 2xsai\ \ 
-Wykorzystuje podwójne skalowanie i interpolację do skalowania i wygładzania
-obrazów.
+Przeskaluje i wygładzi obraz przy pomocy podwójnego skalowania i
+algorytmu interpolacji.
 .
 .TP
 .B 1bpp\ \ \ 
@@ -4554,15 +4568,18 @@ ilość linii wybierana ze środka obrazu (domyślnie: 12)
 .PD 1
 .
 .TP
-.B bmovl=hidden:opaque:<fifo>
-Odczytuje bitmapy z FIFO i wyświetla je w oknie.
+.B bmovl=ukryty:nieprzezroczysty:kolejka
+Odczytuje bitmapy z FIFO i wyświetla je w górnej części filmu,
+pozwalając na tranformacje na obrazie.
+TOOLS/bmovl-test.c jest małym programem do testowania bmovl.
 .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\ 
+.IPs <ukryty>
+Ustawia domyślną wartość flagi "hidden" (0=widoczny, 1=ukryty).
+.IPs <nieprzejzroczysty>
+Ustawia domyślną wartość flagi "opaque" czystym
+(0=przezroczysty, 1=nieprzezroczysty)).
+.IPs <kolejka> 
 ścieżka/\:nazwa pliku FIFO (nazwana kolejka łącząca mplayer \-vf bmovl
 z aplikacją kontrolują)
 .RE
@@ -4578,20 +4595,20 @@ i następnie szerokość*wysokość*4 bajtów danych źródłowych RGBA32.
 .IPs "ABGR32 szerokość wysokość xpoz ypoz alfa clear"
 i następnie szerokość*wysokość*4 bajtów danych źródłowych ABGR2.
 .IPs "RGB24 szerokość wysokość xpoz ypoz alfa clear"
-i następnie szerokość*wysokość*3 bajtów danych źródłowych RGB32.
+i następnie szerokość*wysokość*3 bajtów danych źródłowych RGB24.
 .IPs "BGR24 szerokość wysokość xpoz ypoz alfa clear"
-i następnie szerokość*wysokość*3 bajtów danych źródłowych BGR32.
+i następnie szerokość*wysokość*3 bajtów danych źródłowych BGR24.
 .IPs "ALPHA szerokość wysokość xpoz ypoz alfa"
-zmienia kanał alfa dla obszaru
+Zmienia przezroczystość alfa dla danego obszaru.
 .IPs "CLEAR szerokość wysokość xpoz ypoz"
-czyści obszar
+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ę
+Ukrywa bitmapę.
 .IPs SHOW\ 
-pokazuje bitmapę
+Pokazuje bitmapę.
 .RE
 .PD 1
 .sp 1
@@ -4601,9 +4618,9 @@ Argumenty oznaczają:
 .PD 0
 .RSs
 .IPs "szerokość, wysokość"
-wymiary obrazu/\:obszaru
+wymiary obrazu/obszaru
 .IPs "xpoz, ypoz"
-start blittingu w punkcie o współrzędnych X/Y
+Rozpoczyna blitting 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,
@@ -4612,9 +4629,9 @@ przenikania ! ;)
 .RSss
 0:    tak jak oryginał
 .br
-255:  zmienia wszystko na nieprzezroczyste
+255:  Zmienia wszystko na nieprzezroczyste.
 .br
--255: zmienia wszystko na przezroczyste
+-255: Zmienia wszystko na przezroczyste.
 .REss
 .IPs clear
 czyści bufor przed blittingiem
@@ -4653,32 +4670,32 @@ 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
+.B tile=xkawalki:ykawalki:wyjście: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 ...)
+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) :-)
+(tile) :-).
 .sp 1
 Dostępne parametry:
 .sp 1
 .PD 0
 .RSs
-.IPs xtile
+.IPs <xkawałki>
 ilość kawałków na osi X (domyślnie: 5)
-.IPs ytile
+.IPs <ykawałki>
 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,
+.IPs <wyjście>
+Renderuje kawałek kiedy wyjściowa ("wyjście") 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 <start>
+grubość zewnętrznego obramowanie w pikselach (domyślnie: 2)
 .IPs delta
-piksel pomiędzy 2 kawałkami (x/\:y) (domyślnie: 4)
+grubość wewnętrznego obramowania w pikselach (domyślnie: 4)
 .RE
 .PD 1
 .
@@ -4690,9 +4707,9 @@ 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.
+pozycja lewego, górnego rogu logo
 .IPs w,h
-Szerokość i wysokość czyszczonego prostokątu.
+szerokość i wysokość czyszczonego prostokąta
 .IPs t
 Grubość niewyraźnej krawędzi (dodana do w i h).
 Kiedy ustawiona zostanie na -1, zielony prostokąt zostanie narysowany na
@@ -5566,7 +5583,8 @@ współczynnik kwantyzatora pomiędzy klatkami B a innymi niż B (przejście\ 1/\:2)
 .
 .TP
 .B vi_qfactor=<-31.0\-31.0>
-(przejście\ 1/\:2) (domyślnie: 0.8)
+współczynnik kwantyzatora pomiędzy klatkami I a innymi niż I (przejście\ 1/\:2)
+(domyślnie: 0.8)
 .
 .TP
 .B vb_qoffset=<-31.0\-31.0>
@@ -5897,13 +5915,29 @@ rozsądny zakres
 .
 .TP
 .B tcplx_mask=<0.0\-1.0>
-maskowanie złożoności czasowej (domyślnie: 0.0 (wyłączone))
+maskowanie przejściowej złożoności (domyślnie: 0.0 (wyłączone))
+Wyobraź sobie ujęcie z ptakiem lecącym przez całą scenę. tcplx_mask
+zmniejszy kwantyzatory jego makrobloków (tym samym zmniejszając ich jakość),
+ponieważ ludzkie oko zazwyczaj nie ma czasu, żeby zobaczyć wszystkie jego
+szczegóły.
+Niestety, jeżeli przedmiot, na którego została nałożona maska, zatrzyma się
+(np.\& ptak wyląduje) prawdopodobnie będzie wyglądało to okropnie przez
+krótką chwilę, dopóki koder nie zauważy tego, że przedmiot już się nie porusza
+i potrzebuje nowych bloków.
+Zaoszczędzone bity, będą wykorzystane w innych częściach filmu, co może
+zwiększyć subiektywną jakość, pod warunkiem, że wartość tcplx_mask jest
+dobierana ostrożnie.
 .
 .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.
+Większe wartości pomagają przy blokowaniu, jeżeli żaden filtr odblokowania nie
+jest stosowany przy dekodowaniu - nie jest to najlepszy pomysł.
+.br
+Wyobraź sobie scenę z trawą (która ma zazwyczaj dużą kompleksowość przestrzenną),
+niebieskim niebem i domem. scplx_mask zwiększy kwantyzatory makrobloków trawy
+,tym samym zmniejszając jej jakość, tak żeby wykorzystać więcej bitów na
+niebo i dom.
 .br
 .I WSKAZÓWKA:
 Usuń wszystkie czarne krawędzie, jako że zmniejszają one jakość
@@ -5914,10 +5948,23 @@ wyłączone (domyślnie)
 .IPs 0.0\-0.5
 rozsądny zakres
 .RE
+.sp 1
+.I INFORMACJA:
+Ten parametr nie działa tak samo, jak użycie własnej matrycy, która kompesowała
+by wyższe częstotliwości lepiej, jako że scplx_mask zmniejszy jakość bloków P,
+nawet jeśli tylko DC się zmienia -  nie będzieto prawdopodobnie wyglądało
+za dobrze.
 .
 .TP
 .B p_mask=<0.0\-1.0>
 Maskowanie inter MB (domyślnie: 0.0 (wyłączone))
+
+.B p_mask=<0.0\-1.0> (also see vi_qfactor)
+Zmniejsza jakość inter makrobloków.
+Jest to jednoznaczne z podniesieniem jakości intra bloków, ponieważ ta sama,
+przeciętna wartość bitrate, będzie rozprowadzona przez kontroler tempa
+(rate controller) na całą sekwencję video (domyślnie: 0.0 (wyłączone)). 
+p_mask=1.0 podwoja lość bitów alokowanych do każdego inta bloku.
 .
 .TP
 .B naq\ \ \ \ 
@@ -6835,12 +6882,14 @@ 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).
+Wykorzystuje filtr odblokowywujący (deblock) (domyślnie: włączony).
+Jako, że zabiera mało czasu procesora w porównaniu ze wzrostem jakości,
+jaki daje, nie jest zalecane wyłączanie go.
 .
 .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.
+Parametr AlphaC0 dla filtru odblokowywujący (deblock) (domyślnie: 0).
+Opcja ta dostosowuje zakresy dla filtru odlokowywują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.
@@ -6853,7 +6902,7 @@ nieznaczne zwiększenie jego wartości.
 .
 .TP
 .B deblockbeta=<-6\-6>
-Parametr Beta filtru deblokującego (deblock) (domyślnie: 0).
+Parametr Beta filtru odblokowywującego (deblock) (domyślnie: 0).
 Ma wpływ na maksymalny, dozwolony gradient między dwoma przylegającymi blokami.
 .
 .TP