yetangitu/ampache
1
0
Fork 0
mirror of https://github.com/Yetangitu/ampache synced 2025-10-05 10:49:37 +02:00
Code Issues Releases Wiki Activity
ampache/modules/getid3/module.tag.id3v2.php

3282 lines
153 KiB
PHP
Raw Blame History

<?php
// +----------------------------------------------------------------------+
// | PHP version 5 |
// +----------------------------------------------------------------------+
// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen |
// +----------------------------------------------------------------------+
// | This source file is subject to version 2 of the GPL license, |
// | that is bundled with this package in the file license.txt and is |
// | available through the world-wide-web at the following url: |
// | http://www.gnu.org/copyleft/gpl.html |
// +----------------------------------------------------------------------+
// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org |
// +----------------------------------------------------------------------+
// | Authors: James Heinrich <infoØgetid3*org> |
// | Allan Hansen <ahØartemis*dk> |
// +----------------------------------------------------------------------+
// | module.tag.id3v2.php |
// | module for analyzing ID3v2 tags |
// | dependencies: module.tag.id3v1.php |
// | module.lib.image_size.php (optional) |
// | zlib support in PHP (optional) |
// +----------------------------------------------------------------------+
//
// $Id: module.tag.id3v2.php,v 1.15 2006/12/03 23:47:29 ah Exp $
class getid3_id3v2 extends getid3_handler
{
public $option_starting_offset = 0;
public function Analyze() {
$getid3 = $this->getid3;
// dependency
$getid3->include_module('tag.id3v1');
if ($getid3->option_tags_images) {
$getid3->include_module('lib.image_size');
}
// Overall tag structure:
// +-----------------------------+
// | Header (10 bytes) |
// +-----------------------------+
// | Extended Header |
// | (variable length, OPTIONAL) |
// +-----------------------------+
// | Frames (variable length) |
// +-----------------------------+
// | Padding |
// | (variable length, OPTIONAL) |
// +-----------------------------+
// | Footer (10 bytes, OPTIONAL) |
// +-----------------------------+
//
// Header
// ID3v2/file identifier "ID3"
// ID3v2 version $04 00
// ID3v2 flags (%ab000000 in v2.2, %abc00000 in v2.3, %abcd0000 in v2.4.x)
// ID3v2 size 4 * %0xxxxxxx
// shortcuts
$getid3->info['id3v2']['header'] = true;
$info_id3v2 = &$getid3->info['id3v2'];
$info_id3v2['flags'] = array ();
$info_id3v2_flags = &$info_id3v2['flags'];
$this->fseek($this->option_starting_offset, SEEK_SET);
$header = $this->fread(10);
if (substr($header, 0, 3) == 'ID3' && strlen($header) == 10) {
$info_id3v2['majorversion'] = ord($header{3});
$info_id3v2['minorversion'] = ord($header{4});
// shortcut
$id3v2_major_version = &$info_id3v2['majorversion'];
} else {
unset($getid3->info['id3v2']);
return false;
}
if ($id3v2_major_version > 4) { // this script probably won't correctly parse ID3v2.5.x and above (if it ever exists)
throw new getid3_exception('this script only parses up to ID3v2.4.x - this tag is ID3v2.'.$id3v2_major_version.'.'.$info_id3v2['minorversion']);
}
$id3_flags = ord($header{5});
switch ($id3v2_major_version) {
case 2:
// %ab000000 in v2.2
$info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation
$info_id3v2_flags['compression'] = (bool)($id3_flags & 0x40); // b - Compression
break;
case 3:
// %abc00000 in v2.3
$info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation
$info_id3v2_flags['exthead'] = (bool)($id3_flags & 0x40); // b - Extended header
$info_id3v2_flags['experim'] = (bool)($id3_flags & 0x20); // c - Experimental indicator
break;
case 4:
// %abcd0000 in v2.4
$info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation
$info_id3v2_flags['exthead'] = (bool)($id3_flags & 0x40); // b - Extended header
$info_id3v2_flags['experim'] = (bool)($id3_flags & 0x20); // c - Experimental indicator
$info_id3v2_flags['isfooter'] = (bool)($id3_flags & 0x10); // d - Footer present
break;
}
$info_id3v2['headerlength'] = getid3_lib::BigEndianSyncSafe2Int(substr($header, 6, 4)) + 10; // length of ID3v2 tag in 10-byte header doesn't include 10-byte header length
$info_id3v2['tag_offset_start'] = $this->option_starting_offset;
$info_id3v2['tag_offset_end'] = $info_id3v2['tag_offset_start'] + $info_id3v2['headerlength'];
// Frames
// All ID3v2 frames consists of one frame header followed by one or more
// fields containing the actual information. The header is always 10
// bytes and laid out as follows:
//
// Frame ID $xx xx xx xx (four characters)
// Size 4 * %0xxxxxxx
// Flags $xx xx
$size_of_frames = $info_id3v2['headerlength'] - 10; // not including 10-byte initial header
if (@$info_id3v2['exthead']['length']) {
$size_of_frames -= ($info_id3v2['exthead']['length'] + 4);
}
if (@$info_id3v2_flags['isfooter']) {
$size_of_frames -= 10; // footer takes last 10 bytes of ID3v2 header, after frame data, before audio
}
if ($size_of_frames > 0) {
$frame_data = $this->fread($size_of_frames); // read all frames from file into $frame_data variable
// if entire frame data is unsynched, de-unsynch it now (ID3v2.3.x)
if (@$info_id3v2_flags['unsynch'] && ($id3v2_major_version <= 3)) {
$frame_data = str_replace("\xFF\x00", "\xFF", $frame_data);
}
// [in ID3v2.4.0] Unsynchronisation [S:6.1] is done on frame level, instead
// of on tag level, making it easier to skip frames, increasing the streamability
// of the tag. The unsynchronisation flag in the header [S:3.1] indicates that
// there exists an unsynchronised frame, while the new unsynchronisation flag in
// the frame header [S:4.1.2] indicates unsynchronisation.
//$frame_data_offset = 10 + (@$info_id3v2['exthead']['length'] ? $info_id3v2['exthead']['length'] + 4 : 0); // how many bytes into the stream - start from after the 10-byte header (and extended header length+4, if present)
$frame_data_offset = 10; // how many bytes into the stream - start from after the 10-byte header
// Extended Header
if (@$info_id3v2_flags['exthead']) {
$extended_header_offset = 0;
if ($id3v2_major_version == 3) {
// v2.3 definition:
//Extended header size $xx xx xx xx // 32-bit integer
//Extended Flags $xx xx
// %x0000000 %00000000 // v2.3
// x - CRC data present
//Size of padding $xx xx xx xx
$info_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 0);
$extended_header_offset += 4;
$info_id3v2['exthead']['flag_bytes'] = 2;
$info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes']));
$extended_header_offset += $info_id3v2['exthead']['flag_bytes'];
$info_id3v2['exthead']['flags']['crc'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x8000);
$info_id3v2['exthead']['padding_size'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4));
$extended_header_offset += 4;
if ($info_id3v2['exthead']['flags']['crc']) {
$info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4));
$extended_header_offset += 4;
}
$extended_header_offset += $info_id3v2['exthead']['padding_size'];
}
elseif ($id3v2_major_version == 4) {
// v2.4 definition:
//Extended header size 4 * %0xxxxxxx // 28-bit synchsafe integer
//Number of flag bytes $01
//Extended Flags $xx
// %0bcd0000 // v2.4
// b - Tag is an update
// Flag data length $00
// c - CRC data present
// Flag data length $05
// Total frame CRC 5 * %0xxxxxxx
// d - Tag restrictions
// Flag data length $01
$info_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 1);
$extended_header_offset += 4;
$info_id3v2['exthead']['flag_bytes'] = 1;
$info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes']));
$extended_header_offset += $info_id3v2['exthead']['flag_bytes'];
$info_id3v2['exthead']['flags']['update'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x4000);
$info_id3v2['exthead']['flags']['crc'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x2000);
$info_id3v2['exthead']['flags']['restrictions'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x1000);
if ($info_id3v2['exthead']['flags']['crc']) {
$info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 5), 1);
$extended_header_offset += 5;
}
if ($info_id3v2['exthead']['flags']['restrictions']) {
// %ppqrrstt
$restrictions_raw = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 1));
$extended_header_offset += 1;
$info_id3v2['exthead']['flags']['restrictions']['tagsize'] = ($restrictions_raw && 0xC0) >> 6; // p - Tag size restrictions
$info_id3v2['exthead']['flags']['restrictions']['textenc'] = ($restrictions_raw && 0x20) >> 5; // q - Text encoding restrictions
$info_id3v2['exthead']['flags']['restrictions']['textsize'] = ($restrictions_raw && 0x18) >> 3; // r - Text fields size restrictions
$info_id3v2['exthead']['flags']['restrictions']['imgenc'] = ($restrictions_raw && 0x04) >> 2; // s - Image encoding restrictions
$info_id3v2['exthead']['flags']['restrictions']['imgsize'] = ($restrictions_raw && 0x03) >> 0; // t - Image size restrictions
}
}
$frame_data_offset += $extended_header_offset;
$frame_data = substr($frame_data, $extended_header_offset);
} // end extended header
while (isset($frame_data) && (strlen($frame_data) > 0)) { // cycle through until no more frame data is left to parse
if (strlen($frame_data) <= ($id3v2_major_version == 2 ? 6 : 10)) {
// insufficient room left in ID3v2 header for actual data - must be padding
$info_id3v2['padding']['start'] = $frame_data_offset;
$info_id3v2['padding']['length'] = strlen($frame_data);
$info_id3v2['padding']['valid'] = true;
for ($i = 0; $i < $info_id3v2['padding']['length']; $i++) {
if ($frame_data{$i} != "\x00") {
$info_id3v2['padding']['valid'] = false;
$info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i;
$getid3->warning('Invalid ID3v2 padding found at offset '.$info_id3v2['padding']['errorpos'].' (the remaining '.($info_id3v2['padding']['length'] - $i).' bytes are considered invalid)');
break;
}
}
break; // skip rest of ID3v2 header
}
if ($id3v2_major_version == 2) {
// Frame ID $xx xx xx (three characters)
// Size $xx xx xx (24-bit integer)
// Flags $xx xx
$frame_header = substr($frame_data, 0, 6); // take next 6 bytes for header
$frame_data = substr($frame_data, 6); // and leave the rest in $frame_data
$frame_name = substr($frame_header, 0, 3);
$frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 3, 3));
$frame_flags = 0; // not used for anything in ID3v2.2, just set to avoid E_NOTICEs
} elseif ($id3v2_major_version > 2) {
// Frame ID $xx xx xx xx (four characters)
// Size $xx xx xx xx (32-bit integer in v2.3, 28-bit synchsafe in v2.4+)
// Flags $xx xx
$frame_header = substr($frame_data, 0, 10); // take next 10 bytes for header
$frame_data = substr($frame_data, 10); // and leave the rest in $frame_data
$frame_name = substr($frame_header, 0, 4);
if ($id3v2_major_version == 3) {
$frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer
} else { // ID3v2.4+
$frame_size = getid3_lib::BigEndianSyncSafe2Int(substr($frame_header, 4, 4)); // 32-bit synchsafe integer (28-bit value)
}
if ($frame_size < (strlen($frame_data) + 4)) {
$nextFrameID = substr($frame_data, $frame_size, 4);
if (getid3_id3v2::IsValidID3v2FrameName($nextFrameID, $id3v2_major_version)) {
// next frame is OK
} elseif (($frame_name == "\x00".'MP3') || ($frame_name == "\x00\x00".'MP') || ($frame_name == ' MP3') || ($frame_name == 'MP3e')) {
// MP3ext known broken frames - "ok" for the purposes of this test
} elseif (($id3v2_major_version == 4) && (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)), 4), 3))) {
$getid3->warning('ID3v2 tag written as ID3v2.4, but with non-synchsafe integers (ID3v2.3 style). Older versions of (Helium2; iTunes) are known culprits of this. Tag has been parsed as ID3v2.3');
$id3v2_major_version = 3;
$frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer
}
}
$frame_flags = getid3_lib::BigEndian2Int(substr($frame_header, 8, 2));
}
if ((($id3v2_major_version == 2) && ($frame_name == "\x00\x00\x00")) || ($frame_name == "\x00\x00\x00\x00")) {
// padding encountered
$info_id3v2['padding']['start'] = $frame_data_offset;
$info_id3v2['padding']['length'] = strlen($frame_header) + strlen($frame_data);
$info_id3v2['padding']['valid'] = true;
$len = strlen($frame_data);
for ($i = 0; $i < $len; $i++) {
if ($frame_data{$i} != "\x00") {
$info_id3v2['padding']['valid'] = false;
$info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i;
$getid3->warning('Invalid ID3v2 padding found at offset '.$info_id3v2['padding']['errorpos'].' (the remaining '.($info_id3v2['padding']['length'] - $i).' bytes are considered invalid)');
break;
}
}
break; // skip rest of ID3v2 header
}
if ($frame_name == 'COM ') {
$getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))). [Note: this particular error has been known to happen with tags edited by iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably others too)]');
$frame_name = 'COMM';
}
if (($frame_size <= strlen($frame_data)) && (getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version))) {
unset($parsed_frame);
$parsed_frame['frame_name'] = $frame_name;
$parsed_frame['frame_flags_raw'] = $frame_flags;
$parsed_frame['data'] = substr($frame_data, 0, $frame_size);
$parsed_frame['datalength'] = (int)($frame_size);
$parsed_frame['dataoffset'] = $frame_data_offset;
$this->ParseID3v2Frame($parsed_frame);
$info_id3v2[$frame_name][] = $parsed_frame;
$frame_data = substr($frame_data, $frame_size);
} else { // invalid frame length or FrameID
if ($frame_size <= strlen($frame_data)) {
if (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, $frame_size, 4), $id3v2_major_version)) {
// next frame is valid, just skip the current frame
$frame_data = substr($frame_data, $frame_size);
$getid3->warning('Next ID3v2 frame is valid, skipping current frame.');
} else {
// next frame is invalid too, abort processing
throw new getid3_exception('Next ID3v2 frame is also invalid, aborting processing.');
}
} elseif ($frame_size == strlen($frame_data)) {
// this is the last frame, just skip
$getid3->warning('This was the last ID3v2 frame.');
} else {
// next frame is invalid too, abort processing
$frame_data = null;
$getid3->warning('Invalid ID3v2 frame size, aborting.');
}
if (!getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version)) {
switch ($frame_name) {
case "\x00\x00".'MP':
case "\x00".'MP3':
case ' MP3':
case 'MP3e':
case "\x00".'MP':
case ' MP':
case 'MP3':
$getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))). [Note: this particular error has been known to happen with tags edited by "MP3ext (www.mutschler.de/mp3ext/)"]');
break;
default:
$getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))).');
break;
}
} elseif ($frame_size > strlen(@$frame_data)){
throw new getid3_exception('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: $frame_size ('.$frame_size.') > strlen($frame_data) ('.strlen($frame_data).')).');
} else {
throw new getid3_exception('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag).');
}
}
$frame_data_offset += ($frame_size + ($id3v2_major_version == 2 ? 6 : 10));
}
}
// Footer
// The footer is a copy of the header, but with a different identifier.
// ID3v2 identifier "3DI"
// ID3v2 version $04 00
// ID3v2 flags %abcd0000
// ID3v2 size 4 * %0xxxxxxx
if (isset($info_id3v2_flags['isfooter']) && $info_id3v2_flags['isfooter']) {
$footer = fread ($getid3->fp, 10);
if (substr($footer, 0, 3) == '3DI') {
$info_id3v2['footer'] = true;
$info_id3v2['majorversion_footer'] = ord($footer{3});
$info_id3v2['minorversion_footer'] = ord($footer{4});
}
if ($info_id3v2['majorversion_footer'] <= 4) {
$id3_flags = ord($footer{5});
$info_id3v2_flags['unsynch_footer'] = (bool)($id3_flags & 0x80);
$info_id3v2_flags['extfoot_footer'] = (bool)($id3_flags & 0x40);
$info_id3v2_flags['experim_footer'] = (bool)($id3_flags & 0x20);
$info_id3v2_flags['isfooter_footer'] = (bool)($id3_flags & 0x10);
$info_id3v2['footerlength'] = getid3_lib::BigEndianSyncSafe2Int(substr($footer, 6, 4));
}
} // end footer
if (isset($info_id3v2['comments']['genre'])) {
foreach ($info_id3v2['comments']['genre'] as $key => $value) {
unset($info_id3v2['comments']['genre'][$key]);
$info_id3v2['comments'] = getid3_id3v2::array_merge_noclobber($info_id3v2['comments'], getid3_id3v2::ParseID3v2GenreString($value));
}
}
if (isset($info_id3v2['comments']['track'])) {
foreach ($info_id3v2['comments']['track'] as $key => $value) {
if (strstr($value, '/')) {
list($info_id3v2['comments']['track'][$key], $info_id3v2['comments']['totaltracks'][$key]) = explode('/', $info_id3v2['comments']['track'][$key]);
}
}
}
// Use year from recording time if year is empty
if (!strlen($info_id3v2['comments']['year']) && ereg('^([0-9]{4})', @$info_id3v2['comments']['recording_time'][0], $matches)) {
$info_id3v2['comments']['year'] = array ($matches[1]);
}
// Set avdataoffset
$getid3->info['avdataoffset'] = $info_id3v2['headerlength'];
if (isset($info_id3v2['footer'])) {
$getid3->info['avdataoffset'] += 10;
}
return true;
}
private function ParseID3v2Frame(&$parsed_frame) {
$getid3 = $this->getid3;
$id3v2_major_version = $getid3->info['id3v2']['majorversion'];
$frame_name_long = getid3_id3v2::FrameNameLongLookup($parsed_frame['frame_name']);
if ($frame_name_long) {
$parsed_frame['framenamelong'] = $frame_name_long;
}
$frame_name_short = getid3_id3v2::FrameNameShortLookup($parsed_frame['frame_name']);
if ($frame_name_short) {
$parsed_frame['framenameshort'] = $frame_name_short;
}
if ($id3v2_major_version >= 3) { // frame flags are not part of the ID3v2.2 standard
if ($id3v2_major_version == 3) {
// Frame Header Flags
// %abc00000 %ijk00000
$parsed_frame['flags']['TagAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x8000); // a - Tag alter preservation
$parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // b - File alter preservation
$parsed_frame['flags']['ReadOnly'] = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // c - Read only
$parsed_frame['flags']['compression'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0080); // i - Compression
$parsed_frame['flags']['Encryption'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // j - Encryption
$parsed_frame['flags']['GroupingIdentity'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0020); // k - Grouping identity
} elseif ($id3v2_major_version == 4) {
// Frame Header Flags
// %0abc0000 %0h00kmnp
$parsed_frame['flags']['TagAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // a - Tag alter preservation
$parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // b - File alter preservation
$parsed_frame['flags']['ReadOnly'] = (bool)($parsed_frame['frame_flags_raw'] & 0x1000); // c - Read only
$parsed_frame['flags']['GroupingIdentity'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // h - Grouping identity
$parsed_frame['flags']['compression'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0008); // k - Compression
$parsed_frame['flags']['Encryption'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0004); // m - Encryption
$parsed_frame['flags']['Unsynchronisation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0002); // n - Unsynchronisation
$parsed_frame['flags']['DataLengthIndicator'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0001); // p - Data length indicator
// Frame-level de-unsynchronisation - ID3v2.4
if ($parsed_frame['flags']['Unsynchronisation']) {
$parsed_frame['data'] = str_replace("\xFF\x00", "\xFF", $parsed_frame['data']);
}
}
// Frame-level de-compression
if ($parsed_frame['flags']['compression']) {
$parsed_frame['decompressed_size'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 4));
if (!function_exists('gzuncompress')) {
$getid3->warning('gzuncompress() support required to decompress ID3v2 frame "'.$parsed_frame['frame_name'].'"');
} elseif ($decompressed_data = @gzuncompress(substr($parsed_frame['data'], 4))) {
$parsed_frame['data'] = $decompressed_data;
} else {
$getid3->warning('gzuncompress() failed on compressed contents of ID3v2 frame "'.$parsed_frame['frame_name'].'"');
}
}
}
if (isset($parsed_frame['datalength']) && ($parsed_frame['datalength'] == 0)) {
$warning = 'Frame "'.$parsed_frame['frame_name'].'" at offset '.$parsed_frame['dataoffset'].' has no data portion';
switch ($parsed_frame['frame_name']) {
case 'WCOM':
$warning .= ' (this is known to happen with files tagged by RioPort)';
break;
default:
break;
}
$getid3->warning($warning);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'UFID')) || // 4.1 UFID Unique file identifier
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'UFI'))) { // 4.1 UFI Unique file identifier
// There may be more than one 'UFID' frame in a tag,
// but only one with the same 'Owner identifier'.
// <Header for 'Unique file identifier', ID: 'UFID'>
// Owner identifier <text string> $00
// Identifier <up to 64 bytes binary data>
$frame_terminator_pos = strpos($parsed_frame['data'], "\x00");
$frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos);
$parsed_frame['ownerid'] = $frame_id_string;
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'TXXX')) || // 4.2.2 TXXX User defined text information frame
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'TXX'))) { // 4.2.2 TXX User defined text information frame
// There may be more than one 'TXXX' frame in each tag,
// but only one with the same description.
// <Header for 'User defined text information frame', ID: 'TXXX'>
// Text encoding $xx
// Description <text string according to encoding> $00 (00)
// Value <text string according to encoding>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['description'] = $frame_description;
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = trim($getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']));
}
unset($parsed_frame['data']);
return true;
}
if ($parsed_frame['frame_name']{0} == 'T') { // 4.2. T??[?] Text information frame
// There may only be one text information frame of its kind in an tag.
// <Header for 'Text information frame', ID: 'T000' - 'TZZZ',
// excluding 'TXXX' described in 4.2.6.>
// Text encoding $xx
// Information <text string(s) according to encoding>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
// remove possible terminating \x00 (put by encoding id or software bug)
$string = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
if ($string[strlen($string)-1] == "\x00") {
$string = substr($string, 0, strlen($string)-1);
}
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $string;
unset($string);
}
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'WXXX')) || // 4.3.2 WXXX User defined URL link frame
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'WXX'))) { // 4.3.2 WXX User defined URL link frame
// There may be more than one 'WXXX' frame in each tag,
// but only one with the same description
// <Header for 'User defined URL link frame', ID: 'WXXX'>
// Text encoding $xx
// Description <text string according to encoding> $00 (00)
// URL <text string>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
$frame_terminator_pos = strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
if ($frame_terminator_pos) {
// there are null bytes after the data - this is not according to spec
// only use data up to first null byte
$frame_urldata = (string)substr($parsed_frame['data'], 0, $frame_terminator_pos);
} else {
// no null bytes following data, just use all data
$frame_urldata = (string)$parsed_frame['data'];
}
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['url'] = $frame_urldata;
$parsed_frame['description'] = $frame_description;
if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['url']);
}
unset($parsed_frame['data']);
return true;
}
if ($parsed_frame['frame_name']{0} == 'W') { // 4.3. W??? URL link frames
// There may only be one URL link frame of its kind in a tag,
// except when stated otherwise in the frame description
// <Header for 'URL link frame', ID: 'W000' - 'WZZZ', excluding 'WXXX'
// described in 4.3.2.>
// URL <text string>
$parsed_frame['url'] = trim($parsed_frame['data']);
if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['url'];
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'IPLS')) || // 4.4 IPLS Involved people list (ID3v2.3 only)
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'IPL'))) { // 4.4 IPL Involved people list (ID3v2.2 only)
// There may only be one 'IPL' frame in each tag
// <Header for 'User defined URL link frame', ID: 'IPL'>
// Text encoding $xx
// People list strings <textstrings>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($parsed_frame['encodingid']);
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
}
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MCDI')) || // 4.4 MCDI Music CD identifier
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MCI'))) { // 4.5 MCI Music CD identifier
// There may only be one 'MCDI' frame in each tag
// <Header for 'Music CD identifier', ID: 'MCDI'>
// CD TOC <binary data>
if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['data'];
}
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ETCO')) || // 4.5 ETCO Event timing codes
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ETC'))) { // 4.6 ETC Event timing codes
// There may only be one 'ETCO' frame in each tag
// <Header for 'Event timing codes', ID: 'ETCO'>
// Time stamp format $xx
// Where time stamp format is:
// $01 (32-bit value) MPEG frames from beginning of file
// $02 (32-bit value) milliseconds from beginning of file
// Followed by a list of key events in the following format:
// Type of event $xx
// Time stamp $xx (xx ...)
// The 'Time stamp' is set to zero if directly at the beginning of the sound
// or after the previous event. All events MUST be sorted in chronological order.
$frame_offset = 0;
$parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
while ($frame_offset < strlen($parsed_frame['data'])) {
$parsed_frame['typeid'] = $parsed_frame['data']{$frame_offset++};
$parsed_frame['type'] = getid3_id3v2::ETCOEventLookup($parsed_frame['typeid']);
$parsed_frame['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
$frame_offset += 4;
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MLLT')) || // 4.6 MLLT MPEG location lookup table
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MLL'))) { // 4.7 MLL MPEG location lookup table
// There may only be one 'MLLT' frame in each tag
// <Header for 'Location lookup table', ID: 'MLLT'>
// MPEG frames between reference $xx xx
// Bytes between reference $xx xx xx
// Milliseconds between reference $xx xx xx
// Bits for bytes deviation $xx
// Bits for milliseconds dev. $xx
// Then for every reference the following data is included;
// Deviation in bytes %xxx....
// Deviation in milliseconds %xxx....
$frame_offset = 0;
$parsed_frame['framesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 2));
$parsed_frame['bytesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 2, 3));
$parsed_frame['msbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 5, 3));
$parsed_frame['bitsforbytesdeviation'] = getid3_lib::BigEndian2Int($parsed_frame['data'][8]);
$parsed_frame['bitsformsdeviation'] = getid3_lib::BigEndian2Int($parsed_frame['data'][9]);
$parsed_frame['data'] = substr($parsed_frame['data'], 10);
while ($frame_offset < strlen($parsed_frame['data'])) {
$deviation_bitstream .= getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
}
$reference_counter = 0;
while (strlen($deviation_bitstream) > 0) {
$parsed_frame[$reference_counter]['bytedeviation'] = bindec(substr($deviation_bitstream, 0, $parsed_frame['bitsforbytesdeviation']));
$parsed_frame[$reference_counter]['msdeviation'] = bindec(substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'], $parsed_frame['bitsformsdeviation']));
$deviation_bitstream = substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'] + $parsed_frame['bitsformsdeviation']);
$reference_counter++;
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYTC')) || // 4.7 SYTC Synchronised tempo codes
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'STC'))) { // 4.8 STC Synchronised tempo codes
// There may only be one 'SYTC' frame in each tag
// <Header for 'Synchronised tempo codes', ID: 'SYTC'>
// Time stamp format $xx
// Tempo data <binary data>
// Where time stamp format is:
// $01 (32-bit value) MPEG frames from beginning of file
// $02 (32-bit value) milliseconds from beginning of file
$frame_offset = 0;
$parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
$timestamp_counter = 0;
while ($frame_offset < strlen($parsed_frame['data'])) {
$parsed_frame[$timestamp_counter]['tempo'] = ord($parsed_frame['data']{$frame_offset++});
if ($parsed_frame[$timestamp_counter]['tempo'] == 255) {
$parsed_frame[$timestamp_counter]['tempo'] += ord($parsed_frame['data']{$frame_offset++});
}
$parsed_frame[$timestamp_counter]['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
$frame_offset += 4;
$timestamp_counter++;
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USLT')) || // 4.8 USLT Unsynchronised lyric/text transcription
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ULT'))) { // 4.9 ULT Unsynchronised lyric/text transcription
// There may be more than one 'Unsynchronised lyrics/text transcription' frame
// in each tag, but only one with the same language and content descriptor.
// <Header for 'Unsynchronised lyrics/text transcription', ID: 'USLT'>
// Text encoding $xx
// Language $xx xx xx
// Content descriptor <text string according to encoding> $00 (00)
// Lyrics/text <full text string according to encoding>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_language = substr($parsed_frame['data'], $frame_offset, 3);
$frame_offset += 3;
if ($frame_offset > strlen($parsed_frame['data'])) {
$frame_offset = strlen($parsed_frame['data']) - 1;
}
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['data'] = $parsed_frame['data'];
$parsed_frame['language'] = $frame_language;
$parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
$parsed_frame['description'] = $frame_description;
if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYLT')) || // 4.9 SYLT Synchronised lyric/text
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'SLT'))) { // 4.10 SLT Synchronised lyric/text
// There may be more than one 'SYLT' frame in each tag,
// but only one with the same language and content descriptor.
// <Header for 'Synchronised lyrics/text', ID: 'SYLT'>
// Text encoding $xx
// Language $xx xx xx
// Time stamp format $xx
// $01 (32-bit value) MPEG frames from beginning of file
// $02 (32-bit value) milliseconds from beginning of file
// Content type $xx
// Content descriptor <text string according to encoding> $00 (00)
// Terminated text to be synced (typically a syllable)
// Sync identifier (terminator to above string) $00 (00)
// Time stamp $xx (xx ...)
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_language = substr($parsed_frame['data'], $frame_offset, 3);
$frame_offset += 3;
$parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['contenttypeid'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['contenttype'] = getid3_id3v2::SYTLContentTypeLookup($parsed_frame['contenttypeid']);
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['language'] = $frame_language;
$parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
$timestamp_index = 0;
$frame_remaining_data = substr($parsed_frame['data'], $frame_offset);
while (strlen($frame_remaining_data)) {
$frame_offset = 0;
$frame_terminator_pos = strpos($frame_remaining_data, getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
if ($frame_terminator_pos === false) {
$frame_remaining_data = '';
} else {
if (ord(substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$parsed_frame['lyrics'][$timestamp_index]['data'] = substr($frame_remaining_data, $frame_offset, $frame_terminator_pos - $frame_offset);
$frame_remaining_data = substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
if (($timestamp_index == 0) && (ord($frame_remaining_data{0}) != 0)) {
// timestamp probably omitted for first data item
} else {
$parsed_frame['lyrics'][$timestamp_index]['timestamp'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 4));
$frame_remaining_data = substr($frame_remaining_data, 4);
}
$timestamp_index++;
}
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMM')) || // 4.10 COMM Comments
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'COM'))) { // 4.11 COM Comments
// There may be more than one comment frame in each tag,
// but only one with the same language and content descriptor.
// <Header for 'Comment', ID: 'COMM'>
// Text encoding $xx
// Language $xx xx xx
// Short content descrip. <text string according to encoding> $00 (00)
// The actual text <full text string according to encoding>
if (strlen($parsed_frame['data']) < 5) {
$getid3->warning('Invalid data (too short) for "'.$parsed_frame['frame_name'].'" frame at offset '.$parsed_frame['dataoffset']);
return true;
}
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_language = substr($parsed_frame['data'], $frame_offset, 3);
$frame_offset += 3;
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$frame_text = (string)substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['language'] = $frame_language;
$parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
$parsed_frame['description'] = $frame_description;
$parsed_frame['data'] = $frame_text;
if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
}
return true;
}
if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'RVA2')) { // 4.11 RVA2 Relative volume adjustment (2) (ID3v2.4+ only)
// There may be more than one 'RVA2' frame in each tag,
// but only one with the same identification string
// <Header for 'Relative volume adjustment (2)', ID: 'RVA2'>
// Identification <text string> $00
// The 'identification' string is used to identify the situation and/or
// device where this adjustment should apply. The following is then
// repeated for every channel:
// Type of channel $xx
// Volume adjustment $xx xx
// Bits representing peak $xx
// Peak volume $xx (xx ...)
$frame_terminator_pos = strpos($parsed_frame['data'], "\x00");
$frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos);
if (ord($frame_id_string) === 0) {
$frame_id_string = '';
}
$frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
$parsed_frame['description'] = $frame_id_string;
while (strlen($frame_remaining_data)) {
$frame_offset = 0;
$frame_channeltypeid = ord(substr($frame_remaining_data, $frame_offset++, 1));
$parsed_frame[$frame_channeltypeid]['channeltypeid'] = $frame_channeltypeid;
$parsed_frame[$frame_channeltypeid]['channeltype'] = getid3_id3v2::RVA2ChannelTypeLookup($frame_channeltypeid);
$parsed_frame[$frame_channeltypeid]['volumeadjust'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, 2), true); // 16-bit signed
$frame_offset += 2;
$parsed_frame[$frame_channeltypeid]['bitspeakvolume'] = ord(substr($frame_remaining_data, $frame_offset++, 1));
$frame_bytespeakvolume = ceil($parsed_frame[$frame_channeltypeid]['bitspeakvolume'] / 8);
$parsed_frame[$frame_channeltypeid]['peakvolume'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, $frame_bytespeakvolume));
$frame_remaining_data = substr($frame_remaining_data, $frame_offset + $frame_bytespeakvolume);
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'RVAD')) || // 4.12 RVAD Relative volume adjustment (ID3v2.3 only)
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'RVA'))) { // 4.12 RVA Relative volume adjustment (ID3v2.2 only)
// There may only be one 'RVA' frame in each tag
// <Header for 'Relative volume adjustment', ID: 'RVA'>
// ID3v2.2 => Increment/decrement %000000ba
// ID3v2.3 => Increment/decrement %00fedcba
// Bits used for volume descr. $xx
// Relative volume change, right $xx xx (xx ...) // a
// Relative volume change, left $xx xx (xx ...) // b
// Peak volume right $xx xx (xx ...)
// Peak volume left $xx xx (xx ...)
// ID3v2.3 only, optional (not present in ID3v2.2):
// Relative volume change, right back $xx xx (xx ...) // c
// Relative volume change, left back $xx xx (xx ...) // d
// Peak volume right back $xx xx (xx ...)
// Peak volume left back $xx xx (xx ...)
// ID3v2.3 only, optional (not present in ID3v2.2):
// Relative volume change, center $xx xx (xx ...) // e
// Peak volume center $xx xx (xx ...)
// ID3v2.3 only, optional (not present in ID3v2.2):
// Relative volume change, bass $xx xx (xx ...) // f
// Peak volume bass $xx xx (xx ...)
$frame_offset = 0;
$frame_incrdecrflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
$parsed_frame['incdec']['right'] = (bool)substr($frame_incrdecrflags, 6, 1);
$parsed_frame['incdec']['left'] = (bool)substr($frame_incrdecrflags, 7, 1);
$parsed_frame['bitsvolume'] = ord($parsed_frame['data']{$frame_offset++});
$frame_bytesvolume = ceil($parsed_frame['bitsvolume'] / 8);
$parsed_frame['volumechange']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
if ($parsed_frame['incdec']['right'] === false) {
$parsed_frame['volumechange']['right'] *= -1;
}
$frame_offset += $frame_bytesvolume;
$parsed_frame['volumechange']['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
if ($parsed_frame['incdec']['left'] === false) {
$parsed_frame['volumechange']['left'] *= -1;
}
$frame_offset += $frame_bytesvolume;
$parsed_frame['peakvolume']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
$frame_offset += $frame_bytesvolume;
$parsed_frame['peakvolume']['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
$frame_offset += $frame_bytesvolume;
if ($id3v2_major_version == 3) {
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
if (strlen($parsed_frame['data']) > 0) {
$parsed_frame['incdec']['rightrear'] = (bool)substr($frame_incrdecrflags, 4, 1);
$parsed_frame['incdec']['leftrear'] = (bool)substr($frame_incrdecrflags, 5, 1);
$parsed_frame['volumechange']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
if ($parsed_frame['incdec']['rightrear'] === false) {
$parsed_frame['volumechange']['rightrear'] *= -1;
}
$frame_offset += $frame_bytesvolume;
$parsed_frame['volumechange']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
if ($parsed_frame['incdec']['leftrear'] === false) {
$parsed_frame['volumechange']['leftrear'] *= -1;
}
$frame_offset += $frame_bytesvolume;
$parsed_frame['peakvolume']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
$frame_offset += $frame_bytesvolume;
$parsed_frame['peakvolume']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
$frame_offset += $frame_bytesvolume;
}
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
if (strlen($parsed_frame['data']) > 0) {
$parsed_frame['incdec']['center'] = (bool)substr($frame_incrdecrflags, 3, 1);
$parsed_frame['volumechange']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
if ($parsed_frame['incdec']['center'] === false) {
$parsed_frame['volumechange']['center'] *= -1;
}
$frame_offset += $frame_bytesvolume;
$parsed_frame['peakvolume']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
$frame_offset += $frame_bytesvolume;
}
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
if (strlen($parsed_frame['data']) > 0) {
$parsed_frame['incdec']['bass'] = (bool)substr($frame_incrdecrflags, 2, 1);
$parsed_frame['volumechange']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
if ($parsed_frame['incdec']['bass'] === false) {
$parsed_frame['volumechange']['bass'] *= -1;
}
$frame_offset += $frame_bytesvolume;
$parsed_frame['peakvolume']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
$frame_offset += $frame_bytesvolume;
}
}
unset($parsed_frame['data']);
return true;
}
if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'EQU2')) { // 4.12 EQU2 Equalisation (2) (ID3v2.4+ only)
// There may be more than one 'EQU2' frame in each tag,
// but only one with the same identification string
// <Header of 'Equalisation (2)', ID: 'EQU2'>
// Interpolation method $xx
// $00 Band
// $01 Linear
// Identification <text string> $00
// The following is then repeated for every adjustment point
// Frequency $xx xx
// Volume adjustment $xx xx
$frame_offset = 0;
$frame_interpolationmethod = ord($parsed_frame['data']{$frame_offset++});
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_id_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_id_string) === 0) {
$frame_id_string = '';
}
$parsed_frame['description'] = $frame_id_string;
$frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
while (strlen($frame_remaining_data)) {
$frame_frequency = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 2)) / 2;
$parsed_frame['data'][$frame_frequency] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, 2), true);
$frame_remaining_data = substr($frame_remaining_data, 4);
}
$parsed_frame['interpolationmethod'] = $frame_interpolationmethod;
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'EQUA')) || // 4.12 EQUA Equalisation (ID3v2.3 only)
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'EQU'))) { // 4.13 EQU Equalisation (ID3v2.2 only)
// There may only be one 'EQUA' frame in each tag
// <Header for 'Relative volume adjustment', ID: 'EQU'>
// Adjustment bits $xx
// This is followed by 2 bytes + ('adjustment bits' rounded up to the
// nearest byte) for every equalisation band in the following format,
// giving a frequency range of 0 - 32767Hz:
// Increment/decrement %x (MSB of the Frequency)
// Frequency (lower 15 bits)
// Adjustment $xx (xx ...)
$frame_offset = 0;
$parsed_frame['adjustmentbits'] = $parsed_frame['data']{$frame_offset++};
$frame_adjustment_bytes = ceil($parsed_frame['adjustmentbits'] / 8);
$frame_remaining_data = (string)substr($parsed_frame['data'], $frame_offset);
while (strlen($frame_remaining_data) > 0) {
$frame_frequencystr = getid3_lib::BigEndian2Bin(substr($frame_remaining_data, 0, 2));
$frame_incdec = (bool)substr($frame_frequencystr, 0, 1);
$frame_frequency = bindec(substr($frame_frequencystr, 1, 15));
$parsed_frame[$frame_frequency]['incdec'] = $frame_incdec;
$parsed_frame[$frame_frequency]['adjustment'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, $frame_adjustment_bytes));
if ($parsed_frame[$frame_frequency]['incdec'] === false) {
$parsed_frame[$frame_frequency]['adjustment'] *= -1;
}
$frame_remaining_data = substr($frame_remaining_data, 2 + $frame_adjustment_bytes);
}
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RVRB')) || // 4.13 RVRB Reverb
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'REV'))) { // 4.14 REV Reverb
// There may only be one 'RVRB' frame in each tag.
// <Header for 'Reverb', ID: 'RVRB'>
// Reverb left (ms) $xx xx
// Reverb right (ms) $xx xx
// Reverb bounces, left $xx
// Reverb bounces, right $xx
// Reverb feedback, left to left $xx
// Reverb feedback, left to right $xx
// Reverb feedback, right to right $xx
// Reverb feedback, right to left $xx
// Premix left to right $xx
// Premix right to left $xx
$frame_offset = 0;
$parsed_frame['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
$frame_offset += 2;
$parsed_frame['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
$frame_offset += 2;
$parsed_frame['bouncesL'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['bouncesR'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['feedbackLL'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['feedbackLR'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['feedbackRR'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['feedbackRL'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['premixLR'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['premixRL'] = ord($parsed_frame['data']{$frame_offset++});
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'APIC')) || // 4.14 APIC Attached picture
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'PIC'))) { // 4.15 PIC Attached picture
// There may be several pictures attached to one file,
// each in their individual 'APIC' frame, but only one
// with the same content descriptor
// <Header for 'Attached picture', ID: 'APIC'>
// Text encoding $xx
// ID3v2.3+ => MIME type <text string> $00
// ID3v2.2 => Image format $xx xx xx
// Picture type $xx
// Description <text string according to encoding> $00 (00)
// Picture data <binary data>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
if ($id3v2_major_version == 2 && strlen($parsed_frame['data']) > $frame_offset) {
$frame_imagetype = substr($parsed_frame['data'], $frame_offset, 3);
if (strtolower($frame_imagetype) == 'ima') {
// complete hack for mp3Rage (www.chaoticsoftware.com) that puts ID3v2.3-formatted
// MIME type instead of 3-char ID3v2.2-format image type (thanks xbhoffØpacbell*net)
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_mimetype) === 0) {
$frame_mimetype = '';
}
$frame_imagetype = strtoupper(str_replace('image/', '', strtolower($frame_mimetype)));
if ($frame_imagetype == 'JPEG') {
$frame_imagetype = 'JPG';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
} else {
$frame_offset += 3;
}
}
if ($id3v2_major_version > 2 && strlen($parsed_frame['data']) > $frame_offset) {
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_mimetype) === 0) {
$frame_mimetype = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
}
$frame_picturetype = ord($parsed_frame['data']{$frame_offset++});
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
if ($id3v2_major_version == 2) {
$parsed_frame['imagetype'] = $frame_imagetype;
} else {
$parsed_frame['mime'] = $frame_mimetype;
}
$parsed_frame['picturetypeid'] = $frame_picturetype;
$parsed_frame['picturetype'] = getid3_id3v2::APICPictureTypeLookup($frame_picturetype);
$parsed_frame['description'] = $frame_description;
$parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
if ($getid3->option_tags_images) {
$image_chunk_check = getid3_lib_image_size::get($parsed_frame['data']);
if (($image_chunk_check[2] >= 1) && ($image_chunk_check[2] <= 3)) {
$parsed_frame['image_mime'] = image_type_to_mime_type($image_chunk_check[2]);
if ($image_chunk_check[0]) {
$parsed_frame['image_width'] = $image_chunk_check[0];
}
if ($image_chunk_check[1]) {
$parsed_frame['image_height'] = $image_chunk_check[1];
}
$parsed_frame['image_bytes'] = strlen($parsed_frame['data']);
}
}
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GEOB')) || // 4.15 GEOB General encapsulated object
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'GEO'))) { // 4.16 GEO General encapsulated object
// There may be more than one 'GEOB' frame in each tag,
// but only one with the same content descriptor
// <Header for 'General encapsulated object', ID: 'GEOB'>
// Text encoding $xx
// MIME type <text string> $00
// Filename <text string according to encoding> $00 (00)
// Content description <text string according to encoding> $00 (00)
// Encapsulated object <binary data>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_mimetype) === 0) {
$frame_mimetype = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_filename = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_filename) === 0) {
$frame_filename = '';
}
$frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
$parsed_frame['objectdata'] = (string)substr($parsed_frame['data'], $frame_offset);
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['mime'] = $frame_mimetype;
$parsed_frame['filename'] = $frame_filename;
$parsed_frame['description'] = $frame_description;
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PCNT')) || // 4.16 PCNT Play counter
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CNT'))) { // 4.17 CNT Play counter
// There may only be one 'PCNT' frame in each tag.
// When the counter reaches all one's, one byte is inserted in
// front of the counter thus making the counter eight bits bigger
// <Header for 'Play counter', ID: 'PCNT'>
// Counter $xx xx xx xx (xx ...)
$parsed_frame['data'] = getid3_lib::BigEndian2Int($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POPM')) || // 4.17 POPM Popularimeter
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'POP'))) { // 4.18 POP Popularimeter
// There may be more than one 'POPM' frame in each tag,
// but only one with the same email address
// <Header for 'Popularimeter', ID: 'POPM'>
// Email to user <text string> $00
// Rating $xx
// Counter $xx xx xx xx (xx ...)
$frame_offset = 0;
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_email_address = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_email_address) === 0) {
$frame_email_address = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$frame_rating = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset));
$parsed_frame['email'] = $frame_email_address;
$parsed_frame['rating'] = $frame_rating;
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RBUF')) || // 4.18 RBUF Recommended buffer size
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'BUF'))) { // 4.19 BUF Recommended buffer size
// There may only be one 'RBUF' frame in each tag
// <Header for 'Recommended buffer size', ID: 'RBUF'>
// Buffer size $xx xx xx
// Embedded info flag %0000000x
// Offset to next tag $xx xx xx xx
$frame_offset = 0;
$parsed_frame['buffersize'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 3));
$frame_offset += 3;
$frame_embeddedinfoflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
$parsed_frame['flags']['embededinfo'] = (bool)substr($frame_embeddedinfoflags, 7, 1);
$parsed_frame['nexttagoffset'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
unset($parsed_frame['data']);
return true;
}
if (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRM')) { // 4.20 Encrypted meta frame (ID3v2.2 only)
// There may be more than one 'CRM' frame in a tag,
// but only one with the same 'owner identifier'
// <Header for 'Encrypted meta frame', ID: 'CRM'>
// Owner identifier <textstring> $00 (00)
// Content/explanation <textstring> $00 (00)
// Encrypted datablock <binary data>
$frame_offset = 0;
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
$frame_offset = $frame_terminator_pos + strlen("\x00");
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$parsed_frame['ownerid'] = $frame_owner_id;
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
$parsed_frame['description'] = $frame_description;
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'AENC')) || // 4.19 AENC Audio encryption
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRA'))) { // 4.21 CRA Audio encryption
// There may be more than one 'AENC' frames in a tag,
// but only one with the same 'Owner identifier'
// <Header for 'Audio encryption', ID: 'AENC'>
// Owner identifier <text string> $00
// Preview start $xx xx
// Preview length $xx xx
// Encryption info <binary data>
$frame_offset = 0;
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_owner_id) === 0) {
$frame_owner_id == '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$parsed_frame['ownerid'] = $frame_owner_id;
$parsed_frame['previewstart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
$frame_offset += 2;
$parsed_frame['previewlength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
$frame_offset += 2;
$parsed_frame['encryptioninfo'] = (string)substr($parsed_frame['data'], $frame_offset);
unset($parsed_frame['data']);
return true;
}
if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'LINK')) || // 4.20 LINK Linked information
(($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'LNK'))) { // 4.22 LNK Linked information
// There may be more than one 'LINK' frame in a tag,
// but only one with the same contents
// <Header for 'Linked information', ID: 'LINK'>
// ID3v2.3+ => Frame identifier $xx xx xx xx
// ID3v2.2 => Frame identifier $xx xx xx
// URL <text string> $00
// ID and additional data <text string(s)>
$frame_offset = 0;
if ($id3v2_major_version == 2) {
$parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 3);
$frame_offset += 3;
} else {
$parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 4);
$frame_offset += 4;
}
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_url = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_url) === 0) {
$frame_url = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$parsed_frame['url'] = $frame_url;
$parsed_frame['additionaldata'] = (string)substr($parsed_frame['data'], $frame_offset);
if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = utf8_encode($parsed_frame['url']);
}
unset($parsed_frame['data']);
return true;
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POSS')) { // 4.21 POSS Position synchronisation frame (ID3v2.3+ only)
// There may only be one 'POSS' frame in each tag
// <Head for 'Position synchronisation', ID: 'POSS'>
// Time stamp format $xx
// Position $xx (xx ...)
$frame_offset = 0;
$parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['position'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset));
unset($parsed_frame['data']);
return true;
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USER')) { // 4.22 USER Terms of use (ID3v2.3+ only)
// There may be more than one 'Terms of use' frame in a tag,
// but only one with the same 'Language'
// <Header for 'Terms of use frame', ID: 'USER'>
// Text encoding $xx
// Language $xx xx xx
// The actual text <text string according to encoding>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_language = substr($parsed_frame['data'], $frame_offset, 3);
$frame_offset += 3;
$parsed_frame['language'] = $frame_language;
$parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
$getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
}
unset($parsed_frame['data']);
return true;
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'OWNE')) { // 4.23 OWNE Ownership frame (ID3v2.3+ only)
// There may only be one 'OWNE' frame in a tag
// <Header for 'Ownership frame', ID: 'OWNE'>
// Text encoding $xx
// Price paid <text string> $00
// Date of purch. <text string>
// Seller <text string according to encoding>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_pricepaid = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
$frame_offset = $frame_terminator_pos + strlen("\x00");
$parsed_frame['pricepaid']['currencyid'] = substr($frame_pricepaid, 0, 3);
$parsed_frame['pricepaid']['currency'] = getid3_id3v2::LookupCurrencyUnits($parsed_frame['pricepaid']['currencyid']);
$parsed_frame['pricepaid']['value'] = substr($frame_pricepaid, 3);
$parsed_frame['purchasedate'] = substr($parsed_frame['data'], $frame_offset, 8);
if (!getid3_id3v2::IsValidDateStampString($parsed_frame['purchasedate'])) {
$parsed_frame['purchasedateunix'] = gmmktime (0, 0, 0, substr($parsed_frame['purchasedate'], 4, 2), substr($parsed_frame['purchasedate'], 6, 2), substr($parsed_frame['purchasedate'], 0, 4));
}
$frame_offset += 8;
$parsed_frame['seller'] = (string)substr($parsed_frame['data'], $frame_offset);
unset($parsed_frame['data']);
return true;
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMR')) { // 4.24 COMR Commercial frame (ID3v2.3+ only)
// There may be more than one 'commercial frame' in a tag,
// but no two may be identical
// <Header for 'Commercial frame', ID: 'COMR'>
// Text encoding $xx
// Price string <text string> $00
// Valid until <text string>
// Contact URL <text string> $00
// Received as $xx
// Name of seller <text string according to encoding> $00 (00)
// Description <text string according to encoding> $00 (00)
// Picture MIME type <string> $00
// Seller logo <binary data>
$frame_offset = 0;
$frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
$getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
}
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_price_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
$frame_offset = $frame_terminator_pos + strlen("\x00");
$frame_rawpricearray = explode('/', $frame_price_string);
foreach ($frame_rawpricearray as $key => $val) {
$frame_currencyid = substr($val, 0, 3);
$parsed_frame['price'][$frame_currencyid]['currency'] = getid3_id3v2::LookupCurrencyUnits($frame_currencyid);
$parsed_frame['price'][$frame_currencyid]['value'] = substr($val, 3);
}
$frame_date_string = substr($parsed_frame['data'], $frame_offset, 8);
$frame_offset += 8;
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_contacturl = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
$frame_offset = $frame_terminator_pos + strlen("\x00");
$frame_received_as_id = ord($parsed_frame['data']{$frame_offset++});
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_sellername = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_sellername) === 0) {
$frame_sellername = '';
}
$frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
$frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
$frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
}
$frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_description) === 0) {
$frame_description = '';
}
$frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
$frame_offset = $frame_terminator_pos + strlen("\x00");
$frame_sellerlogo = substr($parsed_frame['data'], $frame_offset);
$parsed_frame['encodingid'] = $frame_text_encoding;
$parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
$parsed_frame['pricevaliduntil'] = $frame_date_string;
$parsed_frame['contacturl'] = $frame_contacturl;
$parsed_frame['receivedasid'] = $frame_received_as_id;
$parsed_frame['receivedas'] = getid3_id3v2::COMRReceivedAsLookup($frame_received_as_id);
$parsed_frame['sellername'] = $frame_sellername;
$parsed_frame['description'] = $frame_description;
$parsed_frame['mime'] = $frame_mimetype;
$parsed_frame['logo'] = $frame_sellerlogo;
unset($parsed_frame['data']);
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ENCR')) { // 4.25 ENCR Encryption method registration (ID3v2.3+ only)
// There may be several 'ENCR' frames in a tag,
// but only one containing the same symbol
// and only one containing the same owner identifier
// <Header for 'Encryption method registration', ID: 'ENCR'>
// Owner identifier <text string> $00
// Method symbol $xx
// Encryption data <binary data>
$frame_offset = 0;
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_owner_id) === 0) {
$frame_owner_id = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$parsed_frame['ownerid'] = $frame_owner_id;
$parsed_frame['methodsymbol'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
return true;
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GRID')) { // 4.26 GRID Group identification registration (ID3v2.3+ only)
// There may be several 'GRID' frames in a tag,
// but only one containing the same symbol
// and only one containing the same owner identifier
// <Header for 'Group ID registration', ID: 'GRID'>
// Owner identifier <text string> $00
// Group symbol $xx
// Group dependent data <binary data>
$frame_offset = 0;
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_owner_id) === 0) {
$frame_owner_id = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$parsed_frame['ownerid'] = $frame_owner_id;
$parsed_frame['groupsymbol'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
return true;
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PRIV')) { // 4.27 PRIV Private frame (ID3v2.3+ only)
// The tag may contain more than one 'PRIV' frame
// but only with different contents
// <Header for 'Private frame', ID: 'PRIV'>
// Owner identifier <text string> $00
// The private data <binary data>
$frame_offset = 0;
$frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
$frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
if (ord($frame_owner_id) === 0) {
$frame_owner_id = '';
}
$frame_offset = $frame_terminator_pos + strlen("\x00");
$parsed_frame['ownerid'] = $frame_owner_id;
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
return true;
}
if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SIGN')) { // 4.28 SIGN Signature frame (ID3v2.4+ only)
// There may be more than one 'signature frame' in a tag,
// but no two may be identical
// <Header for 'Signature frame', ID: 'SIGN'>
// Group symbol $xx
// Signature <binary data>
$frame_offset = 0;
$parsed_frame['groupsymbol'] = ord($parsed_frame['data']{$frame_offset++});
$parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
return true;
}
if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SEEK')) { // 4.29 SEEK Seek frame (ID3v2.4+ only)
// There may only be one 'seek frame' in a tag
// <Header for 'Seek frame', ID: 'SEEK'>
// Minimum offset to next tag $xx xx xx xx
$frame_offset = 0;
$parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
return true;
}
if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'ASPI')) { // 4.30 ASPI Audio seek point index (ID3v2.4+ only)
// There may only be one 'audio seek point index' frame in a tag
// <Header for 'Seek Point Index', ID: 'ASPI'>
// Indexed data start (S) $xx xx xx xx
// Indexed data length (L) $xx xx xx xx
// Number of index points (N) $xx xx
// Bits per index point (b) $xx
// Then for every index point the following data is included:
// Fraction at index (Fi) $xx (xx)
$frame_offset = 0;
$parsed_frame['datastart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
$frame_offset += 4;
$parsed_frame['indexeddatalength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
$frame_offset += 4;
$parsed_frame['indexpoints'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
$frame_offset += 2;
$parsed_frame['bitsperpoint'] = ord($parsed_frame['data']{$frame_offset++});
$frame_bytesperpoint = ceil($parsed_frame['bitsperpoint'] / 8);
for ($i = 0; $i < $frame_indexpoints; $i++) {
$parsed_frame['indexes'][$i] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesperpoint));
$frame_offset += $frame_bytesperpoint;
}
unset($parsed_frame['data']);
return true;
}
if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RGAD')) { // Replay Gain Adjustment
// http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html
// There may only be one 'RGAD' frame in a tag
// <Header for 'Replay Gain Adjustment', ID: 'RGAD'>
// Peak Amplitude $xx $xx $xx $xx
// Radio Replay Gain Adjustment %aaabbbcd %dddddddd
// Audiophile Replay Gain Adjustment %aaabbbcd %dddddddd
// a - name code
// b - originator code
// c - sign bit
// d - replay gain adjustment
$frame_offset = 0;
$parsed_frame['peakamplitude'] = (float)getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
$frame_offset += 4;
$rg_track_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2));
$frame_offset += 2;
$rg_album_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2));
$frame_offset += 2;
$parsed_frame['raw']['track']['name'] = bindec(substr($rg_track_adjustment, 0, 3));
$parsed_frame['raw']['track']['originator'] = bindec(substr($rg_track_adjustment, 3, 3));
$parsed_frame['raw']['track']['signbit'] = bindec($rg_track_adjustment[6]);
$parsed_frame['raw']['track']['adjustment'] = bindec(substr($rg_track_adjustment, 7, 9));
$parsed_frame['raw']['album']['name'] = bindec(substr($rg_album_adjustment, 0, 3));
$parsed_frame['raw']['album']['originator'] = bindec(substr($rg_album_adjustment, 3, 3));
$parsed_frame['raw']['album']['signbit'] = bindec($rg_album_adjustment[6]);
$parsed_frame['raw']['album']['adjustment'] = bindec(substr($rg_album_adjustment, 7, 9));
$parsed_frame['track']['name'] = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['track']['name']);
$parsed_frame['track']['originator'] = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['track']['originator']);
$parsed_frame['track']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['track']['adjustment'], $parsed_frame['raw']['track']['signbit']);
$parsed_frame['album']['name'] = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['album']['name']);
$parsed_frame['album']['originator'] = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['album']['originator']);
$parsed_frame['album']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['album']['adjustment'], $parsed_frame['raw']['album']['signbit']);
$getid3->info['replay_gain']['track']['peak'] = $parsed_frame['peakamplitude'];
$getid3->info['replay_gain']['track']['originator'] = $parsed_frame['track']['originator'];
$getid3->info['replay_gain']['track']['adjustment'] = $parsed_frame['track']['adjustment'];
$getid3->info['replay_gain']['album']['originator'] = $parsed_frame['album']['originator'];
$getid3->info['replay_gain']['album']['adjustment'] = $parsed_frame['album']['adjustment'];
unset($parsed_frame['data']);
return true;
}
return true;
}
private function TextEncodingNameLookup($encoding) {
// Override specification - BRAINDEAD taggers
if (!$encoding) {
return $this->getid3->encoding_id3v2;
}
// http://www.id3.org/id3v2.4.0-structure.txt
static $lookup = array (
0 => 'ISO-8859-1',
1 => 'UTF-16',
2 => 'UTF-16BE',
3 => 'UTF-8',
255 => 'UTF-16BE'
);
return (isset($lookup[$encoding]) ? $lookup[$encoding] : 'ISO-8859-1');
}
public static function ParseID3v2GenreString($genre_string) {
// Parse genres into arrays of genreName and genreID
// ID3v2.2.x, ID3v2.3.x: '(21)' or '(4)Eurodisco' or '(51)(39)' or '(55)((I think...)'
// ID3v2.4.x: '21' $00 'Eurodisco' $00
$genre_string = trim($genre_string);
$return_array = array ();
if (strpos($genre_string, "\x00") !== false) {
$unprocessed = trim($genre_string); // trailing nulls will cause an infinite loop.
$genre_string = '';
while (strpos($unprocessed, "\x00") !== false) {
// convert null-seperated v2.4-format into v2.3 ()-seperated format
$end_pos = strpos($unprocessed, "\x00");
$genre_string .= '('.substr($unprocessed, 0, $end_pos).')';
$unprocessed = substr($unprocessed, $end_pos + 1);
}
unset($unprocessed);
}
if (getid3_id3v1::LookupGenreID($genre_string)) {
$return_array['genre'][] = $genre_string;
} else {
while (strpos($genre_string, '(') !== false) {
$start_pos = strpos($genre_string, '(');
$end_pos = strpos($genre_string, ')');
if (substr($genre_string, $start_pos + 1, 1) == '(') {
$genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $start_pos + 1);
$end_pos--;
}
$element = substr($genre_string, $start_pos + 1, $end_pos - ($start_pos + 1));
$genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $end_pos + 1);
if (getid3_id3v1::LookupGenreName($element)) { // $element is a valid genre id/abbreviation
if (empty($return_array['genre']) || !in_array(getid3_id3v1::LookupGenreName($element), $return_array['genre'])) { // avoid duplicate entires
$return_array['genre'][] = getid3_id3v1::LookupGenreName($element);
}
} else {
if (empty($return_array['genre']) || !in_array($element, $return_array['genre'])) { // avoid duplicate entires
$return_array['genre'][] = $element;
}
}
}
}
if ($genre_string) {
if (empty($return_array['genre']) || !in_array($genre_string, $return_array['genre'])) { // avoid duplicate entires
$return_array['genre'][] = $genre_string;
}
}
return $return_array;
}
public static function LookupCurrencyUnits($currency_id) {
static $lookup = array (
'AED' => 'Dirhams',
'AFA' => 'Afghanis',
'ALL' => 'Leke',
'AMD' => 'Drams',
'ANG' => 'Guilders',
'AOA' => 'Kwanza',
'ARS' => 'Pesos',
'ATS' => 'Schillings',
'AUD' => 'Dollars',
'AWG' => 'Guilders',
'AZM' => 'Manats',
'BAM' => 'Convertible Marka',
'BBD' => 'Dollars',
'BDT' => 'Taka',
'BEF' => 'Francs',
'BGL' => 'Leva',
'BHD' => 'Dinars',
'BIF' => 'Francs',
'BMD' => 'Dollars',
'BND' => 'Dollars',
'BOB' => 'Bolivianos',
'BRL' => 'Brazil Real',
'BSD' => 'Dollars',
'BTN' => 'Ngultrum',
'BWP' => 'Pulas',
'BYR' => 'Rubles',
'BZD' => 'Dollars',
'CAD' => 'Dollars',
'CDF' => 'Congolese Francs',
'CHF' => 'Francs',
'CLP' => 'Pesos',
'CNY' => 'Yuan Renminbi',
'COP' => 'Pesos',
'CRC' => 'Colones',
'CUP' => 'Pesos',
'CVE' => 'Escudos',
'CYP' => 'Pounds',
'CZK' => 'Koruny',
'DEM' => 'Deutsche Marks',
'DJF' => 'Francs',
'DKK' => 'Kroner',
'DOP' => 'Pesos',
'DZD' => 'Algeria Dinars',
'EEK' => 'Krooni',
'EGP' => 'Pounds',
'ERN' => 'Nakfa',
'ESP' => 'Pesetas',
'ETB' => 'Birr',
'EUR' => 'Euro',
'FIM' => 'Markkaa',
'FJD' => 'Dollars',
'FKP' => 'Pounds',
'FRF' => 'Francs',
'GBP' => 'Pounds',
'GEL' => 'Lari',
'GGP' => 'Pounds',
'GHC' => 'Cedis',
'GIP' => 'Pounds',
'GMD' => 'Dalasi',
'GNF' => 'Francs',
'GRD' => 'Drachmae',
'GTQ' => 'Quetzales',
'GYD' => 'Dollars',
'HKD' => 'Dollars',
'HNL' => 'Lempiras',
'HRK' => 'Kuna',
'HTG' => 'Gourdes',
'HUF' => 'Forints',
'IDR' => 'Rupiahs',
'IEP' => 'Pounds',
'ILS' => 'New Shekels',
'IMP' => 'Pounds',
'INR' => 'Rupees',
'IQD' => 'Dinars',
'IRR' => 'Rials',
'ISK' => 'Kronur',
'ITL' => 'Lire',
'JEP' => 'Pounds',
'JMD' => 'Dollars',
'JOD' => 'Dinars',
'JPY' => 'Yen',
'KES' => 'Shillings',
'KGS' => 'Soms',
'KHR' => 'Riels',
'KMF' => 'Francs',
'KPW' => 'Won',
'KWD' => 'Dinars',
'KYD' => 'Dollars',
'KZT' => 'Tenge',
'LAK' => 'Kips',
'LBP' => 'Pounds',
'LKR' => 'Rupees',
'LRD' => 'Dollars',
'LSL' => 'Maloti',
'LTL' => 'Litai',
'LUF' => 'Francs',
'LVL' => 'Lati',
'LYD' => 'Dinars',
'MAD' => 'Dirhams',
'MDL' => 'Lei',
'MGF' => 'Malagasy Francs',
'MKD' => 'Denars',
'MMK' => 'Kyats',
'MNT' => 'Tugriks',
'MOP' => 'Patacas',
'MRO' => 'Ouguiyas',
'MTL' => 'Liri',
'MUR' => 'Rupees',
'MVR' => 'Rufiyaa',
'MWK' => 'Kwachas',
'MXN' => 'Pesos',
'MYR' => 'Ringgits',
'MZM' => 'Meticais',
'NAD' => 'Dollars',
'NGN' => 'Nairas',
'NIO' => 'Gold Cordobas',
'NLG' => 'Guilders',
'NOK' => 'Krone',
'NPR' => 'Nepal Rupees',
'NZD' => 'Dollars',
'OMR' => 'Rials',
'PAB' => 'Balboa',
'PEN' => 'Nuevos Soles',
'PGK' => 'Kina',
'PHP' => 'Pesos',
'PKR' => 'Rupees',
'PLN' => 'Zlotych',
'PTE' => 'Escudos',
'PYG' => 'Guarani',
'QAR' => 'Rials',
'ROL' => 'Lei',
'RUR' => 'Rubles',
'RWF' => 'Rwanda Francs',
'SAR' => 'Riyals',
'SBD' => 'Dollars',
'SCR' => 'Rupees',
'SDD' => 'Dinars',
'SEK' => 'Kronor',
'SGD' => 'Dollars',
'SHP' => 'Pounds',
'SIT' => 'Tolars',
'SKK' => 'Koruny',
'SLL' => 'Leones',
'SOS' => 'Shillings',
'SPL' => 'Luigini',
'SRG' => 'Guilders',
'STD' => 'Dobras',
'SVC' => 'Colones',
'SYP' => 'Pounds',
'SZL' => 'Emalangeni',
'THB' => 'Baht',
'TJR' => 'Rubles',
'TMM' => 'Manats',
'TND' => 'Dinars',
'TOP' => 'Pa\'anga',
'TRL' => 'Liras',
'TTD' => 'Dollars',
'TVD' => 'Tuvalu Dollars',
'TWD' => 'New Dollars',
'TZS' => 'Shillings',
'UAH' => 'Hryvnia',
'UGX' => 'Shillings',
'USD' => 'Dollars',
'UYU' => 'Pesos',
'UZS' => 'Sums',
'VAL' => 'Lire',
'VEB' => 'Bolivares',
'VND' => 'Dong',
'VUV' => 'Vatu',
'WST' => 'Tala',
'XAF' => 'Francs',
'XAG' => 'Ounces',
'XAU' => 'Ounces',
'XCD' => 'Dollars',
'XDR' => 'Special Drawing Rights',
'XPD' => 'Ounces',
'XPF' => 'Francs',
'XPT' => 'Ounces',
'YER' => 'Rials',
'YUM' => 'New Dinars',
'ZAR' => 'Rand',
'ZMK' => 'Kwacha',
'ZWD' => 'Zimbabwe Dollars'
);
return @$lookup[$currency_id];
}
public static function LookupCurrencyCountry($currency_id) {
static $lookup = array (
'AED' => 'United Arab Emirates',
'AFA' => 'Afghanistan',
'ALL' => 'Albania',
'AMD' => 'Armenia',
'ANG' => 'Netherlands Antilles',
'AOA' => 'Angola',
'ARS' => 'Argentina',
'ATS' => 'Austria',
'AUD' => 'Australia',
'AWG' => 'Aruba',
'AZM' => 'Azerbaijan',
'BAM' => 'Bosnia and Herzegovina',
'BBD' => 'Barbados',
'BDT' => 'Bangladesh',
'BEF' => 'Belgium',
'BGL' => 'Bulgaria',
'BHD' => 'Bahrain',
'BIF' => 'Burundi',
'BMD' => 'Bermuda',
'BND' => 'Brunei Darussalam',
'BOB' => 'Bolivia',
'BRL' => 'Brazil',
'BSD' => 'Bahamas',
'BTN' => 'Bhutan',
'BWP' => 'Botswana',
'BYR' => 'Belarus',
'BZD' => 'Belize',
'CAD' => 'Canada',
'CDF' => 'Congo/Kinshasa',
'CHF' => 'Switzerland',
'CLP' => 'Chile',
'CNY' => 'China',
'COP' => 'Colombia',
'CRC' => 'Costa Rica',
'CUP' => 'Cuba',
'CVE' => 'Cape Verde',
'CYP' => 'Cyprus',
'CZK' => 'Czech Republic',
'DEM' => 'Germany',
'DJF' => 'Djibouti',
'DKK' => 'Denmark',
'DOP' => 'Dominican Republic',
'DZD' => 'Algeria',
'EEK' => 'Estonia',
'EGP' => 'Egypt',
'ERN' => 'Eritrea',
'ESP' => 'Spain',
'ETB' => 'Ethiopia',
'EUR' => 'Euro Member Countries',
'FIM' => 'Finland',
'FJD' => 'Fiji',
'FKP' => 'Falkland Islands (Malvinas)',
'FRF' => 'France',
'GBP' => 'United Kingdom',
'GEL' => 'Georgia',
'GGP' => 'Guernsey',
'GHC' => 'Ghana',
'GIP' => 'Gibraltar',
'GMD' => 'Gambia',
'GNF' => 'Guinea',
'GRD' => 'Greece',
'GTQ' => 'Guatemala',
'GYD' => 'Guyana',
'HKD' => 'Hong Kong',
'HNL' => 'Honduras',
'HRK' => 'Croatia',
'HTG' => 'Haiti',
'HUF' => 'Hungary',
'IDR' => 'Indonesia',
'IEP' => 'Ireland (Eire)',
'ILS' => 'Israel',
'IMP' => 'Isle of Man',
'INR' => 'India',
'IQD' => 'Iraq',
'IRR' => 'Iran',
'ISK' => 'Iceland',
'ITL' => 'Italy',
'JEP' => 'Jersey',
'JMD' => 'Jamaica',
'JOD' => 'Jordan',
'JPY' => 'Japan',
'KES' => 'Kenya',
'KGS' => 'Kyrgyzstan',
'KHR' => 'Cambodia',
'KMF' => 'Comoros',
'KPW' => 'Korea',
'KWD' => 'Kuwait',
'KYD' => 'Cayman Islands',
'KZT' => 'Kazakstan',
'LAK' => 'Laos',
'LBP' => 'Lebanon',
'LKR' => 'Sri Lanka',
'LRD' => 'Liberia',
'LSL' => 'Lesotho',
'LTL' => 'Lithuania',
'LUF' => 'Luxembourg',
'LVL' => 'Latvia',
'LYD' => 'Libya',
'MAD' => 'Morocco',
'MDL' => 'Moldova',
'MGF' => 'Madagascar',
'MKD' => 'Macedonia',
'MMK' => 'Myanmar (Burma)',
'MNT' => 'Mongolia',
'MOP' => 'Macau',
'MRO' => 'Mauritania',
'MTL' => 'Malta',
'MUR' => 'Mauritius',
'MVR' => 'Maldives (Maldive Islands)',
'MWK' => 'Malawi',
'MXN' => 'Mexico',
'MYR' => 'Malaysia',
'MZM' => 'Mozambique',
'NAD' => 'Namibia',
'NGN' => 'Nigeria',
'NIO' => 'Nicaragua',
'NLG' => 'Netherlands (Holland)',
'NOK' => 'Norway',
'NPR' => 'Nepal',
'NZD' => 'New Zealand',
'OMR' => 'Oman',
'PAB' => 'Panama',
'PEN' => 'Peru',
'PGK' => 'Papua New Guinea',
'PHP' => 'Philippines',
'PKR' => 'Pakistan',
'PLN' => 'Poland',
'PTE' => 'Portugal',
'PYG' => 'Paraguay',
'QAR' => 'Qatar',
'ROL' => 'Romania',
'RUR' => 'Russia',
'RWF' => 'Rwanda',
'SAR' => 'Saudi Arabia',
'SBD' => 'Solomon Islands',
'SCR' => 'Seychelles',
'SDD' => 'Sudan',
'SEK' => 'Sweden',
'SGD' => 'Singapore',
'SHP' => 'Saint Helena',
'SIT' => 'Slovenia',
'SKK' => 'Slovakia',
'SLL' => 'Sierra Leone',
'SOS' => 'Somalia',
'SPL' => 'Seborga',
'SRG' => 'Suriname',
'STD' => 'São Tome and Principe',
'SVC' => 'El Salvador',
'SYP' => 'Syria',
'SZL' => 'Swaziland',
'THB' => 'Thailand',
'TJR' => 'Tajikistan',
'TMM' => 'Turkmenistan',
'TND' => 'Tunisia',
'TOP' => 'Tonga',
'TRL' => 'Turkey',
'TTD' => 'Trinidad and Tobago',
'TVD' => 'Tuvalu',
'TWD' => 'Taiwan',
'TZS' => 'Tanzania',
'UAH' => 'Ukraine',
'UGX' => 'Uganda',
'USD' => 'United States of America',
'UYU' => 'Uruguay',
'UZS' => 'Uzbekistan',
'VAL' => 'Vatican City',
'VEB' => 'Venezuela',
'VND' => 'Viet Nam',
'VUV' => 'Vanuatu',
'WST' => 'Samoa',
'XAF' => 'Communauté Financière Africaine',
'XAG' => 'Silver',
'XAU' => 'Gold',
'XCD' => 'East Caribbean',
'XDR' => 'International Monetary Fund',
'XPD' => 'Palladium',
'XPF' => 'Comptoirs Français du Pacifique',
'XPT' => 'Platinum',
'YER' => 'Yemen',
'YUM' => 'Yugoslavia',
'ZAR' => 'South Africa',
'ZMK' => 'Zambia',
'ZWD' => 'Zimbabwe'
);
return @$lookup[$currency_id];
}
public static function LanguageLookup($language_code, $case_sensitive=false) {
if (!$case_sensitive) {
$language_code = strtolower($language_code);
}
// http://www.id3.org/id3v2.4.0-structure.txt
// [4. ID3v2 frame overview]
// The three byte language field, present in several frames, is used to
// describe the language of the frame's content, according to ISO-639-2
// [ISO-639-2]. The language should be represented in lower case. If the
// language is not known the string "XXX" should be used.
// ISO 639-2 - http://www.id3.org/iso639-2.html
static $lookup = array (
'XXX' => 'unknown',
'xxx' => 'unknown',
'aar' => 'Afar',
'abk' => 'Abkhazian',
'ace' => 'Achinese',
'ach' => 'Acoli',
'ada' => 'Adangme',
'afa' => 'Afro-Asiatic (Other)',
'afh' => 'Afrihili',
'afr' => 'Afrikaans',
'aka' => 'Akan',
'akk' => 'Akkadian',
'alb' => 'Albanian',
'ale' => 'Aleut',
'alg' => 'Algonquian Languages',
'amh' => 'Amharic',
'ang' => 'English, Old (ca. 450-1100)',
'apa' => 'Apache Languages',
'ara' => 'Arabic',
'arc' => 'Aramaic',
'arm' => 'Armenian',
'arn' => 'Araucanian',
'arp' => 'Arapaho',
'art' => 'Artificial (Other)',
'arw' => 'Arawak',
'asm' => 'Assamese',
'ath' => 'Athapascan Languages',
'ava' => 'Avaric',
'ave' => 'Avestan',
'awa' => 'Awadhi',
'aym' => 'Aymara',
'aze' => 'Azerbaijani',
'bad' => 'Banda',
'bai' => 'Bamileke Languages',
'bak' => 'Bashkir',
'bal' => 'Baluchi',
'bam' => 'Bambara',
'ban' => 'Balinese',
'baq' => 'Basque',
'bas' => 'Basa',
'bat' => 'Baltic (Other)',
'bej' => 'Beja',
'bel' => 'Byelorussian',
'bem' => 'Bemba',
'ben' => 'Bengali',
'ber' => 'Berber (Other)',
'bho' => 'Bhojpuri',
'bih' => 'Bihari',
'bik' => 'Bikol',
'bin' => 'Bini',
'bis' => 'Bislama',
'bla' => 'Siksika',
'bnt' => 'Bantu (Other)',
'bod' => 'Tibetan',
'bra' => 'Braj',
'bre' => 'Breton',
'bua' => 'Buriat',
'bug' => 'Buginese',
'bul' => 'Bulgarian',
'bur' => 'Burmese',
'cad' => 'Caddo',
'cai' => 'Central American Indian (Other)',
'car' => 'Carib',
'cat' => 'Catalan',
'cau' => 'Caucasian (Other)',
'ceb' => 'Cebuano',
'cel' => 'Celtic (Other)',
'ces' => 'Czech',
'cha' => 'Chamorro',
'chb' => 'Chibcha',
'che' => 'Chechen',
'chg' => 'Chagatai',
'chi' => 'Chinese',
'chm' => 'Mari',
'chn' => 'Chinook jargon',
'cho' => 'Choctaw',
'chr' => 'Cherokee',
'chu' => 'Church Slavic',
'chv' => 'Chuvash',
'chy' => 'Cheyenne',
'cop' => 'Coptic',
'cor' => 'Cornish',
'cos' => 'Corsican',
'cpe' => 'Creoles and Pidgins, English-based (Other)',
'cpf' => 'Creoles and Pidgins, French-based (Other)',
'cpp' => 'Creoles and Pidgins, Portuguese-based (Other)',
'cre' => 'Cree',
'crp' => 'Creoles and Pidgins (Other)',
'cus' => 'Cushitic (Other)',
'cym' => 'Welsh',
'cze' => 'Czech',
'dak' => 'Dakota',
'dan' => 'Danish',
'del' => 'Delaware',
'deu' => 'German',
'din' => 'Dinka',
'div' => 'Divehi',
'doi' => 'Dogri',
'dra' => 'Dravidian (Other)',
'dua' => 'Duala',
'dum' => 'Dutch, Middle (ca. 1050-1350)',
'dut' => 'Dutch',
'dyu' => 'Dyula',
'dzo' => 'Dzongkha',
'efi' => 'Efik',
'egy' => 'Egyptian (Ancient)',
'eka' => 'Ekajuk',
'ell' => 'Greek, Modern (1453-)',
'elx' => 'Elamite',
'eng' => 'English',
'enm' => 'English, Middle (ca. 1100-1500)',
'epo' => 'Esperanto',
'esk' => 'Eskimo (Other)',
'esl' => 'Spanish',
'est' => 'Estonian',
'eus' => 'Basque',
'ewe' => 'Ewe',
'ewo' => 'Ewondo',
'fan' => 'Fang',
'fao' => 'Faroese',
'fas' => 'Persian',
'fat' => 'Fanti',
'fij' => 'Fijian',
'fin' => 'Finnish',
'fiu' => 'Finno-Ugrian (Other)',
'fon' => 'Fon',
'fra' => 'French',
'fre' => 'French',
'frm' => 'French, Middle (ca. 1400-1600)',
'fro' => 'French, Old (842- ca. 1400)',
'fry' => 'Frisian',
'ful' => 'Fulah',
'gaa' => 'Ga',
'gae' => 'Gaelic (Scots)',
'gai' => 'Irish',
'gay' => 'Gayo',
'gdh' => 'Gaelic (Scots)',
'gem' => 'Germanic (Other)',
'geo' => 'Georgian',
'ger' => 'German',
'gez' => 'Geez',
'gil' => 'Gilbertese',
'glg' => 'Gallegan',
'gmh' => 'German, Middle High (ca. 1050-1500)',
'goh' => 'German, Old High (ca. 750-1050)',
'gon' => 'Gondi',
'got' => 'Gothic',
'grb' => 'Grebo',
'grc' => 'Greek, Ancient (to 1453)',
'gre' => 'Greek, Modern (1453-)',
'grn' => 'Guarani',
'guj' => 'Gujarati',
'hai' => 'Haida',
'hau' => 'Hausa',
'haw' => 'Hawaiian',
'heb' => 'Hebrew',
'her' => 'Herero',
'hil' => 'Hiligaynon',
'him' => 'Himachali',
'hin' => 'Hindi',
'hmo' => 'Hiri Motu',
'hun' => 'Hungarian',
'hup' => 'Hupa',
'hye' => 'Armenian',
'iba' => 'Iban',
'ibo' => 'Igbo',
'ice' => 'Icelandic',
'ijo' => 'Ijo',
'iku' => 'Inuktitut',
'ilo' => 'Iloko',
'ina' => 'Interlingua (International Auxiliary language Association)',
'inc' => 'Indic (Other)',
'ind' => 'Indonesian',
'ine' => 'Indo-European (Other)',
'ine' => 'Interlingue',
'ipk' => 'Inupiak',
'ira' => 'Iranian (Other)',
'iri' => 'Irish',
'iro' => 'Iroquoian uages',
'isl' => 'Icelandic',
'ita' => 'Italian',
'jav' => 'Javanese',
'jaw' => 'Javanese',
'jpn' => 'Japanese',
'jpr' => 'Judeo-Persian',
'jrb' => 'Judeo-Arabic',
'kaa' => 'Kara-Kalpak',
'kab' => 'Kabyle',
'kac' => 'Kachin',
'kal' => 'Greenlandic',
'kam' => 'Kamba',
'kan' => 'Kannada',
'kar' => 'Karen',
'kas' => 'Kashmiri',
'kat' => 'Georgian',
'kau' => 'Kanuri',
'kaw' => 'Kawi',
'kaz' => 'Kazakh',
'kha' => 'Khasi',
'khi' => 'Khoisan (Other)',
'khm' => 'Khmer',
'kho' => 'Khotanese',
'kik' => 'Kikuyu',
'kin' => 'Kinyarwanda',
'kir' => 'Kirghiz',
'kok' => 'Konkani',
'kom' => 'Komi',
'kon' => 'Kongo',
'kor' => 'Korean',
'kpe' => 'Kpelle',
'kro' => 'Kru',
'kru' => 'Kurukh',
'kua' => 'Kuanyama',
'kum' => 'Kumyk',
'kur' => 'Kurdish',
'kus' => 'Kusaie',
'kut' => 'Kutenai',
'lad' => 'Ladino',
'lah' => 'Lahnda',
'lam' => 'Lamba',
'lao' => 'Lao',
'lat' => 'Latin',
'lav' => 'Latvian',
'lez' => 'Lezghian',
'lin' => 'Lingala',
'lit' => 'Lithuanian',
'lol' => 'Mongo',
'loz' => 'Lozi',
'ltz' => 'Letzeburgesch',
'lub' => 'Luba-Katanga',
'lug' => 'Ganda',
'lui' => 'Luiseno',
'lun' => 'Lunda',
'luo' => 'Luo (Kenya and Tanzania)',
'mac' => 'Macedonian',
'mad' => 'Madurese',
'mag' => 'Magahi',
'mah' => 'Marshall',
'mai' => 'Maithili',
'mak' => 'Macedonian',
'mak' => 'Makasar',
'mal' => 'Malayalam',
'man' => 'Mandingo',
'mao' => 'Maori',
'map' => 'Austronesian (Other)',
'mar' => 'Marathi',
'mas' => 'Masai',
'max' => 'Manx',
'may' => 'Malay',
'men' => 'Mende',
'mga' => 'Irish, Middle (900 - 1200)',
'mic' => 'Micmac',
'min' => 'Minangkabau',
'mis' => 'Miscellaneous (Other)',
'mkh' => 'Mon-Kmer (Other)',
'mlg' => 'Malagasy',
'mlt' => 'Maltese',
'mni' => 'Manipuri',
'mno' => 'Manobo Languages',
'moh' => 'Mohawk',
'mol' => 'Moldavian',
'mon' => 'Mongolian',
'mos' => 'Mossi',
'mri' => 'Maori',
'msa' => 'Malay',
'mul' => 'Multiple Languages',
'mun' => 'Munda Languages',
'mus' => 'Creek',
'mwr' => 'Marwari',
'mya' => 'Burmese',
'myn' => 'Mayan Languages',
'nah' => 'Aztec',
'nai' => 'North American Indian (Other)',
'nau' => 'Nauru',
'nav' => 'Navajo',
'nbl' => 'Ndebele, South',
'nde' => 'Ndebele, North',
'ndo' => 'Ndongo',
'nep' => 'Nepali',
'new' => 'Newari',
'nic' => 'Niger-Kordofanian (Other)',
'niu' => 'Niuean',
'nla' => 'Dutch',
'nno' => 'Norwegian (Nynorsk)',
'non' => 'Norse, Old',
'nor' => 'Norwegian',
'nso' => 'Sotho, Northern',
'nub' => 'Nubian Languages',
'nya' => 'Nyanja',
'nym' => 'Nyamwezi',
'nyn' => 'Nyankole',
'nyo' => 'Nyoro',
'nzi' => 'Nzima',
'oci' => 'Langue d\'Oc (post 1500)',
'oji' => 'Ojibwa',
'ori' => 'Oriya',
'orm' => 'Oromo',
'osa' => 'Osage',
'oss' => 'Ossetic',
'ota' => 'Turkish, Ottoman (1500 - 1928)',
'oto' => 'Otomian Languages',
'paa' => 'Papuan-Australian (Other)',
'pag' => 'Pangasinan',
'pal' => 'Pahlavi',
'pam' => 'Pampanga',
'pan' => 'Panjabi',
'pap' => 'Papiamento',
'pau' => 'Palauan',
'peo' => 'Persian, Old (ca 600 - 400 B.C.)',
'per' => 'Persian',
'phn' => 'Phoenician',
'pli' => 'Pali',
'pol' => 'Polish',
'pon' => 'Ponape',
'por' => 'Portuguese',
'pra' => 'Prakrit uages',
'pro' => 'Provencal, Old (to 1500)',
'pus' => 'Pushto',
'que' => 'Quechua',
'raj' => 'Rajasthani',
'rar' => 'Rarotongan',
'roa' => 'Romance (Other)',
'roh' => 'Rhaeto-Romance',
'rom' => 'Romany',
'ron' => 'Romanian',
'rum' => 'Romanian',
'run' => 'Rundi',
'rus' => 'Russian',
'sad' => 'Sandawe',
'sag' => 'Sango',
'sah' => 'Yakut',
'sai' => 'South American Indian (Other)',
'sal' => 'Salishan Languages',
'sam' => 'Samaritan Aramaic',
'san' => 'Sanskrit',
'sco' => 'Scots',
'scr' => 'Serbo-Croatian',
'sel' => 'Selkup',
'sem' => 'Semitic (Other)',
'sga' => 'Irish, Old (to 900)',
'shn' => 'Shan',
'sid' => 'Sidamo',
'sin' => 'Singhalese',
'sio' => 'Siouan Languages',
'sit' => 'Sino-Tibetan (Other)',
'sla' => 'Slavic (Other)',
'slk' => 'Slovak',
'slo' => 'Slovak',
'slv' => 'Slovenian',
'smi' => 'Sami Languages',
'smo' => 'Samoan',
'sna' => 'Shona',
'snd' => 'Sindhi',
'sog' => 'Sogdian',
'som' => 'Somali',
'son' => 'Songhai',
'sot' => 'Sotho, Southern',
'spa' => 'Spanish',
'sqi' => 'Albanian',
'srd' => 'Sardinian',
'srr' => 'Serer',
'ssa' => 'Nilo-Saharan (Other)',
'ssw' => 'Siswant',
'ssw' => 'Swazi',
'suk' => 'Sukuma',
'sun' => 'Sudanese',
'sus' => 'Susu',
'sux' => 'Sumerian',
'sve' => 'Swedish',
'swa' => 'Swahili',
'swe' => 'Swedish',
'syr' => 'Syriac',
'tah' => 'Tahitian',
'tam' => 'Tamil',
'tat' => 'Tatar',
'tel' => 'Telugu',
'tem' => 'Timne',
'ter' => 'Tereno',
'tgk' => 'Tajik',
'tgl' => 'Tagalog',
'tha' => 'Thai',
'tib' => 'Tibetan',
'tig' => 'Tigre',
'tir' => 'Tigrinya',
'tiv' => 'Tivi',
'tli' => 'Tlingit',
'tmh' => 'Tamashek',
'tog' => 'Tonga (Nyasa)',
'ton' => 'Tonga (Tonga Islands)',
'tru' => 'Truk',
'tsi' => 'Tsimshian',
'tsn' => 'Tswana',
'tso' => 'Tsonga',
'tuk' => 'Turkmen',
'tum' => 'Tumbuka',
'tur' => 'Turkish',
'tut' => 'Altaic (Other)',
'twi' => 'Twi',
'tyv' => 'Tuvinian',
'uga' => 'Ugaritic',
'uig' => 'Uighur',
'ukr' => 'Ukrainian',
'umb' => 'Umbundu',
'und' => 'Undetermined',
'urd' => 'Urdu',
'uzb' => 'Uzbek',
'vai' => 'Vai',
'ven' => 'Venda',
'vie' => 'Vietnamese',
'vol' => 'Volapük',
'vot' => 'Votic',
'wak' => 'Wakashan Languages',
'wal' => 'Walamo',
'war' => 'Waray',
'was' => 'Washo',
'wel' => 'Welsh',
'wen' => 'Sorbian Languages',
'wol' => 'Wolof',
'xho' => 'Xhosa',
'yao' => 'Yao',
'yap' => 'Yap',
'yid' => 'Yiddish',
'yor' => 'Yoruba',
'zap' => 'Zapotec',
'zen' => 'Zenaga',
'zha' => 'Zhuang',
'zho' => 'Chinese',
'zul' => 'Zulu',
'zun' => 'Zuni'
);
return @$lookup[$language_code];
}
public static function ETCOEventLookup($index) {
if (($index >= 0x17) && ($index <= 0xDF)) {
return 'reserved for future use';
}
if (($index >= 0xE0) && ($index <= 0xEF)) {
return 'not predefined synch 0-F';
}
if (($index >= 0xF0) && ($index <= 0xFC)) {
return 'reserved for future use';
}
static $lookup = array (
0x00 => 'padding (has no meaning)',
0x01 => 'end of initial silence',
0x02 => 'intro start',
0x03 => 'main part start',
0x04 => 'outro start',
0x05 => 'outro end',
0x06 => 'verse start',
0x07 => 'refrain start',
0x08 => 'interlude start',
0x09 => 'theme start',
0x0A => 'variation start',
0x0B => 'key change',
0x0C => 'time change',
0x0D => 'momentary unwanted noise (Snap, Crackle & Pop)',
0x0E => 'sustained noise',
0x0F => 'sustained noise end',
0x10 => 'intro end',
0x11 => 'main part end',
0x12 => 'verse end',
0x13 => 'refrain end',
0x14 => 'theme end',
0x15 => 'profanity',
0x16 => 'profanity end',
0xFD => 'audio end (start of silence)',
0xFE => 'audio file ends',
0xFF => 'one more byte of events follows'
);
return @$lookup[$index];
}
public static function SYTLContentTypeLookup($index) {
static $lookup = array (
0x00 => 'other',
0x01 => 'lyrics',
0x02 => 'text transcription',
0x03 => 'movement/part name', // (e.g. 'Adagio')
0x04 => 'events', // (e.g. 'Don Quijote enters the stage')
0x05 => 'chord', // (e.g. 'Bb F Fsus')
0x06 => 'trivia/\'pop up\' information',
0x07 => 'URLs to webpages',
0x08 => 'URLs to images'
);
return @$lookup[$index];
}
public static function APICPictureTypeLookup($index, $return_array=false) {
static $lookup = array (
0x00 => 'Other',
0x01 => '32x32 pixels \'file icon\' (PNG only)',
0x02 => 'Other file icon',
0x03 => 'Cover (front)',
0x04 => 'Cover (back)',
0x05 => 'Leaflet page',
0x06 => 'Media (e.g. label side of CD)',
0x07 => 'Lead artist/lead performer/soloist',
0x08 => 'Artist/performer',
0x09 => 'Conductor',
0x0A => 'Band/Orchestra',
0x0B => 'Composer',
0x0C => 'Lyricist/text writer',
0x0D => 'Recording Location',
0x0E => 'During recording',
0x0F => 'During performance',
0x10 => 'Movie/video screen capture',
0x11 => 'A bright coloured fish',
0x12 => 'Illustration',
0x13 => 'Band/artist logotype',
0x14 => 'Publisher/Studio logotype'
);
if ($return_array) {
return $lookup;
}
return @$lookup[$index];
}
public static function COMRReceivedAsLookup($index) {
static $lookup = array (
0x00 => 'Other',
0x01 => 'Standard CD album with other songs',
0x02 => 'Compressed audio on CD',
0x03 => 'File over the Internet',
0x04 => 'Stream over the Internet',
0x05 => 'As note sheets',
0x06 => 'As note sheets in a book with other sheets',
0x07 => 'Music on other media',
0x08 => 'Non-musical merchandise'
);
return (isset($lookup[$index]) ? $lookup[$index] : '');
}
public static function RVA2ChannelTypeLookup($index) {
static $lookup = array (
0x00 => 'Other',
0x01 => 'Master volume',
0x02 => 'Front right',
0x03 => 'Front left',
0x04 => 'Back right',
0x05 => 'Back left',
0x06 => 'Front centre',
0x07 => 'Back centre',
0x08 => 'Subwoofer'
);
return @$lookup[$index];
}
public static function FrameNameLongLookup($frame_name) {
static $lookup = array (
'AENC' => 'Audio encryption',
'APIC' => 'Attached picture',
'ASPI' => 'Audio seek point index',
'BUF' => 'Recommended buffer size',
'CNT' => 'Play counter',
'COM' => 'Comments',
'COMM' => 'Comments',
'COMR' => 'Commercial frame',
'CRA' => 'Audio encryption',
'CRM' => 'Encrypted meta frame',
'ENCR' => 'Encryption method registration',
'EQU' => 'Equalisation',
'EQU2' => 'Equalisation (2)',
'EQUA' => 'Equalisation',
'ETC' => 'Event timing codes',
'ETCO' => 'Event timing codes',
'GEO' => 'General encapsulated object',
'GEOB' => 'General encapsulated object',
'GRID' => 'Group identification registration',
'IPL' => 'Involved people list',
'IPLS' => 'Involved people list',
'LINK' => 'Linked information',
'LNK' => 'Linked information',
'MCDI' => 'Music CD identifier',
'MCI' => 'Music CD Identifier',
'MLL' => 'MPEG location lookup table',
'MLLT' => 'MPEG location lookup table',
'OWNE' => 'Ownership frame',
'PCNT' => 'Play counter',
'PIC' => 'Attached picture',
'POP' => 'Popularimeter',
'POPM' => 'Popularimeter',
'POSS' => 'Position synchronisation frame',
'PRIV' => 'Private frame',
'RBUF' => 'Recommended buffer size',
'REV' => 'Reverb',
'RVA' => 'Relative volume adjustment',
'RVA2' => 'Relative volume adjustment (2)',
'RVAD' => 'Relative volume adjustment',
'RVRB' => 'Reverb',
'SEEK' => 'Seek frame',
'SIGN' => 'Signature frame',
'SLT' => 'Synchronised lyric/text',
'STC' => 'Synced tempo codes',
'SYLT' => 'Synchronised lyric/text',
'SYTC' => 'Synchronised tempo codes',
'TAL' => 'Album/Movie/Show title',
'TALB' => 'Album/Movie/Show title',
'TBP' => 'BPM (Beats Per Minute)',
'TBPM' => 'BPM (beats per minute)',
'TCM' => 'Composer',
'TCO' => 'Content type',
'TCOM' => 'Composer',
'TCON' => 'Content type',
'TCOP' => 'Copyright message',
'TCR' => 'Copyright message',
'TDA' => 'Date',
'TDAT' => 'Date',
'TDEN' => 'Encoding time',
'TDLY' => 'Playlist delay',
'TDOR' => 'Original release time',
'TDRC' => 'Recording time',
'TDRL' => 'Release time',
'TDTG' => 'Tagging time',
'TDY' => 'Playlist delay',
'TEN' => 'Encoded by',
'TENC' => 'Encoded by',
'TEXT' => 'Lyricist/Text writer',
'TFLT' => 'File type',
'TFT' => 'File type',
'TIM' => 'Time',
'TIME' => 'Time',
'TIPL' => 'Involved people list',
'TIT1' => 'Content group description',
'TIT2' => 'Title/songname/content description',
'TIT3' => 'Subtitle/Description refinement',
'TKE' => 'Initial key',
'TKEY' => 'Initial key',
'TLA' => 'Language(s)',
'TLAN' => 'Language(s)',
'TLE' => 'Length',
'TLEN' => 'Length',
'TMCL' => 'Musician credits list',
'TMED' => 'Media type',
'TMOO' => 'Mood',
'TMT' => 'Media type',
'TOA' => 'Original artist(s)/performer(s)',
'TOAL' => 'Original album/movie/show title',
'TOF' => 'Original filename',
'TOFN' => 'Original filename',
'TOL' => 'Original Lyricist(s)/text writer(s)',
'TOLY' => 'Original lyricist(s)/text writer(s)',
'TOPE' => 'Original artist(s)/performer(s)',
'TOR' => 'Original release year',
'TORY' => 'Original release year',
'TOT' => 'Original album/Movie/Show title',
'TOWN' => 'File owner/licensee',
'TP1' => 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group',
'TP2' => 'Band/Orchestra/Accompaniment',
'TP3' => 'Conductor/Performer refinement',
'TP4' => 'Interpreted, remixed, or otherwise modified by',
'TPA' => 'Part of a set',
'TPB' => 'Publisher',
'TPE1' => 'Lead performer(s)/Soloist(s)',
'TPE2' => 'Band/orchestra/accompaniment',
'TPE3' => 'Conductor/performer refinement',
'TPE4' => 'Interpreted, remixed, or otherwise modified by',
'TPOS' => 'Part of a set',
'TPRO' => 'Produced notice',
'TPUB' => 'Publisher',
'TRC' => 'ISRC (International Standard Recording Code)',
'TRCK' => 'Track number/Position in set',
'TRD' => 'Recording dates',
'TRDA' => 'Recording dates',
'TRK' => 'Track number/Position in set',
'TRSN' => 'Internet radio station name',
'TRSO' => 'Internet radio station owner',
'TSI' => 'Size',
'TSIZ' => 'Size',
'TSOA' => 'Album sort order',
'TSOP' => 'Performer sort order',
'TSOT' => 'Title sort order',
'TSRC' => 'ISRC (international standard recording code)',
'TSS' => 'Software/hardware and settings used for encoding',
'TSSE' => 'Software/Hardware and settings used for encoding',
'TSST' => 'Set subtitle',
'TT1' => 'Content group description',
'TT2' => 'Title/Songname/Content description',
'TT3' => 'Subtitle/Description refinement',
'TXT' => 'Lyricist/text writer',
'TXX' => 'User defined text information frame',
'TXXX' => 'User defined text information frame',
'TYE' => 'Year',
'TYER' => 'Year',
'UFI' => 'Unique file identifier',
'UFID' => 'Unique file identifier',
'ULT' => 'Unsychronised lyric/text transcription',
'USER' => 'Terms of use',
'USLT' => 'Unsynchronised lyric/text transcription',
'WAF' => 'Official audio file webpage',
'WAR' => 'Official artist/performer webpage',
'WAS' => 'Official audio source webpage',
'WCM' => 'Commercial information',
'WCOM' => 'Commercial information',
'WCOP' => 'Copyright/Legal information',
'WCP' => 'Copyright/Legal information',
'WOAF' => 'Official audio file webpage',
'WOAR' => 'Official artist/performer webpage',
'WOAS' => 'Official audio source webpage',
'WORS' => 'Official Internet radio station homepage',
'WPAY' => 'Payment',
'WPB' => 'Publishers official webpage',
'WPUB' => 'Publishers official webpage',
'WXX' => 'User defined URL link frame',
'WXXX' => 'User defined URL link frame',
'TFEA' => 'Featured Artist',
'TSTU' => 'Recording Studio',
'rgad' => 'Replay Gain Adjustment'
);
return @$lookup[$frame_name];
// Last three:
// from Helium2 [www.helium2.com]
// from http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html
}
public static function FrameNameShortLookup($frame_name) {
static $lookup = array (
'COM' => 'comment',
'COMM' => 'comment',
'TAL' => 'album',
'TALB' => 'album',
'TBP' => 'bpm',
'TBPM' => 'bpm',
'TCM' => 'composer',
'TCO' => 'genre',
'TCOM' => 'composer',
'TCON' => 'genre',
'TCOP' => 'copyright',
'TCR' => 'copyright',
'TEN' => 'encoded_by',
'TENC' => 'encoded_by',
'TEXT' => 'lyricist',
'TIT1' => 'description',
'TIT2' => 'title',
'TIT3' => 'subtitle',
'TLA' => 'language',
'TLAN' => 'language',
'TLE' => 'length',
'TLEN' => 'length',
'TMOO' => 'mood',
'TOA' => 'original_artist',
'TOAL' => 'original_album',
'TOF' => 'original_filename',
'TOFN' => 'original_filename',
'TOL' => 'original_lyricist',
'TOLY' => 'original_lyricist',
'TOPE' => 'original_artist',
'TOT' => 'original_album',
'TP1' => 'artist',
'TP2' => 'band',
'TP3' => 'conductor',
'TP4' => 'remixer',
'TPA' => 'pos',
'TPB' => 'publisher',
'TPE1' => 'artist',
'TPE2' => 'band',
'TPE3' => 'conductor',
'TPE4' => 'remixer',
'TPOS' => 'pos',
'TPUB' => 'publisher',
'TRC' => 'isrc',
'TRCK' => 'track',
'TRK' => 'track',
'TSI' => 'size',
'TSIZ' => 'size',
'TSRC' => 'isrc',
'TSS' => 'encoder_settings',
'TSSE' => 'encoder_settings',
'TSST' => 'subtitle',
'TT1' => 'description',
'TT2' => 'title',
'TT3' => 'subtitle',
'TXT' => 'lyricist',
'TXX' => 'text',
'TXXX' => 'text',
'TYE' => 'year',
'TYER' => 'year',
'UFI' => 'unique_file_identifier',
'UFID' => 'unique_file_identifier',
'ULT' => 'unsychronised_lyric',
'USER' => 'terms_of_use',
'USLT' => 'unsynchronised lyric',
'WAF' => 'url_file',
'WAR' => 'url_artist',
'WAS' => 'url_source',
'WCOP' => 'copyright',
'WCP' => 'copyright',
'WOAF' => 'url_file',
'WOAR' => 'url_artist',
'WOAS' => 'url_source',
'WORS' => 'url_station',
'WPB' => 'url_publisher',
'WPUB' => 'url_publisher',
'WXX' => 'url_user',
'WXXX' => 'url_user',
'TFEA' => 'featured_artist',
'TSTU' => 'studio'
);
return @$lookup[$frame_name];
}
public static function TextEncodingTerminatorLookup($encoding) {
// http://www.id3.org/id3v2.4.0-structure.txt
// Frames that allow different types of text encoding contains a text encoding description byte. Possible encodings:
// $00 ISO-8859-1. Terminated with $00.
// $01 UTF-16 encoded Unicode with BOM. All strings in the same frame SHALL have the same byteorder. Terminated with $00 00.
// $02 UTF-16BE encoded Unicode without BOM. Terminated with $00 00.
// $03 UTF-8 encoded Unicode. Terminated with $00.
static $lookup = array (
0 => "\x00",
1 => "\x00\x00",
2 => "\x00\x00",
3 => "\x00",
255 => "\x00\x00"
);
return @$lookup[$encoding];
}
public static function IsValidID3v2FrameName($frame_name, $id3v2_major_version) {
switch ($id3v2_major_version) {
case 2:
return preg_match('/[A-Z][A-Z0-9]{2}/', $frame_name);
case 3:
case 4:
return preg_match('/[A-Z][A-Z0-9]{3}/', $frame_name);
}
return false;
}
public static function IsValidDateStampString($date_stamp) {
if (strlen($date_stamp) != 8) {
return false;
}
if ((int)$date_stamp) {
return false;
}
$year = substr($date_stamp, 0, 4);
$month = substr($date_stamp, 4, 2);
$day = substr($date_stamp, 6, 2);
if (!$year || !$month || !$day || $month > 12 || $day > 31 ) {
return false;
}
if (($day > 30) && (($month == 4) || ($month == 6) || ($month == 9) || ($month == 11))) {
return false;
}
if (($day > 29) && ($month == 2)) {
return false;
}
return true;
}
public static function array_merge_noclobber($array1, $array2) {
if (!is_array($array1) || !is_array($array2)) {
return false;
}
$newarray = $array1;
foreach ($array2 as $key => $val) {
if (is_array($val) && isset($newarray[$key]) && is_array($newarray[$key])) {
$newarray[$key] = getid3_id3v2::array_merge_noclobber($newarray[$key], $val);
} elseif (!isset($newarray[$key])) {
$newarray[$key] = $val;
}
}
return $newarray;
}
}
?>
Reference in a new issue View git blame Copy permalink