view DOCS/xml/fr/audio.xml @ 13077:3a486d15217f

minor fixes
author wight
date Sat, 21 Aug 2004 22:47:00 +0000 (2004-08-21)
parents 52ff326f1ac9
children 7b764c9e2959
line wrap: on
line source
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- synced with 1.12 -->
<sect2 id="audio-dev">
<title>P�riph�riques de sortie audio</title>
<sect3 id="sync">
<title>Synchronisation audio/vid�o</title>

<para>
L'interface audio de <application>MPlayer</application> se nomme
<emphasis>libao2</emphasis>. Elle poss�de actuellement ces pilotes:
</para>

<informaltable>
<tgroup cols="2">
<thead>
  <row><entry>Pilote</entry><entry>Commentaire</entry></row>
</thead>
<tbody>
<row><entry>oss</entry><entry>
  pilote OSS (ioctl) (supporte le transfert AC3 mat�riel)
  </entry></row>
<row><entry>sdl</entry><entry>
  pilote SDL (supporte les d�mons de son comme <emphasis role="bold">ESD</emphasis>
  et <emphasis role="bold">ARTS</emphasis>)
  </entry></row>
<row><entry>nas</entry><entry>
  pilote NAS (Network Audio System)
  </entry></row>
<row><entry>alsa5</entry><entry>
  pilote ALSA 0.5 natif
  </entry></row>
<row><entry>alsa9</entry><entry>
  pilote ALSA 0.9 natif (supporte le transfert AC3 mat�riel)
  </entry></row>
<row><entry>sun</entry><entry>
   pilote audio SUN (<filename>/dev/audio</filename>) pour les utilisateurs de BSD et Solaris8
  </entry></row>
<row><entry>macosx</entry><entry>
  pilote MacOS X natif
  </entry></row>
<row><entry>win32</entry><entry>
  pilote Win32 natif
  </entry></row>
<row><entry>arts</entry><entry>
  pilote ARTS natif (principalement pour les utilisateurs KDE)
  </entry></row>
<row><entry>esd</entry><entry>
  pilote ESD natif (principalement pour les utilisateurs GNOME)
  </entry></row>
</tbody>
</tgroup>
</informaltable>

<para>
Les pilotes Linux des cartes son ont des probl�mes d'incompatibilit�. C'est pourquoi
<application>MPlayer</application> utilise une fonction des pilotes �crits
<emphasis>correctement</emphasis> pour maintenir une synchro audio/vid�o correcte.
Malheureusement, certains auteurs de pilotes n'ont que faire de cette fonction: elle
n'est pas requise pour jouer des MP3 ou des effets sonores.
</para>

<para>
D'autres lecteurs multim�dia comme <ulink url="http://avifile.sourceforge.net">aviplay</ulink>
ou <ulink url="http://xine.sourceforge.net">xine</ulink> fonctionnent probablement
autrement avec ces pilotes parce qu'ils utilisent des m�thodes "simples" pour leur
synchro interne. Le temps affich�s avec leurs m�thodes n'est pas aussi pr�cis que celui
de <application>MPlayer</application>.
</para>

<para>
Utiliser <application>MPlayer</application> avec un pilote correctement �crit ne
provoquera pas de d�synchro A/V relatives � l'audio, � part avec les fichiers tr�s mal
cr蜑s (voir la page de man pour les solutions).
</para>

<para>
Si vous avez un mauvais pilote audio, essayez l'option <option>-autosync</option>, il
devrait r�gler vos probl�mes. Voir la page de man pour les informations d�taill�es.
</para>

<itemizedlist>
<title>Quelques notes:</title>
<listitem><para>
  Si vous avez un pilote OSS, essayez d'abord avec l'option <option>-ao oss</option>
  (utilis� par d�faut). Si vous obtenez des scratchs ou une sonorit� anormale, essayez
  l'option <option>-ao sdl</option> (NOTE: vous devez bien s�r avoir install� les
  librairies SDL ainsi que leurs fichiers d'ent�te). Le pilote audio SDL est plus
  efficace dans de nombreux cas et supporte �galement ESD (GNOME) et ARTS (KDE).
  </para></listitem>
<listitem><para>
  Si vous avez ALSA version 0.5, vous devrez presque toujours utiliser l'option
  <option>-ao alsa5</option>, la version 0.5 �mulant mal l'OSS, qui
  <emphasis role="bold">plante <application>MPlayer</application></emphasis>
  avec un message du type:
  <screen>
DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!<!--
--></screen>
  </para></listitem>
<listitem><para>
  Sur Solaris, utilisez le pilote audio SUN avec l'option <option>-ao sun</option>,
  sinon ni la vid�o ni le son ne fonctionneront.
  </para></listitem>
<listitem><para>
  Si le son �met des cliqu�tements lors d'une lecture depuis le CD-ROM, activez l'IRQ
  unmasking, ex. <command>hdparm -u1 /dev/cdrom</command> (<command>man hdparm</command>).
  Ceci est g�n�ralement b�n�fique et d�crit plus en d�tail dans la section
  <link linkend="drives">CD-ROM</link>.
 </para></listitem>
</itemizedlist>
</sect3>

<sect3 id="experiences">
<title>Probl�mes de cartes son, recommandations</title>
<para>
Sous Linux, utilisez le noyau 2.4 si possible, le 2.2 n'a pas �t� test�.
</para>

