 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
                           XINE: В╕льно розповсюджуваний в╕део плей╓р.       
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


  ВЕРС╤Я
    => $Id: README_uk,v 1.3 2002/05/27 09:01:21 pmhahn Exp $
     
     
Терм╕ни:

 Г╤К  - граф╕чний ╕нтерфейс користувача (GUI).
 ЧАП - част╕ питання.
 ALSA - advanced Linux sound architecture (покращена звукова система для Linux).
 CSS - content scrambling system (система шифрування зм╕сту).
 CVS - concurent version system (система конкурентних файл╕в).
 dll - dynamic link library (модул╕ б╕бл╕отек динам╕чного завантаження (Win32)).
 DMA - direct memory access (режим прямого доступу до пам'ят╕; дозволя╓
          сутт╓во прискорити обм╕н ╕нформ. для визнач. пристрою без участ╕ процесора).
 DVD - digital video disc (формат компакт диск╕в для р╕зноман╕тно╖ ╕нформац╕╖).
 gcc  - GNU C compiler (комп╕лятор мови програмування C).
 MPEG - moution picture encoding group (стандарт по кодуванню в╕део,
            який розробля╓ однойменна група по стандартизац╕╖).
 MRL - media resource locator (локатор (адреса) мед╕а ресурсу).
 MTRR - memory type range registers (рег╕стри для встановлення д╕апозону пам'ят╕).
 PID - process identifier (╕дентиф╕катор (номер) процесу).
 VCD - Video CD (старий формат цифрового в╕део на компакт-дисках).
 URL - universal resource locator (ун╕версальний локатор (адреса) ресурсу).
 Xv  - eXtension video (модуль розширення Xwindow для прискорення граф╕ки).
 Xshm - Xwindows shared memory (граф╕чний режим з пам'яттю  сп╕льного доступу).



 ╤ндекс
 -===-
   
   1   ДОКУМЕНТАЦ╤Я
   1.1 Мета цього документу
   
   2   О XINE
   2.1 П╕дтримуван╕ платформи ╕ системн╕ вимоги
   2.2 Вжите програмне забезпечення
   2.3 Розробники Xine
   2.4 Використання.
   2.4.1 Ключов╕ клав╕ш╕.
   2.4.2 Виб╕р ауд╕о канал╕в
   2.4.3 Виб╕р субтитр╕в
   
   3   Ситуац╕я навколо DVD
   3.1 Свобода, DVD та ╕нше ...
   
   4   Контакти з проектом Xine




-------
 
1   ДОКУМЕНТАЦ╤Я

1.1 Мета цього документу

    Це документац╕я для к╕нцевого користувача по пакунках xine-lib та xine-ui.
    Ви знайдете б╕льше документац╕╖ в директор╕╖ /doc цих пакунк╕в.
    
    Будь-ласка уважно прочитайте ЧАП, що ╕нтегрований в xine-ui (Г╤К),
    який вже може мати в╕дпов╕дь на Ваш╕ питання.

2   Про XINE
   
    Xine  - це в╕део плей╓р для Unix систем (╓ також порт для Windows), який
    в╕льно розповсюджу╓ться п╕д л╕ценз╕╓ю GPL. В╕н п╕дтриму╓ MPEG-2 ╕ MPEG-1
    (ауд╕о + в╕део мульт╕плекс╕я) потоки, елементарн╕ MPEG потоки
    (ауд╕о/в╕део т╕льки, тобто mp3 файли), AVI файли з р╕зними в╕део форматами
    (для деяких з них використовуя win32 dll модул╕) ╕ Vorbis OGG потоки.
    Також ╓ п╕дтримка для quicktime поток╕в (але треба зауважити що
    quicktime в╕део ╕ ауд╕о кодеки ╓ власн╕стю Apple ╕ п╕дтримуються ще не повн╕стю).

    Хine програ╓ в╕део ╕ ауд╕о дан╕ потоку ╕ синхрон╕зу╓ ╖х в режим╕ реального часу.
    Залежно в╕д властивост╕в потоку, програвання буде вимагати б╕льше чи менше
    ресурс╕в процесора, повнокадровий MPEG-2 пот╕к можна побачити
    на сиcтемах з процесором K6-2 / P-II 400 МГц.

    Xine може безпосередньо показувати Video CD, SVCD ╕ DVD. Нажаль
    правовий статус перегляду зашифрованих / заблокованих DVD невизначений
    в деяких кра╖нах, тому xine не м╕стить н╕якого DVD дешифруючого / розблоковуючого
    коду. Щоб подивитися так╕ DVD, Вам потр╕бн╕ зовн╕шн╕ програми або щось под╕бне
    на модуль xine_dvd_plugin, який здатний обробляти аутентиф╕кац╕ю / дешифрування DVD.
    
    Учасники проекту Xine не несуть в╕дпов╕дальност╕ за под╕бне використання Xine.

    З верс╕╖ 0.5 арх╕тектура Xine дозволя╓ гнучко п╕дключати р╕зн╕ модул╕ так, що
    р╕зн╕ типи поток╕в ╕ вих╕дних пристро╖в можуть бути п╕дтриман╕ у майбутньому.

2.1 П╕дтримуван╕ платформи ╕ системн╕ вимоги

    - Xine потр╕бен X11 сервер для в╕део виходу
      (8, 15, 16, 24 або 32 б╕тна кольорова глибина)
      
    - Xine може знайти ╕ використати MIT X в╕део ╕ Xshm розширення
      для кращого показу в╕део.
      
    - якщо Ви не можете запустити розширенняt Xv на Ваш╕й платформ╕, Ви повинн╕
      використовувати  16 б╕тну кольорову глибину для зб╕льшення швидкост╕.
      Xv, зда╓ться, може працювати нормально при будь-як╕й кольоров╕й глибин╕.
      
    - якщо Ви ма╓те граф╕чний адаптер Matrox G200/G400/G450 , Ви можете опц╕ально
      використати  драйвер в╕део виходу syncfb/teletux. Див╕ться файл README.syncfb
      для подробиць.
      
    - для програвання ауд╕о п╕дтримуються драйвера OSS, ALSA, ESD ╕ ARTSD.
    - aaxine використову╓ aalib для виходу ╕ може бути запущеним на будь-якому терм╕нал╕
    - щоб зкомп╕лювати xine потр╕бн╕ стаб╕льн╕ програми GNU make, gcc ╕ binutils .

       Xine повинен запускатися на машинах класу Pentium ╕ вище
    (K5, K6, K6-2, K6-3, Duron, Athlon, Pentium II/III/IV, Celeron)
    з системою GNU/Linux або FreeBSD. Залежно в╕д типу в╕део
    потоку Вам необх╕дно буде мати б╕льше чи менше процесорних ресурс╕в
    для як╕сного програвання. Як правило, DVD типово запускаються без проблем
    на машинах класу Pentium II 400 МГц (або екв╕валентних). На  перегляд в╕део
    вплива╓ багато фактор╕в, тому Ваш╕ результати можуть в╕др╕знятися.

      Усп╕шно протестован╕ наступн╕ в╕део адаптери (в режим╕ Xv) для ПК:
    nVidia Riva TNT (б╕нарн╕ драйвера nvidia), nVidia Riva TNT 2, nVidia GeForce,
    Matrox G400, ATI AIW Rage128-16МБ, ATI Radeon, 3DFX Voodoo3 2000 PCI 16МБ

    Наступн╕ карти, як було пов╕домлено, працюють, але не в╕домо
    чи працюють вони з Xv, або т╕льки з XShm (будь-ласка над╕шл╕ть зв╕т
    до поштово╖ розсилки xine-user@sourceforge.net):
     
     Trident 9660, ATI AIW M64-8МБ PCI, ATI RageII 8МБ.

    Xine повинен показувати в╕део на любому працюючому X сервер╕
    з будь-яким граф╕чним адаптером в режим╕ Xshm, але з г╕ршою як╕стю
    н╕ж за допомогою розширення Xv.

    Додатково, Xine запуска╓ться на платформ╕ i386-solaris, sparc машинах з
    Linux або Solaris (кадровий буфер Creator-3D ма╓ працювати), дивиться
    README.solaris для докладно╖ ╕нформац╕╖. Також п╕дтримуються: деяк╕ 
    систем╕ на баз╕ PowerPC (з Linux) ╕ IRIX на MIPS.
    
    Xine, як було пов╕домлено, працю╓ на платформ╕ Alpha, IA-64 ╕ S/390 машинах. 

2.2 Вжите програмне забезпечення.

    Xine використову╓ код з наступних  зовн╕шн╕х проект╕в з в╕дкритим кодом:

     - liba52, автори Аарон Хольцман (Aaron Holtzman) ╕ М╕шель Лесп╕наз╕ (Michel Lespinasse)
     - libmpeg2, автори Аарон Хольцман (Aaron Holtzman) ╕ М╕шель Лесп╕наз╕ (Michel Lespinasse)
     - libmad, автор Роберт Лесл╕ (Robert Leslie)
     - libffmpeg, автор Джерард Лантау (Fabrice Bellard)

    Без цих чудових частин програмного забезпечення Xine зв╕сно не став би
    тим, чим в╕н ╓ сьогодн╕.

    Також велика подяка розробникам проект╕в "Linux Video" ╕  DVD Project "LiViD",  зв╕дки
    прийшли ориг╕нальн╕ ╕де╖ для реал╕зац╕╖ Xine в╕део плей╓ра.
     
     => http://www.linuxvideo.org/

2.3 Розробники Xine

    Головний розробник Xine: Гюнтер Бартщ (Guenter Bartsch)

    Р╕зн╕ пропозиц╕╖, усунення вад ╕ ф╕ксац╕я коду, 
    а також модуль alsa ╕ Г╤К:   Дан╕ель Коуджоль-Берт (Daniel Caujolle-Bert)

    Програмування ауд╕о:    С╕гфр╕д Лангауф (Siegfried Langauf)

    Сп╕впраця при вдосконаленн╕ б╕бл╕отек
    libmpeg2 ╕ libac3 з: М╕шель Лесп╕наз╕ (Michael Lespinasse)
  
    Плюс ╕нш╕ розробники, дивиться файл xine-lib/AUTHORS 

2.4 Використання
    
    Ви можете запустити Xine без будь-якого параметру з командного рядка,
    або Ви можете безпосередньо вказати один або дек╕лька вх╕дних поток╕в.
    Xine спробу╓ визначити, чи використовувати розширення Xv ╕ якщо н╕,
    то переключиться на використання XShm, але ця проба  може привести
    до збою. Ви можете вказати модуль в╕део виходу за допомогою
    опц╕╖ "-V", наприклад:

     xine -V XShm

    примусить Xine вживати XShm режим або прим╕тивний X11. 

    Якщо Ви бажа╓те посилати звук через мережу з ESD, встановить
    зм╕нну оточення ESPEAKER перед запуском xine.

    Вх╕дним потоком може бути ╕м'я файлу, або щось, що ми назива╓мо
    "MediaResourceLocator" (або MRL), який под╕бний на URL. Спочатку
    вкаж╕ть вх╕дне джерело потоку за як╕м сл╕ду╓ "://" ╕ дал╕
    специф╕чний ╕дентиф╕катор вх╕дного джерела. Як╕ вх╕дн╕ джерела
    Ви можете використовувати залежить в╕д тих вх╕дних модул╕в,
    що Ви ма╓те (для простих файл╕в Ви можете пропустити
    ╕дентиф╕катор вх╕дного джерела).

    Спробуйте:

     xine --help

    щоб отримати повну ╕нформац╕ю по використанню.

    xine п╕дтриму╓ xdnd протокол (верс╕ю 3) тому, якщо Ви ма╓те файловий менеджер,
    що п╕дтриму╓ цей протокол (наприклад gmc), Ви можете перетягувати в╕зуально
    файли на пиктограму Xine для перегляду.

    Перегляд треку 3 з VCD:

     xine vcd://3

    Приклад прямого доступу до DVD:

     xine dvd://VTS_01_1.VOB


2.4.1 Клав╕атурн╕ комб╕нац╕╖ управл╕ння

      Комб╕нац╕я клав╕ш        Д╕я

      <ENTER>             грати
      <SPACE>             пауза
      <Up>/<Down>      швидка промотка вперед / назад

      0                        шукати початок потоку
      1-9                     шукати позиц╕ю в 10 .. 90 % в╕д загального розм╕ру потоку
      <Left>/<Right>      шукати -/+ 15 сек (+ CTRL: 60 сек)
      <PgUp>/<Prior>     перестрибнути до попереднього елементу списку програвання
      <PgDown>/<Next> перестрибнути до наступного елементу списку програвання

      f               переключити повноекранний режим
      a              переключити розм╕р стор╕н в╕део (АВТО/16:9/4:3/DVB)
      i               переключити черезрядковий режим

      z / Shift-Z     зб╕льшити / зменшити масштаб в╕део
              + Ctrl    масштабування по горизонтал╕
              + Meta  масштабування по вертикал╕

      "<", ">"        модиф╕кувати розм╕р в╕кна
      + -             зм╕нити ауд╕о канал
      , .              зм╕нити канал субтитр╕в
      n m             в╕дрегульовати синхрон╕зац╕ю ауд╕о / в╕део
      <HOME>      встановити типову синхронизац╕ю  ауд╕о / в╕део 

      <INSERT>       переключити в╕дображення курсору миши у в╕кн╕ в╕део

      q               вих╕д

      h               сховати в╕део в╕кно (корисно для прослуховування mp3)

      
      Дал╕ буде. :-)

      Правий щовчок (або натиснення на 'g') на в╕кн╕ в╕део виходу переключа╓ 
      присутн╕сть панел╕ Г╤К.

      Зм╕на клав╕атурних комб╕нац╕й:

        Ви можете зм╕нити будь-яку клав╕атурну комб╕нац╕ю. для цього Ви повинн╕ мати
        файл keymap у Ваш╕й домашн╕й директор╕╖ ($HOME)/.xine/. Синтакс╕в ключ╕в наступний:

         WindowReduce {
            key = less
            modifier = none
         }

        Клав╕атурний ключ повинен в╕дпов╕дати рядку ключ╕в X11 (дивиться нижче).
       Модиф╕катори можуть бути:
	         - 'none' при в╕дсутност╕ модиф╕катора ,
                 - 'control' (або 'ctrl') для клав╕ши  "ctrl" ,
                 - 'meta' (або 'alt' для ПК) для мета ключа,
                 - 'mod3' або 'mod4' або 'mod5' доступн╕ т╕льк╕ на деяких платформах.

        Модиф╕катори можуть бути зм╕шан╕, розд╕лен╕ комою:
	
         WindowReduce {
           key = less
           modifier = control, alt
         }

        Якщо Ви не вказали рядок модиф╕катор╕в це р╕внозначно 'none'  (нема╓).

        Ви також можете додати псевдоними до клав. комб╕нац╕й, наприклад:
	 
	 Alias {
           entry = Pause
           key = p
         }

        Ма╓ться на уваз╕ що Ви дода╓те ╕ншу клав. комб╕нац╕ю до елементу 'Pause' , натиснув на 'p',
        Ви можете також додати секц╕ю модиф╕катора (див. вище). Якщо Ви не вкажите це, 
        модиф╕катор буде таким, як ╕ в ориг╕нальн╕й секц╕╖ ('Pause' в цьому випадку).

        Знаходження значень клав╕атурних ключ╕в X11:

        Щоб д╕знатися значення ключа (клав. комб╕нац╕╖) X11, Ви можете використовувати утил╕ту
       'xev', яка постача╓ться у склад╕ Вашого пакунку X11. Запустить 'xev' в терм╕нал╕ 
       (наприклад xterm), акцентуйте увагу на маленькому в╕кн╕, ╕ натиснить на клав╕шу,
       яку Ви хочете вжити.
      
         Дал╕ Ви побачите щось под╕бне до:
	
         ...
         KeyRelease event, serial 27, synthetic NO, window 0x3200001,
         root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
         state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
                                               ^^^^^^^^
			       Це те що Ви шука╓те.

        Перегляд поточно встановлених / переприв'язаних клав╕атурних ключ╕в:
      
        Ви можете запустити 'xine --keymap' або 'xine --keymap=default', щоб
        побачити типов╕ ключ╕. Зв╕сно, Ви можете перенаправити результат до
        файлу, який може сам по соб╕ стати конф╕гурац╕йним файлом  ~/.xine/keymap.
	
	Щоб побачити результат переприв'язки, запустить 'xine --keymap=remapped'.

2.4.2 Виб╕р ауд╕о канал╕в
   
      Задайте опц╕ю -a щоб вибрати бажа╓мий ауд╕о трек:
       
       xine -a 3 test.mpg

      Гра╓ 3 -ий доступний ауд╕о трек ( ╕ зв╕сно в╕део).

      Альтернативно Ви можете це зробити через Г╤К.

2.4.3 Виб╕р субтитр╕в

      Субтитри вбудован╕ в р╕зн╕ трек╕, наприклад ауд╕о. Зазвичай,
      трек 0 ╓ субтитром мови по умовчанню. Використовуйте опц╕ю -u 
      для вибору бажа╓мого треку субтитр╕в:

       xine -u 0 test.vob

      Показу╓ субтитри з потоку (треку) 0.

      Альтернативно Ви можете це зробити через Г╤К.

2.4.4 Д╕станц╕йне управл╕ння в Linux

      Xine може управлятися д╕станц╕йно за допомогою ╕нфра-червоних пульт╕в.
      Для цього, Ви повинн╕ мати встановлений пакунок LIRC (http://www.lirc.org).

      Ви можете додати деяк╕ елементи до Вашого конф. файлу ~/.lircrc, наприклад:
      
       begin
               remote = SAMSUNG
               button = Button_Play
               prog   = xine
               repeat = 0
               config = Play
       end
       begin
               remote = SAMSUNG
               button = Button_1
               prog   = xine
               repeat = 0
               config = SetPosition10%
       end

      Xine може самост╕йно генерувати типов╕ елементи конф╕гурац╕╖ для lirc, 
      вживая команду 'xine --keymap=lirc', вив╕д текстово╖ ╕нформац╕╖ з Xine
      Ви можете перенаправити до файлу ~/.lircrc.
      
      Кожний елемент под╕бно до:

       # Зменьшити розм╕р вих╕дного в╕кна.
       begin
               remote = xxxxx
               button = xxxxx
               prog   = xine
               repeat = 0
               config = WindowReduce
       end

      Вам залиша╓ться вказати ╕м'я в╕ддаленого об'╓кту (remote name), ╕ призначити клав╕шу.


3   ЩО ЩЕ ЗАЛИШИЛОСЯ СКАЗАТИ

3.1 СВОБОДА, DVD ╕ проблеми ...
   
    Xine це в╕льно доступне програмне забезпечення. "В╕льне" означа╓ з 
    "в╕дкритим кодом". Б╕льш того, значення терм╕ну "в╕льна програма" ма╓ 
    розширений сенс: абсолютно необмежене використання програми. 
   Якщо Ви ма╓те час, будь-ласка прочитайте що про це (свободу ╕ програми) 
   говорить асоц╕ац╕я в╕льного програмного забезпечення:
     
     => http://www.gnu.org/philosophy/free-sw.html

      У випадку, коли ╕нформац╕я розташована на DVD, поняття свободи тракту╓ться
    ╕накше:  к╕но╕ндустр╕я наполегливо робить спроби обмежити перегляд DVD за 
    допомогою апаратного контролю. Б╕льш╕сть DVD, що зараз продаються, зашифрован╕
    особливим чином - в деяких кра╖нах (наприклад в США), можливо дешифрування в╕део
    буде нелегальним, нав╕ть для приватного перегляду.

      Нащастя, багато людей погоджуються, що це дуже суперечливий п╕дх╕д для
    користувач╕в. Розробники проекту xine осуджують так╕ спроби к╕но╕ндустр╕╖, яка,
    намагаючись запоб╕гти втрат при продаж╕, таким способом насправд╕ демонстру╓
    велику неповагу до честних споживач╕в.
   
      З ╕ншого боку, розробники xine проти порушення ╕снуючого законодавства.
    Н╕хто точно не зна╓, чи ╓ насправд╕ нелегальним будь де у св╕т╕ розробляти,
    волод╕ти ╕ використовувати програмне забезпечення для перегляду зашифрованих
    DVD. Так як, це ╓ дос╕ невизначеною темою (що зда╓ться потенц╕йно дуже
    небезпечно),  xine не м╕стить н╕якого специф╕чного коду для дешифрування DVD.

    Зда╓ться що ╕нш╕ колективи програм╕ст╕в працюють над такими розширенням╕.
    Можливо в деяких кра╖нах можна легально використовувати так╕ програми.

     Так чи ╕накше Ви не зможете дивитися зашифрован╕ DVD за допомогою стандартного
    дистрибутиву xine. Майте на уваз╕, що це не вада типу "в╕дсутня функц╕я" а легальна
    проблема. Було б непогано розв'язати цю проблему (наприклад переконати
    Америку ╕/або к╕но╕ндустр╕ю, що вони ╕х роздратування ╕ недов╕ра до користувач╕в 
    ╕ розробник╕в в╕льного програмного забезпечення н╕чим не обгрунтована),
    але включення коду в xine для дешифрування DVD не вир╕шить проблему.

4   Контакти з проектом Xine

    Стор╕нка проекту xine :

     => http://xine.sourceforge.net

    В╕дгуки або пропозиц╕╖ з допомоги щ╕ро в╕таються, будь ласка зв'яжиться з нами:

    поштова розсилка xine -  <xine-user@lists.sourceforge.net>

 -----------------------------------------

  переклад укра╖нською Кудрика Серг╕я
  mailto: linux_ua@yahoo.com

 Можете звертатися до мене за допомогою,
 якщо ма╓те проблеми з Xine.






