Collaboration diagram for WavFile:

Public Member Functions
	__construct ($numChannelsOrFileName=null, $sampleRateOrReadData=null, $bitsPerSample=null)
	WavFile Constructor. More...

	__destruct ()

	__clone ()

	__toString ()
	Output the wav file headers and data. More...

	getActualSize ()

	getChunkSize ()

	getFmtChunkSize ()

	getFmtExtendedSize ()

	getFactChunkSize ()

	getDataSize ()

	getDataOffset ()

	getAudioFormat ()

	getAudioSubFormat ()

	getNumChannels ()

	setNumChannels ($numChannels)

	getChannelMask ()

	setChannelMask ($channelMask=self::SPEAKER_DEFAULT)

	getSampleRate ()

	setSampleRate ($sampleRate)

	getBitsPerSample ()

	setBitsPerSample ($bitsPerSample)

	getValidBitsPerSample ()

	getBlockAlign ()

	getNumBlocks ()

	getByteRate ()

	getSamples ()

	setSamples (&$samples='')

	getMinAmplitude ()

	getZeroAmplitude ()

	getMaxAmplitude ()

	makeHeader ()
	Construct a wav header from this object. More...

	getDataSubchunk ()
	Construct wav DATA chunk. More...

	save ($filename)
	Save the wav data to a file. More...

	openWav ($filename, $readData=true)
	Reads a wav header and data from a file. More...

	closeWav ()
	Close a with openWav() previously opened wav file or free the buffer of setWavData(). More...

	setWavData (&$data, $free=true)
	Set the wav file data and properties from a wav file in a string. More...

	readWavData ($dataOffset=0, $dataSize=null)
	Read the wav data from the file into the buffer. More...

	getSampleBlock ($blockNum)
	Return a single sample block from the file. More...

	setSampleBlock ($sampleBlock, $blockNum)
	Set a single sample block. More...

	getSampleValue ($blockNum, $channelNum)
	Get a float sample value for a specific sample block and channel number. More...

	setSampleValue ($sampleFloat, $blockNum, $channelNum)
	Sets a float sample value for a specific sample block number and channel. More...

	filter ($filters, $blockOffset=0, $numBlocks=null)
	Run samples through audio processing filters. More...

	appendWav (WavFile $wav)
	Append a wav file to the current wav. More...

	mergeWav (WavFile $wav, $normalizeThreshold=null)
	Mix 2 wav files together. More...

	insertSilence ($duration=1.0)
	Add silence to the wav file. More...

	degrade ($quality=1.0)
	Degrade the quality of the wav file by introducing random noise. More...

	generateNoise ($duration=1.0, $percent=100)
	Generate noise at the end of the wav for the specified duration and volume. More...

	convertBitsPerSample ($bitsPerSample)
	Convert sample data to different bits per sample. More...

	displayInfo ()
	Output information about the wav object. More...

Static Public Member Functions
static	unpackSample ($sampleBinary, $bitDepth=null)
	Unpacks a single binary sample to numeric value. More...

static	packSample ($sample, $bitDepth)
	Packs a single numeric sample to binary. More...

static	unpackSampleBlock ($sampleBlock, $bitDepth, $numChannels=null)
	Unpacks a binary sample block to numeric values. More...

static	packSampleBlock ($samples, $bitDepth)
	Packs an array of numeric channel samples to a binary sample block. More...

static	normalizeSample ($sampleFloat, $threshold)
	Normalizes a float audio sample. More...

Data Fields
const	FILTER_MIX = 0x01

const	FILTER_NORMALIZE = 0x02

const	FILTER_DEGRADE = 0x04

const	MAX_CHANNEL = 18

const	MAX_SAMPLERATE = 192000

const	SPEAKER_DEFAULT = 0x000000
	Channel Locations for ChannelMask. More...

const	SPEAKER_FRONT_LEFT = 0x000001

const	SPEAKER_FRONT_RIGHT = 0x000002

const	SPEAKER_FRONT_CENTER = 0x000004

const	SPEAKER_LOW_FREQUENCY = 0x000008

const	SPEAKER_BACK_LEFT = 0x000010

const	SPEAKER_BACK_RIGHT = 0x000020

const	SPEAKER_FRONT_LEFT_OF_CENTER = 0x000040

const	SPEAKER_FRONT_RIGHT_OF_CENTER = 0x000080

const	SPEAKER_BACK_CENTER = 0x000100

const	SPEAKER_SIDE_LEFT = 0x000200

const	SPEAKER_SIDE_RIGHT = 0x000400

const	SPEAKER_TOP_CENTER = 0x000800

const	SPEAKER_TOP_FRONT_LEFT = 0x001000

const	SPEAKER_TOP_FRONT_CENTER = 0x002000

const	SPEAKER_TOP_FRONT_RIGHT = 0x004000

const	SPEAKER_TOP_BACK_LEFT = 0x008000

const	SPEAKER_TOP_BACK_CENTER = 0x010000

const	SPEAKER_TOP_BACK_RIGHT = 0x020000

const	SPEAKER_ALL = 0x03FFFF

const	WAVE_FORMAT_PCM = 0x0001

const	WAVE_FORMAT_IEEE_FLOAT = 0x0003

const	WAVE_FORMAT_EXTENSIBLE = 0xFFFE

const	WAVE_SUBFORMAT_PCM = "0100000000001000800000aa00389b71"

const	WAVE_SUBFORMAT_IEEE_FLOAT = "0300000000001000800000aa00389b71"

Protected Member Functions
	setActualSize ($actualSize=null)

	setChunkSize ($chunkSize=null)

	setFmtChunkSize ($fmtChunkSize=null)

	setFmtExtendedSize ($fmtExtendedSize=null)

	setFactChunkSize ($factChunkSize=null)

	setDataSize ($dataSize=null)

	setDataOffset ($dataOffset=null)

	setAudioFormat ($audioFormat=null)

	setAudioSubFormat ($audioSubFormat=null)

	setValidBitsPerSample ($validBitsPerSample=null)

	setBlockAlign ($blockAlign=null)

	setNumBlocks ($numBlocks=null)

	setByteRate ($byteRate=null)

	readWav ($readData=true)
	Read wav file from a stream. More...

	readWavHeader ()
	Parse a wav header. More...

Static Protected Attributes
static	$LOOKUP_LOGBASE

Detailed Description

Definition at line 69 of file WavFile.php.

Constructor & Destructor Documentation

◆ __construct()

WavFile::__construct	(	$numChannelsOrFileName = `null`,
		$sampleRateOrReadData = `null`,
		$bitsPerSample = `null`
	)

WavFile Constructor.

$wav1 = new WavFile(2, 44100, 16); // new wav with 2 channels, at 44100 samples/sec and 16 bits per sample $wav2 = new WavFile('./audio/sound.wav'); // open and read wav file

Parameters

string \| int	$numChannelsOrFileName	(Optional) If string, the filename of the wav file to open. The number of channels otherwise. Defaults to 1.
int \| bool	$sampleRateOrReadData	(Optional) If opening a file and boolean, decides whether to read the data chunk or not. Defaults to true. The sample rate in samples per second otherwise. 8000 = standard telephone, 16000 = wideband telephone, 32000 = FM radio and 44100 = CD quality. Defaults to 8000.
int	$bitsPerSample	(Optional) The number of bits per sample. Has to be 8, 16 or 24 for PCM audio or 32 for IEEE FLOAT audio. 8 = telephone, 16 = CD and 24 or 32 = studio quality. Defaults to 8.

Exceptions

WavFormatException
WavFileException

Definition at line 221 of file WavFile.php.

    {
        $this->_actualSize         = 44;
        $this->_chunkSize          = 36;
        $this->_fmtChunkSize       = 16;
        $this->_fmtExtendedSize    = 0;
        $this->_factChunkSize      = 0;
        $this->_dataSize           = 0;
        $this->_dataSize_fp        = 0;
        $this->_dataSize_valid     = true;
        $this->_dataOffset         = 44;
        $this->_audioFormat        = self::WAVE_FORMAT_PCM;
        $this->_audioSubFormat     = null;
        $this->_numChannels        = 1;
        $this->_channelMask        = self::SPEAKER_DEFAULT;
        $this->_sampleRate         = 8000;
        $this->_bitsPerSample      = 8;
        $this->_validBitsPerSample = 8;
        $this->_blockAlign         = 1;
        $this->_numBlocks          = 0;
        $this->_byteRate           = 8000;
        $this->_samples            = '';
        $this->_fp                 = null;
 
 
        if (is_string($numChannelsOrFileName)) {
            $this->openWav($numChannelsOrFileName, is_bool($sampleRateOrReadData) ? $sampleRateOrReadData : true);
 
        } else {
            $this->setNumChannels(is_null($numChannelsOrFileName) ? 1 : $numChannelsOrFileName)
                 ->setSampleRate(is_null($sampleRateOrReadData) ? 8000 : $sampleRateOrReadData)
                 ->setBitsPerSample(is_null($bitsPerSample) ? 8 : $bitsPerSample);
        }
    }

References openWav(), setNumChannels(), SPEAKER_DEFAULT, and WAVE_FORMAT_PCM.

Here is the call graph for this function:

◆ __destruct()

WavFile::__destruct ( )

Definition at line 256 of file WavFile.php.

                                 {
        if (is_resource($this->_fp)) $this->closeWav();
    }

References closeWav().

Here is the call graph for this function:

Member Function Documentation

◆ __clone()

WavFile::__clone ( )

Definition at line 260 of file WavFile.php.

                              {
        $this->_fp = null;
    }

◆ __toString()

WavFile::__toString ( )

Output the wav file headers and data.

Returns: string The encoded file.

Definition at line 269 of file WavFile.php.

    {
        return $this->makeHeader() .
               $this->getDataSubchunk();
    }

References getDataSubchunk(), and makeHeader().

Here is the call graph for this function:

◆ appendWav()

WavFile::appendWav ( WavFile $wav )

Append a wav file to the current wav.

The wav files must have the same sample rate, number of bits per sample, and number of channels.

Parameters

WavFile $wav (Required) The wav file to append.

Exceptions

WavFileException

Definition at line 1678 of file WavFile.php.

                                            {
        // basic checks
        if ($wav->getSampleRate() != $this->getSampleRate()) {
            throw new WavFileException("Sample rate for wav files do not match.");
        } else if ($wav->getBitsPerSample() != $this->getBitsPerSample()) {
            throw new WavFileException("Bits per sample for wav files do not match.");
        } else if ($wav->getNumChannels() != $this->getNumChannels()) {
            throw new WavFileException("Number of channels for wav files do not match.");
        }
 
        $this->_samples .= $wav->_samples;
        $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
 
        return $this;
    }

References getBitsPerSample(), getNumChannels(), getSampleRate(), and setDataSize().

Here is the call graph for this function:

◆ closeWav()

WavFile::closeWav ( )

Close a with openWav() previously opened wav file or free the buffer of setWavData().

Not necessary if the data has been read (readData = true) already.

Definition at line 953 of file WavFile.php.

                               {
        if (is_resource($this->_fp)) fclose($this->_fp);
 
        return $this;
    }

Referenced by __destruct(), openWav(), readWav(), readWavData(), and setWavData().

Here is the caller graph for this function:

◆ convertBitsPerSample()

WavFile::convertBitsPerSample ( $bitsPerSample )

Convert sample data to different bits per sample.

Parameters

