Manuel PHP
Précédent |  | Suivant

# CVI. oggvorbis

# Introduction

Le format de fichier OGG/Vorbis, comme définit par http://www.vorbis.com/, est un schéma pour la compression de flux audio par de multiples facteurs avec un minimum de perte de qualité. Cette extension ajoute le support Ogg Vorbis aux gestionnaires d'URL de PHP. Lorsqu'utilisé en mode lecture, les données compressées OGG/Vorbis sont déployées en audio PCM brute en un des six formats d'encodage PCM listés ci-dessous.

# Pré-requis

Cette extension nécessite PHP >= 4.3.0, libogg >= 1.0, et libvorbis >= 1.0.

# Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

# Installation

oggvorbis est installé en utilisant le processus d'installation des paquets PECL.

-     $ pear install oggvorbis

- Copiez le fichier résultant oggvorbis.so dans un dossier approprié et ajoutez extension=oggvorbis.so à votre `php.ini` ou chargez-le dynamiquement dans votre script PHP en utilisant dl('oggvorbis.so');

# Options de contexte

Tableau 1. Options personnalisées OGG/Vorbis

Option | Définition | Pertinence | Défaut
--- | --- | --- | ---
pcm_mode | Encodage PCM utilisé. Voir les constantes ci-dessous. | Lecture / Écriture | `OGGVORBIS_PCM_S16_LE`
rate | Taux d'échantillonage PCM. Mesuré en Hz. | Écriture uniquement | `44100`
bitrate | Débit d'encodage moyen Vorbis / Débit d'encodage variable. Mesuré en bps (ABR) ou en niveau de qualité (VBR : 0.0 à 1.0). 128000 ABR équivaut à 0.4 VBR. | Écriture uniquement | `128000`
channels | Nombre de canaux PCM. 1 == Mono, 2 == Stéréo. | Écriture uniquement | `2`
serialno | Nombre de séries de flux dans un fichier. Doit être unique dans un fichier. Parcequ'il est potentiellement possible de sélectionner plusieurs nombres de séries dans un fichier chaîné, faites l'effort d'assigner manuellement des nombres uniques lors de l'encodage. | Écriture uniquement | Random
comments | Tableau associatif de commentaires de fichier. Peut être traduit par strtoupper($name) . "=$value". Note : Cette option de contexte n'est pas disponible en oggvorbis-0.1 | Écriture uniquement | `array('ENCODER' => 'PHP/OggVorbis, http://pear.php.net/oggvorbis')`

# Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

Tableau 2. OGG/Vorbis supporte l'encodage PCM dans les formats suivants :

Constante | Définition
--- | ---
`OGGVORBIS_PCM_U8` | PCM 8-bit non-signé.
`OGGVORBIS_PCM_S8` | PCM 8-bit signé.
`OGGVORBIS_PCM_U16_LE` | PCM 16-bit non-signé. Arrangements normaux Little Endian.
`OGGVORBIS_PCM_U16_BE` | PCM 16-bit non-signé. Arrangements normaux Big Endian.
`OGGVORBIS_PCM_S16_LE` | PCM 16-bit signé. Arrangements normaux Little Endian.
`OGGVORBIS_PCM_S16_BE` | PCM 16-bit signé. Arrangements normaux Big Endian.

Précédent | Sommaire | Suivant
PDO_ODBC DSN | Niveau supérieur | Utilisation