Forum und email
oggvorbis

CIX. oggvorbis

Úvod

The OGG/Vorbis file format, as defined by https://www.vorbis.com/, is a scheme for compressing audio streams by multiple factors with a minimum of quality loss. This extension adds Ogg Vorbis support to PHP's URL Wrappers. When used in read mode, compressed OGG/Vorbis data is expanded to raw PCM audio in one of six PCM encoding formats listed below.

Požadavky

This extension requires PHP >= 4.3.0, libogg >= 1.0, and libvorbis >= 1.0.

Konfigurace běhu

Toto rozšíření nemá definováno žádné konfigurační direktivy.

Instalace

Informace o instalaci tohoto PECL rozšíření lze najít v kapitole manuálu nazvané Instalace rozšíření PECL. Další informace, jako nové verze, soubory ke stažení, zdrojové soubory, správcovské informace a CHANGELOG, lze najít zde: https://pecl.php.netoggvorbis

Context options

Tabulka 1. OGG/Vorbis tuning options

OptionDefinitionRelevanceDefault
pcm_modePCM byte encoding used. See constants below.Read / WriteOGGVORBIS_PCM_S16_LE
ratePCM Sampling rate. Measured in Hz.Write only44100
bitrate Vorbis Average Bitrate Encoding / Variable Bitrate Encoding. Measured in bps (ABR) or Quality level (VBR: 0.0 to 1.0). 128000 ABR is rough equal to 0.4 VBR. Write only128000
channelsNumber of PCM channels. 1 == Mono, 2 == Stereo.Write only2
serialno Serial Number of stream within file. Must be unique within file. Because of the potential to select a duplicate serial number within a chained file, make efforts to manually assign unique numbers when encoding. Write onlyRandom
comments Associative array of file comments. Will be translated to strtoupper($name) . "=$value". Note: This context option is not available in oggvorbis-0.1 Write onlyarray('ENCODER' => 'PHP/OggVorbis, https://pear.php.net/oggvorbis')

Předdefinované konstanty

Tyto konstanty jsou definovány tímto rozšířením a budou k dispozici pouze tehdy, bylo-li rozšíření zkompilováno společně s PHP nebo dynamicky zavedeno za běhu.

Tabulka 2. OGG/Vorbis supports PCM encodings in the following formats

ConstantDefinition
OGGVORBIS_PCM_U8Unsigned 8-bit PCM.
OGGVORBIS_PCM_S8Signed 8-bit PCM.
OGGVORBIS_PCM_U16_LEUnsigned 16-bit PCM. Little Endian byte order.
OGGVORBIS_PCM_U16_BEUnsigned 16-bit PCM. Big Endian byte order.
OGGVORBIS_PCM_S16_LESigned 16-bit PCM. Little Endian byte order.
OGGVORBIS_PCM_S16_BESigned 16-bit PCM. Big Endian byte order.
Obsah
Usage --  Examples on using the ogg:// wrapper.