annotate DOCS/xml/fr/install.xml @ 22323:db082b1a4e77

cosmetics: reindented

<?xml version="1.0" encoding="utf-8"?>
<!-- synced with r21154 -->

<chapter id="install">
<title>Installation</title>

<para>
Un guide d'installation rapide peut être trouvé dans le fichier <filename>README</filename>.
Veuillez le lire d'abord et revenir ensuite ici pour le reste des détails.
</para>

<para>
Dans ce chapitre je vous serez guidé à travers étapes de configuration et de
compilation de <application>MPlayer</application>.
Ce n'est pas facile, mais pas vraiment difficile non plus.
Si vous observez un comportement différent de celui de ces explications,
cherchez dans la doc et vous trouverez les réponses adéquates.
</para>

<para>
Vous aurez besoin d'un système relativement récent. Sous Linux, les noyaux 2.4.x sont
recommandés.
</para>


<sect1 id="softreq">
<title>Logiciels nécessaires</title>

<itemizedlist>
<listitem><para>
  <emphasis role="bold">binutils</emphasis> - la version conseillée est la <emphasis role="bold">2.11.x</emphasis> ou plus récente.
</para></listitem>
<listitem><para>
  <emphasis role="bold">gcc</emphasis> - les versions conseillées sont les
  versions 2.95 et 3.4 ou plus récentes.
  Les versions 2.96 et 3.0.x sont connues pour générer du code incorrect.
  Des problèmes existent avec les versions 3.1 et 3.2.
  Sur les plateformes PowerPC, utilisez GCC 4.x.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">XFree86</emphasis> - la version conseillée est 4.3 ou
  plus récente.
  Assurez-vous que ses <emphasis role="bold">paquets de développement</emphasis>
  sont également installés, sinon cela ne fonctionnera pas.
  Si vous n'avez pas besoin de X, certains pilotes de sortie vidéo fonctionnent
  aussi sans.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">make</emphasis> - version conseillée 3.79.x ou plus
  récente.
  Pour contruire la documentation XML, vous devez utiliser au moins la version 3.80.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">FreeType</emphasis> - version 2.0.9 ou supérieure requise pour l'affichage des
  sous-titres et du OSD (On Screen Display).
  </para></listitem>  
<listitem><para>
  <emphasis role="bold">libjpeg</emphasis> - décodeur JPEG optionnel, utilisé
    par l'option <option>-mf</option> et le pilote de sortie vidéo JPEG.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">libpng</emphasis> - Décodeur (M)PNG optionnel,
  requis pour l'interface graphique et le pilote de sortie vidéo PNG.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">lame</emphasis> - version 3.90 ou plus récente est
  recommandé, requis pour l'encodage MP3 audio avec
  <application>MEncoder</application>.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">zlib</emphasis> - recommandé, nécessaire pour les
  entêtes MOV compressées et le support PNG.
  </para></listitem>
<listitem><para>
  <emphasis role="bold"><ulink url="http://www.live555.com/mplayer/">LIVE555 Streaming Media</ulink></emphasis>
  - optionnel, requis pour lire certains flux RTSP/RTP.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">directfb</emphasis> - optionnel, utilisez la version
  0.9.13 ou plus récente.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">cdparanoia</emphasis> - optionnel, pour le support CDDA
  </para></listitem>
<listitem><para>
  <emphasis role="bold">libxmms</emphasis> - optionnel, pour le support des plugins
  d'entrée de XMMS. Une version supérieure ou égale à 1.2.7 est requise.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">libsmb</emphasis> - optionnel, pour le support réseau smb.
  </para></listitem>
<listitem><para>
  <emphasis role="bold">ALSA</emphasis> - optionnel, pour le support de sortie audio ALSA.
  La version 0.9.0rc4 est le minimal requis.
  </para></listitem>
</itemizedlist>
</sect1>


<sect1 id="features">
<title>Fonctionalités</title>

<itemizedlist>
<listitem><para>
  Si vous souhaitez une interface graphique (GUI), lisez la section <link linkend="gui">GUI</link> avant de compiler.
  </para></listitem>
<listitem><para>
  Si vous voulez installer <application>MEncoder</application> (notre excellent
  encodeur multi-usages), voir la section <link linkend="mencoder"><application>MEncoder</application></link>.
  </para></listitem>
