 +++++++++++++++++++++++++                           +++++++++++++++++++++++++
                           XINE: Un lecteur video libre       
 +++++++++++++++++++++++++                           +++++++++++++++++++++++++


 INDEX
 -===-
   
   1   LA DOCUMENTATION
   1.1 But de ce document
   
   2   A PROPOS DE XINE
   2.1 Plateformes supportÃ©es et prÃ© requis
   2.2 Logiciels utilisÃ©s
   2.3 Les dÃ©veloppeurs de Xine
   2.4 Utilisation
   2.4.1 Raccourcis clavier
   2.4.2 Selection des canaux audio
   2.4.3 SÃ©lection des sous titres
   
   3   QUE RESTE T'IL A DIRE ?
   3.1 LibertÃ©, DVD et autres choses...
   
   4   Contacter le projet Xine







1   LA DOCUMENTATION

1.1 But de ce document

    Il s'agit de la documentation destinÃ©e Ã  l'utilisateur final de xine-lib 
    et xine-ui. Vous pourrez trouver plus de documentation dans le rÃ©pertoire
    doc/ de chacun des packages.

    Merci Ã©galement de regarder de plus prÃ¨s les questions frÃ©quentes (le FAQ),
    inclus dans le package xine-ui, qui pourrais Ã©galement contenir des
    rÃ©ponses Ã  vos questions.

2   A PROPOS DE XINE

    xine est un lecteur vidÃ©o libre, pour systÃ¨mes de type UNIX, fonctionnant
    sous licence GPL.
    Il supporte les systÃ¨mes (vidÃ©o et son multiplexÃ©s) de flux MPEG-2 & MPEG-1,
    des flux MPEG Ã©lÃ©mentaires (audio/vidÃ©o seulement, c.f. fichiers MP3), les
    fichiers AVI avec de nombreux formats vidÃ©o (certain utilisant des DLLs
    win32) et les flux OGG Vorbis. Il existe un support pour certains flux
    Quicktime (mais la plupart des codecs vidÃ©o et audio de Quicktime sont
    hautement propriÃ©taires, et de ce fait non supportÃ©s).

    Xine lit les donnÃ©es vidÃ©o et audio dans les flux et synchronise leur
    lecture. En fonction des propriÃ©tÃ©s des flux, la lecture necessitera plus
    ou moins de charge processeur, la taux de rafraichissement maximal pour du
    MPEG-2 a Ã©tÃ© signalÃ© sur un P-II 400.

    Xine peut lire des Video CDs, SVCDs, et des DVDs directement. Malheureu-
    sement, le statut lÃ©gal des DVD encryptÃ©s/bloquÃ©s est incertain dans 
    plusieurs pays, ainsi Xine ne contient pas le code de dÃ©cryptage/dÃ©bloquage.
    Pour lire de tels DVDs, vous aurez besoin de programmes externes tels que
    un xine_dvd_plugin qui peut controler l'authentification/dÃ©cryptage.

    L'Ã©quipe du projet Xine dÃ©nigre toute responsabilitÃ© pour un tel usage de
    Xine.    

    Puisque l'architecture 0.5 de xine permet l'utilisation de plugins
    flexibles, des formats de flux divers et variÃ©s, ainsi que des nouveaux
    pÃ©riphÃ©riques de sortie pourront Ãªtre supportÃ©s dans le futur.

