summaryrefslogtreecommitdiff
path: root/doc/README.dxr3_pl
diff options
context:
space:
mode:
Diffstat (limited to 'doc/README.dxr3_pl')
-rw-r--r--doc/README.dxr3_pl319
1 files changed, 319 insertions, 0 deletions
diff --git a/doc/README.dxr3_pl b/doc/README.dxr3_pl
new file mode 100644
index 000000000..f25d01a04
--- /dev/null
+++ b/doc/README.dxr3_pl
@@ -0,0 +1,319 @@
+
+ ----------------------
+ xine
+ ----------------------
+
+ wolny odtwarzacz wideo
+
+
+Wstęp
+=====
+
+Ta dokumantacja jest przeznaczona dla użytkowników dekodera dxr3
+firmy Creative Labs lub Sigma Designs.
+
+Ta wersja xine domyślnie zawiera wtyczkę dla wsparcia wspomnianych
+dekoderów sprzętowych. Brakującym elementem jest moduł jądra systemu.
+Ten moduł jest dostępny na stronie głównej projektu dxr3/hw+ pod
+adresem
+
+ http://dxr3.sourceforge.net/
+
+Różne formaty dystrybucji (skompresowane, RPMy) są wyszczególnione
+pod adresem
+
+ http://dxr3.sourceforge.net/download.html
+
+Ponieważ konfiguracja sterownika dxr3/hw+ jest nieco skomplikowane,
+proszę zaglądnąć do dokumentu HOWTO:
+
+ http://dxr3.sourceforge.net/howto.html
+
+Wtyczka xine dxr3 wymaga przynajmniej wersji
+
+ em8300-0.8.1 sterownika kernela linuxa
+
+
+Kompilacja
+==========
+
+Bardzo ważnym jest skompilowanie i zainstalowanie sterwonika
+(modułu) dxr3/hw+ *przed* kompilacją xine-lib. Nie zachowanie
+wspomnianej zasady spowoduje wyłączenie obsługi dxr3 z ostrzeżeniem
+przez skryp ./configure.
+
+W celu aktywacji wtyczkę, plik em8300.h musi być dostępny
+w katalogu /usr/src/linux/include/linux. Jeśli masz niestandardowy
+katalog źródeł jądra linuxa np. /usr/src/linux-2.4.5, musisz
+podać go jako parametr:
+
+./configure --with-linux-path=/usr/src/linux-2.4.5
+
+Wtyczka dxr3 xine
+=================
+
+Są dwa sposoby użycia karty dxr3 przez xine.
+
+1. dekodowanie i wyświetlanie mpeg-1/mpeg-2 (DVD, VCD, ...).
+
+Jest to normalne użytkowanie. Zamiast dekodować mpeg programowo,
+xine ustawia wyświetlanie (TV albo overlay) i wysyła dane mpeg
+poprzez sterownik jądra do dekodera mpeg na karcie dxr3 bardzo
+podobnie do odtwarzacza windowsowego który prawdopodobnie otrzymałeś
+wraz z kartą. W tym trybie, powinieneś używać wtyczkę dekodera dxr3
+razem z wtyczką wyjścia obrazu dxr3.
+
+xine powinno wybrać wtyczkę dekodera dxr3 automatycznie gdy
+napotka strumień mpeg, lecz jest możliwe że nie użyje automatycznie
+wtyczki wyjścia obrazu dxr3. W takim przypadku, wystartuj xine
+z opcją "-V dxr3" aby zdefiniować wtyczkę wyjścia obrazu dxr3. Jeśli
+użyjesz innej wtyczki wyjścia obrazu, jak Xv lub XShm, xine nie
+będzie mógł użyć dekodujących własności sprzętu dxr3 i użyje
+zamiast tego biblioteki libmpeg2.
+
+ Oto uproszczony opis tego co dzieje się gdy odtwarzasz
+dvd z pomocą xine używającego sterownika wyjścia obrazu dxr3:
+
+DVD -> podział obrazu i dźwięku mpeg oraz strumieni dźwięku
+-> wysyłanie obrazu mpeg do dxr3 -> obraz pojawia się na ekranie
+
+2. wyświetlanie obrazu nie-mpeg na sprzęcie dxr3.
+
+Obraz nie-mpeg może być avi, quicktime, windows-media-files lub
+cokolwiek xine może odkodować.
+
+Ta opcja musi być wkompilowana i wymaga wspieranego kodera mpeg.
+W tym momencie istnieją dwa:
+- libfame z fame.sourceforge.net (bardzo szybki, dobrej jakości)
+- librte (versja 0.4) z zapping.sourceforge.net (szybki, bardzo
+dobrej jakości)
+Jeśli ./configure znajdzie jeden albo obydwa, wkompiluje
+wsparcie dla kodowania do sterownika dxr3.
+
+Aby użyć tego sterownika dla wyjścia obrazu zamiast, powiedzmy,
+Xv, wystartuj xine z linii poleceń z opcją "-V dxr3", np.
+$ xine -V dxr3 my_movie.avi
+
+W przeciwieństwie do przypadku 1), gdzie karta wykonuje
+dekodowanie obrazu, tutaj xine wykonuje dekodowanie programowo,
+jak zwykle i wysyła zdekompresowany obraz do sterownika wyjścia
+obrazu. Sterownik wyjścia dxr3 zakodowywuje, w czasie
+rzeczywistym, ten obraz jako wewnętrzną ramke mpeg-1 i wysyła
+to do dekodera mpeg na karcie.
+
+Używając tego triku, możemy wyświetlić dowolny format obrazu
+poprzez wyjście TV karty dxr3. Sprytne, nie? Jedyną wadą tego
+rozwiązania jest wymagana dodatkowa moc do przeliczenia tego
+odkodowania i zakodowania obrazu w czasie rzeczywistym
+programowo. Wymagana moc procesora zależy oczywiście od
+rozdzielczości formatu źródła, ale według reguły kciuka
+zalecany jest system z 128 MB pamięci RAM i P-III/Athlonem
+taktowanym zegarem 800 MHz.
+
+Oto opis tego co dzieje się gdy odgrywasz plik avi w ten
+sposób (porównaj do poprzedniego opisu!)
+
+-> oddzielenie strumienia obrazu i dźwięku -> dekodowanie
+strumienia obrazu -> zakodowywanie obrazu jako mpeg-1 ->
+wysyłanie strumienia mpeg-1 do dxr3 -> obraz wyświetlany
+na ekranie.
+
+konfiguracja xine
+=================
+
+xine posiada wiele opcji konfiguracyjnych w $HOME/.xine/config
+(zobacz również doc/README.config_en)
+
+dxr3.devicename:
+ /dev/em8300-0 Ścieżka bezwzględna do urządzenia dxr3.
+
+dxr3.preferred_tvmode:
+ default Użyj obecnych ustawień sterownika
+ ntsc NTSC 60Hz
+ pal PAL 50Hz
+ pal60 PAL 60Hz
+
+dxr3.videoout_mode:
+ letterboxed overlay
+ wyjście obrazu overlay na monitorze VGA z opcją
+ przełączania "w locie" do trybu TV. (patrz
+ 'Właściwość VGA overlay' poniżej). Overlay
+ będzie wyświetlany z czarnymi brzegami jeśli
+ obraz jest anamorficzny. To może być użyteczne
+ w rzadkim przypadku napisów które poprawnie
+ są wyświetlane tylko w trybie letterbox.
+ Dobrym tego przykładem są animowane
+ sylwetki komentatorów w "Ghostbusters".
+ widescreen overlay
+ wyjście obrazu overlay na monitorze VGA z
+ opcją przełączania w locie do trybu TV
+ (patrz 'Właściwość VGA overlay' poniżej).
+ Najpopularniejszy wariant trybu overlay dxr3.
+ letterboxed tv
+ wysyła obraz tylko do wyjścia TV karty.
+ To jest tryb używany dla standardowego
+ telewizora 4:3. Anamorficzne proporcje będą
+ wyświetlane letterboxed, materiał pan&scan
+ będzie miał obraz obcięty.
+ widescreen tv
+ wysyła obraz tylko do wyjścia TV karty. To
+ jest tryb przeznaczony dla telewizorów 16:9.
+ Zawartość anamorficzna i pan&scan wypełni obraz
+ ale będziesz musiał ustawić proporcje TV ręcznie.
+
+dxr3_keycolor: (tylko w trybie overlay)
+ 0x80a040 Szesnastkowa wartość RGB koloru kluczowego.
+ Nie powinna być zmieniana.
+
+dxr3.color_interval: (tylko w trybie overlay)
+ 50.0 Zakres tolerancji dla koloru kluczowego. Wyższa wartość
+ pozwala na większy zakres kolorów kluczowych. Używane
+ do korekcji błędów w wyświetlaniu kolorów na wyjściu VGA.
+ Mniejsza wartość jest zalecana aby nie używać "błędnych"
+ kolorów do trybu overlay. Rozsądny zakres to 20.0 - 200.0
+
+dxr3.scr_priority:
+ 10 Priorytet wtyczki dxr3 scr. <5 oznacza że czasomierz
+ systemowy ma być użyty. >5 narzuca użycie dxr3 jako
+ źródło synchronizacji. Jeśli tego nie rozumiesz
+ pozostaw ustawienia domyślne.
+
+dxr3.decoder_priority:
+ 10 Priorytet wtyczki dekodera dxr3. <5 oznacza że sprzętowe
+ dekodowanie będzie wyłączone i będzie użyte zamiast tego
+ libmpeg2. W ten sposób jakikolwiek materiał wideo,
+ włączając w to mpeg będzie przechodził przez programowe
+ dekodowanie i ponowne kodowanie do mpeg.
+
+dxr3.contrast:
+dxr3.brightness:
+dxr3.saturation:
+ 500 Nie powinno być potrzebne zmienianie ręczne. Użyj xine
+ do regulacji. Zakres 100 - 900
+
+dxr3.alt_play_mode:
+ 1 Włącz lub wyłącza rozszerzony tryb bufora dostępnego
+ przynajmniej na części kart. Znaczące polepszenie
+ było zaobserwowane z zakłuconymi strumieniami przerywanymi
+ pauzami.
+
+dxr3.sync_every_frame:
+ 0 Próbuje ustawić znaczniki czasu synchronizacji dla każdej
+ ramki. Zazwyczaj nie jest to wymagane, nawet jeśli
+ sychrnonizacyjne znaczniki czasu są ustawiane od czasu
+ czasu.
+
+dxr3.correct_durations:
+ 0 Włącza mały automat który koryguje czas trwania ramki
+ niektórych strumieni mpeg z błędnymi kodekami framerate.
+ Obecnie została zaimplementowana korekta dla ntsc błędnie
+ nazwana jako strumień pal. Włączaj tylko kiedy spotkasz
+ taki strumień.
+
+video.driver:
+ dxr3 Sterownik obrazu dxr3 robi całą niezbędną konfigurację
+ karty i kodowanie do mpeg gdy odtwarzany jest strumień
+ nie-mpeg (patrz wyżej)
+
+audio.driver:
+ oss wyjście em8300 audio jest dostępne jako zwykłe urządzenie
+ OSS. Sterownik audio musi więc być ustawione na oss.
+ Może być również ustawione przy użyciu "-A oss" jako
+ opcji w lini poleceń.
+
+audio.oss_device_num:
+ 0-16 komputery z zainstalowaną kartą dxr3 często mają również
+ zainstaloaną kartę dźwiękową. Jeśli odtwarzanie dźwięku
+ odbywa się za pomocą błędnego urządzenia, wymagane
+ urządzenie może być ustawione za pomocą tej opcji.
+
+Poniższe ustawienia dotyczą tylko części kodującej do mpeg:
+
+dxr3.enc_alt_play_mode:
+ 1 Patrz na dxr3.alt_play_mode. Różnica polega na tym
+ że ta jest używana w trybie kodowania.
+
+dxr3.enc_swap_fields:
+ 0 Zamienia parzyste pola z nieparzystymi obrazu. Włącz
+ tę opcję dla materiałów które generują pionowe skakanie
+ obrazu na ekranie.
+
+dxr3.enc_add_bars:
+ 1 Dodaj czarne pasy gdy obraz ma proporcje nie obsługiwane
+ przez kartę. Jest wymagane do utrzymania prawidłowych
+ proporcji.
+
+dxr3.encoder:
+ Program kodujący który ma być użyty.
+ Zależnie od tego co zostało wkompilowane może być "fame"
+ lub "rte". Według reguły kciuka, powinieneś spróbować
+ najpierw rte ponieważ daje on lepszą jakość obrazu. Jeśli
+ masz za dużo opuszczonych ramek, przełącz na "fame" i
+ znajdź optymalne ustawienie fame_quality (patrz niżej)
+ dla Twojego systemu.
+
+dxr3.fame_quality: (tylko koder libfame)
+ 0-100 Ustawienie jakości kodowania mpeg1 przez fame. Niższa
+ wartość jest szybsza ale daje znaczące zniekształcenia
+ Wyższa jest lepsza ale wolniejsza. Wartości pomiędzy
+ 0 a 100, 90 jest dobrą wartością początkową.
+
+dxr3.rte_bitrate: (tylko koder rte)
+ 1000-20000 Bitrate w kbit/s wyjścia kodera librte. Niższa wartość
+ jest szybsza, ale różnica nie jest tak duża jak w
+ ustawieniach libfame. Jeśli masz za dużo opuszczonych
+ ramek, lepiej użyj kodera libfame.
+
+Zalecane jest uruchomienie XINE przynajmniej raz przed edycją
+pliku konfiguracyjnego, ponieważ wszystkie opcje są zapisywane w
+pliku .xinerc i mają swoją domyślną wartość. Xine można zmusić do
+użycia sterownika dxr3 używając opcji "-V dxr3" w lini poleceń.
+Jeśli domyślne ustawienia sterownika są błędne - trzeba poprawić
+jedynie wartość opcji tvmode.
+
+Funkcjonalność zoom (tylko TVout)
+=================================
+Przyciskając klawisz 'z' włącza inną specyficzną dla trybu
+wyjścia TV które powiększa centralną część obrazu 16:9 aby
+wyświetlić dużo mniejsze (albo wogóle) czarne pasy na dole i
+górze. To obcina obraz na lewo i prawo aby zachować odpowiednie
+proporcje. Użyj SHIFT-z aby wyłączyć.
+
+Funkcjonalność przełączania trybu TV
+====================================
+Naciśnięcie kombinacji CTRL-o przełącza pomiędzy trybami TV pal,
+pal60, i NTSC. Wybrany format będzie działał tylko do końca
+aktualnej sesji xine, przy starcie tryb TV bedzie ustawione
+z powrotem do wartości w .xine/config
+
+Funkcjonalność VGA overlay
+==========================
+
+W poprzednich wersjach xine, trzeba było używać dxr3view by używać
+mechanizmu em8300 overlay. Teraz od wersji 0.5, można odtwarzać w trybie
+em8300 overlay bezbośrednio w oknie video xine.
+
+Pierwszy pomysł i poprawnie pracujący kod przyszedł od Mike Lampard
+<mjl@datafast.net.au>. Chwała mu za tą nową funkcjonalność.
+
+W celu aktywacji, "dxr3_tvmode" musi być ustawiony na "overlay".
+Ale to nie zadziała dopóki stary dxr3view też będzie uruchomiony
+(po prostu sprawdź). Przed pierwszym użyciem, musisz uruchomić "autocal".
+To zachowa parametry trybu overlay w pliku "~/.overlay". Więcej informacji
+również w HOWTO dxr3.
+
+Rzuć również okiem na wyżej opisane opcje xinerc dxr3_keycolor i
+dxr3_color_interval.
+
+
+---
+Wersja tego pliku:
+$Id: README.dxr3_pl,v 1.1 2003/01/05 13:11:53 guenter Exp $
+
+*********************************
+* Tłumaczenie: Bartłomiej Muryn *
+* Uwagi do tłumaczenia proszę *
+* przesyłać na adres *
+* _4ever_@irc.pl *
+*********************************
+