XCV. oggvorbis

Introduction

Le format de fichier OGG/Vorbis, comme définit par http://www.vorbis.com/ et 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

OptionDéfinitionPertinenceDéfaut
pcm_modeEncodage PCM utilisé. Voir les constantes ci-dessous.Lecture / ÉcritureOGGVORBIS_PCM_S16_LE
rateTaux d'échantillonage PCM. Mesuré en Hz.Écriture uniquement44100
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 uniquement128000
channelsNombre de canaux PCM. 1 == Mono, 2 == Stéréo.Écriture uniquement2
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é, faîte l'effort d'assigner manuellement des nombres uniques lors de l'encodage. Écriture uniquementRandom
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 uniquementarray('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 :

ConstanteDéfinition
OGGVORBIS_PCM_U8PCM 8-bit non-signé.
OGGVORBIS_PCM_S8PCM 8-bit signé.
OGGVORBIS_PCM_U16_LEPCM 16-bit non-signé. Arrangements normaux Little Endian.
OGGVORBIS_PCM_U16_BEPCM 16-bit non-signé. Arrangements normaux Big Endian.
OGGVORBIS_PCM_S16_LEPCM 16-bit signé. Arrangements normaux Little Endian.
OGGVORBIS_PCM_S16_BEPCM 16-bit signé. Arrangements normaux Big Endian.
Table des matières
Utilisation --  Exemples d'utilisation du gestionnaire ogg://.

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:20