2.1 Plate-formes supportÃ©es et prÃ©-requis

    - Xine a besoin d'un serveur X11 pour la sortie vidÃ©o
      (8, 15, 16, 24 ou 32 bits de profondeur de couleur)

    - Xine peut dÃ©tecter et utiliser les extensions 'MIT X video' et la mÃ©moire
      partagÃ©e X ('X shared memory') pour de meilleures performance de lecture.

    - Si vous ne pouvez pas utiliser Xv pour fonctionner sur votre plate forme,
      vous devriez utiliser du 16 bit de profondeur de couleur pour la vitesse.
      Xv semble fonctionner correctement pour tout les modes de couleur.
      
    - Si vous possÃ©dez une carte vidÃ©o Matrox G200/G400/G450, vous pouvez
      optionnellement utiliser le driver de sortie vidÃ©o sybcfb/teletux.
      Reportez vous au fichier README.syncfb pour les dÃ©tails.
   
    - Pour la lecture audio, OSS, ALSA, ESD, ARTSD son supportÃ©s.
    - aaxine utilises aalib pour la sortie vidÃ©o, et peut Ãªtre lancÃ© sur 
      presque tout les terminaux.
    - Pour compiler Xine, des versions de make, gcc et binutils assez rÃ©centes
      sont requises.
      
    Xine devrait fonctionner sur n'importe quel compatible PC rÃ©cent (Pentium
    et plus) utilisant GNU/Linux ou FreeBSD.
    DÃ©pendant directement du type de flux que vous voulez visionner, vous aurez
    besoin de plus ou moins de puissance processeur pour une lecture fluide. 
    A titre de comparaison, les DVDs commenceront a Ãªtre lu correctement Ã 
    partir d'un systÃ¨me Pentium II 400 (ou Ã©quivalent). Il y a plusieurs 
    facteurs dans l'Ã©quation, votre rÃ©sultat peut donc varier.

    Les cartes vidÃ©o testÃ©es avec succÃ¨s (utilisant Xv) pour les PCs sont :
    nVidia Riva TNT (Drivers nvidia protÃ©gÃ©s), nVidia Riva TNT 2, Matrox G400,
    ATI AIW Rage 128-16 MB, 3dfx Voodoo 3 2000 PCI 16 MB
    
    Les cartes suivantes ont Ã©tÃ©s rapportÃ©es comme fonctionnelles, cependant il
    n'est pas clair de savoir si elles fonctionnent avec Xv ou seulement avec
    XShl (Merci de consulter la mailing list 'xine-user') :

    Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.

    Xine devrait Ãªtre capable de montrer de la vidÃ©o sur n'importe quel type de
    serveur X fonctionnant avec n'importe quelle carte graphique, cependant
    avec de plus mauvaise performance comparativement Ã  Xv.
  
    De plus, Xine fonctionne sur Solaris pour i386, machines SPARC sous Linux
    ou Solaris (le framebuffer CREATOR-3D est connu pour fonctionner), voir
    README.solaris pour plus d'information. Egalement supportÃ©s : certains
    systÃ¨mes basÃ©s sur le powerpc (sous Linux), et IRIX sur les MIPS.

    Et le dernier mais non le moindre, Xine est Ã©galement rapportÃ© comme
    fonctionnant sur Alpha, IA-64 et S/390.
    
2.2 Logiciel utilisÃ©s

    Xine utilises du code des projets libres suivant :

     - liba52 par Aaron Holtzman et Michel Lespinasse
     - libmpeg2 par Aaron Holtzman et Michel Lespinasse
     - libmad par Robert Leslie
     - libffmpeg par Gerard Lantau

    Sans ces grandes parties de code, Xine ne serait Ã©videmment par ou il en
    est maintenant.

    De nouveau, de nombreux remerciements au projet Linux Video et DVD "LiViD",
    d'ou sont venus les idÃ©es originelles pour le lecteur vidÃ©o Xine.

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

2.3 Les dÃ©veloppeurs de Xine

    Programmation principale de Xine

      Guenter Bartsch <guenter@users.sourceforge.net>

    Suggestions diverses, correctifs de compilation et de programmation,
    plugin Alsa, interface utilisateur

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

    Plusieurs correctifs de bugs et de crash, dÃ©tection du taux d'Ã©chantillo-
    nage, dÃ©sentrelacement logiciel, mises Ã  jour massives de libwin32

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

    Routine de sortie vidÃ©o teletux/syncfb, corrections de bugs/tests variÃ©s,
    Alsa

      Joachim Koenig <Joachim.Koenig@gmx.net>

    DÃ©veloppement liba52/libmpeg2

      Michel Lespinasse <walken@zoy.org>

    Package Debian, support utilisateur

      Siegfried Langauf <siggi@users.sourceforge.net>

    Ajoutons Ã  cela diverses autres contributions, voir le fichier
    xine-lib/AUTHORS

2.4 Utilisation
    
    Vous pouvez faire fonctionner Xine sans paramÃ¨tre de ligne de commande,
    ou vous pouvez spÃ©cifier, un ou plus, flux d'entrÃ©e directement. Xine
    tentera de dÃ©tecter si il peut utiliser l'extension Xv, ou retourner Ã  XShm,
    mais cette dÃ©tection peut Ã©chouer.
    Vous pouvez spÃ©cifier la sortie vidÃ©o en utilisant l'option "-V", par
    exemple :
    
     xine -V XShm

    forcera Xine Ã  utiliser XShm ou seulement X11.

    Si vous voulez envoyer le son sur un rÃ©seau avec ESD, placer la variable
    ESPEAKER avant de dÃ©marrer Xine.

    Le flux d'entrÃ©e peut Ãªtre un nom de fichier ou quelque chose que nous
    appelons "MediaResourceLocator" (ou MRL), qui ressemble Ã  une URL. Tout
    d'abord, vous spÃ©cifiez une source suivie de "://" et un identificateur
    spÃ©cifique de source d'entrÃ©e. Les sources utilisables dÃ©pendent des
    plugins d'entrÃ©e possÃ©dÃ©s (pour de simples fichiers, vous pouvez omettre
    l'identificateur de source d'entrÃ©e).

    Essayez :

    xine --help

    pour obtenir une information plus complÃ¨te sur les options..

    Xine supporte le protocol xdnd (Version 3), donc si vous avez un
    gestionnaire de fichiers supportant ce protocole (par ex. gmc) vous pouvez
    dÃ©placer des fichiers vidÃ©o dans Xine pour lecture.

    Lecture de la piste 3 d'un VCD :

     xine vcd://3

    Exemple pour un accÃ¨s direct au DVD :

     xine dvd://VTS_01_1.VOB