<para>
Les pilotes son de Linux sont surtout fournis par la version libre d'OSS. Ces pilotes
ont �t� repris par <ulink url="http://www.alsa-project.org">ALSA</ulink> (Advanced
Linux Sound Architecture) dans la s�rie de d�veloppement 2.5. Si votre distribution
n'utilise pas d�j� ALSA vous pourriez souhaiter essayer leurs pilotes si vous avez des
probl�mes de son. Les pilotes ALSA sont g�n�ralement sup�rieurs � OSS en compatibilit�,
performances et fonctionnalit�s. Mais certaines cartes ne sont support�es que par les
pilotes OSS commerciaux de <ulink url="http://www.opensound.com/">4Front Technologies</ulink>.
Ils supportent �galement de nombreux syst�mes non-Linux.
</para>

<informaltable>
<tgroup cols="8">
  <colspec colname="c1"/>
  <colspec colname="c2"/>
  <colspec colname="c3"/>
  <colspec colname="c4"/>
  <colspec colname="c5"/>
  <colspec colname="c6"/>
  <colspec colname="c7"/>
  <colspec colname="c8"/>
  <spanspec spanname="driver" namest="c2" nameend="c5"/>
  <spanspec spanname="ossfree" namest="c2" nameend="c2"/>
  <spanspec spanname="alsa" namest="c3" nameend="c3"/>
  <spanspec spanname="osspro" namest="c4" nameend="c4"/>
  <spanspec spanname="others" namest="c5" nameend="c5"/>
<thead>
  <row>
    <entry morerows="2" valign="middle">CARTE SON</entry>
    <entry spanname="driver">PILOTE</entry>
    <entry morerows="2" valign="middle">kHz Max</entry>
    <entry morerows="2" valign="middle">Canaux Max</entry>
    <entry morerows="2" valign="middle">Max Ouverts
      <footnote id="maxopens">
        <para>nombre d'applications pouvant utiliser le p�riph�rique
        <emphasis>en m�me temps</emphasis>.</para>
      </footnote>
    </entry>
  </row>

  <row>
    <entry spanname="ossfree">OSS/Libre</entry>
    <entry spanname="alsa">ALSA</entry>
    <entry spanname="osspro">OSS/Pro</entry>
    <entry spanname="others">autres</entry>
  </row>
</thead>

<tbody>
  <row>
    <entry>VIA onboard (686/A/B, 8233, 8235)</entry>
    <entry>
      <ulink url="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">via82cxxx_audio</ulink>
    </entry>
    <entry>snd-via82xx</entry>
    <entry></entry>
    <entry></entry>
    <entry>4-48 kHz ou 48 kHz uniquement, selon le chipset</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Aureal Vortex 2</entry>
    <entry>aucun</entry>
    <entry>aucun</entry>
    <entry>OK</entry>
    <entry>
      <ulink url="http://aureal.sourceforge.net">Pilotes Linux Aureal</ulink>
      <ulink url="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">taille du tampon port�e � 32k</ulink>
    </entry>
    <entry>48</entry>
    <entry>4.1</entry>
    <entry>5+</entry>
  </row>

  <row>
    <entry>SB Live!</entry>
    <entry>Analogique OK, SP/DIF non fonctionnel</entry>
    <entry>Tous deux OK</entry>
    <entry>Tous deux OK</entry>
    <entry>
      <ulink url="http://opensource.creative.com">Pilote OSS de Creative (support SP/DIF)</ulink>
    </entry>
    <entry>192</entry>
    <entry>4.0/5.1</entry>
    <entry>32</entry>
  </row>

  <row>
    <entry>SB 128 PCI (es1371)</entry>
    <entry>OK</entry>
    <entry>?</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry>st�r�o</entry>
    <entry>2</entry>
  </row>

  <row>
    <entry>SB AWE 64</entry>
    <entry>max 44kHz</entry>
    <entry>48kHz mauvaise qualit�</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>GUS PnP</entry>
    <entry>aucun</entry>
    <entry>OK</entry>
    <entry>OK</entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Gravis UltraSound ACE</entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Gravis UltraSound MAX</entry>
    <entry>OK</entry>
    <entry>OK (?)</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>ESS 688</entry>
    <entry>OK</entry>
    <entry>OK (?)</entry>
    <entry></entry>
    <entry></entry>
    <entry>48</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Cartes C-Media (CMI8338/8738)</entry>
    <entry>OK</entry>
    <entry>OK, SP/DIF est support� par ALSA 0.9.x</entry>
    <entry>?</entry>
    <entry></entry>
    <entry>44</entry>
    <entry>st�r�o</entry>
    <entry>1</entry>
  </row>

  <row>
    <entry>Cartes Yamaha (*ymf*)</entry>
    <entry>pas OK (?) (peut-�tre <option>-ao sdl</option>)</entry>
    <entry>OK uniquement via ALSA 0.5 avec �mulation OSS
      <emphasis role="bold">ET</emphasis> <option>-ao sdl</option> (!) (?)</entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>Cartes avec chips envy24 (comme la Terratec EWS88MT)</entry>
    <entry>?</entry>
    <entry>?</entry>
    <entry>OK</entry>
    <entry></entry>
    <entry>?</entry>
    <entry></entry>
    <entry></entry>
  </row>

  <row>
    <entry>PC Speaker ou DAC</entry>
    <entry>OK</entry>
    <entry>aucun</entry>
    <entry></entry>
    <entry>
      <ulink url="http://www.geocities.com/stssppnn/pcsp.html">Pilote PC speaker OSS Linux</ulink>
    </entry>
    <entry>Ce pilote �mule 44.1, peut-�tre plus.</entry>
    <entry>mono</entry>
    <entry>1</entry>
  </row>

