rik/plibreader
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add Zend_Media_Mpeg class proposal

Browse Source 
git-svn-id: http://php-reader.googlecode.com/svn/branches/zend@172 51a70ab9-7547-0410-9469-37e369ee0574
This commit is contained in:
svollbehr
2010-03-06 22:08:24 +00:00
parent 7fc09e5964
commit 308466cbad
24 changed files with 2656 additions and 3483 deletions
Download Patch File Download Diff File Expand all files Collapse all files

550
src/Zend/Media/Mpeg/Abs/Frame.php Normal file
View File

@@ -0,0 +1,550 @@
<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
/**#@+ @ignore */
require_once 'Zend/Bit/Twiddling.php';
require_once 'Zend/Media/Mpeg/Abs/Object.php';
/**#@-*/
/**
* This class represents an MPEG Audio Bit Stream frame as described in
* ISO/IEC 11172-3 and ISO/IEC 13818-3 standards.
*
* To accommodate fast header processing the error checking data and the audio
* data are lazy fetch by default. You can change this behaviour by giving a
* proper option to the {@link Zend_Media_Mpeg_Abs} class.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @author Ryan Butterfield <buttza@gmail.com>
* @author Sven Vollbehr <sven@vollbehr.eu>
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
final class Zend_Media_Mpeg_Abs_Frame extends Zend_Media_Mpeg_Abs_Object
{
/**
* The bitrate lookup table. The table has the following format.
*
* <code>
* array (
* SAMPLING_FREQUENCY_HIGH | SAMPLING_FREQUENCY_LOW => array (
* LAYER_ONE | LAYER_TWO | LAYER_TREE => array ( <bitrates> )
* )
* )
* </code>
*
* @var Array
*/
private static $bitrates = array (
self::SAMPLING_FREQUENCY_HIGH => array (
self::LAYER_ONE => array (
1 => 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384,
416, 448
),
self::LAYER_TWO => array (
1 => 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320,
384
),
self::LAYER_THREE => array (
1 => 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256,
320
)
),
self::SAMPLING_FREQUENCY_LOW => array (
self::LAYER_ONE => array (
1 => 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224,
256
),
self::LAYER_TWO => array (
1 => 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160
),
self::LAYER_THREE => array (
1 => 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160
)
)
);
/**
* Sample rate lookup table. The table has the following format.
*
* <code>
* array (
* LAYER_ONE | LAYER_TWO | LAYER_TREE => array ( <sample rates> )
* )
* </code>
*
* @var Array
*/
private static $samplingFrequencies = array (
self::VERSION_ONE => array (44100, 48000, 32000),
self::VERSION_TWO => array (22050, 24000, 16000),
self::VERSION_TWO_FIVE => array (11025, 12000, 8000)
);
/**
* Samples per frame lookup table. The table has the following format.
*
* <code>
* array (
* SAMPLING_FREQUENCY_HIGH | SAMPLING_FREQUENCY_LOW => array (
* LAYER_ONE | LAYER_TWO | LAYER_TREE => <sample count>
* )
* )
* </code>
*
* @var Array
*/
private static $samples = array (
self::SAMPLING_FREQUENCY_HIGH => array (
self::LAYER_ONE => 384,
self::LAYER_TWO => 1152,
self::LAYER_THREE => 1152),
self::SAMPLING_FREQUENCY_LOW => array (
self::LAYER_ONE => 384,
self::LAYER_TWO => 1152,
self::LAYER_THREE => 576));
/**
* Coefficient lookup table. The table has the following format.
*
* <code>
* array (
* SAMPLING_FREQUENCY_HIGH | SAMPLING_FREQUENCY_LOW => array (
* LAYER_ONE | LAYER_TWO | LAYER_TREE => array ( <coefficient> )
* )
* )
* </code>
*
* @var Array
*/
private static $coefficients = array (
self::SAMPLING_FREQUENCY_HIGH => array (
self::LAYER_ONE => 12, self::LAYER_TWO => 144,
self::LAYER_THREE => 144
),
self::SAMPLING_FREQUENCY_LOW => array (
self::LAYER_ONE => 12, self::LAYER_TWO => 144,
self::LAYER_THREE => 72
)
);
/**
* Slot size per layer lookup table. The table has the following format.
*
* <code>
* array (
* LAYER_ONE | LAYER_TWO | LAYER_TREE => <size>
* )
* </code>
*
* @var Array
*/
private static $slotsizes = array (
self::LAYER_ONE => 4, self::LAYER_TWO => 1, self::LAYER_THREE => 1
);
/** @var integer */
private $_offset;
/** @var integer */
private $_version;
/** @var integer */
private $_frequencyType;
/** @var integer */
private $_layer;
/** @var integer */
private $_redundancy;
/** @var integer */
private $_bitrate;
/** @var integer */
private $_samplingFrequency;
/** @var integer */
private $_padding;
/** @var integer */
private $_mode;
/** @var integer */
private $_modeExtension;
/** @var integer */
private $_copyright;
/** @var integer */
private $_original;
/** @var integer */
private $_emphasis;
/** @var integer */
private $_length;
/** @var integer */
private $_samples;
/** @var integer */
private $_crc = false;
/** @var string */
private $_data = false;
/**
* Constructs the class with given parameters and reads object related data
* from the frame.
*
* @param Zend_Io_Reader $reader The reader object.
* @param Array $options Array of options.
*/
public function __construct($reader, &$options = array())
{
parent::__construct($reader, $options);
$this->_offset = $this->_reader->getOffset();
$header = $this->_reader->readUInt32BE();
$this->_version = Zend_Bit_Twiddling::getValue($header, 19, 20);
$this->_frequencyType = Zend_Bit_Twiddling::testBit($header, 19);
$this->_layer = Zend_Bit_Twiddling::getValue($header, 17, 18);
$this->_redundancy = !Zend_Bit_Twiddling::testBit($header, 16);
$this->_bitrate = isset
(self::$bitrates[$this->_frequencyType][$this->_layer]
[$index = Zend_Bit_Twiddling::getValue($header, 12, 15)]) ?
self::$bitrates[$this->_frequencyType][$this->_layer][$index] :
false;
$this->_samplingFrequency = isset
(self::$samplingFrequencies[$this->_version]
[$index = Zend_Bit_Twiddling::getValue($header, 10, 11)]) ?
self::$samplingFrequencies[$this->_version][$index] : false;
$this->_padding = Zend_Bit_Twiddling::testBit($header, 9);
$this->_mode = Zend_Bit_Twiddling::getValue($header, 6, 7);
$this->_modeExtension = Zend_Bit_Twiddling::getValue($header, 4, 5);
$this->_copyright = Zend_Bit_Twiddling::testBit($header, 3);
$this->_original = Zend_Bit_Twiddling::testBit($header, 2);
$this->_emphasis = Zend_Bit_Twiddling::getValue($header, 0, 1);
$this->_length = (int)
((self::$coefficients[$this->_frequencyType][$this->_layer] *
($this->_bitrate * 1000) / $this->_samplingFrequency) +
($this->_padding ? 1 : 0)) * self::$slotsizes[$this->_layer];
$this->_samples = self::$samples[$this->_frequencyType][$this->_layer];
if ($this->getOption('readmode', 'lazy') == 'full') {
$this->_readCrc();
$this->_readData();
}
$this->_reader->skip($this->_length - 4);
}
/**
* Returns the version identifier of the algorithm.
*
* @see VERSION_ONE, VERSION_TWO, VERSION_TWO_FIVE
* @return integer
*/
public function getVersion()
{
return $this->_version;
}
/**
* Returns the sampling frequency type. This can be one of the following
* values.
*
* o <b>{@link SAMPLING_FREQUENCY_HIGH}</b> -- Higher Sampling Frequency
* (Version 1)
* o <b>{@link SAMPLING_FREQUENCY_LOW}</b> -- Lower Sampling Frequency
* (Version 2 and 2.5)
*
* @see SAMPLING_FREQUENCY_LOW, SAMPLING_FREQUENCY_HIGH
* @return integer
*/
public function getFrequencyType()
{
return $this->_frequencyType;
}
/**
* Returns the type of layer used.
*
* @see LAYER_ONE, LAYER_TWO, LAYER_THREE
* @return integer
*/
public function getLayer()
{
return $this->_layer;
}
/**
* An alias to getRedundancy().
*
* @see getRedundancy
* @return boolean
*/
public function hasRedundancy()
{
return $this->getRedundancy();
}
/**
* Returns boolean corresponding to whether redundancy has been added in the
* audio bitstream to facilitate error detection and concealment. Equals
* <var>false</var> if no redundancy has been added, <var>true</var> if
* redundancy has been added.
*
* @return boolean
*/
public function getRedundancy()
{
return $this->_redundancy;
}
/**
* Returns the bitrate in kbps. The returned value indicates the total bitrate
* irrespective of the mode (stereo, joint_stereo, dual_channel,
* single_channel).
*
* @return integer
*/
public function getBitrate()
{
return $this->_bitrate;
}
/**
* Returns the sampling frequency in Hz.
*
* @return integer
*/
public function getSamplingFrequency()
{
return $this->_samplingFrequency;
}
/**
* An alias to getPadding().
*
* @see getPadding
* @return boolean
*/
public function hasPadding()
{
return $this->getPadding();
}
/**
* Returns boolean corresponding the frame contains an additional slot to
* adjust the mean bitrate to the sampling frequency. Equals to
* <var>true</var> if padding has been added, <var>false</var> otherwise.
*
* Padding is only necessary with a sampling frequency of 44.1kHz.
*
* @return boolean
*/
public function getPadding()
{
return $this->_padding;
}
/**
* Returns the mode. In Layer I and II the CHANNEL_JOINT_STEREO mode is
* intensity_stereo, in Layer III it is intensity_stereo and/or ms_stereo.
*
* @see CHANNEL_STEREO, CHANNEL_JOINT_STEREO, CHANNEL_DUAL_CHANNEL,
* CHANNEL_SINGLE_CHANNEL
* @return integer
*/
public function getMode()
{
return $this->_mode;
}
/**
* Returns the mode extension used in CHANNEL_JOINT_STEREO mode.
*
* In Layer I and II the return type indicates which subbands are in
* intensity_stereo. All other subbands are coded in stereo.
*
* o <b>{@link MODE_SUBBAND_4_TO_31}</b> -- subbands 4-31 in
* intensity_stereo, bound==4
* o <b>{@link MODE_SUBBAND_8_TO_31}</b> -- subbands 8-31 in
* intensity_stereo, bound==8
* o <b>{@link MODE_SUBBAND_12_TO_31}</b> -- subbands 12-31 in
* intensity_stereo, bound==12
* o <b>{@link MODE_SUBBAND_16_TO_31}</b> -- subbands 16-31 in
* intensity_stereo, bound==16
*
* In Layer III they indicate which type of joint stereo coding method is
* applied. The frequency ranges over which the intensity_stereo and
* ms_stereo modes are applied are implicit in the algorithm. Please see
* {@link MODE_ISOFF_MSSOFF}, {@link MODE_ISON_MSSOFF},
* {@link MODE_ISOFF_MSSON}, and {@link MODE_ISON_MSSON}.
*
* @return integer
*/
public function getModeExtension()
{
return $this->_modeExtension;
}
/**
* An alias to getCopyright().
*
* @see getCopyright
* @return boolean
*/
public function hasCopyright()
{
return $this->getCopyright();
}
/**
* Returns <var>true</var> if the coded bitstream is copyright protected,
* <var>false</var> otherwise.
*
* @return boolean
*/
public function getCopyright()
{
return $this->_copyright;
}
/**
* An alias to getOriginal().
*
* @see getOriginal
* @return boolean
*/
public function isOriginal()
{
return $this->getOriginal();
}
/**
* Returns whether the bitstream is original or home made.
*
* @return boolean
*/
public function getOriginal()
{
return $this->_original;
}
/**
* Returns the type of de-emphasis that shall be used. The value is one of
* the following.
*
* o <b>{@link EMPHASIS_NONE}</b> -- No emphasis
* o <b>{@link EMPHASIS_50_15}</b> -- 50/15 microsec. emphasis
* o <b>{@link EMPHASIS_CCIT_J17}</b> -- CCITT J.17
*
* @see EMPHASIS_NONE, EMPHASIS_50_15, EMPHASIS_CCIT_J17
* @return integer
*/
public function getEmphasis()
{
return $this->_emphasis;
}
/**
* Returns the length of the frame based on the current layer, bit rate,
* sampling frequency and padding, in bytes.
*
* @return integer
*/
public function getLength()
{
return $this->_length;
}
/**
* Returns the number of samples contained in the frame.
*
* @return integer
*/
public function getSamples()
{
return $this->_samples;
}
/**
* Returns the 16-bit CRC of the frame or <var>false</var> if not present.
*
* @return integer
*/
public function getCrc()
{
if ($this->getOption('readmode', 'lazy') == 'lazy' &&
$this->hasRedundancy() && $this->_crc === false) {
$this->_readCrc();
}
return $this->_crc;
}
/**
* Reads the CRC data.
*/
private function _readCrc()
{
if ($this->hasRedundancy()) {
$offset = $this->_reader->getOffset();
$this->_reader->setOffset($this->_offset + 4);
$this->_crc = $this->_reader->readUInt16BE();
$this->_reader->setOffset($offset);
}
}
/**
* Returns the audio data.
*
* @return string
*/
public function getData()
{
if ($this->getOption('readmode', 'lazy') == 'lazy' &&
$this->_data === false) {
$this->_readData();
}
return $this->_data;
}
/**
* Reads the frame data.
*/
private function _readData()
{
$offset = $this->_reader->getOffset();
$this->_reader->setOffset
($this->_offset + 4 + ($this->hasRedundancy() ? 2 : 0));
$this->_data = $this->_reader->read
($this->getLength() - 4 - ($this->hasRedundancy() ? 2 : 0));
$this->_reader->setOffset($offset);
}
}