2.4.1 Raccourcis claviers

      Touche          Action

      [ENTREE]        Lecture
      [ESPACE]         Pause
      [Haut]/[Bas]     Avance rapide / ralenti

      0               Cherche le dÃ©but du flux courant
      1-9             Cherche 10-90 % du flux courant
      [Gauche]/[Droite]  Cherche +/- 15 sec(+CTRL : 60 sec)
      [PgUp]/[PrÃ©cedent] Saut Ã  l'entrÃ©e de playlist prÃ©cÃ©dente
      [PgDown]/[Suivant] Saut Ã  l'entrÃ©e de playlist suivante

      f               Passage en plein Ã©cran
      a               Changement du ratio d'aspect (AUTO/16:9/4:3/DVB)
      i               Changement du mode d'entrelacement

      z / Shift-Z     Zoom in / out de la vidÃ©o
      		      Ajouter CTRL pour zoomer horizontalement ou meta pour
		      zoomer verticalement

      "<", ">"        Modification de la taille de la sortie vidÃ©o
      + -             Changement du canal audio
      , .             Changement du canal de sous-titrage
      n m             Ajustement de la synchronisation audio/vidÃ©o
      [HOME]          Remise Ã  zÃ©ro de la synchro audio/vidÃ©o

      [INSERT]        Activation de l'affichage du curseur de la souris dans
		      la fenetre de sortie video

      q               Quitter

      h               Cacher la fenetre video (utile pour la lecture MP3)

      
      Plus a venir. :-)

      Clic droit (ou touche 'g') dans la fenetre de sortie video pour activer
      l'affichage du panneau de controle.

      Changement des raccourcis :
        Vous pouvez Ã©galement changer un/plusieurs/tout les raccourcis. Pour
        cela, vous devrez avoir un fichier .xine_keymap dans votre rÃ©pertoire
        $HOME. La syntaxe d'entrÃ©e d'un raccourci est :

         WindowReduce {
            key = less
            modifier = none
         }

        La touche doit correspondre avec les codes de touche X11. Le modifica-
        teur peut Ãªtre :
                - 'none' quand il n'y a aucun modificateur,
                - 'control' (ou 'ctrl') pour la touche control,
                - 'meta' (ou 'alt' sur PC) pour la touche meta,
                - 'mod3' ou 'mod4' ou 'mod5' disponible seulement sur certaines
                plate-formes.

        Les modidicateurs peuvent Ãªtre mixÃ©s, sÃ©parÃ©s par des virgules :

         WindowReduce {
           key = less
           modifier = control, alt
         }

        Si vous ne spÃ©cifiez pas de ligne de modificateur, alors ce dernier est
        Ã©quivalent Ã  'none'.

        Vous pouvez Ã©galement ajouter des alias de raccourcis, tels que :
	 
	 Alias {
           entry = Pause
           key = p
         }

        Ce qui signifie que vous avez ajoutÃ© un autre raccourci Ã  l'entrÃ©e
        'Pause', en appuyant sur 'p', vous pouvez Ã©galement ajouter une section
        modificateur (voir ci-dessus). Si vous ne le spÃ©cifiez pas, le modifi-
        cateur sera le mÃªme que dans la section originale ('Pause' dans le cas
        prÃ©sent).

      Recherche de nom de touches sous X11 :
        Pour connaitre la chaine d'une touche X11, vous pouvez utiliser 'xev',
        qui est fourni avec votre package X11.
        DÃ©marrez 'xev' d'un terminal (comme 'xterm'), donnez la main Ã  la
        petite fenÃªtre affichÃ©e, et appuyez sur la touche que vous dÃ©sirez
        spÃ©cifier.
      
        A ce moment, vous verrez quelque chose comme :
         ...
         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,
                                               ^^^^^^^^
					       C'est ce que vous cherchez.

      Afficher les raccourcis courants ou crÃ©Ã©s :
        Vous pouvez utiliser 'xine --keymap' ou 'xine --keymap=default' pour
        afficher les raccourcis par dÃ©faut.
        Vous pouvez rediriger les rÃ©sultats vers un fichier, qui peut devenir
        un .xine_keymap.

        Pour voir les rÃ©sultats du remappage, utiliser simplement
        'xine --keymap=remapped'

