annotate e2gallerypro/e2upload/Backend/Assets/getid3/module.tag.id3v2.php @ 3:3f6b44aa6b35 judyates

[svn r4] added ability to buy stuff, from a Prints page, but it doesn't work well with the css, and it also has not been fitted into the perl make system.
author rlm
date Mon, 22 Feb 2010 08:02:39 -0500
parents
children
rev   line source
rlm@3 1 <?php
rlm@3 2 // +----------------------------------------------------------------------+
rlm@3 3 // | PHP version 5 |
rlm@3 4 // +----------------------------------------------------------------------+
rlm@3 5 // | Copyright (c) 2002-2006 James Heinrich, Allan Hansen |
rlm@3 6 // +----------------------------------------------------------------------+
rlm@3 7 // | This source file is subject to version 2 of the GPL license, |
rlm@3 8 // | that is bundled with this package in the file license.txt and is |
rlm@3 9 // | available through the world-wide-web at the following url: |
rlm@3 10 // | http://www.gnu.org/copyleft/gpl.html |
rlm@3 11 // +----------------------------------------------------------------------+
rlm@3 12 // | getID3() - http://getid3.sourceforge.net or http://www.getid3.org |
rlm@3 13 // +----------------------------------------------------------------------+
rlm@3 14 // | Authors: James Heinrich <infoØgetid3*org> |
rlm@3 15 // | Allan Hansen <ahØartemis*dk> |
rlm@3 16 // +----------------------------------------------------------------------+
rlm@3 17 // | module.tag.id3v2.php |
rlm@3 18 // | module for analyzing ID3v2 tags |
rlm@3 19 // | dependencies: module.tag.id3v1.php |
rlm@3 20 // | module.lib.image_size.php (optional) |
rlm@3 21 // | zlib support in PHP (optional) |
rlm@3 22 // +----------------------------------------------------------------------+
rlm@3 23 //
rlm@3 24 // $Id: module.tag.id3v2.php,v 1.15 2006/12/03 23:47:29 ah Exp $
rlm@3 25
rlm@3 26
rlm@3 27
rlm@3 28
rlm@3 29 class getid3_id3v2 extends getid3_handler
rlm@3 30 {
rlm@3 31
rlm@3 32 public $option_starting_offset = 0;
rlm@3 33
rlm@3 34
rlm@3 35 public function Analyze() {
rlm@3 36
rlm@3 37 $getid3 = $this->getid3;
rlm@3 38
rlm@3 39 // dependency
rlm@3 40 $getid3->include_module('tag.id3v1');
rlm@3 41
rlm@3 42 if ($getid3->option_tags_images) {
rlm@3 43 $getid3->include_module('lib.image_size');
rlm@3 44 }
rlm@3 45
rlm@3 46
rlm@3 47 // Overall tag structure:
rlm@3 48 // +-----------------------------+
rlm@3 49 // | Header (10 bytes) |
rlm@3 50 // +-----------------------------+
rlm@3 51 // | Extended Header |
rlm@3 52 // | (variable length, OPTIONAL) |
rlm@3 53 // +-----------------------------+
rlm@3 54 // | Frames (variable length) |
rlm@3 55 // +-----------------------------+
rlm@3 56 // | Padding |
rlm@3 57 // | (variable length, OPTIONAL) |
rlm@3 58 // +-----------------------------+
rlm@3 59 // | Footer (10 bytes, OPTIONAL) |
rlm@3 60 // +-----------------------------+
rlm@3 61 //
rlm@3 62 // Header
rlm@3 63 // ID3v2/file identifier "ID3"
rlm@3 64 // ID3v2 version $04 00
rlm@3 65 // ID3v2 flags (%ab000000 in v2.2, %abc00000 in v2.3, %abcd0000 in v2.4.x)
rlm@3 66 // ID3v2 size 4 * %0xxxxxxx
rlm@3 67
rlm@3 68
rlm@3 69 // shortcuts
rlm@3 70 $getid3->info['id3v2']['header'] = true;
rlm@3 71 $info_id3v2 = &$getid3->info['id3v2'];
rlm@3 72 $info_id3v2['flags'] = array ();
rlm@3 73 $info_id3v2_flags = &$info_id3v2['flags'];
rlm@3 74
rlm@3 75
rlm@3 76 $this->fseek($this->option_starting_offset, SEEK_SET);
rlm@3 77 $header = $this->fread(10);
rlm@3 78 if (substr($header, 0, 3) == 'ID3' && strlen($header) == 10) {
rlm@3 79
rlm@3 80 $info_id3v2['majorversion'] = ord($header{3});
rlm@3 81 $info_id3v2['minorversion'] = ord($header{4});
rlm@3 82
rlm@3 83 // shortcut
rlm@3 84 $id3v2_major_version = &$info_id3v2['majorversion'];
rlm@3 85
rlm@3 86 } else {
rlm@3 87 unset($getid3->info['id3v2']);
rlm@3 88 return false;
rlm@3 89
rlm@3 90 }
rlm@3 91
rlm@3 92 if ($id3v2_major_version > 4) { // this script probably won't correctly parse ID3v2.5.x and above (if it ever exists)
rlm@3 93 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 94 }
rlm@3 95
rlm@3 96 $id3_flags = ord($header{5});
rlm@3 97 switch ($id3v2_major_version) {
rlm@3 98 case 2:
rlm@3 99 // %ab000000 in v2.2
rlm@3 100 $info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation
rlm@3 101 $info_id3v2_flags['compression'] = (bool)($id3_flags & 0x40); // b - Compression
rlm@3 102 break;
rlm@3 103
rlm@3 104 case 3:
rlm@3 105 // %abc00000 in v2.3
rlm@3 106 $info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation
rlm@3 107 $info_id3v2_flags['exthead'] = (bool)($id3_flags & 0x40); // b - Extended header
rlm@3 108 $info_id3v2_flags['experim'] = (bool)($id3_flags & 0x20); // c - Experimental indicator
rlm@3 109 break;
rlm@3 110
rlm@3 111 case 4:
rlm@3 112 // %abcd0000 in v2.4
rlm@3 113 $info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation
rlm@3 114 $info_id3v2_flags['exthead'] = (bool)($id3_flags & 0x40); // b - Extended header
rlm@3 115 $info_id3v2_flags['experim'] = (bool)($id3_flags & 0x20); // c - Experimental indicator
rlm@3 116 $info_id3v2_flags['isfooter'] = (bool)($id3_flags & 0x10); // d - Footer present
rlm@3 117 break;
rlm@3 118 }
rlm@3 119
rlm@3 120 $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 121
rlm@3 122 $info_id3v2['tag_offset_start'] = $this->option_starting_offset;
rlm@3 123 $info_id3v2['tag_offset_end'] = $info_id3v2['tag_offset_start'] + $info_id3v2['headerlength'];
rlm@3 124
rlm@3 125
rlm@3 126 // Frames
rlm@3 127
rlm@3 128 // All ID3v2 frames consists of one frame header followed by one or more
rlm@3 129 // fields containing the actual information. The header is always 10
rlm@3 130 // bytes and laid out as follows:
rlm@3 131 //
rlm@3 132 // Frame ID $xx xx xx xx (four characters)
rlm@3 133 // Size 4 * %0xxxxxxx
rlm@3 134 // Flags $xx xx
rlm@3 135
rlm@3 136 $size_of_frames = $info_id3v2['headerlength'] - 10; // not including 10-byte initial header
rlm@3 137 if (@$info_id3v2['exthead']['length']) {
rlm@3 138 $size_of_frames -= ($info_id3v2['exthead']['length'] + 4);
rlm@3 139 }
rlm@3 140
rlm@3 141 if (@$info_id3v2_flags['isfooter']) {
rlm@3 142 $size_of_frames -= 10; // footer takes last 10 bytes of ID3v2 header, after frame data, before audio
rlm@3 143 }
rlm@3 144
rlm@3 145 if ($size_of_frames > 0) {
rlm@3 146 $frame_data = $this->fread($size_of_frames); // read all frames from file into $frame_data variable
rlm@3 147
rlm@3 148 // if entire frame data is unsynched, de-unsynch it now (ID3v2.3.x)
rlm@3 149 if (@$info_id3v2_flags['unsynch'] && ($id3v2_major_version <= 3)) {
rlm@3 150 $frame_data = str_replace("\xFF\x00", "\xFF", $frame_data);
rlm@3 151 }
rlm@3 152
rlm@3 153 // [in ID3v2.4.0] Unsynchronisation [S:6.1] is done on frame level, instead
rlm@3 154 // of on tag level, making it easier to skip frames, increasing the streamability
rlm@3 155 // of the tag. The unsynchronisation flag in the header [S:3.1] indicates that
rlm@3 156 // there exists an unsynchronised frame, while the new unsynchronisation flag in
rlm@3 157 // the frame header [S:4.1.2] indicates unsynchronisation.
rlm@3 158
rlm@3 159 //$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 160 $frame_data_offset = 10; // how many bytes into the stream - start from after the 10-byte header
rlm@3 161
rlm@3 162 // Extended Header
rlm@3 163 if (@$info_id3v2_flags['exthead']) {
rlm@3 164 $extended_header_offset = 0;
rlm@3 165
rlm@3 166 if ($id3v2_major_version == 3) {
rlm@3 167
rlm@3 168 // v2.3 definition:
rlm@3 169 //Extended header size $xx xx xx xx // 32-bit integer
rlm@3 170 //Extended Flags $xx xx
rlm@3 171 // %x0000000 %00000000 // v2.3
rlm@3 172 // x - CRC data present
rlm@3 173 //Size of padding $xx xx xx xx
rlm@3 174
rlm@3 175 $info_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 0);
rlm@3 176 $extended_header_offset += 4;
rlm@3 177
rlm@3 178 $info_id3v2['exthead']['flag_bytes'] = 2;
rlm@3 179 $info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes']));
rlm@3 180 $extended_header_offset += $info_id3v2['exthead']['flag_bytes'];
rlm@3 181
rlm@3 182 $info_id3v2['exthead']['flags']['crc'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x8000);
rlm@3 183
rlm@3 184 $info_id3v2['exthead']['padding_size'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4));
rlm@3 185 $extended_header_offset += 4;
rlm@3 186
rlm@3 187 if ($info_id3v2['exthead']['flags']['crc']) {
rlm@3 188 $info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4));
rlm@3 189 $extended_header_offset += 4;
rlm@3 190 }
rlm@3 191 $extended_header_offset += $info_id3v2['exthead']['padding_size'];
rlm@3 192
rlm@3 193 }
rlm@3 194
rlm@3 195 elseif ($id3v2_major_version == 4) {
rlm@3 196
rlm@3 197 // v2.4 definition:
rlm@3 198 //Extended header size 4 * %0xxxxxxx // 28-bit synchsafe integer
rlm@3 199 //Number of flag bytes $01
rlm@3 200 //Extended Flags $xx
rlm@3 201 // %0bcd0000 // v2.4
rlm@3 202 // b - Tag is an update
rlm@3 203 // Flag data length $00
rlm@3 204 // c - CRC data present
rlm@3 205 // Flag data length $05
rlm@3 206 // Total frame CRC 5 * %0xxxxxxx
rlm@3 207 // d - Tag restrictions
rlm@3 208 // Flag data length $01
rlm@3 209
rlm@3 210 $info_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 1);
rlm@3 211 $extended_header_offset += 4;
rlm@3 212
rlm@3 213 $info_id3v2['exthead']['flag_bytes'] = 1;
rlm@3 214 $info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes']));
rlm@3 215 $extended_header_offset += $info_id3v2['exthead']['flag_bytes'];
rlm@3 216
rlm@3 217 $info_id3v2['exthead']['flags']['update'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x4000);
rlm@3 218 $info_id3v2['exthead']['flags']['crc'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x2000);
rlm@3 219 $info_id3v2['exthead']['flags']['restrictions'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x1000);
rlm@3 220
rlm@3 221 if ($info_id3v2['exthead']['flags']['crc']) {
rlm@3 222 $info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 5), 1);
rlm@3 223 $extended_header_offset += 5;
rlm@3 224 }
rlm@3 225 if ($info_id3v2['exthead']['flags']['restrictions']) {
rlm@3 226 // %ppqrrstt
rlm@3 227 $restrictions_raw = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 1));
rlm@3 228 $extended_header_offset += 1;
rlm@3 229 $info_id3v2['exthead']['flags']['restrictions']['tagsize'] = ($restrictions_raw && 0xC0) >> 6; // p - Tag size restrictions
rlm@3 230 $info_id3v2['exthead']['flags']['restrictions']['textenc'] = ($restrictions_raw && 0x20) >> 5; // q - Text encoding restrictions
rlm@3 231 $info_id3v2['exthead']['flags']['restrictions']['textsize'] = ($restrictions_raw && 0x18) >> 3; // r - Text fields size restrictions
rlm@3 232 $info_id3v2['exthead']['flags']['restrictions']['imgenc'] = ($restrictions_raw && 0x04) >> 2; // s - Image encoding restrictions
rlm@3 233 $info_id3v2['exthead']['flags']['restrictions']['imgsize'] = ($restrictions_raw && 0x03) >> 0; // t - Image size restrictions
rlm@3 234 }
rlm@3 235
rlm@3 236 }
rlm@3 237 $frame_data_offset += $extended_header_offset;
rlm@3 238 $frame_data = substr($frame_data, $extended_header_offset);
rlm@3 239 } // end extended header
rlm@3 240
rlm@3 241
rlm@3 242
rlm@3 243
rlm@3 244
rlm@3 245
rlm@3 246 while (isset($frame_data) && (strlen($frame_data) > 0)) { // cycle through until no more frame data is left to parse
rlm@3 247 if (strlen($frame_data) <= ($id3v2_major_version == 2 ? 6 : 10)) {
rlm@3 248 // insufficient room left in ID3v2 header for actual data - must be padding
rlm@3 249 $info_id3v2['padding']['start'] = $frame_data_offset;
rlm@3 250 $info_id3v2['padding']['length'] = strlen($frame_data);
rlm@3 251 $info_id3v2['padding']['valid'] = true;
rlm@3 252 for ($i = 0; $i < $info_id3v2['padding']['length']; $i++) {
rlm@3 253 if ($frame_data{$i} != "\x00") {
rlm@3 254 $info_id3v2['padding']['valid'] = false;
rlm@3 255 $info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i;
rlm@3 256 $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 257 break;
rlm@3 258 }
rlm@3 259 }
rlm@3 260 break; // skip rest of ID3v2 header
rlm@3 261 }
rlm@3 262
rlm@3 263 if ($id3v2_major_version == 2) {
rlm@3 264 // Frame ID $xx xx xx (three characters)
rlm@3 265 // Size $xx xx xx (24-bit integer)
rlm@3 266 // Flags $xx xx
rlm@3 267
rlm@3 268 $frame_header = substr($frame_data, 0, 6); // take next 6 bytes for header
rlm@3 269 $frame_data = substr($frame_data, 6); // and leave the rest in $frame_data
rlm@3 270 $frame_name = substr($frame_header, 0, 3);
rlm@3 271 $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 3, 3));
rlm@3 272 $frame_flags = 0; // not used for anything in ID3v2.2, just set to avoid E_NOTICEs
rlm@3 273
rlm@3 274
rlm@3 275 } elseif ($id3v2_major_version > 2) {
rlm@3 276
rlm@3 277 // Frame ID $xx xx xx xx (four characters)
rlm@3 278 // Size $xx xx xx xx (32-bit integer in v2.3, 28-bit synchsafe in v2.4+)
rlm@3 279 // Flags $xx xx
rlm@3 280
rlm@3 281 $frame_header = substr($frame_data, 0, 10); // take next 10 bytes for header
rlm@3 282 $frame_data = substr($frame_data, 10); // and leave the rest in $frame_data
rlm@3 283
rlm@3 284 $frame_name = substr($frame_header, 0, 4);
rlm@3 285
rlm@3 286 if ($id3v2_major_version == 3) {
rlm@3 287 $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer
rlm@3 288
rlm@3 289 } else { // ID3v2.4+
rlm@3 290 $frame_size = getid3_lib::BigEndianSyncSafe2Int(substr($frame_header, 4, 4)); // 32-bit synchsafe integer (28-bit value)
rlm@3 291 }
rlm@3 292
rlm@3 293 if ($frame_size < (strlen($frame_data) + 4)) {
rlm@3 294 $nextFrameID = substr($frame_data, $frame_size, 4);
rlm@3 295 if (getid3_id3v2::IsValidID3v2FrameName($nextFrameID, $id3v2_major_version)) {
rlm@3 296 // next frame is OK
rlm@3 297 } elseif (($frame_name == "\x00".'MP3') || ($frame_name == "\x00\x00".'MP') || ($frame_name == ' MP3') || ($frame_name == 'MP3e')) {
rlm@3 298 // MP3ext known broken frames - "ok" for the purposes of this test
rlm@3 299 } elseif (($id3v2_major_version == 4) && (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)), 4), 3))) {
rlm@3 300 $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 301 $id3v2_major_version = 3;
rlm@3 302 $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer
rlm@3 303 }
rlm@3 304 }
rlm@3 305
rlm@3 306
rlm@3 307 $frame_flags = getid3_lib::BigEndian2Int(substr($frame_header, 8, 2));
rlm@3 308 }
rlm@3 309
rlm@3 310 if ((($id3v2_major_version == 2) && ($frame_name == "\x00\x00\x00")) || ($frame_name == "\x00\x00\x00\x00")) {
rlm@3 311 // padding encountered
rlm@3 312
rlm@3 313 $info_id3v2['padding']['start'] = $frame_data_offset;
rlm@3 314 $info_id3v2['padding']['length'] = strlen($frame_header) + strlen($frame_data);
rlm@3 315 $info_id3v2['padding']['valid'] = true;
rlm@3 316
rlm@3 317 $len = strlen($frame_data);
rlm@3 318 for ($i = 0; $i < $len; $i++) {
rlm@3 319 if ($frame_data{$i} != "\x00") {
rlm@3 320 $info_id3v2['padding']['valid'] = false;
rlm@3 321 $info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i;
rlm@3 322 $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 323 break;
rlm@3 324 }
rlm@3 325 }
rlm@3 326 break; // skip rest of ID3v2 header
rlm@3 327 }
rlm@3 328
rlm@3 329 if ($frame_name == 'COM ') {
rlm@3 330 $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 331 $frame_name = 'COMM';
rlm@3 332 }
rlm@3 333 if (($frame_size <= strlen($frame_data)) && (getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version))) {
rlm@3 334
rlm@3 335 unset($parsed_frame);
rlm@3 336 $parsed_frame['frame_name'] = $frame_name;
rlm@3 337 $parsed_frame['frame_flags_raw'] = $frame_flags;
rlm@3 338 $parsed_frame['data'] = substr($frame_data, 0, $frame_size);
rlm@3 339 $parsed_frame['datalength'] = (int)($frame_size);
rlm@3 340 $parsed_frame['dataoffset'] = $frame_data_offset;
rlm@3 341
rlm@3 342 $this->ParseID3v2Frame($parsed_frame);
rlm@3 343 $info_id3v2[$frame_name][] = $parsed_frame;
rlm@3 344
rlm@3 345 $frame_data = substr($frame_data, $frame_size);
rlm@3 346
rlm@3 347 } else { // invalid frame length or FrameID
rlm@3 348
rlm@3 349 if ($frame_size <= strlen($frame_data)) {
rlm@3 350
rlm@3 351 if (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, $frame_size, 4), $id3v2_major_version)) {
rlm@3 352
rlm@3 353 // next frame is valid, just skip the current frame
rlm@3 354 $frame_data = substr($frame_data, $frame_size);
rlm@3 355 $getid3->warning('Next ID3v2 frame is valid, skipping current frame.');
rlm@3 356
rlm@3 357 } else {
rlm@3 358
rlm@3 359 // next frame is invalid too, abort processing
rlm@3 360 throw new getid3_exception('Next ID3v2 frame is also invalid, aborting processing.');
rlm@3 361
rlm@3 362 }
rlm@3 363
rlm@3 364 } elseif ($frame_size == strlen($frame_data)) {
rlm@3 365
rlm@3 366 // this is the last frame, just skip
rlm@3 367 $getid3->warning('This was the last ID3v2 frame.');
rlm@3 368
rlm@3 369 } else {
rlm@3 370
rlm@3 371 // next frame is invalid too, abort processing
rlm@3 372 $frame_data = null;
rlm@3 373 $getid3->warning('Invalid ID3v2 frame size, aborting.');
rlm@3 374
rlm@3 375 }
rlm@3 376 if (!getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version)) {
rlm@3 377
rlm@3 378 switch ($frame_name) {
rlm@3 379
rlm@3 380 case "\x00\x00".'MP':
rlm@3 381 case "\x00".'MP3':
rlm@3 382 case ' MP3':
rlm@3 383 case 'MP3e':
rlm@3 384 case "\x00".'MP':
rlm@3 385 case ' MP':
rlm@3 386 case 'MP3':
rlm@3 387 $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 388 break;
rlm@3 389
rlm@3 390 default:
rlm@3 391 $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 392 break;
rlm@3 393 }
rlm@3 394
rlm@3 395 } elseif ($frame_size > strlen(@$frame_data)){
rlm@3 396
rlm@3 397 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 398
rlm@3 399 } else {
rlm@3 400
rlm@3 401 throw new getid3_exception('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag).');
rlm@3 402
rlm@3 403 }
rlm@3 404
rlm@3 405 }
rlm@3 406 $frame_data_offset += ($frame_size + ($id3v2_major_version == 2 ? 6 : 10));
rlm@3 407
rlm@3 408 }
rlm@3 409
rlm@3 410 }
rlm@3 411
rlm@3 412
rlm@3 413 // Footer
rlm@3 414
rlm@3 415 // The footer is a copy of the header, but with a different identifier.
rlm@3 416 // ID3v2 identifier "3DI"
rlm@3 417 // ID3v2 version $04 00
rlm@3 418 // ID3v2 flags %abcd0000
rlm@3 419 // ID3v2 size 4 * %0xxxxxxx
rlm@3 420
rlm@3 421 if (isset($info_id3v2_flags['isfooter']) && $info_id3v2_flags['isfooter']) {
rlm@3 422 $footer = fread ($getid3->fp, 10);
rlm@3 423 if (substr($footer, 0, 3) == '3DI') {
rlm@3 424 $info_id3v2['footer'] = true;
rlm@3 425 $info_id3v2['majorversion_footer'] = ord($footer{3});
rlm@3 426 $info_id3v2['minorversion_footer'] = ord($footer{4});
rlm@3 427 }
rlm@3 428 if ($info_id3v2['majorversion_footer'] <= 4) {
rlm@3 429 $id3_flags = ord($footer{5});
rlm@3 430 $info_id3v2_flags['unsynch_footer'] = (bool)($id3_flags & 0x80);
rlm@3 431 $info_id3v2_flags['extfoot_footer'] = (bool)($id3_flags & 0x40);
rlm@3 432 $info_id3v2_flags['experim_footer'] = (bool)($id3_flags & 0x20);
rlm@3 433 $info_id3v2_flags['isfooter_footer'] = (bool)($id3_flags & 0x10);
rlm@3 434
rlm@3 435 $info_id3v2['footerlength'] = getid3_lib::BigEndianSyncSafe2Int(substr($footer, 6, 4));
rlm@3 436 }
rlm@3 437 } // end footer
rlm@3 438
rlm@3 439 if (isset($info_id3v2['comments']['genre'])) {
rlm@3 440 foreach ($info_id3v2['comments']['genre'] as $key => $value) {
rlm@3 441 unset($info_id3v2['comments']['genre'][$key]);
rlm@3 442 $info_id3v2['comments'] = getid3_id3v2::array_merge_noclobber($info_id3v2['comments'], getid3_id3v2::ParseID3v2GenreString($value));
rlm@3 443 }
rlm@3 444 }
rlm@3 445
rlm@3 446 if (isset($info_id3v2['comments']['track'])) {
rlm@3 447 foreach ($info_id3v2['comments']['track'] as $key => $value) {
rlm@3 448 if (strstr($value, '/')) {
rlm@3 449 list($info_id3v2['comments']['track'][$key], $info_id3v2['comments']['totaltracks'][$key]) = explode('/', $info_id3v2['comments']['track'][$key]);
rlm@3 450 }
rlm@3 451 }
rlm@3 452 }
rlm@3 453
rlm@3 454 // Use year from recording time if year not set
rlm@3 455 if (!isset($info_id3v2['comments']['year']) && ereg('^([0-9]{4})', @$info_id3v2['comments']['recording_time'][0], $matches)) {
rlm@3 456 $info_id3v2['comments']['year'] = array ($matches[1]);
rlm@3 457 }
rlm@3 458
rlm@3 459 // Set avdataoffset
rlm@3 460 $getid3->info['avdataoffset'] = $info_id3v2['headerlength'];
rlm@3 461 if (isset($info_id3v2['footer'])) {
rlm@3 462 $getid3->info['avdataoffset'] += 10;
rlm@3 463 }
rlm@3 464
rlm@3 465 return true;
rlm@3 466 }
rlm@3 467
rlm@3 468
rlm@3 469
rlm@3 470 private function ParseID3v2Frame(&$parsed_frame) {
rlm@3 471
rlm@3 472 $getid3 = $this->getid3;
rlm@3 473
rlm@3 474 $id3v2_major_version = $getid3->info['id3v2']['majorversion'];
rlm@3 475
rlm@3 476 $frame_name_long = getid3_id3v2::FrameNameLongLookup($parsed_frame['frame_name']);
rlm@3 477 if ($frame_name_long) {
rlm@3 478 $parsed_frame['framenamelong'] = $frame_name_long;
rlm@3 479 }
rlm@3 480
rlm@3 481 $frame_name_short = getid3_id3v2::FrameNameShortLookup($parsed_frame['frame_name']);
rlm@3 482 if ($frame_name_short) {
rlm@3 483 $parsed_frame['framenameshort'] = $frame_name_short;
rlm@3 484 }
rlm@3 485
rlm@3 486 if ($id3v2_major_version >= 3) { // frame flags are not part of the ID3v2.2 standard
rlm@3 487
rlm@3 488 if ($id3v2_major_version == 3) {
rlm@3 489
rlm@3 490 // Frame Header Flags
rlm@3 491 // %abc00000 %ijk00000
rlm@3 492
rlm@3 493 $parsed_frame['flags']['TagAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x8000); // a - Tag alter preservation
rlm@3 494 $parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // b - File alter preservation
rlm@3 495 $parsed_frame['flags']['ReadOnly'] = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // c - Read only
rlm@3 496 $parsed_frame['flags']['compression'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0080); // i - Compression
rlm@3 497 $parsed_frame['flags']['Encryption'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // j - Encryption
rlm@3 498 $parsed_frame['flags']['GroupingIdentity'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0020); // k - Grouping identity
rlm@3 499
rlm@3 500
rlm@3 501 } elseif ($id3v2_major_version == 4) {
rlm@3 502
rlm@3 503 // Frame Header Flags
rlm@3 504 // %0abc0000 %0h00kmnp
rlm@3 505
rlm@3 506 $parsed_frame['flags']['TagAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // a - Tag alter preservation
rlm@3 507 $parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // b - File alter preservation
rlm@3 508 $parsed_frame['flags']['ReadOnly'] = (bool)($parsed_frame['frame_flags_raw'] & 0x1000); // c - Read only
rlm@3 509 $parsed_frame['flags']['GroupingIdentity'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // h - Grouping identity
rlm@3 510 $parsed_frame['flags']['compression'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0008); // k - Compression
rlm@3 511 $parsed_frame['flags']['Encryption'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0004); // m - Encryption
rlm@3 512 $parsed_frame['flags']['Unsynchronisation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0002); // n - Unsynchronisation
rlm@3 513 $parsed_frame['flags']['DataLengthIndicator'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0001); // p - Data length indicator
rlm@3 514
rlm@3 515 // Frame-level de-unsynchronisation - ID3v2.4
rlm@3 516 if ($parsed_frame['flags']['Unsynchronisation']) {
rlm@3 517 $parsed_frame['data'] = str_replace("\xFF\x00", "\xFF", $parsed_frame['data']);
rlm@3 518 }
rlm@3 519 }
rlm@3 520
rlm@3 521 // Frame-level de-compression
rlm@3 522 if ($parsed_frame['flags']['compression']) {
rlm@3 523 $parsed_frame['decompressed_size'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 4));
rlm@3 524
rlm@3 525 if (!function_exists('gzuncompress')) {
rlm@3 526 $getid3->warning('gzuncompress() support required to decompress ID3v2 frame "'.$parsed_frame['frame_name'].'"');
rlm@3 527 } elseif ($decompressed_data = @gzuncompress(substr($parsed_frame['data'], 4))) {
rlm@3 528 $parsed_frame['data'] = $decompressed_data;
rlm@3 529 } else {
rlm@3 530 $getid3->warning('gzuncompress() failed on compressed contents of ID3v2 frame "'.$parsed_frame['frame_name'].'"');
rlm@3 531 }
rlm@3 532 }
rlm@3 533 }
rlm@3 534
rlm@3 535
rlm@3 536 if (isset($parsed_frame['datalength']) && ($parsed_frame['datalength'] == 0)) {
rlm@3 537
rlm@3 538 $warning = 'Frame "'.$parsed_frame['frame_name'].'" at offset '.$parsed_frame['dataoffset'].' has no data portion';
rlm@3 539 switch ($parsed_frame['frame_name']) {
rlm@3 540 case 'WCOM':
rlm@3 541 $warning .= ' (this is known to happen with files tagged by RioPort)';
rlm@3 542 break;
rlm@3 543
rlm@3 544 default:
rlm@3 545 break;
rlm@3 546 }
rlm@3 547 $getid3->warning($warning);
rlm@3 548 return true;
rlm@3 549 }
rlm@3 550
rlm@3 551
rlm@3 552 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'UFID')) || // 4.1 UFID Unique file identifier
rlm@3 553 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'UFI'))) { // 4.1 UFI Unique file identifier
rlm@3 554
rlm@3 555 // There may be more than one 'UFID' frame in a tag,
rlm@3 556 // but only one with the same 'Owner identifier'.
rlm@3 557 // <Header for 'Unique file identifier', ID: 'UFID'>
rlm@3 558 // Owner identifier <text string> $00
rlm@3 559 // Identifier <up to 64 bytes binary data>
rlm@3 560
rlm@3 561 $frame_terminator_pos = strpos($parsed_frame['data'], "\x00");
rlm@3 562 $frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos);
rlm@3 563 $parsed_frame['ownerid'] = $frame_id_string;
rlm@3 564 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
rlm@3 565 unset($parsed_frame['data']);
rlm@3 566 return true;
rlm@3 567 }
rlm@3 568
rlm@3 569
rlm@3 570 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'TXXX')) || // 4.2.2 TXXX User defined text information frame
rlm@3 571 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'TXX'))) { // 4.2.2 TXX User defined text information frame
rlm@3 572
rlm@3 573 // There may be more than one 'TXXX' frame in each tag,
rlm@3 574 // but only one with the same description.
rlm@3 575 // <Header for 'User defined text information frame', ID: 'TXXX'>
rlm@3 576 // Text encoding $xx
rlm@3 577 // Description <text string according to encoding> $00 (00)
rlm@3 578 // Value <text string according to encoding>
rlm@3 579
rlm@3 580 $frame_offset = 0;
rlm@3 581 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 582
rlm@3 583 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 584 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 585 }
rlm@3 586 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 587 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 588 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 589 }
rlm@3 590 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 591 if (ord($frame_description) === 0) {
rlm@3 592 $frame_description = '';
rlm@3 593 }
rlm@3 594 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 595 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 596
rlm@3 597 $parsed_frame['description'] = $frame_description;
rlm@3 598 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
rlm@3 599 if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
rlm@3 600 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = trim($getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']));
rlm@3 601 }
rlm@3 602 unset($parsed_frame['data']);
rlm@3 603 return true;
rlm@3 604 }
rlm@3 605
rlm@3 606
rlm@3 607 if ($parsed_frame['frame_name']{0} == 'T') { // 4.2. T??[?] Text information frame
rlm@3 608
rlm@3 609 // There may only be one text information frame of its kind in an tag.
rlm@3 610 // <Header for 'Text information frame', ID: 'T000' - 'TZZZ',
rlm@3 611 // excluding 'TXXX' described in 4.2.6.>
rlm@3 612 // Text encoding $xx
rlm@3 613 // Information <text string(s) according to encoding>
rlm@3 614
rlm@3 615 $frame_offset = 0;
rlm@3 616 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 617 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 618 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 619 }
rlm@3 620
rlm@3 621 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 622
rlm@3 623 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 624 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 625
rlm@3 626 if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
rlm@3 627
rlm@3 628 // remove possible terminating \x00 (put by encoding id or software bug)
rlm@3 629 $string = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
rlm@3 630 if ($string[strlen($string)-1] = "\x00") {
rlm@3 631 $string = substr($string, 0, strlen($string)-1);
rlm@3 632 }
rlm@3 633 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $string;
rlm@3 634 unset($string);
rlm@3 635 }
rlm@3 636 return true;
rlm@3 637 }
rlm@3 638
rlm@3 639
rlm@3 640 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'WXXX')) || // 4.3.2 WXXX User defined URL link frame
rlm@3 641 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'WXX'))) { // 4.3.2 WXX User defined URL link frame
rlm@3 642
rlm@3 643 // There may be more than one 'WXXX' frame in each tag,
rlm@3 644 // but only one with the same description
rlm@3 645 // <Header for 'User defined URL link frame', ID: 'WXXX'>
rlm@3 646 // Text encoding $xx
rlm@3 647 // Description <text string according to encoding> $00 (00)
rlm@3 648 // URL <text string>
rlm@3 649
rlm@3 650 $frame_offset = 0;
rlm@3 651 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 652 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 653 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 654 }
rlm@3 655 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 656 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 657 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 658 }
rlm@3 659 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 660
rlm@3 661 if (ord($frame_description) === 0) {
rlm@3 662 $frame_description = '';
rlm@3 663 }
rlm@3 664 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
rlm@3 665
rlm@3 666 $frame_terminator_pos = strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
rlm@3 667 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 668 $frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 669 }
rlm@3 670 if ($frame_terminator_pos) {
rlm@3 671 // there are null bytes after the data - this is not according to spec
rlm@3 672 // only use data up to first null byte
rlm@3 673 $frame_urldata = (string)substr($parsed_frame['data'], 0, $frame_terminator_pos);
rlm@3 674 } else {
rlm@3 675 // no null bytes following data, just use all data
rlm@3 676 $frame_urldata = (string)$parsed_frame['data'];
rlm@3 677 }
rlm@3 678
rlm@3 679 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 680 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 681
rlm@3 682 $parsed_frame['url'] = $frame_urldata;
rlm@3 683 $parsed_frame['description'] = $frame_description;
rlm@3 684 if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
rlm@3 685 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['url']);
rlm@3 686 }
rlm@3 687 unset($parsed_frame['data']);
rlm@3 688 return true;
rlm@3 689 }
rlm@3 690
rlm@3 691
rlm@3 692 if ($parsed_frame['frame_name']{0} == 'W') { // 4.3. W??? URL link frames
rlm@3 693
rlm@3 694 // There may only be one URL link frame of its kind in a tag,
rlm@3 695 // except when stated otherwise in the frame description
rlm@3 696 // <Header for 'URL link frame', ID: 'W000' - 'WZZZ', excluding 'WXXX'
rlm@3 697 // described in 4.3.2.>
rlm@3 698 // URL <text string>
rlm@3 699
rlm@3 700 $parsed_frame['url'] = trim($parsed_frame['data']);
rlm@3 701 if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
rlm@3 702 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['url'];
rlm@3 703 }
rlm@3 704 unset($parsed_frame['data']);
rlm@3 705 return true;
rlm@3 706 }
rlm@3 707
rlm@3 708
rlm@3 709 if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'IPLS')) || // 4.4 IPLS Involved people list (ID3v2.3 only)
rlm@3 710 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'IPL'))) { // 4.4 IPL Involved people list (ID3v2.2 only)
rlm@3 711
rlm@3 712 // There may only be one 'IPL' frame in each tag
rlm@3 713 // <Header for 'User defined URL link frame', ID: 'IPL'>
rlm@3 714 // Text encoding $xx
rlm@3 715 // People list strings <textstrings>
rlm@3 716
rlm@3 717 $frame_offset = 0;
rlm@3 718 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 719 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 720 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 721 }
rlm@3 722 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 723 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($parsed_frame['encodingid']);
rlm@3 724
rlm@3 725 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 726 if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
rlm@3 727 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
rlm@3 728 }
rlm@3 729 return true;
rlm@3 730 }
rlm@3 731
rlm@3 732
rlm@3 733 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MCDI')) || // 4.4 MCDI Music CD identifier
rlm@3 734 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MCI'))) { // 4.5 MCI Music CD identifier
rlm@3 735
rlm@3 736 // There may only be one 'MCDI' frame in each tag
rlm@3 737 // <Header for 'Music CD identifier', ID: 'MCDI'>
rlm@3 738 // CD TOC <binary data>
rlm@3 739
rlm@3 740 if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
rlm@3 741 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['data'];
rlm@3 742 }
rlm@3 743 return true;
rlm@3 744 }
rlm@3 745
rlm@3 746
rlm@3 747 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ETCO')) || // 4.5 ETCO Event timing codes
rlm@3 748 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ETC'))) { // 4.6 ETC Event timing codes
rlm@3 749
rlm@3 750 // There may only be one 'ETCO' frame in each tag
rlm@3 751 // <Header for 'Event timing codes', ID: 'ETCO'>
rlm@3 752 // Time stamp format $xx
rlm@3 753 // Where time stamp format is:
rlm@3 754 // $01 (32-bit value) MPEG frames from beginning of file
rlm@3 755 // $02 (32-bit value) milliseconds from beginning of file
rlm@3 756 // Followed by a list of key events in the following format:
rlm@3 757 // Type of event $xx
rlm@3 758 // Time stamp $xx (xx ...)
rlm@3 759 // The 'Time stamp' is set to zero if directly at the beginning of the sound
rlm@3 760 // or after the previous event. All events MUST be sorted in chronological order.
rlm@3 761
rlm@3 762 $frame_offset = 0;
rlm@3 763 $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 764
rlm@3 765 while ($frame_offset < strlen($parsed_frame['data'])) {
rlm@3 766 $parsed_frame['typeid'] = $parsed_frame['data']{$frame_offset++};
rlm@3 767 $parsed_frame['type'] = getid3_id3v2::ETCOEventLookup($parsed_frame['typeid']);
rlm@3 768 $parsed_frame['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
rlm@3 769 $frame_offset += 4;
rlm@3 770 }
rlm@3 771 unset($parsed_frame['data']);
rlm@3 772 return true;
rlm@3 773 }
rlm@3 774
rlm@3 775
rlm@3 776 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MLLT')) || // 4.6 MLLT MPEG location lookup table
rlm@3 777 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MLL'))) { // 4.7 MLL MPEG location lookup table
rlm@3 778
rlm@3 779 // There may only be one 'MLLT' frame in each tag
rlm@3 780 // <Header for 'Location lookup table', ID: 'MLLT'>
rlm@3 781 // MPEG frames between reference $xx xx
rlm@3 782 // Bytes between reference $xx xx xx
rlm@3 783 // Milliseconds between reference $xx xx xx
rlm@3 784 // Bits for bytes deviation $xx
rlm@3 785 // Bits for milliseconds dev. $xx
rlm@3 786 // Then for every reference the following data is included;
rlm@3 787 // Deviation in bytes %xxx....
rlm@3 788 // Deviation in milliseconds %xxx....
rlm@3 789
rlm@3 790 $frame_offset = 0;
rlm@3 791 $parsed_frame['framesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 2));
rlm@3 792 $parsed_frame['bytesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 2, 3));
rlm@3 793 $parsed_frame['msbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 5, 3));
rlm@3 794 $parsed_frame['bitsforbytesdeviation'] = getid3_lib::BigEndian2Int($parsed_frame['data'][8]);
rlm@3 795 $parsed_frame['bitsformsdeviation'] = getid3_lib::BigEndian2Int($parsed_frame['data'][9]);
rlm@3 796 $parsed_frame['data'] = substr($parsed_frame['data'], 10);
rlm@3 797
rlm@3 798 while ($frame_offset < strlen($parsed_frame['data'])) {
rlm@3 799 $deviation_bitstream .= getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
rlm@3 800 }
rlm@3 801 $reference_counter = 0;
rlm@3 802 while (strlen($deviation_bitstream) > 0) {
rlm@3 803 $parsed_frame[$reference_counter]['bytedeviation'] = bindec(substr($deviation_bitstream, 0, $parsed_frame['bitsforbytesdeviation']));
rlm@3 804 $parsed_frame[$reference_counter]['msdeviation'] = bindec(substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'], $parsed_frame['bitsformsdeviation']));
rlm@3 805 $deviation_bitstream = substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'] + $parsed_frame['bitsformsdeviation']);
rlm@3 806 $reference_counter++;
rlm@3 807 }
rlm@3 808 unset($parsed_frame['data']);
rlm@3 809 return true;
rlm@3 810 }
rlm@3 811
rlm@3 812
rlm@3 813 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYTC')) || // 4.7 SYTC Synchronised tempo codes
rlm@3 814 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'STC'))) { // 4.8 STC Synchronised tempo codes
rlm@3 815
rlm@3 816 // There may only be one 'SYTC' frame in each tag
rlm@3 817 // <Header for 'Synchronised tempo codes', ID: 'SYTC'>
rlm@3 818 // Time stamp format $xx
rlm@3 819 // Tempo data <binary data>
rlm@3 820 // Where time stamp format is:
rlm@3 821 // $01 (32-bit value) MPEG frames from beginning of file
rlm@3 822 // $02 (32-bit value) milliseconds from beginning of file
rlm@3 823
rlm@3 824 $frame_offset = 0;
rlm@3 825 $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 826 $timestamp_counter = 0;
rlm@3 827 while ($frame_offset < strlen($parsed_frame['data'])) {
rlm@3 828 $parsed_frame[$timestamp_counter]['tempo'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 829 if ($parsed_frame[$timestamp_counter]['tempo'] == 255) {
rlm@3 830 $parsed_frame[$timestamp_counter]['tempo'] += ord($parsed_frame['data']{$frame_offset++});
rlm@3 831 }
rlm@3 832 $parsed_frame[$timestamp_counter]['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
rlm@3 833 $frame_offset += 4;
rlm@3 834 $timestamp_counter++;
rlm@3 835 }
rlm@3 836 unset($parsed_frame['data']);
rlm@3 837 return true;
rlm@3 838 }
rlm@3 839
rlm@3 840
rlm@3 841 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USLT')) || // 4.8 USLT Unsynchronised lyric/text transcription
rlm@3 842 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ULT'))) { // 4.9 ULT Unsynchronised lyric/text transcription
rlm@3 843
rlm@3 844 // There may be more than one 'Unsynchronised lyrics/text transcription' frame
rlm@3 845 // in each tag, but only one with the same language and content descriptor.
rlm@3 846 // <Header for 'Unsynchronised lyrics/text transcription', ID: 'USLT'>
rlm@3 847 // Text encoding $xx
rlm@3 848 // Language $xx xx xx
rlm@3 849 // Content descriptor <text string according to encoding> $00 (00)
rlm@3 850 // Lyrics/text <full text string according to encoding>
rlm@3 851
rlm@3 852 $frame_offset = 0;
rlm@3 853 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 854 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 855 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 856 }
rlm@3 857 $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
rlm@3 858 $frame_offset += 3;
rlm@3 859 if ($frame_offset > strlen($parsed_frame['data'])) {
rlm@3 860 $frame_offset = strlen($parsed_frame['data']) - 1;
rlm@3 861 }
rlm@3 862 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 863 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 864 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 865 }
rlm@3 866 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 867 if (ord($frame_description) === 0) {
rlm@3 868 $frame_description = '';
rlm@3 869 }
rlm@3 870 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
rlm@3 871
rlm@3 872 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 873 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 874
rlm@3 875 $parsed_frame['data'] = $parsed_frame['data'];
rlm@3 876 $parsed_frame['language'] = $frame_language;
rlm@3 877 $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
rlm@3 878 $parsed_frame['description'] = $frame_description;
rlm@3 879 if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
rlm@3 880 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
rlm@3 881 }
rlm@3 882 unset($parsed_frame['data']);
rlm@3 883 return true;
rlm@3 884 }
rlm@3 885
rlm@3 886
rlm@3 887 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYLT')) || // 4.9 SYLT Synchronised lyric/text
rlm@3 888 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'SLT'))) { // 4.10 SLT Synchronised lyric/text
rlm@3 889
rlm@3 890 // There may be more than one 'SYLT' frame in each tag,
rlm@3 891 // but only one with the same language and content descriptor.
rlm@3 892 // <Header for 'Synchronised lyrics/text', ID: 'SYLT'>
rlm@3 893 // Text encoding $xx
rlm@3 894 // Language $xx xx xx
rlm@3 895 // Time stamp format $xx
rlm@3 896 // $01 (32-bit value) MPEG frames from beginning of file
rlm@3 897 // $02 (32-bit value) milliseconds from beginning of file
rlm@3 898 // Content type $xx
rlm@3 899 // Content descriptor <text string according to encoding> $00 (00)
rlm@3 900 // Terminated text to be synced (typically a syllable)
rlm@3 901 // Sync identifier (terminator to above string) $00 (00)
rlm@3 902 // Time stamp $xx (xx ...)
rlm@3 903
rlm@3 904 $frame_offset = 0;
rlm@3 905 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 906 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 907 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 908 }
rlm@3 909 $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
rlm@3 910 $frame_offset += 3;
rlm@3 911 $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 912 $parsed_frame['contenttypeid'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 913 $parsed_frame['contenttype'] = getid3_id3v2::SYTLContentTypeLookup($parsed_frame['contenttypeid']);
rlm@3 914 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 915 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 916
rlm@3 917 $parsed_frame['language'] = $frame_language;
rlm@3 918 $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
rlm@3 919
rlm@3 920 $timestamp_index = 0;
rlm@3 921 $frame_remaining_data = substr($parsed_frame['data'], $frame_offset);
rlm@3 922 while (strlen($frame_remaining_data)) {
rlm@3 923 $frame_offset = 0;
rlm@3 924 $frame_terminator_pos = strpos($frame_remaining_data, getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
rlm@3 925 if ($frame_terminator_pos === false) {
rlm@3 926 $frame_remaining_data = '';
rlm@3 927 } else {
rlm@3 928 if (ord(substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 929 $frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 930 }
rlm@3 931 $parsed_frame['lyrics'][$timestamp_index]['data'] = substr($frame_remaining_data, $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 932
rlm@3 933 $frame_remaining_data = substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
rlm@3 934 if (($timestamp_index == 0) && (ord($frame_remaining_data{0}) != 0)) {
rlm@3 935 // timestamp probably omitted for first data item
rlm@3 936 } else {
rlm@3 937 $parsed_frame['lyrics'][$timestamp_index]['timestamp'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 4));
rlm@3 938 $frame_remaining_data = substr($frame_remaining_data, 4);
rlm@3 939 }
rlm@3 940 $timestamp_index++;
rlm@3 941 }
rlm@3 942 }
rlm@3 943 unset($parsed_frame['data']);
rlm@3 944 return true;
rlm@3 945 }
rlm@3 946
rlm@3 947
rlm@3 948 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMM')) || // 4.10 COMM Comments
rlm@3 949 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'COM'))) { // 4.11 COM Comments
rlm@3 950
rlm@3 951 // There may be more than one comment frame in each tag,
rlm@3 952 // but only one with the same language and content descriptor.
rlm@3 953 // <Header for 'Comment', ID: 'COMM'>
rlm@3 954 // Text encoding $xx
rlm@3 955 // Language $xx xx xx
rlm@3 956 // Short content descrip. <text string according to encoding> $00 (00)
rlm@3 957 // The actual text <full text string according to encoding>
rlm@3 958
rlm@3 959 if (strlen($parsed_frame['data']) < 5) {
rlm@3 960
rlm@3 961 $getid3->warning('Invalid data (too short) for "'.$parsed_frame['frame_name'].'" frame at offset '.$parsed_frame['dataoffset']);
rlm@3 962 return true;
rlm@3 963 }
rlm@3 964
rlm@3 965 $frame_offset = 0;
rlm@3 966 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 967 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 968 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 969 }
rlm@3 970 $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
rlm@3 971 $frame_offset += 3;
rlm@3 972 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 973 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 974 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 975 }
rlm@3 976 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 977 if (ord($frame_description) === 0) {
rlm@3 978 $frame_description = '';
rlm@3 979 }
rlm@3 980 $frame_text = (string)substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
rlm@3 981
rlm@3 982 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 983 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 984
rlm@3 985 $parsed_frame['language'] = $frame_language;
rlm@3 986 $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
rlm@3 987 $parsed_frame['description'] = $frame_description;
rlm@3 988 $parsed_frame['data'] = $frame_text;
rlm@3 989 if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
rlm@3 990 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
rlm@3 991 }
rlm@3 992 return true;
rlm@3 993 }
rlm@3 994
rlm@3 995
rlm@3 996 if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'RVA2')) { // 4.11 RVA2 Relative volume adjustment (2) (ID3v2.4+ only)
rlm@3 997
rlm@3 998 // There may be more than one 'RVA2' frame in each tag,
rlm@3 999 // but only one with the same identification string
rlm@3 1000 // <Header for 'Relative volume adjustment (2)', ID: 'RVA2'>
rlm@3 1001 // Identification <text string> $00
rlm@3 1002 // The 'identification' string is used to identify the situation and/or
rlm@3 1003 // device where this adjustment should apply. The following is then
rlm@3 1004 // repeated for every channel:
rlm@3 1005 // Type of channel $xx
rlm@3 1006 // Volume adjustment $xx xx
rlm@3 1007 // Bits representing peak $xx
rlm@3 1008 // Peak volume $xx (xx ...)
rlm@3 1009
rlm@3 1010 $frame_terminator_pos = strpos($parsed_frame['data'], "\x00");
rlm@3 1011 $frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos);
rlm@3 1012 if (ord($frame_id_string) === 0) {
rlm@3 1013 $frame_id_string = '';
rlm@3 1014 }
rlm@3 1015 $frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
rlm@3 1016 $parsed_frame['description'] = $frame_id_string;
rlm@3 1017
rlm@3 1018 while (strlen($frame_remaining_data)) {
rlm@3 1019 $frame_offset = 0;
rlm@3 1020 $frame_channeltypeid = ord(substr($frame_remaining_data, $frame_offset++, 1));
rlm@3 1021 $parsed_frame[$frame_channeltypeid]['channeltypeid'] = $frame_channeltypeid;
rlm@3 1022 $parsed_frame[$frame_channeltypeid]['channeltype'] = getid3_id3v2::RVA2ChannelTypeLookup($frame_channeltypeid);
rlm@3 1023 $parsed_frame[$frame_channeltypeid]['volumeadjust'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, 2), true); // 16-bit signed
rlm@3 1024 $frame_offset += 2;
rlm@3 1025 $parsed_frame[$frame_channeltypeid]['bitspeakvolume'] = ord(substr($frame_remaining_data, $frame_offset++, 1));
rlm@3 1026 $frame_bytespeakvolume = ceil($parsed_frame[$frame_channeltypeid]['bitspeakvolume'] / 8);
rlm@3 1027 $parsed_frame[$frame_channeltypeid]['peakvolume'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, $frame_bytespeakvolume));
rlm@3 1028 $frame_remaining_data = substr($frame_remaining_data, $frame_offset + $frame_bytespeakvolume);
rlm@3 1029 }
rlm@3 1030 unset($parsed_frame['data']);
rlm@3 1031 return true;
rlm@3 1032 }
rlm@3 1033
rlm@3 1034
rlm@3 1035 if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'RVAD')) || // 4.12 RVAD Relative volume adjustment (ID3v2.3 only)
rlm@3 1036 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'RVA'))) { // 4.12 RVA Relative volume adjustment (ID3v2.2 only)
rlm@3 1037
rlm@3 1038 // There may only be one 'RVA' frame in each tag
rlm@3 1039 // <Header for 'Relative volume adjustment', ID: 'RVA'>
rlm@3 1040 // ID3v2.2 => Increment/decrement %000000ba
rlm@3 1041 // ID3v2.3 => Increment/decrement %00fedcba
rlm@3 1042 // Bits used for volume descr. $xx
rlm@3 1043 // Relative volume change, right $xx xx (xx ...) // a
rlm@3 1044 // Relative volume change, left $xx xx (xx ...) // b
rlm@3 1045 // Peak volume right $xx xx (xx ...)
rlm@3 1046 // Peak volume left $xx xx (xx ...)
rlm@3 1047 // ID3v2.3 only, optional (not present in ID3v2.2):
rlm@3 1048 // Relative volume change, right back $xx xx (xx ...) // c
rlm@3 1049 // Relative volume change, left back $xx xx (xx ...) // d
rlm@3 1050 // Peak volume right back $xx xx (xx ...)
rlm@3 1051 // Peak volume left back $xx xx (xx ...)
rlm@3 1052 // ID3v2.3 only, optional (not present in ID3v2.2):
rlm@3 1053 // Relative volume change, center $xx xx (xx ...) // e
rlm@3 1054 // Peak volume center $xx xx (xx ...)
rlm@3 1055 // ID3v2.3 only, optional (not present in ID3v2.2):
rlm@3 1056 // Relative volume change, bass $xx xx (xx ...) // f
rlm@3 1057 // Peak volume bass $xx xx (xx ...)
rlm@3 1058
rlm@3 1059 $frame_offset = 0;
rlm@3 1060 $frame_incrdecrflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
rlm@3 1061 $parsed_frame['incdec']['right'] = (bool)substr($frame_incrdecrflags, 6, 1);
rlm@3 1062 $parsed_frame['incdec']['left'] = (bool)substr($frame_incrdecrflags, 7, 1);
rlm@3 1063 $parsed_frame['bitsvolume'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1064 $frame_bytesvolume = ceil($parsed_frame['bitsvolume'] / 8);
rlm@3 1065 $parsed_frame['volumechange']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1066 if ($parsed_frame['incdec']['right'] === false) {
rlm@3 1067 $parsed_frame['volumechange']['right'] *= -1;
rlm@3 1068 }
rlm@3 1069 $frame_offset += $frame_bytesvolume;
rlm@3 1070 $parsed_frame['volumechange']['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1071 if ($parsed_frame['incdec']['left'] === false) {
rlm@3 1072 $parsed_frame['volumechange']['left'] *= -1;
rlm@3 1073 }
rlm@3 1074 $frame_offset += $frame_bytesvolume;
rlm@3 1075 $parsed_frame['peakvolume']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1076 $frame_offset += $frame_bytesvolume;
rlm@3 1077 $parsed_frame['peakvolume']['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1078 $frame_offset += $frame_bytesvolume;
rlm@3 1079 if ($id3v2_major_version == 3) {
rlm@3 1080 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
rlm@3 1081 if (strlen($parsed_frame['data']) > 0) {
rlm@3 1082 $parsed_frame['incdec']['rightrear'] = (bool)substr($frame_incrdecrflags, 4, 1);
rlm@3 1083 $parsed_frame['incdec']['leftrear'] = (bool)substr($frame_incrdecrflags, 5, 1);
rlm@3 1084 $parsed_frame['volumechange']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1085 if ($parsed_frame['incdec']['rightrear'] === false) {
rlm@3 1086 $parsed_frame['volumechange']['rightrear'] *= -1;
rlm@3 1087 }
rlm@3 1088 $frame_offset += $frame_bytesvolume;
rlm@3 1089 $parsed_frame['volumechange']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1090 if ($parsed_frame['incdec']['leftrear'] === false) {
rlm@3 1091 $parsed_frame['volumechange']['leftrear'] *= -1;
rlm@3 1092 }
rlm@3 1093 $frame_offset += $frame_bytesvolume;
rlm@3 1094 $parsed_frame['peakvolume']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1095 $frame_offset += $frame_bytesvolume;
rlm@3 1096 $parsed_frame['peakvolume']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1097 $frame_offset += $frame_bytesvolume;
rlm@3 1098 }
rlm@3 1099 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
rlm@3 1100 if (strlen($parsed_frame['data']) > 0) {
rlm@3 1101 $parsed_frame['incdec']['center'] = (bool)substr($frame_incrdecrflags, 3, 1);
rlm@3 1102 $parsed_frame['volumechange']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1103 if ($parsed_frame['incdec']['center'] === false) {
rlm@3 1104 $parsed_frame['volumechange']['center'] *= -1;
rlm@3 1105 }
rlm@3 1106 $frame_offset += $frame_bytesvolume;
rlm@3 1107 $parsed_frame['peakvolume']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1108 $frame_offset += $frame_bytesvolume;
rlm@3 1109 }
rlm@3 1110 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
rlm@3 1111 if (strlen($parsed_frame['data']) > 0) {
rlm@3 1112 $parsed_frame['incdec']['bass'] = (bool)substr($frame_incrdecrflags, 2, 1);
rlm@3 1113 $parsed_frame['volumechange']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1114 if ($parsed_frame['incdec']['bass'] === false) {
rlm@3 1115 $parsed_frame['volumechange']['bass'] *= -1;
rlm@3 1116 }
rlm@3 1117 $frame_offset += $frame_bytesvolume;
rlm@3 1118 $parsed_frame['peakvolume']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
rlm@3 1119 $frame_offset += $frame_bytesvolume;
rlm@3 1120 }
rlm@3 1121 }
rlm@3 1122 unset($parsed_frame['data']);
rlm@3 1123 return true;
rlm@3 1124 }
rlm@3 1125
rlm@3 1126
rlm@3 1127 if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'EQU2')) { // 4.12 EQU2 Equalisation (2) (ID3v2.4+ only)
rlm@3 1128
rlm@3 1129 // There may be more than one 'EQU2' frame in each tag,
rlm@3 1130 // but only one with the same identification string
rlm@3 1131 // <Header of 'Equalisation (2)', ID: 'EQU2'>
rlm@3 1132 // Interpolation method $xx
rlm@3 1133 // $00 Band
rlm@3 1134 // $01 Linear
rlm@3 1135 // Identification <text string> $00
rlm@3 1136 // The following is then repeated for every adjustment point
rlm@3 1137 // Frequency $xx xx
rlm@3 1138 // Volume adjustment $xx xx
rlm@3 1139
rlm@3 1140 $frame_offset = 0;
rlm@3 1141 $frame_interpolationmethod = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1142 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1143 $frame_id_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1144 if (ord($frame_id_string) === 0) {
rlm@3 1145 $frame_id_string = '';
rlm@3 1146 }
rlm@3 1147 $parsed_frame['description'] = $frame_id_string;
rlm@3 1148 $frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
rlm@3 1149 while (strlen($frame_remaining_data)) {
rlm@3 1150 $frame_frequency = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 2)) / 2;
rlm@3 1151 $parsed_frame['data'][$frame_frequency] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, 2), true);
rlm@3 1152 $frame_remaining_data = substr($frame_remaining_data, 4);
rlm@3 1153 }
rlm@3 1154 $parsed_frame['interpolationmethod'] = $frame_interpolationmethod;
rlm@3 1155 unset($parsed_frame['data']);
rlm@3 1156 return true;
rlm@3 1157 }
rlm@3 1158
rlm@3 1159
rlm@3 1160 if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'EQUA')) || // 4.12 EQUA Equalisation (ID3v2.3 only)
rlm@3 1161 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'EQU'))) { // 4.13 EQU Equalisation (ID3v2.2 only)
rlm@3 1162
rlm@3 1163 // There may only be one 'EQUA' frame in each tag
rlm@3 1164 // <Header for 'Relative volume adjustment', ID: 'EQU'>
rlm@3 1165 // Adjustment bits $xx
rlm@3 1166 // This is followed by 2 bytes + ('adjustment bits' rounded up to the
rlm@3 1167 // nearest byte) for every equalisation band in the following format,
rlm@3 1168 // giving a frequency range of 0 - 32767Hz:
rlm@3 1169 // Increment/decrement %x (MSB of the Frequency)
rlm@3 1170 // Frequency (lower 15 bits)
rlm@3 1171 // Adjustment $xx (xx ...)
rlm@3 1172
rlm@3 1173 $frame_offset = 0;
rlm@3 1174 $parsed_frame['adjustmentbits'] = $parsed_frame['data']{$frame_offset++};
rlm@3 1175 $frame_adjustment_bytes = ceil($parsed_frame['adjustmentbits'] / 8);
rlm@3 1176
rlm@3 1177 $frame_remaining_data = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1178 while (strlen($frame_remaining_data) > 0) {
rlm@3 1179 $frame_frequencystr = getid3_lib::BigEndian2Bin(substr($frame_remaining_data, 0, 2));
rlm@3 1180 $frame_incdec = (bool)substr($frame_frequencystr, 0, 1);
rlm@3 1181 $frame_frequency = bindec(substr($frame_frequencystr, 1, 15));
rlm@3 1182 $parsed_frame[$frame_frequency]['incdec'] = $frame_incdec;
rlm@3 1183 $parsed_frame[$frame_frequency]['adjustment'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, $frame_adjustment_bytes));
rlm@3 1184 if ($parsed_frame[$frame_frequency]['incdec'] === false) {
rlm@3 1185 $parsed_frame[$frame_frequency]['adjustment'] *= -1;
rlm@3 1186 }
rlm@3 1187 $frame_remaining_data = substr($frame_remaining_data, 2 + $frame_adjustment_bytes);
rlm@3 1188 }
rlm@3 1189 unset($parsed_frame['data']);
rlm@3 1190 return true;
rlm@3 1191 }
rlm@3 1192
rlm@3 1193
rlm@3 1194 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RVRB')) || // 4.13 RVRB Reverb
rlm@3 1195 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'REV'))) { // 4.14 REV Reverb
rlm@3 1196
rlm@3 1197 // There may only be one 'RVRB' frame in each tag.
rlm@3 1198 // <Header for 'Reverb', ID: 'RVRB'>
rlm@3 1199 // Reverb left (ms) $xx xx
rlm@3 1200 // Reverb right (ms) $xx xx
rlm@3 1201 // Reverb bounces, left $xx
rlm@3 1202 // Reverb bounces, right $xx
rlm@3 1203 // Reverb feedback, left to left $xx
rlm@3 1204 // Reverb feedback, left to right $xx
rlm@3 1205 // Reverb feedback, right to right $xx
rlm@3 1206 // Reverb feedback, right to left $xx
rlm@3 1207 // Premix left to right $xx
rlm@3 1208 // Premix right to left $xx
rlm@3 1209
rlm@3 1210 $frame_offset = 0;
rlm@3 1211 $parsed_frame['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
rlm@3 1212 $frame_offset += 2;
rlm@3 1213 $parsed_frame['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
rlm@3 1214 $frame_offset += 2;
rlm@3 1215 $parsed_frame['bouncesL'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1216 $parsed_frame['bouncesR'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1217 $parsed_frame['feedbackLL'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1218 $parsed_frame['feedbackLR'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1219 $parsed_frame['feedbackRR'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1220 $parsed_frame['feedbackRL'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1221 $parsed_frame['premixLR'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1222 $parsed_frame['premixRL'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1223 unset($parsed_frame['data']);
rlm@3 1224 return true;
rlm@3 1225 }
rlm@3 1226
rlm@3 1227
rlm@3 1228 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'APIC')) || // 4.14 APIC Attached picture
rlm@3 1229 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'PIC'))) { // 4.15 PIC Attached picture
rlm@3 1230
rlm@3 1231 // There may be several pictures attached to one file,
rlm@3 1232 // each in their individual 'APIC' frame, but only one
rlm@3 1233 // with the same content descriptor
rlm@3 1234 // <Header for 'Attached picture', ID: 'APIC'>
rlm@3 1235 // Text encoding $xx
rlm@3 1236 // ID3v2.3+ => MIME type <text string> $00
rlm@3 1237 // ID3v2.2 => Image format $xx xx xx
rlm@3 1238 // Picture type $xx
rlm@3 1239 // Description <text string according to encoding> $00 (00)
rlm@3 1240 // Picture data <binary data>
rlm@3 1241
rlm@3 1242 $frame_offset = 0;
rlm@3 1243 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1244 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 1245 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 1246 }
rlm@3 1247
rlm@3 1248 if ($id3v2_major_version == 2 && strlen($parsed_frame['data']) > $frame_offset) {
rlm@3 1249 $frame_imagetype = substr($parsed_frame['data'], $frame_offset, 3);
rlm@3 1250 if (strtolower($frame_imagetype) == 'ima') {
rlm@3 1251 // complete hack for mp3Rage (www.chaoticsoftware.com) that puts ID3v2.3-formatted
rlm@3 1252 // MIME type instead of 3-char ID3v2.2-format image type (thanks xbhoffØpacbell*net)
rlm@3 1253 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1254 $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1255 if (ord($frame_mimetype) === 0) {
rlm@3 1256 $frame_mimetype = '';
rlm@3 1257 }
rlm@3 1258 $frame_imagetype = strtoupper(str_replace('image/', '', strtolower($frame_mimetype)));
rlm@3 1259 if ($frame_imagetype == 'JPEG') {
rlm@3 1260 $frame_imagetype = 'JPG';
rlm@3 1261 }
rlm@3 1262 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1263 } else {
rlm@3 1264 $frame_offset += 3;
rlm@3 1265 }
rlm@3 1266 }
rlm@3 1267
rlm@3 1268 if ($id3v2_major_version > 2 && strlen($parsed_frame['data']) > $frame_offset) {
rlm@3 1269 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1270 $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1271 if (ord($frame_mimetype) === 0) {
rlm@3 1272 $frame_mimetype = '';
rlm@3 1273 }
rlm@3 1274 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1275 }
rlm@3 1276
rlm@3 1277 $frame_picturetype = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1278
rlm@3 1279 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 1280 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 1281 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 1282 }
rlm@3 1283 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1284 if (ord($frame_description) === 0) {
rlm@3 1285 $frame_description = '';
rlm@3 1286 }
rlm@3 1287 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 1288 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 1289
rlm@3 1290 if ($id3v2_major_version == 2) {
rlm@3 1291 $parsed_frame['imagetype'] = $frame_imagetype;
rlm@3 1292 } else {
rlm@3 1293 $parsed_frame['mime'] = $frame_mimetype;
rlm@3 1294 }
rlm@3 1295 $parsed_frame['picturetypeid'] = $frame_picturetype;
rlm@3 1296 $parsed_frame['picturetype'] = getid3_id3v2::APICPictureTypeLookup($frame_picturetype);
rlm@3 1297 $parsed_frame['description'] = $frame_description;
rlm@3 1298 $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
rlm@3 1299
rlm@3 1300 if ($getid3->option_tags_images) {
rlm@3 1301
rlm@3 1302 $image_chunk_check = getid3_lib_image_size::get($parsed_frame['data']);
rlm@3 1303 if (($image_chunk_check[2] >= 1) && ($image_chunk_check[2] <= 3)) {
rlm@3 1304 $parsed_frame['image_mime'] = image_type_to_mime_type($image_chunk_check[2]);
rlm@3 1305
rlm@3 1306 if ($image_chunk_check[0]) {
rlm@3 1307 $parsed_frame['image_width'] = $image_chunk_check[0];
rlm@3 1308 }
rlm@3 1309
rlm@3 1310 if ($image_chunk_check[1]) {
rlm@3 1311 $parsed_frame['image_height'] = $image_chunk_check[1];
rlm@3 1312 }
rlm@3 1313
rlm@3 1314 $parsed_frame['image_bytes'] = strlen($parsed_frame['data']);
rlm@3 1315 }
rlm@3 1316 }
rlm@3 1317
rlm@3 1318 return true;
rlm@3 1319 }
rlm@3 1320
rlm@3 1321
rlm@3 1322 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GEOB')) || // 4.15 GEOB General encapsulated object
rlm@3 1323 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'GEO'))) { // 4.16 GEO General encapsulated object
rlm@3 1324
rlm@3 1325 // There may be more than one 'GEOB' frame in each tag,
rlm@3 1326 // but only one with the same content descriptor
rlm@3 1327 // <Header for 'General encapsulated object', ID: 'GEOB'>
rlm@3 1328 // Text encoding $xx
rlm@3 1329 // MIME type <text string> $00
rlm@3 1330 // Filename <text string according to encoding> $00 (00)
rlm@3 1331 // Content description <text string according to encoding> $00 (00)
rlm@3 1332 // Encapsulated object <binary data>
rlm@3 1333
rlm@3 1334 $frame_offset = 0;
rlm@3 1335 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1336 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 1337 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 1338 }
rlm@3 1339 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1340 $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1341 if (ord($frame_mimetype) === 0) {
rlm@3 1342 $frame_mimetype = '';
rlm@3 1343 }
rlm@3 1344 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1345
rlm@3 1346 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 1347 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 1348 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 1349 }
rlm@3 1350 $frame_filename = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1351 if (ord($frame_filename) === 0) {
rlm@3 1352 $frame_filename = '';
rlm@3 1353 }
rlm@3 1354 $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
rlm@3 1355
rlm@3 1356 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 1357 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 1358 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 1359 }
rlm@3 1360 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1361 if (ord($frame_description) === 0) {
rlm@3 1362 $frame_description = '';
rlm@3 1363 }
rlm@3 1364 $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
rlm@3 1365
rlm@3 1366 $parsed_frame['objectdata'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1367 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 1368 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 1369
rlm@3 1370 $parsed_frame['mime'] = $frame_mimetype;
rlm@3 1371 $parsed_frame['filename'] = $frame_filename;
rlm@3 1372 $parsed_frame['description'] = $frame_description;
rlm@3 1373 unset($parsed_frame['data']);
rlm@3 1374 return true;
rlm@3 1375 }
rlm@3 1376
rlm@3 1377
rlm@3 1378 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PCNT')) || // 4.16 PCNT Play counter
rlm@3 1379 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CNT'))) { // 4.17 CNT Play counter
rlm@3 1380
rlm@3 1381 // There may only be one 'PCNT' frame in each tag.
rlm@3 1382 // When the counter reaches all one's, one byte is inserted in
rlm@3 1383 // front of the counter thus making the counter eight bits bigger
rlm@3 1384 // <Header for 'Play counter', ID: 'PCNT'>
rlm@3 1385 // Counter $xx xx xx xx (xx ...)
rlm@3 1386
rlm@3 1387 $parsed_frame['data'] = getid3_lib::BigEndian2Int($parsed_frame['data']);
rlm@3 1388 return true;
rlm@3 1389 }
rlm@3 1390
rlm@3 1391
rlm@3 1392 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POPM')) || // 4.17 POPM Popularimeter
rlm@3 1393 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'POP'))) { // 4.18 POP Popularimeter
rlm@3 1394
rlm@3 1395 // There may be more than one 'POPM' frame in each tag,
rlm@3 1396 // but only one with the same email address
rlm@3 1397 // <Header for 'Popularimeter', ID: 'POPM'>
rlm@3 1398 // Email to user <text string> $00
rlm@3 1399 // Rating $xx
rlm@3 1400 // Counter $xx xx xx xx (xx ...)
rlm@3 1401
rlm@3 1402 $frame_offset = 0;
rlm@3 1403 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1404 $frame_email_address = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1405 if (ord($frame_email_address) === 0) {
rlm@3 1406 $frame_email_address = '';
rlm@3 1407 }
rlm@3 1408 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1409 $frame_rating = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1410 $parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset));
rlm@3 1411 $parsed_frame['email'] = $frame_email_address;
rlm@3 1412 $parsed_frame['rating'] = $frame_rating;
rlm@3 1413 unset($parsed_frame['data']);
rlm@3 1414 return true;
rlm@3 1415 }
rlm@3 1416
rlm@3 1417
rlm@3 1418 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RBUF')) || // 4.18 RBUF Recommended buffer size
rlm@3 1419 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'BUF'))) { // 4.19 BUF Recommended buffer size
rlm@3 1420
rlm@3 1421 // There may only be one 'RBUF' frame in each tag
rlm@3 1422 // <Header for 'Recommended buffer size', ID: 'RBUF'>
rlm@3 1423 // Buffer size $xx xx xx
rlm@3 1424 // Embedded info flag %0000000x
rlm@3 1425 // Offset to next tag $xx xx xx xx
rlm@3 1426
rlm@3 1427 $frame_offset = 0;
rlm@3 1428 $parsed_frame['buffersize'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 3));
rlm@3 1429 $frame_offset += 3;
rlm@3 1430
rlm@3 1431 $frame_embeddedinfoflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
rlm@3 1432 $parsed_frame['flags']['embededinfo'] = (bool)substr($frame_embeddedinfoflags, 7, 1);
rlm@3 1433 $parsed_frame['nexttagoffset'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
rlm@3 1434 unset($parsed_frame['data']);
rlm@3 1435 return true;
rlm@3 1436 }
rlm@3 1437
rlm@3 1438
rlm@3 1439 if (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRM')) { // 4.20 Encrypted meta frame (ID3v2.2 only)
rlm@3 1440
rlm@3 1441 // There may be more than one 'CRM' frame in a tag,
rlm@3 1442 // but only one with the same 'owner identifier'
rlm@3 1443 // <Header for 'Encrypted meta frame', ID: 'CRM'>
rlm@3 1444 // Owner identifier <textstring> $00 (00)
rlm@3 1445 // Content/explanation <textstring> $00 (00)
rlm@3 1446 // Encrypted datablock <binary data>
rlm@3 1447
rlm@3 1448 $frame_offset = 0;
rlm@3 1449 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1450 $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1451 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1452
rlm@3 1453 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1454 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1455 if (ord($frame_description) === 0) {
rlm@3 1456 $frame_description = '';
rlm@3 1457 }
rlm@3 1458 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1459
rlm@3 1460 $parsed_frame['ownerid'] = $frame_owner_id;
rlm@3 1461 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1462 $parsed_frame['description'] = $frame_description;
rlm@3 1463 unset($parsed_frame['data']);
rlm@3 1464 return true;
rlm@3 1465 }
rlm@3 1466
rlm@3 1467
rlm@3 1468 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'AENC')) || // 4.19 AENC Audio encryption
rlm@3 1469 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRA'))) { // 4.21 CRA Audio encryption
rlm@3 1470
rlm@3 1471 // There may be more than one 'AENC' frames in a tag,
rlm@3 1472 // but only one with the same 'Owner identifier'
rlm@3 1473 // <Header for 'Audio encryption', ID: 'AENC'>
rlm@3 1474 // Owner identifier <text string> $00
rlm@3 1475 // Preview start $xx xx
rlm@3 1476 // Preview length $xx xx
rlm@3 1477 // Encryption info <binary data>
rlm@3 1478
rlm@3 1479 $frame_offset = 0;
rlm@3 1480 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1481 $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1482 if (ord($frame_owner_id) === 0) {
rlm@3 1483 $frame_owner_id == '';
rlm@3 1484 }
rlm@3 1485 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1486 $parsed_frame['ownerid'] = $frame_owner_id;
rlm@3 1487 $parsed_frame['previewstart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
rlm@3 1488 $frame_offset += 2;
rlm@3 1489 $parsed_frame['previewlength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
rlm@3 1490 $frame_offset += 2;
rlm@3 1491 $parsed_frame['encryptioninfo'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1492 unset($parsed_frame['data']);
rlm@3 1493 return true;
rlm@3 1494 }
rlm@3 1495
rlm@3 1496
rlm@3 1497 if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'LINK')) || // 4.20 LINK Linked information
rlm@3 1498 (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'LNK'))) { // 4.22 LNK Linked information
rlm@3 1499
rlm@3 1500 // There may be more than one 'LINK' frame in a tag,
rlm@3 1501 // but only one with the same contents
rlm@3 1502 // <Header for 'Linked information', ID: 'LINK'>
rlm@3 1503 // ID3v2.3+ => Frame identifier $xx xx xx xx
rlm@3 1504 // ID3v2.2 => Frame identifier $xx xx xx
rlm@3 1505 // URL <text string> $00
rlm@3 1506 // ID and additional data <text string(s)>
rlm@3 1507
rlm@3 1508 $frame_offset = 0;
rlm@3 1509 if ($id3v2_major_version == 2) {
rlm@3 1510 $parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 3);
rlm@3 1511 $frame_offset += 3;
rlm@3 1512 } else {
rlm@3 1513 $parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 4);
rlm@3 1514 $frame_offset += 4;
rlm@3 1515 }
rlm@3 1516
rlm@3 1517 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1518 $frame_url = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1519 if (ord($frame_url) === 0) {
rlm@3 1520 $frame_url = '';
rlm@3 1521 }
rlm@3 1522 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1523 $parsed_frame['url'] = $frame_url;
rlm@3 1524
rlm@3 1525 $parsed_frame['additionaldata'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1526 if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
rlm@3 1527 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = utf8_encode($parsed_frame['url']);
rlm@3 1528 }
rlm@3 1529 unset($parsed_frame['data']);
rlm@3 1530 return true;
rlm@3 1531 }
rlm@3 1532
rlm@3 1533
rlm@3 1534 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POSS')) { // 4.21 POSS Position synchronisation frame (ID3v2.3+ only)
rlm@3 1535
rlm@3 1536 // There may only be one 'POSS' frame in each tag
rlm@3 1537 // <Head for 'Position synchronisation', ID: 'POSS'>
rlm@3 1538 // Time stamp format $xx
rlm@3 1539 // Position $xx (xx ...)
rlm@3 1540
rlm@3 1541 $frame_offset = 0;
rlm@3 1542 $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1543 $parsed_frame['position'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset));
rlm@3 1544 unset($parsed_frame['data']);
rlm@3 1545 return true;
rlm@3 1546 }
rlm@3 1547
rlm@3 1548
rlm@3 1549 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USER')) { // 4.22 USER Terms of use (ID3v2.3+ only)
rlm@3 1550
rlm@3 1551 // There may be more than one 'Terms of use' frame in a tag,
rlm@3 1552 // but only one with the same 'Language'
rlm@3 1553 // <Header for 'Terms of use frame', ID: 'USER'>
rlm@3 1554 // Text encoding $xx
rlm@3 1555 // Language $xx xx xx
rlm@3 1556 // The actual text <text string according to encoding>
rlm@3 1557
rlm@3 1558 $frame_offset = 0;
rlm@3 1559 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1560 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 1561 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 1562 }
rlm@3 1563 $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
rlm@3 1564 $frame_offset += 3;
rlm@3 1565 $parsed_frame['language'] = $frame_language;
rlm@3 1566 $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
rlm@3 1567 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 1568 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 1569
rlm@3 1570 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1571 if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
rlm@3 1572 $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
rlm@3 1573 }
rlm@3 1574 unset($parsed_frame['data']);
rlm@3 1575 return true;
rlm@3 1576 }
rlm@3 1577
rlm@3 1578
rlm@3 1579 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'OWNE')) { // 4.23 OWNE Ownership frame (ID3v2.3+ only)
rlm@3 1580
rlm@3 1581 // There may only be one 'OWNE' frame in a tag
rlm@3 1582 // <Header for 'Ownership frame', ID: 'OWNE'>
rlm@3 1583 // Text encoding $xx
rlm@3 1584 // Price paid <text string> $00
rlm@3 1585 // Date of purch. <text string>
rlm@3 1586 // Seller <text string according to encoding>
rlm@3 1587
rlm@3 1588 $frame_offset = 0;
rlm@3 1589 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1590 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 1591 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 1592 }
rlm@3 1593 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 1594 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 1595
rlm@3 1596 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1597 $frame_pricepaid = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1598 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1599
rlm@3 1600 $parsed_frame['pricepaid']['currencyid'] = substr($frame_pricepaid, 0, 3);
rlm@3 1601 $parsed_frame['pricepaid']['currency'] = getid3_id3v2::LookupCurrencyUnits($parsed_frame['pricepaid']['currencyid']);
rlm@3 1602 $parsed_frame['pricepaid']['value'] = substr($frame_pricepaid, 3);
rlm@3 1603
rlm@3 1604 $parsed_frame['purchasedate'] = substr($parsed_frame['data'], $frame_offset, 8);
rlm@3 1605 if (!getid3_id3v2::IsValidDateStampString($parsed_frame['purchasedate'])) {
rlm@3 1606 $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 1607 }
rlm@3 1608 $frame_offset += 8;
rlm@3 1609
rlm@3 1610 $parsed_frame['seller'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1611 unset($parsed_frame['data']);
rlm@3 1612 return true;
rlm@3 1613 }
rlm@3 1614
rlm@3 1615
rlm@3 1616 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMR')) { // 4.24 COMR Commercial frame (ID3v2.3+ only)
rlm@3 1617
rlm@3 1618 // There may be more than one 'commercial frame' in a tag,
rlm@3 1619 // but no two may be identical
rlm@3 1620 // <Header for 'Commercial frame', ID: 'COMR'>
rlm@3 1621 // Text encoding $xx
rlm@3 1622 // Price string <text string> $00
rlm@3 1623 // Valid until <text string>
rlm@3 1624 // Contact URL <text string> $00
rlm@3 1625 // Received as $xx
rlm@3 1626 // Name of seller <text string according to encoding> $00 (00)
rlm@3 1627 // Description <text string according to encoding> $00 (00)
rlm@3 1628 // Picture MIME type <string> $00
rlm@3 1629 // Seller logo <binary data>
rlm@3 1630
rlm@3 1631 $frame_offset = 0;
rlm@3 1632 $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1633 if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
rlm@3 1634 $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
rlm@3 1635 }
rlm@3 1636
rlm@3 1637 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1638 $frame_price_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1639 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1640 $frame_rawpricearray = explode('/', $frame_price_string);
rlm@3 1641 foreach ($frame_rawpricearray as $key => $val) {
rlm@3 1642 $frame_currencyid = substr($val, 0, 3);
rlm@3 1643 $parsed_frame['price'][$frame_currencyid]['currency'] = getid3_id3v2::LookupCurrencyUnits($frame_currencyid);
rlm@3 1644 $parsed_frame['price'][$frame_currencyid]['value'] = substr($val, 3);
rlm@3 1645 }
rlm@3 1646
rlm@3 1647 $frame_date_string = substr($parsed_frame['data'], $frame_offset, 8);
rlm@3 1648 $frame_offset += 8;
rlm@3 1649
rlm@3 1650 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1651 $frame_contacturl = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1652 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1653
rlm@3 1654 $frame_received_as_id = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1655
rlm@3 1656 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 1657 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 1658 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 1659 }
rlm@3 1660
rlm@3 1661 $frame_sellername = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1662 if (ord($frame_sellername) === 0) {
rlm@3 1663 $frame_sellername = '';
rlm@3 1664 }
rlm@3 1665
rlm@3 1666 $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
rlm@3 1667
rlm@3 1668 $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
rlm@3 1669 if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
rlm@3 1670 $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
rlm@3 1671 }
rlm@3 1672
rlm@3 1673 $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1674 if (ord($frame_description) === 0) {
rlm@3 1675 $frame_description = '';
rlm@3 1676 }
rlm@3 1677
rlm@3 1678 $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
rlm@3 1679
rlm@3 1680 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1681 $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1682 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1683
rlm@3 1684 $frame_sellerlogo = substr($parsed_frame['data'], $frame_offset);
rlm@3 1685
rlm@3 1686 $parsed_frame['encodingid'] = $frame_text_encoding;
rlm@3 1687 $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding);
rlm@3 1688
rlm@3 1689 $parsed_frame['pricevaliduntil'] = $frame_date_string;
rlm@3 1690 $parsed_frame['contacturl'] = $frame_contacturl;
rlm@3 1691 $parsed_frame['receivedasid'] = $frame_received_as_id;
rlm@3 1692 $parsed_frame['receivedas'] = getid3_id3v2::COMRReceivedAsLookup($frame_received_as_id);
rlm@3 1693 $parsed_frame['sellername'] = $frame_sellername;
rlm@3 1694 $parsed_frame['description'] = $frame_description;
rlm@3 1695 $parsed_frame['mime'] = $frame_mimetype;
rlm@3 1696 $parsed_frame['logo'] = $frame_sellerlogo;
rlm@3 1697 unset($parsed_frame['data']);
rlm@3 1698 }
rlm@3 1699
rlm@3 1700
rlm@3 1701 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ENCR')) { // 4.25 ENCR Encryption method registration (ID3v2.3+ only)
rlm@3 1702
rlm@3 1703 // There may be several 'ENCR' frames in a tag,
rlm@3 1704 // but only one containing the same symbol
rlm@3 1705 // and only one containing the same owner identifier
rlm@3 1706 // <Header for 'Encryption method registration', ID: 'ENCR'>
rlm@3 1707 // Owner identifier <text string> $00
rlm@3 1708 // Method symbol $xx
rlm@3 1709 // Encryption data <binary data>
rlm@3 1710
rlm@3 1711 $frame_offset = 0;
rlm@3 1712 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1713 $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1714 if (ord($frame_owner_id) === 0) {
rlm@3 1715 $frame_owner_id = '';
rlm@3 1716 }
rlm@3 1717 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1718
rlm@3 1719 $parsed_frame['ownerid'] = $frame_owner_id;
rlm@3 1720 $parsed_frame['methodsymbol'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1721 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1722 return true;
rlm@3 1723 }
rlm@3 1724
rlm@3 1725
rlm@3 1726 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GRID')) { // 4.26 GRID Group identification registration (ID3v2.3+ only)
rlm@3 1727
rlm@3 1728 // There may be several 'GRID' frames in a tag,
rlm@3 1729 // but only one containing the same symbol
rlm@3 1730 // and only one containing the same owner identifier
rlm@3 1731 // <Header for 'Group ID registration', ID: 'GRID'>
rlm@3 1732 // Owner identifier <text string> $00
rlm@3 1733 // Group symbol $xx
rlm@3 1734 // Group dependent data <binary data>
rlm@3 1735
rlm@3 1736 $frame_offset = 0;
rlm@3 1737 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1738 $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1739 if (ord($frame_owner_id) === 0) {
rlm@3 1740 $frame_owner_id = '';
rlm@3 1741 }
rlm@3 1742 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1743
rlm@3 1744 $parsed_frame['ownerid'] = $frame_owner_id;
rlm@3 1745 $parsed_frame['groupsymbol'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1746 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1747 return true;
rlm@3 1748 }
rlm@3 1749
rlm@3 1750
rlm@3 1751 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PRIV')) { // 4.27 PRIV Private frame (ID3v2.3+ only)
rlm@3 1752
rlm@3 1753 // The tag may contain more than one 'PRIV' frame
rlm@3 1754 // but only with different contents
rlm@3 1755 // <Header for 'Private frame', ID: 'PRIV'>
rlm@3 1756 // Owner identifier <text string> $00
rlm@3 1757 // The private data <binary data>
rlm@3 1758
rlm@3 1759 $frame_offset = 0;
rlm@3 1760 $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
rlm@3 1761 $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
rlm@3 1762 if (ord($frame_owner_id) === 0) {
rlm@3 1763 $frame_owner_id = '';
rlm@3 1764 }
rlm@3 1765 $frame_offset = $frame_terminator_pos + strlen("\x00");
rlm@3 1766
rlm@3 1767 $parsed_frame['ownerid'] = $frame_owner_id;
rlm@3 1768 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1769 return true;
rlm@3 1770 }
rlm@3 1771
rlm@3 1772
rlm@3 1773 if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SIGN')) { // 4.28 SIGN Signature frame (ID3v2.4+ only)
rlm@3 1774
rlm@3 1775 // There may be more than one 'signature frame' in a tag,
rlm@3 1776 // but no two may be identical
rlm@3 1777 // <Header for 'Signature frame', ID: 'SIGN'>
rlm@3 1778 // Group symbol $xx
rlm@3 1779 // Signature <binary data>
rlm@3 1780
rlm@3 1781 $frame_offset = 0;
rlm@3 1782 $parsed_frame['groupsymbol'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1783 $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
rlm@3 1784 return true;
rlm@3 1785 }
rlm@3 1786
rlm@3 1787
rlm@3 1788 if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SEEK')) { // 4.29 SEEK Seek frame (ID3v2.4+ only)
rlm@3 1789
rlm@3 1790 // There may only be one 'seek frame' in a tag
rlm@3 1791 // <Header for 'Seek frame', ID: 'SEEK'>
rlm@3 1792 // Minimum offset to next tag $xx xx xx xx
rlm@3 1793
rlm@3 1794 $frame_offset = 0;
rlm@3 1795 $parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
rlm@3 1796 return true;
rlm@3 1797 }
rlm@3 1798
rlm@3 1799
rlm@3 1800 if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'ASPI')) { // 4.30 ASPI Audio seek point index (ID3v2.4+ only)
rlm@3 1801
rlm@3 1802 // There may only be one 'audio seek point index' frame in a tag
rlm@3 1803 // <Header for 'Seek Point Index', ID: 'ASPI'>
rlm@3 1804 // Indexed data start (S) $xx xx xx xx
rlm@3 1805 // Indexed data length (L) $xx xx xx xx
rlm@3 1806 // Number of index points (N) $xx xx
rlm@3 1807 // Bits per index point (b) $xx
rlm@3 1808 // Then for every index point the following data is included:
rlm@3 1809 // Fraction at index (Fi) $xx (xx)
rlm@3 1810
rlm@3 1811 $frame_offset = 0;
rlm@3 1812 $parsed_frame['datastart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
rlm@3 1813 $frame_offset += 4;
rlm@3 1814 $parsed_frame['indexeddatalength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
rlm@3 1815 $frame_offset += 4;
rlm@3 1816 $parsed_frame['indexpoints'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
rlm@3 1817 $frame_offset += 2;
rlm@3 1818 $parsed_frame['bitsperpoint'] = ord($parsed_frame['data']{$frame_offset++});
rlm@3 1819 $frame_bytesperpoint = ceil($parsed_frame['bitsperpoint'] / 8);
rlm@3 1820 for ($i = 0; $i < $frame_indexpoints; $i++) {
rlm@3 1821 $parsed_frame['indexes'][$i] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesperpoint));
rlm@3 1822 $frame_offset += $frame_bytesperpoint;
rlm@3 1823 }
rlm@3 1824 unset($parsed_frame['data']);
rlm@3 1825 return true;
rlm@3 1826 }
rlm@3 1827
rlm@3 1828
rlm@3 1829 if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RGAD')) { // Replay Gain Adjustment
rlm@3 1830
rlm@3 1831 // http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html
rlm@3 1832 // There may only be one 'RGAD' frame in a tag
rlm@3 1833 // <Header for 'Replay Gain Adjustment', ID: 'RGAD'>
rlm@3 1834 // Peak Amplitude $xx $xx $xx $xx
rlm@3 1835 // Radio Replay Gain Adjustment %aaabbbcd %dddddddd
rlm@3 1836 // Audiophile Replay Gain Adjustment %aaabbbcd %dddddddd
rlm@3 1837 // a - name code
rlm@3 1838 // b - originator code
rlm@3 1839 // c - sign bit
rlm@3 1840 // d - replay gain adjustment
rlm@3 1841
rlm@3 1842 $frame_offset = 0;
rlm@3 1843
rlm@3 1844 $parsed_frame['peakamplitude'] = (float)getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
rlm@3 1845 $frame_offset += 4;
rlm@3 1846
rlm@3 1847 $rg_track_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2));
rlm@3 1848 $frame_offset += 2;
rlm@3 1849
rlm@3 1850 $rg_album_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2));
rlm@3 1851 $frame_offset += 2;
rlm@3 1852
rlm@3 1853 $parsed_frame['raw']['track']['name'] = bindec(substr($rg_track_adjustment, 0, 3));
rlm@3 1854 $parsed_frame['raw']['track']['originator'] = bindec(substr($rg_track_adjustment, 3, 3));
rlm@3 1855 $parsed_frame['raw']['track']['signbit'] = bindec($rg_track_adjustment[6]);
rlm@3 1856 $parsed_frame['raw']['track']['adjustment'] = bindec(substr($rg_track_adjustment, 7, 9));
rlm@3 1857 $parsed_frame['raw']['album']['name'] = bindec(substr($rg_album_adjustment, 0, 3));
rlm@3 1858 $parsed_frame['raw']['album']['originator'] = bindec(substr($rg_album_adjustment, 3, 3));
rlm@3 1859 $parsed_frame['raw']['album']['signbit'] = bindec($rg_album_adjustment[6]);
rlm@3 1860 $parsed_frame['raw']['album']['adjustment'] = bindec(substr($rg_album_adjustment, 7, 9));
rlm@3 1861 $parsed_frame['track']['name'] = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['track']['name']);
rlm@3 1862 $parsed_frame['track']['originator'] = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['track']['originator']);
rlm@3 1863 $parsed_frame['track']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['track']['adjustment'], $parsed_frame['raw']['track']['signbit']);
rlm@3 1864 $parsed_frame['album']['name'] = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['album']['name']);
rlm@3 1865 $parsed_frame['album']['originator'] = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['album']['originator']);
rlm@3 1866 $parsed_frame['album']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['album']['adjustment'], $parsed_frame['raw']['album']['signbit']);
rlm@3 1867
rlm@3 1868 $getid3->info['replay_gain']['track']['peak'] = $parsed_frame['peakamplitude'];
rlm@3 1869 $getid3->info['replay_gain']['track']['originator'] = $parsed_frame['track']['originator'];
rlm@3 1870 $getid3->info['replay_gain']['track']['adjustment'] = $parsed_frame['track']['adjustment'];
rlm@3 1871 $getid3->info['replay_gain']['album']['originator'] = $parsed_frame['album']['originator'];
rlm@3 1872 $getid3->info['replay_gain']['album']['adjustment'] = $parsed_frame['album']['adjustment'];
rlm@3 1873
rlm@3 1874 unset($parsed_frame['data']);
rlm@3 1875 return true;
rlm@3 1876 }
rlm@3 1877
rlm@3 1878 return true;
rlm@3 1879 }
rlm@3 1880
rlm@3 1881
rlm@3 1882
rlm@3 1883 private function TextEncodingNameLookup($encoding) {
rlm@3 1884
rlm@3 1885 // Override specification - BRAINDEAD taggers
rlm@3 1886 if (!$encoding) {
rlm@3 1887 return $this->getid3->encoding_id3v2;
rlm@3 1888 }
rlm@3 1889
rlm@3 1890 // http://www.id3.org/id3v2.4.0-structure.txt
rlm@3 1891 static $lookup = array (
rlm@3 1892 0 => 'ISO-8859-1',
rlm@3 1893 1 => 'UTF-16',
rlm@3 1894 2 => 'UTF-16BE',
rlm@3 1895 3 => 'UTF-8',
rlm@3 1896 255 => 'UTF-16BE'
rlm@3 1897 );
rlm@3 1898
rlm@3 1899 return (isset($lookup[$encoding]) ? $lookup[$encoding] : 'ISO-8859-1');
rlm@3 1900 }
rlm@3 1901
rlm@3 1902
rlm@3 1903
rlm@3 1904 public static function ParseID3v2GenreString($genre_string) {
rlm@3 1905
rlm@3 1906 // Parse genres into arrays of genreName and genreID
rlm@3 1907 // ID3v2.2.x, ID3v2.3.x: '(21)' or '(4)Eurodisco' or '(51)(39)' or '(55)((I think...)'
rlm@3 1908 // ID3v2.4.x: '21' $00 'Eurodisco' $00
rlm@3 1909
rlm@3 1910 $genre_string = trim($genre_string);
rlm@3 1911 $return_array = array ();
rlm@3 1912 if (strpos($genre_string, "\x00") !== false) {
rlm@3 1913 $unprocessed = trim($genre_string); // trailing nulls will cause an infinite loop.
rlm@3 1914 $genre_string = '';
rlm@3 1915 while (strpos($unprocessed, "\x00") !== false) {
rlm@3 1916 // convert null-seperated v2.4-format into v2.3 ()-seperated format
rlm@3 1917 $end_pos = strpos($unprocessed, "\x00");
rlm@3 1918 $genre_string .= '('.substr($unprocessed, 0, $end_pos).')';
rlm@3 1919 $unprocessed = substr($unprocessed, $end_pos + 1);
rlm@3 1920 }
rlm@3 1921 unset($unprocessed);
rlm@3 1922 }
rlm@3 1923 if (getid3_id3v1::LookupGenreID($genre_string)) {
rlm@3 1924
rlm@3 1925 $return_array['genre'][] = $genre_string;
rlm@3 1926
rlm@3 1927 } else {
rlm@3 1928
rlm@3 1929 while (strpos($genre_string, '(') !== false) {
rlm@3 1930
rlm@3 1931 $start_pos = strpos($genre_string, '(');
rlm@3 1932 $end_pos = strpos($genre_string, ')');
rlm@3 1933 if (substr($genre_string, $start_pos + 1, 1) == '(') {
rlm@3 1934 $genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $start_pos + 1);
rlm@3 1935 $end_pos--;
rlm@3 1936 }
rlm@3 1937 $element = substr($genre_string, $start_pos + 1, $end_pos - ($start_pos + 1));
rlm@3 1938 $genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $end_pos + 1);
rlm@3 1939
rlm@3 1940 if (getid3_id3v1::LookupGenreName($element)) { // $element is a valid genre id/abbreviation
rlm@3 1941
rlm@3 1942 if (empty($return_array['genre']) || !in_array(getid3_id3v1::LookupGenreName($element), $return_array['genre'])) { // avoid duplicate entires
rlm@3 1943 $return_array['genre'][] = getid3_id3v1::LookupGenreName($element);
rlm@3 1944 }
rlm@3 1945 } else {
rlm@3 1946
rlm@3 1947 if (empty($return_array['genre']) || !in_array($element, $return_array['genre'])) { // avoid duplicate entires
rlm@3 1948 $return_array['genre'][] = $element;
rlm@3 1949 }
rlm@3 1950 }
rlm@3 1951 }
rlm@3 1952 }
rlm@3 1953 if ($genre_string) {
rlm@3 1954 if (empty($return_array['genre']) || !in_array($genre_string, $return_array['genre'])) { // avoid duplicate entires
rlm@3 1955 $return_array['genre'][] = $genre_string;
rlm@3 1956 }
rlm@3 1957 }
rlm@3 1958
rlm@3 1959 return $return_array;
rlm@3 1960 }
rlm@3 1961
rlm@3 1962
rlm@3 1963
rlm@3 1964 public static function LookupCurrencyUnits($currency_id) {
rlm@3 1965
rlm@3 1966 static $lookup = array (
rlm@3 1967 'AED' => 'Dirhams',
rlm@3 1968 'AFA' => 'Afghanis',
rlm@3 1969 'ALL' => 'Leke',
rlm@3 1970 'AMD' => 'Drams',
rlm@3 1971 'ANG' => 'Guilders',
rlm@3 1972 'AOA' => 'Kwanza',
rlm@3 1973 'ARS' => 'Pesos',
rlm@3 1974 'ATS' => 'Schillings',
rlm@3 1975 'AUD' => 'Dollars',
rlm@3 1976 'AWG' => 'Guilders',
rlm@3 1977 'AZM' => 'Manats',
rlm@3 1978 'BAM' => 'Convertible Marka',
rlm@3 1979 'BBD' => 'Dollars',
rlm@3 1980 'BDT' => 'Taka',
rlm@3 1981 'BEF' => 'Francs',
rlm@3 1982 'BGL' => 'Leva',
rlm@3 1983 'BHD' => 'Dinars',
rlm@3 1984 'BIF' => 'Francs',
rlm@3 1985 'BMD' => 'Dollars',
rlm@3 1986 'BND' => 'Dollars',
rlm@3 1987 'BOB' => 'Bolivianos',
rlm@3 1988 'BRL' => 'Brazil Real',
rlm@3 1989 'BSD' => 'Dollars',
rlm@3 1990 'BTN' => 'Ngultrum',
rlm@3 1991 'BWP' => 'Pulas',
rlm@3 1992 'BYR' => 'Rubles',
rlm@3 1993 'BZD' => 'Dollars',
rlm@3 1994 'CAD' => 'Dollars',
rlm@3 1995 'CDF' => 'Congolese Francs',
rlm@3 1996 'CHF' => 'Francs',
rlm@3 1997 'CLP' => 'Pesos',
rlm@3 1998 'CNY' => 'Yuan Renminbi',
rlm@3 1999 'COP' => 'Pesos',
rlm@3 2000 'CRC' => 'Colones',
rlm@3 2001 'CUP' => 'Pesos',
rlm@3 2002 'CVE' => 'Escudos',
rlm@3 2003 'CYP' => 'Pounds',
rlm@3 2004 'CZK' => 'Koruny',
rlm@3 2005 'DEM' => 'Deutsche Marks',
rlm@3 2006 'DJF' => 'Francs',
rlm@3 2007 'DKK' => 'Kroner',
rlm@3 2008 'DOP' => 'Pesos',
rlm@3 2009 'DZD' => 'Algeria Dinars',
rlm@3 2010 'EEK' => 'Krooni',
rlm@3 2011 'EGP' => 'Pounds',
rlm@3 2012 'ERN' => 'Nakfa',
rlm@3 2013 'ESP' => 'Pesetas',
rlm@3 2014 'ETB' => 'Birr',
rlm@3 2015 'EUR' => 'Euro',
rlm@3 2016 'FIM' => 'Markkaa',
rlm@3 2017 'FJD' => 'Dollars',
rlm@3 2018 'FKP' => 'Pounds',
rlm@3 2019 'FRF' => 'Francs',
rlm@3 2020 'GBP' => 'Pounds',
rlm@3 2021 'GEL' => 'Lari',
rlm@3 2022 'GGP' => 'Pounds',
rlm@3 2023 'GHC' => 'Cedis',
rlm@3 2024 'GIP' => 'Pounds',
rlm@3 2025 'GMD' => 'Dalasi',
rlm@3 2026 'GNF' => 'Francs',
rlm@3 2027 'GRD' => 'Drachmae',
rlm@3 2028 'GTQ' => 'Quetzales',
rlm@3 2029 'GYD' => 'Dollars',
rlm@3 2030 'HKD' => 'Dollars',
rlm@3 2031 'HNL' => 'Lempiras',
rlm@3 2032 'HRK' => 'Kuna',
rlm@3 2033 'HTG' => 'Gourdes',
rlm@3 2034 'HUF' => 'Forints',
rlm@3 2035 'IDR' => 'Rupiahs',
rlm@3 2036 'IEP' => 'Pounds',
rlm@3 2037 'ILS' => 'New Shekels',
rlm@3 2038 'IMP' => 'Pounds',
rlm@3 2039 'INR' => 'Rupees',
rlm@3 2040 'IQD' => 'Dinars',
rlm@3 2041 'IRR' => 'Rials',
rlm@3 2042 'ISK' => 'Kronur',
rlm@3 2043 'ITL' => 'Lire',
rlm@3 2044 'JEP' => 'Pounds',
rlm@3 2045 'JMD' => 'Dollars',
rlm@3 2046 'JOD' => 'Dinars',
rlm@3 2047 'JPY' => 'Yen',
rlm@3 2048 'KES' => 'Shillings',
rlm@3 2049 'KGS' => 'Soms',
rlm@3 2050 'KHR' => 'Riels',
rlm@3 2051 'KMF' => 'Francs',
rlm@3 2052 'KPW' => 'Won',
rlm@3 2053 'KWD' => 'Dinars',
rlm@3 2054 'KYD' => 'Dollars',
rlm@3 2055 'KZT' => 'Tenge',
rlm@3 2056 'LAK' => 'Kips',
rlm@3 2057 'LBP' => 'Pounds',
rlm@3 2058 'LKR' => 'Rupees',
rlm@3 2059 'LRD' => 'Dollars',
rlm@3 2060 'LSL' => 'Maloti',
rlm@3 2061 'LTL' => 'Litai',
rlm@3 2062 'LUF' => 'Francs',
rlm@3 2063 'LVL' => 'Lati',
rlm@3 2064 'LYD' => 'Dinars',
rlm@3 2065 'MAD' => 'Dirhams',
rlm@3 2066 'MDL' => 'Lei',
rlm@3 2067 'MGF' => 'Malagasy Francs',
rlm@3 2068 'MKD' => 'Denars',
rlm@3 2069 'MMK' => 'Kyats',
rlm@3 2070 'MNT' => 'Tugriks',
rlm@3 2071 'MOP' => 'Patacas',
rlm@3 2072 'MRO' => 'Ouguiyas',
rlm@3 2073 'MTL' => 'Liri',
rlm@3 2074 'MUR' => 'Rupees',
rlm@3 2075 'MVR' => 'Rufiyaa',
rlm@3 2076 'MWK' => 'Kwachas',
rlm@3 2077 'MXN' => 'Pesos',
rlm@3 2078 'MYR' => 'Ringgits',
rlm@3 2079 'MZM' => 'Meticais',
rlm@3 2080 'NAD' => 'Dollars',
rlm@3 2081 'NGN' => 'Nairas',
rlm@3 2082 'NIO' => 'Gold Cordobas',
rlm@3 2083 'NLG' => 'Guilders',
rlm@3 2084 'NOK' => 'Krone',
rlm@3 2085 'NPR' => 'Nepal Rupees',
rlm@3 2086 'NZD' => 'Dollars',
rlm@3 2087 'OMR' => 'Rials',
rlm@3 2088 'PAB' => 'Balboa',
rlm@3 2089 'PEN' => 'Nuevos Soles',
rlm@3 2090 'PGK' => 'Kina',
rlm@3 2091 'PHP' => 'Pesos',
rlm@3 2092 'PKR' => 'Rupees',
rlm@3 2093 'PLN' => 'Zlotych',
rlm@3 2094 'PTE' => 'Escudos',
rlm@3 2095 'PYG' => 'Guarani',
rlm@3 2096 'QAR' => 'Rials',
rlm@3 2097 'ROL' => 'Lei',
rlm@3 2098 'RUR' => 'Rubles',
rlm@3 2099 'RWF' => 'Rwanda Francs',
rlm@3 2100 'SAR' => 'Riyals',
rlm@3 2101 'SBD' => 'Dollars',
rlm@3 2102 'SCR' => 'Rupees',
rlm@3 2103 'SDD' => 'Dinars',
rlm@3 2104 'SEK' => 'Kronor',
rlm@3 2105 'SGD' => 'Dollars',
rlm@3 2106 'SHP' => 'Pounds',
rlm@3 2107 'SIT' => 'Tolars',
rlm@3 2108 'SKK' => 'Koruny',
rlm@3 2109 'SLL' => 'Leones',
rlm@3 2110 'SOS' => 'Shillings',
rlm@3 2111 'SPL' => 'Luigini',
rlm@3 2112 'SRG' => 'Guilders',
rlm@3 2113 'STD' => 'Dobras',
rlm@3 2114 'SVC' => 'Colones',
rlm@3 2115 'SYP' => 'Pounds',
rlm@3 2116 'SZL' => 'Emalangeni',
rlm@3 2117 'THB' => 'Baht',
rlm@3 2118 'TJR' => 'Rubles',
rlm@3 2119 'TMM' => 'Manats',
rlm@3 2120 'TND' => 'Dinars',
rlm@3 2121 'TOP' => 'Pa\'anga',
rlm@3 2122 'TRL' => 'Liras',
rlm@3 2123 'TTD' => 'Dollars',
rlm@3 2124 'TVD' => 'Tuvalu Dollars',
rlm@3 2125 'TWD' => 'New Dollars',
rlm@3 2126 'TZS' => 'Shillings',
rlm@3 2127 'UAH' => 'Hryvnia',
rlm@3 2128 'UGX' => 'Shillings',
rlm@3 2129 'USD' => 'Dollars',
rlm@3 2130 'UYU' => 'Pesos',
rlm@3 2131 'UZS' => 'Sums',
rlm@3 2132 'VAL' => 'Lire',
rlm@3 2133 'VEB' => 'Bolivares',
rlm@3 2134 'VND' => 'Dong',
rlm@3 2135 'VUV' => 'Vatu',
rlm@3 2136 'WST' => 'Tala',
rlm@3 2137 'XAF' => 'Francs',
rlm@3 2138 'XAG' => 'Ounces',
rlm@3 2139 'XAU' => 'Ounces',
rlm@3 2140 'XCD' => 'Dollars',
rlm@3 2141 'XDR' => 'Special Drawing Rights',
rlm@3 2142 'XPD' => 'Ounces',
rlm@3 2143 'XPF' => 'Francs',
rlm@3 2144 'XPT' => 'Ounces',
rlm@3 2145 'YER' => 'Rials',
rlm@3 2146 'YUM' => 'New Dinars',
rlm@3 2147 'ZAR' => 'Rand',
rlm@3 2148 'ZMK' => 'Kwacha',
rlm@3 2149 'ZWD' => 'Zimbabwe Dollars'
rlm@3 2150 );
rlm@3 2151
rlm@3 2152 return @$lookup[$currency_id];
rlm@3 2153 }
rlm@3 2154
rlm@3 2155
rlm@3 2156
rlm@3 2157 public static function LookupCurrencyCountry($currency_id) {
rlm@3 2158
rlm@3 2159 static $lookup = array (
rlm@3 2160 'AED' => 'United Arab Emirates',
rlm@3 2161 'AFA' => 'Afghanistan',
rlm@3 2162 'ALL' => 'Albania',
rlm@3 2163 'AMD' => 'Armenia',
rlm@3 2164 'ANG' => 'Netherlands Antilles',
rlm@3 2165 'AOA' => 'Angola',
rlm@3 2166 'ARS' => 'Argentina',
rlm@3 2167 'ATS' => 'Austria',
rlm@3 2168 'AUD' => 'Australia',
rlm@3 2169 'AWG' => 'Aruba',
rlm@3 2170 'AZM' => 'Azerbaijan',
rlm@3 2171 'BAM' => 'Bosnia and Herzegovina',
rlm@3 2172 'BBD' => 'Barbados',
rlm@3 2173 'BDT' => 'Bangladesh',
rlm@3 2174 'BEF' => 'Belgium',
rlm@3 2175 'BGL' => 'Bulgaria',
rlm@3 2176 'BHD' => 'Bahrain',
rlm@3 2177 'BIF' => 'Burundi',
rlm@3 2178 'BMD' => 'Bermuda',
rlm@3 2179 'BND' => 'Brunei Darussalam',
rlm@3 2180 'BOB' => 'Bolivia',
rlm@3 2181 'BRL' => 'Brazil',
rlm@3 2182 'BSD' => 'Bahamas',
rlm@3 2183 'BTN' => 'Bhutan',
rlm@3 2184 'BWP' => 'Botswana',
rlm@3 2185 'BYR' => 'Belarus',
rlm@3 2186 'BZD' => 'Belize',
rlm@3 2187 'CAD' => 'Canada',
rlm@3 2188 'CDF' => 'Congo/Kinshasa',
rlm@3 2189 'CHF' => 'Switzerland',
rlm@3 2190 'CLP' => 'Chile',
rlm@3 2191 'CNY' => 'China',
rlm@3 2192 'COP' => 'Colombia',
rlm@3 2193 'CRC' => 'Costa Rica',
rlm@3 2194 'CUP' => 'Cuba',
rlm@3 2195 'CVE' => 'Cape Verde',
rlm@3 2196 'CYP' => 'Cyprus',
rlm@3 2197 'CZK' => 'Czech Republic',
rlm@3 2198 'DEM' => 'Germany',
rlm@3 2199 'DJF' => 'Djibouti',
rlm@3 2200 'DKK' => 'Denmark',
rlm@3 2201 'DOP' => 'Dominican Republic',
rlm@3 2202 'DZD' => 'Algeria',
rlm@3 2203 'EEK' => 'Estonia',
rlm@3 2204 'EGP' => 'Egypt',
rlm@3 2205 'ERN' => 'Eritrea',
rlm@3 2206 'ESP' => 'Spain',
rlm@3 2207 'ETB' => 'Ethiopia',
rlm@3 2208 'EUR' => 'Euro Member Countries',
rlm@3 2209 'FIM' => 'Finland',
rlm@3 2210 'FJD' => 'Fiji',
rlm@3 2211 'FKP' => 'Falkland Islands (Malvinas)',
rlm@3 2212 'FRF' => 'France',
rlm@3 2213 'GBP' => 'United Kingdom',
rlm@3 2214 'GEL' => 'Georgia',
rlm@3 2215 'GGP' => 'Guernsey',
rlm@3 2216 'GHC' => 'Ghana',
rlm@3 2217 'GIP' => 'Gibraltar',
rlm@3 2218 'GMD' => 'Gambia',
rlm@3 2219 'GNF' => 'Guinea',
rlm@3 2220 'GRD' => 'Greece',
rlm@3 2221 'GTQ' => 'Guatemala',
rlm@3 2222 'GYD' => 'Guyana',
rlm@3 2223 'HKD' => 'Hong Kong',
rlm@3 2224 'HNL' => 'Honduras',
rlm@3 2225 'HRK' => 'Croatia',
rlm@3 2226 'HTG' => 'Haiti',
rlm@3 2227 'HUF' => 'Hungary',
rlm@3 2228 'IDR' => 'Indonesia',
rlm@3 2229 'IEP' => 'Ireland (Eire)',
rlm@3 2230 'ILS' => 'Israel',
rlm@3 2231 'IMP' => 'Isle of Man',
rlm@3 2232 'INR' => 'India',
rlm@3 2233 'IQD' => 'Iraq',
rlm@3 2234 'IRR' => 'Iran',
rlm@3 2235 'ISK' => 'Iceland',
rlm@3 2236 'ITL' => 'Italy',
rlm@3 2237 'JEP' => 'Jersey',
rlm@3 2238 'JMD' => 'Jamaica',
rlm@3 2239 'JOD' => 'Jordan',
rlm@3 2240 'JPY' => 'Japan',
rlm@3 2241 'KES' => 'Kenya',
rlm@3 2242 'KGS' => 'Kyrgyzstan',
rlm@3 2243 'KHR' => 'Cambodia',
rlm@3 2244 'KMF' => 'Comoros',
rlm@3 2245 'KPW' => 'Korea',
rlm@3 2246 'KWD' => 'Kuwait',
rlm@3 2247 'KYD' => 'Cayman Islands',
rlm@3 2248 'KZT' => 'Kazakstan',
rlm@3 2249 'LAK' => 'Laos',
rlm@3 2250 'LBP' => 'Lebanon',
rlm@3 2251 'LKR' => 'Sri Lanka',
rlm@3 2252 'LRD' => 'Liberia',
rlm@3 2253 'LSL' => 'Lesotho',
rlm@3 2254 'LTL' => 'Lithuania',
rlm@3 2255 'LUF' => 'Luxembourg',
rlm@3 2256 'LVL' => 'Latvia',
rlm@3 2257 'LYD' => 'Libya',
rlm@3 2258 'MAD' => 'Morocco',
rlm@3 2259 'MDL' => 'Moldova',
rlm@3 2260 'MGF' => 'Madagascar',
rlm@3 2261 'MKD' => 'Macedonia',
rlm@3 2262 'MMK' => 'Myanmar (Burma)',
rlm@3 2263 'MNT' => 'Mongolia',
rlm@3 2264 'MOP' => 'Macau',
rlm@3 2265 'MRO' => 'Mauritania',
rlm@3 2266 'MTL' => 'Malta',
rlm@3 2267 'MUR' => 'Mauritius',
rlm@3 2268 'MVR' => 'Maldives (Maldive Islands)',
rlm@3 2269 'MWK' => 'Malawi',
rlm@3 2270 'MXN' => 'Mexico',
rlm@3 2271 'MYR' => 'Malaysia',
rlm@3 2272 'MZM' => 'Mozambique',
rlm@3 2273 'NAD' => 'Namibia',
rlm@3 2274 'NGN' => 'Nigeria',
rlm@3 2275 'NIO' => 'Nicaragua',
rlm@3 2276 'NLG' => 'Netherlands (Holland)',
rlm@3 2277 'NOK' => 'Norway',
rlm@3 2278 'NPR' => 'Nepal',
rlm@3 2279 'NZD' => 'New Zealand',
rlm@3 2280 'OMR' => 'Oman',
rlm@3 2281 'PAB' => 'Panama',
rlm@3 2282 'PEN' => 'Peru',
rlm@3 2283 'PGK' => 'Papua New Guinea',
rlm@3 2284 'PHP' => 'Philippines',
rlm@3 2285 'PKR' => 'Pakistan',
rlm@3 2286 'PLN' => 'Poland',
rlm@3 2287 'PTE' => 'Portugal',
rlm@3 2288 'PYG' => 'Paraguay',
rlm@3 2289 'QAR' => 'Qatar',
rlm@3 2290 'ROL' => 'Romania',
rlm@3 2291 'RUR' => 'Russia',
rlm@3 2292 'RWF' => 'Rwanda',
rlm@3 2293 'SAR' => 'Saudi Arabia',
rlm@3 2294 'SBD' => 'Solomon Islands',
rlm@3 2295 'SCR' => 'Seychelles',
rlm@3 2296 'SDD' => 'Sudan',
rlm@3 2297 'SEK' => 'Sweden',
rlm@3 2298 'SGD' => 'Singapore',
rlm@3 2299 'SHP' => 'Saint Helena',
rlm@3 2300 'SIT' => 'Slovenia',
rlm@3 2301 'SKK' => 'Slovakia',
rlm@3 2302 'SLL' => 'Sierra Leone',
rlm@3 2303 'SOS' => 'Somalia',
rlm@3 2304 'SPL' => 'Seborga',
rlm@3 2305 'SRG' => 'Suriname',
rlm@3 2306 'STD' => 'São Tome and Principe',
rlm@3 2307 'SVC' => 'El Salvador',
rlm@3 2308 'SYP' => 'Syria',
rlm@3 2309 'SZL' => 'Swaziland',
rlm@3 2310 'THB' => 'Thailand',
rlm@3 2311 'TJR' => 'Tajikistan',
rlm@3 2312 'TMM' => 'Turkmenistan',
rlm@3 2313 'TND' => 'Tunisia',
rlm@3 2314 'TOP' => 'Tonga',
rlm@3 2315 'TRL' => 'Turkey',
rlm@3 2316 'TTD' => 'Trinidad and Tobago',
rlm@3 2317 'TVD' => 'Tuvalu',
rlm@3 2318 'TWD' => 'Taiwan',
rlm@3 2319 'TZS' => 'Tanzania',
rlm@3 2320 'UAH' => 'Ukraine',
rlm@3 2321 'UGX' => 'Uganda',
rlm@3 2322 'USD' => 'United States of America',
rlm@3 2323 'UYU' => 'Uruguay',
rlm@3 2324 'UZS' => 'Uzbekistan',
rlm@3 2325 'VAL' => 'Vatican City',
rlm@3 2326 'VEB' => 'Venezuela',
rlm@3 2327 'VND' => 'Viet Nam',
rlm@3 2328 'VUV' => 'Vanuatu',
rlm@3 2329 'WST' => 'Samoa',
rlm@3 2330 'XAF' => 'Communauté Financière Africaine',
rlm@3 2331 'XAG' => 'Silver',
rlm@3 2332 'XAU' => 'Gold',
rlm@3 2333 'XCD' => 'East Caribbean',
rlm@3 2334 'XDR' => 'International Monetary Fund',
rlm@3 2335 'XPD' => 'Palladium',
rlm@3 2336 'XPF' => 'Comptoirs Français du Pacifique',
rlm@3 2337 'XPT' => 'Platinum',
rlm@3 2338 'YER' => 'Yemen',
rlm@3 2339 'YUM' => 'Yugoslavia',
rlm@3 2340 'ZAR' => 'South Africa',
rlm@3 2341 'ZMK' => 'Zambia',
rlm@3 2342 'ZWD' => 'Zimbabwe'
rlm@3 2343 );
rlm@3 2344
rlm@3 2345 return @$lookup[$currency_id];
rlm@3 2346 }
rlm@3 2347
rlm@3 2348
rlm@3 2349
rlm@3 2350 public static function LanguageLookup($language_code, $case_sensitive=false) {
rlm@3 2351
rlm@3 2352 if (!$case_sensitive) {
rlm@3 2353 $language_code = strtolower($language_code);
rlm@3 2354 }
rlm@3 2355
rlm@3 2356 // http://www.id3.org/id3v2.4.0-structure.txt
rlm@3 2357 // [4. ID3v2 frame overview]
rlm@3 2358 // The three byte language field, present in several frames, is used to
rlm@3 2359 // describe the language of the frame's content, according to ISO-639-2
rlm@3 2360 // [ISO-639-2]. The language should be represented in lower case. If the
rlm@3 2361 // language is not known the string "XXX" should be used.
rlm@3 2362
rlm@3 2363
rlm@3 2364 // ISO 639-2 - http://www.id3.org/iso639-2.html
rlm@3 2365
rlm@3 2366 static $lookup = array (
rlm@3 2367 'XXX' => 'unknown',
rlm@3 2368 'xxx' => 'unknown',
rlm@3 2369 'aar' => 'Afar',
rlm@3 2370 'abk' => 'Abkhazian',
rlm@3 2371 'ace' => 'Achinese',
rlm@3 2372 'ach' => 'Acoli',
rlm@3 2373 'ada' => 'Adangme',
rlm@3 2374 'afa' => 'Afro-Asiatic (Other)',
rlm@3 2375 'afh' => 'Afrihili',
rlm@3 2376 'afr' => 'Afrikaans',
rlm@3 2377 'aka' => 'Akan',
rlm@3 2378 'akk' => 'Akkadian',
rlm@3 2379 'alb' => 'Albanian',
rlm@3 2380 'ale' => 'Aleut',
rlm@3 2381 'alg' => 'Algonquian Languages',
rlm@3 2382 'amh' => 'Amharic',
rlm@3 2383 'ang' => 'English, Old (ca. 450-1100)',
rlm@3 2384 'apa' => 'Apache Languages',
rlm@3 2385 'ara' => 'Arabic',
rlm@3 2386 'arc' => 'Aramaic',
rlm@3 2387 'arm' => 'Armenian',
rlm@3 2388 'arn' => 'Araucanian',
rlm@3 2389 'arp' => 'Arapaho',
rlm@3 2390 'art' => 'Artificial (Other)',
rlm@3 2391 'arw' => 'Arawak',
rlm@3 2392 'asm' => 'Assamese',
rlm@3 2393 'ath' => 'Athapascan Languages',
rlm@3 2394 'ava' => 'Avaric',
rlm@3 2395 'ave' => 'Avestan',
rlm@3 2396 'awa' => 'Awadhi',
rlm@3 2397 'aym' => 'Aymara',
rlm@3 2398 'aze' => 'Azerbaijani',
rlm@3 2399 'bad' => 'Banda',
rlm@3 2400 'bai' => 'Bamileke Languages',
rlm@3 2401 'bak' => 'Bashkir',
rlm@3 2402 'bal' => 'Baluchi',
rlm@3 2403 'bam' => 'Bambara',
rlm@3 2404 'ban' => 'Balinese',
rlm@3 2405 'baq' => 'Basque',
rlm@3 2406 'bas' => 'Basa',
rlm@3 2407 'bat' => 'Baltic (Other)',
rlm@3 2408 'bej' => 'Beja',
rlm@3 2409 'bel' => 'Byelorussian',
rlm@3 2410 'bem' => 'Bemba',
rlm@3 2411 'ben' => 'Bengali',
rlm@3 2412 'ber' => 'Berber (Other)',
rlm@3 2413 'bho' => 'Bhojpuri',
rlm@3 2414 'bih' => 'Bihari',
rlm@3 2415 'bik' => 'Bikol',
rlm@3 2416 'bin' => 'Bini',
rlm@3 2417 'bis' => 'Bislama',
rlm@3 2418 'bla' => 'Siksika',
rlm@3 2419 'bnt' => 'Bantu (Other)',
rlm@3 2420 'bod' => 'Tibetan',
rlm@3 2421 'bra' => 'Braj',
rlm@3 2422 'bre' => 'Breton',
rlm@3 2423 'bua' => 'Buriat',
rlm@3 2424 'bug' => 'Buginese',
rlm@3 2425 'bul' => 'Bulgarian',
rlm@3 2426 'bur' => 'Burmese',
rlm@3 2427 'cad' => 'Caddo',
rlm@3 2428 'cai' => 'Central American Indian (Other)',
rlm@3 2429 'car' => 'Carib',
rlm@3 2430 'cat' => 'Catalan',
rlm@3 2431 'cau' => 'Caucasian (Other)',
rlm@3 2432 'ceb' => 'Cebuano',
rlm@3 2433 'cel' => 'Celtic (Other)',
rlm@3 2434 'ces' => 'Czech',
rlm@3 2435 'cha' => 'Chamorro',
rlm@3 2436 'chb' => 'Chibcha',
rlm@3 2437 'che' => 'Chechen',
rlm@3 2438 'chg' => 'Chagatai',
rlm@3 2439 'chi' => 'Chinese',
rlm@3 2440 'chm' => 'Mari',
rlm@3 2441 'chn' => 'Chinook jargon',
rlm@3 2442 'cho' => 'Choctaw',
rlm@3 2443 'chr' => 'Cherokee',
rlm@3 2444 'chu' => 'Church Slavic',
rlm@3 2445 'chv' => 'Chuvash',
rlm@3 2446 'chy' => 'Cheyenne',
rlm@3 2447 'cop' => 'Coptic',
rlm@3 2448 'cor' => 'Cornish',
rlm@3 2449 'cos' => 'Corsican',
rlm@3 2450 'cpe' => 'Creoles and Pidgins, English-based (Other)',
rlm@3 2451 'cpf' => 'Creoles and Pidgins, French-based (Other)',
rlm@3 2452 'cpp' => 'Creoles and Pidgins, Portuguese-based (Other)',
rlm@3 2453 'cre' => 'Cree',
rlm@3 2454 'crp' => 'Creoles and Pidgins (Other)',
rlm@3 2455 'cus' => 'Cushitic (Other)',
rlm@3 2456 'cym' => 'Welsh',
rlm@3 2457 'cze' => 'Czech',
rlm@3 2458 'dak' => 'Dakota',
rlm@3 2459 'dan' => 'Danish',
rlm@3 2460 'del' => 'Delaware',
rlm@3 2461 'deu' => 'German',
rlm@3 2462 'din' => 'Dinka',
rlm@3 2463 'div' => 'Divehi',
rlm@3 2464 'doi' => 'Dogri',
rlm@3 2465 'dra' => 'Dravidian (Other)',
rlm@3 2466 'dua' => 'Duala',
rlm@3 2467 'dum' => 'Dutch, Middle (ca. 1050-1350)',
rlm@3 2468 'dut' => 'Dutch',
rlm@3 2469 'dyu' => 'Dyula',
rlm@3 2470 'dzo' => 'Dzongkha',
rlm@3 2471 'efi' => 'Efik',
rlm@3 2472 'egy' => 'Egyptian (Ancient)',
rlm@3 2473 'eka' => 'Ekajuk',
rlm@3 2474 'ell' => 'Greek, Modern (1453-)',
rlm@3 2475 'elx' => 'Elamite',
rlm@3 2476 'eng' => 'English',
rlm@3 2477 'enm' => 'English, Middle (ca. 1100-1500)',
rlm@3 2478 'epo' => 'Esperanto',
rlm@3 2479 'esk' => 'Eskimo (Other)',
rlm@3 2480 'esl' => 'Spanish',
rlm@3 2481 'est' => 'Estonian',
rlm@3 2482 'eus' => 'Basque',
rlm@3 2483 'ewe' => 'Ewe',
rlm@3 2484 'ewo' => 'Ewondo',
rlm@3 2485 'fan' => 'Fang',
rlm@3 2486 'fao' => 'Faroese',
rlm@3 2487 'fas' => 'Persian',
rlm@3 2488 'fat' => 'Fanti',
rlm@3 2489 'fij' => 'Fijian',
rlm@3 2490 'fin' => 'Finnish',
rlm@3 2491 'fiu' => 'Finno-Ugrian (Other)',
rlm@3 2492 'fon' => 'Fon',
rlm@3 2493 'fra' => 'French',
rlm@3 2494 'fre' => 'French',
rlm@3 2495 'frm' => 'French, Middle (ca. 1400-1600)',
rlm@3 2496 'fro' => 'French, Old (842- ca. 1400)',
rlm@3 2497 'fry' => 'Frisian',
rlm@3 2498 'ful' => 'Fulah',
rlm@3 2499 'gaa' => 'Ga',
rlm@3 2500 'gae' => 'Gaelic (Scots)',
rlm@3 2501 'gai' => 'Irish',
rlm@3 2502 'gay' => 'Gayo',
rlm@3 2503 'gdh' => 'Gaelic (Scots)',
rlm@3 2504 'gem' => 'Germanic (Other)',
rlm@3 2505 'geo' => 'Georgian',
rlm@3 2506 'ger' => 'German',
rlm@3 2507 'gez' => 'Geez',
rlm@3 2508 'gil' => 'Gilbertese',
rlm@3 2509 'glg' => 'Gallegan',
rlm@3 2510 'gmh' => 'German, Middle High (ca. 1050-1500)',
rlm@3 2511 'goh' => 'German, Old High (ca. 750-1050)',
rlm@3 2512 'gon' => 'Gondi',
rlm@3 2513 'got' => 'Gothic',
rlm@3 2514 'grb' => 'Grebo',
rlm@3 2515 'grc' => 'Greek, Ancient (to 1453)',
rlm@3 2516 'gre' => 'Greek, Modern (1453-)',
rlm@3 2517 'grn' => 'Guarani',
rlm@3 2518 'guj' => 'Gujarati',
rlm@3 2519 'hai' => 'Haida',
rlm@3 2520 'hau' => 'Hausa',
rlm@3 2521 'haw' => 'Hawaiian',
rlm@3 2522 'heb' => 'Hebrew',
rlm@3 2523 'her' => 'Herero',
rlm@3 2524 'hil' => 'Hiligaynon',
rlm@3 2525 'him' => 'Himachali',
rlm@3 2526 'hin' => 'Hindi',
rlm@3 2527 'hmo' => 'Hiri Motu',
rlm@3 2528 'hun' => 'Hungarian',
rlm@3 2529 'hup' => 'Hupa',
rlm@3 2530 'hye' => 'Armenian',
rlm@3 2531 'iba' => 'Iban',
rlm@3 2532 'ibo' => 'Igbo',
rlm@3 2533 'ice' => 'Icelandic',
rlm@3 2534 'ijo' => 'Ijo',
rlm@3 2535 'iku' => 'Inuktitut',
rlm@3 2536 'ilo' => 'Iloko',
rlm@3 2537 'ina' => 'Interlingua (International Auxiliary language Association)',
rlm@3 2538 'inc' => 'Indic (Other)',
rlm@3 2539 'ind' => 'Indonesian',
rlm@3 2540 'ine' => 'Indo-European (Other)',
rlm@3 2541 'ine' => 'Interlingue',
rlm@3 2542 'ipk' => 'Inupiak',
rlm@3 2543 'ira' => 'Iranian (Other)',
rlm@3 2544 'iri' => 'Irish',
rlm@3 2545 'iro' => 'Iroquoian uages',
rlm@3 2546 'isl' => 'Icelandic',
rlm@3 2547 'ita' => 'Italian',
rlm@3 2548 'jav' => 'Javanese',
rlm@3 2549 'jaw' => 'Javanese',
rlm@3 2550 'jpn' => 'Japanese',
rlm@3 2551 'jpr' => 'Judeo-Persian',
rlm@3 2552 'jrb' => 'Judeo-Arabic',
rlm@3 2553 'kaa' => 'Kara-Kalpak',
rlm@3 2554 'kab' => 'Kabyle',
rlm@3 2555 'kac' => 'Kachin',
rlm@3 2556 'kal' => 'Greenlandic',
rlm@3 2557 'kam' => 'Kamba',
rlm@3 2558 'kan' => 'Kannada',
rlm@3 2559 'kar' => 'Karen',
rlm@3 2560 'kas' => 'Kashmiri',
rlm@3 2561 'kat' => 'Georgian',
rlm@3 2562 'kau' => 'Kanuri',
rlm@3 2563 'kaw' => 'Kawi',
rlm@3 2564 'kaz' => 'Kazakh',
rlm@3 2565 'kha' => 'Khasi',
rlm@3 2566 'khi' => 'Khoisan (Other)',
rlm@3 2567 'khm' => 'Khmer',
rlm@3 2568 'kho' => 'Khotanese',
rlm@3 2569 'kik' => 'Kikuyu',
rlm@3 2570 'kin' => 'Kinyarwanda',
rlm@3 2571 'kir' => 'Kirghiz',
rlm@3 2572 'kok' => 'Konkani',
rlm@3 2573 'kom' => 'Komi',
rlm@3 2574 'kon' => 'Kongo',
rlm@3 2575 'kor' => 'Korean',
rlm@3 2576 'kpe' => 'Kpelle',
rlm@3 2577 'kro' => 'Kru',
rlm@3 2578 'kru' => 'Kurukh',
rlm@3 2579 'kua' => 'Kuanyama',
rlm@3 2580 'kum' => 'Kumyk',
rlm@3 2581 'kur' => 'Kurdish',
rlm@3 2582 'kus' => 'Kusaie',
rlm@3 2583 'kut' => 'Kutenai',
rlm@3 2584 'lad' => 'Ladino',
rlm@3 2585 'lah' => 'Lahnda',
rlm@3 2586 'lam' => 'Lamba',
rlm@3 2587 'lao' => 'Lao',
rlm@3 2588 'lat' => 'Latin',
rlm@3 2589 'lav' => 'Latvian',
rlm@3 2590 'lez' => 'Lezghian',
rlm@3 2591 'lin' => 'Lingala',
rlm@3 2592 'lit' => 'Lithuanian',
rlm@3 2593 'lol' => 'Mongo',
rlm@3 2594 'loz' => 'Lozi',
rlm@3 2595 'ltz' => 'Letzeburgesch',
rlm@3 2596 'lub' => 'Luba-Katanga',
rlm@3 2597 'lug' => 'Ganda',
rlm@3 2598 'lui' => 'Luiseno',
rlm@3 2599 'lun' => 'Lunda',
rlm@3 2600 'luo' => 'Luo (Kenya and Tanzania)',
rlm@3 2601 'mac' => 'Macedonian',
rlm@3 2602 'mad' => 'Madurese',
rlm@3 2603 'mag' => 'Magahi',
rlm@3 2604 'mah' => 'Marshall',
rlm@3 2605 'mai' => 'Maithili',
rlm@3 2606 'mak' => 'Macedonian',
rlm@3 2607 'mak' => 'Makasar',
rlm@3 2608 'mal' => 'Malayalam',
rlm@3 2609 'man' => 'Mandingo',
rlm@3 2610 'mao' => 'Maori',
rlm@3 2611 'map' => 'Austronesian (Other)',
rlm@3 2612 'mar' => 'Marathi',
rlm@3 2613 'mas' => 'Masai',
rlm@3 2614 'max' => 'Manx',
rlm@3 2615 'may' => 'Malay',
rlm@3 2616 'men' => 'Mende',
rlm@3 2617 'mga' => 'Irish, Middle (900 - 1200)',
rlm@3 2618 'mic' => 'Micmac',
rlm@3 2619 'min' => 'Minangkabau',
rlm@3 2620 'mis' => 'Miscellaneous (Other)',
rlm@3 2621 'mkh' => 'Mon-Kmer (Other)',
rlm@3 2622 'mlg' => 'Malagasy',
rlm@3 2623 'mlt' => 'Maltese',
rlm@3 2624 'mni' => 'Manipuri',
rlm@3 2625 'mno' => 'Manobo Languages',
rlm@3 2626 'moh' => 'Mohawk',
rlm@3 2627 'mol' => 'Moldavian',
rlm@3 2628 'mon' => 'Mongolian',
rlm@3 2629 'mos' => 'Mossi',
rlm@3 2630 'mri' => 'Maori',
rlm@3 2631 'msa' => 'Malay',
rlm@3 2632 'mul' => 'Multiple Languages',
rlm@3 2633 'mun' => 'Munda Languages',
rlm@3 2634 'mus' => 'Creek',
rlm@3 2635 'mwr' => 'Marwari',
rlm@3 2636 'mya' => 'Burmese',
rlm@3 2637 'myn' => 'Mayan Languages',
rlm@3 2638 'nah' => 'Aztec',
rlm@3 2639 'nai' => 'North American Indian (Other)',
rlm@3 2640 'nau' => 'Nauru',
rlm@3 2641 'nav' => 'Navajo',
rlm@3 2642 'nbl' => 'Ndebele, South',
rlm@3 2643 'nde' => 'Ndebele, North',
rlm@3 2644 'ndo' => 'Ndongo',
rlm@3 2645 'nep' => 'Nepali',
rlm@3 2646 'new' => 'Newari',
rlm@3 2647 'nic' => 'Niger-Kordofanian (Other)',
rlm@3 2648 'niu' => 'Niuean',
rlm@3 2649 'nla' => 'Dutch',
rlm@3 2650 'nno' => 'Norwegian (Nynorsk)',
rlm@3 2651 'non' => 'Norse, Old',
rlm@3 2652 'nor' => 'Norwegian',
rlm@3 2653 'nso' => 'Sotho, Northern',
rlm@3 2654 'nub' => 'Nubian Languages',
rlm@3 2655 'nya' => 'Nyanja',
rlm@3 2656 'nym' => 'Nyamwezi',
rlm@3 2657 'nyn' => 'Nyankole',
rlm@3 2658 'nyo' => 'Nyoro',
rlm@3 2659 'nzi' => 'Nzima',
rlm@3 2660 'oci' => 'Langue d\'Oc (post 1500)',
rlm@3 2661 'oji' => 'Ojibwa',
rlm@3 2662 'ori' => 'Oriya',
rlm@3 2663 'orm' => 'Oromo',
rlm@3 2664 'osa' => 'Osage',
rlm@3 2665 'oss' => 'Ossetic',
rlm@3 2666 'ota' => 'Turkish, Ottoman (1500 - 1928)',
rlm@3 2667 'oto' => 'Otomian Languages',
rlm@3 2668 'paa' => 'Papuan-Australian (Other)',
rlm@3 2669 'pag' => 'Pangasinan',
rlm@3 2670 'pal' => 'Pahlavi',
rlm@3 2671 'pam' => 'Pampanga',
rlm@3 2672 'pan' => 'Panjabi',
rlm@3 2673 'pap' => 'Papiamento',
rlm@3 2674 'pau' => 'Palauan',
rlm@3 2675 'peo' => 'Persian, Old (ca 600 - 400 B.C.)',
rlm@3 2676 'per' => 'Persian',
rlm@3 2677 'phn' => 'Phoenician',
rlm@3 2678 'pli' => 'Pali',
rlm@3 2679 'pol' => 'Polish',
rlm@3 2680 'pon' => 'Ponape',
rlm@3 2681 'por' => 'Portuguese',
rlm@3 2682 'pra' => 'Prakrit uages',
rlm@3 2683 'pro' => 'Provencal, Old (to 1500)',
rlm@3 2684 'pus' => 'Pushto',
rlm@3 2685 'que' => 'Quechua',
rlm@3 2686 'raj' => 'Rajasthani',
rlm@3 2687 'rar' => 'Rarotongan',
rlm@3 2688 'roa' => 'Romance (Other)',
rlm@3 2689 'roh' => 'Rhaeto-Romance',
rlm@3 2690 'rom' => 'Romany',
rlm@3 2691 'ron' => 'Romanian',
rlm@3 2692 'rum' => 'Romanian',
rlm@3 2693 'run' => 'Rundi',
rlm@3 2694 'rus' => 'Russian',
rlm@3 2695 'sad' => 'Sandawe',
rlm@3 2696 'sag' => 'Sango',
rlm@3 2697 'sah' => 'Yakut',
rlm@3 2698 'sai' => 'South American Indian (Other)',
rlm@3 2699 'sal' => 'Salishan Languages',
rlm@3 2700 'sam' => 'Samaritan Aramaic',
rlm@3 2701 'san' => 'Sanskrit',
rlm@3 2702 'sco' => 'Scots',
rlm@3 2703 'scr' => 'Serbo-Croatian',
rlm@3 2704 'sel' => 'Selkup',
rlm@3 2705 'sem' => 'Semitic (Other)',
rlm@3 2706 'sga' => 'Irish, Old (to 900)',
rlm@3 2707 'shn' => 'Shan',
rlm@3 2708 'sid' => 'Sidamo',
rlm@3 2709 'sin' => 'Singhalese',
rlm@3 2710 'sio' => 'Siouan Languages',
rlm@3 2711 'sit' => 'Sino-Tibetan (Other)',
rlm@3 2712 'sla' => 'Slavic (Other)',
rlm@3 2713 'slk' => 'Slovak',
rlm@3 2714 'slo' => 'Slovak',
rlm@3 2715 'slv' => 'Slovenian',
rlm@3 2716 'smi' => 'Sami Languages',
rlm@3 2717 'smo' => 'Samoan',
rlm@3 2718 'sna' => 'Shona',
rlm@3 2719 'snd' => 'Sindhi',
rlm@3 2720 'sog' => 'Sogdian',
rlm@3 2721 'som' => 'Somali',
rlm@3 2722 'son' => 'Songhai',
rlm@3 2723 'sot' => 'Sotho, Southern',
rlm@3 2724 'spa' => 'Spanish',
rlm@3 2725 'sqi' => 'Albanian',
rlm@3 2726 'srd' => 'Sardinian',
rlm@3 2727 'srr' => 'Serer',
rlm@3 2728 'ssa' => 'Nilo-Saharan (Other)',
rlm@3 2729 'ssw' => 'Siswant',
rlm@3 2730 'ssw' => 'Swazi',
rlm@3 2731 'suk' => 'Sukuma',
rlm@3 2732 'sun' => 'Sudanese',
rlm@3 2733 'sus' => 'Susu',
rlm@3 2734 'sux' => 'Sumerian',
rlm@3 2735 'sve' => 'Swedish',
rlm@3 2736 'swa' => 'Swahili',
rlm@3 2737 'swe' => 'Swedish',
rlm@3 2738 'syr' => 'Syriac',
rlm@3 2739 'tah' => 'Tahitian',
rlm@3 2740 'tam' => 'Tamil',
rlm@3 2741 'tat' => 'Tatar',
rlm@3 2742 'tel' => 'Telugu',
rlm@3 2743 'tem' => 'Timne',
rlm@3 2744 'ter' => 'Tereno',
rlm@3 2745 'tgk' => 'Tajik',
rlm@3 2746 'tgl' => 'Tagalog',
rlm@3 2747 'tha' => 'Thai',
rlm@3 2748 'tib' => 'Tibetan',
rlm@3 2749 'tig' => 'Tigre',
rlm@3 2750 'tir' => 'Tigrinya',
rlm@3 2751 'tiv' => 'Tivi',
rlm@3 2752 'tli' => 'Tlingit',
rlm@3 2753 'tmh' => 'Tamashek',
rlm@3 2754 'tog' => 'Tonga (Nyasa)',
rlm@3 2755 'ton' => 'Tonga (Tonga Islands)',
rlm@3 2756 'tru' => 'Truk',
rlm@3 2757 'tsi' => 'Tsimshian',
rlm@3 2758 'tsn' => 'Tswana',
rlm@3 2759 'tso' => 'Tsonga',
rlm@3 2760 'tuk' => 'Turkmen',
rlm@3 2761 'tum' => 'Tumbuka',
rlm@3 2762 'tur' => 'Turkish',
rlm@3 2763 'tut' => 'Altaic (Other)',
rlm@3 2764 'twi' => 'Twi',
rlm@3 2765 'tyv' => 'Tuvinian',
rlm@3 2766 'uga' => 'Ugaritic',
rlm@3 2767 'uig' => 'Uighur',
rlm@3 2768 'ukr' => 'Ukrainian',
rlm@3 2769 'umb' => 'Umbundu',
rlm@3 2770 'und' => 'Undetermined',
rlm@3 2771 'urd' => 'Urdu',
rlm@3 2772 'uzb' => 'Uzbek',
rlm@3 2773 'vai' => 'Vai',
rlm@3 2774 'ven' => 'Venda',
rlm@3 2775 'vie' => 'Vietnamese',
rlm@3 2776 'vol' => 'Volapük',
rlm@3 2777 'vot' => 'Votic',
rlm@3 2778 'wak' => 'Wakashan Languages',
rlm@3 2779 'wal' => 'Walamo',
rlm@3 2780 'war' => 'Waray',
rlm@3 2781 'was' => 'Washo',
rlm@3 2782 'wel' => 'Welsh',
rlm@3 2783 'wen' => 'Sorbian Languages',
rlm@3 2784 'wol' => 'Wolof',
rlm@3 2785 'xho' => 'Xhosa',
rlm@3 2786 'yao' => 'Yao',
rlm@3 2787 'yap' => 'Yap',
rlm@3 2788 'yid' => 'Yiddish',
rlm@3 2789 'yor' => 'Yoruba',
rlm@3 2790 'zap' => 'Zapotec',
rlm@3 2791 'zen' => 'Zenaga',
rlm@3 2792 'zha' => 'Zhuang',
rlm@3 2793 'zho' => 'Chinese',
rlm@3 2794 'zul' => 'Zulu',
rlm@3 2795 'zun' => 'Zuni'
rlm@3 2796 );
rlm@3 2797
rlm@3 2798 return @$lookup[$language_code];
rlm@3 2799 }
rlm@3 2800
rlm@3 2801
rlm@3 2802
rlm@3 2803 public static function ETCOEventLookup($index) {
rlm@3 2804
rlm@3 2805 if (($index >= 0x17) && ($index <= 0xDF)) {
rlm@3 2806 return 'reserved for future use';
rlm@3 2807 }
rlm@3 2808 if (($index >= 0xE0) && ($index <= 0xEF)) {
rlm@3 2809 return 'not predefined synch 0-F';
rlm@3 2810 }
rlm@3 2811 if (($index >= 0xF0) && ($index <= 0xFC)) {
rlm@3 2812 return 'reserved for future use';
rlm@3 2813 }
rlm@3 2814
rlm@3 2815 static $lookup = array (
rlm@3 2816 0x00 => 'padding (has no meaning)',
rlm@3 2817 0x01 => 'end of initial silence',
rlm@3 2818 0x02 => 'intro start',
rlm@3 2819 0x03 => 'main part start',
rlm@3 2820 0x04 => 'outro start',
rlm@3 2821 0x05 => 'outro end',
rlm@3 2822 0x06 => 'verse start',
rlm@3 2823 0x07 => 'refrain start',
rlm@3 2824 0x08 => 'interlude start',
rlm@3 2825 0x09 => 'theme start',
rlm@3 2826 0x0A => 'variation start',
rlm@3 2827 0x0B => 'key change',
rlm@3 2828 0x0C => 'time change',
rlm@3 2829 0x0D => 'momentary unwanted noise (Snap, Crackle & Pop)',
rlm@3 2830 0x0E => 'sustained noise',
rlm@3 2831 0x0F => 'sustained noise end',
rlm@3 2832 0x10 => 'intro end',
rlm@3 2833 0x11 => 'main part end',
rlm@3 2834 0x12 => 'verse end',
rlm@3 2835 0x13 => 'refrain end',
rlm@3 2836 0x14 => 'theme end',
rlm@3 2837 0x15 => 'profanity',
rlm@3 2838 0x16 => 'profanity end',
rlm@3 2839 0xFD => 'audio end (start of silence)',
rlm@3 2840 0xFE => 'audio file ends',
rlm@3 2841 0xFF => 'one more byte of events follows'
rlm@3 2842 );
rlm@3 2843
rlm@3 2844 return @$lookup[$index];
rlm@3 2845 }
rlm@3 2846
rlm@3 2847
rlm@3 2848
rlm@3 2849 public static function SYTLContentTypeLookup($index) {
rlm@3 2850
rlm@3 2851 static $lookup = array (
rlm@3 2852 0x00 => 'other',
rlm@3 2853 0x01 => 'lyrics',
rlm@3 2854 0x02 => 'text transcription',
rlm@3 2855 0x03 => 'movement/part name', // (e.g. 'Adagio')
rlm@3 2856 0x04 => 'events', // (e.g. 'Don Quijote enters the stage')
rlm@3 2857 0x05 => 'chord', // (e.g. 'Bb F Fsus')
rlm@3 2858 0x06 => 'trivia/\'pop up\' information',
rlm@3 2859 0x07 => 'URLs to webpages',
rlm@3 2860 0x08 => 'URLs to images'
rlm@3 2861 );
rlm@3 2862
rlm@3 2863 return @$lookup[$index];
rlm@3 2864 }
rlm@3 2865
rlm@3 2866
rlm@3 2867
rlm@3 2868 public static function APICPictureTypeLookup($index, $return_array=false) {
rlm@3 2869
rlm@3 2870 static $lookup = array (
rlm@3 2871 0x00 => 'Other',
rlm@3 2872 0x01 => '32x32 pixels \'file icon\' (PNG only)',
rlm@3 2873 0x02 => 'Other file icon',
rlm@3 2874 0x03 => 'Cover (front)',
rlm@3 2875 0x04 => 'Cover (back)',
rlm@3 2876 0x05 => 'Leaflet page',
rlm@3 2877 0x06 => 'Media (e.g. label side of CD)',
rlm@3 2878 0x07 => 'Lead artist/lead performer/soloist',
rlm@3 2879 0x08 => 'Artist/performer',
rlm@3 2880 0x09 => 'Conductor',
rlm@3 2881 0x0A => 'Band/Orchestra',
rlm@3 2882 0x0B => 'Composer',
rlm@3 2883 0x0C => 'Lyricist/text writer',
rlm@3 2884 0x0D => 'Recording Location',
rlm@3 2885 0x0E => 'During recording',
rlm@3 2886 0x0F => 'During performance',
rlm@3 2887 0x10 => 'Movie/video screen capture',
rlm@3 2888 0x11 => 'A bright coloured fish',
rlm@3 2889 0x12 => 'Illustration',
rlm@3 2890 0x13 => 'Band/artist logotype',
rlm@3 2891 0x14 => 'Publisher/Studio logotype'
rlm@3 2892 );
rlm@3 2893
rlm@3 2894 if ($return_array) {
rlm@3 2895 return $lookup;
rlm@3 2896 }
rlm@3 2897 return @$lookup[$index];
rlm@3 2898 }
rlm@3 2899
rlm@3 2900
rlm@3 2901
rlm@3 2902 public static function COMRReceivedAsLookup($index) {
rlm@3 2903
rlm@3 2904 static $lookup = array (
rlm@3 2905 0x00 => 'Other',
rlm@3 2906 0x01 => 'Standard CD album with other songs',
rlm@3 2907 0x02 => 'Compressed audio on CD',
rlm@3 2908 0x03 => 'File over the Internet',
rlm@3 2909 0x04 => 'Stream over the Internet',
rlm@3 2910 0x05 => 'As note sheets',
rlm@3 2911 0x06 => 'As note sheets in a book with other sheets',
rlm@3 2912 0x07 => 'Music on other media',
rlm@3 2913 0x08 => 'Non-musical merchandise'
rlm@3 2914 );
rlm@3 2915
rlm@3 2916 return (isset($lookup[$index]) ? $lookup[$index] : '');
rlm@3 2917 }
rlm@3 2918
rlm@3 2919
rlm@3 2920
rlm@3 2921 public static function RVA2ChannelTypeLookup($index) {
rlm@3 2922
rlm@3 2923 static $lookup = array (
rlm@3 2924 0x00 => 'Other',
rlm@3 2925 0x01 => 'Master volume',
rlm@3 2926 0x02 => 'Front right',
rlm@3 2927 0x03 => 'Front left',
rlm@3 2928 0x04 => 'Back right',
rlm@3 2929 0x05 => 'Back left',
rlm@3 2930 0x06 => 'Front centre',
rlm@3 2931 0x07 => 'Back centre',
rlm@3 2932 0x08 => 'Subwoofer'
rlm@3 2933 );
rlm@3 2934
rlm@3 2935 return @$lookup[$index];
rlm@3 2936 }
rlm@3 2937
rlm@3 2938
rlm@3 2939
rlm@3 2940 public static function FrameNameLongLookup($frame_name) {
rlm@3 2941
rlm@3 2942 static $lookup = array (
rlm@3 2943 'AENC' => 'Audio encryption',
rlm@3 2944 'APIC' => 'Attached picture',
rlm@3 2945 'ASPI' => 'Audio seek point index',
rlm@3 2946 'BUF' => 'Recommended buffer size',
rlm@3 2947 'CNT' => 'Play counter',
rlm@3 2948 'COM' => 'Comments',
rlm@3 2949 'COMM' => 'Comments',
rlm@3 2950 'COMR' => 'Commercial frame',
rlm@3 2951 'CRA' => 'Audio encryption',
rlm@3 2952 'CRM' => 'Encrypted meta frame',
rlm@3 2953 'ENCR' => 'Encryption method registration',
rlm@3 2954 'EQU' => 'Equalisation',
rlm@3 2955 'EQU2' => 'Equalisation (2)',
rlm@3 2956 'EQUA' => 'Equalisation',
rlm@3 2957 'ETC' => 'Event timing codes',
rlm@3 2958 'ETCO' => 'Event timing codes',
rlm@3 2959 'GEO' => 'General encapsulated object',
rlm@3 2960 'GEOB' => 'General encapsulated object',
rlm@3 2961 'GRID' => 'Group identification registration',
rlm@3 2962 'IPL' => 'Involved people list',
rlm@3 2963 'IPLS' => 'Involved people list',
rlm@3 2964 'LINK' => 'Linked information',
rlm@3 2965 'LNK' => 'Linked information',
rlm@3 2966 'MCDI' => 'Music CD identifier',
rlm@3 2967 'MCI' => 'Music CD Identifier',
rlm@3 2968 'MLL' => 'MPEG location lookup table',
rlm@3 2969 'MLLT' => 'MPEG location lookup table',
rlm@3 2970 'OWNE' => 'Ownership frame',
rlm@3 2971 'PCNT' => 'Play counter',
rlm@3 2972 'PIC' => 'Attached picture',
rlm@3 2973 'POP' => 'Popularimeter',
rlm@3 2974 'POPM' => 'Popularimeter',
rlm@3 2975 'POSS' => 'Position synchronisation frame',
rlm@3 2976 'PRIV' => 'Private frame',
rlm@3 2977 'RBUF' => 'Recommended buffer size',
rlm@3 2978 'REV' => 'Reverb',
rlm@3 2979 'RVA' => 'Relative volume adjustment',
rlm@3 2980 'RVA2' => 'Relative volume adjustment (2)',
rlm@3 2981 'RVAD' => 'Relative volume adjustment',
rlm@3 2982 'RVRB' => 'Reverb',
rlm@3 2983 'SEEK' => 'Seek frame',
rlm@3 2984 'SIGN' => 'Signature frame',
rlm@3 2985 'SLT' => 'Synchronised lyric/text',
rlm@3 2986 'STC' => 'Synced tempo codes',
rlm@3 2987 'SYLT' => 'Synchronised lyric/text',
rlm@3 2988 'SYTC' => 'Synchronised tempo codes',
rlm@3 2989 'TAL' => 'Album/Movie/Show title',
rlm@3 2990 'TALB' => 'Album/Movie/Show title',
rlm@3 2991 'TBP' => 'BPM (Beats Per Minute)',
rlm@3 2992 'TBPM' => 'BPM (beats per minute)',
rlm@3 2993 'TCM' => 'Composer',
rlm@3 2994 'TCO' => 'Content type',
rlm@3 2995 'TCOM' => 'Composer',
rlm@3 2996 'TCON' => 'Content type',
rlm@3 2997 'TCOP' => 'Copyright message',
rlm@3 2998 'TCR' => 'Copyright message',
rlm@3 2999 'TDA' => 'Date',
rlm@3 3000 'TDAT' => 'Date',
rlm@3 3001 'TDEN' => 'Encoding time',
rlm@3 3002 'TDLY' => 'Playlist delay',
rlm@3 3003 'TDOR' => 'Original release time',
rlm@3 3004 'TDRC' => 'Recording time',
rlm@3 3005 'TDRL' => 'Release time',
rlm@3 3006 'TDTG' => 'Tagging time',
rlm@3 3007 'TDY' => 'Playlist delay',
rlm@3 3008 'TEN' => 'Encoded by',
rlm@3 3009 'TENC' => 'Encoded by',
rlm@3 3010 'TEXT' => 'Lyricist/Text writer',
rlm@3 3011 'TFLT' => 'File type',
rlm@3 3012 'TFT' => 'File type',
rlm@3 3013 'TIM' => 'Time',
rlm@3 3014 'TIME' => 'Time',
rlm@3 3015 'TIPL' => 'Involved people list',
rlm@3 3016 'TIT1' => 'Content group description',
rlm@3 3017 'TIT2' => 'Title/songname/content description',
rlm@3 3018 'TIT3' => 'Subtitle/Description refinement',
rlm@3 3019 'TKE' => 'Initial key',
rlm@3 3020 'TKEY' => 'Initial key',
rlm@3 3021 'TLA' => 'Language(s)',
rlm@3 3022 'TLAN' => 'Language(s)',
rlm@3 3023 'TLE' => 'Length',
rlm@3 3024 'TLEN' => 'Length',
rlm@3 3025 'TMCL' => 'Musician credits list',
rlm@3 3026 'TMED' => 'Media type',
rlm@3 3027 'TMOO' => 'Mood',
rlm@3 3028 'TMT' => 'Media type',
rlm@3 3029 'TOA' => 'Original artist(s)/performer(s)',
rlm@3 3030 'TOAL' => 'Original album/movie/show title',
rlm@3 3031 'TOF' => 'Original filename',
rlm@3 3032 'TOFN' => 'Original filename',
rlm@3 3033 'TOL' => 'Original Lyricist(s)/text writer(s)',
rlm@3 3034 'TOLY' => 'Original lyricist(s)/text writer(s)',
rlm@3 3035 'TOPE' => 'Original artist(s)/performer(s)',
rlm@3 3036 'TOR' => 'Original release year',
rlm@3 3037 'TORY' => 'Original release year',
rlm@3 3038 'TOT' => 'Original album/Movie/Show title',
rlm@3 3039 'TOWN' => 'File owner/licensee',
rlm@3 3040 'TP1' => 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group',
rlm@3 3041 'TP2' => 'Band/Orchestra/Accompaniment',
rlm@3 3042 'TP3' => 'Conductor/Performer refinement',
rlm@3 3043 'TP4' => 'Interpreted, remixed, or otherwise modified by',
rlm@3 3044 'TPA' => 'Part of a set',
rlm@3 3045 'TPB' => 'Publisher',
rlm@3 3046 'TPE1' => 'Lead performer(s)/Soloist(s)',
rlm@3 3047 'TPE2' => 'Band/orchestra/accompaniment',
rlm@3 3048 'TPE3' => 'Conductor/performer refinement',
rlm@3 3049 'TPE4' => 'Interpreted, remixed, or otherwise modified by',
rlm@3 3050 'TPOS' => 'Part of a set',
rlm@3 3051 'TPRO' => 'Produced notice',
rlm@3 3052 'TPUB' => 'Publisher',
rlm@3 3053 'TRC' => 'ISRC (International Standard Recording Code)',
rlm@3 3054 'TRCK' => 'Track number/Position in set',
rlm@3 3055 'TRD' => 'Recording dates',
rlm@3 3056 'TRDA' => 'Recording dates',
rlm@3 3057 'TRK' => 'Track number/Position in set',
rlm@3 3058 'TRSN' => 'Internet radio station name',
rlm@3 3059 'TRSO' => 'Internet radio station owner',
rlm@3 3060 'TSI' => 'Size',
rlm@3 3061 'TSIZ' => 'Size',
rlm@3 3062 'TSOA' => 'Album sort order',
rlm@3 3063 'TSOP' => 'Performer sort order',
rlm@3 3064 'TSOT' => 'Title sort order',
rlm@3 3065 'TSRC' => 'ISRC (international standard recording code)',
rlm@3 3066 'TSS' => 'Software/hardware and settings used for encoding',
rlm@3 3067 'TSSE' => 'Software/Hardware and settings used for encoding',
rlm@3 3068 'TSST' => 'Set subtitle',
rlm@3 3069 'TT1' => 'Content group description',
rlm@3 3070 'TT2' => 'Title/Songname/Content description',
rlm@3 3071 'TT3' => 'Subtitle/Description refinement',
rlm@3 3072 'TXT' => 'Lyricist/text writer',
rlm@3 3073 'TXX' => 'User defined text information frame',
rlm@3 3074 'TXXX' => 'User defined text information frame',
rlm@3 3075 'TYE' => 'Year',
rlm@3 3076 'TYER' => 'Year',
rlm@3 3077 'UFI' => 'Unique file identifier',
rlm@3 3078 'UFID' => 'Unique file identifier',
rlm@3 3079 'ULT' => 'Unsychronised lyric/text transcription',
rlm@3 3080 'USER' => 'Terms of use',
rlm@3 3081 'USLT' => 'Unsynchronised lyric/text transcription',
rlm@3 3082 'WAF' => 'Official audio file webpage',
rlm@3 3083 'WAR' => 'Official artist/performer webpage',
rlm@3 3084 'WAS' => 'Official audio source webpage',
rlm@3 3085 'WCM' => 'Commercial information',
rlm@3 3086 'WCOM' => 'Commercial information',
rlm@3 3087 'WCOP' => 'Copyright/Legal information',
rlm@3 3088 'WCP' => 'Copyright/Legal information',
rlm@3 3089 'WOAF' => 'Official audio file webpage',
rlm@3 3090 'WOAR' => 'Official artist/performer webpage',
rlm@3 3091 'WOAS' => 'Official audio source webpage',
rlm@3 3092 'WORS' => 'Official Internet radio station homepage',
rlm@3 3093 'WPAY' => 'Payment',
rlm@3 3094 'WPB' => 'Publishers official webpage',
rlm@3 3095 'WPUB' => 'Publishers official webpage',
rlm@3 3096 'WXX' => 'User defined URL link frame',
rlm@3 3097 'WXXX' => 'User defined URL link frame',
rlm@3 3098 'TFEA' => 'Featured Artist',
rlm@3 3099 'TSTU' => 'Recording Studio',
rlm@3 3100 'rgad' => 'Replay Gain Adjustment'
rlm@3 3101 );
rlm@3 3102
rlm@3 3103 return @$lookup[$frame_name];
rlm@3 3104
rlm@3 3105 // Last three:
rlm@3 3106 // from Helium2 [www.helium2.com]
rlm@3 3107 // from http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html
rlm@3 3108 }
rlm@3 3109
rlm@3 3110
rlm@3 3111 public static function FrameNameShortLookup($frame_name) {
rlm@3 3112
rlm@3 3113 static $lookup = array (
rlm@3 3114 'COM' => 'comment',
rlm@3 3115 'COMM' => 'comment',
rlm@3 3116 'TAL' => 'album',
rlm@3 3117 'TALB' => 'album',
rlm@3 3118 'TBP' => 'bpm',
rlm@3 3119 'TBPM' => 'bpm',
rlm@3 3120 'TCM' => 'composer',
rlm@3 3121 'TCO' => 'genre',
rlm@3 3122 'TCOM' => 'composer',
rlm@3 3123 'TCON' => 'genre',
rlm@3 3124 'TCOP' => 'copyright',
rlm@3 3125 'TCR' => 'copyright',
rlm@3 3126 'TEN' => 'encoded_by',
rlm@3 3127 'TENC' => 'encoded_by',
rlm@3 3128 'TEXT' => 'lyricist',
rlm@3 3129 'TIT1' => 'description',
rlm@3 3130 'TIT2' => 'title',
rlm@3 3131 'TIT3' => 'subtitle',
rlm@3 3132 'TLA' => 'language',
rlm@3 3133 'TLAN' => 'language',
rlm@3 3134 'TLE' => 'length',
rlm@3 3135 'TLEN' => 'length',
rlm@3 3136 'TMOO' => 'mood',
rlm@3 3137 'TOA' => 'original_artist',
rlm@3 3138 'TOAL' => 'original_album',
rlm@3 3139 'TOF' => 'original_filename',
rlm@3 3140 'TOFN' => 'original_filename',
rlm@3 3141 'TOL' => 'original_lyricist',
rlm@3 3142 'TOLY' => 'original_lyricist',
rlm@3 3143 'TOPE' => 'original_artist',
rlm@3 3144 'TOT' => 'original_album',
rlm@3 3145 'TP1' => 'artist',
rlm@3 3146 'TP2' => 'band',
rlm@3 3147 'TP3' => 'conductor',
rlm@3 3148 'TP4' => 'remixer',
rlm@3 3149 'TPB' => 'publisher',
rlm@3 3150 'TPE1' => 'artist',
rlm@3 3151 'TPE2' => 'band',
rlm@3 3152 'TPE3' => 'conductor',
rlm@3 3153 'TPE4' => 'remixer',
rlm@3 3154 'TPUB' => 'publisher',
rlm@3 3155 'TRC' => 'isrc',
rlm@3 3156 'TRCK' => 'track',
rlm@3 3157 'TRK' => 'track',
rlm@3 3158 'TSI' => 'size',
rlm@3 3159 'TSIZ' => 'size',
rlm@3 3160 'TSRC' => 'isrc',
rlm@3 3161 'TSS' => 'encoder_settings',
rlm@3 3162 'TSSE' => 'encoder_settings',
rlm@3 3163 'TSST' => 'subtitle',
rlm@3 3164 'TT1' => 'description',
rlm@3 3165 'TT2' => 'title',
rlm@3 3166 'TT3' => 'subtitle',
rlm@3 3167 'TXT' => 'lyricist',
rlm@3 3168 'TXX' => 'text',
rlm@3 3169 'TXXX' => 'text',
rlm@3 3170 'TYE' => 'year',
rlm@3 3171 'TYER' => 'year',
rlm@3 3172 'UFI' => 'unique_file_identifier',
rlm@3 3173 'UFID' => 'unique_file_identifier',
rlm@3 3174 'ULT' => 'unsychronised_lyric',
rlm@3 3175 'USER' => 'terms_of_use',
rlm@3 3176 'USLT' => 'unsynchronised lyric',
rlm@3 3177 'WAF' => 'url_file',
rlm@3 3178 'WAR' => 'url_artist',
rlm@3 3179 'WAS' => 'url_source',
rlm@3 3180 'WCOP' => 'copyright',
rlm@3 3181 'WCP' => 'copyright',
rlm@3 3182 'WOAF' => 'url_file',
rlm@3 3183 'WOAR' => 'url_artist',
rlm@3 3184 'WOAS' => 'url_source',
rlm@3 3185 'WORS' => 'url_station',
rlm@3 3186 'WPB' => 'url_publisher',
rlm@3 3187 'WPUB' => 'url_publisher',
rlm@3 3188 'WXX' => 'url_user',
rlm@3 3189 'WXXX' => 'url_user',
rlm@3 3190 'TFEA' => 'featured_artist',
rlm@3 3191 'TSTU' => 'studio'
rlm@3 3192 );
rlm@3 3193
rlm@3 3194 return @$lookup[$frame_name];
rlm@3 3195 }
rlm@3 3196
rlm@3 3197
rlm@3 3198
rlm@3 3199 public static function TextEncodingTerminatorLookup($encoding) {
rlm@3 3200
rlm@3 3201 // http://www.id3.org/id3v2.4.0-structure.txt
rlm@3 3202 // Frames that allow different types of text encoding contains a text encoding description byte. Possible encodings:
rlm@3 3203 // $00 ISO-8859-1. Terminated with $00.
rlm@3 3204 // $01 UTF-16 encoded Unicode with BOM. All strings in the same frame SHALL have the same byteorder. Terminated with $00 00.
rlm@3 3205 // $02 UTF-16BE encoded Unicode without BOM. Terminated with $00 00.
rlm@3 3206 // $03 UTF-8 encoded Unicode. Terminated with $00.
rlm@3 3207
rlm@3 3208 static $lookup = array (
rlm@3 3209 0 => "\x00",
rlm@3 3210 1 => "\x00\x00",
rlm@3 3211 2 => "\x00\x00",
rlm@3 3212 3 => "\x00",
rlm@3 3213 255 => "\x00\x00"
rlm@3 3214 );
rlm@3 3215
rlm@3 3216 return @$lookup[$encoding];
rlm@3 3217 }
rlm@3 3218
rlm@3 3219
rlm@3 3220
rlm@3 3221 public static function IsValidID3v2FrameName($frame_name, $id3v2_major_version) {
rlm@3 3222
rlm@3 3223 switch ($id3v2_major_version) {
rlm@3 3224 case 2:
rlm@3 3225 return preg_match('/[A-Z][A-Z0-9]{2}/', $frame_name);
rlm@3 3226
rlm@3 3227 case 3:
rlm@3 3228 case 4:
rlm@3 3229 return preg_match('/[A-Z][A-Z0-9]{3}/', $frame_name);
rlm@3 3230 }
rlm@3 3231 return false;
rlm@3 3232 }
rlm@3 3233
rlm@3 3234
rlm@3 3235
rlm@3 3236 public static function IsValidDateStampString($date_stamp) {
rlm@3 3237
rlm@3 3238 if (strlen($date_stamp) != 8) {
rlm@3 3239 return false;
rlm@3 3240 }
rlm@3 3241 if ((int)$date_stamp) {
rlm@3 3242 return false;
rlm@3 3243 }
rlm@3 3244
rlm@3 3245 $year = substr($date_stamp, 0, 4);
rlm@3 3246 $month = substr($date_stamp, 4, 2);
rlm@3 3247 $day = substr($date_stamp, 6, 2);
rlm@3 3248 if (!$year || !$month || !$day || $month > 12 || $day > 31 ) {
rlm@3 3249 return false;
rlm@3 3250 }
rlm@3 3251 if (($day > 30) && (($month == 4) || ($month == 6) || ($month == 9) || ($month == 11))) {
rlm@3 3252 return false;
rlm@3 3253 }
rlm@3 3254 if (($day > 29) && ($month == 2)) {
rlm@3 3255 return false;
rlm@3 3256 }
rlm@3 3257 return true;
rlm@3 3258 }
rlm@3 3259
rlm@3 3260
rlm@3 3261
rlm@3 3262 public static function array_merge_noclobber($array1, $array2) {
rlm@3 3263 if (!is_array($array1) || !is_array($array2)) {
rlm@3 3264 return false;
rlm@3 3265 }
rlm@3 3266 $newarray = $array1;
rlm@3 3267 foreach ($array2 as $key => $val) {
rlm@3 3268 if (is_array($val) && isset($newarray[$key]) && is_array($newarray[$key])) {
rlm@3 3269 $newarray[$key] = getid3_id3v2::array_merge_noclobber($newarray[$key], $val);
rlm@3 3270 } elseif (!isset($newarray[$key])) {
rlm@3 3271 $newarray[$key] = $val;
rlm@3 3272 }
rlm@3 3273 }
rlm@3 3274 return $newarray;
rlm@3 3275 }
rlm@3 3276
rlm@3 3277
rlm@3 3278 }
rlm@3 3279
rlm@3 3280 ?>