int $bitsPerSample (Required) The new number of bits per sample;

Exceptions

WavFileException

Definition at line 1779 of file WavFile.php.

                                                         {
        if ($this->getBitsPerSample() == $bitsPerSample) {
            return $this;
        }
 
        $tempWav = new WavFile($this->getNumChannels(), $this->getSampleRate(), $bitsPerSample);
        $tempWav->filter(
            array(self::FILTER_MIX => $this),
            0,
            $this->getNumBlocks()
        );
 
        $this->setSamples()                       // implicit setDataSize(), setSize(), setActualSize(), setNumBlocks()
             ->setBitsPerSample($bitsPerSample);  // implicit setValidBitsPerSample(), setAudioFormat(), setAudioSubFormat(), setFmtChunkSize(), setFactChunkSize(), setSize(), setActualSize(), setDataOffset(), setByteRate(), setBlockAlign(), setNumBlocks()
        $this->_samples = $tempWav->_samples;
        $this->setDataSize();                     // implicit setSize(), setActualSize(), setNumBlocks()
 
        return $this;
    }

References getBitsPerSample(), getNumBlocks(), getNumChannels(), getSampleRate(), setDataSize(), and setSamples().

Here is the call graph for this function:

◆ degrade()

WavFile::degrade ( $quality = 1.0 )

Degrade the quality of the wav file by introducing random noise.

Parameters

float quality (Optional) The quality relative to the amplitude. 1 = no noise, 0 = max. noise.

Definition at line 1736 of file WavFile.php.

    {
        return $this->filter(self::FILTER_DEGRADE, array(
            WavFile::FILTER_DEGRADE => $quality
        ));
    }

References filter(), and FILTER_DEGRADE.

Here is the call graph for this function:

◆ displayInfo()

WavFile::displayInfo ( )

Output information about the wav object.

Definition at line 1806 of file WavFile.php.

    {
        $s = "File Size: %u\n"
            ."Chunk Size: %u\n"
            ."fmt Subchunk Size: %u\n"
            ."Extended fmt Size: %u\n"
            ."fact Subchunk Size: %u\n"
            ."Data Offset: %u\n"
            ."Data Size: %u\n"
            ."Audio Format: %s\n"
            ."Audio SubFormat: %s\n"
            ."Channels: %u\n"
            ."Channel Mask: 0x%s\n"
            ."Sample Rate: %u\n"
            ."Bits Per Sample: %u\n"
            ."Valid Bits Per Sample: %u\n"
            ."Sample Block Size: %u\n"
            ."Number of Sample Blocks: %u\n"
            ."Byte Rate: %uBps\n";
 
        $s = sprintf($s, $this->getActualSize(),
                         $this->getChunkSize(),
                         $this->getFmtChunkSize(),
                         $this->getFmtExtendedSize(),
                         $this->getFactChunkSize(),
                         $this->getDataOffset(),
                         $this->getDataSize(),
                         $this->getAudioFormat() == self::WAVE_FORMAT_PCM ? 'PCM' : ($this->getAudioFormat() == self::WAVE_FORMAT_IEEE_FLOAT ? 'IEEE FLOAT' : 'EXTENSIBLE'),
                         $this->getAudioSubFormat() == self::WAVE_SUBFORMAT_PCM ? 'PCM' : 'IEEE FLOAT',
                         $this->getNumChannels(),
                         dechex($this->getChannelMask()),
                         $this->getSampleRate(),
                         $this->getBitsPerSample(),
                         $this->getValidBitsPerSample(),
                         $this->getBlockAlign(),
                         $this->getNumBlocks(),
                         $this->getByteRate());
 
        if (php_sapi_name() == 'cli') {
            return $s;
        } else {
            return nl2br($s);
        }
    }

References getActualSize(), getAudioFormat(), getAudioSubFormat(), getBitsPerSample(), getBlockAlign(), getByteRate(), getChannelMask(), getChunkSize(), getDataOffset(), getDataSize(), getFactChunkSize(), getFmtChunkSize(), getFmtExtendedSize(), getNumBlocks(), getNumChannels(), getSampleRate(), and getValidBitsPerSample().

Here is the call graph for this function:

◆ filter()

WavFile::filter	(	$filters,
		$blockOffset = `0`,
		$numBlocks = `null`
	)

Run samples through audio processing filters.

