 +++++++++++++++++++++++++                           +++++++++++++++++++++++++
                          XINE: Voln pehrva videa
 +++++++++++++++++++++++++                           +++++++++++++++++++++++++


  VERZE
    => $Id: README_cs,v 1.4 2003/06/13 15:45:56 pmhahn Exp $

 OBSAH
 -===-

   1   DOKUMENTACE
   1.1 el tohoto dokumentu

   2   O XINE
   2.1 Podporovan platformy a poadavky
   2.2 Pouit software
   2.3 Vvoji xine
   2.4 Pouit
   2.4.1 Klvesov zkratky
   2.4.2 Vbr zvukovch kanl
   2.4.3 Vbr titulk
   2.4.4 LIRC
   2.4.5 Nastaven konfiguranch voleb xine na pkazov dce

   3   CO JET NEBYLO EENO
   3.1 Svoboda a DVD...

   4   Kontakt na projekt xine

   5   esk peklad xine


1   DOKUMENTACE

1.1 el tohoto dokumentu

    Toto je dokumentace xine-lib a xine-ui pro koncov uivatele. Vce 
    informac naleznete v adresi doc/ u obou program.

    Tak se prosm na zvr podvejte na FAQ obsaen v balku xine-ui, 
    kter ji me obsahovat odpovdi na vae dotazy.

2   O XINE

    xine je svobodn videopehrva pod GPL licenc pro unixovsk systmy.
    Podporuje data ve formtu mpeg-2 a mpeg-1 (spolen zvuk + video),
    jednoduch data mpeg (samotn zvuk/video, nap. soubory mp3), soubory 
    AVI s nejrznjmi formty videa (nkter z nich za pouit win32 
    knihoven) a data Vorbis a OGG. Je zde i jist podpora pro sekvence 
    quicktime (ale vtina video a zvukovch kodek quicktime je 
    patentovna, tud nepodporovna).

    xine pehrv obrazov a zvukov data a pi pehrvn je synchronizuje.
    V zvislosti na vlastnostech formtu dat potebuje pehrvn vce i 
    mn vkonu procesoru, pln kvalita bez ztrty snmk byla pro mpeg-2 
    dosaena na systmu s procesorem P II 400 MHz.
    
    xine me pehrvat video pmo z CD, SVCD nebo DVD. Nanetst legln 
    status pehrvn zaifrovanch/zablokovanch DVD je v nkterch zemch
    nejasn, a tak xine neobsahuje dn kd na odblokovn/deifrovn DVD.
    K pehrvn takovch DVD budete potebovat dal programy nebo nco 
    jako xine_dvd_plugin, kter me zajistit autentifikaci/dekdovn DVD.
    
    Tm projektu xine odmt jakoukoliv zodpovdnost za takovto uivatele 
    xine.
    
    Architektura xine, jak je od verze 0.5, dovoluje pizpsobiteln 
    moduly, a tak mohou bt v budoucnu podporovny rzn dal typy formt 
    a vstupnch zazen.

2.1 Podporovan platformy a poadavky

    - xine vyaduje na vstup videa server X11
      (8, 15, 16, 24 nebo 32 bit barevn hloubky)

    - xine me detekovat a pouvat pro lep vkon pehrvn rozen 
      MIT X video nebo X shared memory

    - jestlie nemete pimt bet Xv na va platform, mli byste kvli 
      rychlosti pouvat barevnou hloubku 16 bit/bod. 
      Xv, zd se, pracuje vborn se vemi barevnmi hloubkami.

    - jestlie mte grafick adaptr Matrox G200/G400/G450, mete ppadn
      pout vstupn video ovlada syncfb/teletux. Vce detail viz. 
      README.syncfb.

    - je podporovno pehrvn zvuku pomoc OSS, ALSA, ESD a ARTSD.
    - aaxine pouv na vstup knihovnu aalib a me bet tm na vech 
      terminlech
    - k bezproblmovmu zkompilovn xine jsou vyadovny novj verze GNU 
      make, gcc a binutils

    xine by ml bet na vech novjch potach kompatibilnch s i386 
    (pentium a vy) pouvajcch GNU/Linux nebo FreeBSD. V zvislosti na 
    typu formtu videa, kter chcete pehrvat, budete pro plynul 
    pehrvn potebovat vce i mn vkonu procesoru. DVD se budou dobe 
    pehrvat zpravidla u na systmu s Pentiem II 400 MHz (nebo 
    srovnatelnm). V tomto odhadu je mnoho faktor, take vae poadavky by 
    se mohly liit.

    K spn testovanm grafickm kartm (pouvajcch Xv) pro PC pat:
    nVidia Riva TNT (closed-source ovladae od nvidie), nVidia Riva TNT 2,
    Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo3 2000 PCI 16Mb

    U nsledujcch karet bylo hleno e funguj, ale nen jasn zda 
    funguj s Xv nebo jen s XShm (prosm oznamujte na mailing list 
    xine-user):
    
     Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.

    xine by ml bt schopen zobrazit video na vech typech pracujcch 
    X server s jakmikoliv grafickmi kartami, ale s mnohem horm vkonem 
    ne s Xv.
    
    Dle xine b na potach i386-solaris a sparc s linuxem nebo 
    solarisem (o framebufferu Creator-3D je znmo, e funguje), vce 
    informac viz. README.solaris. Tak jsou podporovny: systmy zaloen 
    na powerpc (s bcm linuxem) a IRIX na MIPS.

    V neposledn ad bylo oznmeno, e xine funguje na potach Alpha, 
    IA-64 a S/390.
    