2.4.2 SÃ©lection des canaux audio

      Ajouter l'option -a pour sÃ©lectionner la piste audio dÃ©sirÃ©e :

       xine -a 3 test.mpg

      Lit la troisiÃ¨me piste audio disponible (et la vidÃ©o, bien sur).

      L'interface utilisateur permet Ã©galement pour sÃ©lectionner une piste
      audio.

2.4.3 Selection des sous-titres

      Les sous-titres sont stockÃ©s dans des pistes diffÃ©rentes comme l'audio.
      En gÃ©nÃ©ral, la piste 0 est le sous-titre de la langue par dÃ©faut.
      Utilisez l'option -u pour sÃ©lectionner la piste de sous-titrage dÃ©sirÃ©e : 

       xine -u 0 test.vob

      Affiche les sous-titre du flux 0.

      Il est Ã©galement possible de changer le sous-titrage via l'interface
      utilisateur.

2.4.4 LIRC

      Xine peut Ãªtre controlÃ© Ã  distance par infrarouges. Pour cela, vous
      devrez avoir LIRC d'installÃ© (http://www.lirc.org).

      Vous pouvez ajouter des entrÃ©es dans votre fichier ~/.lircrc, comme :
      
       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 peut auto-gÃ©nÃ©rer un modÃ¨le d'entrÃ©es lirc, en utilisant
      'xine --keymap=lirc', il est alors possible de rediriger la sortie vers
      un fichier pour affiner les rÃ©glages.
      
      Toute entrÃ©e ressemblera Ã  Ã§a :

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

      C'est Ã  vous de spÃ©cifier le nom de la tÃ©lÃ©commande, et Ã  assigner le
      bouton.


3   QUE RESTE T'IL A DIRE ?

3.1 LibertÃ©, DVDs et autre choses

    Xine est un logiciel libre. "Logiciel libre" est relatif au fait d'Ãªtre 
    "open-source".
    Cependant, la signification de "logiciel libre" dÃ©passe ce cadre : cela
    exprime la libertÃ© des utilisateurs des logiciels. Si vous avez le temps,
    merci de lire ce que la Free software foundation Ã©crit Ã  propos de la
    libertÃ© et des logiciels :
    
    => http://www.gnu.org/philosophy/free-sw.html

    Il y a une rÃ©elle menace Ã  la libertÃ© quant on en vient aux DVDs :
    l'industrie cinÃ©matographique fait d'immenses efforts pour restreindre la
    lecture des DVDs dans des machines controllÃ©es. La plupart des DVDs
    actuellement vendus le sont de maniÃ¨re propriÃ©taire - et dans certains pays
    (notamment aux USA), il peut Ãªtre illÃ©gal de les dÃ©crypter - mÃªme dans le
    cadre d'une lecture privÃ©e.
    Heureusement une majoritÃ© de gens conviendront que c'est une maniÃ¨re
    trÃ¨s discutable de traiter les consommateurs. L'Ã©quipe du projet Xine
    condamne ces efforts de l'industrie du cinÃ©ma, dans leur essai d'enrayement
    de la perte de ventes par le dÃ©monstration d'un manque de respect vis Ã  vis
    de tous les clients honnÃªtes.
    Cependant, l'Ã©quipe du projet Xine est contre le fait de briser les lois
    existantes.
    Personne ne sait exactement si il est effectivement illegal quelque part
    d'Ã©crire, de possÃ©der et d'utiliser des logiciels pour la lecture de DVDs
    encryptÃ©s. Mais comme c'est un point obscur (qui semble potentiellement
    trÃ¨s dangereux), Xine ne contient aucun code susceptible de dÃ©crypter les
    DVDs. Il semble, cependant, que des parties tierces travaillent sur de
    telles extensions. Peut-Ãªtre dans des endroits ou il est lÃ©gal d'utiliser
    ces programmes. Quoi qu'il en soit, vous serez incapable de lire des DVDs
    encryptÃ©s avec Xine tel-quel. Merci de noter que ce n'est ni un bug, ni
    une fonctionnalitÃ© manquante, mais bien un problÃ¨me lÃ©gal original. Il
    serait bienvenue de rÃ©soudre le problÃ¨me (par exemple en convaincant
    l'AmÃ©rique et/ou l'industrie cinÃ©matographique qu'ils sont vraiment gÃªnants
    et injustes envers les clients, aussi bien qu'envers les utilisateurs et
    les dÃ©veloppeurs de logiciels libres, mais l'inclusion du code de 
    dÃ©cryptage de DVDs dans Xine ne rÃ©soudra pas le problÃ¨me.


4   Contacter le projet Xine

    Le site web du projet Xine est :

     => http://xine.sourceforge.net

    Les retours ou offres d'aide sont grandement apprÃ©ciÃ©s, merci de contacter :

     La mailing list des utilisateurs Xine <xine-user@lists.sourceforge.net>

