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