</tbody>
</tgroup>
</informaltable>

<para>
Les retours sur ce document sont les bienvenus. Merci de nous faire savoir comment
<application>MPlayer</application> et votre(vos) carte(s) son ont fonctionn� ensemble.
</para>
</sect3>

<sect3 id="af">
<title>Filtres Audio</title>
<para>
  Les anciens plugins audio ont �t� remplac�s par une nouvelle couche de filtres audio.
  Les filtres audio sont utilis�s pour changer les propri�t�s des donn�es audio avant
  que le son n'atteigne la carte son. L'activation et la d�sactivation sont normalement
  automatis�s mais peuvent �tre outrepass�s. Les filtres sont activ�s quand les
  propri�t�s des donn�es audio diff�rent de celles requises par la carte son et
  d�sactiv�s si n�cessaire. L'option  <option>-af filtre1,filtre2,...</option> est
  utilis�e pour outrepasser l'activation automatique des filtres ou pour ins�rer des
  filtres qui ne le sont pas automatiquement. Les filtres seront ex�cut�s dans l'ordre
  o� ils apparaissent dans la liste s�par�e par des virgules.
</para>

<para>
Exemple:
<screen>mplayer -af resample,pan <replaceable>film.avi</replaceable></screen>
ferait passer le son au travers du filtre de resampling suivi du filtre panoramique.
Remarquez que la liste ne doit contenir aucun espace, sinon cela �chouera.
</para>

<para>
Les filtres ont souvent des options changeant leur comportement. Ces options sont
expliqu�es en d�tail dans les sections ci-dessous. Un filtre sera ex�cut� en utilisant
ses param�tres par d�faut si ses options sont omises. Voici un exemple de comment
utiliser les filtres en conjonction avec des options sp�cifiques � un filtre:
<screen>mplayer -af resample=11025,pan=1:0.5:0.5 -channels 1 -srate 11025 <replaceable>media.avi</replaceable></screen>
d�finirait la fr�quence de sortie du filtre resample � 11025Hz et downmixerait l'audio
dans 1 canal en utilisant le filtre pan.
</para>


<para>
Le fonctionnement g�n�ral de la couche filtre est contr�l� en utilisant l'option
<option>-af-adv</option>. Cette option a deux sous-options:
</para>

<para>
<option>force</option> est un champs de bits qui contr�le comment les filtres sont
ins�r�s et quelles optimisations de vitesse/exactitude ils utilisent:
</para>

<variablelist>
<varlistentry>
<term><option>0</option></term>
<listitem><para>
Utilise l'insertion automatique des filtres et optimise en fonction de la vitesse du CPU.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>1</option></term>
<listitem><para>
Utilise l'insertion automatique des filtres et optimise pour la plus haute vitesse.
<emphasis>Attention:</emphasis> Certaines fonctions des filtres audio pourraient alors
�chouer silencieusement, et la qualit� du son pourrait en souffrir.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>2</option></term>
<listitem><para>
Utilise l'insertion automatique des filtres et optimise pour la qualit�.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>3</option></term>
<listitem><para>
N'utilise pas d'insertion automatique des filtres et n'optimise pas.
<emphasis>Attention:</emphasis> Il pourrait arriver de planter MPlayer en utilisant ce r�glage.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>4</option></term>
<listitem><para>
Utilise l'insertion automatique des filtres comme indiqu� au champ 0, mais fait des
calculs � virgule flottante si possible.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>5</option></term>
<listitem><para>
Utilise l'insertion automatique des filtres comme indiqu� au champ 1, mais fait des
calculs � virgule flottante si possible.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>6</option></term>
<listitem><para>
Utilise l'insertion automatique des filtres comme indiqu� au champ 2, mais fait des
calculs � virgule flottante si possible.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>7</option></term>
<listitem><para>
N'utilise pas d'insertion automatique des filtres comme indiqu� au champ 3, et fait
des calculs � virgule flottante si possible.
</para></listitem>
</varlistentry>
</variablelist>

<para>
<option>list</option> est un alias de l'option -af.
</para>

<para>
La couche filtre est �galement affect�e par les options g�n�riques suivantes:
</para>

<variablelist>
<varlistentry>
<term><option>-v</option></term>
<listitem><para>
Augmente le niveau de verbosit� et fait afficher des messages d'�tat suppl�mentaires �
la plupart des filtres.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-channels</option></term>
<listitem><para>
Cette option d�finie le nombre de canaux de sortie voulus pour votre carte son. Il
affecte �galement le nombre de canaux qui sont d�cod�s � partir des m�dia. Si le m�dium
contient moins de canaux que le nombre demand� le filtre channels (voir plus bas) sera
automatiquement ins�r�. Le routage sera le routage par d�faut pour le filtre channels.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>-srate</option></term>
<listitem><para>
Cette option s�lectionne le taux d'�chantillonage voulu pour votre carte son. Si la
fr�quence d'�chantillonage de votre carte son est diff�rente de celle du m�dium, le
filtre resample (voir plus bas) sera ins�r� dans la couche filtre audio pour compenser
la diff�rence.
</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-format</option></term>
<listitem><para>
Cette option d�fini le format de sample de la couche audio et de la carte son. Si le
format de sample demand� pour votre carte son est diff�rent de celui du m�dium, le
filtre format (voir plus bas) sera ins�r� pour rectifier la diff�rence.
</para></listitem>
</varlistentry>
</variablelist>

<sect4 id="af_resample">
<title>Up/Downsampling</title>

