 ++++++++++++++++++++++                                 +++++++++++++++++++++
                        XINE: Ilmainen/vapaa videosoitin       
 ++++++++++++++++++++++                                 +++++++++++++++++++++


 INDEX
 -===-
   
   1   KÃ¤yttÃ¶ohje
   1.1 Esikatselmus
   
   2   Xine:stÃ¤
   2.1 Tuetut kÃ¤yttÃ¶jÃ¤rjestelmÃ¤t ja vaatimukset
   2.2 KÃ¤ytetyt ohjelmat
   2.3 Xine:n kehittÃ¤jÃ¤t
   2.4 KÃ¤yttÃ¶
   2.4.1 PikÃ¤nÃ¤ppÃ¤imet
   2.4.2 Audio-kanavien valinta
   2.4.3 Tekstityksen valinta
   
   3   VielÃ¤ sanottavaa
   3.1 Vapaus, dvd:t ja muuta...
   
   4   Yhteyden ottaminen 







1   KÃ¤yttÃ¶ohje

1.1 Esikatselmus

    TÃ¤mÃ¤ on loppukÃ¤yttÃ¤jÃ¤n kÃ¤yttÃ¶hje xine-lib:lle ja xine-ui:lle. LÃ¶ydÃ¤t
    lisÃ¤Ã¤ dokumentaatiota molempien pakettien doc/ hakemistosta.
    
    Katso myÃ¶s tarkemmin FAQ (Useimmiten Kysytyt Kysymykset/UKK) tiedostoa
    xine-ui paketissa, jossa voi olla jo vastaus kysymykseesi.


2   Xine:stÃ¤

    Xine on ilmainen/vapaa GPL-lisensoitu videosoitin unix-tyylisille kÃ¤yttÃ¶-
    jÃ¤rjestelmille. Xine tukee mpeg-2 ja mpeg-1 (audio + video) tiedostoita,
    mpeg pÃ¤Ã¤virtoja (audio/video ainostaan, esim. mp3 tiedostoja), AVI
    tiedostoja useilla video-formaateilla (joitakin kÃ¤yttÃ¤en win32 dll:Ã¤)
    ja Vorbis OGG virtoja. SekÃ¤ hieman quicktime virtoja (mutta useimmat
    quicktime video ja audio koodekit ovat patentoituja ja siksi ei tuettuja).
    
    Xine toistaa video ja audio dataa virrasta ja synkronoi niiden toiston.
    Riippuen virran ominaisuuksista, toistaminen vaatii enemmÃ¤n tai vÃ¤hemmÃ¤n
    tehoa, tÃ¤ydellÃ¤ toistolla mpeg-2 on nÃ¤hty toimivan 400 MHz P II jÃ¤rjes-
    telmÃ¤llÃ¤.
    
    Xine voi toistaa Vdeo CD:tÃ¤, SVCD:tÃ¤ ja DVD:tÃ¤ suoraan. IkÃ¤vÃ¤ kyllÃ¤
    salatun/lukitun DVD:n toistamisen laillisuus joissakin maissa on
    epÃ¤varmaa, joten Xine ei sisÃ¤llÃ¤ DVD koodin purkamista. Sellaisen
    DVD:n toistamiseen tarvitset erillisen ohjelman tai kuten
    xine_dvd_plugin:n joka osaa hoitaa DVD:n purkamisen.
    
    Xine:n projekti tiimi kieltÃ¤Ã¤ kaiken vastuun xine:n kÃ¤yttÃ¤misen ko.
    tarkoituksiin.

    Xine 0.5 versiosta lÃ¤htien Xine:n arkkitehtuuri sallii joustavat
    "pluginit", joten monenlaiset muut virta-tyypit ja ulostulo-laitteet
    voisivat olla tuettuja tulevaisuudessa.
    