2.2 Pouit software

    xine pouv kd z nsledujcch projekt volnho softwaru:

     - liba52 od Aarona Holtzmana a Michela Lespinasse
     - libmpeg2 od Aarona Holtzmana a Michela Lespinasse 
     - libmad od Roberta Leslieho
     - libffmpeg od Fabrice Bellarda

    Bez tchto znamenitch kousk softwaru by samozejm xine nebyl tam, kde 
    je te.

    Tak velk dk projektu Linux Video a DVD "LiVid", odkud pochz pvodn 
    mylenky pro videopehrva xine.

      => http://www.linuxvideo.org/ 

2.3 Vvoji xine

    hlavn programovn xine

      Guenter Bartsch <guenter@users.sourceforge.net>

    nejrznj nvrhy, opravy chyb a kompilace, modul alsa, grafick 
    rozhran

      Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>

    mnoho oprav chyb a uvznut, detekce rychlosti toku dat, softwarov 
    korekce prokldn, mohutn aktualizace libwin32

      Miguel Freitas <miguel@cetuc.puc-rio.br>

    modul pro videovstup teletux/syncfb, rzn opravy chyb/revize, alsa

      Joachim Koenig <Joachim.Koenig@gmx.net>

    vvoj liba52/libmpeg2

      Michel Lespinasse <walken@zoy.org>

    balek pro Debian, uivatelsk podpora

      Siegfried Langauf <siggi@users.sourceforge.net>

    Plus mnoho dalch pispvovatel, viz. soubor xine-lib/AUTHORS

2.4 Pouit
    
    xine mete spustit bez jakchkoliv parametr na pkazov dce nebo  
    mete pmo specifikovat jeden nebo vce vstupnch dat. xine zkus 
    detekovat, jestli lze pout rozen Xv a pi nespchu se vrt 
    k XShm. Tato detekce by ale mohla selhat. Mete tedy specifikovat 
    vstupn ovlada videa pouitm volby "-V", nap.

     xine -V XShm

    pimje xine pout XShm nebo prost X11.

    Jestlie chcete poslat zvuk pes s pomoc ESD, nastavte promnnou 
    prosted ESPEAKER ped sputnm xine.

    Jako vstupn data mete specifikovat jmno souboru nebo nco, co 
    nazvme "MediaResourceLocator" (MRL), kter vypad podobn jako URL. 
    Naped uvedete zdroj vstupu, za kterm nsleduje "://", a pak 
    identifiktor specifick pro zadan zdroj dat. Jak zdroje dat mete 
    pout zvis na vstupnch modulech, kter mte (pro obyejn soubory 
    mete vynechat identifiktor zdroje vstupu "file://").

    Zkuste:

     xine --help

    zskte ucelenj informace o pouit.

    xine podporuje protokol xdnd (verze 3), a proto, jestli mte aplikaci 
    pro prci se soubory podporujc tento protokol (nap. gmc), mete 
    soubory s videem, kter chcete pehrvat, pesunout my na xine.

    Pehrn tet stopy z VCD:

     xine vcd://3

    Pklad pmho pstupu na DVD:

     xine dvd://VTS_01_1.VOB