528
src/Zend/Media/Mpeg/Abs/LameHeader.php Normal file
View File

@@ -0,0 +1,528 @@
<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
/**#@+ @ignore */
require_once 'Zend/Io/Reader.php';
require_once 'Zend/Bit/Twiddling.php';
require_once 'Zend/Media/Mpeg/Abs/Object.php';
/**#@-*/
/**
* This class represents a LAME extension to the Xing VBR header. The purpose of
* this header is to provide extra information about the audio bistream, encoder
* and parameters used. This header should, as much as possible, be meaningfull
* for as many encoders as possible, even if it is unlikely that other encoders
* than LAME will implement it.
*
* This header should be backward compatible with the Xing VBR tag, providing
* basic support for a lot of already written software. As much as possible the
* current revision (revision 1) should provide information similar to the one
* already provided by revision 0.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @author Sven Vollbehr <sven@vollbehr.eu>
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
class Zend_Media_Mpeg_Abs_LameHeader extends Zend_Media_Mpeg_Abs_Object
{
/** @var integer */
const VBR_METHOD_CONSTANT = 1;
/** @var integer */
const VBR_METHOD_ABR = 2;
/** @var integer */
const VBR_METHOD_RH = 3;
/** @var integer */
const VBR_METHOD_MTRH = 4;
/** @var integer */
const VBR_METHOD_MT = 5;
/** @var integer */
const ENCODING_FLAG_NSPSYTUNE = 1;
/** @var integer */
const ENCODING_FLAG_NSSAFEJOINT = 2;
/** @var integer */
const ENCODING_FLAG_NOGAP_CONTINUED = 4;
/** @var integer */
const ENCODING_FLAG_NOGAP_CONTINUATION = 8;
/** @var integer */
const MODE_MONO = 0;
/** @var integer */
const MODE_STEREO = 1;
/** @var integer */
const MODE_DUAL = 2;
/** @var integer */
const MODE_JOINT = 3;
/** @var integer */
const MODE_FORCE = 4;
/** @var integer */
const MODE_AUTO = 5;
/** @var integer */
const MODE_INTENSITY = 6;
/** @var integer */
const MODE_UNDEFINED = 7;
/** @var integer */
const SOURCE_FREQUENCY_32000_OR_LOWER = 0;
/** @var integer */
const SOURCE_FREQUENCY_44100 = 1;
/** @var integer */
const SOURCE_FREQUENCY_48000 = 2;
/** @var integer */
const SOURCE_FREQUENCY_HIGHER = 3;
/** @var integer */
const SURROUND_NONE = 0;
/** @var integer */
const SURROUND_DPL = 1;
/** @var integer */
const SURROUND_DPL2 = 2;
/** @var integer */
const SURROUND_AMBISONIC = 3;
/** @var string */
private $_version;
/** @var integer */
private $_revision;
/** @var integer */
private $_vbrMethod;
/** @var integer */
private $_lowpass;
/** @var integer */
private $_peakSignalAmplitude;
/** @var integer */
private $_radioReplayGain;
/** @var integer */
private $_audiophileReplayGain;
/** @var integer */
private $_encodingFlags;
/** @var integer */
private $_athType;
/** @var integer */
private $_bitrate;
/** @var integer */
private $_encoderDelaySamples;
/** @var integer */
private $_paddedSamples;
/** @var integer */
private $_sourceSampleFrequency;
/** @var boolean */
private $_unwiseSettingsUsed;
/** @var integer */
private $_mode;
/** @var integer */
private $_noiseShaping;
/** @var integer */
private $_mp3Gain;
/** @var integer */
private $_surroundInfo;
/** @var integer */
private $_presetUsed;
/** @var integer */
private $_musicLength;
/** @var integer */
private $_musicCrc;
/** @var integer */
private $_crc;
/**
* Constructs the class with given parameters and reads object related data
* from the bitstream.
*
* @param Zend_Io_Reader $reader The reader object.
* @param Array $options Array of options.
*/
public function __construct($reader, &$options = array())
{
parent::__construct($reader, $options);
$this->_version = $this->_reader->readString8(5);
$tmp = $this->_reader->readUInt8();
$this->_revision = Zend_Bit_Twiddling::getValue($tmp, 4, 8);
$this->_vbrMethod = Zend_Bit_Twiddling::getValue($tmp, 0, 3);
$this->_lowpass = $this->_reader->readUInt8() * 100;
$this->_peakSignalAmplitude = $this->_reader->readUInt32BE();
$tmp = $this->_reader->readUInt16BE();
$this->_radioReplayGain = array(
'name' => Zend_Bit_Twiddling::getValue($tmp, 0, 2),
'originator' => Zend_Bit_Twiddling::getValue($tmp, 3, 5),
'absoluteGainAdjustment' =>
Zend_Bit_Twiddling::getValue($tmp, 7, 15) / 10
);
$tmp = $this->_reader->readUInt16BE();
$this->_audiophileReplayGain = array(
'name' => Zend_Bit_Twiddling::getValue($tmp, 0, 2),
'originator' => Zend_Bit_Twiddling::getValue($tmp, 3, 5),
'absoluteGainAdjustment' =>
Zend_Bit_Twiddling::getValue($tmp, 7, 15) / 10
);
$tmp = $this->_reader->readUInt8();
$this->_encodingFlags = Zend_Bit_Twiddling::getValue($tmp, 4, 8);
$this->_athType = Zend_Bit_Twiddling::getValue($tmp, 0, 3);
$this->_bitrate = $this->_reader->readUInt8();
$tmp = $this->_reader->readUInt32BE();
// Encoder delay fields
$this->_encoderDelaySamples =
Zend_Bit_Twiddling::getValue($tmp, 20, 31);
$this->_paddedSamples = Zend_Bit_Twiddling::getValue($tmp, 8, 19);
// Misc field
$this->_sourceSampleFrequency =
Zend_Bit_Twiddling::getValue($tmp, 6, 7);
$this->_unwiseSettingsUsed = Zend_Bit_Twiddling::testBit($tmp, 5);
$this->_mode = Zend_Bit_Twiddling::getValue($tmp, 2, 4);
$this->_noiseShaping = Zend_Bit_Twiddling::getValue($tmp, 0, 1);
$this->_mp3Gain = pow(2, $this->_reader->readInt8() / 4);
$tmp = $this->_reader->readUInt16BE();
$this->_surroundInfo = Zend_Bit_Twiddling::getValue($tmp, 11, 14);
$this->_presetUsed = Zend_Bit_Twiddling::getValue($tmp, 0, 10);
$this->_musicLength = $this->_reader->readUInt32BE();
$this->_musicCrc = $this->_reader->readUInt16BE();
$this->_crc = $this->_reader->readUInt16BE();
}
/**
* Returns the version string of the header.
*
* @return string
*/
public function getVersion()
{
return $this->_version;
}
/**
* Returns the info tag revision.
*
* @return integer
*/
public function getRevision()
{
return $this->_revision;
}
/**
* Returns the VBR method used for encoding. See the corresponding constants
* for possible return values.
*
* @return integer
*/
public function getVbrMethod()
{
return $this->_vbrMethod;
}
/**
* Returns the lowpass filter value.
*
* @return integer
*/
public function getLowpass()
{
return $this->_lowpass;
}
/**
* Returns the peak signal amplitude field of replay gain. The value of 1.0
* (ie 100%) represents maximal signal amplitude storeable in decoding
* format.
*
* @return integer
*/
public function getPeakSignalAmplitude()
{
return $this->_peakSignalAmplitude;
}
/**
* Returns the radio replay gain field of replay gain, required to make all
* tracks equal loudness, as an array that consists of the following keys.
*
* o name -- Specifies the name of the gain adjustment. Can be one of the
* following values: 0 = not set, 1 = radio, or 2 = audiophile.
*
* o originator -- Specifies the originator of the gain adjustment. Can be
* one of the following values: 0 = not set, 1 = set by artist, 2 = set
* by user, 3 = set by my model, 4 = set by simple RMS average.
*
* o absoluteGainAdjustment -- Speficies the absolute gain adjustment.
*
* @return Array
*/
public function getRadioReplayGain()
{
return $this->_radioReplayGain;
}
/**
* Returns the audiophile replay gain field of replay gain, required to give
* ideal listening loudness, as an array that consists of the following
* keys.
*
* o name -- Specifies the name of the gain adjustment. Can be one of the
* following values: 0 = not set, 1 = radio, or 2 = audiophile.
*
* o originator -- Specifies the originator of the gain adjustment. Can be
* one of the following values: 0 = not set, 1 = set by artist, 2 = set
* by user, 3 = set by my model, 4 = set by simple RMS average.
*
* o absoluteGainAdjustment -- Speficies the absolute gain adjustment.
*
* @return Array
*/
public function getAudiophileReplayGain()
{
return $this->_audiophileReplayGain;
}
/**
* Returns the encoding flags. See the corresponding flag constants for
* possible values.
*
* @return integer
*/
public function getEncodingFlags()
{
return $this->_encodingFlags;
}
/**
* Returns the ATH type.
*
* @return integer
*/
public function getAthType()
{
return $this->_athType;
}
/**
* Returns the bitrate for CBR encoded files and the minimal birate for
* VBR encoded file. The maximum value of this field is 255 even with higher
* actual bitrates.
*
* @return integer
*/
public function getBitrate()
{
return $this->_bitrate;
}
/**
* Returns the encoder delay or number of samples added at start.
*
* @return integer
*/
public function getEncoderDelaySamples()
{
return $this->_encoderDelaySamples;
}
/**
* Returns the number of padded samples to complete the last frame.
*
* @return integer
*/
public function getPaddedSamples()
{
return $this->_paddedSamples;
}
/**
* Returns the source sample frequency. See corresponding constants for
* possible values.
*
* @return integer
*/
public function getSourceSampleFrequency()
{
return $this->_sourceSampleFrequency;
}
/**
* An alias to getUnwiseSettingsUsed().
*
* @see getUnwiseSettingsUsed
* @return boolean
*/
public function areUnwiseSettingsUsed()
{
return $this->getUnwiseSettingsUsed();
}
/**
* Returns whether unwise settings were used to encode the file.
*
* @return boolean
*/
public function getUnwiseSettingsUsed()
{
return $this->_unwiseSettingsUsed;
}
/**
* Returns the stereo mode. See corresponding constants for possible values.
*
* @return integer
*/
public function getMode()
{
return $this->_mode;
}
/**
* Returns the noise shaping.
*
* @return integer
*/
public function getNoiseShaping()
{
return $this->_noiseShaping;
}
/**
* Returns the MP3 gain change. Any MP3 can be amplified in a lossless
* manner. If done so, this field can be used to log such transformation
* happened so that any given time it can be undone.
*
* @return integer
*/
public function getMp3Gain()
{
return $this->_mp3Gain;
}
/**
* Returns the surround info. See corresponding contants for possible
* values.
*
* @return integer
*/
public function getSurroundInfo()
{
return $this->_surroundInfo;
}
/**
* Returns the preset used in encoding.
*
* @return integer
*/
public function getPresetUsed()
{
return $this->_presetUsed;
}
/**
* Returns the exact length in bytes of the MP3 file originally made by LAME
* excluded ID3 tag info at the end.
*
* The first byte it counts is the first byte of this LAME header and the
* last byte it counts is the last byte of the last MP3 frame containing
* music. The value should be equal to file length at the time of LAME
* encoding, except when using ID3 tags.
*
* @return integer
*/
public function getMusicLength()
{
return $this->_musicLength;
}
/**
* Returns the CRC-16 of the complete MP3 music data as made originally by
* LAME.
*
* @return integer
*/
public function getMusicCrc()
{
return $this->_musicCrc;
}
/**
* Returns the CRC-16 of the first 190 bytes of the header frame.
*
* @return integer
*/
public function getCrc()
{
return $this->_crc;
}
}