<para>
MPlayer supporte pleinement l'up/down-sampling du son par l'interm�diaire du filtre
<option>resample</option>. Ce filtre peut �tre utilis� si vous avez une carte
son � fr�quence fixe ou si vous avez une vieille carte son qui n'est capable que de
44.1kHz. Ce filtre est automatiquement activ� si cela est n�cessaire, mais il peut �tre
explicitement activ� en ligne de commande. Il a trois options:
</para>

<variablelist>
<varlistentry>
<term><option>srate &lt;8000-192000&gt;</option></term>
<listitem><para>
    est un entier utilis� pour d�finir la fr�quence d'�chantillonage de sortie en Hz.
    L'intervalle valide pour ce param�tre va de 8kHz � 192kHz. Si les fr�quences d'entr�e
    et de sortie sont les m�mes ou si les param�tres sont omis, le filtre est
    automatiquement retir�. Un fr�quence d'�chantillonage haute augmente normalement la
    qualit� audio, surtout utilis� en conjonction avec d'autres filtres.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>sloppy</option></term>
<listitem><para>
    est un param�tre binaire optionnel qui permet � la fr�quence de sortie de diff�rer
    l�g�rement de la fr�quence donn�e par <option>srate</option>. Cette option est utilis�
    au d�marrage si la lecture est extr�mement lente.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>type &lt;0-2&gt;</option></term>
<listitem><para>
    est un entier optionnel compris entre <literal>0</literal> et <literal>2</literal>
    qui s�lectionne quelle m�thode de r�-�chantillonnage utiliser. Ici <literal>0</literal>
    repr�sente l'interpolation lin�aire comme m�thode de r�-�chantillonnage, <literal>1</literal>
    repr�sente un r�-�chantillonnage en utilisant une banque de filtres poly-phase et des
    calculs d'entiers et <literal>2</literal> repr�sente un r�-�chantillonnage en
    utilisant une banque de filtres poly-phase et des calculs � virgule flottante.
    L'interpolation lin�aire est extr�mement rapide, mais souffre d'une pauvre qualit�
    sonore surtout quand elle est utilis�e pour l'up-sampling. La meilleur qualit� est
    donn�e par <literal>2</literal> mais cette m�thode souffre �galement de la plus forte
    charge CPU.
</para></listitem>
</varlistentry>
</variablelist>

<para>Exemple:
<screen>mplayer -af resample=44100:0:0</screen>
fixerait la fr�quence de sortie du filtre resample � 44100Hz en utilisant une �chelle
de fr�quence exacte et l'interpolation lin�aire.
</para>
</sect4>

<sect4 id="af_channels">
<title>Changer le nombre de canaux</title>
<para>
Le filtre <option>channels</option> peut �tre utilis� pour ajouter ou retirer des
canaux, il peut aussi �tre utilis� pour le routage ou la copie de canaux. Il est
automatiquement activ� quand la sortie du filtre audio diff�re de la couche d'entr�e
ou quand il est demand� par un autre filtre. Se filtre se retire si il n'est pas requis.
Le nombre d'option est dynamique:
</para>

<variablelist>
<varlistentry>
<term><option>nch &lt;1-6&gt;</option></term>
<listitem><para>
  est un entier entre <literal>1</literal> et <literal>6</literal> utilis� pour
  d�finir le nombre de canaux de sortie. Cette option est requise, la laisser vide
  provoquera une erreur � l'ex�cution.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>nr &lt;1-6&gt;</option></term>
<listitem><para>
   est un entier entre <literal>1</literal> et <literal>6</literal> utilis� pour
   d�finir le nombre de canaux de sortie. Cette option est optionnelle. Si elle
   est omise, le routage par d�faut est utilis�.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>from1:to1:from2:to2:from3:to3...</option></term>
<listitem><para>
  sont des paires de nombres entre <literal>0</literal> et <literal>5</literal> qui
  d�finissent o� chaque canal est rout�.
</para></listitem>
</varlistentry>
</variablelist>

<para>
  Si seul <option>nch</option> est indiqu� le routage par d�faut est utilis�, il
  fonctionne comme cela: Si le nombre de canaux de sortie est plus grand que le nombre
  de canaux d'entr�e des canaux vides sont ins�r�s (except� le mixage de mono vers
  st�r�o, dans ce cas le canal mono est r�p�t� sur chacun des canaux de sortie). Si le
  nombre de canaux de sortie est plus petit que le nombre de canaux d'entr�e les canaux
  en trop seront tronqu�s.
</para>

<para>
Exemple 1:
<screen>mplayer -af channels=4:4:0:1:1:0:2:2:3:3 <replaceable>media.avi</replaceable></screen>
changerait le nombre de canaux � 4 et d�finirait 4 routes qui �changent le canal 0 et
le canal 1 et laissent les canaux 2 et 3 intacts. Remarquez que si le m�dium qui
contient deux canaux �tait jou� en arri�re, les canaux 2 et 3 contiendraient du silence
mais les 0 et 1 seraient tout de m�me invers�s.
</para>

<para>
Exemple 2:
<screen>mplayer -af channels=6:4:0:0:0:1:0:2:0:3 <replaceable>media.avi</replaceable></screen>
changerait le nombre de canaux � 6 et d�finirait 4 routes copiant le canal 0 dans les
canaux 0 � 3. Les canaux 4 et 5 contiendront du silence.
</para>
</sect4>

<sect4 id="af_format">
<title>Convertisseur de format de sample</title>
<para>
Le filtre <option>format</option> fait la conversion entre les diff�rents formats de
sample. Il est automatiquement activ� si requis par la carte son ou un autre filtre.
</para>

