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


  VERSION
    => $Id: README_fr,v 1.1 2002/06/17 19:16:04 heikos Exp $
     
     
 INDEX
 -===-
   
   1   LA DOCUMENTATION
   1.1 But de ce document
   
   2   A PROPOS DE XINE
   2.1 Plateformes supportes et pr requis
   2.2 Logiciels utiliss
   2.3 Les dveloppeurs de Xine
   2.4 Utilisation
   2.4.1 Raccourcis clavier
   2.4.2 Selection des canaux audio
   2.4.3 Slection 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 destine  l'utilisateur final de xine-lib et xine-ui.
    Vous pourrez trouver plus de documentation dans le rpertoire doc/ de chacun des packages.

    Merci galement de regarder de plus prs les questions frquentes (le FAQ), inclus dans le
    package xine-ui, qui pourrais galement contenir des rponses  vos questions.

2   A PROPOS DE XINE

    xine est un lecteur vido gratuit, pour systmes de type UNIX, fonctionnant sous licence GPL.
    Il supporte les systmes (Vido et son multiplexs) de flux MPEG-2 & MPEG-1, des flux MPEG lmentaires
    (Audio/vido seulement, c.f. fichiers MP3), les fichiers AVI avec de nombreux formats vido (certain utilisant
    des DLLs win32) et les flux OGG Vorbis. Il existe un support pour certains flux Quicktime (mais la plupart des 
    des codecs vido et audio de Quicktime sont hautement propritaires, et de ce fait non supports).

    Xine lit les donnes vido et audio dans les flux et synchronise leur lecture. Dpendant des proprits 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. Malheureusement, le statut lgal des DVD encrypts/bloqus
    est incertain dans plusieurs pays, ainsi Xine ne contient pas le code de dcryptage/dbloquage.
    Pour lire de tels DVDs, vous aurez besoin de programmes externes tels que un xine_dvd_plugin qui peut controler
    l'authentification/dcryptage.

    L'quipe du projet Xine dnigre 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 varis, ainsi que des
    nouveaux priphriques de sortie pourront tre supports dans le futur.

2.1 Plate-formes supports et pr-requis

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

    - Xine peut dtecter et utiliser les extensions 'MIT X video' et la mmoire partage 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 possdez une carte vido Matrox G200/G400/G450, vous pouvez optionnellement utiliser
      le driver de sortie vido sybcfb/teletux. Reportez vous au fichier README.syncfb pour les dtails.
   
    - Pour la lecture audio, OSS, ALSA, ESD, ARTSD son supports.
    - aaxine utilises aalib pour la sortie vido, et peut tre lanc sur presque tout les terminaux.
    - Pour compiler Xine, des versions de make, gcc et binutils assez rcentes sont requises.
      
    Xine devrait fonctionner sur n'importe quel compatible PC rcent (Pentium et plus) utilisant GNU/Linux ou FreeBSD.
    Dpendant 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
    systme Pentium II 400 (ou quivalent). Il y a plusieurs facteurs dans l'quation, votre rsultat peut donc varier.

    Les cartes vido testes avec succs (utilisant Xv) pour les PCs sont :
    nVidia Riva TNT (Drivers nvidia protgs), nVidia Riva TNT 2, Matrox G400,
    ATI AIW Rage 128-16 MB, 3dfx Voodoo 3 2000 PCI 16 MB
    
    Les cartes suivantes ont ts rapportes 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 vido 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 supports : certains systmes bass sur le powerpc (sous Linux),
    et IRIX sur les MIPS.

    Et le dernier mais non le moindre, Xine est galement rapport comme fonctionnant sur Alplha, IA-64 et S/390.
    
2.2 Logiciel utiliss

    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 ides originelles pour le lecteur
    vido Xine.

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