150
src/Zend/Media/Mpeg/Abs/Object.php Normal file
View File

@@ -0,0 +1,150 @@
<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
/**#@+ @ignore */
require_once 'Zend/Media/Mpeg/Object.php';
/**#@-*/
/**
* The base class for all MPEG Audio Bit Stream objects.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @author Ryan Butterfield <buttza@gmail.com>
* @author Sven Vollbehr <sven@vollbehr.eu>
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
abstract class Zend_Media_Mpeg_Abs_Object extends Zend_Media_Mpeg_Object
{
/** @var integer */
const VERSION_ONE = 3;
/** @var integer */
const VERSION_TWO = 2;
/** @var integer */
const VERSION_TWO_FIVE = 0;
/** @var integer */
const SAMPLING_FREQUENCY_LOW = 0;
/** @var integer */
const SAMPLING_FREQUENCY_HIGH = 1;
/** @var integer */
const LAYER_ONE = 3;
/** @var integer */
const LAYER_TWO = 2;
/** @var integer */
const LAYER_THREE = 1;
/** @var integer */
const CHANNEL_STEREO = 0;
/** @var integer */
const CHANNEL_JOINT_STEREO = 1;
/** @var integer */
const CHANNEL_DUAL_CHANNEL = 2;
/** @var integer */
const CHANNEL_SINGLE_CHANNEL = 3;
/** @var integer */
const MODE_SUBBAND_4_TO_31 = 0;
/** @var integer */
const MODE_SUBBAND_8_TO_31 = 1;
/** @var integer */
const MODE_SUBBAND_12_TO_31 = 2;
/** @var integer */
const MODE_SUBBAND_16_TO_31 = 3;
/** @var integer */
const MODE_ISOFF_MSSOFF = 0;
/** @var integer */
const MODE_ISON_MSSOFF = 1;
/** @var integer */
const MODE_ISOFF_MSSON = 2;
/** @var integer */
const MODE_ISON_MSSON = 3;
/** @var integer */
const EMPHASIS_NONE = 0;
/** @var integer */
const EMPHASIS_50_15 = 1;
/** @var integer */
const EMPHASIS_CCIT_J17 = 3;
/**
* Layer III side information size lookup table. The table has the
* following format.
*
* <code>
* array (
* SAMPLING_FREQUENCY_HIGH | SAMPLING_FREQUENCY_LOW => array (
* CHANNEL_STEREO | CHANNEL_JOINT_STEREO | CHANNEL_DUAL_CHANNEL |
* CHANNEL_SINGLE_CHANNEL => <size>
* )
* )
* </code>
*
* @var Array
*/
protected static $sidesizes = array(
self::SAMPLING_FREQUENCY_HIGH => array(
self::CHANNEL_STEREO => 32,
self::CHANNEL_JOINT_STEREO => 32,
self::CHANNEL_DUAL_CHANNEL => 32,
self::CHANNEL_SINGLE_CHANNEL => 17
),
self::SAMPLING_FREQUENCY_LOW => array(
self::CHANNEL_STEREO => 17,
self::CHANNEL_JOINT_STEREO => 17,
self::CHANNEL_DUAL_CHANNEL => 17,
self::CHANNEL_SINGLE_CHANNEL => 9
)
);
/**
* Constructs the class with given parameters.
*
* @param Zend_Io_Reader $reader The reader object.
* @param Array $options The options array.
*/
public function __construct($reader, &$options = array())
{
parent::__construct($reader, $options);
}
}