<variablelist>
<varlistentry>
<term><option>bps &lt;number&gt;</option></term>
<listitem><para>
    peut �tre <literal>1</literal>, <literal>2</literal> ou <literal>4</literal> et d�fini
    le nombre d'octets par sample. Cette option est requise, la laisser vide provoquera
    une erreur � l'ex�cution.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>f &lt;format&gt;</option></term>
<listitem><para>
    est une cha�ne texte d�crivant le format de sample. Cette cha�ne est un mix concat�n�
    de: <option>alaw</option>, <option>mulaw</option> ou <option>imaadpcm</option>,
    <option>float</option> ou <option>int</option>, <option>unsigned</option> ou
    <option>signed</option>, <option>le</option> ou <option>be</option> (little ou big
    endian). Cette option est requise, la laisser vide provoquera une erreur � l'ex�cution.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Exemple:
<screen>mplayer -af format=4:float <replaceable>media.avi</replaceable></screen>
initialiserait le format de sortie en donn�es � virgule de 4 octets par sample.
</para>
</sect4>

<sect4 id="af_delay">
<title>Delay</title>
<para>
Le filtre <option>delay</option> d�cale le son vers les haut-parleurs de fa�on a faire
arriver le son dans les diff�rents canaux au m�me moment dans la position d'�coute.
Cela n'est utile que si vous avez plus de 2 haut-parleurs. Ce filtre a une nombre
variable de param�tres:
</para>

<variablelist>
<varlistentry>
<term><option>d1:d2:d3...</option></term>
<listitem><para>
    sont des nombres � virgule repr�sentant les d�calages en ms qui devraient �tre impos�s
    aux diff�rents canaux. Le d�calage minimum est 0ms et le maximum est 1000ms.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Pour calculer le d�calage requis pour chaque canal, faites comme ceci:
</para>

<orderedlist>
<listitem><para>
    Mesurez la distance entre les hauts parleurs et votre position d'�coute (en m�tres)
    ce qui vous donne les distances s1 � s5 (pour un syst�me 5.1). Ce n'est pas la peine
    de le faire pour le caisson de basses (vous n'entendrez pas la diff�rence de toute
    fa�on).
</para></listitem>
<listitem><para>
Soustrayez les distances s1 � s5 � la distance maximum c-a-d.
    s[i] = max(s) - s[i]; i = 1...5
</para></listitem>
<listitem><para>
Les d�calages requis (en ms) sont calcul�s avec
    d[i] = 1000*s[i]/342; i = 1...5
</para></listitem>
</orderedlist>

<para>
Exemple:
<screen>mplayer -af delay=10.5:10.5:0:0:7:0 <replaceable>media.avi</replaceable></screen>
d�calerait les canaux avant gauche et droite de 10.5ms, les deux canaux arri�re et le
caisson de 0ms et le canal central de 7ms.
</para>

</sect4>

<sect4 id="af_volume">
<title>Contr�le de volume logiciel</title>
<para>
Le contr�le de volume logiciel est impl�ment� par le filtre audio <option>volume</option>.
Utilisez ce filtre avec pr�caution car il peut r�duire le signal au niveau de bruit du
son. Dans la plupart des cas il vaut mieux fixer le niveau du son PCM au max, laisser
ce filtre de c�t� et contr�ler le niveau de sortie de vos haut-parleurs avec le
contr�leur de volume principal du mixeur. Au cas o� votre carte son ait un mixeur
num�rique au lieu d'un analogique, et que vous entendez sa distorsion, utilisez le
mixeur MASTER � la place. Si il y a un amplificateur externe connect� � l'ordinateur
(ce qui est presque toujours le cas), le niveau de bruit peut �tre minimis� en ajustant
le niveau ma�tre et le bouton du volume jusqu'� ce que le bruit r�siduel soit parti.
Ce filtre a deux options:
</para>

<variablelist>
<varlistentry>
<term><option>v &lt;-200 - +60&gt;</option></term>
<listitem><para>
    est un nombre � virgule compris entre <literal>-200</literal> et <literal>+60</literal>
    qui repr�sente le niveau du volume en dB. Le niveau par d�faut est 0dB.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>c</option></term>
<listitem><para>
    est un contr�le binaire qui active et d�sactive le soft clipping. Le Soft-Clipping
    peut rendre le son plus fluide si de tr�s gros niveaux de volume de son sont utilis�s.
    Activez cette option si l'intervalle dynamique de vos haut-parleurs est tr�s bas.
    Soyez conscient que cette fonction cr�e une distorsion et ne devrait �tre utilis�
    qu'en dernier recours.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Exemple:
<screen>mplayer -af volume=10.1:0 <replaceable>media.avi</replaceable></screen>
amplifierait le son de 10.1dB et bloque le volume si il est trop haut.
</para>

<para>
Ce filtre a une seconde fonction: Il mesure le niveau maximum du son et l'affiche
quand MPlayer se termine. Cette estimation de volume peut �tre utilis�e pour d�finir
le niveau de son dans MEncoder pour que l'intervalle dynamique maximum soit utilis�.
</para>
</sect4>

<sect4 id="af_equalizer">
<title>�galiseur</title>
<para>
Le filtre <option>equalizer</option> est un �galiseur graphique � 10 bandes, impl�ment�
en utilisant 10 filtres IIR de bande passante. Cela signifie qu'il fonctionne quel que
soit le type d'audio jou�. Les fr�quences centrales pour les 10 bandes sont:
</para>