2.3 Les dveloppeurs 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, dtection du taux dchantillonage, dsentrelacement logiciel,
    mises  jour massives de libwin32

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

    Routine de sortie vido teletux/syncfb, corrections de bugs/tests varis, Alsa

      Joachim Koenig <Joachim.Koenig@gmx.net>

    Dveloppement 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 farie fonctionner Xine sans paramtre de ligne de commande, ou vous pouvez spcifier, un ou plus, flux d'entre
    directement. Xine tentera de dtecter si il peut utiliser l'extension Xv, ou retourner  XShm, mais cette dtection peut chouer.
    Vous pouvez spcifier la sortie vido en utilisant l'option "-V", par exemple :
    
     xine -V XShm

    forcera Xine  utiliser XShm ou seulement X11.

    Si vous voulez envoyer le son su un rseau avec ESD, placer la variable ESPEAKER avant de dmarrer Xine.

    Le flux d'entre peut tre un nom de fichier ou quelque chose que nous appelons "MediaResourceLocator" (ou MRL), qui ressemlble 
    une URL. Tout d'abord, vous spcifiez une source suivie de "://" et un identificateur spcifique de source d'entre. Les sources utilisables
    dpendent des plugins d'entre possds (pour de simples fichiers, vous pouvez omettre l'identificateur de source d'entre).

    Essayez :

    xine --help

    pour obtenir une information plus complte 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 dplacer des fichiers vido dans Xine pour lecture.

    Lecture de la piste 3 d'un VCD :

     xine vcd://3

    Exemple pour un accs 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 dbut du flux courant
      1-9             Cherche 10-90 % du flux courant
      [Gauche]/[Droite]  Cherche +/- 15 sec(+CTRL : 60 sec)
      [PgUp]/[Prcedent]  Saut  l'entre de playlist prcdente
      [PgDown]/[Suivant] Saut  l'entre 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 vido
      		      ajouter CTRL pour zoomer horizontalement ou meta pour zoomer verticalement

      "<", ">"        Modification de la taille de la sortie vido
      + -             Changement du canal audio
      , .             Changement du canal de sous-titrage
      n m             Ajustement de la synchronisation audio/vido
      [HOME]          Remise  zro de la synchro audio/vido

      [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 rpertoire $HOME. La syntaxe d'entre d'un raccourci est :

         WindowReduce {
            key = less
            modifier = none
         }

        La touche doit correspondre avec les codes de touche X11. Le modificateur 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 mixs, spars par des virgules :

         WindowReduce {
           key = less
           modifier = control, alt
         }

        Si vous ne spcifiez pas de ligne de modificateur, alors ce dernier est quivalent  'none'.

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

        Ce qui signifie que vous avez ajout un autre raccourci  l'entre 'Pause', en appuuyant sur 'p', 
        vous pouvez galement ajouter une section modificateur (voir ci-dessus). Si vous ne le spcifiez pas,
        le modificateur sera le mme que dans la section originale ('Pause' dans le cas prsent).

      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.
        Dmarrez 'xev' d'un terminal (comme 'xterm'), donnez la main  la petite fentre affiche, et appuyez sur la touche que vous dsirez spcifier.
      
        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 crs :
        Vous pouvez utiliser 'xine --keymap' ou 'xine --keymap=default' pour afficher les raccourcis par dfaut.
        Vous pouvez rediriger les rsultats vers un fichier, qui peut devenir un .xine_keymap.

        Pour voir les rsultats du remappage, utiliser simplement 'xine --keymap=remapped'

2.4.2 Slection des canaux audio

      Ajouter l'option -a pour slectionner la piste audio dsire :

       xine -a 3 test.mpg

      Lit la troisime piste audio disponible (et la vido, bien sur).

      L'interface utilisateur permet galement pour slectionner une piste audio.

2.4.3 Selection des sous-titres

      Les sous-titres sont stocks dans des pistes diffrentes comme l'audio. En gnral,
      la piste 0 est le sous-titre de la langue par dfaut. Utilisez l'option -u pour slectionner la
      piste de sous-titre dsire : 

       xine -u 0 test.vob

      Affiche le 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 entres 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-gnrer un modle d'entres lirc, en utilisant 'xine --keymap=lirc',
      il est alors possible de rediriger la sortie vers un fichier pour affiner les rglages.
      
      Toute entre ressemblera  a :

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

      C'est  vous de spcifier le nom de la tlcommande, et  assigner le bouton.


3   QUE RESTE T'IL A DIRE ?

3.1 Libert, DVDs et autre choses

    Xine est un logiciel gratuit. "Logiciel gratuit" est relatif au fait d'tre "open-source".
    Cependant, la signification de de "logiciel gratuit" dpasse 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 relle menace  la libert quant on en vient aux DVDs : l'industrie
    cinmatographique fait d'immenses efforts pour restreindre la lecture des DVDs
    dans des machines controlles. La plupart des DVDs actuellement vendus le sont
    de manire propritaire - et dans certains pays (notamment aux USA), il peut tre
    illgal de les dcrypter - mme dans le cadre d'une lecture prive.
    Heureusement une majorit de gens conviendront que c'est une manire
    trs discutable de traiter les consommateurs. L'quipe du projet Xine condamne ces
    efforts de l'industrie du cinma, dans leur essai d'enrayement de la perte de ventes
    par le dmonstration d'un manque de respect vis  vis de tous les clients honntes.
    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
    possder et d'utiliser des logiciels pour la lecture de DVDs encrypts. Mais comme
    c'est un point obscur (qui semble potentiellement trs dangereux), Xine ne contient
    aucun code susceptible de dcrypter les DVDs. Il semble, cependant, que des
    parties tierces travaillent sur de telles extensions. Peut-tre dans des endroits ou il 
    est lgal d'utiliser ces programmes. Quoi qu'il en soit, vous serez incapable de lire
    des DVDs encrypts avec Xine tel-quel. Merci de noter que ce n'est ni un bug, ni 
    une fonctionnalit manquante, mais bien un problme lgal original. Il serait 
    bienvenue de rsoudre le problme (par exemple en convaincant l'Amrique et/ou 
    l'industrie cinmatographique qu'ils sont vraiment gnants et injustes envers les clients,
    aussi bien qu'envers les utilisateurs et les dveloppeurs de logiciels libres, mais l'inclusion
    du code de dcryptage de DVDs dans Xine ne rsoudra pas le problme.


4   Contacter le projet Xine

    Le site web du projet Xine est :

     => http://xine.sourceforge.net

    Les retours ou offres d'aide sont grandement apprcis, merci de contacter :

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

