/**
* Constructs the class with given parameters and reads object related data
* from the Ogg bitstream.
*
* @param HausDesign_Io_Reader $reader The reader object.
*/
public function __construct($reader)
{
$this->_reader = $reader;
$this->_capturePattern = $this->_reader->read(4);
if ($this->_capturePattern != 'OggS') {
require_once 'HausDesign/Media/Ogg/Exception.php';
throw new HausDesign_Media_Ogg_Exception('Not a valid Ogg bitstream');
}
$this->_streamStructureVersion = $this->_reader->readUInt8();
if ($this->_streamStructureVersion != 0) {
require_once 'HausDesign/Media/Ogg/Exception.php';
throw new HausDesign_Media_Ogg_Exception('Unsupported Ogg stream structure version');
}
$this->_headerTypeFlag = $this->_reader->readUInt8();
$this->_granulePosition = $this->_reader->readInt64LE();
$this->_bitstreamSerialNumber = $this->_reader->readUInt32LE();
$this->_pageSequenceNumber = $this->_reader->readUInt32LE();
$this->_crcChecksum = $this->_reader->readUInt32LE();
$this->_numberPageSegments = $this->_reader->readUInt8();
$this->_segmentTable = array();
for ($i = 0; $i < $this->_numberPageSegments; $i++) {
$this->_segmentTable[] = $this->_reader->readUInt8();
}
$this->_headerSize = $this->_numberPageSegments + 27;
$this->_pageSize = array_sum($this->_segmentTable);
$this->_size = $this->_headerSize + $this->_pageSize;
}
/**
* Constructs the class with given parameters and reads object related data
* from the Flac bitstream.
*
* @param HausDesign_Io_Reader $reader The reader object.
*/
public function __construct($reader)
{
$this->_reader = $reader;
$this->_last = ($tmp = $this->_reader->readUInt8()) >> 7 & 0x1;
$this->_type = $tmp & 0x7f;
$this->_size = $this->_reader->readUInt24BE();
}
/**
* Constructs the HausDesign_Io_FileReader class with given path to the file. By
* default the file is opened in read (rb) mode.
*
* @param string $filename The path to the file.
* @throws HausDesign_Io_Exception if the file cannot be read
*/
public function __construct($filename, $mode = null)
{
if ($mode === null) {
$mode = 'rb';
}
if (!file_exists($filename) || !is_readable($filename) || ($fd = fopen($filename, $mode)) === false) {
require_once 'HausDesign/Io/Exception.php';
throw new HausDesign_Io_Exception('Unable to open file for reading: ' . $filename);
}
parent::__construct($fd);
}
/**
* Constructs the class with given parameters and options.
*
* @param HausDesign_Io_Reader $reader The reader object.
* @param Array $options The options array.
*/
public function __construct($reader, &$options = array())
{
$this->_reader = $reader;
$this->_options =& $options;
if (($this->_reader = $reader) === null) {
if (defined($constant = 'self::' . strtoupper(preg_replace('/(?<=[a-z])[A-Z]/', '_$0', substr(get_class($this), 22))))) {
$this->_identifier = constant($constant);
} else {
require_once 'HausDesign/Media/Asf/Exception.php';
throw new HausDesign_Media_Asf_Exception('Object identifier could not be determined');
}
} else {
$this->_offset = $this->_reader->getOffset();
$this->_identifier = $this->_reader->readGuid();
$this->_size = $this->_reader->readInt64LE();
}
}
/**
* Writes the possibly altered ID3v2 tag back to the file where it was read.
* If the class was constructed without a file name, one can be provided
* here as an argument. Regardless, the write operation will override
* previous tag information, if found.
*
* If write is called on a tag without any frames to it, current tag is
* removed from the file altogether.
*
* @param string|HausDesign_Io_Writer $filename The optional path to the file, use
* null to save to the same file.
*/
public function write($filename)
{
if ($filename === null && ($filename = $this->_filename) === null) {
require_once 'HausDesign/Media/Id3/Exception.php';
throw new HausDesign_Media_Id3_Exception('No file given to write to');
} else {
if ($filename !== null && $filename instanceof HausDesign_Io_Writer) {
require_once 'HausDesign/Io/Writer.php';
$this->_writeData($filename);
return;
} else {
if ($filename !== null && $this->_filename !== null && realpath($filename) != realpath($this->_filename) && !copy($this->_filename, $filename)) {
require_once 'HausDesign/Media/Id3/Exception.php';
throw new HausDesign_Media_Id3_Exception('Unable to copy source to destination: ' . realpath($this->_filename) . '->' . realpath($filename));
}
}
}
if (($fd = fopen($filename, file_exists($filename) ? 'r+b' : 'wb')) === false) {
require_once 'HausDesign/Media/Id3/Exception.php';
throw new HausDesign_Media_Id3_Exception('Unable to open file for writing: ' . $filename);
}
$hasNoFrames = true;
foreach ($this->_frames as $identifier => $instances) {
if (count($instances) > 0) {
$hasNoFrames = false;
break;
}
}
if ($hasNoFrames === true) {
$this->remove(new HausDesign_Io_Reader($fd));
return;
}
if ($this->_reader !== null) {
$oldTagSize = 10 + $this->_header->getSize();
} else {
$reader = new HausDesign_Io_Reader($fd);
if ($reader->read(3) == 'ID3') {
$header = new HausDesign_Media_Id3_Header($reader);
$oldTagSize = 10 + $header->getSize();
} else {
$oldTagSize = 0;
}
}
require_once 'HausDesign/Io/StringWriter.php';
$tag = new HausDesign_Io_StringWriter();
$this->_writeData($tag);
$tagSize = $tag->getSize();
if ($tagSize > $oldTagSize) {
fseek($fd, 0, SEEK_END);
$oldFileSize = ftell($fd);
ftruncate($fd, $newFileSize = $tagSize - $oldTagSize + $oldFileSize);
for ($i = 1, $cur = $oldFileSize; $cur > 0; $cur -= 1024, $i++) {
if ($cur >= 1024) {
fseek($fd, -($i * 1024 + ($newFileSize - $oldFileSize)), SEEK_END);
$buffer = fread($fd, 1024);
fseek($fd, -($i * 1024), SEEK_END);
$bytes = fwrite($fd, $buffer, 1024);
} else {
fseek($fd, 0);
$buffer = fread($fd, $cur);
fseek($fd, $newFileSize - $oldFileSize);
$bytes = fwrite($fd, $buffer, $cur);
}
}
if (($remaining = $oldFileSize % 1024) != 0) {
// huh?
}
fseek($fd, 0, SEEK_END);
}
fseek($fd, 0);
for ($i = 0; $i < $tagSize; $i += 1024) {
fseek($tag->getFileDescriptor(), $i);
$bytes = fwrite($fd, fread($tag->getFileDescriptor(), 1024));
}
fclose($fd);
$this->_filename = $filename;
}
/**
* Constructs the class with given filename.
*
* @param string|resource|HausDesign_Io_Reader $filename The path to the file,
* file descriptor of an opened file, or a {@link HausDesign_Io_Reader} instance.
* @throws HausDesign_Io_Exception if an error occur in stream handling.
* @throws HausDesign_Media_Flac_Exception if an error occurs in vorbis bitstream reading.
*/
public function __construct($filename)
{
if ($filename instanceof HausDesign_Io_Reader) {
$this->_reader =& $filename;
} else {
$this->_filename = $filename;
require_once 'HausDesign/Io/FileReader.php';
try {
$this->_reader = new HausDesign_Io_FileReader($filename);
} catch (HausDesign_Io_Exception $e) {
$this->_reader = null;
require_once 'HausDesign/Media/Flac/Exception.php';
throw new HausDesign_Media_Flac_Exception($e->getMessage());
}
}
$capturePattern = $this->_reader->read(4);
if ($capturePattern != 'fLaC') {
require_once 'HausDesign/Media/Flac/Exception.php';
throw new HausDesign_Media_Flac_Exception('Not a valid FLAC bitstream');
}
while (true) {
$offset = $this->_reader->getOffset();
$last = ($tmp = $this->_reader->readUInt8()) >> 7 & 0x1;
$type = $tmp & 0x7f;
$size = $this->_reader->readUInt24BE();
$this->_reader->setOffset($offset);
switch ($type) {
case self::STREAMINFO:
// 0
require_once 'HausDesign/Media/Flac/MetadataBlock/Streaminfo.php';
$this->_metadataBlocks[] = new HausDesign_Media_Flac_MetadataBlock_Streaminfo($this->_reader);
break;
case self::PADDING:
// 1
require_once 'HausDesign/Media/Flac/MetadataBlock/Padding.php';
$this->_metadataBlocks[] = new HausDesign_Media_Flac_MetadataBlock_Padding($this->_reader);
break;
case self::APPLICATION:
// 2
require_once 'HausDesign/Media/Flac/MetadataBlock/Application.php';
$this->_metadataBlocks[] = new HausDesign_Media_Flac_MetadataBlock_Application($this->_reader);
break;
case self::SEEKTABLE:
// 3
require_once 'HausDesign/Media/Flac/MetadataBlock/Seektable.php';
$this->_metadataBlocks[] = new HausDesign_Media_Flac_MetadataBlock_Seektable($this->_reader);
break;
case self::VORBIS_COMMENT:
// 4
require_once 'HausDesign/Media/Flac/MetadataBlock/VorbisComment.php';
$this->_metadataBlocks[] = new HausDesign_Media_Flac_MetadataBlock_VorbisComment($this->_reader);
break;
case self::CUESHEET:
// 5
require_once 'HausDesign/Media/Flac/MetadataBlock/Cuesheet.php';
$this->_metadataBlocks[] = new HausDesign_Media_Flac_MetadataBlock_Cuesheet($this->_reader);
break;
case self::PICTURE:
// 6
require_once 'HausDesign/Media/Flac/MetadataBlock/Picture.php';
$this->_metadataBlocks[] = new HausDesign_Media_Flac_MetadataBlock_Picture($this->_reader);
break;
default:
// break intentionally omitted
}
$this->_reader->setOffset($offset + 4 + $size);
// Jump off the loop if we reached the end of metadata blocks
if ($last === 1) {
break;
}
}
}
/**
* Returns the current machine endian order.
*
* @return integer
*/
private function _getEndianess()
{
if (self::$_endianess === 0) {
self::$_endianess = $this->_fromInt32("") == 1 ? self::LITTLE_ENDIAN_ORDER : self::BIG_ENDIAN_ORDER;
}
return self::$_endianess;
}
/**
* Overwrite the method to read bytes within the Ogg bitstream.
*
* @param integer $length The amount of bytes to read within the Ogg bitstream.
* @return string
* @throws HausDesign_Io_Exception if an I/O error occurs
*/
public function read($length)
{
$currentPageSize = $this->_pages[$this->_currentPageNumber]['page']->getPageSize();
if ($this->_currentPagePosition + $length >= $currentPageSize) {
$buffer = parent::read($currentPageSize - $this->_currentPagePosition);
parent::skip($this->_pages[++$this->_currentPageNumber]['page']->getHeaderSize());
return $buffer . parent::read($this->_currentPagePosition = $length - ($currentPageSize - $this->_currentPagePosition));
} else {
$buffer = parent::read($length);
$this->_currentPagePosition += $length;
return $buffer;
}
}
/**
* Writes the possibly altered ID3v1 tag back to the file where it was read.
* If the class was constructed without a file name, one can be provided
* here as an argument. Regardless, the write operation will override
* previous tag information, if found.
*
* @param string $filename The optional path to the file.
* @throws HausDesign_Media_Id3_Exception if there is no file to write the tag to
*/
public function write($filename = null)
{
if ($filename === null && ($filename = $this->_filename) === null) {
require_once 'HausDesign/Media/Id3/Exception.php';
throw new HausDesign_Media_Id3_Exception('No file given to write the tag to');
}
require_once 'HausDesign/Io/FileWriter.php';
try {
$writer = new HausDesign_Io_FileWriter($filename);
$offset = $writer->getSize();
if ($this->_reader !== null) {
$offset = -128;
} else {
$reader = new HausDesign_Io_Reader($writer->getFileDescriptor());
$reader->setOffset(-128);
if ($reader->read(3) == 'TAG') {
$offset = -128;
}
}
$writer->setOffset($offset);
$writer->writeString8('TAG')->writeString8(substr($this->_title, 0, 30), 30)->writeString8(substr($this->_artist, 0, 30), 30)->writeString8(substr($this->_album, 0, 30), 30)->writeString8(substr($this->_year, 0, 4), 4);
if ($this->_track) {
$writer->writeString8(substr($this->_comment, 0, 28), 28)->writeInt8(0)->writeInt8($this->_track);
} else {
$writer->writeString8(substr($this->_comment, 0, 30), 30);
}
$writer->writeInt8($this->_genre);
$writer->flush();
} catch (HausDesign_Io_Exception $e) {
require_once 'HausDesign/Media/Id3/Exception.php';
throw new HausDesign_Media_Id3_Exception($e->getMessage());
}
$this->_filename = $filename;
}