<informaltable>
<tgroup cols="2">
<thead>
  <row>
    <entry>Band No.</entry><entry>Fr�quence centrale</entry>
  </row>
</thead>
<tbody>
  <row><entry>0</entry><entry>31.25 Hz</entry></row>
  <row><entry>1</entry><entry>62.50 Hz</entry></row>
  <row><entry>2</entry><entry>125.0 Hz</entry></row>
  <row><entry>3</entry><entry>250.0 Hz</entry></row>
  <row><entry>4</entry><entry>500.0 Hz</entry></row>
  <row><entry>5</entry><entry>1.000 kHz</entry></row>
  <row><entry>6</entry><entry>2.000 kHz</entry></row>
  <row><entry>7</entry><entry>4.000 kHz</entry></row>
  <row><entry>8</entry><entry>8.000 kHz</entry></row>
  <row><entry>9</entry><entry>16.00 kHz</entry></row>
</tbody>
</tgroup>
</informaltable>

<para>
Si la fr�quence du son jou� est plus basse que la fr�quence centrale pour une bande de
fr�quence, alors cette bande sera d�sactiv�e. Un bogue connu de ce filtre est que les
caract�ristiques de la plus haute bande ne sont pas compl�tement sym�triques si la
fr�quence du sample est proche de la fr�quence centrale de la bande. Ce probl�me peut
�tre contourn� en up-samplant le son en utilisant le filtre resample avant qu'il
n'atteigne ce filtre.
</para>

<para>
Ce filtre a 10 param�tres:
</para>

<variablelist>
<varlistentry>
<term><option>g1:g2:g3...g10</option></term>
<listitem><para>
sont des nombres � virgule compris entre <literal>-12</literal> et <literal>+12</literal>
repr�sentant le gain en dB pour chaque bande de fr�quence.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Exemple:
<screen>mplayer -af equalizer=11:11:10:5:0:-12:0:5:12:12 <replaceable>media.avi</replaceable></screen>
amplifierait le son sur les fr�quences les plus hautes et les plus basses tout en les
annulant presque compl�tement autour de 1kHz.
</para>
</sect4>

<sect4 id="af_panning">
<title>Filtre panoramique</title>
<para>
Utilisez le filtre <option>pan</option> pour mixer les canaux arbitrairement.
Fondamentalement c'est une combinaison des filtres volume control et channels. Il y a
deux utilisations principales pour ce filtre:
</para>

<orderedlist>
<listitem><para>
Down-mixage de plusieurs canaux vers seulement quelques uns, st�r�o vers mono par exemple.
</para></listitem>
<listitem><para>
Faire varier la &quot;largeur&quot; du haut parleur central dans un syst�me de son surround.
</para></listitem>
</orderedlist>

<para>
Ce filtre est difficile � utiliser, et n�cessitera quelques r�glage avant d'obtenir le
r�sultat souhait�. Le nombre d'options pour ce filtre d�pends du nombre de canaux de sortie:
</para>

<variablelist>
<varlistentry>
<term><option>nch &lt;1-6&gt;</option></term>
<listitem><para>
est un entier compris entre <literal>1</literal> et <literal>6</literal> utilis�
pour d�finir le nombre de canaux de sortie. Cette option est requise, la laisser vide
provoquera une erreur � l'ex�cution.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>l00:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...</option></term>
<listitem><para>
sont des nombres � virgule compris entre <literal>0</literal> et <literal>1</literal>.
<option>l[i][j]</option> d�termine le nombre j de canaux d'entr�e � mixer dans le
nombre i de canaux de sortie.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Exemple 1:
<screen>mplayer -af pan=1:0.5:0.5 -channels 1 <replaceable>media.avi</replaceable></screen>
down-mixerait de st�r�o vers mono.
</para>

<para>
Exemple 2:
<screen>mplayer -af pan=3:1:0:1:0.5:0.5 -channels 3 <replaceable>media.avi</replaceable></screen>
produirait une sortie � trois canaux en laissant les canaux 0 et 1 intacts, et
mixerait les canaux 0 et 1 dans le canal 2 (qui pourrait �tre envoy� � un sub-woofer
par exemple).
</para>
</sect4>

<sect4 id="af_sub">
<title>Sub-woofer</title>
<para>
Le filtre <option>sub</option> ajoute un canal de sub woofer au flux audio. Les donn�es
audio utilis�es pour cr�er le canal sub-woofer sont une moyenne des canaux 0 et 1. Le
fr�quences basses sont ensuite filtr�es par un filtre Butterworth de 4�me ordre avec
une fr�quence de cut-off par d�faut de 60Hz et ajout�es � un canal s�par� du flux
audio. Attention: D�sactivez ce filtre quand vous lisez des DVDs en son Dolby Digital
5.1, sinon ce filtre emp�chera l'envoi du son au sub-woofer. Ce filtre a deux
param�tres:
</para>

<variablelist>
<varlistentry>
<term><option>fc &lt;20-300&gt;</option></term>
<listitem><para>
    est un nombre � virgule optionnel utilis� pour d�finir la fr�quence de cut-off du
    filtre en Hz. L'intervalle valide est de 20Hz � 300Hz. Pour les meilleurs r�sultats
    essayez de fixer la fr�quence de cut-off le plus bas possible. Cela am�liorera la
    st�r�o ou le son surround. La fr�quence de cut-off par d�faut est 60Hz.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>ch &lt;0-5&gt;</option></term>
