 ++++++++++++++++++++++                                 +++++++++++++++++++++
                        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>