176
src/Zend/Media/Mpeg/Abs/VbriHeader.php Normal file
View File

@@ -0,0 +1,176 @@
<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
/**#@+ @ignore */
require_once 'Reader.php';
require_once 'Zend/Bit/Twiddling.php';
require_once 'Zend/Media/Mpeg/Abs/Object.php';
/**#@-*/
/**
* This class represents the Fraunhofer IIS VBR header which is often found in
* the first frame of an MPEG Audio Bit Stream.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @author Ryan Butterfield <buttza@gmail.com>
* @author Sven Vollbehr <sven@vollbehr.eu>
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
class Zend_Media_Mpeg_Abs_VbriHeader extends Zend_Media_Mpeg_Abs_Object
{
/** @var integer */
private $_version;
/** @var integer */
private $_delay;
/** @var integer */
private $_qualityIndicator;
/** @var integer */
private $_bytes;
/** @var integer */
private $_frames;
/** @var Array */
private $_toc = array();
/** @var integer */
private $_tocFramesPerEntry;
/** @var integer */
private $_length;
/**
* Constructs the class with given parameters and reads object related data
* from the bitstream.
*
* @param Zend_Io_Reader $reader The reader object.
* @param Array $options Array of options.
*/
public function __construct($reader, &$options = array())
{
$offset = $this->_reader->getOffset();
$this->_version = $this->_reader->readUInt16BE();
$this->_delay = $this->_reader->readUInt16BE();
$this->_qualityIndicator = $this->_reader->readUInt16BE();
$this->_bytes = $this->_reader->readUInt32BE();
$this->_frames = $this->_reader->readUInt32BE();
$tocEntries = $this->_reader->readUInt16BE();
$tocEntryScale = $this->_reader->readUInt16BE();
$tocEntrySize = $this->_reader->readUInt16BE();
$this->_tocFramesPerEntry = $this->_reader->readUInt16BE();
$this->_toc = array_merge(unpack(($tocEntrySize == 1) ? 'C*' :
($tocEntrySize == 2) ? 'n*' : 'N*',
$this->_reader->read($tocCount * $tocEntrySize)));
foreach ($this->_toc as $key => $value) {
$this->_toc[$key] = $tocEntryScale * $value;
}
$this->_length = $this->_reader->getOffset() - $offset;
}
/**
* Returns the header version.
*
* @return integer
*/
public function getVersion()
{
return $this->_version;
}
/**
* Returns the delay.
*
* @return integer
*/
public function getDelay()
{
return $this->_delay;
}
/**
* Returns the quality indicator. Return value varies from 0 (best quality)
* to 100 (worst quality).
*
* @return integer
*/
public function getQualityIndicator()
{
return $this->_qualityIndicator;
}
/**
* Returns the number of bytes in the file.
*
* @return integer
*/
public function getBytes()
{
return $this->_bytes;
}
/**
* Returns the number of frames in the file.
*
* @return integer
*/
public function getFrames()
{
return $this->_frames;
}
/**
* Returns the table of contents array.
*
* @return Array
*/
public function getToc()
{
return $this->_toc;
}
/**
* Returns the number of frames per TOC entry.
*
* @return integer
*/
public function getTocFramesPerEntry()
{
return $this->_tocFramesPerEntry;
}
/**
* Returns the length of the header in bytes.
*
* @return integer
*/
public function getLength()
{
return $this->_length;
}
}

