doc-fr/language/wrappers/audio.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af6fdf16ab44bcf4d045407963e43c3d9dd2ff29 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" role="noversion">
 <refnamediv>
  <refname>ogg://</refname>
  <refpurpose>Flux Audio</refpurpose>
 </refnamediv>

 <refsect1 role="description"><!-- {{{ -->
  &reftitle.description;
  <para>
   Les fichiers ouverts en lecture avec le gestionnaire <filename>ogg://</filename>
   sont traités comme de l'audio compressé en utilisant le codec <literal>OGG/Vorbis</literal>.
   De la même façon, les fichiers ouverts en écriture ou en ajout avec le gestionnaire
   <filename>ogg://</filename> sont écrits comme étant des données audio compressées.
   La fonction <function>stream_get_meta_data</function>, lorsqu'elle est utilisée sur un
   fichier <literal>OGG/Vorbis</literal> ouvert en lecture, retournera de nombreux détails
   concernant ce flux, incluant l'en-tête <parameter>vendor</parameter>, tous les commentaires
   <parameter>comments</parameter>, le nombre de canaux
   <parameter>channels</parameter>, le taux d'échantillonnage <parameter>rate</parameter>
   ainsi que le taux d'encodage décrit par :
   <parameter>bitrate_lower</parameter>, <parameter>bitrate_upper</parameter>,
   <parameter>bitrate_nominal</parameter> et <parameter>bitrate_window</parameter>.
  </para>

  <simpara><filename>ogg://</filename> (PECL)</simpara>
  <note>
   <title>Ce gestionnaire n'est pas activé par défaut</title>
   <simpara>
    Pour utiliser le gestionnaire <filename>ogg://</filename>, vous devez installer
    l'extension <link xlink:href="&url.pecl.package;oggvorbis">OGG/Vorbis</link>
    disponible sur <link xlink:href="&url.pecl;">PECL</link>.
   </simpara>
  </note>
 </refsect1><!-- }}} -->

 <refsect1 role="usage"> <!-- {{{ -->
  &reftitle.usage;
  <itemizedlist>
   <listitem><simpara><filename>ogg://soundfile.ogg</filename></simpara></listitem>
   <listitem><simpara><filename>ogg:///path/to/soundfile.ogg</filename></simpara></listitem>
   <listitem><simpara><filename>ogg://http://www.example.com/path/to/soundstream.ogg</filename></simpara></listitem>
  </itemizedlist>
 </refsect1> <!-- }}} -->

 <refsect1 role="options"><!-- {{{ -->
  &reftitle.options;
  <para>
   <table>
    <title>Résumé du gestionnaire</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Attribut</entry>
       <entry>Supporté</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>Restreint par <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
       <entry>Non</entry>
      </row>
      <row>
       <entry>Permet la lecture</entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Permet l'écriture</entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Permet l'ajout</entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Permet la lecture et l'écriture simultanément</entry>
       <entry>Non</entry>
      </row>
      <row>
       <entry>Supporte la fonction <function>stat</function></entry>
       <entry>Non</entry>
      </row>
      <row>
       <entry>Supporte la fonction <function>unlink</function></entry>
       <entry>Non</entry>
      </row>
      <row>
       <entry>Supporte la fonction <function>rename</function></entry>
       <entry>Non</entry>
      </row>
      <row>
       <entry>Supporte la fonction <function>mkdir</function></entry>
       <entry>Non</entry>
      </row>
      <row>
       <entry>Supporte la fonction <function>rmdir</function></entry>
       <entry>Non</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <!-- FIXME: This should not be here! context.audio... -->
  <para>
   <table>
    <title>Options de contexte</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Nom</entry>
       <entry>Utilisation</entry>
       <entry>Défaut</entry>
       <entry>Mode</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>pcm_mode</literal></entry>
       <entry>
        L'encodage PCM à appliquer pendant la lecture, parmi un de ceux-ci :
        <constant>OGGVORBIS_PCM_U8</constant>, <constant>OGGVORBIS_PCM_S8</constant>,
        <constant>OGGVORBIS_PCM_U16_BE</constant>,
        <constant>OGGVORBIS_PCM_S16_BE</constant>,
        <constant>OGGVORBIS_PCM_U16_LE</constant> et
        <constant>OGGVORBIS_PCM_S16_LE</constant>.
        (8 vs 16 bit, signé ou non, gros ou petit <literal>endian</literal>)
       </entry>
       <entry>OGGVORBIS_PCM_S16_LE</entry>
       <entry>Lecture</entry>
      </row>
      <row>
       <entry><literal>rate</literal></entry>
       <entry>
        Taux d'échantillonnage des données entrantes, exprimé en Hz
       </entry>
       <entry>44100</entry>
       <entry>Écriture/Ajout</entry>
      </row>
      <row>
       <entry><literal>bitrate</literal></entry>
       <entry>
        Lorsque donné sous la forme d'un entier, la vitesse du débit pour encoder
        (de 16000 à 131072). Lorsque donné sous la forme d'un nombre décimal,
        la variation de la qualité du débit à utiliser (de -1.0 à 1.0).
       </entry>
       <entry>128000</entry>
       <entry>Écriture/Ajout</entry>
      </row>
      <row>
       <entry><literal>channels</literal></entry>
       <entry>
        Le nombre de canaux audio à encoder, typiquement 1 (Mono) ou 2 (Stéréo).
        Intervalle pouvant aller jusqu'à 16.
       </entry>
       <entry>2</entry>
       <entry>Écriture/Ajout</entry>
      </row>
      <row>
       <entry><literal>comments</literal></entry>
       <entry>
        Un tableau de valeurs sous forme de chaînes de caractères à encoder
        dans la piste d'en-tête.
       </entry>
       <entry/>
       <entry>Écriture/Ajout</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </refsect1> <!-- }}} -->

 <refsect1 role="examples"><!-- {{{ -->
  &reftitle.examples;
 </refsect1><!-- }}} -->

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->