2.4.1 Klvesov zkratky

      Klvesa          Akce

      [RETURN]         pehrt
      [MEZERNK]       pozastavit
      [Nahoru]/[Dol]  rychle vped / pomal pohyb

      0-9              zadn odpovdajcho sla
      /                posuv na zadan poet procent
      [Vlevo]/[Vpravo] skoit o -+ 15 sekund (+CTRL: 60 sekund)
      [PgUp]/[Prior]   skoit na pedchzejc poloku playlistu
      [PgDown]/[Next]  skoit na dal poloku playlistu

      f                pepnout mezi celoobrazovkovm a okennm reimem
      a                pepnout pomr vka/ka (AUTO/16:9/4:3/DVB)
      i                pepnout reim prokldn

      z / Shift-Z      zvtit / zmenit video
                       pidejte Ctrl ke zmn velikosti horizontln nebo 
                       Meta (Alt) ke zmn vertikln
     
      "<", ">"         upravit velikost vstupnho okna
      + -              zmnit zvukov kanl
      , .              zmnit kanl s titulky
      n m              pizpsobit synchronizaci zvuku a videa
      [HOME]           reset synchronizace zvuku a videa

      [INSERT]         zobrazit kurzor myi ve vstupnm okn videa

      q                ukonit

      h                skrt okno s videem (uiten pro pehrvn mp3)

     
      Dal pijdou. :-)

      Lev tlatko myi (nebo stisk 'g') v okn videa zapn nebo vypn
      ovldac panel.

      Zmna klvesovch zkratek:
         Vechny z tchto klvesovch zkratek mete mnit. Za tmto elem 
         byste mli mt mapu klvesnice ve vaem adresi $HOME/.xine. 
         Syntaxe kad poloky je:

         WindowReduce {
            key = less
            modifier = none
         }

         Jmno klvesy by mlo souhlasit s klvesovmi etzci X11 (viz. 
         ne). Modifiktor by ml bt:
                 - 'none' pro dn modifiktor,
                 - 'control' (nebo 'ctrl') pro klvesu Ctrl,
                 - 'meta' (nebo 'alt' na PC) pro klvesu Meta (Alt),
                 - 'mod3', 'mod4' nebo 'mod5' k dispozici jen na nkterch 
                   platformch

        Modifiktory se mohou kombinovat, oddluj se rkami:

         WindowReduce {
           key = less
           modifier = control, alt
         }

        Jestlie nespecifikujete dku s modifiktorem, je to stejn jako
        specifikovn 'none'.

        Mete tak pidat zstupce klvesovch zkratek, jako nap.:

         Alias {
           entry = Pause
           key = p
         }

        znamen, e pidvte dal klvesu do poloky 'Pause' - stisk 'p'.
        Mete tak pidat dku s modifiktorem (viz. nahoe). Jestlie ho 
        nespecifikujete, modifiktor bude stejn jako v pvodn sekci 
        (v tomto ppad 'Pause').

      Zjitn nzv klves v X11:
        Ke zjitn nzvu klvesy v X11 lze pout program 'xev', kter je
        dodvn s vam programovm balkem X11. Spuste 'xev' z xtermu, 
        pepnte se do zobrazenho malho okna a stisknte klvesu, kterou 
        chcete specifikovat.

        Uvidte nco jako:

         ...
         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,
                                               ^^^^^^^^
                                               Toto je, co hledte.

       U tlatek myi, pouit nap. koleka va myi, muste
       sledovat, kter tlatko je piazeno dan innosti, pouit xev:

         ButtonRelease event, serial 27, synthetic NO, window 0x1200001,
         root 0x3b, subw 0x0, time 2710360666, (107,87), root:(120,117),
         state 0x1000, button 5, same_screen YES
                       ^^^^^^^^
                       Toto je to tlatko

       V tomto ppad muste nastavit "key = XButton_5". Modifiktor klves 
       je s tlatky myi tak podporovn.
       
      Zobrazen aktulnch/zmnnch klvesovch zkratek:
        K zobrazen pedvolench klvesovch zkratek lze pout 
        'xine --keymap' nebo 'xine --keymap=default'. Vsledek mete 
        pesmrovat do souboru, kter pak sm me bt ~/.xine/keymap.

        Abyste zobrazili vsledek pemapovn klvesnice, prost pouijte
       'xine --keymap=remapped'.

2.4.2 Vbr zvukovch kanl

      Abyste vybrali poadovan zvukov kanl, pidejte volbu -a:

       xine -a 3 test.mpg

      Pehraje tet zvukov kanl, kter je k dispozici (s videem, 
      samozejm).

      Eventuln me bt k vbru zvukovho kanlu pouito grafick 
      uivatelsk rozhran.

2.4.3 Vbr titulk

      Titulky jsou vloeny v jinch stopch ne je zvuk. Pedvolen jazykov
      titulky jsou obvykle na stop 0. K vbru poadovan stopy s titulky 
      pouijte volbu -u:

       xine -u 0 test.vob

      Zobraz se titulky z kanlu 0.

      Eventuln me bt k vbru kanlu s titulky pouito grafick 
      uivatelsk rozhran.

      Titulky v oddlenm textovm souboru lze tak pout. Volba pro soubor
      s titulky se uvede za znakem '#':

       xine test.avi#subtitle:test.sub

      Pro sprvn zobrazen eskch znak zkontrolujte nastaven kdovn
      souboru s titulky, pednastaveno je windows-1250.
      Ve verzi xine-lib <= beta12 bylo teba zmnit i font titulk ze 
      "sans" na "sanshu". Nyn u pednastaven font "sans" obsahuje vechny
      esk znaky s diakritikou.

      pravy lze provst bu v konfiguranm dialogu nebo editac
      konfiguranho souboru ~/.xine/config2. Ten by ml obsahovat tyto daje:

      # string, default: sans
        codec.spu_font:sans

      # string, default: windows-1250
        codec.spu_src_encoding:windows-1250