$wav->filter( array( WavFile::FILTER_MIX => array( // Filter for mixing 2 WavFile instances. 'wav' => $wav2, // (Required) The WavFile to mix into this WhavFile. If no optional arguments are given, can be passed without the array. 'loop' => true, // (Optional) Loop the selected portion (with warping to the beginning at the end). 'blockOffset' => 0, // (Optional) Block number to start mixing from. 'numBlocks' => null // (Optional) Number of blocks to mix in or to select for looping. Defaults to the end or all data for looping. ), WavFile::FILTER_NORMALIZE => 0.6, // (Required) Normalization of (mixed) audio samples - see threshold parameter for normalizeSample(). WavFile::FILTER_DEGRADE => 0.9 // (Required) Introduce random noise. The quality relative to the amplitude. 1 = no noise, 0 = max. noise. ), 0, // (Optional) The block number of this WavFile to start with. null // (Optional) The number of blocks to process. );

Parameters

array	$filters	(Required) An array of 1 or more audio processing filters.
int	$blockOffset	(Optional) The block number to start precessing from.
int	$numBlocks	(Optional) The maximum number of blocks to process.

Exceptions

WavFileException

Definition at line 1571 of file WavFile.php.

    {
        // check preconditions
        $totalBlocks = $this->getNumBlocks();
        $numChannels = $this->getNumChannels();
        if (is_null($numBlocks)) $numBlocks = $totalBlocks - $blockOffset;
 
        if (!is_array($filters) || empty($filters) || $blockOffset < 0 || $blockOffset > $totalBlocks || $numBlocks <= 0) {
            // nothing to do
            return $this;
        }
 
        // check filtes
        $filter_mix = false;
        if (array_key_exists(self::FILTER_MIX, $filters)) {
            if (!is_array($filters[self::FILTER_MIX])) {
                // assume the 'wav' parameter
                $filters[self::FILTER_MIX] = array('wav' => $filters[self::FILTER_MIX]);
            }
 
            $mix_wav = @$filters[self::FILTER_MIX]['wav'];
            if (!($mix_wav instanceof WavFile)) {
                throw new WavFileException("WavFile to mix is missing or invalid.");
            } elseif ($mix_wav->getSampleRate() != $this->getSampleRate()) {
                throw new WavFileException("Sample rate of WavFile to mix does not match.");
            } else if ($mix_wav->getNumChannels() != $this->getNumChannels()) {
                throw new WavFileException("Number of channels of WavFile to mix does not match.");
            }
 
            $mix_loop = @$filters[self::FILTER_MIX]['loop'];
            if (is_null($mix_loop)) $mix_loop = false;
 
            $mix_blockOffset = @$filters[self::FILTER_MIX]['blockOffset'];
            if (is_null($mix_blockOffset)) $mix_blockOffset = 0;
 
            $mix_totalBlocks = $mix_wav->getNumBlocks();
            $mix_numBlocks = @$filters[self::FILTER_MIX]['numBlocks'];
            if (is_null($mix_numBlocks)) $mix_numBlocks = $mix_loop ? $mix_totalBlocks : $mix_totalBlocks - $mix_blockOffset;
            $mix_maxBlock = min($mix_blockOffset + $mix_numBlocks, $mix_totalBlocks);
 
            $filter_mix = true;
        }
 
        $filter_normalize = false;
        if (array_key_exists(self::FILTER_NORMALIZE, $filters)) {
            $normalize_threshold = @$filters[self::FILTER_NORMALIZE];
 
            if (!is_null($normalize_threshold) && abs($normalize_threshold) != 1) $filter_normalize = true;
        }
 
        $filter_degrade = false;
        if (array_key_exists(self::FILTER_DEGRADE, $filters)) {
            $degrade_quality = @$filters[self::FILTER_DEGRADE];
            if (is_null($degrade_quality)) $degrade_quality = 1;
 
            if ($degrade_quality >= 0 && $degrade_quality < 1) $filter_degrade = true;
        }
 
 
        // loop through all sample blocks
        for ($block = 0; $block < $numBlocks; ++$block) {
            // loop through all channels
            for ($channel = 1; $channel <= $numChannels; ++$channel) {
                // read current sample
                $currentBlock = $blockOffset + $block;
                $sampleFloat = $this->getSampleValue($currentBlock, $channel);
 
 
                /************* MIX FILTER ***********************/
                if ($filter_mix) {
                    if ($mix_loop) {
                        $mixBlock = ($mix_blockOffset + ($block % $mix_numBlocks)) % $mix_totalBlocks;
                    } else {
                        $mixBlock = $mix_blockOffset + $block;
                    }
 
                    if ($mixBlock < $mix_maxBlock) {
                        $sampleFloat += $mix_wav->getSampleValue($mixBlock, $channel);
                    }
                }
 
                /************* NORMALIZE FILTER *******************/
                if ($filter_normalize) {
                    $sampleFloat = $this->normalizeSample($sampleFloat, $normalize_threshold);
                }
 
                /************* DEGRADE FILTER *******************/
                if ($filter_degrade) {
                    $sampleFloat += rand(1000000 * ($degrade_quality - 1), 1000000 * (1 - $degrade_quality)) / 1000000;
                }
 
 
                // write current sample
                $this->setSampleValue($sampleFloat, $currentBlock, $channel);
            }
        }
 
        return $this;
    }

References FILTER_DEGRADE, FILTER_MIX, FILTER_NORMALIZE, getNumBlocks(), getNumChannels(), getSampleValue(), normalizeSample(), and setSampleValue().

Referenced by degrade(), and mergeWav().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ generateNoise()

WavFile::generateNoise	(	$duration = `1.0`,
		$percent = `100`
	)

Generate noise at the end of the wav for the specified duration and volume.

Parameters

float	$duration	(Optional) Number of seconds of noise to generate.
float	$percent	(Optional) The percentage of the maximum amplitude to use. 100 = full amplitude.

Definition at line 1749 of file WavFile.php.

    {
        $numChannels = $this->getNumChannels();
        $numSamples  = $this->getSampleRate() * $duration;
        $minAmp      = $this->getMinAmplitude();
        $maxAmp      = $this->getMaxAmplitude();
        $bitDepth    = $this->getBitsPerSample();
 
        for ($s = 0; $s < $numSamples; ++$s) {
            if ($bitDepth == 32) {
                $val = rand(-$percent * 10000, $percent * 10000) / 1000000;
            } else {
                $val = rand($minAmp, $maxAmp);
                $val = (int)($val * $percent / 100);
            }
 
            $this->_samples .= str_repeat(self::packSample($val, $bitDepth), $numChannels);
        }
 
        $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
 
        return $this;
    }

References getBitsPerSample(), getMaxAmplitude(), getMinAmplitude(), getNumChannels(), getSampleRate(), and setDataSize().

Here is the call graph for this function:

◆ getActualSize()

WavFile::getActualSize ( )

Definition at line 453 of file WavFile.php.

                                    {
        return $this->_actualSize;
    }

References $_actualSize.

Referenced by displayInfo().

Here is the caller graph for this function:

◆ getAudioFormat()

WavFile::getAudioFormat ( )

Definition at line 583 of file WavFile.php.

                                     {
        return $this->_audioFormat;
    }

References $_audioFormat.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getAudioSubFormat()

WavFile::getAudioSubFormat ( )

Definition at line 612 of file WavFile.php.

                                        {
        return $this->_audioSubFormat;
    }

References $_audioSubFormat.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getBitsPerSample()

WavFile::getBitsPerSample ( )

Definition at line 693 of file WavFile.php.

                                       {
        return $this->_bitsPerSample;
    }

References $_bitsPerSample.

Referenced by appendWav(), convertBitsPerSample(), displayInfo(), generateNoise(), insertSilence(), and makeHeader().

Here is the caller graph for this function:

◆ getBlockAlign()

WavFile::getBlockAlign ( )

Definition at line 732 of file WavFile.php.

                                    {
        return $this->_blockAlign;
    }

References $_blockAlign.

Referenced by displayInfo(), makeHeader(), and readWavData().

Here is the caller graph for this function:

◆ getByteRate()

WavFile::getByteRate ( )

Definition at line 763 of file WavFile.php.

                                  {
        return $this->_byteRate;
    }

References $_byteRate.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getChannelMask()

WavFile::getChannelMask ( )

Definition at line 650 of file WavFile.php.

                                     {
        return $this->_channelMask;
    }

References $_channelMask.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getChunkSize()

WavFile::getChunkSize ( )

Definition at line 467 of file WavFile.php.

                                   {
        return $this->_chunkSize;
    }

References $_chunkSize.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getDataOffset()

WavFile::getDataOffset ( )

Definition at line 565 of file WavFile.php.

                                    {
        return $this->_dataOffset;
    }

References $_dataOffset.

Referenced by displayInfo().

Here is the caller graph for this function:

◆ getDataSize()

WavFile::getDataSize ( )

Definition at line 547 of file WavFile.php.

                                  {
        return $this->_dataSize;
    }

References $_dataSize.

Referenced by displayInfo(), and getDataSubchunk().

Here is the caller graph for this function:

◆ getDataSubchunk()

WavFile::getDataSubchunk ( )

Construct wav DATA chunk.

Returns: string The DATA header and chunk.

Definition at line 884 of file WavFile.php.

    {
        // check preconditions
        if (!$this->_dataSize_valid) {
            $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
        }
 
 
        // create subchunk
        return pack('N', 0x64617461) .                    // SubchunkID - "data"
               pack('V', $this->getDataSize()) .          // SubchunkSize
               $this->_samples .                          // Subchunk data
               ($this->getDataSize() & 1 ? chr(0) : '');  // padding byte
    }

References getDataSize(), and setDataSize().

Referenced by __toString(), and save().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFactChunkSize()

WavFile::getFactChunkSize ( )

Definition at line 526 of file WavFile.php.

                                       {
        return $this->_factChunkSize;
    }

References $_factChunkSize.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getFmtChunkSize()

WavFile::getFmtChunkSize ( )

Definition at line 487 of file WavFile.php.

                                      {
        return $this->_fmtChunkSize;
    }

References $_fmtChunkSize.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getFmtExtendedSize()

WavFile::getFmtExtendedSize ( )

Definition at line 504 of file WavFile.php.

                                         {
        return $this->_fmtExtendedSize;
    }

References $_fmtExtendedSize.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getMaxAmplitude()

WavFile::getMaxAmplitude ( )

Definition at line 819 of file WavFile.php.

    {
        if($this->_bitsPerSample == 8) {
            return 0xFF;
        } elseif($this->_bitsPerSample == 32) {
            return 1.0;
        } else {
            return (1 << ($this->_bitsPerSample - 1)) - 1;
        }
    }

Referenced by generateNoise().

Here is the caller graph for this function:

◆ getMinAmplitude()

WavFile::getMinAmplitude ( )

Definition at line 797 of file WavFile.php.

    {
        if ($this->_bitsPerSample == 8) {
            return 0;
        } elseif ($this->_bitsPerSample == 32) {
            return -1.0;
        } else {
            return -(1 << ($this->_bitsPerSample - 1));
        }
    }

Referenced by generateNoise().

Here is the caller graph for this function:

◆ getNumBlocks()

WavFile::getNumBlocks ( )

Definition at line 748 of file WavFile.php.

    {
        return $this->_numBlocks;
    }

References $_numBlocks.

Referenced by convertBitsPerSample(), displayInfo(), filter(), and makeHeader().

Here is the caller graph for this function:

◆ getNumChannels()

WavFile::getNumChannels ( )

Definition at line 630 of file WavFile.php.

                                     {
        return $this->_numChannels;
    }

References $_numChannels.

Referenced by appendWav(), convertBitsPerSample(), displayInfo(), filter(), generateNoise(), insertSilence(), and makeHeader().

Here is the caller graph for this function:

◆ getSampleBlock()

WavFile::getSampleBlock ( $blockNum )

Return a single sample block from the file.

Parameters

int $blockNum (Required) The sample block number. Zero based.

Returns: string The binary sample block (all channels). Returns null if the sample block number was out of range.

Definition at line 1319 of file WavFile.php.

    {
        // check preconditions
        if (!$this->_dataSize_valid) {
            $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
        }
 
        $offset = $blockNum * $this->_blockAlign;
        if ($offset + $this->_blockAlign > $this->_dataSize || $offset < 0) {
            return null;
        }
 
 
        // read data
        return substr($this->_samples, $offset, $this->_blockAlign);
    }

References $_blockAlign, and setDataSize().

Here is the call graph for this function:

◆ getSampleRate()

WavFile::getSampleRate ( )

Definition at line 675 of file WavFile.php.

                                    {
        return $this->_sampleRate;
    }

References $_sampleRate.

Referenced by appendWav(), convertBitsPerSample(), displayInfo(), generateNoise(), insertSilence(), and makeHeader().

Here is the caller graph for this function:

◆ getSamples()

WavFile::getSamples ( )

Definition at line 777 of file WavFile.php.

                                 {
        return $this->_samples;
    }

References $_samples.

◆ getSampleValue()

WavFile::getSampleValue	(	$blockNum,
		$channelNum
	)

Get a float sample value for a specific sample block and channel number.

Parameters

int	$blockNum	(Required) The sample block number to fetch. Zero based.
int	$channelNum	(Required) The channel number within the sample block to fetch. First channel is 1.

Returns: float The float sample value. Returns null if the sample block number was out of range.

Exceptions

WavFileException

Definition at line 1389 of file WavFile.php.

    {
        // check preconditions
        if ($channelNum < 1 || $channelNum > $this->_numChannels) {
            throw new WavFileException('Channel number is out of range.');
        }
 
        if (!$this->_dataSize_valid) {
            $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
        }
 
        $sampleBytes = $this->_bitsPerSample / 8;
        $offset = $blockNum * $this->_blockAlign + ($channelNum - 1) * $sampleBytes;
        if ($offset + $sampleBytes > $this->_dataSize || $offset < 0) {
            return null;
        }
 
        // read binary value
        $sampleBinary = substr($this->_samples, $offset, $sampleBytes);
 
        // convert binary to value
        switch ($this->_bitsPerSample) {
            case 8:
                // unsigned char
                return (float)((ord($sampleBinary) - 0x80) / 0x80);
 
            case 16:
                // signed short, little endian
                $data = unpack('v', $sampleBinary);
                $sample = $data[1];
                if ($sample >= 0x8000) {
                    $sample -= 0x10000;
                }
                return (float)($sample / 0x8000);
 
            case 24:
                // 3 byte packed signed integer, little endian
                $data = unpack('C3', $sampleBinary);
                $sample = $data[1] | ($data[2] << 8) | ($data[3] << 16);
                if ($sample >= 0x800000) {
                    $sample -= 0x1000000;
                }
                return (float)($sample / 0x800000);
 
            case 32:
                // 32-bit float
                $data = unpack('f', $sampleBinary);
                return (float)$data[1];
 
            default:
                return null;
        }
    }

References $data, and setDataSize().

Referenced by filter().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getValidBitsPerSample()

WavFile::getValidBitsPerSample ( )

Definition at line 713 of file WavFile.php.

                                            {
        return $this->_validBitsPerSample;
    }

References $_validBitsPerSample.

Referenced by displayInfo(), and makeHeader().

Here is the caller graph for this function:

◆ getZeroAmplitude()

WavFile::getZeroAmplitude ( )

Definition at line 808 of file WavFile.php.

    {
        if ($this->_bitsPerSample == 8) {
            return 0x80;
        } elseif ($this->_bitsPerSample == 32) {
            return 0.0;
        } else {
            return 0;
        }
    }

Referenced by insertSilence().

Here is the caller graph for this function:

◆ insertSilence()

WavFile::insertSilence ( $duration = 1.0 )

Add silence to the wav file.

Parameters

float $duration (Optional) How many seconds of silence. If negative, add to the beginning of the file. Defaults to 1s.

Definition at line 1714 of file WavFile.php.

    {
        $numSamples  = (int)($this->getSampleRate() * abs($duration));
        $numChannels = $this->getNumChannels();
 
        $data = str_repeat(self::packSample($this->getZeroAmplitude(), $this->getBitsPerSample()), $numSamples * $numChannels);
        if ($duration >= 0) {
            $this->_samples .= $data;
        } else {
            $this->_samples = $data . $this->_samples;
        }
 
        $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
 
        return $this;
    }

References $_samples, $data, getBitsPerSample(), getNumChannels(), getSampleRate(), getZeroAmplitude(), and setDataSize().

Here is the call graph for this function:

◆ makeHeader()

WavFile::makeHeader ( )

Construct a wav header from this object.

Includes "fact" chunk in necessary. http://www-mmsp.ece.mcgill.ca/documents/audioformats/wave/wave.html

Returns: string The RIFF header data.

Definition at line 840 of file WavFile.php.

    {
        // reset and recalculate
        $this->setAudioFormat();                                    // implicit setAudioSubFormat(), setFactChunkSize(), setFmtExtendedSize(), setFmtChunkSize(), setSize(), setActualSize(), setDataOffset()
        $this->setNumBlocks();
 
        // RIFF header
        $header = pack('N', 0x52494646);                            // ChunkID - "RIFF"
        $header .= pack('V', $this->getChunkSize());                // ChunkSize
        $header .= pack('N', 0x57415645);                           // Format - "WAVE"
 
        // "fmt " subchunk
        $header .= pack('N', 0x666d7420);                           // SubchunkID - "fmt "
        $header .= pack('V', $this->getFmtChunkSize());             // SubchunkSize
        $header .= pack('v', $this->getAudioFormat());              // AudioFormat
        $header .= pack('v', $this->getNumChannels());              // NumChannels
        $header .= pack('V', $this->getSampleRate());               // SampleRate
        $header .= pack('V', $this->getByteRate());                 // ByteRate
        $header .= pack('v', $this->getBlockAlign());               // BlockAlign
        $header .= pack('v', $this->getBitsPerSample());            // BitsPerSample
        if($this->getFmtExtendedSize() == 24) {
            $header .= pack('v', 22);                               // extension size = 24 bytes, cbSize: 24 - 2 = 22 bytes
            $header .= pack('v', $this->getValidBitsPerSample());   // ValidBitsPerSample
            $header .= pack('V', $this->getChannelMask());          // ChannelMask
            $header .= pack('H32', $this->getAudioSubFormat());     // SubFormat
        } elseif ($this->getFmtExtendedSize() == 2) {
            $header .= pack('v', 0);                                // extension size = 2 bytes, cbSize: 2 - 2 = 0 bytes
        }
 
        // "fact" subchunk
        if ($this->getFactChunkSize() == 4) {
            $header .= pack('N', 0x66616374);                       // SubchunkID - "fact"
            $header .= pack('V', 4);                                // SubchunkSize
            $header .= pack('V', $this->getNumBlocks());            // SampleLength (per channel)
        }
 
        return $header;
    }

References $header, getAudioFormat(), getAudioSubFormat(), getBitsPerSample(), getBlockAlign(), getByteRate(), getChannelMask(), getChunkSize(), getFactChunkSize(), getFmtChunkSize(), getFmtExtendedSize(), getNumBlocks(), getNumChannels(), getSampleRate(), getValidBitsPerSample(), setAudioFormat(), and setNumBlocks().

Referenced by __toString(), and save().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ mergeWav()

WavFile::mergeWav	(	WavFile	$wav,
			$normalizeThreshold = `null`
	)

Mix 2 wav files together.

Both wavs must have the same sample rate and same number of channels.

Parameters

WavFile	$wav	(Required) The WavFile to mix.
float	$normalizeThreshold	(Optional) See normalizeSample for an explanation.

Exceptions

WavFileException

Definition at line 1702 of file WavFile.php.

                                                                       {
        return $this->filter(array(
            WavFile::FILTER_MIX       => $wav,
            WavFile::FILTER_NORMALIZE => $normalizeThreshold
        ));
    }

References filter(), FILTER_MIX, and FILTER_NORMALIZE.

Here is the call graph for this function:

◆ normalizeSample()

static WavFile::normalizeSample	(	$sampleFloat,
		$threshold
	)

static

Normalizes a float audio sample.

Maximum input range assumed for compression is [-2, 2]. See http://www.voegler.eu/pub/audio/ for more information.

Parameters

float	$sampleFloat	(Required) The float sample to normalize.
float	$threshold	(Required) The threshold or gain factor for normalizing the amplitude. >= 1 - Normalize by multiplying by the threshold (boost - positive gain). A value of 1 in effect means no normalization (and results in clipping). <= -1 - Normalize by dividing by the the absolute value of threshold (attenuate - negative gain). A factor of 2 (-2) is about 6dB reduction in volume. [0, 1) - (open inverval - not including 1) - The threshold above which amplitudes are comressed logarithmically. e.g. 0.6 to leave amplitudes up to 60% "as is" and compress above. (-1, 0) - (open inverval - not including -1 and 0) - The threshold above which amplitudes are comressed linearly. e.g. -0.6 to leave amplitudes up to 60% "as is" and compress above.

Returns: float The normalized sample.

Definition at line 419 of file WavFile.php.

                                                                     {
        // apply positive gain
        if ($threshold >= 1) {
            return $sampleFloat * $threshold;
        }
 
        // apply negative gain
        if ($threshold <= -1) {
            return $sampleFloat / -$threshold;
        }
 
        $sign = $sampleFloat < 0 ? -1 : 1;
        $sampleAbs = abs($sampleFloat);
 
        // logarithmic compression
        if ($threshold >= 0 && $threshold < 1 && $sampleAbs > $threshold) {
            $loga = self::$LOOKUP_LOGBASE[(int)($threshold * 20)]; // log base modifier
            return $sign * ($threshold + (1 - $threshold) * log(1 + $loga * ($sampleAbs - $threshold) / (2 - $threshold)) / log(1 + $loga));
        }
 
        // linear compression
        $thresholdAbs = abs($threshold);
        if ($threshold > -1 && $threshold < 0 && $sampleAbs > $thresholdAbs) {
            return $sign * ($thresholdAbs + (1 - $thresholdAbs) / (2 - $thresholdAbs) * ($sampleAbs - $thresholdAbs));
        }
 
        // else ?
        return $sampleFloat;
    }

Referenced by filter().

Here is the caller graph for this function:

◆ openWav()

WavFile::openWav	(	$filename,
		$readData = `true`
	)

Reads a wav header and data from a file.

Parameters

string	$filename	(Required) The path to the wav file to read.
bool	$readData	(Optional) If true, also read the data chunk.

Exceptions

WavFormatException
WavFileException

Definition at line 927 of file WavFile.php.

    {
        // check preconditions
        if (!file_exists($filename)) {
            throw new WavFileException('Failed to open "' . $filename . '". File not found.');
        } elseif (!is_readable($filename)) {
            throw new WavFileException('Failed to open "' . $filename . '". File is not readable.');
        } elseif (is_resource($this->_fp)) {
            $this->closeWav();
        }
 
 
        // open the file
        $this->_fp = @fopen($filename, 'rb');
        if (!is_resource($this->_fp)) {
            throw new WavFileException('Failed to open "' . $filename . '".');
        }
 
        // read the file
        return $this->readWav($readData);
    }

References $filename, closeWav(), and readWav().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ packSample()

static WavFile::packSample	(	$sample,
		$bitDepth
	)

static

Packs a single numeric sample to binary.

Parameters

int \| float	$sample	(Required) The sample to encode. Has to be within valid range for $bitDepth. Float values only for 32 bits.
int	$bitDepth	(Required) The bits per sample to encode with.

Returns: string The encoded binary sample. Returns null for unsupported bit depths.

Definition at line 332 of file WavFile.php.

    {
        switch ($bitDepth) {
            case 8:
                // unsigned char
                return chr($sample);
 
            case 16:
                // signed short, little endian
                if ($sample < 0) {
                    $sample += 0x10000;
                }
                return pack('v', $sample);
 
            case 24:
                // 3 byte packed signed integer, little endian
                if ($sample < 0) {
                    $sample += 0x1000000;
                }
                return pack('C3', $sample & 0xff, ($sample >>  8) & 0xff, ($sample >> 16) & 0xff);
 
            case 32:
                // 32-bit float
                return pack('f', $sample);
 
            default:
                return null;
        }
    }

Referenced by packSampleBlock().

Here is the caller graph for this function:

◆ packSampleBlock()

static WavFile::packSampleBlock	(	$samples,
		$bitDepth
	)

static

Packs an array of numeric channel samples to a binary sample block.

Parameters

array	$samples	(Required) The array of channel sample values. Expects float values for 32 bits and integer otherwise.
int	$bitDepth	(Required) The bits per sample to encode with.

Returns: string The encoded binary sample block.

Definition at line 392 of file WavFile.php.

                                                                {
        $sampleBlock = '';
        foreach($samples as $sample) {
            $sampleBlock .= self::packSample($sample, $bitDepth);
        }
 
        return $sampleBlock;
    }

References packSample().

Here is the call graph for this function:

◆ readWav()

WavFile::readWav ( $readData = true )

protected

Read wav file from a stream.

Parameters

$readData (Optional) If true, also read the data chunk.

Exceptions

WavFormatException
WavFileException

Definition at line 997 of file WavFile.php.

    {
        if (!is_resource($this->_fp)) {
            throw new WavFileException('No wav file open. Use openWav() first.');
        }
 
        try {
            $this->readWavHeader();
        } catch (WavFileException $ex) {
            $this->closeWav();
            throw $ex;
        }
 
        if ($readData) return $this->readWavData();
 
        return $this;
    }

References closeWav(), readWavData(), and readWavHeader().

Referenced by openWav(), and setWavData().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ readWavData()

WavFile::readWavData	(	$dataOffset = `0`,
		$dataSize = `null`
	)

Read the wav data from the file into the buffer.

Parameters

$dataOffset	(Optional) The byte offset to skip before starting to read. Must be a multiple of BlockAlign.
$dataSize	(Optional) The size of the data to read in bytes. Must be a multiple of BlockAlign. Defaults to all data.

Exceptions

WavFileException

Definition at line 1278 of file WavFile.php.

    {
        // check preconditions
        if (!is_resource($this->_fp)) {
            throw new WavFileException('No wav file open. Use openWav() first.');
        }
 
        if ($dataOffset < 0 || $dataOffset % $this->getBlockAlign() > 0) {
            throw new WavFileException('Invalid data offset. Has to be a multiple of BlockAlign.');
        }
 
        if (is_null($dataSize)) {
            $dataSize = $this->_dataSize_fp - ($this->_dataSize_fp % $this->getBlockAlign());  // only read complete blocks
        } elseif ($dataSize < 0 || $dataSize % $this->getBlockAlign() > 0) {
            throw new WavFileException('Invalid data size to read. Has to be a multiple of BlockAlign.');
        }
 
 
        // skip offset
        if ($dataOffset > 0 && fseek($this->_fp, $dataOffset, SEEK_CUR) !== 0) {
            throw new WavFileException('Seeking to data offset failed.');
        }
 
        // read data
        $this->_samples .= fread($this->_fp, $dataSize);  // allow appending
        $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
 
        // close file or memory stream
        return $this->closeWav();
    }

References closeWav(), getBlockAlign(), and setDataSize().

Referenced by readWav().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ readWavHeader()

WavFile::readWavHeader ( )

protected

Parse a wav header.

http://www-mmsp.ece.mcgill.ca/documents/audioformats/wave/wave.html

Exceptions

WavFormatException
WavFileException

Definition at line 1022 of file WavFile.php.

    {
        if (!is_resource($this->_fp)) {
            throw new WavFileException('No wav file open. Use openWav() first.');
        }
 
        // get actual file size
        $stat = fstat($this->_fp);
        $actualSize = $stat['size'];
 
        $this->_actualSize = $actualSize;
 
 
        // read the common header
        $header = fread($this->_fp, 36);  // minimum size of the wav header
        if (strlen($header) < 36) {
            throw new WavFormatException('Not wav format. Header too short.', 1);
        }
 
 
        // check "RIFF" header
        $RIFF = unpack('NChunkID/VChunkSize/NFormat', $header);
 
        if ($RIFF['ChunkID'] != 0x52494646) {  // "RIFF"
            throw new WavFormatException('Not wav format. "RIFF" signature missing.', 2);
        }
 
        if ($actualSize - 8 < $RIFF['ChunkSize']) {
            trigger_error('"RIFF" chunk size does not match actual file size. Found ' . $RIFF['ChunkSize'] . ', expected ' . ($actualSize - 8) . '.', E_USER_NOTICE);
            $RIFF['ChunkSize'] = $actualSize - 8;
            //throw new WavFormatException('"RIFF" chunk size does not match actual file size. Found ' . $RIFF['ChunkSize'] . ', expected ' . ($actualSize - 8) . '.', 3);
        }
 
        if ($RIFF['Format'] != 0x57415645) {  // "WAVE"
            throw new WavFormatException('Not wav format. "RIFF" chunk format is not "WAVE".', 4);
        }
 
        $this->_chunkSize = $RIFF['ChunkSize'];
 
 
        // check common "fmt " subchunk
        $fmt = unpack('NSubchunkID/VSubchunkSize/vAudioFormat/vNumChannels/'
                     .'VSampleRate/VByteRate/vBlockAlign/vBitsPerSample',
                     substr($header, 12));
 
        if ($fmt['SubchunkID'] != 0x666d7420) {  // "fmt "
            throw new WavFormatException('Bad wav header. Expected "fmt " subchunk.', 11);
        }
 
        if ($fmt['SubchunkSize'] < 16) {
            throw new WavFormatException('Bad "fmt " subchunk size.', 12);
        }
 
        if (   $fmt['AudioFormat'] != self::WAVE_FORMAT_PCM
            && $fmt['AudioFormat'] != self::WAVE_FORMAT_IEEE_FLOAT
            && $fmt['AudioFormat'] != self::WAVE_FORMAT_EXTENSIBLE)
        {
            throw new WavFormatException('Unsupported audio format. Only PCM or IEEE FLOAT (EXTENSIBLE) audio is supported.', 13);
        }
 
        if ($fmt['NumChannels'] < 1 || $fmt['NumChannels'] > self::MAX_CHANNEL) {
            throw new WavFormatException('Invalid number of channels in "fmt " subchunk.', 14);
        }
 
        if ($fmt['SampleRate'] < 1 || $fmt['SampleRate'] > self::MAX_SAMPLERATE) {
            throw new WavFormatException('Invalid sample rate in "fmt " subchunk.', 15);
        }
 
        if (   ($fmt['AudioFormat'] == self::WAVE_FORMAT_PCM && !in_array($fmt['BitsPerSample'], array(8, 16, 24)))
            || ($fmt['AudioFormat'] == self::WAVE_FORMAT_IEEE_FLOAT && $fmt['BitsPerSample'] != 32)
            || ($fmt['AudioFormat'] == self::WAVE_FORMAT_EXTENSIBLE && !in_array($fmt['BitsPerSample'], array(8, 16, 24, 32))))
        {
            throw new WavFormatException('Only 8, 16 and 24-bit PCM and 32-bit IEEE FLOAT (EXTENSIBLE) audio is supported.', 16);
        }
 
        $blockAlign = $fmt['NumChannels'] * $fmt['BitsPerSample'] / 8;
        if ($blockAlign != $fmt['BlockAlign']) {
            trigger_error('Invalid block align in "fmt " subchunk. Found ' . $fmt['BlockAlign'] . ', expected ' . $blockAlign . '.', E_USER_NOTICE);
            $fmt['BlockAlign'] = $blockAlign;
            //throw new WavFormatException('Invalid block align in "fmt " subchunk. Found ' . $fmt['BlockAlign'] . ', expected ' . $blockAlign . '.', 17);
        }
 
        $byteRate = $fmt['SampleRate'] * $blockAlign;
        if ($byteRate != $fmt['ByteRate']) {
            trigger_error('Invalid average byte rate in "fmt " subchunk. Found ' . $fmt['ByteRate'] . ', expected ' . $byteRate . '.', E_USER_NOTICE);
            $fmt['ByteRate'] = $byteRate;
            //throw new WavFormatException('Invalid average byte rate in "fmt " subchunk. Found ' . $fmt['ByteRate'] . ', expected ' . $byteRate . '.', 18);
        }
 
        $this->_fmtChunkSize  = $fmt['SubchunkSize'];
        $this->_audioFormat   = $fmt['AudioFormat'];
        $this->_numChannels   = $fmt['NumChannels'];
        $this->_sampleRate    = $fmt['SampleRate'];
        $this->_byteRate      = $fmt['ByteRate'];
        $this->_blockAlign    = $fmt['BlockAlign'];
        $this->_bitsPerSample = $fmt['BitsPerSample'];
 
 
        // read extended "fmt " subchunk data
        $extendedFmt = '';
        if ($fmt['SubchunkSize'] > 16) {
            // possibly handle malformed subchunk without a padding byte
            $extendedFmt = fread($this->_fp, $fmt['SubchunkSize'] - 16 + ($fmt['SubchunkSize'] & 1));  // also read padding byte
            if (strlen($extendedFmt) < $fmt['SubchunkSize'] - 16) {
                throw new WavFormatException('Not wav format. Header too short.', 1);
            }
        }
 
 
        // check extended "fmt " for EXTENSIBLE Audio Format
        if ($fmt['AudioFormat'] == self::WAVE_FORMAT_EXTENSIBLE) {
            if (strlen($extendedFmt) < 24) {
                throw new WavFormatException('Invalid EXTENSIBLE "fmt " subchunk size. Found ' . $fmt['SubchunkSize'] . ', expected at least 40.', 19);
            }
 
            $extensibleFmt = unpack('vSize/vValidBitsPerSample/VChannelMask/H32SubFormat', substr($extendedFmt, 0, 24));
 
            if (   $extensibleFmt['SubFormat'] != self::WAVE_SUBFORMAT_PCM
                && $extensibleFmt['SubFormat'] != self::WAVE_SUBFORMAT_IEEE_FLOAT)
            {
                throw new WavFormatException('Unsupported audio format. Only PCM or IEEE FLOAT (EXTENSIBLE) audio is supported.', 13);
            }
 
            if (   ($extensibleFmt['SubFormat'] == self::WAVE_SUBFORMAT_PCM && !in_array($fmt['BitsPerSample'], array(8, 16, 24)))
                || ($extensibleFmt['SubFormat'] == self::WAVE_SUBFORMAT_IEEE_FLOAT && $fmt['BitsPerSample'] != 32))
            {
                throw new WavFormatException('Only 8, 16 and 24-bit PCM and 32-bit IEEE FLOAT (EXTENSIBLE) audio is supported.', 16);
            }
 
            if ($extensibleFmt['Size'] != 22) {
                trigger_error('Invaid extension size in EXTENSIBLE "fmt " subchunk.', E_USER_NOTICE);
                $extensibleFmt['Size'] = 22;
                //throw new WavFormatException('Invaid extension size in EXTENSIBLE "fmt " subchunk.', 20);
            }
 
            if ($extensibleFmt['ValidBitsPerSample'] != $fmt['BitsPerSample']) {
                trigger_error('Invaid or unsupported valid bits per sample in EXTENSIBLE "fmt " subchunk.', E_USER_NOTICE);
                $extensibleFmt['ValidBitsPerSample'] = $fmt['BitsPerSample'];
                //throw new WavFormatException('Invaid or unsupported valid bits per sample in EXTENSIBLE "fmt " subchunk.', 21);
            }
 
            if ($extensibleFmt['ChannelMask'] != 0) {
                // count number of set bits - Hamming weight
                $c = (int)$extensibleFmt['ChannelMask'];
                $n = 0;
                while ($c > 0) {
                    $n += $c & 1;
                    $c >>= 1;
                }
                if ($n != $fmt['NumChannels'] || (((int)$extensibleFmt['ChannelMask'] | self::SPEAKER_ALL) != self::SPEAKER_ALL)) {
                    trigger_error('Invalid channel mask in EXTENSIBLE "fmt " subchunk. The number of channels does not match the number of locations in the mask.', E_USER_NOTICE);
                    $extensibleFmt['ChannelMask'] = 0;
                    //throw new WavFormatException('Invalid channel mask in EXTENSIBLE "fmt " subchunk. The number of channels does not match the number of locations in the mask.', 22);
                }
            }
 
            $this->_fmtExtendedSize    = strlen($extendedFmt);
            $this->_validBitsPerSample = $extensibleFmt['ValidBitsPerSample'];
            $this->_channelMask        = $extensibleFmt['ChannelMask'];
            $this->_audioSubFormat     = $extensibleFmt['SubFormat'];
 
        } else {
            $this->_fmtExtendedSize    = strlen($extendedFmt);
            $this->_validBitsPerSample = $fmt['BitsPerSample'];
            $this->_channelMask        = 0;
            $this->_audioSubFormat     = null;
        }
 
 
        // read additional subchunks until "data" subchunk is found
        $factSubchunk = array();
        $dataSubchunk = array();
 
        while (!feof($this->_fp)) {
            $subchunkHeader = fread($this->_fp, 8);
            if (strlen($subchunkHeader) < 8) {
                throw new WavFormatException('Missing "data" subchunk.', 101);
            }
 
            $subchunk = unpack('NSubchunkID/VSubchunkSize', $subchunkHeader);
 
            if ($subchunk['SubchunkID'] == 0x66616374) {        // "fact"
                // possibly handle malformed subchunk without a padding byte
                $subchunkData = fread($this->_fp, $subchunk['SubchunkSize'] + ($subchunk['SubchunkSize'] & 1));  // also read padding byte
                if (strlen($subchunkData) < 4) {
                    throw new WavFormatException('Invalid "fact" subchunk.', 102);
                }
 
                $factParams = unpack('VSampleLength', substr($subchunkData, 0, 4));
                $factSubchunk = array_merge($subchunk, $factParams);
 
            } elseif ($subchunk['SubchunkID'] == 0x64617461) {  // "data"
                $dataSubchunk = $subchunk;
 
                break;
 
            } elseif ($subchunk['SubchunkID'] == 0x7761766C) {  // "wavl"
                throw new WavFormatException('Wave List Chunk ("wavl" subchunk) is not supported.', 106);
            } else {
                // skip all other (unknown) subchunks
                // possibly handle malformed subchunk without a padding byte
                if ( $subchunk['SubchunkSize'] < 0
                  || fseek($this->_fp, $subchunk['SubchunkSize'] + ($subchunk['SubchunkSize'] & 1), SEEK_CUR) !== 0) {  // also skip padding byte
                    throw new WavFormatException('Invalid subchunk (0x' . dechex($subchunk['SubchunkID']) . ') encountered.', 103);
                }
            }
        }
 
        if (empty($dataSubchunk)) {
            throw new WavFormatException('Missing "data" subchunk.', 101);
        }
 
 
        // check "data" subchunk
        $dataOffset = ftell($this->_fp);
        if ($dataSubchunk['SubchunkSize'] < 0 || $actualSize - $dataOffset < $dataSubchunk['SubchunkSize']) {
            trigger_error('Invalid "data" subchunk size.', E_USER_NOTICE);
            $dataSubchunk['SubchunkSize'] = $actualSize - $dataOffset;
            //throw new WavFormatException('Invalid "data" subchunk size.', 104);
        }
 
        $this->_dataOffset     = $dataOffset;
        $this->_dataSize       = $dataSubchunk['SubchunkSize'];
        $this->_dataSize_fp    = $dataSubchunk['SubchunkSize'];
        $this->_dataSize_valid = false;
        $this->_samples        = '';
 
 
        // check "fact" subchunk
        $numBlocks = (int)($dataSubchunk['SubchunkSize'] / $fmt['BlockAlign']);
 
        if (empty($factSubchunk)) {  // construct fake "fact" subchunk
            $factSubchunk = array('SubchunkSize' => 0, 'SampleLength' => $numBlocks);
        }
 
        if ($factSubchunk['SampleLength'] != $numBlocks) {
            trigger_error('Invalid sample length in "fact" subchunk.', E_USER_NOTICE);
            $factSubchunk['SampleLength'] = $numBlocks;
            //throw new WavFormatException('Invalid sample length in "fact" subchunk.', 105);
        }
 
        $this->_factChunkSize = $factSubchunk['SubchunkSize'];
        $this->_numBlocks     = $factSubchunk['SampleLength'];
 
 
        return $this;
 
    }

References $header, and $n.

Referenced by readWav().

Here is the caller graph for this function:

◆ save()

WavFile::save ( $filename )

Save the wav data to a file.

Parameters

string $filename (Required) The file path to save the wav to.

Exceptions

WavFileException

Definition at line 905 of file WavFile.php.

    {
        $fp = @fopen($filename, 'w+b');
        if (!is_resource($fp)) {
            throw new WavFileException('Failed to open "' . $filename . '" for writing.');
        }
 
        fwrite($fp, $this->makeHeader());
        fwrite($fp, $this->getDataSubchunk());
        fclose($fp);
 
        return $this;
    }

References $filename, getDataSubchunk(), and makeHeader().

Here is the call graph for this function:

◆ setActualSize()

WavFile::setActualSize ( $actualSize = null )

protected

Definition at line 457 of file WavFile.php.

                                                         {
        if (is_null($actualSize)) {
            $this->_actualSize = 8 + $this->_chunkSize;  // + "RIFF" header (ID + size)
        } else {
            $this->_actualSize = $actualSize;
        }
 
        return $this;
    }

References $_chunkSize.

Referenced by setChunkSize().

Here is the caller graph for this function:

◆ setAudioFormat()

WavFile::setAudioFormat ( $audioFormat = null )

protected

Definition at line 587 of file WavFile.php.

                                                           {
        if (is_null($audioFormat)) {
            if (($this->_bitsPerSample <= 16 || $this->_bitsPerSample == 32)
              && $this->_validBitsPerSample == $this->_bitsPerSample
              && $this->_channelMask == self::SPEAKER_DEFAULT
              && $this->_numChannels <= 2) {
                if ($this->_bitsPerSample <= 16) {
                    $this->_audioFormat = self::WAVE_FORMAT_PCM;
                } else {
                    $this->_audioFormat = self::WAVE_FORMAT_IEEE_FLOAT;
                }
            } else {
                $this->_audioFormat = self::WAVE_FORMAT_EXTENSIBLE;
            }
        } else {
            $this->_audioFormat = $audioFormat;
        }
 
        $this->setAudioSubFormat()
             ->setFactChunkSize()     // implicit setSize(), setActualSize(), setDataOffset()
             ->setFmtExtendedSize();  // implicit setFmtChunkSize(), setSize(), setActualSize(), setDataOffset()
 
        return $this;
    }

References setAudioSubFormat(), WAVE_FORMAT_EXTENSIBLE, WAVE_FORMAT_IEEE_FLOAT, and WAVE_FORMAT_PCM.

Referenced by makeHeader(), setChannelMask(), setNumChannels(), and setValidBitsPerSample().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAudioSubFormat()

WavFile::setAudioSubFormat ( $audioSubFormat = null )

protected

Definition at line 616 of file WavFile.php.

                                                                 {
        if (is_null($audioSubFormat)) {
            if ($this->_bitsPerSample == 32) {
                $this->_audioSubFormat = self::WAVE_SUBFORMAT_IEEE_FLOAT;  // 32 bits are IEEE FLOAT in this class
            } else {
                $this->_audioSubFormat = self::WAVE_SUBFORMAT_PCM;         // 8, 16 and 24 bits are PCM in this class
            }
        } else {
            $this->_audioSubFormat = $audioSubFormat;
        }
 
        return $this;
    }

References WAVE_SUBFORMAT_IEEE_FLOAT, and WAVE_SUBFORMAT_PCM.

Referenced by setAudioFormat().

Here is the caller graph for this function:

◆ setBitsPerSample()

WavFile::setBitsPerSample ( $bitsPerSample )

Definition at line 697 of file WavFile.php.

                                                     {
        if (!in_array($bitsPerSample, array(8, 16, 24, 32))) {
            throw new WavFileException('Unsupported bits per sample. Only 8, 16, 24 and 32 bits are supported.');
        } elseif ($this->_samples !== '') {
            trigger_error('Wav already has sample data. Changing the bits per sample does not convert and may corrupt the data.', E_USER_NOTICE);
        }
 
        $this->_bitsPerSample = (int)$bitsPerSample;
 
        $this->setValidBitsPerSample()  // implicit setAudioFormat(), setAudioSubFormat(), setFmtChunkSize(), setFactChunkSize(), setSize(), setActualSize(), setDataOffset()
             ->setByteRate()
             ->setBlockAlign();         // implicit setNumBlocks()
 
        return $this;
    }

References setValidBitsPerSample().

Here is the call graph for this function:

◆ setBlockAlign()

WavFile::setBlockAlign ( $blockAlign = null )

protected

Definition at line 736 of file WavFile.php.

                                                         {
        if (is_null($blockAlign)) {
            $this->_blockAlign = $this->_numChannels * $this->_bitsPerSample / 8;
        } else {
            $this->_blockAlign = $blockAlign;
        }
 
        $this->setNumBlocks();
 
        return $this;
    }

References setNumBlocks().

Here is the call graph for this function:

◆ setByteRate()

WavFile::setByteRate ( $byteRate = null )

protected

Definition at line 767 of file WavFile.php.

                                                     {
        if (is_null($byteRate)) {
            $this->_byteRate = $this->_sampleRate * $this->_numChannels * $this->_bitsPerSample / 8;
        } else {
            $this->_byteRate = $byteRate;
        }
 
        return $this;
    }

Referenced by setSampleRate().

Here is the caller graph for this function:

◆ setChannelMask()

WavFile::setChannelMask ( $channelMask = self::SPEAKER_DEFAULT )

Definition at line 654 of file WavFile.php.

                                                                       {
        if ($channelMask != 0) {
            // count number of set bits - Hamming weight
            $c = (int)$channelMask;
            $n = 0;
            while ($c > 0) {
                $n += $c & 1;
                $c >>= 1;
            }
            if ($n != $this->_numChannels || (((int)$channelMask | self::SPEAKER_ALL) != self::SPEAKER_ALL)) {
                throw new WavFileException('Invalid channel mask. The number of channels does not match the number of locations in the mask.');
            }
        }
 
        $this->_channelMask = (int)$channelMask;
 
        $this->setAudioFormat();  // implicit setAudioSubFormat(), setFactChunkSize(), setFmtExtendedSize(), setFmtChunkSize(), setSize(), setActualSize(), setDataOffset()
 
        return $this;
    }

References $n, and setAudioFormat().

Here is the call graph for this function:

◆ setChunkSize()

WavFile::setChunkSize ( $chunkSize = null )

protected

Definition at line 471 of file WavFile.php.

                                                       {
        if (is_null($chunkSize)) {
            $this->_chunkSize = 4 +                                                            // "WAVE" chunk
                                8 + $this->_fmtChunkSize +                                     // "fmt " subchunk
                                ($this->_factChunkSize > 0 ? 8 + $this->_factChunkSize : 0) +  // "fact" subchunk
                                8 + $this->_dataSize +                                         // "data" subchunk
                                ($this->_dataSize & 1);                                        // padding byte
        } else {
            $this->_chunkSize = $chunkSize;
        }
 
        $this->setActualSize();
 
        return $this;
    }

References setActualSize().

Referenced by setDataSize(), setFactChunkSize(), and setFmtChunkSize().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setDataOffset()

WavFile::setDataOffset ( $dataOffset = null )

protected

Definition at line 569 of file WavFile.php.

                                                         {
        if (is_null($dataOffset)) {
            $this->_dataOffset = 8 +                                                            // "RIFF" header (ID + size)
                                 4 +                                                            // "WAVE" chunk
                                 8 + $this->_fmtChunkSize +                                     // "fmt " subchunk
                                 ($this->_factChunkSize > 0 ? 8 + $this->_factChunkSize : 0) +  // "fact" subchunk
                                 8;                                                             // "data" subchunk
        } else {
            $this->_dataOffset = $dataOffset;
        }
 
        return $this;
    }

◆ setDataSize()

WavFile::setDataSize ( $dataSize = null )

protected

Definition at line 551 of file WavFile.php.

                                                     {
        if (is_null($dataSize)) {
            $this->_dataSize = strlen($this->_samples);
        } else {
            $this->_dataSize = $dataSize;
        }
 
        $this->setChunkSize()   // implicit setActualSize()
             ->setNumBlocks();
        $this->_dataSize_valid = true;
 
        return $this;
    }

References setChunkSize().

Referenced by appendWav(), convertBitsPerSample(), generateNoise(), getDataSubchunk(), getSampleBlock(), getSampleValue(), insertSilence(), readWavData(), setSampleBlock(), setSamples(), and setSampleValue().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setFactChunkSize()

WavFile::setFactChunkSize ( $factChunkSize = null )

protected

Definition at line 530 of file WavFile.php.

                                                               {
        if (is_null($factChunkSize)) {
            if ($this->_audioFormat != self::WAVE_FORMAT_PCM) {
                $this->_factChunkSize = 4;
            } else {
                $this->_factChunkSize = 0;
            }
        } else {
            $this->_factChunkSize = $factChunkSize;
        }
 
        $this->setChunkSize()    // implicit setActualSize()
             ->setDataOffset();
 
        return $this;
    }

References setChunkSize().

Here is the call graph for this function:

◆ setFmtChunkSize()

WavFile::setFmtChunkSize ( $fmtChunkSize = null )

protected

Definition at line 491 of file WavFile.php.

                                                             {
        if (is_null($fmtChunkSize)) {
            $this->_fmtChunkSize = 16 + $this->_fmtExtendedSize;
        } else {
            $this->_fmtChunkSize = $fmtChunkSize;
        }
 
        $this->setChunkSize()    // implicit setActualSize()
             ->setDataOffset();
 
        return $this;
    }

References $_fmtExtendedSize, and setChunkSize().

Referenced by setFmtExtendedSize().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setFmtExtendedSize()

WavFile::setFmtExtendedSize ( $fmtExtendedSize = null )

protected

Definition at line 508 of file WavFile.php.

                                                                   {
        if (is_null($fmtExtendedSize)) {
            if ($this->_audioFormat == self::WAVE_FORMAT_EXTENSIBLE) {
                $this->_fmtExtendedSize = 2 + 22;                          // extension size for WAVE_FORMAT_EXTENSIBLE
            } elseif ($this->_audioFormat != self::WAVE_FORMAT_PCM) {
                $this->_fmtExtendedSize = 2 + 0;                           // empty extension
            } else {
                $this->_fmtExtendedSize = 0;                               // no extension, only for WAVE_FORMAT_PCM
            }
        } else {
            $this->_fmtExtendedSize = $fmtExtendedSize;
        }
 
        $this->setFmtChunkSize();  // implicit setSize(), setActualSize(), setDataOffset()
 
        return $this;
    }

References setFmtChunkSize().

Here is the call graph for this function:

◆ setNumBlocks()

WavFile::setNumBlocks ( $numBlocks = null )

protected

Definition at line 753 of file WavFile.php.

                                                       {
        if (is_null($numBlocks)) {
            $this->_numBlocks = (int)($this->_dataSize / $this->_blockAlign);  // do not count incomplete sample blocks
        } else {
            $this->_numBlocks = $numBlocks;
        }
 
        return $this;
    }

Referenced by makeHeader(), and setBlockAlign().

Here is the caller graph for this function:

◆ setNumChannels()

WavFile::setNumChannels ( $numChannels )

Definition at line 634 of file WavFile.php.

                                                 {
        if ($numChannels < 1 || $numChannels > self::MAX_CHANNEL) {
            throw new WavFileException('Unsupported number of channels. Only up to ' . self::MAX_CHANNEL . ' channels are supported.');
        } elseif ($this->_samples !== '') {
            trigger_error('Wav already has sample data. Changing the number of channels does not convert and may corrupt the data.', E_USER_NOTICE);
        }
 
        $this->_numChannels = (int)$numChannels;
 
        $this->setAudioFormat()  // implicit setAudioSubFormat(), setFactChunkSize(), setFmtExtendedSize(), setFmtChunkSize(), setSize(), setActualSize(), setDataOffset()
             ->setByteRate()
             ->setBlockAlign();  // implicit setNumBlocks()
 
        return $this;
    }

References setAudioFormat().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSampleBlock()

WavFile::setSampleBlock	(	$sampleBlock,
		$blockNum
	)

Set a single sample block.

Allows to append a sample block.

Parameters

string	$sampleBlock	(Required) The binary sample block (all channels).
int	$blockNum	(Required) The sample block number. Zero based.

Exceptions

WavFileException

Definition at line 1344 of file WavFile.php.

    {
        // check preconditions
        $blockAlign = $this->_blockAlign;
        if (!isset($sampleBlock[$blockAlign - 1]) || isset($sampleBlock[$blockAlign])) {  // faster than: if (strlen($sampleBlock) != $blockAlign)
            throw new WavFileException('Incorrect sample block size. Got ' . strlen($sampleBlock) . ', expected ' . $blockAlign . '.');
        }
 
        if (!$this->_dataSize_valid) {
            $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
        }
 
        $numBlocks = (int)($this->_dataSize / $blockAlign);
        $offset = $blockNum * $blockAlign;
        if ($blockNum > $numBlocks || $blockNum < 0) {  // allow appending
            throw new WavFileException('Sample block number is out of range.');
        }
 
 
        // replace or append data
        if ($blockNum == $numBlocks) {
            // append
            $this->_samples    .= $sampleBlock;
            $this->_dataSize   += $blockAlign;
            $this->_chunkSize  += $blockAlign;
            $this->_actualSize += $blockAlign;
            $this->_numBlocks++;
        } else {
            // replace
            for ($i = 0; $i < $blockAlign; ++$i) {
                $this->_samples[$offset + $i] = $sampleBlock[$i];
            }
        }
 
        return $this;
    }

References $_blockAlign, and setDataSize().

Here is the call graph for this function:

◆ setSampleRate()

WavFile::setSampleRate ( $sampleRate )

Definition at line 679 of file WavFile.php.

                                               {
        if ($sampleRate < 1 || $sampleRate > self::MAX_SAMPLERATE) {
            throw new WavFileException('Invalid sample rate.');
        } elseif ($this->_samples !== '') {
            trigger_error('Wav already has sample data. Changing the sample rate does not convert the data and may yield undesired results.', E_USER_NOTICE);
        }
 
        $this->_sampleRate = (int)$sampleRate;
 
        $this->setByteRate();
 
        return $this;
    }

References setByteRate().

Here is the call graph for this function:

◆ setSamples()

WavFile::setSamples ( & $samples = '' )

Definition at line 781 of file WavFile.php.

                                               {
        if (strlen($samples) % $this->_blockAlign != 0) {
            throw new WavFileException('Incorrect samples size. Has to be a multiple of BlockAlign.');
        }
 
        $this->_samples = $samples;
 
        $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
 
        return $this;
    }

References setDataSize().

Referenced by convertBitsPerSample().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSampleValue()

WavFile::setSampleValue	(	$sampleFloat,
		$blockNum,
		$channelNum
	)

Sets a float sample value for a specific sample block number and channel.

Converts float values to appropriate integer values and clips properly.
Allows to append samples (in order).

Parameters

float	$sampleFloat	(Required) The float sample value to set. Converts float values and clips if necessary.
int	$blockNum	(Required) The sample block number to set or append. Zero based.
int	$channelNum	(Required) The channel number within the sample block to set or append. First channel is 1.

Exceptions

WavFileException

Definition at line 1453 of file WavFile.php.

    {
        // check preconditions
        if ($channelNum < 1 || $channelNum > $this->_numChannels) {
            throw new WavFileException('Channel number is out of range.');
        }
 
        if (!$this->_dataSize_valid) {
            $this->setDataSize();  // implicit setSize(), setActualSize(), setNumBlocks()
        }
 
        $dataSize = $this->_dataSize;
        $bitsPerSample = $this->_bitsPerSample;
        $sampleBytes = $bitsPerSample / 8;
        $offset = $blockNum * $this->_blockAlign + ($channelNum - 1) * $sampleBytes;
        if (($offset + $sampleBytes > $dataSize && $offset != $dataSize) || $offset < 0) { // allow appending
            throw new WavFileException('Sample block or channel number is out of range.');
        }
 
 
        // convert to value, quantize and clip
        if ($bitsPerSample == 32) {
            $sample = $sampleFloat < -1.0 ? -1.0 : ($sampleFloat > 1.0 ? 1.0 : $sampleFloat);
        } else {
            $p = 1 << ($bitsPerSample - 1); // 2 to the power of _bitsPerSample divided by 2
 
            // project and quantize (round) float to integer values
            $sample = $sampleFloat < 0 ? (int)($sampleFloat * $p - 0.5) : (int)($sampleFloat * $p + 0.5);
 
            // clip if necessary to [-$p, $p - 1]
            if ($sample < -$p) {
                $sample = -$p;
            } elseif ($sample > $p - 1) {
                $sample = $p - 1;
            }
        }
 
        // convert to binary
        switch ($bitsPerSample) {
            case 8:
                // unsigned char
                $sampleBinary = chr($sample + 0x80);
                break;
 
            case 16:
                // signed short, little endian
                if ($sample < 0) {
                    $sample += 0x10000;
                }
                $sampleBinary = pack('v', $sample);
                break;
 
            case 24:
                // 3 byte packed signed integer, little endian
                if ($sample < 0) {
                    $sample += 0x1000000;
                }
                $sampleBinary = pack('C3', $sample & 0xff, ($sample >>  8) & 0xff, ($sample >> 16) & 0xff);
                break;
 
            case 32:
                // 32-bit float
                $sampleBinary = pack('f', $sample);
                break;
 
            default:
                $sampleBinary = null;
                $sampleBytes = 0;
                break;
        }
 
        // replace or append data
        if ($offset == $dataSize) {
            // append
            $this->_samples    .= $sampleBinary;
            $this->_dataSize   += $sampleBytes;
            $this->_chunkSize  += $sampleBytes;
            $this->_actualSize += $sampleBytes;
            $this->_numBlocks = (int)($this->_dataSize / $this->_blockAlign);
        } else {
            // replace
            for ($i = 0; $i < $sampleBytes; ++$i) {
                $this->_samples{$offset + $i} = $sampleBinary{$i};
            }
        }
 
        return $this;
    }

References $_bitsPerSample, $_dataSize, and setDataSize().

Referenced by filter().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setValidBitsPerSample()

WavFile::setValidBitsPerSample ( $validBitsPerSample = null )

protected

Definition at line 717 of file WavFile.php.

                                                                         {
        if (is_null($validBitsPerSample)) {
            $this->_validBitsPerSample = $this->_bitsPerSample;
        } else {
            if ($validBitsPerSample < 1 || $validBitsPerSample > $this->_bitsPerSample) {
                throw new WavFileException('ValidBitsPerSample cannot be greater than BitsPerSample.');
            }
            $this->_validBitsPerSample = (int)$validBitsPerSample;
        }
 
        $this->setAudioFormat();  // implicit setAudioSubFormat(), setFactChunkSize(), setFmtExtendedSize(), setFmtChunkSize(), setSize(), setActualSize(), setDataOffset()
 
        return $this;
    }

References $_bitsPerSample, and setAudioFormat().

Referenced by setBitsPerSample().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setWavData()

WavFile::setWavData	(	&	$data,
			$free = `true`
	)

Set the wav file data and properties from a wav file in a string.

Parameters

string	$data	(Required) The wav file data. Passed by reference.
bool	$free	(Optional) True to free the passed $data after copying.

Exceptions

WavFormatException
WavFileException

Definition at line 967 of file WavFile.php.

    {
        // check preconditions
        if (is_resource($this->_fp)) $this->closeWav();
 
 
        // open temporary stream in memory
        $this->_fp = @fopen('php://memory', 'w+b');
        if (!is_resource($this->_fp)) {
            throw new WavFileException('Failed to open memory stream to write wav data. Use openWav() instead.');
        }
 
        // prepare stream
        fwrite($this->_fp, $data);
        rewind($this->_fp);
 
        // free the passed data
        if ($free) $data = null;
 
        // read the stream like a file
        return $this->readWav(true);
    }

References $data, closeWav(), and readWav().

Here is the call graph for this function:

◆ unpackSample()

static WavFile::unpackSample	(	$sampleBinary,
		$bitDepth = `null`
	)

static

Unpacks a single binary sample to numeric value.

Parameters

string	$sampleBinary	(Required) The sample to decode.
int	$bitDepth	(Optional) The bits per sample to decode. If omitted, derives it from the length of $sampleBinary.

Returns: int|float The numeric sample value. Float for 32-bit samples. Returns null for unsupported bit depths.

Definition at line 286 of file WavFile.php.

    {
        if ($bitDepth === null) {
            $bitDepth = strlen($sampleBinary) * 8;
        }
 
        switch ($bitDepth) {
            case 8:
                // unsigned char
                return ord($sampleBinary);
 
            case 16:
                // signed short, little endian
                $data = unpack('v', $sampleBinary);
                $sample = $data[1];
                if ($sample >= 0x8000) {
                    $sample -= 0x10000;
                }
                return $sample;
 
            case 24:
                // 3 byte packed signed integer, little endian
                $data = unpack('C3', $sampleBinary);
                $sample = $data[1] | ($data[2] << 8) | ($data[3] << 16);
                if ($sample >= 0x800000) {
                    $sample -= 0x1000000;
                }
                return $sample;
 
            case 32:
                // 32-bit float
                $data = unpack('f', $sampleBinary);
                return $data[1];
 
            default:
                return null;
        }
    }

References $data.

Referenced by unpackSampleBlock().

Here is the caller graph for this function:

◆ unpackSampleBlock()

static WavFile::unpackSampleBlock	(	$sampleBlock,
		$bitDepth,
		$numChannels = `null`
	)

static

Unpacks a binary sample block to numeric values.

Parameters

string	$sampleBlock	(Required) The binary sample block (all channels).
int	$bitDepth	(Required) The bits per sample to decode.
int	$numChannels	(Optional) The number of channels to decode. If omitted, derives it from the length of $sampleBlock and $bitDepth.

Returns: array The sample values as an array of integers of floats for 32 bits. First channel is array index 1.

Definition at line 370 of file WavFile.php.

                                                                                           {
        $sampleBytes = $bitDepth / 8;
        if ($numChannels === null) {
            $numChannels = strlen($sampleBlock) / $sampleBytes;
        }
 
        $samples = array();
        for ($i = 0; $i < $numChannels; $i++) {
            $sampleBinary = substr($sampleBlock, $i * $sampleBytes, $sampleBytes);
            $samples[$i + 1] = self::unpackSample($sampleBinary, $bitDepth);
        }
 
        return $samples;
    }

References unpackSample().

Here is the call graph for this function:

Field Documentation

◆ $_actualSize

WavFile::$_actualSize

protected

Definition at line 141 of file WavFile.php.

Referenced by getActualSize().

◆ $_audioFormat

WavFile::$_audioFormat

protected

Definition at line 168 of file WavFile.php.

Referenced by getAudioFormat().

◆ $_audioSubFormat

WavFile::$_audioSubFormat

protected

Definition at line 171 of file WavFile.php.

Referenced by getAudioSubFormat().

◆ $_bitsPerSample

WavFile::$_bitsPerSample

protected

Definition at line 183 of file WavFile.php.

Referenced by getBitsPerSample(), setSampleValue(), and setValidBitsPerSample().

◆ $_blockAlign

WavFile::$_blockAlign

protected

Definition at line 189 of file WavFile.php.

Referenced by getBlockAlign(), getSampleBlock(), and setSampleBlock().

◆ $_byteRate

WavFile::$_byteRate

protected

Definition at line 195 of file WavFile.php.

Referenced by getByteRate().

◆ $_channelMask

WavFile::$_channelMask

protected

Definition at line 177 of file WavFile.php.

Referenced by getChannelMask().

◆ $_chunkSize

WavFile::$_chunkSize

protected

Definition at line 144 of file WavFile.php.

Referenced by getChunkSize(), and setActualSize().

◆ $_dataOffset

WavFile::$_dataOffset

protected

Definition at line 165 of file WavFile.php.

Referenced by getDataOffset().

◆ $_dataSize

WavFile::$_dataSize

protected

Definition at line 156 of file WavFile.php.

Referenced by getDataSize(), and setSampleValue().

◆ $_dataSize_fp

WavFile::$_dataSize_fp

protected

Definition at line 159 of file WavFile.php.

◆ $_dataSize_valid

WavFile::$_dataSize_valid

protected

Definition at line 162 of file WavFile.php.

◆ $_factChunkSize

WavFile::$_factChunkSize

protected

Definition at line 153 of file WavFile.php.

Referenced by getFactChunkSize().

◆ $_fmtChunkSize

WavFile::$_fmtChunkSize

protected

Definition at line 147 of file WavFile.php.

Referenced by getFmtChunkSize().

◆ $_fmtExtendedSize

WavFile::$_fmtExtendedSize

protected

Definition at line 150 of file WavFile.php.

Referenced by getFmtExtendedSize(), and setFmtChunkSize().

◆ $_fp

WavFile::$_fp

protected

Definition at line 201 of file WavFile.php.

◆ $_numBlocks

WavFile::$_numBlocks

protected

Definition at line 192 of file WavFile.php.

Referenced by getNumBlocks().

◆ $_numChannels

WavFile::$_numChannels

protected

Definition at line 174 of file WavFile.php.

Referenced by getNumChannels().

◆ $_sampleRate

WavFile::$_sampleRate

protected

Definition at line 180 of file WavFile.php.

Referenced by getSampleRate().

◆ $_samples

WavFile::$_samples

protected

Definition at line 198 of file WavFile.php.

Referenced by getSamples(), and insertSilence().

◆ $_validBitsPerSample

WavFile::$_validBitsPerSample

protected

Definition at line 186 of file WavFile.php.

Referenced by getValidBitsPerSample().

◆ $LOOKUP_LOGBASE

WavFile::$LOOKUP_LOGBASE

staticprotected

Initial value:

= array(
        2.513, 2.667, 2.841, 3.038, 3.262,
        3.520, 3.819, 4.171, 4.589, 5.093,
        5.711, 6.487, 7.483, 8.806, 10.634,
        13.302, 17.510, 24.970, 41.155, 96.088
    )

Definition at line 133 of file WavFile.php.

◆ FILTER_DEGRADE

const WavFile::FILTER_DEGRADE = 0x04

Definition at line 81 of file WavFile.php.

Referenced by degrade(), filter(), and Securimage\generateWAV().

◆ FILTER_MIX

const WavFile::FILTER_MIX = 0x01

Definition at line 75 of file WavFile.php.

Referenced by filter(), Securimage\generateWAV(), and mergeWav().

◆ FILTER_NORMALIZE

const WavFile::FILTER_NORMALIZE = 0x02

Definition at line 78 of file WavFile.php.

Referenced by filter(), Securimage\generateWAV(), and mergeWav().

◆ MAX_CHANNEL

const WavFile::MAX_CHANNEL = 18

Definition at line 84 of file WavFile.php.

◆ MAX_SAMPLERATE

const WavFile::MAX_SAMPLERATE = 192000

Definition at line 87 of file WavFile.php.

◆ SPEAKER_ALL

const WavFile::SPEAKER_ALL = 0x03FFFF

Definition at line 109 of file WavFile.php.

◆ SPEAKER_BACK_CENTER

const WavFile::SPEAKER_BACK_CENTER = 0x000100

Definition at line 99 of file WavFile.php.

◆ SPEAKER_BACK_LEFT

const WavFile::SPEAKER_BACK_LEFT = 0x000010

Definition at line 95 of file WavFile.php.

◆ SPEAKER_BACK_RIGHT

const WavFile::SPEAKER_BACK_RIGHT = 0x000020

Definition at line 96 of file WavFile.php.

◆ SPEAKER_DEFAULT

const WavFile::SPEAKER_DEFAULT = 0x000000

Channel Locations for ChannelMask.

Definition at line 90 of file WavFile.php.

Referenced by __construct().

◆ SPEAKER_FRONT_CENTER

const WavFile::SPEAKER_FRONT_CENTER = 0x000004

Definition at line 93 of file WavFile.php.

◆ SPEAKER_FRONT_LEFT

const WavFile::SPEAKER_FRONT_LEFT = 0x000001

Definition at line 91 of file WavFile.php.

◆ SPEAKER_FRONT_LEFT_OF_CENTER

const WavFile::SPEAKER_FRONT_LEFT_OF_CENTER = 0x000040

Definition at line 97 of file WavFile.php.

◆ SPEAKER_FRONT_RIGHT

const WavFile::SPEAKER_FRONT_RIGHT = 0x000002

Definition at line 92 of file WavFile.php.

◆ SPEAKER_FRONT_RIGHT_OF_CENTER

const WavFile::SPEAKER_FRONT_RIGHT_OF_CENTER = 0x000080

Definition at line 98 of file WavFile.php.

◆ SPEAKER_LOW_FREQUENCY

const WavFile::SPEAKER_LOW_FREQUENCY = 0x000008

Definition at line 94 of file WavFile.php.

◆ SPEAKER_SIDE_LEFT

const WavFile::SPEAKER_SIDE_LEFT = 0x000200

Definition at line 100 of file WavFile.php.

◆ SPEAKER_SIDE_RIGHT

const WavFile::SPEAKER_SIDE_RIGHT = 0x000400

Definition at line 101 of file WavFile.php.

◆ SPEAKER_TOP_BACK_CENTER

const WavFile::SPEAKER_TOP_BACK_CENTER = 0x010000

Definition at line 107 of file WavFile.php.

◆ SPEAKER_TOP_BACK_LEFT

const WavFile::SPEAKER_TOP_BACK_LEFT = 0x008000

Definition at line 106 of file WavFile.php.

◆ SPEAKER_TOP_BACK_RIGHT

const WavFile::SPEAKER_TOP_BACK_RIGHT = 0x020000

Definition at line 108 of file WavFile.php.

◆ SPEAKER_TOP_CENTER

const WavFile::SPEAKER_TOP_CENTER = 0x000800

Definition at line 102 of file WavFile.php.

◆ SPEAKER_TOP_FRONT_CENTER

const WavFile::SPEAKER_TOP_FRONT_CENTER = 0x002000

Definition at line 104 of file WavFile.php.

◆ SPEAKER_TOP_FRONT_LEFT

const WavFile::SPEAKER_TOP_FRONT_LEFT = 0x001000

Definition at line 103 of file WavFile.php.

◆ SPEAKER_TOP_FRONT_RIGHT

const WavFile::SPEAKER_TOP_FRONT_RIGHT = 0x004000

Definition at line 105 of file WavFile.php.

◆ WAVE_FORMAT_EXTENSIBLE

const WavFile::WAVE_FORMAT_EXTENSIBLE = 0xFFFE

Definition at line 118 of file WavFile.php.

Referenced by setAudioFormat().

◆ WAVE_FORMAT_IEEE_FLOAT

const WavFile::WAVE_FORMAT_IEEE_FLOAT = 0x0003

Definition at line 115 of file WavFile.php.

Referenced by setAudioFormat().

◆ WAVE_FORMAT_PCM

const WavFile::WAVE_FORMAT_PCM = 0x0001

Definition at line 112 of file WavFile.php.

Referenced by __construct(), and setAudioFormat().

◆ WAVE_SUBFORMAT_IEEE_FLOAT

const WavFile::WAVE_SUBFORMAT_IEEE_FLOAT = "0300000000001000800000aa00389b71"

Definition at line 124 of file WavFile.php.

Referenced by setAudioSubFormat().

◆ WAVE_SUBFORMAT_PCM

const WavFile::WAVE_SUBFORMAT_PCM = "0100000000001000800000aa00389b71"

Definition at line 121 of file WavFile.php.

Referenced by setAudioSubFormat().

The documentation for this class was generated from the following file:

Services/Captcha/lib/securimage_3_5_1/WavFile.php

Protected Attributes
	$_actualSize

	$_chunkSize

	$_fmtChunkSize

	$_fmtExtendedSize

	$_factChunkSize

	$_dataSize

	$_dataSize_fp

	$_dataSize_valid

	$_dataOffset

	$_audioFormat

	$_audioSubFormat

	$_numChannels

	$_channelMask

	$_sampleRate

	$_bitsPerSample

	$_validBitsPerSample

	$_blockAlign

	$_numBlocks

	$_byteRate

	$_samples

	$_fp

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

◆ __destruct()

Member Function Documentation

◆ __clone()

◆ __toString()

◆ appendWav()

◆ closeWav()

◆ convertBitsPerSample()

◆ degrade()

◆ displayInfo()

◆ filter()

◆ generateNoise()

◆ getActualSize()

◆ getAudioFormat()

◆ getAudioSubFormat()

◆ getBitsPerSample()

◆ getBlockAlign()

◆ getByteRate()

◆ getChannelMask()

◆ getChunkSize()

◆ getDataOffset()

◆ getDataSize()

◆ getDataSubchunk()

◆ getFactChunkSize()

◆ getFmtChunkSize()

◆ getFmtExtendedSize()

◆ getMaxAmplitude()

◆ getMinAmplitude()

◆ getNumBlocks()

◆ getNumChannels()

◆ getSampleBlock()

◆ getSampleRate()

◆ getSamples()

◆ getSampleValue()

◆ getValidBitsPerSample()

◆ getZeroAmplitude()

◆ insertSilence()

◆ makeHeader()

◆ mergeWav()

◆ normalizeSample()

◆ openWav()

◆ packSample()

◆ packSampleBlock()

◆ readWav()

◆ readWavData()

◆ readWavHeader()

◆ save()

◆ setActualSize()

◆ setAudioFormat()

◆ setAudioSubFormat()

◆ setBitsPerSample()

◆ setBlockAlign()

◆ setByteRate()

◆ setChannelMask()

◆ setChunkSize()

◆ setDataOffset()

◆ setDataSize()

◆ setFactChunkSize()

◆ setFmtChunkSize()

◆ setFmtExtendedSize()

◆ setNumBlocks()

◆ setNumChannels()

◆ setSampleBlock()

◆ setSampleRate()

◆ setSamples()

◆ setSampleValue()

◆ setValidBitsPerSample()

◆ setWavData()

◆ unpackSample()

◆ unpackSampleBlock()

Field Documentation

◆ $_actualSize