
   ----------------------
            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           *
*********************************