2.1 Tuetut kÃ¤yttÃ¶jÃ¤rjestelmÃ¤t ja vaatimukset

    - Xine vaatii X11 serverin video-ulostulolle
      (8, 15, 16, 24 or 32 bitin vÃ¤risyvyydellÃ¤)
      
    - Xine voi tunnistaa ja kÃ¤yttÃ¤Ã¤ MIT X videota ja X:n jaetun muistin
      laajennusta parempaan toistoon suoritukseen.
      
    - Jos et saa Xv:tÃ¤ toimimaan kÃ¤yttÃ¶jÃ¤rjestelmÃ¤ssÃ¤si, tÃ¤ytyisi sinun
      kÃ¤yttÃ¤Ã¤ 16 bitin vÃ¤risyvyyttÃ¤ nopeuden takia. Xv nÃ¤yttÃ¤Ã¤ toimivan
      hyvin millÃ¤ tahansa vÃ¤risyvyydellÃ¤.
      
    - Jos omistat Matrox G200/G400/G450 nÃ¤ytÃ¶nohjaimen voit myÃ¶s kÃ¤yttÃ¤Ã¤
      sybcfb/teletux video-ulostulo ajuria. Katso README.syncfb :stÃ¤
      lisÃ¤tietoa.
      
    - Ã¤Ã¤nen toistamiseen OSS, ALSA, ESD ja ARTSD ovat tuettuja.
    - aaxine kÃ¤yttÃ¤Ã¤ aalib :iÃ¤ ulostuloon ja toimii lÃ¤hes kaikilla
      terminaaleilla.
    - Xine:n kÃ¤Ã¤ntÃ¤miseen vaaditaan melko uusi GNU make, gcc ja binutils.

    Xine:n pitÃ¤isi toimia i386-yhteensopivilla koneilla (pentium tai
    uudempi) joka kÃ¤yttÃ¤Ã¤ GNU/linux:ia tai FreeBSD:tÃ¤. Riippuen toista-
    mastasi video-virrasta, tarvitset enemmÃ¤n tai vÃ¤hemmÃ¤n prosessori-
    tehoa. PerussÃ¤Ã¤ntÃ¶nÃ¤ on, ettÃ¤ DVD:t yleensÃ¤ pyÃ¶rivÃ¤t hyvin
    Pentium II 400 jÃ¤rjestelmÃ¤llÃ¤ (tai vastaavalla). TÃ¤hÃ¤n vaikuttaa
    useita tekijÃ¶itÃ¤, joten vaatimukset voivat vaihdella.

    Onnistuneesti testatut nÃ¤ytÃ¶nohjaimet (kÃ¤yttÃ¤en Xv:tÃ¤) Pc:lle ovat:
    nVidia Riva TNT (suljetuille nvidia ajureilla), nVidia Riva TNT 2,
    Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo 2000 PCI 16Mb.
    
    Seuraavien korttien on raportoitu toimivan, mutta on epÃ¤selvÃ¤Ã¤ toimi-
    vatko ne Xv:n vaiko vain XShm:n kanssa (raportoikaa asiasta xine-user
    postituslistalle):
         
     Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.

    Xine:n pitÃ¤isi pystyÃ¤ nÃ¤yttÃ¤mÃ¤Ã¤n videota millÃ¤ tahansa toimivalla
    xserver:llÃ¤ millÃ¤ tahansa nÃ¤ytÃ¶nohjaimella, mutta huonommalla tuloksella
    kuin Xv:n kanssa.

    Vaihtoehtoisesti, Xine pyÃ¶rii myÃ¶s i386-solariksella, sparc koneilla
    jotka kÃ¤yttÃ¤vÃ¤t linuxia ja solarista (Creator-3d framebufferin tiedetÃ¤Ã¤n
    toimivan), katso README.solaris :sta lisÃ¤tietoa.
    
    ViimeisinpÃ¤nÃ¤, muttei vÃ¤himmÃ¤isenÃ¤, Xine:n on kuultu toimivan Alphalla,
    IA-64 ja S/390 koneilla.

2.2 KÃ¤ytetetyt ohjelmat

    Xine kÃ¤yttÃ¤Ã¤ koodia seuraavista ulkoisista projekteista:

     - liba52 - Aaron Holtzman ja Michel Lespinasse
     - libmpeg2 - Aaron Holtzman ja Michel Lespinasse
     - libmad - Robert Leslie
     - libffmpeg - Fabrice Bellard

    Ilman nÃ¤itÃ¤ mahtavia ohjelman palasia Xine ei tietenkÃ¤Ã¤n olisi
    nykyisessÃ¤ pisteessÃ¤Ã¤n.

    SekÃ¤ lisÃ¤ksi paljon kiitoksia Linux Video ja DVD Projektille "LiViD",
    josta alkuperÃ¤iset Xine videosoittimen ideat tuli.
     
     => http://www.linuxvideo.org/

2.3 Xine:n kehittÃ¤jÃ¤t

    pÃ¤Ã¤-xine-kehittÃ¤jÃ¤
      Guenter Bartsch

    useita ehdotuksia, bugi ja kÃ¤Ã¤ntÃ¤misen korjauksia, alsa plugini, gui
      Daniel Caujolle-Bert 

    audio ohjelmointi
      Siegfried Langauf 

    mahtavat libmpeg2 ja libac3 hakkeroinnit:
      Michael Lespinasse
  
    Plus useita muita kehittÃ¤jiÃ¤, katso xine-lib/AUTHORS tiedosto

