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


  VERSION
    => $Id: README_fr,v 1.2 2002/08/04 14:00:25 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 libre, 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 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. En fonction 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. Malheureu-
    sement, 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 supportes 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 Alpha, 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 d'chantillo-
    nage, 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 faire 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 sur 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 ressemble  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 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 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, tels que :
	 
	 Alias {
           entry = Pause
           key = p
         }

        Ce qui signifie que vous avez ajout un autre raccourci  l'entre
        'Pause', en appuyant sur 'p', vous pouvez galement ajouter une section
        modificateur (voir ci-dessus). Si vous ne le spcifiez pas, le modifi-
        cateur 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-titrage dsire : 

       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 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 libre. "Logiciel libre" est relatif au fait d'tre 
    "open-source".
    Cependant, la signification de "logiciel libre" 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>

