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