<listitem><para>
  Si vous possédez une carte <emphasis role="bold">tuner TV</emphasis> compatible
  V4L, et désirez voir/enregistrer et encoder des films avec <application>MPlayer</application>, voyez la section
  <link linkend="tv-input">Entrée TV</link>.
  </para></listitem>
<listitem><para>
  Si vous possédez un carte <emphasis role="bold">tuner radio</emphasis> compatible
  V4L, et désirez écouter et capturer du son avec <application>MPlayer</application>,
  lisez la rubrique <link linkend="radio">Entrée Radio</link>.
  </para></listitem>  
<listitem><para>
  Il y a un élégant <emphasis role="bold">Menu OSD</emphasis> prêt à être utilisé.
  Regardez la section <link linkend="osdmenu">menu OSD</link>.
  </para></listitem>
</itemizedlist>

<para>
Ensuite compilez <application>MPlayer</application>:
<screen>
./configure
make
make install</screen>
</para>

<para>
A ce point, <application>MPlayer</application> est prêt à fonctionner.
Le répertoire <filename class="directory">$PREFIX/share/mplayer</filename>
contient le fichier <filename>codecs.conf</filename>, qui est utilisé pour
donner au programme la liste des codecs et de leurs capacités. Ce fichier n'est requis
que si vous voulez changer ses propriétés, car le binaire principal en contient une
copie interne. Vérifiez si vous avez un <filename>codecs.conf</filename> dans votre
répertoire personnel (<filename>~/.mplayer/codecs.conf</filename>) provenant d'une
ancienne installation de <application>MPlayer</application>, et supprimez-le.
</para>

<para>
Notez que si vous avez un <filename>codecs.conf</filename> dans
<filename>~/.mplayer/</filename>, les fichiers <filename>codecs.conf</filename>
du système ou celui intégré seront complètement ignorés.
Ne faites pas cela à moins de vouloir jouer avec le fonctionnement interne de
<application>MPlayer</application> car cela peut poser des problèmes. Si vous voulez changer l'ordre de
recherche des codecs, utilisez les options <option>-vc</option>, <option>-ac</option>,
<option>-vfm</option>, ou <option>-afm</option> soit en ligne de commande soit dans
votre fichier de config (voir la page de man).
</para>

<para>
Les utilisateurs Debian peuvent construire un paquet .deb pour leur propre usage,
c'est très simple. Exécutez
<screen>fakeroot debian/rules binary</screen>
dans le répertoire racine de <application>MPlayer</application>. Voir
<link linkend="debian">Création de paquets Debian</link> pour de plus amples
instructions.
</para>

<para>
<emphasis role="bold">Regardez toujours le listing généré par</emphasis>
<filename>./configure</filename>, ainsi que le fichier
<filename>configure.log</filename>, ils contiennent des informations sur
ce qui sera compilé, et ce qui ne le sera pas. Vous pouvez également consulter
les fichiers <filename>config.h</filename> et <filename>config.mak</filename>.
Si vous avez quelques librairies installées, mais pas détectées par
<filename>./configure</filename>, alors vérifiez que vous avez les fichiers
d'en-tête (généralement les paquets -dev) et que leur version correspond. Le fichier
<filename>configure.log</filename> vous dit généralement ce qui manque.
</para>

<para>
Bien que n'étant pas indispensables, les polices peuvent être installées pour
l'affichage de l'OSD, et le support des sous-titres. La méthode recommandée est
d'installer un fichier de police TTF et de dire à <application>MPlayer</application> de l'utiliser. Voir la
section <link linkend="osdmenu">Sous-titres et OSD</link> pour les détails.
</para>

</sect1>

<!-- ********** -->

<sect1 id="gui">
<title>À propos de l'interface graphique</title>

<para>
La GUI à besoin de GTK 1.2.x ou GTK 2.0 (elle n'est pas entièrement basée dessus, mais les
menus le sont). Les skins sont stockées au format PNG, donc GTK,
<systemitem class="library">libpng</systemitem> (ainsi que leurs paquets de dev,
généralement nommés <systemitem class="library">gtk-dev</systemitem> et <systemitem class="library">libpng-dev</systemitem>)
doivent être installés. Vous pouver la compiler en spécifiant l'option
<option>--enable-gui</option> durant l'étape
<filename>./configure</filename>. Ensuite, pour l'activer vous devrez exécuter
le binaire <command>gmplayer</command>.
</para>