<listitem><para>
    est un entier optionnel entre <literal>0</literal> et <literal>5</literal> qui
    d�termine le nombre de canaux � ins�rer dans le sous-canal audio. Par d�faut c'est le
    canal num�ro <literal>5</literal>. Notez que le nombre de canaux sera automatiquement
    augment� � <replaceable>ch</replaceable> si n�cessaire.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Exemple:
<screen>mplayer -af sub=100:4 -channels 5 <replaceable>media.avi</replaceable></screen>
ajouterait un canal sub-woofer avec une fr�quence de cut-off de 100Hz au canal de sortie 4.
</para>
</sect4>

<sect4 id="af_surround">
<title>D�codeur de son surround</title>
<para>
Le son surround encod� en matrice peut �tre d�cod� par le filtre surround. Dolby
Surround est un exemple de format encod� en matrice. Beaucoup de fichiers avec deux
canaux audio contiennent actuellement du son surround matric�. Pour utiliser cette
fonction vous avez besoin d'une carte son supportant au moins 4 canaux. Ce filtre a un
param�tre:
</para>

<variablelist>
<varlistentry>
<term><option>d &lt;0-1000&gt;</option></term>
<listitem><para>
est un nombre � virgule optionnel entre <literal>0</literal> et <literal>1000</literal>
utilis� pour d�finir le d�calage en ms pour les haut-parleurs arri�res. Ce d�calage
devrait �tre d�fini comme ceci: si d1 est la distance entre la position d'�coute et
les haut-parleurs de devant et d2 la distance entre la position d'�coute et les
haut-parleurs de derri�re, alors le d�calage d peut �tre fix� � 15ms si d1 &lt;= d2 et �
15 + 5*(d1-d2) si d1 &gt; d2. La valeur par d�faut pour d est 20ms.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Exemple:
<screen>mplayer -af surround=15 -channels 4 <replaceable>media.avi</replaceable></screen>
ajouterait un d�codage de son surround avec un d�calage de 15ms pour le son des
haut-parleurs arri�re.
</para>
</sect4>

<sect4 id="af_export">
<title>Exporteurs Audio</title>
<para>
Ce filtre audio exporte le signal entrant vers un autre process en utilisant
le mappage de m�moire <literal>mmap()</literal>). Les aires de m�moire mapp�es
contiennent une ent�te:

<programlisting>
int nch                      /*nombre de canaux*/
int size		     /*taille du tampon*/
unsigned long long counter   /*Utilis� pour garder la synchro, mis � jour
                               chaque fois que de nouvelles donn�es sont
			       export�es.*/
</programlisting>

Le reste est constitu� de donn�es 16bit (non-entrelac�es).
</para>

<variablelist>
<varlistentry>
<term><option>fichier_mmapp�</option></term>
<listitem><para>
Le fichier dans lequel vous voulez que le filtre exporte. Par d�faut il mappe
dans
<filename>~/.mplayer/mplayer-af_export</filename>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>nsamples</option></term>
<listitem><para>
Nombre d'�chantillons par canal. La valeur par d�faut est <literal>512</literal> �chantillons.
</para></listitem>
</varlistentry>
</variablelist>

<para>
Exemple:
<screen>mplayer -af export=/tmp/mplayer-af_export:1024 <replaceable>media.avi</replaceable></screen>
exporterait 1024 �chantillons par canal dans <filename>/tmp/mplayer-af_export</filename>.
</para>
</sect4>

</sect3>

<sect3 id="audio-plugins">
<title>Plugins Audio (� ne plus utiliser)</title>
<note><para><emphasis role="bold">Les plugins audio ont �t� remplac�s par les filtres
audio et seront prochainement supprim�s.</emphasis></para></note>

<para>
<application>MPlayer</application> supporte les plugins audio. Les plugins audio
peuvent �tre utilis�s pour changer les propri�t�s des donn�es audio avant que le son
n'atteigne la carte son. Ils sont activ�s en utilisant l'option <option>-aop</option>
qui accepte l'argument <option>list=plugin1,plugin2,...</option>. L'argument
<option>list</option> est requis et d�termine quels plugins devraient �tre utilis�s et
dans quel ordre ils devraient �tre ex�cut�s. Exemple:

<screen>mplayer <replaceable>media.avi</replaceable> -aop list=resample,format</screen>

passerait le son au travers du plugin resampling suivi du plugin format.
</para>

<para>
Ces plugins on �galement des options qui changent leur comportement. Ces options sont
expliqu�es en d�tail dans les sections ci-dessous. Un plugin s'ex�cutera avec des
param�tres par d�faut si ses options sont omises. Voici un exemple de comment utiliser
les plugins en combinaison avec des options sp�cifiques au plugin:

<screen>mplayer media.avi -aop list=resample,format:fout=44100:format=0x8</screen>

fixerait la fr�quence de sortie du plugin resample � 44100Hz et le format de sortie du
plugin format � AFMT_U8.
</para>

<para>
Actuellement les plugins audio ne peuvent pas �tre utilis�s dans
<application>MEncoder</application>.
</para>


<sect4 id="updn-sampling">
<title>Up/Downsampling</title>

<para>
<application>MPlayer</application> supporte pleinement l'up/downsampling du son.
Ce plugin peut �tre utilis� si vous avez une carte son � fr�quence fixe ou que vous
vous battez avec une vieille carte son qui n'est capable que de sampler � 44.1kHz maxi.
Ce plugin � une option: <option>fout</option> qui peut �tre utilis� pour fixer la
fr�quence de sortie d�sir�e. Elle est donn�e en Hz, et est par d�faut de 48kHz.
</para>

