----------------------
            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 modułu w wersji przynajmniej

	em8300-0.8.1
	

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


Konfiguracja XINE
=================

XINE ma wiele opcji konfiguracyjnych w pliku $HOME/.xinerc
(zobacz również doc/README.xinerc)

Niektóre z nich są ważne dla odtwarzania za pomocą dxr3:
*) dxr3_tvmode:
	default Użyj obecnych ustawień sterownika
	ntsc    NTSC 60Hz
	pal     PAL 50Hz
	pal60   PAL 60Hz
	overlay Wyjście wideo na ekranie monitora VGA
	
*) 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_prio:
	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.
	
*) video_driver_name:
	dxr3    Potrzebne do ustawienia tv_mode, jasności, kontrastu,
                wypełnienia i proporcji ekranu. Jeśli nie ustawione
                to odtwarzanie będzie wciąż działać ale powyższa
                funkcjonalność będzie wyłączona.

                To jest tylko prosty sterownik który nie może wysyłać
                klatek. Klatki są wysyłane dopiero przez dekoder sprzętowy.
                Kiedy niejest odgrywana zawartość typu MPEG1/2, musi być
                ustawiony na sterownik "rzeczywisty" typu "Xv" lub "Xshm".

*) audio_driver_name:
	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ń.

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

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.


Uruchamianie XINE z obsługą dxr3/hw+
====================================

Dekoder sprzętowy jest automatycznie uruchamiany jeśli sterownik
może być poprawnie otwarty. Wideo Mpeg1/2 (np. DVD) są odtwarzane
przez dekoder sprzętowy, podczas gdy inne formaty są odgrywane na
ekranie. W takim przypadku pamiętaj o ustawieniu innego wyjścia
wideo niż "dxr3".


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 2001/10/15 19:00:25 f1rmb Exp $

*********************************
* Tłumaczenie: Bartłomiej Muryn *
* Uwagi do tłumaczenia proszę   *
* przesyłać na adres            *
*      _4ever_@irc.pl           *
*********************************