2.4 KÃ¤yttÃ¶
    
    Voit kÃ¤ynnistÃ¤Ã¤ Xine:n ilman komentorivin parametrejÃ¤ tai voit valita
    yhden tai useamman virran suoraan. Xine yrittÃ¤Ã¤ tunnistaa voiko se kÃ¤yttÃ¤Ã¤
    Xv laajennusta ja palaa takaisin XShm:n, mutta tÃ¤mÃ¤ tunnistus voi epÃ¤-
    onnistua. Voit mÃ¤Ã¤ritellÃ¤ video-ulostulo pluginin kÃ¤yttÃ¤mÃ¤llÃ¤ "-V"
    parametriÃ¤. Esim.

     xine -V XShm

    pakottaa Xine:n kÃ¤yttÃ¤mÃ¤Ã¤n XShm:Ã¤Ã¤ tai pelkkÃ¤Ã¤ X11:ta.

    Jos haluat lÃ¤hettÃ¤Ã¤ Ã¤Ã¤nen verkon yli ESD:llÃ¤, aseta ESPEAKER
    ympÃ¤ristÃ¶muuttuja (enviroment variable) ennen Xine:n kÃ¤ynnistystÃ¤.

    KÃ¤ytettÃ¤vÃ¤ virta voi olla tiedostonimi tai joko kÃ¤yttÃ¤mÃ¤mme
    "MediaResourceLocator" (tai MRL), joka nÃ¤yttÃ¤Ã¤ samanlaiselta kuin URL.
    EnsimmÃ¤iseksi mÃ¤Ã¤ritellÃ¤Ã¤n kÃ¤ytettÃ¤vÃ¤ lÃ¤hde jota seuraa "://" ja
    lÃ¤hteen tarkennustunniste. KÃ¤yttÃ¤mÃ¤si lÃ¤hteen muoto riippuu
    asennetuista plugineista (pelkille tiedostoille voit laittaa lÃ¤hteen
    tunnisteen).

    Kokeile:

     xine --help

    saadaksesi enemmÃ¤n tietoa kÃ¤ytÃ¶stÃ¤.

    Xine tukee xdnd protokollaa (versio 3) joten voit jos sinulla on
    tiedostojen hallintaohjelma joka tukee tÃ¤tÃ¤ protokollaa (esim gmc),
    voit laittaa ne toistamaan Xine:llÃ¤.

    3. raidan toistaminen VCD:ltÃ¤:

     xine vcd://3

    Esimerkki suoraan DVD toistoon:

     xine dvd://VTS_01_1.VOB