<para>
Usage:

<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=resample:fout=<replaceable>freq</replaceable></screen>

o� <literal><replaceable>freq</replaceable></literal> est la fr�quence en Hz, par ex.
<literal>44100</literal>.
</para>

<note>
<para>
Notez que la fr�quence de sortie ne devrait pas �tre augment�e au dessus de sa valeur
par d�faut. Le d�passement provoquera la lecture des flux audio et vid�o en slow motion
assortie d'une distorsion audio.
</para>
</note>
</sect4>


<sect4 id="surround-decode">
<title>D�codage son surround</title>

<para>
<application>MPlayer</application> a un plugin audio qui peut d�coder le son surround
encod� en matrice. Dolby Surround est un exemple de format encod� en matrice. Beaucoup
de fichiers avec deux canaux audio contiennent actuellement du son surround matrici�.
Pour utiliser cette fonction vous avez besoin d'une carte son supportant au moins 4 canaux.
</para>

<para>
Usage:
<screen>mplayer <replaceable>media.avi</replaceable> -aop list=surround</screen>
</para>
</sect4>


<sect4 id="sample-format-conv">
<title>Convertisseur de format de sample</title>

<para>
Si votre carte son ne supporte pas le format de donn�es int 16bit sign�, ce plugin peut
�tre utilis� pour le changer dans un format que votre carte son comprends. Il a une
option, <option>format</option>, qui peut �tre initialis�e avec les nombres trouv�s
dans <filename>libao2/afmt.h</filename>. Ce plugin est tr�s rarement utilis� et est
r�serv�e aux utilisateurs avanc�s. Gardez � l'esprit que ce plugin ne change que le
format de sample et pas sa fr�quence ou le nombre de canaux.
</para>

<para>
Utilisation:

<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=format:format=<replaceable>outfmt</replaceable></screen>

o� <literal><replaceable>outfmt</replaceable></literal> est le format de sortie requis.
</para>
</sect4>


<sect4 id="audio-delay">
<title>D�calage</title>
<para>
Ce plugin d�cale le son est n'est l� que comme exemple pour d�montrer comment
d�velopper de nouveaux plugins. Il ne peut �tre utilis� pour rien d'utile d'un point
de vue utilisateur et n'est mentionn� ici que par soucis d'exhaustivit�.
N'utilisez pas ce plugin � moins que vous soyez un d�veloppeur.
</para>
</sect4>


<sect4 id="sw-volume">
<title>Contr�le de volume logiciel</title>

<para>
Ce plugin est un remplacement logiciel pour le contr�leur de volume, et peut �tre
utilis� sur des machines avec un p�riph�rique mixeur endommag�. Il peut �galement �tre
utilis� si on veut changer le volume de sortie de <application>MPlayer</application>
sans changer le volume PCM du mixeur. Il a une option <option>volume</option> qui est
utilis�e en fixant une valeur entre 0 et 255, 101 �tant la valeur par d�faut qui
�quivaut � une amplification de 0dB. Utilisez ce plugin avec pr�caution car il peut
r�duire le signal jusqu'au bruit. Dans la plupart des cas il vaut mieux r�gler le
volume MASTER au maximum, laisser ce plugin, et contr�ler le niveau de sortie sur vos
haut-parleurs avec le bouton principal du mixeur. Au cas o� votre carte son ait un
mixeur num�rique au lieu d'un analogique, utilisez le contr�le mixeur MASTER � la place.
Si il y a un ampli externe connect� � votre ordinateur (c'est la plupart du temps le
cas), le niveau de bruit peut �tre minimis� en ajustant le niveau principal et la
molette du volume de l'ampli jusqu'� ce que le bruit r�siduel soit parti.
</para>

<para>
Usage:
<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=volume:volume=<replaceable>0-255</replaceable></screen>
</para>

<para>
Ce plugin a �galement des capacit�s de compression ou "Soft-Clipping". La compression
peut �tre utilis� si la dynamique du son est tr�s �lev�e ou si la dynamique de vos
haut-parleurs est tr�s basse. Soyez contient que cette fonction cr�e des distorsions et
ne devrait �tre envisag�e qu'en dernier ressort.
</para>

<para>
Utilisation:
<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=volume:softclip</screen>
</para>
</sect4>

<sect4 id="extrastereo">
<title>Extrastereo</title>

<para>
Ce plugin augmente (lin�airement) la diff�rence entre les canaux gauche et droit (comme
le plugin extrastereo de <application>XMMS</application>) qui donne une sorte d'effet
"live" � la lecture.
</para>

<para>
Utilisation:
<screen>
mplayer <replaceable>media.avi</replaceable> -aop list=extrastereo
mplayer <replaceable>media.avi</replaceable> -aop list=extrastereo:mul=3.45<!--
--></screen>

Le coefficient par d�faut (<option>mul</option>) est un nombre � virgule initialis� �
2.5. Si vous l'initialisez � <literal>0.0</literal>, vous aurez un son mono (moyenne
des deux canaux). Si vous l'initialisez � <literal>1.0</literal>, le son sera inchang�,
si vous l'initialisez � <literal>-1.0</literal>, les canaux gauche et droit seront invers�s.
</para>
</sect4>


<sect4 id="volnorm">
<title>Normaliseur de volume</title>

<para>
Ce plugin maximise le volume sans distordre le son.
</para>

<para>
Usage:
<screen>mplayer <replaceable>media.avi</replaceable> -aop list=volnorm</screen>
</para>
</sect4>
</sect3>
</sect2>