<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/wrappers.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'wrappers.audio.php',
    1 => 'ogg://',
    2 => 'Audio-Streams',
  ),
  'up' => 
  array (
    0 => 'wrappers.php',
    1 => 'Unterst&uuml;tzte Protokolle und Wrapper',
  ),
  'prev' => 
  array (
    0 => 'wrappers.rar.php',
    1 => 'rar://',
  ),
  'next' => 
  array (
    0 => 'wrappers.expect.php',
    1 => 'expect://',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    'path' => 'language/wrappers/audio.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="wrappers.audio" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">ogg://</h1>
  <p class="refpurpose"><span class="refname">ogg://</span> &mdash; <span class="dc-title">Audio-Streams</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-wrappers.audio-description">
  <h3 class="title">Beschreibung</h3>
  <p class="para">
   Dateien, die über den Wrapper <var class="filename">ogg://</var> zum Lesen
   geöffnet werden, werden als komprimierte Audiodaten behandelt, die mit
   dem <code class="literal">OGG/Vorbis</code>-Codec kodiert wurden. Entsprechend werden
   Dateien, die über den Wrapper <var class="filename">ogg://</var> im Schreib- oder
   Anfügemodus geöffnet werden, als komprimierte Audiodaten geschrieben. Wenn
   die Funktion <span class="function"><a href="function.stream-get-meta-data.php" class="function">stream_get_meta_data()</a></span> auf eine
   <code class="literal">OGG/Vorbis</code>-Datei angewendet wird, die im Lesemodus
   geöffnet wurde, gibt sie verschiedene Details über den Stream zurück,
   einschließlich des Hersteller- (<code class="parameter">vendor</code>) Tags, aller
   enthaltenen Kommentare (<code class="parameter">comments</code>), der Anzahl der
   Kanäle (<code class="parameter">channels</code>), der Abtastrate
   (<code class="parameter">rate</code>) und der Kodierungsrate, beschrieben durch
   <code class="parameter">bitrate_lower</code>, <code class="parameter">bitrate_upper</code>,
   <code class="parameter">bitrate_nominal</code> und
   <code class="parameter">bitrate_window</code>.
  </p>

  <p class="simpara"><var class="filename">ogg://</var> (PECL)</p>
  <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
   <strong>Dieser Wrapper ist standardmäßig nicht aktiviert</strong><br />
   <span class="simpara">
    Um den Wrapper <var class="filename">ogg://</var> verwenden zu können, muss die
    <a href="https://pecl.php.net/package/oggvorbis" class="link external">&raquo;&nbsp;OGG/Vorbis</a>-Erweiterung
    von <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a> installiert werden
   </span>
  </p></blockquote>
 </div>


 <div class="refsect1 usage" id="refsect1-wrappers.audio-usage"> 
  <h3 class="title">Verwendung</h3>
  <ul class="itemizedlist">
   <li class="listitem"><span class="simpara"><var class="filename">ogg://soundfile.ogg</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">ogg:///path/to/soundfile.ogg</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">ogg://http://www.example.com/path/to/soundstream.ogg</var></span></li>
  </ul>
 </div>
 

 <div class="refsect1 options" id="refsect1-wrappers.audio-options">
  <h3 class="title">Optionen</h3>
  <p class="para">
   <table class="doctable table">
    <caption><strong>Zusammenfassung des Wrappers</strong></caption>
    
     <thead>
      <tr>
       <th>Eigenschaft</th>
       <th>wird unterstützt</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>Eingeschränkt durch <a href="filesystem.configuration.php#ini.allow-url-fopen" class="link">allow_url_fopen</a></td>
       <td>Nein</td>
      </tr>

      <tr>
       <td>Erlaubt Lesen</td>
       <td>Ja</td>
      </tr>

      <tr>
       <td>Erlaubt Schreiben</td>
       <td>Ja</td>
      </tr>

      <tr>
       <td>Erlaubt Anfügen</td>
       <td>Ja</td>
      </tr>

      <tr>
       <td>Erlaubt gleichzeitiges Lesen und Schreiben</td>
       <td>Nein</td>
      </tr>

      <tr>
       <td>Unterstützt <span class="function"><a href="function.stat.php" class="function">stat()</a></span></td>
       <td>Nein</td>
      </tr>

      <tr>
       <td>Unterstützt <span class="function"><a href="function.unlink.php" class="function">unlink()</a></span></td>
       <td>Nein</td>
      </tr>

      <tr>
       <td>Unterstützt <span class="function"><a href="function.rename.php" class="function">rename()</a></span></td>
       <td>Nein</td>
      </tr>

      <tr>
       <td>Unterstützt <span class="function"><a href="function.mkdir.php" class="function">mkdir()</a></span></td>
       <td>Nein</td>
      </tr>

      <tr>
       <td>Unterstützt <span class="function"><a href="function.rmdir.php" class="function">rmdir()</a></span></td>
       <td>Nein</td>
      </tr>

     </tbody>
    
   </table>

  </p>
  
  <p class="para">
   <table class="doctable table">
    <caption><strong>Kontextoptionen</strong></caption>
    
     <thead>
      <tr>
       <th>Name</th>
       <th>Verwendung</th>
       <th>Voreinstellung</th>
       <th>Modus</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td><code class="literal">pcm_mode</code></td>
       <td>
        Die PCM-Kodierung, die beim Lesen angewendet werden soll, eine von:
        <strong><code>OGGVORBIS_PCM_U8</code></strong>, <strong><code>OGGVORBIS_PCM_S8</code></strong>,
        <strong><code>OGGVORBIS_PCM_U16_BE</code></strong>, <strong><code>OGGVORBIS_PCM_S16_BE</code></strong>,
        <strong><code>OGGVORBIS_PCM_U16_LE</code></strong> und <strong><code>OGGVORBIS_PCM_S16_LE</code></strong>.
        (8 oder 16 Bit, vorzeichenbehaftet oder vorzeichenlos, big- oder
        little-<code class="literal">endian</code>)
       </td>
       <td>OGGVORBIS_PCM_S16_LE</td>
       <td>Lesen</td>
      </tr>

      <tr>
       <td><code class="literal">rate</code></td>
       <td>
        Die Abtastrate der Eingangsdaten, in Hz
       </td>
       <td>44100</td>
       <td>Schreiben/Anfügen</td>
      </tr>

      <tr>
       <td><code class="literal">bitrate</code></td>
       <td>
        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).
       </td>
       <td>128000</td>
       <td>Schreiben/Anfügen</td>
      </tr>

      <tr>
       <td><code class="literal">channels</code></td>
       <td>
        Die Anzahl der zu kodierenden Audiokanäle, normalerweise 1 (Mono) oder
        2 (Stereo).
        Bis zu 16 Kanäle sind möglich.
       </td>
       <td>2</td>
       <td>Schreiben/Anfügen</td>
      </tr>

      <tr>
       <td><code class="literal">comments</code></td>
       <td>
        Ein Array von Zeichenketten, die in den Track-Header kodiert werden
        sollen.
       </td>
       <td class="empty">&nbsp;</td>
       <td>Schreiben/Anfügen</td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>
 

</div><?php manual_footer($setup); ?>