<para>
<application>MPlayer</application> n'ayant pas de skin par défaut, vous
devrez la télécharger si vous voulez utiliser la GUI. Voir la <ulink url="http://www.mplayerhq.hu/dload.html">page des téléchargements</ulink>.
Elles pourront se placer dans le répertoire commun 
(<filename class="directory">$PREFIX/share/mplayer/skins</filename>),
 ou dans <filename class="directory">
$HOME/.mplayer/skins</filename>.
Par défaut, <application>MPlayer</application> consulte ces répertoires à la
recherche d'un répertoire nommé <filename class="directory">default</filename>,
mais vous pouvez utiliser l'option <option>-skin <replaceable>nouvelleskin</replaceable></option>,
ou placer <literal>skin=nouvelleskin</literal> dans votre fichier de configuration
pour utiliser la skin dans le répertoire <filename class="directory">*/skins/newskin</filename>.
</para>
</sect1>

<!-- ********** -->


<sect1 id="fonts-osd">
<title>Polices et OSD</title>

<para>
Vous devez spécifier à <application>MPlayer</application> quelles polices utiliser
pour l'OSD et les sous-titres. N'importe quelle police TrueType ou Bitmap devrait
faire l'affaire. Cependant, les polices TrueType sont recommandés car elles ont
un bien meilleur aspect, peuvent être mises à l'échelle correctement et gèrent mieux
les différents jeux de caractères.
</para>


<sect2 id="truetype-fonts">
<title>Police TrueType</title>

<para>
Il y a deux façons de rendre les polices TrueType opérationnelles. La première
est de spécifier le nom du fichier de la police TrueType à utiliser grâce à l'option 
<option>-font</option>. Il peut être interessant de placer
cette option dans votre fichier de configuration (voir la page de manuel pour plus de détails).
La seconde façon est de créer un symlink baptisé <filename>subfont.ttf</filename> pointant vers le fichier
contenant la police de votre choix. Pour choisir une police commune à tous les utilisateurs, tapez 
<screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf</screen>
Pour définir une police propre à chaque utilisateur, tapez
<screen>ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf</screen>
</para>

<para>
La compilation de <application>MPlayer</application> avec le support pour
<systemitem class="library">fontconfig</systemitem> rend les méthodes ci-dessus inopérantes.
En effet, <application>MPlayer</application> s'attend à ce que <option>-font</option> soit
suivi d'un nom de police compatible avec <systemitem class="library">fontconfig</systemitem>.
Un exemple:
<screen>mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable></screen>
</para>

<para>
Pour obtenir la liste des polices compatibles avec <systemitem class="library">fontconfig</systemitem>, 
executez <command>fc-list</command> dans la console.
</para>
</sect2>

<sect2 id="bitmap-fonts">
<title>Polices Bitmap</title>

<para>
Si pour une raison quelconque vous souhaitez ou devez employer des polices bitmap, téléchargez en un jeu
depuis notre page web. Vous avez les choix entre différentes 
<ulink url="http://www.mplayerhq.hu/MPlayer/releases/fonts/">polices ISO</ulink> et quelques autres 
<ulink url="http://www.mplayerhq.hu/MPlayer/contrib/fonts/">polices développées par des utilisateurs</ulink>
supportant plusieurs encodages.
</para>

<para>
Décompressez le fichier que vous avez téléchargé dans le répertoire
<filename class="directory">~/.mplayer</filename> ou dans
<filename class="directory">$PREFIX/share/mplayer</filename>.
Ensuite, renommez ou symlinkez l'un des répertoire ainsi créé vers
le sous-repertoire 
<filename class="directory">font</filename>. Exemple:
<screen>ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font</screen>
<screen>ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font</screen>
</para>

<para>
Les polices doivent disposer d'un fichier <filename>font.desc</filename>
associant les positions des caractères unicode à l'encodage (NdT: code page) utilisé par le sous-titre.
Une autre solution est d'encoder les sous-titres en UTF-8 et
d'utiliser l'option <option>-utf8</option> ou de donner au fichier sous-titre
le même nom qu'au fichier video avec une extension <filename>.utf</filename> et de le placer
dans le même répertoire que la vidéo.
</para>
</sect2>



