audio.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->

<refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
 <refnamediv>
  <refname>ogg://</refname>
  <refpurpose>Audio-Streams</refpurpose>
 </refnamediv>

 <refsect1 role="description"><!-- {{{ -->
  &reftitle.description;
  <para>
   Dateien, die über den Wrapper <filename>ogg://</filename> zum Lesen
   geöffnet werden, werden als komprimierte Audiodaten behandelt, die mit
   dem <literal>OGG/Vorbis</literal>-Codec kodiert wurden. Entsprechend werden
   Dateien, die über den Wrapper <filename>ogg://</filename> im Schreib- oder
   Anfügemodus geöffnet werden, als komprimierte Audiodaten geschrieben. Wenn
   die Funktion <function>stream_get_meta_data</function> auf eine
   <literal>OGG/Vorbis</literal>-Datei angewendet wird, die im Lesemodus
   geöffnet wurde, gibt sie verschiedene Details über den Stream zurück,
   einschließlich des Hersteller- (<parameter>vendor</parameter>) Tags, aller
   enthaltenen Kommentare (<parameter>comments</parameter>), der Anzahl der
   Kanäle (<parameter>channels</parameter>), der Abtastrate
   (<parameter>rate</parameter>) und der Kodierungsrate, beschrieben durch
   <parameter>bitrate_lower</parameter>, <parameter>bitrate_upper</parameter>,
   <parameter>bitrate_nominal</parameter> und
   <parameter>bitrate_window</parameter>.
  </para>

  <simpara><filename>ogg://</filename> (PECL)</simpara>
  <note>
   <title>Dieser Wrapper ist standardmäßig nicht aktiviert</title>
   <simpara>
    Um den Wrapper <filename>ogg://</filename> verwenden zu können, muss die
    <link xlink:href="&url.pecl.package;oggvorbis">OGG/Vorbis</link>-Erweiterung
    von &link.pecl; installiert werden
   </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>Zusammenfassung des Wrappers</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Eigenschaft</entry>
       <entry>wird unterstützt</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>Eingeschränkt durch <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
       <entry>Nein</entry>
      </row>
      <row>
       <entry>Erlaubt Lesen</entry>
       <entry>Ja</entry>
      </row>
      <row>
       <entry>Erlaubt Schreiben</entry>
       <entry>Ja</entry>
      </row>
      <row>
       <entry>Erlaubt Anfügen</entry>
       <entry>Ja</entry>
      </row>
      <row>
       <entry>Erlaubt gleichzeitiges Lesen und Schreiben</entry>
       <entry>Nein</entry>
      </row>
      <row>
       <entry>Unterstützt <function>stat</function></entry>
       <entry>Nein</entry>
      </row>
      <row>
       <entry>Unterstützt <function>unlink</function></entry>
       <entry>Nein</entry>
      </row>
      <row>
       <entry>Unterstützt <function>rename</function></entry>
       <entry>Nein</entry>
      </row>
      <row>
       <entry>Unterstützt <function>mkdir</function></entry>
       <entry>Nein</entry>
      </row>
      <row>
       <entry>Unterstützt <function>rmdir</function></entry>
       <entry>Nein</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <!-- FIXME: This should not be here! context.audio... -->
  <para>
   <table>
    <title>Kontextoptionen</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Name</entry>
       <entry>Verwendung</entry>
       <entry>Voreinstellung</entry>
       <entry>Modus</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>pcm_mode</literal></entry>
       <entry>
        Die PCM-Kodierung, die beim Lesen angewendet werden soll, eine von:
        <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> und <constant>OGGVORBIS_PCM_S16_LE</constant>.
        (8 oder 16 Bit, vorzeichenbehaftet oder vorzeichenlos, big- oder
        little-<literal>endian</literal>)
       </entry>
       <entry>OGGVORBIS_PCM_S16_LE</entry>
       <entry>Lesen</entry>
      </row>
      <row>
       <entry><literal>rate</literal></entry>
       <entry>
        Die Abtastrate der Eingangsdaten, in Hz
       </entry>
       <entry>44100</entry>
       <entry>Schreiben/Anfügen</entry>
      </row>
      <row>
       <entry><literal>bitrate</literal></entry>
       <entry>
        Bei Angabe als Ganzzahl die feste Bitrate, mit der kodiert werden
        soll (16000 bis 131072).
        Bei Angabe als Gleitkommazahl die zu verwendende Qualität der
        variablen Bitrate (-1.0 bis 1.0).
       </entry>
       <entry>128000</entry>
       <entry>Schreiben/Anfügen</entry>
      </row>
      <row>
       <entry><literal>channels</literal></entry>
       <entry>
        Die Anzahl der zu kodierenden Audiokanäle, normalerweise 1 (Mono) oder
        2 (Stereo).
        Bis zu 16 Kanäle sind möglich.
       </entry>
       <entry>2</entry>
       <entry>Schreiben/Anfügen</entry>
      </row>
      <row>
       <entry><literal>comments</literal></entry>
       <entry>
        Ein Array von Zeichenketten, die in den Track-Header kodiert werden
        sollen.
       </entry>
       <entry/>
       <entry>Schreiben/Anfügen</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </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
-->