 +++++++++++++++++++++++++                           +++++++++++++++++++++++++
                           XINE: A Free Video Player       
 +++++++++++++++++++++++++                           +++++++++++++++++++++++++


 INDEX
 -===-
   
   1   DE DOCUMENTATIE
   1.1 Doel van dit document
   
   2   OVER XINE
   2.1 Ondersteunde platformen en vereisten
   2.2 Gebruikte software
   2.3 Ontwikkelaars van xine
   2.4 Gebruik
   2.4.1 Toetsaanslagen en sneltoetsen
   2.4.2 Audio kanalen selecteren
   2.4.3 Ondertiteling selecteren
   2.4.4 LIRC
   2.4.5 Het instellen van de config-opties van xine op de commandoregel
   
   3   Wat er nog te zeggen valt
   3.1 Vrijheid, DVDs en andere dingen...
   
   4   Met het xine project in contact komen







1   DE DOCUMENTATIE

1.1 Doel van dit document

    Dit is de documentatie voor eindgebruikers van xine-lib en xine-ui. U kunt meer documentatie vinden in de map doc/ van beide pakketten.
    
    Neem ook een kijkje bij de FAQ die met het xine-ui pakket
    wordt meegeleverd waarin misschien al antwoorden zijn te vinden op uw vragen.


2   Over XINE

    xine is een vrij video-speler onder GPL-licentie voor unix-achtige systemen.
    Het kan met mpeg-2 en mpeg-1 systemen (audio + video multiplexed) streams overweg,
    mpeg elementary streams (alleen audio/video, b.v. mp3 bestanden), AVI bestanden
    met diverse video formaten (enkele daarvan gebruiken win32 dlls) en Vorbis
    OGG streams. Er is basis ondersteuning voor quicktime streams (maar de meeste
    quicktime video en audio codecs zijn in grote mate gepatenteerd en kunnen daarom niet afgespeeld worden).

    xine speelt de video en audio data van de stream af en synchroniseert het afspelen 
    van beide. Afhankelijk van de eigenschappen van de stream,
    heeft het afspelen min of meer rekenkracht nodig, de volledige frame rate
    voor mpeg-2 is op een 400 MHz P II systeem gezien.

    xine kan Video CDs, SVCDs en DVDs direct afspelen. Helaas is de legale status van het afspelen van versleutelde/afgesloten DVD onduidelijk
    in enkele landen zodat in xine geen DVD ontsleuteling code aanwezig is.
    Om dergelijke DVDs af te kunnen spelen heeft u externe programma's nodig of zoiets als een 
    xine_dvd_plugin die DVD authentificatie/ontcijfering aankan.
    
    Het xine project team wijst alle verantwoordelijkheid af voor een dergelijk gebruik van xine.

    Wegens de architectuur van xine 0.5 zijn flexibele plugins mogelijk, zodat wellicht
    in de toekomst verschillende andere stream types en uitvoer-methodes mogelijk worden.

2.1 Ondersteunde platformen en vereisten

    - xine heeft een X11 server nodig voor video uitvoer
      (8, 15, 16, 24 or 32 bit kleurdiepten)
      
    - xine kan de MIT X video en X shared memory extensie detecteren en gebruiken
      voor een betere afspeel performance
      
    - als u het niet lukt om Xv op uw platform werkend te krijgen dan zal u 16bpp 
      kleurendiepte moeten gebruiken om snelheid te houden. Xv lijkt met iedere kleurendiepte overweg te kunnen.
      
    - als u een Matrox G200/G400/G450 grafische kaart heeft dan kunt u optioneel
      de sybcfb/teletux video driver gebruiken. Zie README.syncfb voor meer
      details.
      
    - voor het afspelen van audio kan u OSS, ALSA, ESD en ARTSD gebruiken.
    - aaxine gebruikt aalib voor de uitvoer en kan in bijna elk terminalvenster worden gebruikt.
    - Om xine te compileren heeft u een vrij recente GNU make, gcc en binutils nodig.

    xine zou moeten werken op een i386-compatibel machine (pentium
    en nieuwer) dat GNU/linux of FreeBSD gebruikt. Afhankelijk van het type video
    stream dat u wilt afspelen heeft u meer of minder rekenkracht nodig voor
    het vloeiend afspelen. Als vuistregel, zullen DVDs pas goed afspelen
    op een Pentium II 400 systeem (of vergelijkbaar). Er zijn veel factoren die
    dit beïnvloeden, uw situatie kan dus anders zijn.

    Succesvol geteste grafische kaarten (met gebruik van Xv) voor Pc's zijn:
    nVidia Riva TNT (met closed-sources nvidia drivers), nVidia Riva TNT 2,
    Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo3 2000 PCI 16Mb

    Van de volgende kaarten is gemeld dat ze werken, maar het is onduidelijk
    of ze werken met Xv of alleen maar met XShm (meld dit op de
    xine-user mailing list):
     
     Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.

    xine zou in staat moeten zijn om video te tonen op elk type werkende xserver met 
    elk type grafische kaard, maar met een veel slechtere performance dan met Xv.

    Bovendien werkt xine ook op i386-solaris, sparc machines waarop linux
    of solaris draait (van Creator-3D framebuffer is bekend dat het werkt), zie README.solaris
    voor meer informatie. Ook werkend op: enkele op powerpc gebaseerde systemen (waarop
    linux draait) en IRIX op MIPS.
    
    Tenslotte is van xine ook gemeld dat het werkt op Alpha, IA-64
    en S/390 machines. 

