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


Терміни:

 ГІК  - графічний інтерфейс користувача (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.