138
src/Zend/Media/Mpeg/Abs/XingHeader.php Normal file
View File

@@ -0,0 +1,138 @@
<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
/**#@+ @ignore */
require_once 'Reader.php';
require_once 'Zend/Bit/Twiddling.php';
require_once 'Zend/Media/Mpeg/Abs/Object.php';
/**#@-*/
/**
* This class represents the Xing VBR header which is often found in the first
* frame of an MPEG Audio Bit Stream.
*
* @category Zend
* @package Zend_Media
* @subpackage MPEG
* @author Ryan Butterfield <buttza@gmail.com>
* @author Sven Vollbehr <sven@vollbehr.eu>
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id$
*/
class Zend_Media_Mpeg_Abs_XingHeader extends Zend_Media_Mpeg_Abs_Object
{
/** @var integer */
private $_frames = false;
/** @var integer */
private $_bytes = false;
/** @var Array */
private $_toc = array();
/** @var integer */
private $_qualityIndicator = false;
/**
* Constructs the class with given parameters and reads object related data
* from the bitstream.
*
* @param Zend_Io_Reader $reader The reader object.
* @param Array $options Array of options.
*/
public function __construct($reader, &$options = array())
{
parent::__construct($reader, $options);
$flags = $reader->readUInt32BE();
if (Zend_Bit_Twiddling::testAnyBits($flags, 0x1)) {
$this->_frames = $this->_reader->readUInt32BE();
}
if (Zend_Bit_Twiddling::testAnyBits($flags, 0x2)) {
$this->_bytes = $this->_reader->readUInt32BE();
}
if (Zend_Bit_Twiddling::testAnyBits($flags, 0x4)) {
$this->_toc = array_merge(unpack('C*', $this->_reader->read(100)));
}
if (Zend_Bit_Twiddling::testAnyBits($flags, 0x8)) {
$this->_qualityIndicator = $this->_reader->readUInt32BE();
}
}
/**
* Returns the number of frames in the file.
*
* @return integer
*/
public function getFrames()
{
return $this->_frames;
}
/**
* Returns the number of bytes in the file.
*
* @return integer
*/
public function getBytes()
{
return $this->_bytes;
}
/**
* Returns the table of contents array. The returned array has a fixed
* amount of 100 seek points to the file.
*
* @return Array
*/
public function getToc()
{
return $this->_toc;
}
/**
* Returns the quality indicator. The indicator is from 0 (best quality) to
* 100 (worst quality).
*
* @return integer
*/
public function getQualityIndicator()
{
return $this->_qualityIndicator;
}
/**
* Returns the length of the header in bytes.
*
* @return integer
*/
public function getLength()
{
return 4 +
($this->_frames !== false ? 4 : 0) +
($this->_bytes !== false ? 4 : 0) +
(empty($this->_toc) ? 0 : 100) +
($this->_qualityIndicator !== false ? 4 : 0);
}
}