2.4.1 PikanÃ¤ppÃ¤imet

      NÃ¤ppÃ¤in         Toiminto
      
      <Entteri>       toista
      <vÃ¤lilyÃ¶nti>    tauko
      <YlÃ¶s>/<Alas>   pikakelaus / hidastus

      0               selaa virran alkuun
      1-9             selaa 10-90% :n
      <Vasen>/<Oikea> selaa -+ 15 sekunttia (+CTRL: 60 sek.)
      <PgUp>/<Edell.> edellinen soittolistan kohta
      <PgDown>/<Seur.> seuraava soittolistan kohta

      f               kokonÃ¤yttÃ¶ / ikkuna
      a               kuvasuhde (AUTO/16:9/4:3/DVB)
      i               "interlaced" tila

      z / Shift-Z     zoomaa lÃ¤hemmÃ¤ksi / kauemmaksi
                      lisÃ¤ttynÃ¤ Ctrl nÃ¤ppÃ¤imellÃ¤ horisontaalisesti tai
		      Alt nÃ¤ppÃ¤imellÃ¤ vertikaalisesti

      "<", ">"        muokkaa videoikkunan kokoa
      + -             vaihda audio-kanava
      , .             vaihda tekstitys-kanava
      n m             sÃ¤Ã¤dÃ¤ a/v sync:iÃ¤
      <HOME>          resetoi a/v sync

      <INSERT>        hiiren "grabbaus" videokuvaan (pÃ¤Ã¤lle/pois)

      q               lopetus

      h               piilota video ikkuna (kÃ¤ytÃ¤nnÃ¶lllinen mp3 toistoon)

      
      LisÃ¤Ã¤ tulossa :-)

      Klikkaa oikeanpuoleisella napilla (tai paina 'g') video ikkunaa
      vaihtaaksesi paneelin nÃ¤kyvyyttÃ¤.

      PikanÃ¤ppÃ¤inten vaihtaminen:
        Voit myÃ¶s vaihtaa yhtÃ¤/useita/kaikkia pikÃ¤nÃ¤ppÃ¤imiÃ¤. Sinulla pitÃ¤isi
	olla keymap tiedosto $HOME/.xine/ hakemistossa. Perussyntaksi:

         WindowReduce {
            key = less
            modifier = none
         }

        NÃ¤ppÃ¤imen pitÃ¤isi tÃ¤smÃ¤tÃ¤ X11 key stringiin (alla). Vaihtamis-
	nÃ¤ppÃ¤in voisi olla:
	         - 'none' ei vaihtamisnÃ¤ppÃ¤intÃ¤,
                 - 'control' (tai 'ctrl')  control nÃ¤ppÃ¤imelle,
                 - 'meta' (tai 'alt'  PC:llÃ¤) alt nÃ¤ppÃ¤imelle,
                 - 'mod3' tai 'mod4' tai 'mod5' joissakin jÃ¤rjestelmissÃ¤.

        Vaihtajia voi olla useita. Ne erotetaan pilkulla:
	
         WindowReduce {
           key = less
           modifier = control, alt
         }

        Jos et mÃ¤Ã¤ritÃ¤ vaihtaja riviÃ¤ se vastaa samaa kuin 'none'.

        Voit myÃ¶s mÃ¤Ã¤rittÃ¤Ã¤ aliaksia nÃ¤ppÃ¤imille:
	 
	 Alias {
           entry = Pause
           key = p
         }

        Jos lisÃ¤Ã¤t toisen nÃ¤ppÃ¤imen 'Pause' komennolle, painamalla 'p'
	voit myÃ¶s lisÃ¤tÃ¤ vaihtajanÃ¤ppÃ¤imen (katso yllÃ¤). Jos et mÃ¤Ã¤ritÃ¤
	sitÃ¤, niin vaihtajanÃ¤ppÃ¤in tulee olemaan sama kuin alkuperÃ¤isessÃ¤
	('Pause' tÃ¤ssÃ¤ tapauksessa).

      X11 key name:
        TietÃ¤Ã¤ksesi X11 key stringin, voit kÃ¤yttÃ¤Ã¤ 'xev':Ã¤, joka tulee X11
	paketin mukana. KÃ¤ynnistÃ¤ 'xev' xterm:stÃ¤, klikkaa ilmestyvÃ¤Ã¤ pientÃ¤
	ikkunaa (ts. anna focus ikkunalle) ja paina haluamaasi nÃ¤ppÃ¤intÃ¤.
      
        Sitten nÃ¤et seuraavanlaista:
	
         ...
         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,
                                               ^^^^^^^^
					       TÃ¤tÃ¤ kohtaa etsit.

      Muutettujen/oletus pikanÃ¤ppÃ¤inten katsominen:
        Voit kÃ¤yttÃ¤Ã¤ 'xine --keymap' tai 'xine--keymap=default' komentoa
	katsoaksesi pikanÃ¤ppÃ¤imet. Voit ohjata tuloksen tiedostoon, josta
	voi tulla ~/.xine/keymap itsessÃ¤Ã¤n.
	
	Katsoaksesi muutokset, kÃ¤ytÃ¤ komentoa 'xine --keymap=remapped'

2.4.2 Audio kanavien valinta

      KÃ¤ytÃ¤ -a parametriÃ¤ audio raidan valintaan:
       
       xine -a 3 test.mpg

      Toistaa kolmannen audio raidan (ja videon, tietysti)

      MyÃ¶s gui:ta (graafista kÃ¤yttÃ¶liittymÃ¤Ã¤) voidaan kÃ¤yttÃ¤Ã¤ audio
      kanavan valintaan.

2.4.3 Tekstityksen valitseminen

      Tekstitykset ovat sisÃ¤llytettyjÃ¤ raitoja kuten audiokin. Yleisesti
      raita 0 on oletuskielinen tekstitys. KÃ¤ytÃ¤ -u parametriÃ¤ tekstitys-
      raidan valintaan:

       xine -u 0 test.vob

      NÃ¤yttÃ¤Ã¤ tekstityksen 0 raidalta.

      MyÃ¶s gui:ta (graafista kÃ¤yttÃ¶liittymÃ¤Ã¤) voidaan kÃ¤yttÃ¤Ã¤ audio
      kanavan valintaan.