2.2 Gebruikte software

    xine gebruikt code van de volgende externe free software projecten:

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

    Zonder deze geweldige stukken software zou xine uiteraard niet zijn wat het nu is.

    We bedanken ook het Linux Video en DVD Project "LiViD", waar de originele
    ideeën voor de xine videospeler vandaan komen.
     
     => http://www.linuxvideo.org/

2.3 De ontwikkelaars van xine

    Hoofd-ontwikkelaar van xine

      Guenter Bartsch <guenter@users.sourceforge.net>

    verschillende suggesties, bug en build fixes, alsa plugin, gui 

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

    veel bug en deadlock fixes, bitrate detectie, soft deinterlacer, 
    enorm veel libwin32 updates

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

    teletux/syncfb video output module, verschillende bugfixes/reviews, alsa

      Joachim Koenig <Joachim.Koenig@gmx.net>

    liba52/libmpeg2 ontwikkeling

      Michel Lespinasse <walken@zoy.org>

    Debian pakketten, user support

      Siegfried Langauf <siggi@users.sourceforge.net>

    Plus diverse andere ontwikkelaars, zie daarvoor het xine-lib/AUTHORS bestand

2.4 Gebruik
    
    U kunt xine zonder enige commandoregel parameters opstarten maar u kunt ook 
    een of meer invoer direct opgeven. xine probeert te detecteren of het de Xv extensie
    kan gebruiken en zal anders XShm gebruiken, het kan voorkomen 
    deze detectie mislukt. U kunt daarom de video-uitvoer plugin die gebruikt moet worden opgeven 
    met de "-V" optie, b.v.

     xine -V XShm

    zal xine dwingen om XShm of gewoon X11 te gebruiken. 

    Als u het geluid over een netwerk met ESD wilt versturen, stel dan de ESPEAKER
    parameter in bij het opstarten van xine.

    De invoer kan een bestandsnaam zijn of iets wat we een
    "MediaResourceLocator" (of MRL) noemen, wat lijkt op een URL. 
    Eerst specificeert u een type bron op gevolgt door "://" en een
    bestands-identificatie. Welke bronnen u kunt gebruiken hangt af
    van de invoer plugins die u heeft (voor gewone bestanden kunt u
    de invoer identificatie weglaten).

    Probeer:

     xine --help

    om uitgebreidere informatie te krijgen over het gebruik.

    xine kan met het xdnd protocool (Versie 3) overweg zodat
    als u een bestandsbeheerder heeft die met dat
    protocool overweg kan (b.v. gmc) dan kunt u de video-bestanden
    gewoon op xine laten vallen om afgespeeld te worden.

    Het afspelen van track 3 van een VCD:

     xine vcd://3

    Voorbeeld voor direct DVD toegang:

     xine dvd://VTS_01_1.VOB


