PageRenderTime 41ms CodeModel.GetById 21ms RepoModel.GetById 0ms app.codeStats 1ms

/common/libraries/plugin/osflvplayer/flash/write.id3v2.php

https://bitbucket.org/renaatdemuynck/chamilo
PHP | 2618 lines | 2139 code | 167 blank | 312 comment | 336 complexity | 8e5b315522ac2a979e6acaa5c1340dc5 MD5 | raw file
Possible License(s): BSD-3-Clause, LGPL-2.1, LGPL-3.0, GPL-3.0, MIT, GPL-2.0 
    

  1. <?php

    2. 

  2. /////////////////////////////////////////////////////////////////
    3. 

  3. /// getID3() by James Heinrich <info@getid3.org>               //
    4. 

  4. //  available at http://getid3.sourceforge.net                 //
    5. 

  5. //            or http://www.getid3.org                         //
    6. 

  6. /////////////////////////////////////////////////////////////////
    7. 

  7. // See readme.txt for more details                             //
    8. 

  8. /////////////////////////////////////////////////////////////////
    9. 

  9. ///                                                            //
    10. 

  10. // write.id3v2.php                                             //
    11. 

  11. // module for writing ID3v2 tags                               //
    12. 

  12. // dependencies: module.tag.id3v2.php                          //
    13. 

  13. //                                                            ///
    14. 

  14. /////////////////////////////////////////////////////////////////
    15. 

  15. 

    16. 

  16. 

    17. 

  17. getid3_lib :: IncludeDependency(GETID3_INCLUDEPATH . 'module.tag.id3v2.php', __FILE__, true);

    18. 

  18. 

    19. 

  19. class getid3_write_id3v2

    20. 

  20. {

    21. 

  21.     var $filename;

    22. 

  22.     var $tag_data;

    23. 

  23.     var $paddedlength = 4096; // minimum length of ID3v2 tag in bytes
    24. 

  24.     var $majorversion = 3; // ID3v2 major version (2, 3 (recommended), 4)
    25. 

  25.     var $minorversion = 0; // ID3v2 minor version - always 0
    26. 

  26.     var $merge_existing_data = false; // if true, merge new data with existing tags; if false, delete old tag data and only write new tags
    27. 

  27.     var $id3v2_default_encodingid = 0; // default text encoding (ISO-8859-1) if not explicitly passed
    28. 

  28.     var $id3v2_use_unsynchronisation = false; // the specs say it should be TRUE, but most other ID3v2-aware programs are broken if unsynchronization is used, so by default don't use it.
    29. 

  29.     var $warnings = array(); // any non-critical errors will be stored here
    30. 

  30.     var $errors = array(); // any critical errors will be stored here
    31. 

  31. 

    32. 

  32.     

    33. 

  33.     function getid3_write_id3v2()

    34. 

  34.     {

    35. 

  35.         return true;

    36. 

  36.     }

    37. 

  37. 

    38. 

  38.     function WriteID3v2()

    39. 

  39.     {

    40. 

  40.         // File MUST be writeable - CHMOD(646) at least. It's best if the
    41. 

  41.         // directory is also writeable, because that method is both faster and less susceptible to errors.
    42. 

  42.         

    43. 

  43. 

    44. 

  44.         if (is_writeable($this->filename) || (! file_exists($this->filename) && is_writeable(dirname($this->filename))))

    45. 

  45.         {

    46. 

  46.             // Initialize getID3 engine
    47. 

  47.             $getID3 = new getID3();

    48. 

  48.             $OldThisFileInfo = $getID3->analyze($this->filename);

    49. 

  49.             if ($this->merge_existing_data)

    50. 

  50.             {

    51. 

  51.                 // merge with existing data
    52. 

  52.                 if (! empty($OldThisFileInfo['id3v2']))

    53. 

  53.                 {

    54. 

  54.                     $this->tag_data = $this->array_join_merge($OldThisFileInfo['id3v2'], $this->tag_data);

    55. 

  55.                 }

    56. 

  56.             }

    57. 

  57.             $this->paddedlength = max(@$OldThisFileInfo['id3v2']['headerlength'], $this->paddedlength);

    58. 

  58.             

    59. 

  59.             if ($NewID3v2Tag = $this->GenerateID3v2Tag())

    60. 

  60.             {

    61. 

  61.                 

    62. 

  62.                 if (file_exists($this->filename) && is_writeable($this->filename) && isset($OldThisFileInfo['id3v2']['headerlength']) && ($OldThisFileInfo['id3v2']['headerlength'] == strlen($NewID3v2Tag)))

    63. 

  63.                 {

    64. 

  64.                     

    65. 

  65.                     // best and fastest method - insert-overwrite existing tag (padded to length of old tag if neccesary)
    66. 

  66.                     if (file_exists($this->filename))

    67. 

  67.                     {

    68. 

  68.                         

    69. 

  69.                         ob_start();

    70. 

  70.                         if ($fp = fopen($this->filename, 'r+b'))

    71. 

  71.                         {

    72. 

  72.                             rewind($fp);

    73. 

  73.                             fwrite($fp, $NewID3v2Tag, strlen($NewID3v2Tag));

    74. 

  74.                             fclose($fp);

    75. 

  75.                         }

    76. 

  76.                         else

    77. 

  77.                         {

    78. 

  78.                             $this->errors[] = 'Could not open ' . $this->filename . ' mode "r+b" - ' . strip_tags(ob_get_contents());

    79. 

  79.                         }

    80. 

  80.                         ob_end_clean();

    81. 

  81.                     

    82. 

  82.                     }

    83. 

  83.                     else

    84. 

  84.                     {

    85. 

  85.                         

    86. 

  86.                         ob_start();

    87. 

  87.                         if ($fp = fopen($this->filename, 'wb'))

    88. 

  88.                         {

    89. 

  89.                             rewind($fp);

    90. 

  90.                             fwrite($fp, $NewID3v2Tag, strlen($NewID3v2Tag));

    91. 

  91.                             fclose($fp);

    92. 

  92.                         }

    93. 

  93.                         else

    94. 

  94.                         {

    95. 

  95.                             $this->errors[] = 'Could not open ' . $this->filename . ' mode "wb" - ' . strip_tags(ob_get_contents());

    96. 

  96.                         }

    97. 

  97.                         ob_end_clean();

    98. 

  98.                     

    99. 

  99.                     }

    100. 

  100.                 

    101. 

  101.                 }

    102. 

  102.                 else

    103. 

  103.                 {

    104. 

  104.                     

    105. 

  105.                     if ($tempfilename = tempnam('*', 'getID3'))

    106. 

  106.                     {

    107. 

  107.                         ob_start();

    108. 

  108.                         if ($fp_source = fopen($this->filename, 'rb'))

    109. 

  109.                         {

    110. 

  110.                             if ($fp_temp = fopen($tempfilename, 'wb'))

    111. 

  111.                             {

    112. 

  112.                                 

    113. 

  113.                                 fwrite($fp_temp, $NewID3v2Tag, strlen($NewID3v2Tag));

    114. 

  114.                                 

    115. 

  115.                                 rewind($fp_source);

    116. 

  116.                                 if (! empty($OldThisFileInfo['avdataoffset']))

    117. 

  117.                                 {

    118. 

  118.                                     fseek($fp_source, $OldThisFileInfo['avdataoffset'], SEEK_SET);

    119. 

  119.                                 }

    120. 

  120.                                 

    121. 

  121.                                 while ($buffer = fread($fp_source, GETID3_FREAD_BUFFER_SIZE))

    122. 

  122.                                 {

    123. 

  123.                                     fwrite($fp_temp, $buffer, strlen($buffer));

    124. 

  124.                                 }

    125. 

  125.                                 

    126. 

  126.                                 fclose($fp_temp);

    127. 

  127.                                 fclose($fp_source);

    128. 

  128.                                 copy($tempfilename, $this->filename);

    129. 

  129.                                 unlink($tempfilename);

    130. 

  130.                                 ob_end_clean();

    131. 

  131.                                 return true;

    132. 

  132.                             

    133. 

  133.                             }

    134. 

  134.                             else

    135. 

  135.                             {

    136. 

  136.                                 

    137. 

  137.                                 $this->errors[] = 'Could not open ' . $tempfilename . ' mode "wb" - ' . strip_tags(ob_get_contents());

    138. 

  138.                             

    139. 

  139.                             }

    140. 

  140.                             fclose($fp_source);

    141. 

  141.                         

    142. 

  142.                         }

    143. 

  143.                         else

    144. 

  144.                         {

    145. 

  145.                             

    146. 

  146.                             $this->errors[] = 'Could not open ' . $this->filename . ' mode "rb" - ' . strip_tags(ob_get_contents());

    147. 

  147.                         

    148. 

  148.                         }

    149. 

  149.                         ob_end_clean();

    150. 

  150.                     }

    151. 

  151.                     return false;

    152. 

  152.                 

    153. 

  153.                 }

    154. 

  154.             

    155. 

  155.             }

    156. 

  156.             else

    157. 

  157.             {

    158. 

  158.                 

    159. 

  159.                 $this->errors[] = '$this->GenerateID3v2Tag() failed';

    160. 

  160.             

    161. 

  161.             }

    162. 

  162.             

    163. 

  163.             if (! empty($this->errors))

    164. 

  164.             {

    165. 

  165.                 return false;

    166. 

  166.             }

    167. 

  167.             return true;

    168. 

  168.         }

    169. 

  169.         else

    170. 

  170.         {

    171. 

  171.             $this->errors[] = '!is_writeable(' . $this->filename . ')';

    172. 

  172.         }

    173. 

  173.         return false;

    174. 

  174.     }

    175. 

  175. 

    176. 

  176.     function RemoveID3v2()

    177. 

  177.     {

    178. 

  178.         

    179. 

  179.         // File MUST be writeable - CHMOD(646) at least. It's best if the
    180. 

  180.         // directory is also writeable, because that method is both faster and less susceptible to errors.
    181. 

  181.         if (is_writeable(dirname($this->filename)))

    182. 

  182.         {

    183. 

  183.             

    184. 

  184.             // preferred method - only one copying operation, minimal chance of corrupting
    185. 

  185.             // original file if script is interrupted, but required directory to be writeable
    186. 

  186.             if ($fp_source = @fopen($this->filename, 'rb'))

    187. 

  187.             {

    188. 

  188.                 // Initialize getID3 engine
    189. 

  189.                 $getID3 = new getID3();

    190. 

  190.                 $OldThisFileInfo = $getID3->analyze($this->filename);

    191. 

  191.                 rewind($fp_source);

    192. 

  192.                 if ($OldThisFileInfo['avdataoffset'] !== false)

    193. 

  193.                 {

    194. 

  194.                     fseek($fp_source, $OldThisFileInfo['avdataoffset'], SEEK_SET);

    195. 

  195.                 }

    196. 

  196.                 if ($fp_temp = @fopen($this->filename . 'getid3tmp', 'w+b'))

    197. 

  197.                 {

    198. 

  198.                     while ($buffer = fread($fp_source, GETID3_FREAD_BUFFER_SIZE))

    199. 

  199.                     {

    200. 

  200.                         fwrite($fp_temp, $buffer, strlen($buffer));

    201. 

  201.                     }

    202. 

  202.                     fclose($fp_temp);

    203. 

  203.                 }

    204. 

  204.                 else

    205. 

  205.                 {

    206. 

  206.                     $this->errors[] = 'Could not open ' . $this->filename . 'getid3tmp mode "w+b"';

    207. 

  207.                 }

    208. 

  208.                 fclose($fp_source);

    209. 

  209.             }

    210. 

  210.             else

    211. 

  211.             {

    212. 

  212.                 $this->errors[] = 'Could not open ' . $this->filename . ' mode "rb"';

    213. 

  213.             }

    214. 

  214.             if (file_exists($this->filename))

    215. 

  215.             {

    216. 

  216.                 unlink($this->filename);

    217. 

  217.             }

    218. 

  218.             rename($this->filename . 'getid3tmp', $this->filename);

    219. 

  219.         

    220. 

  220.         }

    221. 

  221.         elseif (is_writable($this->filename))

    222. 

  222.         {

    223. 

  223.             

    224. 

  224.             // less desirable alternate method - double-copies the file, overwrites original file
    225. 

  225.             // and could corrupt source file if the script is interrupted or an error occurs.
    226. 

  226.             if ($fp_source = @fopen($this->filename, 'rb'))

    227. 

  227.             {

    228. 

  228.                 // Initialize getID3 engine
    229. 

  229.                 $getID3 = new getID3();

    230. 

  230.                 $OldThisFileInfo = $getID3->analyze($this->filename);

    231. 

  231.                 rewind($fp_source);

    232. 

  232.                 if ($OldThisFileInfo['avdataoffset'] !== false)

    233. 

  233.                 {

    234. 

  234.                     fseek($fp_source, $OldThisFileInfo['avdataoffset'], SEEK_SET);

    235. 

  235.                 }

    236. 

  236.                 if ($fp_temp = tmpfile())

    237. 

  237.                 {

    238. 

  238.                     while ($buffer = fread($fp_source, GETID3_FREAD_BUFFER_SIZE))

    239. 

  239.                     {

    240. 

  240.                         fwrite($fp_temp, $buffer, strlen($buffer));

    241. 

  241.                     }

    242. 

  242.                     fclose($fp_source);

    243. 

  243.                     if ($fp_source = @fopen($this->filename, 'wb'))

    244. 

  244.                     {

    245. 

  245.                         rewind($fp_temp);

    246. 

  246.                         while ($buffer = fread($fp_temp, GETID3_FREAD_BUFFER_SIZE))

    247. 

  247.                         {

    248. 

  248.                             fwrite($fp_source, $buffer, strlen($buffer));

    249. 

  249.                         }

    250. 

  250.                         fseek($fp_temp, - 128, SEEK_END);

    251. 

  251.                         fclose($fp_source);

    252. 

  252.                     }

    253. 

  253.                     else

    254. 

  254.                     {

    255. 

  255.                         $this->errors[] = 'Could not open ' . $this->filename . ' mode "wb"';

    256. 

  256.                     }

    257. 

  257.                     fclose($fp_temp);

    258. 

  258.                 }

    259. 

  259.                 else

    260. 

  260.                 {

    261. 

  261.                     $this->errors[] = 'Could not create tmpfile()';

    262. 

  262.                 }

    263. 

  263.             }

    264. 

  264.             else

    265. 

  265.             {

    266. 

  266.                 $this->errors[] = 'Could not open ' . $this->filename . ' mode "rb"';

    267. 

  267.             }

    268. 

  268.         

    269. 

  269.         }

    270. 

  270.         else

    271. 

  271.         {

    272. 

  272.             

    273. 

  273.             $this->errors[] = 'Directory and file both not writeable';

    274. 

  274.         

    275. 

  275.         }

    276. 

  276.         

    277. 

  277.         if (! empty($this->errors))

    278. 

  278.         {

    279. 

  279.             return false;

    280. 

  280.         }

    281. 

  281.         return true;

    282. 

  282.     }

    283. 

  283. 

    284. 

  284.     function GenerateID3v2TagFlags($flags)

    285. 

  285.     {

    286. 

  286.         switch ($this->majorversion)

    287. 

  287.         {

    288. 

  288.             case 4 :

    289. 

  289.                 // %abcd0000
    290. 

  290.                 $flag = (@$flags['unsynchronisation'] ? '1' : '0'); // a - Unsynchronisation
    291. 

  291.                 $flag .= (@$flags['extendedheader'] ? '1' : '0'); // b - Extended header
    292. 

  292.                 $flag .= (@$flags['experimental'] ? '1' : '0'); // c - Experimental indicator
    293. 

  293.                 $flag .= (@$flags['footer'] ? '1' : '0'); // d - Footer present
    294. 

  294.                 $flag .= '0000';

    295. 

  295.                 break;

    296. 

  296.             

    297. 

  297.             case 3 :

    298. 

  298.                 // %abc00000
    299. 

  299.                 $flag = (@$flags['unsynchronisation'] ? '1' : '0'); // a - Unsynchronisation
    300. 

  300.                 $flag .= (@$flags['extendedheader'] ? '1' : '0'); // b - Extended header
    301. 

  301.                 $flag .= (@$flags['experimental'] ? '1' : '0'); // c - Experimental indicator
    302. 

  302.                 $flag .= '00000';

    303. 

  303.                 break;

    304. 

  304.             

    305. 

  305.             case 2 :

    306. 

  306.                 // %ab000000
    307. 

  307.                 $flag = (@$flags['unsynchronisation'] ? '1' : '0'); // a - Unsynchronisation
    308. 

  308.                 $flag .= (@$flags['compression'] ? '1' : '0'); // b - Compression
    309. 

  309.                 $flag .= '000000';

    310. 

  310.                 break;

    311. 

  311.             

    312. 

  312.             default :

    313. 

  313.                 return false;

    314. 

  314.                 break;

    315. 

  315.         }

    316. 

  316.         return chr(bindec($flag));

    317. 

  317.     }

    318. 

  318. 

    319. 

  319.     function GenerateID3v2FrameFlags($TagAlter = false, $FileAlter = false, $ReadOnly = false, $Compression = false, $Encryption = false, $GroupingIdentity = false, $Unsynchronisation = false, $DataLengthIndicator = false)

    320. 

  320.     {

    321. 

  321.         switch ($this->majorversion)

    322. 

  322.         {

    323. 

  323.             case 4 :

    324. 

  324.                 // %0abc0000 %0h00kmnp
    325. 

  325.                 $flag1 = '0';

    326. 

  326.                 $flag1 .= $TagAlter ? '1' : '0'; // a - Tag alter preservation (true == discard)
    327. 

  327.                 $flag1 .= $FileAlter ? '1' : '0'; // b - File alter preservation (true == discard)
    328. 

  328.                 $flag1 .= $ReadOnly ? '1' : '0'; // c - Read only (true == read only)
    329. 

  329.                 $flag1 .= '0000';

    330. 

  330.                 

    331. 

  331.                 $flag2 = '0';

    332. 

  332.                 $flag2 .= $GroupingIdentity ? '1' : '0'; // h - Grouping identity (true == contains group information)
    333. 

  333.                 $flag2 .= '00';

    334. 

  334.                 $flag2 .= $Compression ? '1' : '0'; // k - Compression (true == compressed)
    335. 

  335.                 $flag2 .= $Encryption ? '1' : '0'; // m - Encryption (true == encrypted)
    336. 

  336.                 $flag2 .= $Unsynchronisation ? '1' : '0'; // n - Unsynchronisation (true == unsynchronised)
    337. 

  337.                 $flag2 .= $DataLengthIndicator ? '1' : '0'; // p - Data length indicator (true == data length indicator added)
    338. 

  338.                 break;

    339. 

  339.             

    340. 

  340.             case 3 :

    341. 

  341.                 // %abc00000 %ijk00000
    342. 

  342.                 $flag1 = $TagAlter ? '1' : '0'; // a - Tag alter preservation (true == discard)
    343. 

  343.                 $flag1 .= $FileAlter ? '1' : '0'; // b - File alter preservation (true == discard)
    344. 

  344.                 $flag1 .= $ReadOnly ? '1' : '0'; // c - Read only (true == read only)
    345. 

  345.                 $flag1 .= '00000';

    346. 

  346.                 

    347. 

  347.                 $flag2 = $Compression ? '1' : '0'; // i - Compression (true == compressed)
    348. 

  348.                 $flag2 .= $Encryption ? '1' : '0'; // j - Encryption (true == encrypted)
    349. 

  349.                 $flag2 .= $GroupingIdentity ? '1' : '0'; // k - Grouping identity (true == contains group information)
    350. 

  350.                 $flag2 .= '00000';

    351. 

  351.                 break;

    352. 

  352.             

    353. 

  353.             default :

    354. 

  354.                 return false;

    355. 

  355.                 break;

    356. 

  356.         

    357. 

  357.         }

    358. 

  358.         return chr(bindec($flag1)) . chr(bindec($flag2));

    359. 

  359.     }

    360. 

  360. 

    361. 

  361.     function GenerateID3v2FrameData($frame_name, $source_data_array)

    362. 

  362.     {

    363. 

  363.         if (! getid3_id3v2 :: IsValidID3v2FrameName($frame_name, $this->majorversion))

    364. 

  364.         {

    365. 

  365.             return false;

    366. 

  366.         }

    367. 

  367.         $framedata = '';

    368. 

  368.         

    369. 

  369.         if (($this->majorversion < 3) || ($this->majorversion > 4))

    370. 

  370.         {

    371. 

  371.             

    372. 

  372.             $this->errors[] = 'Only ID3v2.3 and ID3v2.4 are supported in GenerateID3v2FrameData()';

    373. 

  373.         

    374. 

  374.         }

    375. 

  375.         else

    376. 

  376.         { // $this->majorversion 3 or 4
    377. 

  377.             

    378. 

  378. 

    379. 

  379.             switch ($frame_name)

    380. 

  380.             {

    381. 

  381.                 case 'UFID' :

    382. 

  382.                     // 4.1   UFID Unique file identifier
    383. 

  383.                     // Owner identifier        <text string> $00
    384. 

  384.                     // Identifier              <up to 64 bytes binary data>
    385. 

  385.                     if (strlen($source_data_array['data']) > 64)

    386. 

  386.                     {

    387. 

  387.                         $this->errors[] = 'Identifier not allowed to be longer than 64 bytes in ' . $frame_name . ' (supplied data was ' . strlen($source_data_array['data']) . ' bytes long)';

    388. 

  388.                     }

    389. 

  389.                     else

    390. 

  390.                     {

    391. 

  391.                         $framedata .= str_replace("\x00", '', $source_data_array['ownerid']) . "\x00";

    392. 

  392.                         $framedata .= substr($source_data_array['data'], 0, 64); // max 64 bytes - truncate anything longer
    393. 

  393.                     }

    394. 

  394.                     break;

    395. 

  395.                 

    396. 

  396.                 case 'TXXX' :

    397. 

  397.                     // 4.2.2 TXXX User defined text information frame
    398. 

  398.                     // Text encoding     $xx
    399. 

  399.                     // Description       <text string according to encoding> $00 (00)
    400. 

  400.                     // Value             <text string according to encoding>
    401. 

  401.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    402. 

  402.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid'], $this->majorversion))

    403. 

  403.                     {

    404. 

  404.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    405. 

  405.                     }

    406. 

  406.                     else

    407. 

  407.                     {

    408. 

  408.                         $framedata .= chr($source_data_array['encodingid']);

    409. 

  409.                         $framedata .= $source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    410. 

  410.                         $framedata .= $source_data_array['data'];

    411. 

  411.                     }

    412. 

  412.                     break;

    413. 

  413.                 

    414. 

  414.                 case 'WXXX' :

    415. 

  415.                     // 4.3.2 WXXX User defined URL link frame
    416. 

  416.                     // Text encoding     $xx
    417. 

  417.                     // Description       <text string according to encoding> $00 (00)
    418. 

  418.                     // URL               <text string>
    419. 

  419.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    420. 

  420.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid'], $this->majorversion))

    421. 

  421.                     {

    422. 

  422.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    423. 

  423.                     }

    424. 

  424.                     elseif (! isset($source_data_array['data']) || ! $this->IsValidURL($source_data_array['data'], false, false))

    425. 

  425.                     {

    426. 

  426.                         //$this->errors[] = 'Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')';
    427. 

  427.                         // probably should be an error, need to rewrite IsValidURL() to handle other encodings
    428. 

  428.                         $this->warnings[] = 'Invalid URL in ' . $frame_name . ' (' . $source_data_array['data'] . ')';

    429. 

  429.                     }

    430. 

  430.                     else

    431. 

  431.                     {

    432. 

  432.                         $framedata .= chr($source_data_array['encodingid']);

    433. 

  433.                         $framedata .= $source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    434. 

  434.                         $framedata .= $source_data_array['data'];

    435. 

  435.                     }

    436. 

  436.                     break;

    437. 

  437.                 

    438. 

  438.                 case 'IPLS' :

    439. 

  439.                     // 4.4  IPLS Involved people list (ID3v2.3 only)
    440. 

  440.                     // Text encoding     $xx
    441. 

  441.                     // People list strings    <textstrings>
    442. 

  442.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    443. 

  443.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid'], $this->majorversion))

    444. 

  444.                     {

    445. 

  445.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    446. 

  446.                     }

    447. 

  447.                     else

    448. 

  448.                     {

    449. 

  449.                         $framedata .= chr($source_data_array['encodingid']);

    450. 

  450.                         $framedata .= $source_data_array['data'];

    451. 

  451.                     }

    452. 

  452.                     break;

    453. 

  453.                 

    454. 

  454.                 case 'MCDI' :

    455. 

  455.                     // 4.4   MCDI Music CD identifier
    456. 

  456.                     // CD TOC                <binary data>
    457. 

  457.                     $framedata .= $source_data_array['data'];

    458. 

  458.                     break;

    459. 

  459.                 

    460. 

  460.                 case 'ETCO' :

    461. 

  461.                     // 4.5   ETCO Event timing codes
    462. 

  462.                     // Time stamp format    $xx
    463. 

  463.                     //   Where time stamp format is:
    464. 

  464.                     // $01  (32-bit value) MPEG frames from beginning of file
    465. 

  465.                     // $02  (32-bit value) milliseconds from beginning of file
    466. 

  466.                     //   Followed by a list of key events in the following format:
    467. 

  467.                     // Type of event   $xx
    468. 

  468.                     // Time stamp      $xx (xx ...)
    469. 

  469.                     //   The 'Time stamp' is set to zero if directly at the beginning of the sound
    470. 

  470.                     //   or after the previous event. All events MUST be sorted in chronological order.
    471. 

  471.                     if (($source_data_array['timestampformat'] > 2) || ($source_data_array['timestampformat'] < 1))

    472. 

  472.                     {

    473. 

  473.                         $this->errors[] = 'Invalid Time Stamp Format byte in ' . $frame_name . ' (' . $source_data_array['timestampformat'] . ')';

    474. 

  474.                     }

    475. 

  475.                     else

    476. 

  476.                     {

    477. 

  477.                         $framedata .= chr($source_data_array['timestampformat']);

    478. 

  478.                         foreach ($source_data_array as $key => $val)

    479. 

  479.                         {

    480. 

  480.                             if (! $this->ID3v2IsValidETCOevent($val['typeid']))

    481. 

  481.                             {

    482. 

  482.                                 $this->errors[] = 'Invalid Event Type byte in ' . $frame_name . ' (' . $val['typeid'] . ')';

    483. 

  483.                             }

    484. 

  484.                             elseif (($key != 'timestampformat') && ($key != 'flags'))

    485. 

  485.                             {

    486. 

  486.                                 if (($val['timestamp'] > 0) && ($previousETCOtimestamp >= $val['timestamp']))

    487. 

  487.                                 {

    488. 

  488.                                     //   The 'Time stamp' is set to zero if directly at the beginning of the sound
    489. 

  489.                                     //   or after the previous event. All events MUST be sorted in chronological order.
    490. 

  490.                                     $this->errors[] = 'Out-of-order timestamp in ' . $frame_name . ' (' . $val['timestamp'] . ') for Event Type (' . $val['typeid'] . ')';

    491. 

  491.                                 }

    492. 

  492.                                 else

    493. 

  493.                                 {

    494. 

  494.                                     $framedata .= chr($val['typeid']);

    495. 

  495.                                     $framedata .= getid3_lib :: BigEndian2String($val['timestamp'], 4, false);

    496. 

  496.                                 }

    497. 

  497.                             }

    498. 

  498.                         }

    499. 

  499.                     }

    500. 

  500.                     break;

    501. 

  501.                 

    502. 

  502.                 case 'MLLT' :

    503. 

  503.                     // 4.6   MLLT MPEG location lookup table
    504. 

  504.                     // MPEG frames between reference  $xx xx
    505. 

  505.                     // Bytes between reference        $xx xx xx
    506. 

  506.                     // Milliseconds between reference $xx xx xx
    507. 

  507.                     // Bits for bytes deviation       $xx
    508. 

  508.                     // Bits for milliseconds dev.     $xx
    509. 

  509.                     //   Then for every reference the following data is included;
    510. 

  510.                     // Deviation in bytes         %xxx....
    511. 

  511.                     // Deviation in milliseconds  %xxx....
    512. 

  512.                     if (($source_data_array['framesbetweenreferences'] > 0) && ($source_data_array['framesbetweenreferences'] <= 65535))

    513. 

  513.                     {

    514. 

  514.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['framesbetweenreferences'], 2, false);

    515. 

  515.                     }

    516. 

  516.                     else

    517. 

  517.                     {

    518. 

  518.                         $this->errors[] = 'Invalid MPEG Frames Between References in ' . $frame_name . ' (' . $source_data_array['framesbetweenreferences'] . ')';

    519. 

  519.                     }

    520. 

  520.                     if (($source_data_array['bytesbetweenreferences'] > 0) && ($source_data_array['bytesbetweenreferences'] <= 16777215))

    521. 

  521.                     {

    522. 

  522.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['bytesbetweenreferences'], 3, false);

    523. 

  523.                     }

    524. 

  524.                     else

    525. 

  525.                     {

    526. 

  526.                         $this->errors[] = 'Invalid bytes Between References in ' . $frame_name . ' (' . $source_data_array['bytesbetweenreferences'] . ')';

    527. 

  527.                     }

    528. 

  528.                     if (($source_data_array['msbetweenreferences'] > 0) && ($source_data_array['msbetweenreferences'] <= 16777215))

    529. 

  529.                     {

    530. 

  530.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['msbetweenreferences'], 3, false);

    531. 

  531.                     }

    532. 

  532.                     else

    533. 

  533.                     {

    534. 

  534.                         $this->errors[] = 'Invalid Milliseconds Between References in ' . $frame_name . ' (' . $source_data_array['msbetweenreferences'] . ')';

    535. 

  535.                     }

    536. 

  536.                     if (! $this->IsWithinBitRange($source_data_array['bitsforbytesdeviation'], 8, false))

    537. 

  537.                     {

    538. 

  538.                         if (($source_data_array['bitsforbytesdeviation'] % 4) == 0)

    539. 

  539.                         {

    540. 

  540.                             $framedata .= chr($source_data_array['bitsforbytesdeviation']);

    541. 

  541.                         }

    542. 

  542.                         else

    543. 

  543.                         {

    544. 

  544.                             $this->errors[] = 'Bits For Bytes Deviation in ' . $frame_name . ' (' . $source_data_array['bitsforbytesdeviation'] . ') must be a multiple of 4.';

    545. 

  545.                         }

    546. 

  546.                     }

    547. 

  547.                     else

    548. 

  548.                     {

    549. 

  549.                         $this->errors[] = 'Invalid Bits For Bytes Deviation in ' . $frame_name . ' (' . $source_data_array['bitsforbytesdeviation'] . ')';

    550. 

  550.                     }

    551. 

  551.                     if (! $this->IsWithinBitRange($source_data_array['bitsformsdeviation'], 8, false))

    552. 

  552.                     {

    553. 

  553.                         if (($source_data_array['bitsformsdeviation'] % 4) == 0)

    554. 

  554.                         {

    555. 

  555.                             $framedata .= chr($source_data_array['bitsformsdeviation']);

    556. 

  556.                         }

    557. 

  557.                         else

    558. 

  558.                         {

    559. 

  559.                             $this->errors[] = 'Bits For Milliseconds Deviation in ' . $frame_name . ' (' . $source_data_array['bitsforbytesdeviation'] . ') must be a multiple of 4.';

    560. 

  560.                         }

    561. 

  561.                     }

    562. 

  562.                     else

    563. 

  563.                     {

    564. 

  564.                         $this->errors[] = 'Invalid Bits For Milliseconds Deviation in ' . $frame_name . ' (' . $source_data_array['bitsformsdeviation'] . ')';

    565. 

  565.                     }

    566. 

  566.                     foreach ($source_data_array as $key => $val)

    567. 

  567.                     {

    568. 

  568.                         if (($key != 'framesbetweenreferences') && ($key != 'bytesbetweenreferences') && ($key != 'msbetweenreferences') && ($key != 'bitsforbytesdeviation') && ($key != 'bitsformsdeviation') && ($key != 'flags'))

    569. 

  569.                         {

    570. 

  570.                             $unwrittenbitstream .= str_pad(getid3_lib :: Dec2Bin($val['bytedeviation']), $source_data_array['bitsforbytesdeviation'], '0', STR_PAD_LEFT);

    571. 

  571.                             $unwrittenbitstream .= str_pad(getid3_lib :: Dec2Bin($val['msdeviation']), $source_data_array['bitsformsdeviation'], '0', STR_PAD_LEFT);

    572. 

  572.                         }

    573. 

  573.                     }

    574. 

  574.                     for($i = 0; $i < strlen($unwrittenbitstream); $i += 8)

    575. 

  575.                     {

    576. 

  576.                         $highnibble = bindec(substr($unwrittenbitstream, $i, 4)) << 4;

    577. 

  577.                         $lownibble = bindec(substr($unwrittenbitstream, $i + 4, 4));

    578. 

  578.                         $framedata .= chr($highnibble & $lownibble);

    579. 

  579.                     }

    580. 

  580.                     break;

    581. 

  581.                 

    582. 

  582.                 case 'SYTC' :

    583. 

  583.                     // 4.7   SYTC Synchronised tempo codes
    584. 

  584.                     // Time stamp format   $xx
    585. 

  585.                     // Tempo data          <binary data>
    586. 

  586.                     //   Where time stamp format is:
    587. 

  587.                     // $01  (32-bit value) MPEG frames from beginning of file
    588. 

  588.                     // $02  (32-bit value) milliseconds from beginning of file
    589. 

  589.                     if (($source_data_array['timestampformat'] > 2) || ($source_data_array['timestampformat'] < 1))

    590. 

  590.                     {

    591. 

  591.                         $this->errors[] = 'Invalid Time Stamp Format byte in ' . $frame_name . ' (' . $source_data_array['timestampformat'] . ')';

    592. 

  592.                     }

    593. 

  593.                     else

    594. 

  594.                     {

    595. 

  595.                         $framedata .= chr($source_data_array['timestampformat']);

    596. 

  596.                         foreach ($source_data_array as $key => $val)

    597. 

  597.                         {

    598. 

  598.                             if (! $this->ID3v2IsValidETCOevent($val['typeid']))

    599. 

  599.                             {

    600. 

  600.                                 $this->errors[] = 'Invalid Event Type byte in ' . $frame_name . ' (' . $val['typeid'] . ')';

    601. 

  601.                             }

    602. 

  602.                             elseif (($key != 'timestampformat') && ($key != 'flags'))

    603. 

  603.                             {

    604. 

  604.                                 if (($val['tempo'] < 0) || ($val['tempo'] > 510))

    605. 

  605.                                 {

    606. 

  606.                                     $this->errors[] = 'Invalid Tempo (max = 510) in ' . $frame_name . ' (' . $val['tempo'] . ') at timestamp (' . $val['timestamp'] . ')';

    607. 

  607.                                 }

    608. 

  608.                                 else

    609. 

  609.                                 {

    610. 

  610.                                     if ($val['tempo'] > 255)

    611. 

  611.                                     {

    612. 

  612.                                         $framedata .= chr(255);

    613. 

  613.                                         $val['tempo'] -= 255;

    614. 

  614.                                     }

    615. 

  615.                                     $framedata .= chr($val['tempo']);

    616. 

  616.                                     $framedata .= getid3_lib :: BigEndian2String($val['timestamp'], 4, false);

    617. 

  617.                                 }

    618. 

  618.                             }

    619. 

  619.                         }

    620. 

  620.                     }

    621. 

  621.                     break;

    622. 

  622.                 

    623. 

  623.                 case 'USLT' :

    624. 

  624.                     // 4.8   USLT Unsynchronised lyric/text transcription
    625. 

  625.                     // Text encoding        $xx
    626. 

  626.                     // Language             $xx xx xx
    627. 

  627.                     // Content descriptor   <text string according to encoding> $00 (00)
    628. 

  628.                     // Lyrics/text          <full text string according to encoding>
    629. 

  629.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    630. 

  630.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    631. 

  631.                     {

    632. 

  632.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    633. 

  633.                     }

    634. 

  634.                     elseif (getid3_id3v2 :: LanguageLookup($source_data_array['language'], true) == '')

    635. 

  635.                     {

    636. 

  636.                         $this->errors[] = 'Invalid Language in ' . $frame_name . ' (' . $source_data_array['language'] . ')';

    637. 

  637.                     }

    638. 

  638.                     else

    639. 

  639.                     {

    640. 

  640.                         $framedata .= chr($source_data_array['encodingid']);

    641. 

  641.                         $framedata .= strtolower($source_data_array['language']);

    642. 

  642.                         $framedata .= $source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    643. 

  643.                         $framedata .= $source_data_array['data'];

    644. 

  644.                     }

    645. 

  645.                     break;

    646. 

  646.                 

    647. 

  647.                 case 'SYLT' :

    648. 

  648.                     // 4.9   SYLT Synchronised lyric/text
    649. 

  649.                     // Text encoding        $xx
    650. 

  650.                     // Language             $xx xx xx
    651. 

  651.                     // Time stamp format    $xx
    652. 

  652.                     //   $01  (32-bit value) MPEG frames from beginning of file
    653. 

  653.                     //   $02  (32-bit value) milliseconds from beginning of file
    654. 

  654.                     // Content type         $xx
    655. 

  655.                     // Content descriptor   <text string according to encoding> $00 (00)
    656. 

  656.                     //   Terminated text to be synced (typically a syllable)
    657. 

  657.                     //   Sync identifier (terminator to above string)   $00 (00)
    658. 

  658.                     //   Time stamp                                     $xx (xx ...)
    659. 

  659.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    660. 

  660.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    661. 

  661.                     {

    662. 

  662.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    663. 

  663.                     }

    664. 

  664.                     elseif (getid3_id3v2 :: LanguageLookup($source_data_array['language'], true) == '')

    665. 

  665.                     {

    666. 

  666.                         $this->errors[] = 'Invalid Language in ' . $frame_name . ' (' . $source_data_array['language'] . ')';

    667. 

  667.                     }

    668. 

  668.                     elseif (($source_data_array['timestampformat'] > 2) || ($source_data_array['timestampformat'] < 1))

    669. 

  669.                     {

    670. 

  670.                         $this->errors[] = 'Invalid Time Stamp Format byte in ' . $frame_name . ' (' . $source_data_array['timestampformat'] . ')';

    671. 

  671.                     }

    672. 

  672.                     elseif (! $this->ID3v2IsValidSYLTtype($source_data_array['contenttypeid']))

    673. 

  673.                     {

    674. 

  674.                         $this->errors[] = 'Invalid Content Type byte in ' . $frame_name . ' (' . $source_data_array['contenttypeid'] . ')';

    675. 

  675.                     }

    676. 

  676.                     elseif (! is_array($source_data_array['data']))

    677. 

  677.                     {

    678. 

  678.                         $this->errors[] = 'Invalid Lyric/Timestamp data in ' . $frame_name . ' (must be an array)';

    679. 

  679.                     }

    680. 

  680.                     else

    681. 

  681.                     {

    682. 

  682.                         $framedata .= chr($source_data_array['encodingid']);

    683. 

  683.                         $framedata .= strtolower($source_data_array['language']);

    684. 

  684.                         $framedata .= chr($source_data_array['timestampformat']);

    685. 

  685.                         $framedata .= chr($source_data_array['contenttypeid']);

    686. 

  686.                         $framedata .= $source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    687. 

  687.                         ksort($source_data_array['data']);

    688. 

  688.                         foreach ($source_data_array['data'] as $key => $val)

    689. 

  689.                         {

    690. 

  690.                             $framedata .= $val['data'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    691. 

  691.                             $framedata .= getid3_lib :: BigEndian2String($val['timestamp'], 4, false);

    692. 

  692.                         }

    693. 

  693.                     }

    694. 

  694.                     break;

    695. 

  695.                 

    696. 

  696.                 case 'COMM' :

    697. 

  697.                     // 4.10  COMM Comments
    698. 

  698.                     // Text encoding          $xx
    699. 

  699.                     // Language               $xx xx xx
    700. 

  700.                     // Short content descrip. <text string according to encoding> $00 (00)
    701. 

  701.                     // The actual text        <full text string according to encoding>
    702. 

  702.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    703. 

  703.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    704. 

  704.                     {

    705. 

  705.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    706. 

  706.                     }

    707. 

  707.                     elseif (getid3_id3v2 :: LanguageLookup($source_data_array['language'], true) == '')

    708. 

  708.                     {

    709. 

  709.                         $this->errors[] = 'Invalid Language in ' . $frame_name . ' (' . $source_data_array['language'] . ')';

    710. 

  710.                     }

    711. 

  711.                     else

    712. 

  712.                     {

    713. 

  713.                         $framedata .= chr($source_data_array['encodingid']);

    714. 

  714.                         $framedata .= strtolower($source_data_array['language']);

    715. 

  715.                         $framedata .= $source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    716. 

  716.                         $framedata .= $source_data_array['data'];

    717. 

  717.                     }

    718. 

  718.                     break;

    719. 

  719.                 

    720. 

  720.                 case 'RVA2' :

    721. 

  721.                     // 4.11  RVA2 Relative volume adjustment (2) (ID3v2.4+ only)
    722. 

  722.                     // Identification          <text string> $00
    723. 

  723.                     //   The 'identification' string is used to identify the situation and/or
    724. 

  724.                     //   device where this adjustment should apply. The following is then
    725. 

  725.                     //   repeated for every channel:
    726. 

  726.                     // Type of channel         $xx
    727. 

  727.                     // Volume adjustment       $xx xx
    728. 

  728.                     // Bits representing peak  $xx
    729. 

  729.                     // Peak volume             $xx (xx ...)
    730. 

  730.                     $framedata .= str_replace("\x00", '', $source_data_array['description']) . "\x00";

    731. 

  731.                     foreach ($source_data_array as $key => $val)

    732. 

  732.                     {

    733. 

  733.                         if ($key != 'description')

    734. 

  734.                         {

    735. 

  735.                             $framedata .= chr($val['channeltypeid']);

    736. 

  736.                             $framedata .= getid3_lib :: BigEndian2String($val['volumeadjust'], 2, false, true); // signed 16-bit
    737. 

  737.                             if (! $this->IsWithinBitRange($source_data_array['bitspeakvolume'], 8, false))

    738. 

  738.                             {

    739. 

  739.                                 $framedata .= chr($val['bitspeakvolume']);

    740. 

  740.                                 if ($val['bitspeakvolume'] > 0)

    741. 

  741.                                 {

    742. 

  742.                                     $framedata .= getid3_lib :: BigEndian2String($val['peakvolume'], ceil($val['bitspeakvolume'] / 8), false, false);

    743. 

  743.                                 }

    744. 

  744.                             }

    745. 

  745.                             else

    746. 

  746.                             {

    747. 

  747.                                 $this->errors[] = 'Invalid Bits Representing Peak Volume in ' . $frame_name . ' (' . $val['bitspeakvolume'] . ') (range = 0 to 255)';

    748. 

  748.                             }

    749. 

  749.                         }

    750. 

  750.                     }

    751. 

  751.                     break;

    752. 

  752.                 

    753. 

  753.                 case 'RVAD' :

    754. 

  754.                     // 4.12  RVAD Relative volume adjustment (ID3v2.3 only)
    755. 

  755.                     // Increment/decrement     %00fedcba
    756. 

  756.                     // Bits used for volume descr.        $xx
    757. 

  757.                     // Relative volume change, right      $xx xx (xx ...) // a
    758. 

  758.                     // Relative volume change, left       $xx xx (xx ...) // b
    759. 

  759.                     // Peak volume right                  $xx xx (xx ...)
    760. 

  760.                     // Peak volume left                   $xx xx (xx ...)
    761. 

  761.                     // Relative volume change, right back $xx xx (xx ...) // c
    762. 

  762.                     // Relative volume change, left back  $xx xx (xx ...) // d
    763. 

  763.                     // Peak volume right back             $xx xx (xx ...)
    764. 

  764.                     // Peak volume left back              $xx xx (xx ...)
    765. 

  765.                     // Relative volume change, center     $xx xx (xx ...) // e
    766. 

  766.                     // Peak volume center                 $xx xx (xx ...)
    767. 

  767.                     // Relative volume change, bass       $xx xx (xx ...) // f
    768. 

  768.                     // Peak volume bass                   $xx xx (xx ...)
    769. 

  769.                     if (! $this->IsWithinBitRange($source_data_array['bitsvolume'], 8, false))

    770. 

  770.                     {

    771. 

  771.                         $this->errors[] = 'Invalid Bits For Volume Description byte in ' . $frame_name . ' (' . $source_data_array['bitsvolume'] . ') (range = 1 to 255)';

    772. 

  772.                     }

    773. 

  773.                     else

    774. 

  774.                     {

    775. 

  775.                         $incdecflag .= '00';

    776. 

  776.                         $incdecflag .= $source_data_array['incdec']['right'] ? '1' : '0'; // a - Relative volume change, right
    777. 

  777.                         $incdecflag .= $source_data_array['incdec']['left'] ? '1' : '0'; // b - Relative volume change, left
    778. 

  778.                         $incdecflag .= $source_data_array['incdec']['rightrear'] ? '1' : '0'; // c - Relative volume change, right back
    779. 

  779.                         $incdecflag .= $source_data_array['incdec']['leftrear'] ? '1' : '0'; // d - Relative volume change, left back
    780. 

  780.                         $incdecflag .= $source_data_array['incdec']['center'] ? '1' : '0'; // e - Relative volume change, center
    781. 

  781.                         $incdecflag .= $source_data_array['incdec']['bass'] ? '1' : '0'; // f - Relative volume change, bass
    782. 

  782.                         $framedata .= chr(bindec($incdecflag));

    783. 

  783.                         $framedata .= chr($source_data_array['bitsvolume']);

    784. 

  784.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['volumechange']['right'], ceil($source_data_array['bitsvolume'] / 8), false);

    785. 

  785.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['volumechange']['left'], ceil($source_data_array['bitsvolume'] / 8), false);

    786. 

  786.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['peakvolume']['right'], ceil($source_data_array['bitsvolume'] / 8), false);

    787. 

  787.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['peakvolume']['left'], ceil($source_data_array['bitsvolume'] / 8), false);

    788. 

  788.                         if ($source_data_array['volumechange']['rightrear'] || $source_data_array['volumechange']['leftrear'] || $source_data_array['peakvolume']['rightrear'] || $source_data_array['peakvolume']['leftrear'] || $source_data_array['volumechange']['center'] || $source_data_array['peakvolume']['center'] || $source_data_array['volumechange']['bass'] || $source_data_array['peakvolume']['bass'])

    789. 

  789.                         {

    790. 

  790.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['volumechange']['rightrear'], ceil($source_data_array['bitsvolume'] / 8), false);

    791. 

  791.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['volumechange']['leftrear'], ceil($source_data_array['bitsvolume'] / 8), false);

    792. 

  792.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['peakvolume']['rightrear'], ceil($source_data_array['bitsvolume'] / 8), false);

    793. 

  793.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['peakvolume']['leftrear'], ceil($source_data_array['bitsvolume'] / 8), false);

    794. 

  794.                         }

    795. 

  795.                         if ($source_data_array['volumechange']['center'] || $source_data_array['peakvolume']['center'] || $source_data_array['volumechange']['bass'] || $source_data_array['peakvolume']['bass'])

    796. 

  796.                         {

    797. 

  797.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['volumechange']['center'], ceil($source_data_array['bitsvolume'] / 8), false);

    798. 

  798.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['peakvolume']['center'], ceil($source_data_array['bitsvolume'] / 8), false);

    799. 

  799.                         }

    800. 

  800.                         if ($source_data_array['volumechange']['bass'] || $source_data_array['peakvolume']['bass'])

    801. 

  801.                         {

    802. 

  802.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['volumechange']['bass'], ceil($source_data_array['bitsvolume'] / 8), false);

    803. 

  803.                             $framedata .= getid3_lib :: BigEndian2String($source_data_array['peakvolume']['bass'], ceil($source_data_array['bitsvolume'] / 8), false);

    804. 

  804.                         }

    805. 

  805.                     }

    806. 

  806.                     break;

    807. 

  807.                 

    808. 

  808.                 case 'EQU2' :

    809. 

  809.                     // 4.12  EQU2 Equalisation (2) (ID3v2.4+ only)
    810. 

  810.                     // Interpolation method  $xx
    811. 

  811.                     //   $00  Band
    812. 

  812.                     //   $01  Linear
    813. 

  813.                     // Identification        <text string> $00
    814. 

  814.                     //   The following is then repeated for every adjustment point
    815. 

  815.                     // Frequency          $xx xx
    816. 

  816.                     // Volume adjustment  $xx xx
    817. 

  817.                     if (($source_data_array['interpolationmethod'] < 0) || ($source_data_array['interpolationmethod'] > 1))

    818. 

  818.                     {

    819. 

  819.                         $this->errors[] = 'Invalid Interpolation Method byte in ' . $frame_name . ' (' . $source_data_array['interpolationmethod'] . ') (valid = 0 or 1)';

    820. 

  820.                     }

    821. 

  821.                     else

    822. 

  822.                     {

    823. 

  823.                         $framedata .= chr($source_data_array['interpolationmethod']);

    824. 

  824.                         $framedata .= str_replace("\x00", '', $source_data_array['description']) . "\x00";

    825. 

  825.                         foreach ($source_data_array['data'] as $key => $val)

    826. 

  826.                         {

    827. 

  827.                             $framedata .= getid3_lib :: BigEndian2String(intval(round($key * 2)), 2, false);

    828. 

  828.                             $framedata .= getid3_lib :: BigEndian2String($val, 2, false, true); // signed 16-bit
    829. 

  829.                         }

    830. 

  830.                     }

    831. 

  831.                     break;

    832. 

  832.                 

    833. 

  833.                 case 'EQUA' :

    834. 

  834.                     // 4.12  EQUA Equalisation (ID3v2.3 only)
    835. 

  835.                     // Adjustment bits    $xx
    836. 

  836.                     //   This is followed by 2 bytes + ('adjustment bits' rounded up to the
    837. 

  837.                     //   nearest byte) for every equalisation band in the following format,
    838. 

  838.                     //   giving a frequency range of 0 - 32767Hz:
    839. 

  839.                     // Increment/decrement   %x (MSB of the Frequency)
    840. 

  840.                     // Frequency             (lower 15 bits)
    841. 

  841.                     // Adjustment            $xx (xx ...)
    842. 

  842.                     if (! $this->IsWithinBitRange($source_data_array['bitsvolume'], 8, false))

    843. 

  843.                     {

    844. 

  844.                         $this->errors[] = 'Invalid Adjustment Bits byte in ' . $frame_name . ' (' . $source_data_array['bitsvolume'] . ') (range = 1 to 255)';

    845. 

  845.                     }

    846. 

  846.                     else

    847. 

  847.                     {

    848. 

  848.                         $framedata .= chr($source_data_array['adjustmentbits']);

    849. 

  849.                         foreach ($source_data_array as $key => $val)

    850. 

  850.                         {

    851. 

  851.                             if ($key != 'bitsvolume')

    852. 

  852.                             {

    853. 

  853.                                 if (($key > 32767) || ($key < 0))

    854. 

  854.                                 {

    855. 

  855.                                     $this->errors[] = 'Invalid Frequency in ' . $frame_name . ' (' . $key . ') (range = 0 to 32767)';

    856. 

  856.                                 }

    857. 

  857.                                 else

    858. 

  858.                                 {

    859. 

  859.                                     if ($val >= 0)

    860. 

  860.                                     {

    861. 

  861.                                         // put MSB of frequency to 1 if increment, 0 if decrement
    862. 

  862.                                         $key |= 0x8000;

    863. 

  863.                                     }

    864. 

  864.                                     $framedata .= getid3_lib :: BigEndian2String($key, 2, false);

    865. 

  865.                                     $framedata .= getid3_lib :: BigEndian2String($val, ceil($source_data_array['adjustmentbits'] / 8), false);

    866. 

  866.                                 }

    867. 

  867.                             }

    868. 

  868.                         }

    869. 

  869.                     }

    870. 

  870.                     break;

    871. 

  871.                 

    872. 

  872.                 case 'RVRB' :

    873. 

  873.                     // 4.13  RVRB Reverb
    874. 

  874.                     // Reverb left (ms)                 $xx xx
    875. 

  875.                     // Reverb right (ms)                $xx xx
    876. 

  876.                     // Reverb bounces, left             $xx
    877. 

  877.                     // Reverb bounces, right            $xx
    878. 

  878.                     // Reverb feedback, left to left    $xx
    879. 

  879.                     // Reverb feedback, left to right   $xx
    880. 

  880.                     // Reverb feedback, right to right  $xx
    881. 

  881.                     // Reverb feedback, right to left   $xx
    882. 

  882.                     // Premix left to right             $xx
    883. 

  883.                     // Premix right to left             $xx
    884. 

  884.                     if (! $this->IsWithinBitRange($source_data_array['left'], 16, false))

    885. 

  885.                     {

    886. 

  886.                         $this->errors[] = 'Invalid Reverb Left in ' . $frame_name . ' (' . $source_data_array['left'] . ') (range = 0 to 65535)';

    887. 

  887.                     }

    888. 

  888.                     elseif (! $this->IsWithinBitRange($source_data_array['right'], 16, false))

    889. 

  889.                     {

    890. 

  890.                         $this->errors[] = 'Invalid Reverb Left in ' . $frame_name . ' (' . $source_data_array['right'] . ') (range = 0 to 65535)';

    891. 

  891.                     }

    892. 

  892.                     elseif (! $this->IsWithinBitRange($source_data_array['bouncesL'], 8, false))

    893. 

  893.                     {

    894. 

  894.                         $this->errors[] = 'Invalid Reverb Bounces, Left in ' . $frame_name . ' (' . $source_data_array['bouncesL'] . ') (range = 0 to 255)';

    895. 

  895.                     }

    896. 

  896.                     elseif (! $this->IsWithinBitRange($source_data_array['bouncesR'], 8, false))

    897. 

  897.                     {

    898. 

  898.                         $this->errors[] = 'Invalid Reverb Bounces, Right in ' . $frame_name . ' (' . $source_data_array['bouncesR'] . ') (range = 0 to 255)';

    899. 

  899.                     }

    900. 

  900.                     elseif (! $this->IsWithinBitRange($source_data_array['feedbackLL'], 8, false))

    901. 

  901.                     {

    902. 

  902.                         $this->errors[] = 'Invalid Reverb Feedback, Left-To-Left in ' . $frame_name . ' (' . $source_data_array['feedbackLL'] . ') (range = 0 to 255)';

    903. 

  903.                     }

    904. 

  904.                     elseif (! $this->IsWithinBitRange($source_data_array['feedbackLR'], 8, false))

    905. 

  905.                     {

    906. 

  906.                         $this->errors[] = 'Invalid Reverb Feedback, Left-To-Right in ' . $frame_name . ' (' . $source_data_array['feedbackLR'] . ') (range = 0 to 255)';

    907. 

  907.                     }

    908. 

  908.                     elseif (! $this->IsWithinBitRange($source_data_array['feedbackRR'], 8, false))

    909. 

  909.                     {

    910. 

  910.                         $this->errors[] = 'Invalid Reverb Feedback, Right-To-Right in ' . $frame_name . ' (' . $source_data_array['feedbackRR'] . ') (range = 0 to 255)';

    911. 

  911.                     }

    912. 

  912.                     elseif (! $this->IsWithinBitRange($source_data_array['feedbackRL'], 8, false))

    913. 

  913.                     {

    914. 

  914.                         $this->errors[] = 'Invalid Reverb Feedback, Right-To-Left in ' . $frame_name . ' (' . $source_data_array['feedbackRL'] . ') (range = 0 to 255)';

    915. 

  915.                     }

    916. 

  916.                     elseif (! $this->IsWithinBitRange($source_data_array['premixLR'], 8, false))

    917. 

  917.                     {

    918. 

  918.                         $this->errors[] = 'Invalid Premix, Left-To-Right in ' . $frame_name . ' (' . $source_data_array['premixLR'] . ') (range = 0 to 255)';

    919. 

  919.                     }

    920. 

  920.                     elseif (! $this->IsWithinBitRange($source_data_array['premixRL'], 8, false))

    921. 

  921.                     {

    922. 

  922.                         $this->errors[] = 'Invalid Premix, Right-To-Left in ' . $frame_name . ' (' . $source_data_array['premixRL'] . ') (range = 0 to 255)';

    923. 

  923.                     }

    924. 

  924.                     else

    925. 

  925.                     {

    926. 

  926.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['left'], 2, false);

    927. 

  927.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['right'], 2, false);

    928. 

  928.                         $framedata .= chr($source_data_array['bouncesL']);

    929. 

  929.                         $framedata .= chr($source_data_array['bouncesR']);

    930. 

  930.                         $framedata .= chr($source_data_array['feedbackLL']);

    931. 

  931.                         $framedata .= chr($source_data_array['feedbackLR']);

    932. 

  932.                         $framedata .= chr($source_data_array['feedbackRR']);

    933. 

  933.                         $framedata .= chr($source_data_array['feedbackRL']);

    934. 

  934.                         $framedata .= chr($source_data_array['premixLR']);

    935. 

  935.                         $framedata .= chr($source_data_array['premixRL']);

    936. 

  936.                     }

    937. 

  937.                     break;

    938. 

  938.                 

    939. 

  939.                 case 'APIC' :

    940. 

  940.                     // 4.14  APIC Attached picture
    941. 

  941.                     // Text encoding      $xx
    942. 

  942.                     // MIME type          <text string> $00
    943. 

  943.                     // Picture type       $xx
    944. 

  944.                     // Description        <text string according to encoding> $00 (00)
    945. 

  945.                     // Picture data       <binary data>
    946. 

  946.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    947. 

  947.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    948. 

  948.                     {

    949. 

  949.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    950. 

  950.                     }

    951. 

  951.                     elseif (! $this->ID3v2IsValidAPICpicturetype($source_data_array['picturetypeid']))

    952. 

  952.                     {

    953. 

  953.                         $this->errors[] = 'Invalid Picture Type byte in ' . $frame_name . ' (' . $source_data_array['picturetypeid'] . ') for ID3v2.' . $this->majorversion;

    954. 

  954.                     }

    955. 

  955.                     elseif (($this->majorversion >= 3) && (! $this->ID3v2IsValidAPICimageformat($source_data_array['mime'])))

    956. 

  956.                     {

    957. 

  957.                         $this->errors[] = 'Invalid MIME Type in ' . $frame_name . ' (' . $source_data_array['mime'] . ') for ID3v2.' . $this->majorversion;

    958. 

  958.                     }

    959. 

  959.                     elseif (($source_data_array['mime'] == '-->') && (! $this->IsValidURL($source_data_array['data'], false, false)))

    960. 

  960.                     {

    961. 

  961.                         //$this->errors[] = 'Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')';
    962. 

  962.                         // probably should be an error, need to rewrite IsValidURL() to handle other encodings
    963. 

  963.                         $this->warnings[] = 'Invalid URL in ' . $frame_name . ' (' . $source_data_array['data'] . ')';

    964. 

  964.                     }

    965. 

  965.                     else

    966. 

  966.                     {

    967. 

  967.                         $framedata .= chr($source_data_array['encodingid']);

    968. 

  968.                         $framedata .= str_replace("\x00", '', $source_data_array['mime']) . "\x00";

    969. 

  969.                         $framedata .= chr($source_data_array['picturetypeid']);

    970. 

  970.                         $framedata .= @$source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    971. 

  971.                         $framedata .= $source_data_array['data'];

    972. 

  972.                     }

    973. 

  973.                     break;

    974. 

  974.                 

    975. 

  975.                 case 'GEOB' :

    976. 

  976.                     // 4.15  GEOB General encapsulated object
    977. 

  977.                     // Text encoding          $xx
    978. 

  978.                     // MIME type              <text string> $00
    979. 

  979.                     // Filename               <text string according to encoding> $00 (00)
    980. 

  980.                     // Content description    <text string according to encoding> $00 (00)
    981. 

  981.                     // Encapsulated object    <binary data>
    982. 

  982.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    983. 

  983.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    984. 

  984.                     {

    985. 

  985.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    986. 

  986.                     }

    987. 

  987.                     elseif (! $this->IsValidMIMEstring($source_data_array['mime']))

    988. 

  988.                     {

    989. 

  989.                         $this->errors[] = 'Invalid MIME Type in ' . $frame_name . ' (' . $source_data_array['mime'] . ')';

    990. 

  990.                     }

    991. 

  991.                     elseif (! $source_data_array['description'])

    992. 

  992.                     {

    993. 

  993.                         $this->errors[] = 'Missing Description in ' . $frame_name;

    994. 

  994.                     }

    995. 

  995.                     else

    996. 

  996.                     {

    997. 

  997.                         $framedata .= chr($source_data_array['encodingid']);

    998. 

  998.                         $framedata .= str_replace("\x00", '', $source_data_array['mime']) . "\x00";

    999. 

  999.                         $framedata .= $source_data_array['filename'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    1000. 

  1000.                         $framedata .= $source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    1001. 

  1001.                         $framedata .= $source_data_array['data'];

    1002. 

  1002.                     }

    1003. 

  1003.                     break;

    1004. 

  1004.                 

    1005. 

  1005.                 case 'PCNT' :

    1006. 

  1006.                     // 4.16  PCNT Play counter
    1007. 

  1007.                     //   When the counter reaches all one's, one byte is inserted in
    1008. 

  1008.                     //   front of the counter thus making the counter eight bits bigger
    1009. 

  1009.                     // Counter        $xx xx xx xx (xx ...)
    1010. 

  1010.                     $framedata .= getid3_lib :: BigEndian2String($source_data_array['data'], 4, false);

    1011. 

  1011.                     break;

    1012. 

  1012.                 

    1013. 

  1013.                 case 'POPM' :

    1014. 

  1014.                     // 4.17  POPM Popularimeter
    1015. 

  1015.                     //   When the counter reaches all one's, one byte is inserted in
    1016. 

  1016.                     //   front of the counter thus making the counter eight bits bigger
    1017. 

  1017.                     // Email to user   <text string> $00
    1018. 

  1018.                     // Rating          $xx
    1019. 

  1019.                     // Counter         $xx xx xx xx (xx ...)
    1020. 

  1020.                     if (! $this->IsWithinBitRange($source_data_array['rating'], 8, false))

    1021. 

  1021.                     {

    1022. 

  1022.                         $this->errors[] = 'Invalid Rating byte in ' . $frame_name . ' (' . $source_data_array['rating'] . ') (range = 0 to 255)';

    1023. 

  1023.                     }

    1024. 

  1024.                     elseif (! IsValidEmail($source_data_array['email']))

    1025. 

  1025.                     {

    1026. 

  1026.                         $this->errors[] = 'Invalid Email in ' . $frame_name . ' (' . $source_data_array['email'] . ')';

    1027. 

  1027.                     }

    1028. 

  1028.                     else

    1029. 

  1029.                     {

    1030. 

  1030.                         $framedata .= str_replace("\x00", '', $source_data_array['email']) . "\x00";

    1031. 

  1031.                         $framedata .= chr($source_data_array['rating']);

    1032. 

  1032.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['data'], 4, false);

    1033. 

  1033.                     }

    1034. 

  1034.                     break;

    1035. 

  1035.                 

    1036. 

  1036.                 case 'RBUF' :

    1037. 

  1037.                     // 4.18  RBUF Recommended buffer size
    1038. 

  1038.                     // Buffer size               $xx xx xx
    1039. 

  1039.                     // Embedded info flag        %0000000x
    1040. 

  1040.                     // Offset to next tag        $xx xx xx xx
    1041. 

  1041.                     if (! $this->IsWithinBitRange($source_data_array['buffersize'], 24, false))

    1042. 

  1042.                     {

    1043. 

  1043.                         $this->errors[] = 'Invalid Buffer Size in ' . $frame_name;

    1044. 

  1044.                     }

    1045. 

  1045.                     elseif (! $this->IsWithinBitRange($source_data_array['nexttagoffset'], 32, false))

    1046. 

  1046.                     {

    1047. 

  1047.                         $this->errors[] = 'Invalid Offset To Next Tag in ' . $frame_name;

    1048. 

  1048.                     }

    1049. 

  1049.                     else

    1050. 

  1050.                     {

    1051. 

  1051.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['buffersize'], 3, false);

    1052. 

  1052.                         $flag .= '0000000';

    1053. 

  1053.                         $flag .= $source_data_array['flags']['embededinfo'] ? '1' : '0';

    1054. 

  1054.                         $framedata .= chr(bindec($flag));

    1055. 

  1055.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['nexttagoffset'], 4, false);

    1056. 

  1056.                     }

    1057. 

  1057.                     break;

    1058. 

  1058.                 

    1059. 

  1059.                 case 'AENC' :

    1060. 

  1060.                     // 4.19  AENC Audio encryption
    1061. 

  1061.                     // Owner identifier   <text string> $00
    1062. 

  1062.                     // Preview start      $xx xx
    1063. 

  1063.                     // Preview length     $xx xx
    1064. 

  1064.                     // Encryption info    <binary data>
    1065. 

  1065.                     if (! $this->IsWithinBitRange($source_data_array['previewstart'], 16, false))

    1066. 

  1066.                     {

    1067. 

  1067.                         $this->errors[] = 'Invalid Preview Start in ' . $frame_name . ' (' . $source_data_array['previewstart'] . ')';

    1068. 

  1068.                     }

    1069. 

  1069.                     elseif (! $this->IsWithinBitRange($source_data_array['previewlength'], 16, false))

    1070. 

  1070.                     {

    1071. 

  1071.                         $this->errors[] = 'Invalid Preview Length in ' . $frame_name . ' (' . $source_data_array['previewlength'] . ')';

    1072. 

  1072.                     }

    1073. 

  1073.                     else

    1074. 

  1074.                     {

    1075. 

  1075.                         $framedata .= str_replace("\x00", '', $source_data_array['ownerid']) . "\x00";

    1076. 

  1076.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['previewstart'], 2, false);

    1077. 

  1077.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['previewlength'], 2, false);

    1078. 

  1078.                         $framedata .= $source_data_array['encryptioninfo'];

    1079. 

  1079.                     }

    1080. 

  1080.                     break;

    1081. 

  1081.                 

    1082. 

  1082.                 case 'LINK' :

    1083. 

  1083.                     // 4.20  LINK Linked information
    1084. 

  1084.                     // Frame identifier               $xx xx xx xx
    1085. 

  1085.                     // URL                            <text string> $00
    1086. 

  1086.                     // ID and additional data         <text string(s)>
    1087. 

  1087.                     if (! getid3_id3v2 :: IsValidID3v2FrameName($source_data_array['frameid'], $this->majorversion))

    1088. 

  1088.                     {

    1089. 

  1089.                         $this->errors[] = 'Invalid Frame Identifier in ' . $frame_name . ' (' . $source_data_array['frameid'] . ')';

    1090. 

  1090.                     }

    1091. 

  1091.                     elseif (! $this->IsValidURL($source_data_array['data'], true, false))

    1092. 

  1092.                     {

    1093. 

  1093.                         //$this->errors[] = 'Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')';
    1094. 

  1094.                         // probably should be an error, need to rewrite IsValidURL() to handle other encodings
    1095. 

  1095.                         $this->warnings[] = 'Invalid URL in ' . $frame_name . ' (' . $source_data_array['data'] . ')';

    1096. 

  1096.                     }

    1097. 

  1097.                     elseif ((($source_data_array['frameid'] == 'AENC') || ($source_data_array['frameid'] == 'APIC') || ($source_data_array['frameid'] == 'GEOB') || ($source_data_array['frameid'] == 'TXXX')) && ($source_data_array['additionaldata'] == ''))

    1098. 

  1098.                     {

    1099. 

  1099.                         $this->errors[] = 'Content Descriptor must be specified as additional data for Frame Identifier of ' . $source_data_array['frameid'] . ' in ' . $frame_name;

    1100. 

  1100.                     }

    1101. 

  1101.                     elseif (($source_data_array['frameid'] == 'USER') && (getid3_id3v2 :: LanguageLookup($source_data_array['additionaldata'], true) == ''))

    1102. 

  1102.                     {

    1103. 

  1103.                         $this->errors[] = 'Language must be specified as additional data for Frame Identifier of ' . $source_data_array['frameid'] . ' in ' . $frame_name;

    1104. 

  1104.                     }

    1105. 

  1105.                     elseif (($source_data_array['frameid'] == 'PRIV') && ($source_data_array['additionaldata'] == ''))

    1106. 

  1106.                     {

    1107. 

  1107.                         $this->errors[] = 'Owner Identifier must be specified as additional data for Frame Identifier of ' . $source_data_array['frameid'] . ' in ' . $frame_name;

    1108. 

  1108.                     }

    1109. 

  1109.                     elseif ((($source_data_array['frameid'] == 'COMM') || ($source_data_array['frameid'] == 'SYLT') || ($source_data_array['frameid'] == 'USLT')) && ((getid3_id3v2 :: LanguageLookup(substr($source_data_array['additionaldata'], 0, 3), true) == '') || (substr($source_data_array['additionaldata'], 3) == '')))

    1110. 

  1110.                     {

    1111. 

  1111.                         $this->errors[] = 'Language followed by Content Descriptor must be specified as additional data for Frame Identifier of ' . $source_data_array['frameid'] . ' in ' . $frame_name;

    1112. 

  1112.                     }

    1113. 

  1113.                     else

    1114. 

  1114.                     {

    1115. 

  1115.                         $framedata .= $source_data_array['frameid'];

    1116. 

  1116.                         $framedata .= str_replace("\x00", '', $source_data_array['data']) . "\x00";

    1117. 

  1117.                         switch ($source_data_array['frameid'])

    1118. 

  1118.                         {

    1119. 

  1119.                             case 'COMM' :

    1120. 

  1120.                             case 'SYLT' :

    1121. 

  1121.                             case 'USLT' :

    1122. 

  1122.                             case 'PRIV' :

    1123. 

  1123.                             case 'USER' :

    1124. 

  1124.                             case 'AENC' :

    1125. 

  1125.                             case 'APIC' :

    1126. 

  1126.                             case 'GEOB' :

    1127. 

  1127.                             case 'TXXX' :

    1128. 

  1128.                                 $framedata .= $source_data_array['additionaldata'];

    1129. 

  1129.                                 break;

    1130. 

  1130.                             case 'ASPI' :

    1131. 

  1131.                             case 'ETCO' :

    1132. 

  1132.                             case 'EQU2' :

    1133. 

  1133.                             case 'MCID' :

    1134. 

  1134.                             case 'MLLT' :

    1135. 

  1135.                             case 'OWNE' :

    1136. 

  1136.                             case 'RVA2' :

    1137. 

  1137.                             case 'RVRB' :

    1138. 

  1138.                             case 'SYTC' :

    1139. 

  1139.                             case 'IPLS' :

    1140. 

  1140.                             case 'RVAD' :

    1141. 

  1141.                             case 'EQUA' :

    1142. 

  1142.                                 // no additional data required
    1143. 

  1143.                                 break;

    1144. 

  1144.                             case 'RBUF' :

    1145. 

  1145.                                 if ($this->majorversion == 3)

    1146. 

  1146.                                 {

    1147. 

  1147.                                     // no additional data required
    1148. 

  1148.                                 }

    1149. 

  1149.                                 else

    1150. 

  1150.                                 {

    1151. 

  1151.                                     $this->errors[] = $source_data_array['frameid'] . ' is not a valid Frame Identifier in ' . $frame_name . ' (in ID3v2.' . $this->majorversion . ')';

    1152. 

  1152.                                 }

    1153. 

  1153.                             

    1154. 

  1154.                             default :

    1155. 

  1155.                                 if ((substr($source_data_array['frameid'], 0, 1) == 'T') || (substr($source_data_array['frameid'], 0, 1) == 'W'))

    1156. 

  1156.                                 {

    1157. 

  1157.                                     // no additional data required
    1158. 

  1158.                                 }

    1159. 

  1159.                                 else

    1160. 

  1160.                                 {

    1161. 

  1161.                                     $this->errors[] = $source_data_array['frameid'] . ' is not a valid Frame Identifier in ' . $frame_name . ' (in ID3v2.' . $this->majorversion . ')';

    1162. 

  1162.                                 }

    1163. 

  1163.                                 break;

    1164. 

  1164.                         }

    1165. 

  1165.                     }

    1166. 

  1166.                     break;

    1167. 

  1167.                 

    1168. 

  1168.                 case 'POSS' :

    1169. 

  1169.                     // 4.21  POSS Position synchronisation frame (ID3v2.3+ only)
    1170. 

  1170.                     // Time stamp format         $xx
    1171. 

  1171.                     // Position                  $xx (xx ...)
    1172. 

  1172.                     if (($source_data_array['timestampformat'] < 1) || ($source_data_array['timestampformat'] > 2))

    1173. 

  1173.                     {

    1174. 

  1174.                         $this->errors[] = 'Invalid Time Stamp Format in ' . $frame_name . ' (' . $source_data_array['timestampformat'] . ') (valid = 1 or 2)';

    1175. 

  1175.                     }

    1176. 

  1176.                     elseif (! $this->IsWithinBitRange($source_data_array['position'], 32, false))

    1177. 

  1177.                     {

    1178. 

  1178.                         $this->errors[] = 'Invalid Position in ' . $frame_name . ' (' . $source_data_array['position'] . ') (range = 0 to 4294967295)';

    1179. 

  1179.                     }

    1180. 

  1180.                     else

    1181. 

  1181.                     {

    1182. 

  1182.                         $framedata .= chr($source_data_array['timestampformat']);

    1183. 

  1183.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['position'], 4, false);

    1184. 

  1184.                     }

    1185. 

  1185.                     break;

    1186. 

  1186.                 

    1187. 

  1187.                 case 'USER' :

    1188. 

  1188.                     // 4.22  USER Terms of use (ID3v2.3+ only)
    1189. 

  1189.                     // Text encoding        $xx
    1190. 

  1190.                     // Language             $xx xx xx
    1191. 

  1191.                     // The actual text      <text string according to encoding>
    1192. 

  1192.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    1193. 

  1193.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    1194. 

  1194.                     {

    1195. 

  1195.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ')';

    1196. 

  1196.                     }

    1197. 

  1197.                     elseif (getid3_id3v2 :: LanguageLookup($source_data_array['language'], true) == '')

    1198. 

  1198.                     {

    1199. 

  1199.                         $this->errors[] = 'Invalid Language in ' . $frame_name . ' (' . $source_data_array['language'] . ')';

    1200. 

  1200.                     }

    1201. 

  1201.                     else

    1202. 

  1202.                     {

    1203. 

  1203.                         $framedata .= chr($source_data_array['encodingid']);

    1204. 

  1204.                         $framedata .= strtolower($source_data_array['language']);

    1205. 

  1205.                         $framedata .= $source_data_array['data'];

    1206. 

  1206.                     }

    1207. 

  1207.                     break;

    1208. 

  1208.                 

    1209. 

  1209.                 case 'OWNE' :

    1210. 

  1210.                     // 4.23  OWNE Ownership frame (ID3v2.3+ only)
    1211. 

  1211.                     // Text encoding     $xx
    1212. 

  1212.                     // Price paid        <text string> $00
    1213. 

  1213.                     // Date of purch.    <text string>
    1214. 

  1214.                     // Seller            <text string according to encoding>
    1215. 

  1215.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    1216. 

  1216.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    1217. 

  1217.                     {

    1218. 

  1218.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ')';

    1219. 

  1219.                     }

    1220. 

  1220.                     elseif (! $this->IsANumber($source_data_array['pricepaid']['value'], false))

    1221. 

  1221.                     {

    1222. 

  1222.                         $this->errors[] = 'Invalid Price Paid in ' . $frame_name . ' (' . $source_data_array['pricepaid']['value'] . ')';

    1223. 

  1223.                     }

    1224. 

  1224.                     elseif (! $this->IsValidDateStampString($source_data_array['purchasedate']))

    1225. 

  1225.                     {

    1226. 

  1226.                         $this->errors[] = 'Invalid Date Of Purchase in ' . $frame_name . ' (' . $source_data_array['purchasedate'] . ') (format = YYYYMMDD)';

    1227. 

  1227.                     }

    1228. 

  1228.                     else

    1229. 

  1229.                     {

    1230. 

  1230.                         $framedata .= chr($source_data_array['encodingid']);

    1231. 

  1231.                         $framedata .= str_replace("\x00", '', $source_data_array['pricepaid']['value']) . "\x00";

    1232. 

  1232.                         $framedata .= $source_data_array['purchasedate'];

    1233. 

  1233.                         $framedata .= $source_data_array['seller'];

    1234. 

  1234.                     }

    1235. 

  1235.                     break;

    1236. 

  1236.                 

    1237. 

  1237.                 case 'COMR' :

    1238. 

  1238.                     // 4.24  COMR Commercial frame (ID3v2.3+ only)
    1239. 

  1239.                     // Text encoding      $xx
    1240. 

  1240.                     // Price string       <text string> $00
    1241. 

  1241.                     // Valid until        <text string>
    1242. 

  1242.                     // Contact URL        <text string> $00
    1243. 

  1243.                     // Received as        $xx
    1244. 

  1244.                     // Name of seller     <text string according to encoding> $00 (00)
    1245. 

  1245.                     // Description        <text string according to encoding> $00 (00)
    1246. 

  1246.                     // Picture MIME type  <string> $00
    1247. 

  1247.                     // Seller logo        <binary data>
    1248. 

  1248.                     $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    1249. 

  1249.                     if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    1250. 

  1250.                     {

    1251. 

  1251.                         $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ')';

    1252. 

  1252.                     }

    1253. 

  1253.                     elseif (! $this->IsValidDateStampString($source_data_array['pricevaliduntil']))

    1254. 

  1254.                     {

    1255. 

  1255.                         $this->errors[] = 'Invalid Valid Until date in ' . $frame_name . ' (' . $source_data_array['pricevaliduntil'] . ') (format = YYYYMMDD)';

    1256. 

  1256.                     }

    1257. 

  1257.                     elseif (! $this->IsValidURL($source_data_array['contacturl'], false, true))

    1258. 

  1258.                     {

    1259. 

  1259.                         $this->errors[] = 'Invalid Contact URL in ' . $frame_name . ' (' . $source_data_array['contacturl'] . ') (allowed schemes: http, https, ftp, mailto)';

    1260. 

  1260.                     }

    1261. 

  1261.                     elseif (! $this->ID3v2IsValidCOMRreceivedAs($source_data_array['receivedasid']))

    1262. 

  1262.                     {

    1263. 

  1263.                         $this->errors[] = 'Invalid Received As byte in ' . $frame_name . ' (' . $source_data_array['contacturl'] . ') (range = 0 to 8)';

    1264. 

  1264.                     }

    1265. 

  1265.                     elseif (! $this->IsValidMIMEstring($source_data_array['mime']))

    1266. 

  1266.                     {

    1267. 

  1267.                         $this->errors[] = 'Invalid MIME Type in ' . $frame_name . ' (' . $source_data_array['mime'] . ')';

    1268. 

  1268.                     }

    1269. 

  1269.                     else

    1270. 

  1270.                     {

    1271. 

  1271.                         $framedata .= chr($source_data_array['encodingid']);

    1272. 

  1272.                         unset($pricestring);

    1273. 

  1273.                         foreach ($source_data_array['price'] as $key => $val)

    1274. 

  1274.                         {

    1275. 

  1275.                             if ($this->ID3v2IsValidPriceString($key . $val['value']))

    1276. 

  1276.                             {

    1277. 

  1277.                                 $pricestrings[] = $key . $val['value'];

    1278. 

  1278.                             }

    1279. 

  1279.                             else

    1280. 

  1280.                             {

    1281. 

  1281.                                 $this->errors[] = 'Invalid Price String in ' . $frame_name . ' (' . $key . $val['value'] . ')';

    1282. 

  1282.                             }

    1283. 

  1283.                         }

    1284. 

  1284.                         $framedata .= implode('/', $pricestrings);

    1285. 

  1285.                         $framedata .= $source_data_array['pricevaliduntil'];

    1286. 

  1286.                         $framedata .= str_replace("\x00", '', $source_data_array['contacturl']) . "\x00";

    1287. 

  1287.                         $framedata .= chr($source_data_array['receivedasid']);

    1288. 

  1288.                         $framedata .= $source_data_array['sellername'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    1289. 

  1289.                         $framedata .= $source_data_array['description'] . getid3_id3v2 :: TextEncodingTerminatorLookup($source_data_array['encodingid']);

    1290. 

  1290.                         $framedata .= $source_data_array['mime'] . "\x00";

    1291. 

  1291.                         $framedata .= $source_data_array['logo'];

    1292. 

  1292.                     }

    1293. 

  1293.                     break;

    1294. 

  1294.                 

    1295. 

  1295.                 case 'ENCR' :

    1296. 

  1296.                     // 4.25  ENCR Encryption method registration (ID3v2.3+ only)
    1297. 

  1297.                     // Owner identifier    <text string> $00
    1298. 

  1298.                     // Method symbol       $xx
    1299. 

  1299.                     // Encryption data     <binary data>
    1300. 

  1300.                     if (! $this->IsWithinBitRange($source_data_array['methodsymbol'], 8, false))

    1301. 

  1301.                     {

    1302. 

  1302.                         $this->errors[] = 'Invalid Group Symbol in ' . $frame_name . ' (' . $source_data_array['methodsymbol'] . ') (range = 0 to 255)';

    1303. 

  1303.                     }

    1304. 

  1304.                     else

    1305. 

  1305.                     {

    1306. 

  1306.                         $framedata .= str_replace("\x00", '', $source_data_array['ownerid']) . "\x00";

    1307. 

  1307.                         $framedata .= ord($source_data_array['methodsymbol']);

    1308. 

  1308.                         $framedata .= $source_data_array['data'];

    1309. 

  1309.                     }

    1310. 

  1310.                     break;

    1311. 

  1311.                 

    1312. 

  1312.                 case 'GRID' :

    1313. 

  1313.                     // 4.26  GRID Group identification registration (ID3v2.3+ only)
    1314. 

  1314.                     // Owner identifier      <text string> $00
    1315. 

  1315.                     // Group symbol          $xx
    1316. 

  1316.                     // Group dependent data  <binary data>
    1317. 

  1317.                     if (! $this->IsWithinBitRange($source_data_array['groupsymbol'], 8, false))

    1318. 

  1318.                     {

    1319. 

  1319.                         $this->errors[] = 'Invalid Group Symbol in ' . $frame_name . ' (' . $source_data_array['groupsymbol'] . ') (range = 0 to 255)';

    1320. 

  1320.                     }

    1321. 

  1321.                     else

    1322. 

  1322.                     {

    1323. 

  1323.                         $framedata .= str_replace("\x00", '', $source_data_array['ownerid']) . "\x00";

    1324. 

  1324.                         $framedata .= ord($source_data_array['groupsymbol']);

    1325. 

  1325.                         $framedata .= $source_data_array['data'];

    1326. 

  1326.                     }

    1327. 

  1327.                     break;

    1328. 

  1328.                 

    1329. 

  1329.                 case 'PRIV' :

    1330. 

  1330.                     // 4.27  PRIV Private frame (ID3v2.3+ only)
    1331. 

  1331.                     // Owner identifier      <text string> $00
    1332. 

  1332.                     // The private data      <binary data>
    1333. 

  1333.                     $framedata .= str_replace("\x00", '', $source_data_array['ownerid']) . "\x00";

    1334. 

  1334.                     $framedata .= $source_data_array['data'];

    1335. 

  1335.                     break;

    1336. 

  1336.                 

    1337. 

  1337.                 case 'SIGN' :

    1338. 

  1338.                     // 4.28  SIGN Signature frame (ID3v2.4+ only)
    1339. 

  1339.                     // Group symbol      $xx
    1340. 

  1340.                     // Signature         <binary data>
    1341. 

  1341.                     if (! $this->IsWithinBitRange($source_data_array['groupsymbol'], 8, false))

    1342. 

  1342.                     {

    1343. 

  1343.                         $this->errors[] = 'Invalid Group Symbol in ' . $frame_name . ' (' . $source_data_array['groupsymbol'] . ') (range = 0 to 255)';

    1344. 

  1344.                     }

    1345. 

  1345.                     else

    1346. 

  1346.                     {

    1347. 

  1347.                         $framedata .= ord($source_data_array['groupsymbol']);

    1348. 

  1348.                         $framedata .= $source_data_array['data'];

    1349. 

  1349.                     }

    1350. 

  1350.                     break;

    1351. 

  1351.                 

    1352. 

  1352.                 case 'SEEK' :

    1353. 

  1353.                     // 4.29  SEEK Seek frame (ID3v2.4+ only)
    1354. 

  1354.                     // Minimum offset to next tag       $xx xx xx xx
    1355. 

  1355.                     if (! $this->IsWithinBitRange($source_data_array['data'], 32, false))

    1356. 

  1356.                     {

    1357. 

  1357.                         $this->errors[] = 'Invalid Minimum Offset in ' . $frame_name . ' (' . $source_data_array['data'] . ') (range = 0 to 4294967295)';

    1358. 

  1358.                     }

    1359. 

  1359.                     else

    1360. 

  1360.                     {

    1361. 

  1361.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['data'], 4, false);

    1362. 

  1362.                     }

    1363. 

  1363.                     break;

    1364. 

  1364.                 

    1365. 

  1365.                 case 'ASPI' :

    1366. 

  1366.                     // 4.30  ASPI Audio seek point index (ID3v2.4+ only)
    1367. 

  1367.                     // Indexed data start (S)         $xx xx xx xx
    1368. 

  1368.                     // Indexed data length (L)        $xx xx xx xx
    1369. 

  1369.                     // Number of index points (N)     $xx xx
    1370. 

  1370.                     // Bits per index point (b)       $xx
    1371. 

  1371.                     //   Then for every index point the following data is included:
    1372. 

  1372.                     // Fraction at index (Fi)          $xx (xx)
    1373. 

  1373.                     if (! $this->IsWithinBitRange($source_data_array['datastart'], 32, false))

    1374. 

  1374.                     {

    1375. 

  1375.                         $this->errors[] = 'Invalid Indexed Data Start in ' . $frame_name . ' (' . $source_data_array['datastart'] . ') (range = 0 to 4294967295)';

    1376. 

  1376.                     }

    1377. 

  1377.                     elseif (! $this->IsWithinBitRange($source_data_array['datalength'], 32, false))

    1378. 

  1378.                     {

    1379. 

  1379.                         $this->errors[] = 'Invalid Indexed Data Length in ' . $frame_name . ' (' . $source_data_array['datalength'] . ') (range = 0 to 4294967295)';

    1380. 

  1380.                     }

    1381. 

  1381.                     elseif (! $this->IsWithinBitRange($source_data_array['indexpoints'], 16, false))

    1382. 

  1382.                     {

    1383. 

  1383.                         $this->errors[] = 'Invalid Number Of Index Points in ' . $frame_name . ' (' . $source_data_array['indexpoints'] . ') (range = 0 to 65535)';

    1384. 

  1384.                     }

    1385. 

  1385.                     elseif (! $this->IsWithinBitRange($source_data_array['bitsperpoint'], 8, false))

    1386. 

  1386.                     {

    1387. 

  1387.                         $this->errors[] = 'Invalid Bits Per Index Point in ' . $frame_name . ' (' . $source_data_array['bitsperpoint'] . ') (range = 0 to 255)';

    1388. 

  1388.                     }

    1389. 

  1389.                     elseif ($source_data_array['indexpoints'] != count($source_data_array['indexes']))

    1390. 

  1390.                     {

    1391. 

  1391.                         $this->errors[] = 'Number Of Index Points does not match actual supplied data in ' . $frame_name;

    1392. 

  1392.                     }

    1393. 

  1393.                     else

    1394. 

  1394.                     {

    1395. 

  1395.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['datastart'], 4, false);

    1396. 

  1396.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['datalength'], 4, false);

    1397. 

  1397.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['indexpoints'], 2, false);

    1398. 

  1398.                         $framedata .= getid3_lib :: BigEndian2String($source_data_array['bitsperpoint'], 1, false);

    1399. 

  1399.                         foreach ($source_data_array['indexes'] as $key => $val)

    1400. 

  1400.                         {

    1401. 

  1401.                             $framedata .= getid3_lib :: BigEndian2String($val, ceil($source_data_array['bitsperpoint'] / 8), false);

    1402. 

  1402.                         }

    1403. 

  1403.                     }

    1404. 

  1404.                     break;

    1405. 

  1405.                 

    1406. 

  1406.                 case 'RGAD' :

    1407. 

  1407.                     //   RGAD Replay Gain Adjustment
    1408. 

  1408.                     //   http://privatewww.essex.ac.uk/~djmrob/replaygain/
    1409. 

  1409.                     // Peak Amplitude                     $xx $xx $xx $xx
    1410. 

  1410.                     // Radio Replay Gain Adjustment        %aaabbbcd %dddddddd
    1411. 

  1411.                     // Audiophile Replay Gain Adjustment   %aaabbbcd %dddddddd
    1412. 

  1412.                     //   a - name code
    1413. 

  1413.                     //   b - originator code
    1414. 

  1414.                     //   c - sign bit
    1415. 

  1415.                     //   d - replay gain adjustment
    1416. 

  1416.                     

    1417. 

  1417. 

    1418. 

  1418.                     if (($source_data_array['track_adjustment'] > 51) || ($source_data_array['track_adjustment'] < - 51))

    1419. 

  1419.                     {

    1420. 

  1420.                         $this->errors[] = 'Invalid Track Adjustment in ' . $frame_name . ' (' . $source_data_array['track_adjustment'] . ') (range = -51.0 to +51.0)';

    1421. 

  1421.                     }

    1422. 

  1422.                     elseif (($source_data_array['album_adjustment'] > 51) || ($source_data_array['album_adjustment'] < - 51))

    1423. 

  1423.                     {

    1424. 

  1424.                         $this->errors[] = 'Invalid Album Adjustment in ' . $frame_name . ' (' . $source_data_array['album_adjustment'] . ') (range = -51.0 to +51.0)';

    1425. 

  1425.                     }

    1426. 

  1426.                     elseif (! $this->ID3v2IsValidRGADname($source_data_array['raw']['track_name']))

    1427. 

  1427.                     {

    1428. 

  1428.                         $this->errors[] = 'Invalid Track Name Code in ' . $frame_name . ' (' . $source_data_array['raw']['track_name'] . ') (range = 0 to 2)';

    1429. 

  1429.                     }

    1430. 

  1430.                     elseif (! $this->ID3v2IsValidRGADname($source_data_array['raw']['album_name']))

    1431. 

  1431.                     {

    1432. 

  1432.                         $this->errors[] = 'Invalid Album Name Code in ' . $frame_name . ' (' . $source_data_array['raw']['album_name'] . ') (range = 0 to 2)';

    1433. 

  1433.                     }

    1434. 

  1434.                     elseif (! $this->ID3v2IsValidRGADoriginator($source_data_array['raw']['track_originator']))

    1435. 

  1435.                     {

    1436. 

  1436.                         $this->errors[] = 'Invalid Track Originator Code in ' . $frame_name . ' (' . $source_data_array['raw']['track_originator'] . ') (range = 0 to 3)';

    1437. 

  1437.                     }

    1438. 

  1438.                     elseif (! $this->ID3v2IsValidRGADoriginator($source_data_array['raw']['album_originator']))

    1439. 

  1439.                     {

    1440. 

  1440.                         $this->errors[] = 'Invalid Album Originator Code in ' . $frame_name . ' (' . $source_data_array['raw']['album_originator'] . ') (range = 0 to 3)';

    1441. 

  1441.                     }

    1442. 

  1442.                     else

    1443. 

  1443.                     {

    1444. 

  1444.                         $framedata .= getid3_lib :: Float2String($source_data_array['peakamplitude'], 32);

    1445. 

  1445.                         $framedata .= getid3_lib :: RGADgainString($source_data_array['raw']['track_name'], $source_data_array['raw']['track_originator'], $source_data_array['track_adjustment']);

    1446. 

  1446.                         $framedata .= getid3_lib :: RGADgainString($source_data_array['raw']['album_name'], $source_data_array['raw']['album_originator'], $source_data_array['album_adjustment']);

    1447. 

  1447.                     }

    1448. 

  1448.                     break;

    1449. 

  1449.                 

    1450. 

  1450.                 default :

    1451. 

  1451.                     if ($frame_name{0} == 'T')

    1452. 

  1452.                     {

    1453. 

  1453.                         // 4.2. T???  Text information frames
    1454. 

  1454.                         // Text encoding                $xx
    1455. 

  1455.                         // Information                  <text string(s) according to encoding>
    1456. 

  1456.                         $source_data_array['encodingid'] = (isset($source_data_array['encodingid']) ? $source_data_array['encodingid'] : $this->id3v2_default_encodingid);

    1457. 

  1457.                         if (! $this->ID3v2IsValidTextEncoding($source_data_array['encodingid']))

    1458. 

  1458.                         {

    1459. 

  1459.                             $this->errors[] = 'Invalid Text Encoding in ' . $frame_name . ' (' . $source_data_array['encodingid'] . ') for ID3v2.' . $this->majorversion;

    1460. 

  1460.                         }

    1461. 

  1461.                         else

    1462. 

  1462.                         {

    1463. 

  1463.                             $framedata .= chr($source_data_array['encodingid']);

    1464. 

  1464.                             $framedata .= $source_data_array['data'];

    1465. 

  1465.                         }

    1466. 

  1466.                     }

    1467. 

  1467.                     elseif ($frame_name{0} == 'W')

    1468. 

  1468.                     {

    1469. 

  1469.                         // 4.3. W???  URL link frames
    1470. 

  1470.                         // URL              <text string>
    1471. 

  1471.                         if (! $this->IsValidURL($source_data_array['data'], false, false))

    1472. 

  1472.                         {

    1473. 

  1473.                             //$this->errors[] = 'Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')';
    1474. 

  1474.                             // probably should be an error, need to rewrite IsValidURL() to handle other encodings
    1475. 

  1475.                             $this->warnings[] = 'Invalid URL in ' . $frame_name . ' (' . $source_data_array['data'] . ')';

    1476. 

  1476.                         }

    1477. 

  1477.                         else

    1478. 

  1478.                         {

    1479. 

  1479.                             $framedata .= $source_data_array['data'];

    1480. 

  1480.                         }

    1481. 

  1481.                     }

    1482. 

  1482.                     else

    1483. 

  1483.                     {

    1484. 

  1484.                         $this->errors[] = $frame_name . ' not yet supported in $this->GenerateID3v2FrameData()';

    1485. 

  1485.                     }

    1486. 

  1486.                     break;

    1487. 

  1487.             }

    1488. 

  1488.         }

    1489. 

  1489.         if (! empty($this->errors))

    1490. 

  1490.         {

    1491. 

  1491.             return false;

    1492. 

  1492.         }

    1493. 

  1493.         return $framedata;

    1494. 

  1494.     }

    1495. 

  1495. 

    1496. 

  1496.     function ID3v2FrameIsAllowed($frame_name, $source_data_array)

    1497. 

  1497.     {

    1498. 

  1498.         static $PreviousFrames = array();

    1499. 

  1499.         

    1500. 

  1500.         if ($frame_name === null)

    1501. 

  1501.         {

    1502. 

  1502.             // if the writing functions are called multiple times, the static array needs to be
    1503. 

  1503.             // cleared - this can be done by calling $this->ID3v2FrameIsAllowed(null, '')
    1504. 

  1504.             $PreviousFrames = array();

    1505. 

  1505.             return true;

    1506. 

  1506.         }

    1507. 

  1507.         

    1508. 

  1508.         if ($this->majorversion == 4)

    1509. 

  1509.         {

    1510. 

  1510.             switch ($frame_name)

    1511. 

  1511.             {

    1512. 

  1512.                 case 'UFID' :

    1513. 

  1513.                 case 'AENC' :

    1514. 

  1514.                 case 'ENCR' :

    1515. 

  1515.                 case 'GRID' :

    1516. 

  1516.                     if (! isset($source_data_array['ownerid']))

    1517. 

  1517.                     {

    1518. 

  1518.                         $this->errors[] = '[ownerid] not specified for ' . $frame_name;

    1519. 

  1519.                     }

    1520. 

  1520.                     elseif (in_array($frame_name . $source_data_array['ownerid'], $PreviousFrames))

    1521. 

  1521.                     {

    1522. 

  1522.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same OwnerID (' . $source_data_array['ownerid'] . ')';

    1523. 

  1523.                     }

    1524. 

  1524.                     else

    1525. 

  1525.                     {

    1526. 

  1526.                         $PreviousFrames[] = $frame_name . $source_data_array['ownerid'];

    1527. 

  1527.                     }

    1528. 

  1528.                     break;

    1529. 

  1529.                 

    1530. 

  1530.                 case 'TXXX' :

    1531. 

  1531.                 case 'WXXX' :

    1532. 

  1532.                 case 'RVA2' :

    1533. 

  1533.                 case 'EQU2' :

    1534. 

  1534.                 case 'APIC' :

    1535. 

  1535.                 case 'GEOB' :

    1536. 

  1536.                     if (! isset($source_data_array['description']))

    1537. 

  1537.                     {

    1538. 

  1538.                         $this->errors[] = '[description] not specified for ' . $frame_name;

    1539. 

  1539.                     }

    1540. 

  1540.                     elseif (in_array($frame_name . $source_data_array['description'], $PreviousFrames))

    1541. 

  1541.                     {

    1542. 

  1542.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Description (' . $source_data_array['description'] . ')';

    1543. 

  1543.                     }

    1544. 

  1544.                     else

    1545. 

  1545.                     {

    1546. 

  1546.                         $PreviousFrames[] = $frame_name . $source_data_array['description'];

    1547. 

  1547.                     }

    1548. 

  1548.                     break;

    1549. 

  1549.                 

    1550. 

  1550.                 case 'USER' :

    1551. 

  1551.                     if (! isset($source_data_array['language']))

    1552. 

  1552.                     {

    1553. 

  1553.                         $this->errors[] = '[language] not specified for ' . $frame_name;

    1554. 

  1554.                     }

    1555. 

  1555.                     elseif (in_array($frame_name . $source_data_array['language'], $PreviousFrames))

    1556. 

  1556.                     {

    1557. 

  1557.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Language (' . $source_data_array['language'] . ')';

    1558. 

  1558.                     }

    1559. 

  1559.                     else

    1560. 

  1560.                     {

    1561. 

  1561.                         $PreviousFrames[] = $frame_name . $source_data_array['language'];

    1562. 

  1562.                     }

    1563. 

  1563.                     break;

    1564. 

  1564.                 

    1565. 

  1565.                 case 'USLT' :

    1566. 

  1566.                 case 'SYLT' :

    1567. 

  1567.                 case 'COMM' :

    1568. 

  1568.                     if (! isset($source_data_array['language']))

    1569. 

  1569.                     {

    1570. 

  1570.                         $this->errors[] = '[language] not specified for ' . $frame_name;

    1571. 

  1571.                     }

    1572. 

  1572.                     elseif (! isset($source_data_array['description']))

    1573. 

  1573.                     {

    1574. 

  1574.                         $this->errors[] = '[description] not specified for ' . $frame_name;

    1575. 

  1575.                     }

    1576. 

  1576.                     elseif (in_array($frame_name . $source_data_array['language'] . $source_data_array['description'], $PreviousFrames))

    1577. 

  1577.                     {

    1578. 

  1578.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Language + Description (' . $source_data_array['language'] . ' + ' . $source_data_array['description'] . ')';

    1579. 

  1579.                     }

    1580. 

  1580.                     else

    1581. 

  1581.                     {

    1582. 

  1582.                         $PreviousFrames[] = $frame_name . $source_data_array['language'] . $source_data_array['description'];

    1583. 

  1583.                     }

    1584. 

  1584.                     break;

    1585. 

  1585.                 

    1586. 

  1586.                 case 'POPM' :

    1587. 

  1587.                     if (! isset($source_data_array['email']))

    1588. 

  1588.                     {

    1589. 

  1589.                         $this->errors[] = '[email] not specified for ' . $frame_name;

    1590. 

  1590.                     }

    1591. 

  1591.                     elseif (in_array($frame_name . $source_data_array['email'], $PreviousFrames))

    1592. 

  1592.                     {

    1593. 

  1593.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Email (' . $source_data_array['email'] . ')';

    1594. 

  1594.                     }

    1595. 

  1595.                     else

    1596. 

  1596.                     {

    1597. 

  1597.                         $PreviousFrames[] = $frame_name . $source_data_array['email'];

    1598. 

  1598.                     }

    1599. 

  1599.                     break;

    1600. 

  1600.                 

    1601. 

  1601.                 case 'IPLS' :

    1602. 

  1602.                 case 'MCDI' :

    1603. 

  1603.                 case 'ETCO' :

    1604. 

  1604.                 case 'MLLT' :

    1605. 

  1605.                 case 'SYTC' :

    1606. 

  1606.                 case 'RVRB' :

    1607. 

  1607.                 case 'PCNT' :

    1608. 

  1608.                 case 'RBUF' :

    1609. 

  1609.                 case 'POSS' :

    1610. 

  1610.                 case 'OWNE' :

    1611. 

  1611.                 case 'SEEK' :

    1612. 

  1612.                 case 'ASPI' :

    1613. 

  1613.                 case 'RGAD' :

    1614. 

  1614.                     if (in_array($frame_name, $PreviousFrames))

    1615. 

  1615.                     {

    1616. 

  1616.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed';

    1617. 

  1617.                     }

    1618. 

  1618.                     else

    1619. 

  1619.                     {

    1620. 

  1620.                         $PreviousFrames[] = $frame_name;

    1621. 

  1621.                     }

    1622. 

  1622.                     break;

    1623. 

  1623.                 

    1624. 

  1624.                 case 'LINK' :

    1625. 

  1625.                     // this isn't implemented quite right (yet) - it should check the target frame data for compliance
    1626. 

  1626.                     // but right now it just allows one linked frame of each type, to be safe.
    1627. 

  1627.                     if (! isset($source_data_array['frameid']))

    1628. 

  1628.                     {

    1629. 

  1629.                         $this->errors[] = '[frameid] not specified for ' . $frame_name;

    1630. 

  1630.                     }

    1631. 

  1631.                     elseif (in_array($frame_name . $source_data_array['frameid'], $PreviousFrames))

    1632. 

  1632.                     {

    1633. 

  1633.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same FrameID (' . $source_data_array['frameid'] . ')';

    1634. 

  1634.                     }

    1635. 

  1635.                     elseif (in_array($source_data_array['frameid'], $PreviousFrames))

    1636. 

  1636.                     {

    1637. 

  1637.                         // no links to singleton tags
    1638. 

  1638.                         $this->errors[] = 'Cannot specify a ' . $frame_name . ' tag to a singleton tag that already exists (' . $source_data_array['frameid'] . ')';

    1639. 

  1639.                     }

    1640. 

  1640.                     else

    1641. 

  1641.                     {

    1642. 

  1642.                         $PreviousFrames[] = $frame_name . $source_data_array['frameid']; // only one linked tag of this type
    1643. 

  1643.                         $PreviousFrames[] = $source_data_array['frameid']; // no non-linked singleton tags of this type
    1644. 

  1644.                     }

    1645. 

  1645.                     break;

    1646. 

  1646.                 

    1647. 

  1647.                 case 'COMR' :

    1648. 

  1648.                     //   There may be more than one 'commercial frame' in a tag, but no two may be identical
    1649. 

  1649.                     // Checking isn't implemented at all (yet) - just assumes that it's OK.
    1650. 

  1650.                     break;

    1651. 

  1651.                 

    1652. 

  1652.                 case 'PRIV' :

    1653. 

  1653.                 case 'SIGN' :

    1654. 

  1654.                     if (! isset($source_data_array['ownerid']))

    1655. 

  1655.                     {

    1656. 

  1656.                         $this->errors[] = '[ownerid] not specified for ' . $frame_name;

    1657. 

  1657.                     }

    1658. 

  1658.                     elseif (! isset($source_data_array['data']))

    1659. 

  1659.                     {

    1660. 

  1660.                         $this->errors[] = '[data] not specified for ' . $frame_name;

    1661. 

  1661.                     }

    1662. 

  1662.                     elseif (in_array($frame_name . $source_data_array['ownerid'] . $source_data_array['data'], $PreviousFrames))

    1663. 

  1663.                     {

    1664. 

  1664.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same OwnerID + Data (' . $source_data_array['ownerid'] . ' + ' . $source_data_array['data'] . ')';

    1665. 

  1665.                     }

    1666. 

  1666.                     else

    1667. 

  1667.                     {

    1668. 

  1668.                         $PreviousFrames[] = $frame_name . $source_data_array['ownerid'] . $source_data_array['data'];

    1669. 

  1669.                     }

    1670. 

  1670.                     break;

    1671. 

  1671.                 

    1672. 

  1672.                 default :

    1673. 

  1673.                     if (($frame_name{0} != 'T') && ($frame_name{0} != 'W'))

    1674. 

  1674.                     {

    1675. 

  1675.                         $this->errors[] = 'Frame not allowed in ID3v2.' . $this->majorversion . ': ' . $frame_name;

    1676. 

  1676.                     }

    1677. 

  1677.                     break;

    1678. 

  1678.             }

    1679. 

  1679.         

    1680. 

  1680.         }

    1681. 

  1681.         elseif ($this->majorversion == 3)

    1682. 

  1682.         {

    1683. 

  1683.             

    1684. 

  1684.             switch ($frame_name)

    1685. 

  1685.             {

    1686. 

  1686.                 case 'UFID' :

    1687. 

  1687.                 case 'AENC' :

    1688. 

  1688.                 case 'ENCR' :

    1689. 

  1689.                 case 'GRID' :

    1690. 

  1690.                     if (! isset($source_data_array['ownerid']))

    1691. 

  1691.                     {

    1692. 

  1692.                         $this->errors[] = '[ownerid] not specified for ' . $frame_name;

    1693. 

  1693.                     }

    1694. 

  1694.                     elseif (in_array($frame_name . $source_data_array['ownerid'], $PreviousFrames))

    1695. 

  1695.                     {

    1696. 

  1696.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same OwnerID (' . $source_data_array['ownerid'] . ')';

    1697. 

  1697.                     }

    1698. 

  1698.                     else

    1699. 

  1699.                     {

    1700. 

  1700.                         $PreviousFrames[] = $frame_name . $source_data_array['ownerid'];

    1701. 

  1701.                     }

    1702. 

  1702.                     break;

    1703. 

  1703.                 

    1704. 

  1704.                 case 'TXXX' :

    1705. 

  1705.                 case 'WXXX' :

    1706. 

  1706.                 case 'APIC' :

    1707. 

  1707.                 case 'GEOB' :

    1708. 

  1708.                     if (! isset($source_data_array['description']))

    1709. 

  1709.                     {

    1710. 

  1710.                         $this->errors[] = '[description] not specified for ' . $frame_name;

    1711. 

  1711.                     }

    1712. 

  1712.                     elseif (in_array($frame_name . $source_data_array['description'], $PreviousFrames))

    1713. 

  1713.                     {

    1714. 

  1714.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Description (' . $source_data_array['description'] . ')';

    1715. 

  1715.                     }

    1716. 

  1716.                     else

    1717. 

  1717.                     {

    1718. 

  1718.                         $PreviousFrames[] = $frame_name . $source_data_array['description'];

    1719. 

  1719.                     }

    1720. 

  1720.                     break;

    1721. 

  1721.                 

    1722. 

  1722.                 case 'USER' :

    1723. 

  1723.                     if (! isset($source_data_array['language']))

    1724. 

  1724.                     {

    1725. 

  1725.                         $this->errors[] = '[language] not specified for ' . $frame_name;

    1726. 

  1726.                     }

    1727. 

  1727.                     elseif (in_array($frame_name . $source_data_array['language'], $PreviousFrames))

    1728. 

  1728.                     {

    1729. 

  1729.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Language (' . $source_data_array['language'] . ')';

    1730. 

  1730.                     }

    1731. 

  1731.                     else

    1732. 

  1732.                     {

    1733. 

  1733.                         $PreviousFrames[] = $frame_name . $source_data_array['language'];

    1734. 

  1734.                     }

    1735. 

  1735.                     break;

    1736. 

  1736.                 

    1737. 

  1737.                 case 'USLT' :

    1738. 

  1738.                 case 'SYLT' :

    1739. 

  1739.                 case 'COMM' :

    1740. 

  1740.                     if (! isset($source_data_array['language']))

    1741. 

  1741.                     {

    1742. 

  1742.                         $this->errors[] = '[language] not specified for ' . $frame_name;

    1743. 

  1743.                     }

    1744. 

  1744.                     elseif (! isset($source_data_array['description']))

    1745. 

  1745.                     {

    1746. 

  1746.                         $this->errors[] = '[description] not specified for ' . $frame_name;

    1747. 

  1747.                     }

    1748. 

  1748.                     elseif (in_array($frame_name . $source_data_array['language'] . $source_data_array['description'], $PreviousFrames))

    1749. 

  1749.                     {

    1750. 

  1750.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Language + Description (' . $source_data_array['language'] . ' + ' . $source_data_array['description'] . ')';

    1751. 

  1751.                     }

    1752. 

  1752.                     else

    1753. 

  1753.                     {

    1754. 

  1754.                         $PreviousFrames[] = $frame_name . $source_data_array['language'] . $source_data_array['description'];

    1755. 

  1755.                     }

    1756. 

  1756.                     break;

    1757. 

  1757.                 

    1758. 

  1758.                 case 'POPM' :

    1759. 

  1759.                     if (! isset($source_data_array['email']))

    1760. 

  1760.                     {

    1761. 

  1761.                         $this->errors[] = '[email] not specified for ' . $frame_name;

    1762. 

  1762.                     }

    1763. 

  1763.                     elseif (in_array($frame_name . $source_data_array['email'], $PreviousFrames))

    1764. 

  1764.                     {

    1765. 

  1765.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Email (' . $source_data_array['email'] . ')';

    1766. 

  1766.                     }

    1767. 

  1767.                     else

    1768. 

  1768.                     {

    1769. 

  1769.                         $PreviousFrames[] = $frame_name . $source_data_array['email'];

    1770. 

  1770.                     }

    1771. 

  1771.                     break;

    1772. 

  1772.                 

    1773. 

  1773.                 case 'IPLS' :

    1774. 

  1774.                 case 'MCDI' :

    1775. 

  1775.                 case 'ETCO' :

    1776. 

  1776.                 case 'MLLT' :

    1777. 

  1777.                 case 'SYTC' :

    1778. 

  1778.                 case 'RVAD' :

    1779. 

  1779.                 case 'EQUA' :

    1780. 

  1780.                 case 'RVRB' :

    1781. 

  1781.                 case 'PCNT' :

    1782. 

  1782.                 case 'RBUF' :

    1783. 

  1783.                 case 'POSS' :

    1784. 

  1784.                 case 'OWNE' :

    1785. 

  1785.                 case 'RGAD' :

    1786. 

  1786.                     if (in_array($frame_name, $PreviousFrames))

    1787. 

  1787.                     {

    1788. 

  1788.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed';

    1789. 

  1789.                     }

    1790. 

  1790.                     else

    1791. 

  1791.                     {

    1792. 

  1792.                         $PreviousFrames[] = $frame_name;

    1793. 

  1793.                     }

    1794. 

  1794.                     break;

    1795. 

  1795.                 

    1796. 

  1796.                 case 'LINK' :

    1797. 

  1797.                     // this isn't implemented quite right (yet) - it should check the target frame data for compliance
    1798. 

  1798.                     // but right now it just allows one linked frame of each type, to be safe.
    1799. 

  1799.                     if (! isset($source_data_array['frameid']))

    1800. 

  1800.                     {

    1801. 

  1801.                         $this->errors[] = '[frameid] not specified for ' . $frame_name;

    1802. 

  1802.                     }

    1803. 

  1803.                     elseif (in_array($frame_name . $source_data_array['frameid'], $PreviousFrames))

    1804. 

  1804.                     {

    1805. 

  1805.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same FrameID (' . $source_data_array['frameid'] . ')';

    1806. 

  1806.                     }

    1807. 

  1807.                     elseif (in_array($source_data_array['frameid'], $PreviousFrames))

    1808. 

  1808.                     {

    1809. 

  1809.                         // no links to singleton tags
    1810. 

  1810.                         $this->errors[] = 'Cannot specify a ' . $frame_name . ' tag to a singleton tag that already exists (' . $source_data_array['frameid'] . ')';

    1811. 

  1811.                     }

    1812. 

  1812.                     else

    1813. 

  1813.                     {

    1814. 

  1814.                         $PreviousFrames[] = $frame_name . $source_data_array['frameid']; // only one linked tag of this type
    1815. 

  1815.                         $PreviousFrames[] = $source_data_array['frameid']; // no non-linked singleton tags of this type
    1816. 

  1816.                     }

    1817. 

  1817.                     break;

    1818. 

  1818.                 

    1819. 

  1819.                 case 'COMR' :

    1820. 

  1820.                     //   There may be more than one 'commercial frame' in a tag, but no two may be identical
    1821. 

  1821.                     // Checking isn't implemented at all (yet) - just assumes that it's OK.
    1822. 

  1822.                     break;

    1823. 

  1823.                 

    1824. 

  1824.                 case 'PRIV' :

    1825. 

  1825.                     if (! isset($source_data_array['ownerid']))

    1826. 

  1826.                     {

    1827. 

  1827.                         $this->errors[] = '[ownerid] not specified for ' . $frame_name;

    1828. 

  1828.                     }

    1829. 

  1829.                     elseif (! isset($source_data_array['data']))

    1830. 

  1830.                     {

    1831. 

  1831.                         $this->errors[] = '[data] not specified for ' . $frame_name;

    1832. 

  1832.                     }

    1833. 

  1833.                     elseif (in_array($frame_name . $source_data_array['ownerid'] . $source_data_array['data'], $PreviousFrames))

    1834. 

  1834.                     {

    1835. 

  1835.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same OwnerID + Data (' . $source_data_array['ownerid'] . ' + ' . $source_data_array['data'] . ')';

    1836. 

  1836.                     }

    1837. 

  1837.                     else

    1838. 

  1838.                     {

    1839. 

  1839.                         $PreviousFrames[] = $frame_name . $source_data_array['ownerid'] . $source_data_array['data'];

    1840. 

  1840.                     }

    1841. 

  1841.                     break;

    1842. 

  1842.                 

    1843. 

  1843.                 default :

    1844. 

  1844.                     if (($frame_name{0} != 'T') && ($frame_name{0} != 'W'))

    1845. 

  1845.                     {

    1846. 

  1846.                         $this->errors[] = 'Frame not allowed in ID3v2.' . $this->majorversion . ': ' . $frame_name;

    1847. 

  1847.                     }

    1848. 

  1848.                     break;

    1849. 

  1849.             }

    1850. 

  1850.         

    1851. 

  1851.         }

    1852. 

  1852.         elseif ($this->majorversion == 2)

    1853. 

  1853.         {

    1854. 

  1854.             

    1855. 

  1855.             switch ($frame_name)

    1856. 

  1856.             {

    1857. 

  1857.                 case 'UFI' :

    1858. 

  1858.                 case 'CRM' :

    1859. 

  1859.                 case 'CRA' :

    1860. 

  1860.                     if (! isset($source_data_array['ownerid']))

    1861. 

  1861.                     {

    1862. 

  1862.                         $this->errors[] = '[ownerid] not specified for ' . $frame_name;

    1863. 

  1863.                     }

    1864. 

  1864.                     elseif (in_array($frame_name . $source_data_array['ownerid'], $PreviousFrames))

    1865. 

  1865.                     {

    1866. 

  1866.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same OwnerID (' . $source_data_array['ownerid'] . ')';

    1867. 

  1867.                     }

    1868. 

  1868.                     else

    1869. 

  1869.                     {

    1870. 

  1870.                         $PreviousFrames[] = $frame_name . $source_data_array['ownerid'];

    1871. 

  1871.                     }

    1872. 

  1872.                     break;

    1873. 

  1873.                 

    1874. 

  1874.                 case 'TXX' :

    1875. 

  1875.                 case 'WXX' :

    1876. 

  1876.                 case 'PIC' :

    1877. 

  1877.                 case 'GEO' :

    1878. 

  1878.                     if (! isset($source_data_array['description']))

    1879. 

  1879.                     {

    1880. 

  1880.                         $this->errors[] = '[description] not specified for ' . $frame_name;

    1881. 

  1881.                     }

    1882. 

  1882.                     elseif (in_array($frame_name . $source_data_array['description'], $PreviousFrames))

    1883. 

  1883.                     {

    1884. 

  1884.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Description (' . $source_data_array['description'] . ')';

    1885. 

  1885.                     }

    1886. 

  1886.                     else

    1887. 

  1887.                     {

    1888. 

  1888.                         $PreviousFrames[] = $frame_name . $source_data_array['description'];

    1889. 

  1889.                     }

    1890. 

  1890.                     break;

    1891. 

  1891.                 

    1892. 

  1892.                 case 'ULT' :

    1893. 

  1893.                 case 'SLT' :

    1894. 

  1894.                 case 'COM' :

    1895. 

  1895.                     if (! isset($source_data_array['language']))

    1896. 

  1896.                     {

    1897. 

  1897.                         $this->errors[] = '[language] not specified for ' . $frame_name;

    1898. 

  1898.                     }

    1899. 

  1899.                     elseif (! isset($source_data_array['description']))

    1900. 

  1900.                     {

    1901. 

  1901.                         $this->errors[] = '[description] not specified for ' . $frame_name;

    1902. 

  1902.                     }

    1903. 

  1903.                     elseif (in_array($frame_name . $source_data_array['language'] . $source_data_array['description'], $PreviousFrames))

    1904. 

  1904.                     {

    1905. 

  1905.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Language + Description (' . $source_data_array['language'] . ' + ' . $source_data_array['description'] . ')';

    1906. 

  1906.                     }

    1907. 

  1907.                     else

    1908. 

  1908.                     {

    1909. 

  1909.                         $PreviousFrames[] = $frame_name . $source_data_array['language'] . $source_data_array['description'];

    1910. 

  1910.                     }

    1911. 

  1911.                     break;

    1912. 

  1912.                 

    1913. 

  1913.                 case 'POP' :

    1914. 

  1914.                     if (! isset($source_data_array['email']))

    1915. 

  1915.                     {

    1916. 

  1916.                         $this->errors[] = '[email] not specified for ' . $frame_name;

    1917. 

  1917.                     }

    1918. 

  1918.                     elseif (in_array($frame_name . $source_data_array['email'], $PreviousFrames))

    1919. 

  1919.                     {

    1920. 

  1920.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same Email (' . $source_data_array['email'] . ')';

    1921. 

  1921.                     }

    1922. 

  1922.                     else

    1923. 

  1923.                     {

    1924. 

  1924.                         $PreviousFrames[] = $frame_name . $source_data_array['email'];

    1925. 

  1925.                     }

    1926. 

  1926.                     break;

    1927. 

  1927.                 

    1928. 

  1928.                 case 'IPL' :

    1929. 

  1929.                 case 'MCI' :

    1930. 

  1930.                 case 'ETC' :

    1931. 

  1931.                 case 'MLL' :

    1932. 

  1932.                 case 'STC' :

    1933. 

  1933.                 case 'RVA' :

    1934. 

  1934.                 case 'EQU' :

    1935. 

  1935.                 case 'REV' :

    1936. 

  1936.                 case 'CNT' :

    1937. 

  1937.                 case 'BUF' :

    1938. 

  1938.                     if (in_array($frame_name, $PreviousFrames))

    1939. 

  1939.                     {

    1940. 

  1940.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed';

    1941. 

  1941.                     }

    1942. 

  1942.                     else

    1943. 

  1943.                     {

    1944. 

  1944.                         $PreviousFrames[] = $frame_name;

    1945. 

  1945.                     }

    1946. 

  1946.                     break;

    1947. 

  1947.                 

    1948. 

  1948.                 case 'LNK' :

    1949. 

  1949.                     // this isn't implemented quite right (yet) - it should check the target frame data for compliance
    1950. 

  1950.                     // but right now it just allows one linked frame of each type, to be safe.
    1951. 

  1951.                     if (! isset($source_data_array['frameid']))

    1952. 

  1952.                     {

    1953. 

  1953.                         $this->errors[] = '[frameid] not specified for ' . $frame_name;

    1954. 

  1954.                     }

    1955. 

  1955.                     elseif (in_array($frame_name . $source_data_array['frameid'], $PreviousFrames))

    1956. 

  1956.                     {

    1957. 

  1957.                         $this->errors[] = 'Only one ' . $frame_name . ' tag allowed with the same FrameID (' . $source_data_array['frameid'] . ')';

    1958. 

  1958.                     }

    1959. 

  1959.                     elseif (in_array($source_data_array['frameid'], $PreviousFrames))

    1960. 

  1960.                     {

    1961. 

  1961.                         // no links to singleton tags
    1962. 

  1962.                         $this->errors[] = 'Cannot specify a ' . $frame_name . ' tag to a singleton tag that already exists (' . $source_data_array['frameid'] . ')';

    1963. 

  1963.                     }

    1964. 

  1964.                     else

    1965. 

  1965.                     {

    1966. 

  1966.                         $PreviousFrames[] = $frame_name . $source_data_array['frameid']; // only one linked tag of this type
    1967. 

  1967.                         $PreviousFrames[] = $source_data_array['frameid']; // no non-linked singleton tags of this type
    1968. 

  1968.                     }

    1969. 

  1969.                     break;

    1970. 

  1970.                 

    1971. 

  1971.                 default :

    1972. 

  1972.                     if (($frame_name{0} != 'T') && ($frame_name{0} != 'W'))

    1973. 

  1973.                     {

    1974. 

  1974.                         $this->errors[] = 'Frame not allowed in ID3v2.' . $this->majorversion . ': ' . $frame_name;

    1975. 

  1975.                     }

    1976. 

  1976.                     break;

    1977. 

  1977.             }

    1978. 

  1978.         }

    1979. 

  1979.         

    1980. 

  1980.         if (! empty($this->errors))

    1981. 

  1981.         {

    1982. 

  1982.             return false;

    1983. 

  1983.         }

    1984. 

  1984.         return true;

    1985. 

  1985.     }

    1986. 

  1986. 

    1987. 

  1987.     function GenerateID3v2Tag($noerrorsonly = true)

    1988. 

  1988.     {

    1989. 

  1989.         $this->ID3v2FrameIsAllowed(null, ''); // clear static array in case this isn't the first call to $this->GenerateID3v2Tag()
    1990. 

  1990.         

    1991. 

  1991. 

    1992. 

  1992.         $tagstring = '';

    1993. 

  1993.         if (is_array($this->tag_data))

    1994. 

  1994.         {

    1995. 

  1995.             foreach ($this->tag_data as $frame_name => $frame_rawinputdata)

    1996. 

  1996.             {

    1997. 

  1997.                 foreach ($frame_rawinputdata as $irrelevantindex => $source_data_array)

    1998. 

  1998.                 {

    1999. 

  1999.                     if (getid3_id3v2 :: IsValidID3v2FrameName($frame_name, $this->majorversion))

    2000. 

  2000.                     {

    2001. 

  2001.                         unset($frame_length);

    2002. 

  2002.                         unset($frame_flags);

    2003. 

  2003.                         $frame_data = false;

    2004. 

  2004.                         if ($this->ID3v2FrameIsAllowed($frame_name, $source_data_array))

    2005. 

  2005.                         {

    2006. 

  2006.                             if ($frame_data = $this->GenerateID3v2FrameData($frame_name, $source_data_array))

    2007. 

  2007.                             {

    2008. 

  2008.                                 $FrameUnsynchronisation = false;

    2009. 

  2009.                                 if ($this->majorversion >= 4)

    2010. 

  2010.                                 {

    2011. 

  2011.                                     // frame-level unsynchronisation
    2012. 

  2012.                                     $unsynchdata = $frame_data;

    2013. 

  2013.                                     if ($this->id3v2_use_unsynchronisation)

    2014. 

  2014.                                     {

    2015. 

  2015.                                         $unsynchdata = $this->Unsynchronise($frame_data);

    2016. 

  2016.                                     }

    2017. 

  2017.                                     if (strlen($unsynchdata) != strlen($frame_data))

    2018. 

  2018.                                     {

    2019. 

  2019.                                         // unsynchronisation needed
    2020. 

  2020.                                         $FrameUnsynchronisation = true;

    2021. 

  2021.                                         $frame_data = $unsynchdata;

    2022. 

  2022.                                         if (isset($TagUnsynchronisation) && $TagUnsynchronisation === false)

    2023. 

  2023.                                         {

    2024. 

  2024.                                             // only set to true if ALL frames are unsynchronised
    2025. 

  2025.                                         }

    2026. 

  2026.                                         else

    2027. 

  2027.                                         {

    2028. 

  2028.                                             $TagUnsynchronisation = true;

    2029. 

  2029.                                         }

    2030. 

  2030.                                     }

    2031. 

  2031.                                     else

    2032. 

  2032.                                     {

    2033. 

  2033.                                         if (isset($TagUnsynchronisation))

    2034. 

  2034.                                         {

    2035. 

  2035.                                             $TagUnsynchronisation = false;

    2036. 

  2036.                                         }

    2037. 

  2037.                                     }

    2038. 

  2038.                                     unset($unsynchdata);

    2039. 

  2039.                                     

    2040. 

  2040.                                     $frame_length = getid3_lib :: BigEndian2String(strlen($frame_data), 4, true);

    2041. 

  2041.                                 }

    2042. 

  2042.                                 else

    2043. 

  2043.                                 {

    2044. 

  2044.                                     $frame_length = getid3_lib :: BigEndian2String(strlen($frame_data), 4, false);

    2045. 

  2045.                                 }

    2046. 

  2046.                                 $frame_flags = $this->GenerateID3v2FrameFlags($this->ID3v2FrameFlagsLookupTagAlter($frame_name), $this->ID3v2FrameFlagsLookupFileAlter($frame_name), false, false, false, false, $FrameUnsynchronisation, false);

    2047. 

  2047.                             }

    2048. 

  2048.                         }

    2049. 

  2049.                         else

    2050. 

  2050.                         {

    2051. 

  2051.                             $this->errors[] = 'Frame "' . $frame_name . '" is NOT allowed';

    2052. 

  2052.                         }

    2053. 

  2053.                         if ($frame_data === false)

    2054. 

  2054.                         {

    2055. 

  2055.                             $this->errors[] = '$this->GenerateID3v2FrameData() failed for "' . $frame_name . '"';

    2056. 

  2056.                             if ($noerrorsonly)

    2057. 

  2057.                             {

    2058. 

  2058.                                 return false;

    2059. 

  2059.                             }

    2060. 

  2060.                             else

    2061. 

  2061.                             {

    2062. 

  2062.                                 unset($frame_name);

    2063. 

  2063.                             }

    2064. 

  2064.                         }

    2065. 

  2065.                     }

    2066. 

  2066.                     else

    2067. 

  2067.                     {

    2068. 

  2068.                         // ignore any invalid frame names, including 'title', 'header', etc
    2069. 

  2069.                         $this->warnings[] = 'Ignoring invalid ID3v2 frame type: "' . $frame_name . '"';

    2070. 

  2070.                         unset($frame_name);

    2071. 

  2071.                         unset($frame_length);

    2072. 

  2072.                         unset($frame_flags);

    2073. 

  2073.                         unset($frame_data);

    2074. 

  2074.                     }

    2075. 

  2075.                     if (isset($frame_name) && isset($frame_length) && isset($frame_flags) && isset($frame_data))

    2076. 

  2076.                     {

    2077. 

  2077.                         $tagstring .= $frame_name . $frame_length . $frame_flags . $frame_data;

    2078. 

  2078.                     }

    2079. 

  2079.                 }

    2080. 

  2080.             }

    2081. 

  2081.             

    2082. 

  2082.             if (! isset($TagUnsynchronisation))

    2083. 

  2083.             {

    2084. 

  2084.                 $TagUnsynchronisation = false;

    2085. 

  2085.             }

    2086. 

  2086.             if (($this->majorversion <= 3) && $this->id3v2_use_unsynchronisation)

    2087. 

  2087.             {

    2088. 

  2088.                 // tag-level unsynchronisation
    2089. 

  2089.                 $unsynchdata = $this->Unsynchronise($tagstring);

    2090. 

  2090.                 if (strlen($unsynchdata) != strlen($tagstring))

    2091. 

  2091.                 {

    2092. 

  2092.                     // unsynchronisation needed
    2093. 

  2093.                     $TagUnsynchronisation = true;

    2094. 

  2094.                     $tagstring = $unsynchdata;

    2095. 

  2095.                 }

    2096. 

  2096.             }

    2097. 

  2097.             

    2098. 

  2098.             while ($this->paddedlength < (strlen($tagstring) + getid3_id3v2 :: ID3v2HeaderLength($this->majorversion)))

    2099. 

  2099.             {

    2100. 

  2100.                 $this->paddedlength += 1024;

    2101. 

  2101.             }

    2102. 

  2102.             

    2103. 

  2103.             $footer = false; // ID3v2 footers not yet supported in getID3()
    2104. 

  2104.             if (! $footer && ($this->paddedlength > (strlen($tagstring) + getid3_id3v2 :: ID3v2HeaderLength($this->majorversion))))

    2105. 

  2105.             {

    2106. 

  2106.                 // pad up to $paddedlength bytes if unpadded tag is shorter than $paddedlength
    2107. 

  2107.                 // "Furthermore it MUST NOT have any padding when a tag footer is added to the tag."
    2108. 

  2108.                 $tagstring .= @str_repeat("\x00", $this->paddedlength - strlen($tagstring) - getid3_id3v2 :: ID3v2HeaderLength($this->majorversion));

    2109. 

  2109.             }

    2110. 

  2110.             if ($this->id3v2_use_unsynchronisation && (substr($tagstring, strlen($tagstring) - 1, 1) == "\xFF"))

    2111. 

  2111.             {

    2112. 

  2112.                 // special unsynchronisation case:
    2113. 

  2113.                 // if last byte == $FF then appended a $00
    2114. 

  2114.                 $TagUnsynchronisation = true;

    2115. 

  2115.                 $tagstring .= "\x00";

    2116. 

  2116.             }

    2117. 

  2117.             

    2118. 

  2118.             $tagheader = 'ID3';

    2119. 

  2119.             $tagheader .= chr($this->majorversion);

    2120. 

  2120.             $tagheader .= chr($this->minorversion);

    2121. 

  2121.             $tagheader .= $this->GenerateID3v2TagFlags(array('unsynchronisation' => $TagUnsynchronisation));

    2122. 

  2122.             $tagheader .= getid3_lib :: BigEndian2String(strlen($tagstring), 4, true);

    2123. 

  2123.             

    2124. 

  2124.             return $tagheader . $tagstring;

    2125. 

  2125.         }

    2126. 

  2126.         $this->errors[] = 'tag_data is not an array in GenerateID3v2Tag()';

    2127. 

  2127.         return false;

    2128. 

  2128.     }

    2129. 

  2129. 

    2130. 

  2130.     function ID3v2IsValidPriceString($pricestring)

    2131. 

  2131.     {

    2132. 

  2132.         if (getid3_id3v2 :: LanguageLookup(substr($pricestring, 0, 3), true) == '')

    2133. 

  2133.         {

    2134. 

  2134.             return false;

    2135. 

  2135.         }

    2136. 

  2136.         elseif (! $this->IsANumber(substr($pricestring, 3), true))

    2137. 

  2137.         {

    2138. 

  2138.             return false;

    2139. 

  2139.         }

    2140. 

  2140.         return true;

    2141. 

  2141.     }

    2142. 

  2142. 

    2143. 

  2143.     function ID3v2FrameFlagsLookupTagAlter($framename)

    2144. 

  2144.     {

    2145. 

  2145.         // unfinished
    2146. 

  2146.         switch ($framename)

    2147. 

  2147.         {

    2148. 

  2148.             case 'RGAD' :

    2149. 

  2149.                 $allow = true;

    2150. 

  2150.             default :

    2151. 

  2151.                 $allow = false;

    2152. 

  2152.                 break;

    2153. 

  2153.         }

    2154. 

  2154.         return $allow;

    2155. 

  2155.     }

    2156. 

  2156. 

    2157. 

  2157.     function ID3v2FrameFlagsLookupFileAlter($framename)

    2158. 

  2158.     {

    2159. 

  2159.         // unfinished
    2160. 

  2160.         switch ($framename)

    2161. 

  2161.         {

    2162. 

  2162.             case 'RGAD' :

    2163. 

  2163.                 return false;

    2164. 

  2164.                 break;

    2165. 

  2165.             

    2166. 

  2166.             default :

    2167. 

  2167.                 return false;

    2168. 

  2168.                 break;

    2169. 

  2169.         }

    2170. 

  2170.     }

    2171. 

  2171. 

    2172. 

  2172.     function ID3v2IsValidETCOevent($eventid)

    2173. 

  2173.     {

    2174. 

  2174.         if (($eventid < 0) || ($eventid > 0xFF))

    2175. 

  2175.         {

    2176. 

  2176.             // outside range of 1 byte
    2177. 

  2177.             return false;

    2178. 

  2178.         }

    2179. 

  2179.         elseif (($eventid >= 0xF0) && ($eventid <= 0xFC))

    2180. 

  2180.         {

    2181. 

  2181.             // reserved for future use
    2182. 

  2182.             return false;

    2183. 

  2183.         }

    2184. 

  2184.         elseif (($eventid >= 0x17) && ($eventid <= 0xDF))

    2185. 

  2185.         {

    2186. 

  2186.             // reserved for future use
    2187. 

  2187.             return false;

    2188. 

  2188.         }

    2189. 

  2189.         elseif (($eventid >= 0x0E) && ($eventid <= 0x16) && ($this->majorversion == 2))

    2190. 

  2190.         {

    2191. 

  2191.             // not defined in ID3v2.2
    2192. 

  2192.             return false;

    2193. 

  2193.         }

    2194. 

  2194.         elseif (($eventid >= 0x15) && ($eventid <= 0x16) && ($this->majorversion == 3))

    2195. 

  2195.         {

    2196. 

  2196.             // not defined in ID3v2.3
    2197. 

  2197.             return false;

    2198. 

  2198.         }

    2199. 

  2199.         return true;

    2200. 

  2200.     }

    2201. 

  2201. 

    2202. 

  2202.     function ID3v2IsValidSYLTtype($contenttype)

    2203. 

  2203.     {

    2204. 

  2204.         if (($contenttype >= 0) && ($contenttype <= 8) && ($this->majorversion == 4))

    2205. 

  2205.         {

    2206. 

  2206.             return true;

    2207. 

  2207.         }

    2208. 

  2208.         elseif (($contenttype >= 0) && ($contenttype <= 6) && ($this->majorversion == 3))

    2209. 

  2209.         {

    2210. 

  2210.             return true;

    2211. 

  2211.         }

    2212. 

  2212.         return false;

    2213. 

  2213.     }

    2214. 

  2214. 

    2215. 

  2215.     function ID3v2IsValidRVA2channeltype($channeltype)

    2216. 

  2216.     {

    2217. 

  2217.         if (($channeltype >= 0) && ($channeltype <= 8) && ($this->majorversion == 4))

    2218. 

  2218.         {

    2219. 

  2219.             return true;

    2220. 

  2220.         }

    2221. 

  2221.         return false;

    2222. 

  2222.     }

    2223. 

  2223. 

    2224. 

  2224.     function ID3v2IsValidAPICpicturetype($picturetype)

    2225. 

  2225.     {

    2226. 

  2226.         if (($picturetype >= 0) && ($picturetype <= 0x14) && ($this->majorversion >= 2) && ($this->majorversion <= 4))

    2227. 

  2227.         {

    2228. 

  2228.             return true;

    2229. 

  2229.         }

    2230. 

  2230.         return false;

    2231. 

  2231.     }

    2232. 

  2232. 

    2233. 

  2233.     function ID3v2IsValidAPICimageformat($imageformat)

    2234. 

  2234.     {

    2235. 

  2235.         if ($imageformat == '-->')

    2236. 

  2236.         {

    2237. 

  2237.             return true;

    2238. 

  2238.         }

    2239. 

  2239.         elseif ($this->majorversion == 2)

    2240. 

  2240.         {

    2241. 

  2241.             if ((strlen($imageformat) == 3) && ($imageformat == strtoupper($imageformat)))

    2242. 

  2242.             {

    2243. 

  2243.                 return true;

    2244. 

  2244.             }

    2245. 

  2245.         }

    2246. 

  2246.         elseif (($this->majorversion == 3) || ($this->majorversion == 4))

    2247. 

  2247.         {

    2248. 

  2248.             if ($this->IsValidMIMEstring($imageformat))

    2249. 

  2249.             {

    2250. 

  2250.                 return true;

    2251. 

  2251.             }

    2252. 

  2252.         }

    2253. 

  2253.         return false;

    2254. 

  2254.     }

    2255. 

  2255. 

    2256. 

  2256.     function ID3v2IsValidCOMRreceivedAs($receivedas)

    2257. 

  2257.     {

    2258. 

  2258.         if (($this->majorversion >= 3) && ($receivedas >= 0) && ($receivedas <= 8))

    2259. 

  2259.         {

    2260. 

  2260.             return true;

    2261. 

  2261.         }

    2262. 

  2262.         return false;

    2263. 

  2263.     }

    2264. 

  2264. 

    2265. 

  2265.     function ID3v2IsValidRGADname($RGADname)

    2266. 

  2266.     {

    2267. 

  2267.         if (($RGADname >= 0) && ($RGADname <= 2))

    2268. 

  2268.         {

    2269. 

  2269.             return true;

    2270. 

  2270.         }

    2271. 

  2271.         return false;

    2272. 

  2272.     }

    2273. 

  2273. 

    2274. 

  2274.     function ID3v2IsValidRGADoriginator($RGADoriginator)

    2275. 

  2275.     {

    2276. 

  2276.         if (($RGADoriginator >= 0) && ($RGADoriginator <= 3))

    2277. 

  2277.         {

    2278. 

  2278.             return true;

    2279. 

  2279.         }

    2280. 

  2280.         return false;

    2281. 

  2281.     }

    2282. 

  2282. 

    2283. 

  2283.     function ID3v2IsValidTextEncoding($textencodingbyte)

    2284. 

  2284.     {

    2285. 

  2285.         static $ID3v2IsValidTextEncoding_cache = array(2 => array(true, true), 3 => array(true, true), 

    2286. 

  2286.                 4 => array(true, true, true, true));

    2287. 

  2287.         return isset($ID3v2IsValidTextEncoding_cache[$this->majorversion][$textencodingbyte]);

    2288. 

  2288.     }

    2289. 

  2289. 

    2290. 

  2290.     function Unsynchronise($data)

    2291. 

  2291.     {

    2292. 

  2292.         // Whenever a false synchronisation is found within the tag, one zeroed
    2293. 

  2293.         // byte is inserted after the first false synchronisation byte. The
    2294. 

  2294.         // format of a correct sync that should be altered by ID3 encoders is as
    2295. 

  2295.         // follows:
    2296. 

  2296.         //      %11111111 111xxxxx
    2297. 

  2297.         // And should be replaced with:
    2298. 

  2298.         //      %11111111 00000000 111xxxxx
    2299. 

  2299.         // This has the side effect that all $FF 00 combinations have to be
    2300. 

  2300.         // altered, so they won't be affected by the decoding process. Therefore
    2301. 

  2301.         // all the $FF 00 combinations have to be replaced with the $FF 00 00
    2302. 

  2302.         // combination during the unsynchronisation.
    2303. 

  2303.         

    2304. 

  2304. 

    2305. 

  2305.         $data = str_replace("\xFF\x00", "\xFF\x00\x00", $data);

    2306. 

  2306.         $unsyncheddata = '';

    2307. 

  2307.         $datalength = strlen($data);

    2308. 

  2308.         for($i = 0; $i < $datalength; $i ++)

    2309. 

  2309.         {

    2310. 

  2310.             $thischar = $data{$i};

    2311. 

  2311.             $unsyncheddata .= $thischar;

    2312. 

  2312.             if ($thischar == "\xFF")

    2313. 

  2313.             {

    2314. 

  2314.                 $nextchar = ord($data{$i + 1});

    2315. 

  2315.                 if (($nextchar & 0xE0) == 0xE0)

    2316. 

  2316.                 {

    2317. 

  2317.                     // previous byte = 11111111, this byte = 111?????
    2318. 

  2318.                     $unsyncheddata .= "\x00";

    2319. 

  2319.                 }

    2320. 

  2320.             }

    2321. 

  2321.         }

    2322. 

  2322.         return $unsyncheddata;

    2323. 

  2323.     }

    2324. 

  2324. 

    2325. 

  2325.     function is_hash($var)

    2326. 

  2326.     {

    2327. 

  2327.         // written by dev-null�christophe*vg
    2328. 

  2328.         // taken from http://www.php.net/manual/en/function.array-merge-recursive.php
    2329. 

  2329.         if (is_array($var))

    2330. 

  2330.         {

    2331. 

  2331.             $keys = array_keys($var);

    2332. 

  2332.             $all_num = true;

    2333. 

  2333.             for($i = 0; $i < count($keys); $i ++)

    2334. 

  2334.             {

    2335. 

  2335.                 if (is_string($keys[$i]))

    2336. 

  2336.                 {

    2337. 

  2337.                     return true;

    2338. 

  2338.                 }

    2339. 

  2339.             }

    2340. 

  2340.         }

    2341. 

  2341.         return false;

    2342. 

  2342.     }

    2343. 

  2343. 

    2344. 

  2344.     function array_join_merge($arr1, $arr2)

    2345. 

  2345.     {

    2346. 

  2346.         // written by dev-null�christophe*vg
    2347. 

  2347.         // taken from http://www.php.net/manual/en/function.array-merge-recursive.php
    2348. 

  2348.         if (is_array($arr1) && is_array($arr2))

    2349. 

  2349.         {

    2350. 

  2350.             // the same -> merge
    2351. 

  2351.             $new_array = array();

    2352. 

  2352.             

    2353. 

  2353.             if ($this->is_hash($arr1) && $this->is_hash($arr2))

    2354. 

  2354.             {

    2355. 

  2355.                 // hashes -> merge based on keys
    2356. 

  2356.                 $keys = array_merge(array_keys($arr1), array_keys($arr2));

    2357. 

  2357.                 foreach ($keys as $key)

    2358. 

  2358.                 {

    2359. 

  2359.                     $new_array[$key] = $this->array_join_merge(@$arr1[$key], @$arr2[$key]);

    2360. 

  2360.                 }

    2361. 

  2361.             }

    2362. 

  2362.             else

    2363. 

  2363.             {

    2364. 

  2364.                 // two real arrays -> merge
    2365. 

  2365.                 $new_array = array_reverse(array_unique(array_reverse(array_merge($arr1, $arr2))));

    2366. 

  2366.             }

    2367. 

  2367.             return $new_array;

    2368. 

  2368.         }

    2369. 

  2369.         else

    2370. 

  2370.         {

    2371. 

  2371.             // not the same ... take new one if defined, else the old one stays
    2372. 

  2372.             return $arr2 ? $arr2 : $arr1;

    2373. 

  2373.         }

    2374. 

  2374.     }

    2375. 

  2375. 

    2376. 

  2376.     function IsValidMIMEstring($mimestring)

    2377. 

  2377.     {

    2378. 

  2378.         if ((strlen($mimestring) >= 3) && (strpos($mimestring, '/') > 0) && (strpos($mimestring, '/') < (strlen($mimestring) - 1)))

    2379. 

  2379.         {

    2380. 

  2380.             return true;

    2381. 

  2381.         }

    2382. 

  2382.         return false;

    2383. 

  2383.     }

    2384. 

  2384. 

    2385. 

  2385.     function IsWithinBitRange($number, $maxbits, $signed = false)

    2386. 

  2386.     {

    2387. 

  2387.         if ($signed)

    2388. 

  2388.         {

    2389. 

  2389.             if (($number > (0 - pow(2, $maxbits - 1))) && ($number <= pow(2, $maxbits - 1)))

    2390. 

  2390.             {

    2391. 

  2391.                 return true;

    2392. 

  2392.             }

    2393. 

  2393.         }

    2394. 

  2394.         else

    2395. 

  2395.         {

    2396. 

  2396.             if (($number >= 0) && ($number <= pow(2, $maxbits)))

    2397. 

  2397.             {

    2398. 

  2398.                 return true;

    2399. 

  2399.             }

    2400. 

  2400.         }

    2401. 

  2401.         return false;

    2402. 

  2402.     }

    2403. 

  2403. 

    2404. 

  2404.     function safe_parse_url($url)

    2405. 

  2405.     {

    2406. 

  2406.         $parts = @parse_url($url);

    2407. 

  2407.         $parts['scheme'] = (isset($parts['scheme']) ? $parts['scheme'] : '');

    2408. 

  2408.         $parts['host'] = (isset($parts['host']) ? $parts['host'] : '');

    2409. 

  2409.         $parts['user'] = (isset($parts['user']) ? $parts['user'] : '');

    2410. 

  2410.         $parts['pass'] = (isset($parts['pass']) ? $parts['pass'] : '');

    2411. 

  2411.         $parts['path'] = (isset($parts['path']) ? $parts['path'] : '');

    2412. 

  2412.         $parts['query'] = (isset($parts['query']) ? $parts['query'] : '');

    2413. 

  2413.         return $parts;

    2414. 

  2414.     }

    2415. 

  2415. 

    2416. 

  2416.     function IsValidURL($url, $allowUserPass = false)

    2417. 

  2417.     {

    2418. 

  2418.         if ($url == '')

    2419. 

  2419.         {

    2420. 

  2420.             return false;

    2421. 

  2421.         }

    2422. 

  2422.         if ($allowUserPass !== true)

    2423. 

  2423.         {

    2424. 

  2424.             if (strstr($url, '@'))

    2425. 

  2425.             {

    2426. 

  2426.                 // in the format http://user:pass@example.com  or http://user@example.com
    2427. 

  2427.                 // but could easily be somebody incorrectly entering an email address in place of a URL
    2428. 

  2428.                 return false;

    2429. 

  2429.             }

    2430. 

  2430.         }

    2431. 

  2431.         if ($parts = $this->safe_parse_url($url))

    2432. 

  2432.         {

    2433. 

  2433.             if (($parts['scheme'] != 'http') && ($parts['scheme'] != 'https') && ($parts['scheme'] != 'ftp') && ($parts['scheme'] != 'gopher'))

    2434. 

  2434.             {

    2435. 

  2435.                 return false;

    2436. 

  2436.             }

    2437. 

  2437.             elseif (! eregi("^[[:alnum:]]([-.]?[0-9a-z])*\.[a-z]{2,3}$", $parts['host'], $regs) && ! IsValidDottedIP($parts['host']))

    2438. 

  2438.             {

    2439. 

  2439.                 return false;

    2440. 

  2440.             }

    2441. 

  2441.             elseif (! eregi("^([[:alnum:]-]|[\_])*$", $parts['user'], $regs))

    2442. 

  2442.             {

    2443. 

  2443.                 return false;

    2444. 

  2444.             }

    2445. 

  2445.             elseif (! eregi("^([[:alnum:]-]|[\_])*$", $parts['pass'], $regs))

    2446. 

  2446.             {

    2447. 

  2447.                 return false;

    2448. 

  2448.             }

    2449. 

  2449.             elseif (! eregi("^[[:alnum:]/_\.@~-]*$", $parts['path'], $regs))

    2450. 

  2450.             {

    2451. 

  2451.                 return false;

    2452. 

  2452.             }

    2453. 

  2453.             elseif (! eregi("^[[:alnum:]?&=+:;_()%#/,\.-]*$", $parts['query'], $regs))

    2454. 

  2454.             {

    2455. 

  2455.                 return false;

    2456. 

  2456.             }

    2457. 

  2457.             else

    2458. 

  2458.             {

    2459. 

  2459.                 return true;

    2460. 

  2460.             }

    2461. 

  2461.         }

    2462. 

  2462.         return false;

    2463. 

  2463.     }

    2464. 

  2464. 

    2465. 

  2465.     function ID3v2ShortFrameNameLookup($majorversion, $long_description)

    2466. 

  2466.     {

    2467. 

  2467.         $long_description = str_replace(' ', '_', strtolower(trim($long_description)));

    2468. 

  2468.         static $ID3v2ShortFrameNameLookup = array();

    2469. 

  2469.         if (empty($ID3v2ShortFrameNameLookup))

    2470. 

  2470.         {

    2471. 

  2471.             

    2472. 

  2472.             // The following are unique to ID3v2.2
    2473. 

  2473.             $ID3v2ShortFrameNameLookup[2]['comment'] = 'COM';

    2474. 

  2474.             $ID3v2ShortFrameNameLookup[2]['album'] = 'TAL';

    2475. 

  2475.             $ID3v2ShortFrameNameLookup[2]['beats_per_minute'] = 'TBP';

    2476. 

  2476.             $ID3v2ShortFrameNameLookup[2]['composer'] = 'TCM';

    2477. 

  2477.             $ID3v2ShortFrameNameLookup[2]['genre'] = 'TCO';

    2478. 

  2478.             $ID3v2ShortFrameNameLookup[2]['copyright'] = 'TCR';

    2479. 

  2479.             $ID3v2ShortFrameNameLookup[2]['encoded_by'] = 'TEN';

    2480. 

  2480.             $ID3v2ShortFrameNameLookup[2]['language'] = 'TLA';

    2481. 

  2481.             $ID3v2ShortFrameNameLookup[2]['length'] = 'TLE';

    2482. 

  2482.             $ID3v2ShortFrameNameLookup[2]['original_artist'] = 'TOA';

    2483. 

  2483.             $ID3v2ShortFrameNameLookup[2]['original_filename'] = 'TOF';

    2484. 

  2484.             $ID3v2ShortFrameNameLookup[2]['original_lyricist'] = 'TOL';

    2485. 

  2485.             $ID3v2ShortFrameNameLookup[2]['original_album_title'] = 'TOT';

    2486. 

  2486.             $ID3v2ShortFrameNameLookup[2]['artist'] = 'TP1';

    2487. 

  2487.             $ID3v2ShortFrameNameLookup[2]['band'] = 'TP2';

    2488. 

  2488.             $ID3v2ShortFrameNameLookup[2]['conductor'] = 'TP3';

    2489. 

  2489.             $ID3v2ShortFrameNameLookup[2]['remixer'] = 'TP4';

    2490. 

  2490.             $ID3v2ShortFrameNameLookup[2]['publisher'] = 'TPB';

    2491. 

  2491.             $ID3v2ShortFrameNameLookup[2]['isrc'] = 'TRC';

    2492. 

  2492.             $ID3v2ShortFrameNameLookup[2]['tracknumber'] = 'TRK';

    2493. 

  2493.             $ID3v2ShortFrameNameLookup[2]['size'] = 'TSI';

    2494. 

  2494.             $ID3v2ShortFrameNameLookup[2]['encoder_settings'] = 'TSS';

    2495. 

  2495.             $ID3v2ShortFrameNameLookup[2]['description'] = 'TT1';

    2496. 

  2496.             $ID3v2ShortFrameNameLookup[2]['title'] = 'TT2';

    2497. 

  2497.             $ID3v2ShortFrameNameLookup[2]['subtitle'] = 'TT3';

    2498. 

  2498.             $ID3v2ShortFrameNameLookup[2]['lyricist'] = 'TXT';

    2499. 

  2499.             $ID3v2ShortFrameNameLookup[2]['user_text'] = 'TXX';

    2500. 

  2500.             $ID3v2ShortFrameNameLookup[2]['year'] = 'TYE';

    2501. 

  2501.             $ID3v2ShortFrameNameLookup[2]['unique_file_identifier'] = 'UFI';

    2502. 

  2502.             $ID3v2ShortFrameNameLookup[2]['unsynchronised_lyrics'] = 'ULT';

    2503. 

  2503.             $ID3v2ShortFrameNameLookup[2]['url_file'] = 'WAF';

    2504. 

  2504.             $ID3v2ShortFrameNameLookup[2]['url_artist'] = 'WAR';

    2505. 

  2505.             $ID3v2ShortFrameNameLookup[2]['url_source'] = 'WAS';

    2506. 

  2506.             $ID3v2ShortFrameNameLookup[2]['copyright_information'] = 'WCP';

    2507. 

  2507.             $ID3v2ShortFrameNameLookup[2]['url_publisher'] = 'WPB';

    2508. 

  2508.             $ID3v2ShortFrameNameLookup[2]['url_user'] = 'WXX';

    2509. 

  2509.             

    2510. 

  2510.             // The following are common to ID3v2.3 and ID3v2.4
    2511. 

  2511.             $ID3v2ShortFrameNameLookup[3]['audio_encryption'] = 'AENC';

    2512. 

  2512.             $ID3v2ShortFrameNameLookup[3]['attached_picture'] = 'APIC';

    2513. 

  2513.             $ID3v2ShortFrameNameLookup[3]['comment'] = 'COMM';

    2514. 

  2514.             $ID3v2ShortFrameNameLookup[3]['commercial'] = 'COMR';

    2515. 

  2515.             $ID3v2ShortFrameNameLookup[3]['encryption_method_registration'] = 'ENCR';

    2516. 

  2516.             $ID3v2ShortFrameNameLookup[3]['event_timing_codes'] = 'ETCO';

    2517. 

  2517.             $ID3v2ShortFrameNameLookup[3]['general_encapsulated_object'] = 'GEOB';

    2518. 

  2518.             $ID3v2ShortFrameNameLookup[3]['group_identification_registration'] = 'GRID';

    2519. 

  2519.             $ID3v2ShortFrameNameLookup[3]['linked_information'] = 'LINK';

    2520. 

  2520.             $ID3v2ShortFrameNameLookup[3]['music_cd_identifier'] = 'MCDI';

    2521. 

  2521.             $ID3v2ShortFrameNameLookup[3]['mpeg_location_lookup_table'] = 'MLLT';

    2522. 

  2522.             $ID3v2ShortFrameNameLookup[3]['ownership'] = 'OWNE';

    2523. 

  2523.             $ID3v2ShortFrameNameLookup[3]['play_counter'] = 'PCNT';

    2524. 

  2524.             $ID3v2ShortFrameNameLookup[3]['popularimeter'] = 'POPM';

    2525. 

  2525.             $ID3v2ShortFrameNameLookup[3]['position_synchronisation'] = 'POSS';

    2526. 

  2526.             $ID3v2ShortFrameNameLookup[3]['private'] = 'PRIV';

    2527. 

  2527.             $ID3v2ShortFrameNameLookup[3]['recommended_buffer_size'] = 'RBUF';

    2528. 

  2528.             $ID3v2ShortFrameNameLookup[3]['reverb'] = 'RVRB';

    2529. 

  2529.             $ID3v2ShortFrameNameLookup[3]['synchronised_lyrics'] = 'SYLT';

    2530. 

  2530.             $ID3v2ShortFrameNameLookup[3]['synchronised_tempo_codes'] = 'SYTC';

    2531. 

  2531.             $ID3v2ShortFrameNameLookup[3]['album'] = 'TALB';

    2532. 

  2532.             $ID3v2ShortFrameNameLookup[3]['beats_per_minute'] = 'TBPM';

    2533. 

  2533.             $ID3v2ShortFrameNameLookup[3]['composer'] = 'TCOM';

    2534. 

  2534.             $ID3v2ShortFrameNameLookup[3]['genre'] = 'TCON';

    2535. 

  2535.             $ID3v2ShortFrameNameLookup[3]['copyright'] = 'TCOP';

    2536. 

  2536.             $ID3v2ShortFrameNameLookup[3]['playlist_delay'] = 'TDLY';

    2537. 

  2537.             $ID3v2ShortFrameNameLookup[3]['encoded_by'] = 'TENC';

    2538. 

  2538.             $ID3v2ShortFrameNameLookup[3]['lyricist'] = 'TEXT';

    2539. 

  2539.             $ID3v2ShortFrameNameLookup[3]['file_type'] = 'TFLT';

    2540. 

  2540.             $ID3v2ShortFrameNameLookup[3]['content_group_description'] = 'TIT1';

    2541. 

  2541.             $ID3v2ShortFrameNameLookup[3]['title'] = 'TIT2';

    2542. 

  2542.             $ID3v2ShortFrameNameLookup[3]['subtitle'] = 'TIT3';

    2543. 

  2543.             $ID3v2ShortFrameNameLookup[3]['initial_key'] = 'TKEY';

    2544. 

  2544.             $ID3v2ShortFrameNameLookup[3]['language'] = 'TLAN';

    2545. 

  2545.             $ID3v2ShortFrameNameLookup[3]['length'] = 'TLEN';

    2546. 

  2546.             $ID3v2ShortFrameNameLookup[3]['media_type'] = 'TMED';

    2547. 

  2547.             $ID3v2ShortFrameNameLookup[3]['original_album_title'] = 'TOAL';

    2548. 

  2548.             $ID3v2ShortFrameNameLookup[3]['original_filename'] = 'TOFN';

    2549. 

  2549.             $ID3v2ShortFrameNameLookup[3]['original_lyricist'] = 'TOLY';

    2550. 

  2550.             $ID3v2ShortFrameNameLookup[3]['original_artist'] = 'TOPE';

    2551. 

  2551.             $ID3v2ShortFrameNameLookup[3]['file_owner'] = 'TOWN';

    2552. 

  2552.             $ID3v2ShortFrameNameLookup[3]['artist'] = 'TPE1';

    2553. 

  2553.             $ID3v2ShortFrameNameLookup[3]['band'] = 'TPE2';

    2554. 

  2554.             $ID3v2ShortFrameNameLookup[3]['conductor'] = 'TPE3';

    2555. 

  2555.             $ID3v2ShortFrameNameLookup[3]['remixer'] = 'TPE4';

    2556. 

  2556.             $ID3v2ShortFrameNameLookup[3]['part_of_set'] = 'TPOS';

    2557. 

  2557.             $ID3v2ShortFrameNameLookup[3]['publisher'] = 'TPUB';

    2558. 

  2558.             $ID3v2ShortFrameNameLookup[3]['tracknumber'] = 'TRCK';

    2559. 

  2559.             $ID3v2ShortFrameNameLookup[3]['internet_radio_station_name'] = 'TRSN';

    2560. 

  2560.             $ID3v2ShortFrameNameLookup[3]['internet_radio_station_owner'] = 'TRSO';

    2561. 

  2561.             $ID3v2ShortFrameNameLookup[3]['isrc'] = 'TSRC';

    2562. 

  2562.             $ID3v2ShortFrameNameLookup[3]['encoder_settings'] = 'TSSE';

    2563. 

  2563.             $ID3v2ShortFrameNameLookup[3]['user_text'] = 'TXXX';

    2564. 

  2564.             $ID3v2ShortFrameNameLookup[3]['unique_file_identifier'] = 'UFID';

    2565. 

  2565.             $ID3v2ShortFrameNameLookup[3]['terms_of_use'] = 'USER';

    2566. 

  2566.             $ID3v2ShortFrameNameLookup[3]['unsynchronised_lyrics'] = 'USLT';

    2567. 

  2567.             $ID3v2ShortFrameNameLookup[3]['commercial'] = 'WCOM';

    2568. 

  2568.             $ID3v2ShortFrameNameLookup[3]['copyright_information'] = 'WCOP';

    2569. 

  2569.             $ID3v2ShortFrameNameLookup[3]['url_file'] = 'WOAF';

    2570. 

  2570.             $ID3v2ShortFrameNameLookup[3]['url_artist'] = 'WOAR';

    2571. 

  2571.             $ID3v2ShortFrameNameLookup[3]['url_source'] = 'WOAS';

    2572. 

  2572.             $ID3v2ShortFrameNameLookup[3]['url_station'] = 'WORS';

    2573. 

  2573.             $ID3v2ShortFrameNameLookup[3]['payment'] = 'WPAY';

    2574. 

  2574.             $ID3v2ShortFrameNameLookup[3]['url_publisher'] = 'WPUB';

    2575. 

  2575.             $ID3v2ShortFrameNameLookup[3]['url_user'] = 'WXXX';

    2576. 

  2576.             

    2577. 

  2577.             // The above are common to ID3v2.3 and ID3v2.4
    2578. 

  2578.             // so copy them to ID3v2.4 before adding specifics for 2.3 and 2.4
    2579. 

  2579.             $ID3v2ShortFrameNameLookup[4] = $ID3v2ShortFrameNameLookup[3];

    2580. 

  2580.             

    2581. 

  2581.             // The following are unique to ID3v2.3
    2582. 

  2582.             $ID3v2ShortFrameNameLookup[3]['equalisation'] = 'EQUA';

    2583. 

  2583.             $ID3v2ShortFrameNameLookup[3]['involved_people_list'] = 'IPLS';

    2584. 

  2584.             $ID3v2ShortFrameNameLookup[3]['relative_volume_adjustment'] = 'RVAD';

    2585. 

  2585.             $ID3v2ShortFrameNameLookup[3]['date'] = 'TDAT';

    2586. 

  2586.             $ID3v2ShortFrameNameLookup[3]['time'] = 'TIME';

    2587. 

  2587.             $ID3v2ShortFrameNameLookup[3]['original_release_year'] = 'TORY';

    2588. 

  2588.             $ID3v2ShortFrameNameLookup[3]['recording_dates'] = 'TRDA';

    2589. 

  2589.             $ID3v2ShortFrameNameLookup[3]['size'] = 'TSIZ';

    2590. 

  2590.             $ID3v2ShortFrameNameLookup[3]['year'] = 'TYER';

    2591. 

  2591.             

    2592. 

  2592.             // The following are unique to ID3v2.4
    2593. 

  2593.             $ID3v2ShortFrameNameLookup[4]['audio_seek_point_index'] = 'ASPI';

    2594. 

  2594.             $ID3v2ShortFrameNameLookup[4]['equalisation'] = 'EQU2';

    2595. 

  2595.             $ID3v2ShortFrameNameLookup[4]['relative_volume_adjustment'] = 'RVA2';

    2596. 

  2596.             $ID3v2ShortFrameNameLookup[4]['seek'] = 'SEEK';

    2597. 

  2597.             $ID3v2ShortFrameNameLookup[4]['signature'] = 'SIGN';

    2598. 

  2598.             $ID3v2ShortFrameNameLookup[4]['encoding_time'] = 'TDEN';

    2599. 

  2599.             $ID3v2ShortFrameNameLookup[4]['original_release_time'] = 'TDOR';

    2600. 

  2600.             $ID3v2ShortFrameNameLookup[4]['recording_time'] = 'TDRC';

    2601. 

  2601.             $ID3v2ShortFrameNameLookup[4]['release_time'] = 'TDRL';

    2602. 

  2602.             $ID3v2ShortFrameNameLookup[4]['tagging_time'] = 'TDTG';

    2603. 

  2603.             $ID3v2ShortFrameNameLookup[4]['involved_people_list'] = 'TIPL';

    2604. 

  2604.             $ID3v2ShortFrameNameLookup[4]['musician_credits_list'] = 'TMCL';

    2605. 

  2605.             $ID3v2ShortFrameNameLookup[4]['mood'] = 'TMOO';

    2606. 

  2606.             $ID3v2ShortFrameNameLookup[4]['produced_notice'] = 'TPRO';

    2607. 

  2607.             $ID3v2ShortFrameNameLookup[4]['album_sort_order'] = 'TSOA';

    2608. 

  2608.             $ID3v2ShortFrameNameLookup[4]['performer_sort_order'] = 'TSOP';

    2609. 

  2609.             $ID3v2ShortFrameNameLookup[4]['title_sort_order'] = 'TSOT';

    2610. 

  2610.             $ID3v2ShortFrameNameLookup[4]['set_subtitle'] = 'TSST';

    2611. 

  2611.         }

    2612. 

  2612.         return @$ID3v2ShortFrameNameLookup[$majorversion][strtolower($long_description)];

    2613. 

  2613.     

    2614. 

  2614.     }

    2615. 

  2615. 

    2616. 

  2616. }

    2617. 

  2617. 

    2618. 

  2618. ?>
    2619. 

  2619.