2.4.4 LIRC

      Xine:Ã¤ voidaan myÃ¶s ohjata infrapunakaukosÃ¤Ã¤timellÃ¤. TÃ¤tÃ¤ varten,
      sinulla pitÃ¤isi olla LIRC asennettuna (http://www.lirc.org).

      LisÃ¤Ã¤ muutamia kohtia ~/.lircrc tiedostoon seuraavasti:
      
       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 voi itsessÃ¤Ã¤n luoda lirc kohtien oletuslistan komennolla
      'xine --keymap=lirc', jonka voit ohjata tiedostoon asetusten
      hiomiseksi.
            
      Jokainen kohta nÃ¤ytÃ¤Ã¤ suurinpiirtein seuraavalta: 

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

      TehtÃ¤vÃ¤ksesi jÃ¤Ã¤ kaukosÃ¤Ã¤timen nimen ja nÃ¤ppÃ¤inten asettaminen.


3   VielÃ¤ sanottavaa

3.1 Vapaus, DVD:t ja muuta...

    Xine on vapaata ohjelmistoa ('free software'). Vapaa ohjelmisto liittyy
    avoimeen lÃ¤hdekoodiin ('open-source'). Kuitenkin, vapaan ohjelmiston
    kÃ¤site menee pitemmÃ¤lle: se on ohjelmiston kÃ¤yttÃ¤jien vapautta. Voit
    kÃ¤ydÃ¤ katsomassa mitÃ¤ 'free software foundation' sanoo vapaudesta ja
    ohjelmistoista:
     
     => http://www.gnu.org/philosophy/free-sw.html

    On olemassa uhka mitÃ¤ tulee DVD:siin: elokuvateollisuus on tekemÃ¤ssÃ¤
    suuria ponnistuksia DVD:n toiston estÃ¤miseksi ohjatuilla laitteistoilla.
    Useimmat DVD:t myydÃ¤Ã¤n koodattuina - ja joissakin maissa (ainakin
    USA:ssa) on laitonta purkaa tÃ¤mÃ¤ koodi yksityiseenkin kÃ¤yttÃ¶Ã¶n.
    Toivottavasti useimmat ihmiset ovat samaa mieltÃ¤, ettÃ¤ tÃ¤mÃ¤ on erittÃ¤in
    kyseenalainen tapa kohdella kuluttujia. Xine projekti tuomitsee nÃ¤mÃ¤
    elokuvateollisuuden ponnistukset - yrittÃ¤en samalla estÃ¤Ã¤ myyntien laskua
    sillÃ¤ tavalla joka osoittaa paljon epÃ¤kunnioitusta kaikkia rehellisiÃ¤
    asiakkaita kohtaan. Toisaalta Xine projektin tiimi on olemassa olevien
    lakien rikkomista vastaan. Kukaan ei oikeastaan tiedÃ¤, onko missÃ¤Ã¤n maassa
    laillista kirjoittaa, omistaa tai kÃ¤yttÃ¤Ã¤ ohjelmaa salatun DVD:n
    katseluun. Mutta, koska tÃ¤mÃ¤ on epÃ¤selvÃ¤Ã¤ (ja ilmeisesti vaarallista),
    xine ei sisÃ¤llÃ¤ suoranaista koodia DVD salauksen purkamaseksi. NÃ¤yttÃ¤Ã¤
    siltÃ¤, ettÃ¤ kolmannet osapuolet tekevÃ¤t tÃ¤llaisia laajennuksia.
    Mahdollisesti joissakin paikoissa on laitonta kÃ¤yttÃ¤Ã¤ nÃ¤itÃ¤. Oli miten
    oli - niin xine:llÃ¤ ilman erillisiÃ¤ laajennuksia ei voi toistaa
    salattuja DVD:tÃ¤. Huomioikaa, ettei tÃ¤mÃ¤ ole mikÃ¤Ã¤n bugi tai puuttuva
    ominaisuus, mutta aidosti laillisuus ongelma. Olisi mahtavaa ratkaista
    tÃ¤mÃ¤ ongelma (esim. vakuuttumalla amerikalle/elokuvateollisuudelle,
    ettÃ¤ he Ã¤rsyttÃ¤vÃ¤t ja ovat turhaan epÃ¤reiluja asiakkaita sekÃ¤ kÃ¤yttÃ¤jiÃ¤
    ja vapaan ohjelmistojen kehittÃ¤jiÃ¤ kohtaan), mutta sisÃ¤llyttÃ¤mÃ¤llÃ¤
    DVD:n purkukoodi xine:n ei ratkaise tÃ¤tÃ¤ ongelmaa.


4   Yhteyden ottaminen

    Xine projektin kotisivu:

     => http://xine.sourceforge.net

    Palaute ja avustusehdotukset ovat erittÃ¤in arvostettuja, ota yhtettÃ¤:

     xine-user postituslista (englanniksi) <xine-user@lists.sourceforge.net>
