Metadata Library Object lets authors store stream-based,
* language-attributed, multiply defined, and large metadata attributes in a
* file.
*
* This object supports the same types of metadata as the
* {@link ASF_Object_Metadata Metadata Object}, as well as attributes
* with language IDs, attributes that are defined more than once, large
* attributes, and attributes with the GUID data type.
*
* @package php-reader
* @subpackage ASF
* @author Sven Vollbehr
* @copyright Copyright (c) 2008 The PHP Reader Project Workgroup
* @license http://code.google.com/p/php-reader/wiki/License New BSD License
* @version $Rev: 108 $
*/
final class ASF_Object_MetadataLibrary extends ASF_Object
{
/** @var Array */
private $_descriptionRecords = array();
/**
* Constructs the class with given parameters and reads object related data
* from the ASF file.
*
* @param Reader $reader The reader object.
* @param Array $options The options array.
*/
public function __construct($reader, &$options = array())
{
parent::__construct($reader, $options);
$descriptionRecordsCount = $this->_reader->readUInt16LE();
for ($i = 0; $i < $descriptionRecordsCount; $i++) {
$descriptionRecord = array
("languageIndex" => $this->_reader->readUInt16LE(),
"streamNumber" => $this->_reader->readUInt16LE());
$nameLength = $this->_reader->readUInt16LE();
$dataType = $this->_reader->readUInt16LE();
$dataLength = $this->_reader->readUInt32LE();
$descriptionRecord["name"] = iconv
("utf-16le", $this->getOption("encoding"),
$this->_reader->readString16LE($nameLength));
switch ($dataType) {
case 0: // Unicode string
$descriptionRecord["data"] = iconv
("utf-16le", $this->getOption("encoding"),
$this->_reader->readString16LE($dataLength));
break;
case 1: // BYTE array
$descriptionRecord["data"] = $this->_reader->read($dataLength);
break;
case 2: // BOOL
$descriptionRecord["data"] = $this->_reader->readUInt16LE() == 1;
break;
case 3: // DWORD
$descriptionRecord["data"] = $this->_reader->readUInt32LE();
break;
case 4: // QWORD
$descriptionRecord["data"] = $this->_reader->readInt64LE();
break;
case 5: // WORD
$descriptionRecord["data"] = $this->_reader->readUInt16LE();
break;
case 6: // GUID
$descriptionRecord["data"] = $this->_reader->readGUID();
break;
}
$this->_descriptionRecords[] = $descriptionRecord;
}
}
/**
* Returns an array of description records. Each record consists of the
* following keys.
*
* o languageIndex -- Specifies the index into the Language List
* Object that identifies the language of this attribute. If there is
* no Language List Object present, this field is zero.
*
* o streamNumber -- Specifies whether the entry applies to a specific
* digital media stream or whether it applies to the whole file. A value
* of 0 in this field indicates that it applies to the whole file;
* otherwise, the entry applies only to the indicated stream number. Valid
* values are between 1 and 127.
*
* o name -- Specifies the name that identifies the attribute being
* described.
*
* o data -- Specifies the actual metadata being stored.
*
* @return Array
*/
public function getDescriptionRecords() { return $this->_descriptionRecords; }
}