<sect2 id="osdmenu">
<title>Menu OSD</title>

<para>
<application>MPlayer</application> possède une interface de menu OSD complètement modulable.
</para>

<note><para>
Le menu des préférences n'est PAS IMPLÉMENTÉ pour l'instant!
</para></note>

<orderedlist>
<title>Installation</title>
<listitem><para>
  compilez <application>MPlayer</application> en passant le paramètre <option>--enable-menu</option>
  à <filename>./configure</filename>
  </para></listitem>
<listitem><para>
  assurez-vous que les polices OSD sont installées
  </para></listitem>
<listitem><para>
  copiez <filename>etc/menu.conf</filename> dans votre répertoire
  <filename class="directory">.mplayer</filename>
  </para></listitem>
<listitem><para>
  copiez <filename>etc/input.conf</filename> dans votre répertoire
  <filename class="directory">.mplayer</filename>, ou dans le fichier de config globale de
  <application>MPlayer</application> (par défaut: <filename class="directory">/usr/local/etc/mplayer</filename>)
  </para></listitem>
<listitem><para>
  trouvez et éditez <filename>input.conf</filename> pour activer les touches
  correspondants aux mouvements dans le menu (c'est décrit sur place).
  </para></listitem>
<listitem><para>
  lancez <application>MPlayer</application> avec par exemple:
  <screen>$ mplayer -menu <replaceable>fichier.avi</replaceable></screen>
  </para></listitem>
<listitem><para>
  pressez n'importe laquelle des touches menu que vous avez défini
  </para></listitem>
</orderedlist>

</sect2>
</sect1>

<!-- ********** -->


<sect1 id="rtc">
<title>RTC</title>
<para>
Il y a trois méthodes de synchro dans <application>MPlayer</application>.

<itemizedlist>
<listitem><para>
<emphasis role="bold">Pour utiliser l'ancienne méthode</emphasis>, vous n'avez
rien à faire. Elle utilise <systemitem>usleep()</systemitem> pour régler la
synchro A/V, avec une précision de +/- 10ms. Cependant parfois la synchro doit être
réglé encore plus finement.
  </para></listitem>
<listitem><para>
<emphasis role="bold">Le nouveau code de synchro</emphasis> utilise la RTC
(Real Time Clock) du PC pour cette tâche, car elle à des timers précis à 1ms près.
Utilisez l'option <option>-rtc</option> pour l'activer. Notez d'un noyau correctement
configuré est requis. Si vous executez une version du noyau supérieure ou égale à 2.4.19pre8,
vous pouvez ajuster la fréquence maximale (de la RTC) accessible aux utilisateurs normaux grace au système
de fichiers  <systemitem class="systemname">/proc </systemitem>. Pour ceci, les commandes suivantes sont à
votre disposition:
<screen>echo 1024 &gt; /proc/sys/dev/rtc/max-user-freq</screen>
ou  <screen>sysctl dev/rtc/max-user-freq=1024</screen>
Vous pouvez rendre ce réglagle permanant en ajoutant la seconde commande au fichier 
<filename>/etc/sysctl.conf</filename>.
</para>

<para>
   Vous pouvez voir l'efficacité du nouveau timer sur la ligne d'état.
	Les fonctions de gestion de l'énergie des BIOS des certains portables
	avec des processeurs supportant SpeedStep ne font pas bon ménage avec la RTC.
	Le son et les images risquent d'être désynchronisés. Brancher le portable sur
	le secteur avant de le démarrer semble régler le problème dans la plupart des cas.
	Avec certaines combinaisons de matériels (particulièrement: lecteurs DVD ne supportant pas
	le DMA et cartes-mère basé sur le chipset ALi1541), l'utilisation du timer RTC rend la lecture
	irrégulière (NdT: skippy).
  </para></listitem>
<listitem><para>
  <emphasis role="bold">La troisième méthode de synchro</emphasis> est activée par l'option
  <option>-softsleep</option>. Il à la précision de la RTC, mais n'utilise pas la RTC.
  D'un autre côté, il nécessite plus de CPU.
  </para></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>