2.4.4 LIRC

      xine me bt dlkov ovldn pomoc IR. Za tmto elem byste
      mli mt nainstalovan LIRC (http://www.lirc.org).

      Do vaeho souboru ~/.lircrc byste mli pidat nkter poloky, jako 
      nap.:
      
       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 sm me vytvoit nvrh lirc poloek pouitm 
      'xine --keymap=lirc', vstup mete pesmrovat do souboru a doladit 
      nastaven.

      Kad poloka bude vypadat njak takto:

       # Reduce the output window size.
       begin
               remote = xxxxx
               button = xxxxx
               prog   = xine
               repeat = 0
               config = WindowReduce
       end

      Je na vs specifikovat jmno v remote a piadit tlatko.

      Playlist:
      ---------
      K zskn playlistu z danho vstupnho modulu mete pout speciln
      klov slovo 'PlaylistFrom:' nsledovan jmnem modulu (stejn jako 
      na tlatku na okn panelu):

       # Retrieve playlist from NAV plugin.
       begin
               remote = xxxxx
               button = xxxxx
               prog   = xine
               repeat = 0
               config = PlaylistFrom:NAV
       end

2.4.5 Nastaven konfiguranch voleb xine na pkazov dce

      Jakoukoliv volbu mete nastavit z pkazov dky (viz. 
      README.config_en) a potlait tak nastaven hodnoty 
      v $HOME/.xine/config.

      Ke zmn zazen VCD mezi pehrnm dvma MRL mete napklad 
      udlat:
      
         xine vcd://1 opt:input.vcd_device=/dev/cdrom2 vcd://1

      Tato nastaven nebudou uloena v konfiguranm souboru, jsou pouze
      doasn.

3   CO JET NEBYLO EENO

3.1 Svoboda a DVD...

    xine je svobodn software. "svobodn software" je cosi pbuzn 
    "open-source". Avak vznam svobodnho softwaru jde dl ne jen oteven 
    zdrojov kdy: je to o svobod uivatel softwaru. Jestlie mte as, 
    prosm pette si, co k free software foundation na tma svoboda a 
    software:

     => http://www.gnu.org/philosophy/free-sw.html

    Je zde velmi zvltn sta o svobod a DVD: 
    filmov prmysl vytv obrovsk sil na omezen pehrvn DVD do
    kontrolovanch zazen. Nejvce DVD, kter se v souasn dob 
    prodvaj, jsou zaifrovna - a v nkterch zemch (zvlt v USA), je 
    zejm nelegln je deifrovat - dokonce i pro soukrom pehrvn.
    
    Snad bude nejvce lid souhlasit, e toto je velmi pochybn zpsob 
    zachzen se zkaznky. Tm projektu xine odsuzuje tato sil filmovho 
    prmyslu - zkou pedejt ztrt odbytu takovm zpsobem, e je
    rozhodn vidt mnoho necty ke vem jejich estnm zkaznkm.
    Na druhou stranu, tm projektu xine je proti poruovn existujcch
    zkon. Nikdo pesn nev jestli je nkde ve svt skuten nelegln
    pst, vlastnit a pouvat software na sledovn zaifrovanch DVD. Ale
    protoe je toto nejasn tma (a zd se potenciln velmi nebezpen), 
    xine neobsahuje dn specifick kd na deifrovn DVD. Zd se ale, e
    dal programtoi pracuj na takovchto rozench. Mon je na 
    nkterch mstech jejich pouvn legln. A tak nebo tak - nebudete 
    moci pehrvat zaifrovan DVD se samotnm xine tak, jak je. Prosm 
    vimnte si, e toto nen chyba nebo chybjc funkce, ale skuten 
    legln problm. Bylo by ohromn vyeit tento problm (nap. 
    pesvdovnm ameriky a/nebo filmovho prmyslu, e jsou skuten 
    nepjemn a zbyten nepoctiv k zkaznkm stejn jako k uivatelm 
    a vvojm volnho softwaru), ale zahrnut kdu na deifrovn DVD ve 
    xine tento problm nevye.

4   Kontakt na projekt xine

    webov strnka projektu xine je

     => http://xine.sourceforge.net

    reakce nebo nabdky pomoci jsou velmi cenny, prosm kontaktujte:

      mailov diskusn list uivatel xine <xine-user@lists.sourceforge.net>

5   esk peklad

Frantiek Dvok <valtri@atlas.cz>.
