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


  VERSION
    => $Id: README_fi,v 1.4 2002/05/27 09:01:21 pmhahn Exp $
     
     
 INDEX
 -===-
   
   1   Kyttohje
   1.1 Esikatselmus
   
   2   Xine:st
   2.1 Tuetut kyttjrjestelmt ja vaatimukset
   2.2 Kytetyt ohjelmat
   2.3 Xine:n kehittjt
   2.4 Kytt
   2.4.1 Piknppimet
   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   Kyttohje

1.1 Esikatselmus

    Tm on loppukyttjn kytthje xine-lib:lle ja xine-ui:lle. Lydt
    lis dokumentaatiota molempien pakettien doc/ hakemistosta.
    
    Katso mys 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 kytt-
    jrjestelmille. Xine tukee mpeg-2 ja mpeg-1 (audio + video) tiedostoita,
    mpeg pvirtoja (audio/video ainostaan, esim. mp3 tiedostoja), AVI
    tiedostoja useilla video-formaateilla (joitakin kytten 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 enemmn tai vhemmn
    tehoa, tydell toistolla mpeg-2 on nhty toimivan 400 MHz P II jrjes-
    telmll.
    
    Xine voi toistaa Vdeo CD:t, SVCD:t ja DVD:t suoraan. Ikv kyll
    salatun/lukitun DVD:n toistamisen laillisuus joissakin maissa on
    epvarmaa, joten Xine ei sisll 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 kyttmisen ko.
    tarkoituksiin.

    Xine 0.5 versiosta lhtien Xine:n arkkitehtuuri sallii joustavat
    "pluginit", joten monenlaiset muut virta-tyypit ja ulostulo-laitteet
    voisivat olla tuettuja tulevaisuudessa.
    
2.1 Tuetut kyttjrjestelmt ja vaatimukset

    - Xine vaatii X11 serverin video-ulostulolle
      (8, 15, 16, 24 or 32 bitin vrisyvyydell)
      
    - Xine voi tunnistaa ja kytt MIT X videota ja X:n jaetun muistin
      laajennusta parempaan toistoon suoritukseen.
      
    - Jos et saa Xv:t toimimaan kyttjrjestelmsssi, tytyisi sinun
      kytt 16 bitin vrisyvyytt nopeuden takia. Xv nytt toimivan
      hyvin mill tahansa vrisyvyydell.
      
    - Jos omistat Matrox G200/G400/G450 nytnohjaimen voit mys kytt
      sybcfb/teletux video-ulostulo ajuria. Katso README.syncfb :st
      listietoa.
      
    - nen toistamiseen OSS, ALSA, ESD ja ARTSD ovat tuettuja.
    - aaxine kytt aalib :i ulostuloon ja toimii lhes kaikilla
      terminaaleilla.
    - Xine:n kntmiseen vaaditaan melko uusi GNU make, gcc ja binutils.

    Xine:n pitisi toimia i386-yhteensopivilla koneilla (pentium tai
    uudempi) joka kytt GNU/linux:ia tai FreeBSD:t. Riippuen toista-
    mastasi video-virrasta, tarvitset enemmn tai vhemmn prosessori-
    tehoa. Perussntn on, ett DVD:t yleens pyrivt hyvin
    Pentium II 400 jrjestelmll (tai vastaavalla). Thn vaikuttaa
    useita tekijit, joten vaatimukset voivat vaihdella.

    Onnistuneesti testatut nytnohjaimet (kytten 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 epselv 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 pitisi pysty nyttmn videota mill tahansa toimivalla
    xserver:ll mill tahansa nytnohjaimella, mutta huonommalla tuloksella
    kuin Xv:n kanssa.

    Vaihtoehtoisesti, Xine pyrii mys i386-solariksella, sparc koneilla
    jotka kyttvt linuxia ja solarista (Creator-3d framebufferin tiedetn
    toimivan), katso README.solaris :sta listietoa.
    
    Viimeisinpn, muttei vhimmisen, Xine:n on kuultu toimivan Alphalla,
    IA-64 ja S/390 koneilla.

2.2 Kytetetyt ohjelmat

    Xine kytt koodia seuraavista ulkoisista projekteista:

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

    Ilman nit mahtavia ohjelman palasia Xine ei tietenkn olisi
    nykyisess pisteessn.

    Sek lisksi paljon kiitoksia Linux Video ja DVD Projektille "LiViD",
    josta alkuperiset Xine videosoittimen ideat tuli.
     
     => http://www.linuxvideo.org/

2.3 Xine:n kehittjt

    p-xine-kehittj
      Guenter Bartsch

    useita ehdotuksia, bugi ja kntmisen korjauksia, alsa plugini, gui
      Daniel Caujolle-Bert 

    audio ohjelmointi
      Siegfried Langauf 

    mahtavat libmpeg2 ja libac3 hakkeroinnit:
      Michael Lespinasse
  
    Plus useita muita kehittji, katso xine-lib/AUTHORS tiedosto

2.4 Kytt
    
    Voit kynnist Xine:n ilman komentorivin parametrej tai voit valita
    yhden tai useamman virran suoraan. Xine yritt tunnistaa voiko se kytt
    Xv laajennusta ja palaa takaisin XShm:n, mutta tm tunnistus voi ep-
    onnistua. Voit mritell video-ulostulo pluginin kyttmll "-V"
    parametri. Esim.

     xine -V XShm

    pakottaa Xine:n kyttmn XShm: tai pelkk X11:ta.

    Jos haluat lhett nen verkon yli ESD:ll, aseta ESPEAKER
    ympristmuuttuja (enviroment variable) ennen Xine:n kynnistyst.

    Kytettv virta voi olla tiedostonimi tai joko kyttmmme
    "MediaResourceLocator" (tai MRL), joka nytt samanlaiselta kuin URL.
    Ensimmiseksi mritelln kytettv lhde jota seuraa "://" ja
    lhteen tarkennustunniste. Kyttmsi lhteen muoto riippuu
    asennetuista plugineista (pelkille tiedostoille voit laittaa lhteen
    tunnisteen).

    Kokeile:

     xine --help

    saadaksesi enemmn tietoa kytst.

    Xine tukee xdnd protokollaa (versio 3) joten voit jos sinulla on
    tiedostojen hallintaohjelma joka tukee tt 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 Pikanppimet

      Nppin         Toiminto
      
      <Entteri>       toista
      <vlilynti>    tauko
      <Yls>/<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               kokonytt / ikkuna
      a               kuvasuhde (AUTO/16:9/4:3/DVB)
      i               "interlaced" tila

      z / Shift-Z     zoomaa lhemmksi / kauemmaksi
                      listtyn Ctrl nppimell horisontaalisesti tai
		      Alt nppimell vertikaalisesti

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

      <INSERT>        hiiren "grabbaus" videokuvaan (plle/pois)

      q               lopetus

      h               piilota video ikkuna (kytnnlllinen mp3 toistoon)

      
      Lis tulossa :-)

      Klikkaa oikeanpuoleisella napilla (tai paina 'g') video ikkunaa
      vaihtaaksesi paneelin nkyvyytt.

      Pikanppinten vaihtaminen:
        Voit mys vaihtaa yht/useita/kaikkia piknppimi. Sinulla pitisi
	olla keymap tiedosto $HOME/.xine/ hakemistossa. Perussyntaksi:

         WindowReduce {
            key = less
            modifier = none
         }

        Nppimen pitisi tsmt X11 key stringiin (alla). Vaihtamis-
	nppin voisi olla:
	         - 'none' ei vaihtamisnppint,
                 - 'control' (tai 'ctrl')  control nppimelle,
                 - 'meta' (tai 'alt'  PC:ll) alt nppimelle,
                 - 'mod3' tai 'mod4' tai 'mod5' joissakin jrjestelmiss.

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

        Jos et mrit vaihtaja rivi se vastaa samaa kuin 'none'.

        Voit mys mritt aliaksia nppimille:
	 
	 Alias {
           entry = Pause
           key = p
         }

        Jos list toisen nppimen 'Pause' komennolle, painamalla 'p'
	voit mys list vaihtajanppimen (katso yll). Jos et mrit
	sit, niin vaihtajanppin tulee olemaan sama kuin alkuperisess
	('Pause' tss tapauksessa).

      X11 key name:
        Tietksesi X11 key stringin, voit kytt 'xev':, joka tulee X11
	paketin mukana. Kynnist 'xev' xterm:st, klikkaa ilmestyv pient
	ikkunaa (ts. anna focus ikkunalle) ja paina haluamaasi nppint.
      
        Sitten net 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,
                                               ^^^^^^^^
					       Tt kohtaa etsit.

      Muutettujen/oletus pikanppinten katsominen:
        Voit kytt 'xine --keymap' tai 'xine--keymap=default' komentoa
	katsoaksesi pikanppimet. Voit ohjata tuloksen tiedostoon, josta
	voi tulla ~/.xine/keymap itsessn.
	
	Katsoaksesi muutokset, kyt komentoa 'xine --keymap=remapped'

2.4.2 Audio kanavien valinta

      Kyt -a parametri audio raidan valintaan:
       
       xine -a 3 test.mpg

      Toistaa kolmannen audio raidan (ja videon, tietysti)

      Mys gui:ta (graafista kyttliittym) voidaan kytt audio
      kanavan valintaan.

2.4.3 Tekstityksen valitseminen

      Tekstitykset ovat sisllytettyj raitoja kuten audiokin. Yleisesti
      raita 0 on oletuskielinen tekstitys. Kyt -u parametri tekstitys-
      raidan valintaan:

       xine -u 0 test.vob

      Nytt tekstityksen 0 raidalta.

      Mys gui:ta (graafista kyttliittym) voidaan kytt audio
      kanavan valintaan.

2.4.4 LIRC

      Xine: voidaan mys ohjata infrapunakaukostimell. Tt varten,
      sinulla pitisi 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 itsessn luoda lirc kohtien oletuslistan komennolla
      'xine --keymap=lirc', jonka voit ohjata tiedostoon asetusten
      hiomiseksi.
            
      Jokainen kohta nyt suurinpiirtein seuraavalta: 

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

      Tehtvksesi j kaukostimen nimen ja nppinten asettaminen.


3   Viel sanottavaa

3.1 Vapaus, DVD:t ja muuta...

    Xine on vapaata ohjelmistoa ('free software'). Vapaa ohjelmisto liittyy
    avoimeen lhdekoodiin ('open-source'). Kuitenkin, vapaan ohjelmiston
    ksite menee pitemmlle: se on ohjelmiston kyttjien vapautta. Voit
    kyd 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 tekemss
    suuria ponnistuksia DVD:n toiston estmiseksi ohjatuilla laitteistoilla.
    Useimmat DVD:t myydn koodattuina - ja joissakin maissa (ainakin
    USA:ssa) on laitonta purkaa tm koodi yksityiseenkin kyttn.
    Toivottavasti useimmat ihmiset ovat samaa mielt, ett tm on erittin
    kyseenalainen tapa kohdella kuluttujia. Xine projekti tuomitsee nm
    elokuvateollisuuden ponnistukset - yritten samalla est myyntien laskua
    sill tavalla joka osoittaa paljon epkunnioitusta kaikkia rehellisi
    asiakkaita kohtaan. Toisaalta Xine projektin tiimi on olemassa olevien
    lakien rikkomista vastaan. Kukaan ei oikeastaan tied, onko missn maassa
    laillista kirjoittaa, omistaa tai kytt ohjelmaa salatun DVD:n
    katseluun. Mutta, koska tm on epselv (ja ilmeisesti vaarallista),
    xine ei sisll suoranaista koodia DVD salauksen purkamaseksi. Nytt
    silt, ett kolmannet osapuolet tekevt tllaisia laajennuksia.
    Mahdollisesti joissakin paikoissa on laitonta kytt nit. Oli miten
    oli - niin xine:ll ilman erillisi laajennuksia ei voi toistaa
    salattuja DVD:t. Huomioikaa, ettei tm ole mikn bugi tai puuttuva
    ominaisuus, mutta aidosti laillisuus ongelma. Olisi mahtavaa ratkaista
    tm ongelma (esim. vakuuttumalla amerikalle/elokuvateollisuudelle,
    ett he rsyttvt ja ovat turhaan epreiluja asiakkaita sek kyttji
    ja vapaan ohjelmistojen kehittji kohtaan), mutta sisllyttmll
    DVD:n purkukoodi xine:n ei ratkaise tt ongelmaa.


4   Yhteyden ottaminen

    Xine projektin kotisivu:

     => http://xine.sourceforge.net

    Palaute ja avustusehdotukset ovat erittin arvostettuja, ota yhtett:

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