2.4.1 Toetsaanslagen en sneltoetsen

      Toets           Actie

      [RETURN]        afspelen
      [SPACE]         pause
      [Up]/[Down]     snel voorwaarts / slow motion

      0-9             voer het betreffende cijfer in
      /               zoek de % relatief ten opzichte van het getal eerder ingevoerd
      [Links]/[Rechts]  zoek -+ 15 sec (+CTRL: 60 sec)
      [PgUp]/[Prior]  ga naar het vorige item in de afspeellijst
      [PgDown]/[Next] ga naar de volgende item in de afspeellijst

      f               schakelt de volledige scherm-modus
      a               schakelt tussen de aspect ratio (AUTO/16:9/4:3/DVB)
      i               schakelt de interlaced mode

      z / Shift-Z     inzoomen / uitzoomen op video
                      voeg Ctrl toe om horizontaal in te zoomen of Meta om verticaal in te zoomen

      "<", ">"        wijzigt de grootte van het uitvoervenster
      + -             wijzigt audio kanaal
      , .             wijzigt ondertitel kanaal
      n m             past a/v sync aan
      [HOME]          reset a/v sync

      [INSERT]        schakelt muis cursor invoer in het videovenster

      q               sluit programma af

      h               verbergt videovenster (handig bij afspelen van mp3)

      
      Meer volgt nog. :-)

      Rechtsklik (of druk op 'g') op het videovenster om de zichtbaarheid van het paneel te
      schakelen.

      sneltoetsen wijzigen:
        U kunt ook een/veel/alle sneltoetsen wijzigen. Hiervoor moet u het bestand keymap in uw $HOME/.xine/ map hebben. 
       De syntax voor een sneltoets is:

         WindowReduce {
            key = less
            modifier = none
         }

        De toets moet overeenkomen met X11 toets-code (zie hieronder).
        De modifier	kan zijn:
	         - 'none' voor geen modifier,
             - 'control' (of 'ctrl') voor de control toets,
             - 'meta' (of 'alt' op PC) voor de meta toets,
             - 'mod3' of 'mod4' of 'mod5' die alleen op sommige platvormen beschikbaar is.

        U kunt meerdere modifiers gebruiken, gescheiden door komma's:
	
         WindowReduce {
           key = less
           modifier = control, alt
         }

        Als u geen modifier lijn opgeeft dan kom dat overeen met 'none'.

        U kunt ook alias toetsaanslagen toevoegen zoals:
	 
	 Alias {
           entry = Pause
           key = p
         }

        Wat inhoud dat u nog een toetsaanslag aan het 'Pause' item kan toevoegen, door op 'p',
        toe te voegen kan u ook een modifier sectie (zie hierboven) toevoegen. Als u het hier niet specificeert,
        dan zal de modifier dezelfde zijn als in de originele sectie ('Pause'
	    in dit geval).

      De X11 toets-namen vinden:
        Om een X11 toets-code te weten te komen, kunt u 'xev' gebruiken,
        wat wordt meegeleverd met uw X11 pakket. Start 'xev' vanuit een xterm (commandovenster),
        geef de focus aan het kleine venster dat u te zien krijgt, en druk op de toets die u wilt weten.
      
        Dan zal u iets te zien krijgen dat eruit ziet als dit:
	
         ...
         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,
                                               ^^^^^^^^
					       Dit is waar we naar op zoek zijn.


        Wat betreft de muisknop, om uw muiswiel te gebruiken bijvoorbeeld,
        moet u uitvinden welke muisknop is verbonden met een functie,
        door xev te gebruiken:

         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
                       ^^^^^^^^
                       Dit is de knop

         In dit geval moet een "key = XButton_5" opgeven. Modifier toetsen
         kunt u ook gebruiken voor het hanteren van muisknoppen.
 

      De geselecteerde/remapped sneltoets tonen:
        U kunt 'xine --keymap' of 'xine --keymap=default' gebruiken om
        de standaard sneltoetsen te zien. U kan het resultaat naar een bestand sturen, wat dan
        zelf een ~/.xine/keymap kan worden.
	
	Om het resultaat van een remapping te bekijken, gebruikt u 'xine --keymap=remapped'.

2.4.2 Audio kanalen selecteren

      Gebruik de -a optie om de gewenste audio track te selecteren:
       
       xine -a 3 test.mpg

      Speelt de derde beschikbare audio track (en de video, uiteraard).

      Als alternatief kan u ook de menu's gebruiken om een audiokanaal te selecteren.

2.4.3 Ondertiteling selecteren

      Ondertitels worden in aparte tracks geplaatst net zoals audio.
      In het algemeen, is track 0 de ondertiteling voor de standaard taal.
      Gebruik de -u optie om de gewenste ondertitel-track te selecteren:

       xine -u 0 test.vob

      Toont de ondertitels op track 0.

      Als alternatief kan u ook het menu gebruiken om een ondertitel-kanaal te selecteren.

2.4.4 LIRC

      xine kan op afstand worden bediend met een IR (afstandbediening voor de televisie). Hiervoor moet u
      LIRC (http://www.lirc.org) hebben geïnstalleerd.

      U moet dan enkele items aan uw ~/.lircrc toevoegen, zoiets als dit:
      
       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 kan zelf een voorstel voor lirc items generen, gebruik hiervoor 'xine --keymap=lirc',
      waarvan u vervolgens het resultaat naar een bestand kan sturen om vervolgens de instellingen naar wens aan te passen.
      
      Elk item zal er uit zien als dit:

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

      Het is dan uw taak om de gewenste naam en knop op de IR te specificeren.

      afspeellijst
      ---------
      Om een afspeellijst uit een geselecteerde plugin te krijgen, kunt u 
      de speciale trefwoord 'PlaylistFrom:' gebruiken, gevolgd door de naam van de plugin (hetzelfde
      als bij de knop in het paneelvenster):

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

2.4.5 Het instellen van de config-opties van xine op de commandoregel

      U kunt vanaf de commandoregel elke optie (zie README.config_en) instellen waarmee u 
      de standaard waarde in $HOME/.xine/config tijdelijk overschrijft.

      U kunt bijvoorbeeld iets doen wat lijkt op

         xine vcd://1 opt:media.vcd.device=/dev/cdrom2 vcd://1

      om het vcd_device te wijzigen tussen het afspelen van twee mrls.

      deze optionele instellingen zullen niet worden opgeslagen in het configuratiebestand, ze zijn alleen 
      tijdelijk.


3   Wat er nog te zeggen valt

3.1 Vrijheid, DVDs en andere dingen...

    xine is vrije software. "free software" is een beetje gerelateerd aan
    "open-source". Echter, de betekenis van "free software" gaat verder
    dan alleen dat: het gaat over de vrijheid (freedom) van de gebruikers van software.
    Als u genoeg tijd heeft, lees dan wat de free software foundation zegt
    over de onderwerpen vrijheid (freedom) en software:
     
     => http://www.gnu.org/philosophy/free-sw.html

    Er is een zeer speciaal gevaar wat betreft vrijheid als het gaat over DVD's: de
    filmindustrie spant zich heel erg in om het afspelen van DVD's te beperken tot
    apparaten die onder controle staan. De meeste DVD's die op 
    dit moment worden verkocht zijn met geheime codes versleutelt - 
    en in sommige landen (met name de VS), is het verboden om ze te ontsleutelen - 
    zelfs voor eigen gebruik.
    Hopelijk zullen de meeste mensen het er mee eens zijn dat dit een dubieuze manier is
    om met klanten om te gaan. Het xine project team veroordeelt deze inspanningen van
    de filmindustrie - om de mindere verkoop op een dergelijke manier proberen te voorkomen
    toont veel minachting naar al hun eerlijke klanten.
    Aan de andere kant, is het xine project team tegen het breken van bestaande wetten.
    Niemand weet precies of het ergens in de wereld daadwerkelijk illegaal is om
    software voor het bekijken van versleutelde DVD's te schrijven, te bezitten en te gebruiken.
    Maar omdat dit een vaag onderwerp is (dat potentieel erg gevaarlijk lijkt),
    heeft xine geen specifieke code voor het ontsleutelen van DVD's. Het lijkt echter,
    dat andere partijen wel aan dergelijke extensies werken. Misschien
    dat op sommige plaatsen legaal is om deze te gebruiken. Hoe dan ook - u zal niet
    in staat zijn om versleutelde DVD's af te spelen met xine out-of-the-box. Merk op
    dat dit geen bug is of een 'ontbrekende functionaliteit', maar een echt legaal
    probleem. Het zou geweldig zijn als dit probleem wordt opgelost (b.v. door het overtuigen
    van America en/of de filmindustrie ze echt vervelend zijn en onnodig 
    onredelijk naar klanten maar ook naar gebruikers en ontwikkelaars van vrije software),
    maar het toevoegen van code aan xine voor het ontcijferen van DVD's
    zal dit probleem niet oplossen.


4   Met het xine project in contact komen

    de website van het xine project is

     => http://xine.sourceforge.net

    Feedback en het aanbod om te helpen wordt zeer gewaardeerd, neem daarvoor contact op met:

     de xine gebruikers mailing list <xine-user@lists.sourceforge.net>
