File: changelog.txt

package info (click to toggle)
php-getid3 1.9.20+dfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 2,900 kB
  • sloc: php: 32,800; makefile: 10
file content (2974 lines) | stat: -rw-r--r-- 155,548 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
/////////////////////////////////////////////////////////////////
/// getID3() by James Heinrich <info@getid3.org>               //
//  available at http://getid3.sourceforge.net                 //
//            or https://www.getid3.org                        //
//          also https://github.com/JamesHeinrich/getID3       //
/////////////////////////////////////////////////////////////////
//                                                             //
// changelog.txt - part of getID3()                            //
// See readme.txt for more details                             //
//                                                            ///
/////////////////////////////////////////////////////////////////

        »  denotes a major feature addition/change
        ¤  denotes a change in the returned structure
        !  denotes a cry for help from developers
* Bugfix:  denotes a fixed bug

Version History
===============

1.9.20: [2020-06-30] James Heinrich :: 1.9.20-202006061653
	» add support for DSDIFF audio
	» add support for TAK lossess audio
	» add support for IVF video
	» add detection support for EPUB files
	» add detection support for HPK archives
	» add demo.mysqli.php, remove demo.mysql.php
	¤ QuickTime.uuid now returned as an array (may contain multiple entries)
	¤ improved PDF support, including page count
	* bugfix (G:247) array_min incorrect return value
	* bugfix (G:242) filepointer analysis errors
	* bugfix (G:238) comments_html may not match comments
	* bugfix (G:235) prevent disclosing paths when accessing modules directly
	* bugfix (G:233) Quicktime duplicate attached images
	* bugfix (G:229) Quicktime timestamps easy access
	* bugfix (G:228) master.zip did not contain demos
	* bugfix (G:227) Quicktime check subatoms data length
	* bugfix (G:226) uuid parsing based on UUID
	* bugfix (G:225) use comments_html content already generated by modules
	* bugfix (G:223) ID3v2 slashed genre names
	* bugfix (G:222) demo.browse filesystem character encoding
	* bugfix (G:221) option_tags_html=false ignored
	* bugfix (G:219) Quicktime.UUID now parsed more discriminately for XML and other data types
	* bugfix (G:218) QuickTime not copying covr to comments
	* bugfix (G:217) mp3 array offsets of type bool
	* bugfix (G:216) ID3v2.write allow WMP rating in POPM
	* bugfix (G:210) PHP 7.4 deprecated get_magic_quotes
	* bugfix: Quicktime detect null-terminated strings used where Pascal strings should be
	* bugfix: Quicktime GPS uninitialized array keys

1.9.19: [2019-12-17] James Heinrich :: 1.9.19-201912131005
	» add placeholder support for WTV (Windows Recorded TV Show)
	* bugfix (G:210) PHP 7.4 deprecated get_magic_quotes
	* bugfix (G:207) improved LAME version string parsing
	* bugfix (G:206) inverted logic in CopyTagsToComments
	* bugfix (G:203) use getimagesizefromstring if available
	* Quicktime decode 'uuid' atom for 360fly cameras

1.9.18: [2019-07-24] James Heinrich :: 1.9.18-201907240906
	* bugfix (G:198) use native hash functions instead of obsolete external binaries
	* bugfix (G:194) PHP 7.4 compatibility: fix deprecated curly brace array access
	* bugfix (G:191) unsupported operand types module.audio.ac3.php:763
	* bugfix (G:189) false UTF-16 <BOM> and no termination strings
	* bugfix (G:188) add support for DS2 v8
	* bugfix (G:187) RIFF.WAVE.scot parsing
	* bugfix (G:184) invalid regex pattern (ID3v1)
	* bugfix (G:183) reduced information for GIF files with $option_extra_info=false
	* bugfix (G:175) mp4 max buffer size
	* bugfix (G:174) TIFF parsing improvements
	* bugfix (G:121) trailing nulls in ID3v2 strings
	* standardize "track" -> "track_number"

1.9.17: [2019-02-07] James Heinrich :: 1.9.17-201902071234
	* bugfix (G:178) HandleAllTags should skip "picture"
	* bugfix (G:177) error checking for reading more than PHP memory_limit
	* bugfix (G:176) improved mp3 detection in remote-file demo
	* bugfix (G:173) Add filepointer option to analyze/openfile function
	* bugfix (G:170) Add support for WXXX (URL) and APIC (attached picture) subframes inside ID3v2 chapters
	* bugfix: write.id3v2 year field
	* bugfix: mp3.APE permit optional " dB" in ReplayGain tags
	* placeholder support for .xz file format

1.9.16: [2018-10-17] James Heinrich :: 1.9.16-201810171314
	* bugfix (G:168) Ogg FLAC not parsed
	* bugfix (G:163) invalid MP3 header error on VBR
	* bugfix (G:162) prevent writing multiple ID3v2 versions
	* bugfix (G:161) MP3 VBR header duration
	* bugfix (G:160) OggOpus duration sometimes incorrect
	* bugfix (G:157) quicktime GPS invalid argument
	* bugfix (G:148) MPEG-2 aspect ratio
	* bugfix (G:147) Quicktime fourcc codec name lookup
	* bugfix (G:147) Quicktime audio/video bitrate guessing
	* bugfix (G:145) incompatible variable types
	* bugfix (G:139) Quicktime islt subatoms >5
	* bugfix (G:137) ID3v2 semi-numeric genres
	* bugfix (G:136) ID3v2 unsynchronised typo
	* bugfix (#2514) FLAC zero-byte block header
	* bugfix (#2488) MIME types (FLAC, WAV, gzip)
	* bugfix (#2468) Quicktime video rotation
	* bugfix (#2207) metaflac + attached pictures
	* bugfix (#2151) improved demo UNC filename support
	* bugfix (#1966) fread fail when PHP memory_limit -1
	* bugfix (#1908) Quicktime rotation detection (using matrix values)
	* bugfix (#1908) Quicktime "rcif" and "dscp" atoms
	* bugfix (#1900) demo.joinmp3 cut from end
	* security: avoid disabled demo reflection
	* TIFF: expand list of named tags, expose as 'tag_name' key for all entries
	* Quicktime: parse some GoPro-specific data
	* helperapps (Windows): updated vorbiscomment.exe, metaflac.exe to v1.3.2
	* add more image formats supported by getimagesize()

1.9.15: [2017-10-26] James Heinrich :: 1.9.15-201709291043
    » (G:108) add basic APNG support
    » (G:107) add basic WebP support
    * return RIFF.WAV.CART comments in merged comments section
    * add support for QuickTime 'loci' chunk
    * bugfix: (#2124) support for Quicktime/MP4 "chpl" (CHaPter List) atom
    * bugfix: (G:128) undefinied bsmod in module.ac3
    * bugfix: (#2114) possible issue with UTF8 filenames and metaflac
    * bugfix: (G:123) remove MySQL engine and collation from create table
    * bugfix: (#2066) fix AAC MIME type, remove video key for audio-only files
    * bugfix: (G:111) QuickTime stsd number_entries deadlock
    * bugfix: (G:110) PHP memory limit with space
    * bugfix: (G:109) improved animated GIF support
    * bugfix: (#1966) GPS track in QuickTime

1.9.14: [2017-03-27] James Heinrich
    » Add experimental support for E-AC3
    * bugfix (G:105): RIFF.WAVE.iXML multiple TIMESTAMP_SAMPLE_RATE
    * bugfix (G:95): improperly initialized error/warning keys
    * bugfix (G:94): ID3v2 write support for TXXX
    * bugfix (G:93): all errors or warnings should pass through class method

1.9.13: [2016-12-14] James Heinrich
    * bugfix (G:89): ID3v2.4 custom genres with slashes
    * bugfix (G:88): large QuickTime files exceed PHP memory limit
    * bugfix (G:87): ID3v2 write GRID data not working properly
    * bugfix (G:86): Increase autoloading definitions
    * bugfix (G:84): ID3v2 available writable frames list
    * bugfix (G:82): ID3v2 datetime logic
    * bugfix (G:80): attempt to autodetect ID3v1 encoding
    * bugfix (G:77): add partial support of DSSv6
    * bugfix (G:76): add mysqli version of caching extension
    * bugfix (G:75): mysql cache max key length
    * bugfix (G:71): custom error handler to catch exif_read_data() errors
    * bugfix (G:71): add support for mb_convert_encoding
    * bugfix (G:70): ID3v2 POPM / UFID
    * bugfix (G:68): workaround broken iTunes ID3v2
    * bugfix (G:48): Quicktime set MIME to video/mp4 where applicable
    * bugfix (#1930) fread on pipes
    * bugfix (#1926) relax ID3v2.IsValidURL check

1.9.12: [2016-03-02] James Heinrich
    » Add support for Direct Stream Digital (DSD) /
      DSD Storage Facility (DSF) file format
    » Add detection (not parsing) of WebP image format
    * bugfix (#1910): Quicktime embedded images

1.9.11: [2015-12-24] James Heinrich
    * bugfix (G:64): update constructor syntax for PHP 7
    * bugfix (G:62): infinite loop in large PNG files
    * bugfix (G:61): ID3v2 remove BOM from frame descriptions
    * bugfix (G:60): missing "break" in module.audio-video.quicktime.php
    * bugfix (G:59): .gitignore comments
    * bugfix (G:58): inconsistency in relation to module.tag.id3v2.php
    * bugfix (G:57): comparing instead of assign
    * bugfix (G:56): unsupported MIME type "audio/x-wave"
    * bugfix (G:55): readme.md variable reference
    * bugfix (G:54): QuickTime false 1000fps
    * bugfix (G:53): Quicktime / ID3v2 multiple genres
    * bugfix (G:52): sys_get_temp_dir in GetDataImageSize
    * bugfix (#1903): Quicktime meta atom not parsed
    * demo.joinmp3.php enhancements
    * m4b (audiobook) chapters not parsed correctly
    * sqlite3 caching not working

1.9.10: [2015-09-14] James Heinrich
    * bugfix (G:49): Declaration of getID3_cached_sqlite3
    * bugfix (#1892): extension.cache.mysql
    * bugfix (#1891): duplicate default clause [Quicktime]
    * bugfix (G:41): incorrect MP3 playtime
    * bugfix: iconv problems on musl with //TRANSLIT
    * Add arguments to analyze() for original filesize (and filename)
    * ID3v2 simplify handling of multiple genres
    * Corrected merging of multiple genres for ID3v2
    * getid3_lib::GetDataImageSize return false on error

1.9.9: [2014-12-18] James Heinrich
    » Added basic support for OggOpus
    » Add ID3v2 CHAP + CTOC support
    * Add composer autoloader
    * bugfix: removed non-printable ASCII in comment
    * bugfix: possible memory leak in OggFLAC
    * bugfix: sys_get_temp_dir undefined before PHP 5.2.1
    * bugfix: improved fix for XXE security issue (CVE-2014-2053)
      (thanks nacinØwordpress*org)
    * bugfix: G:25 ID3v2 LINK utf8_encode not defined
    * bugfix: G:22 ID3v2 TXXX description encoding
    * bugfix: #1855 - copy image height/width/etc to comments
    * bugfix: #1855 - PHP errors in badly written APE/ID3v2 tags
    * bugfix: #1845 - Quicktime parsing with no PHP memory_limit
    * bugfix: #1828 - ID3v2 writing unknown frame names

1.9.8: [2014-05-11] James Heinrich
    » Add support for AMR (Adaptive Multi-Rate audio codec)
      new file: module.audio.amr.php
    » Added composer.json, registered on packagist.org
    * Added workaround for PHP Bug #39923 (undefined constant IMG_JPG)
    * Bugfix: (#1813) avoid running out of memory when parsing large
      Quicktime files
    * Bugfix: (#1812) potential unwanted high-ASCII characters in errors
    * Bugfix: close potential XXE security issue (CVE-2014-2053)
    * Bugfix: (G:10) Avoid warnings from realpath() if SAFE MODE is enabled
    * Bugfix: (G:12) If [tags] data contains an array of strings then html
      encoding did not take place.
    * Bugfix: (G:12) IPTC character set not specified
    * Bugfix: possible divide by zero error in FLV module
    * Bugfix: possible undefined key in ID3v2
    * Bugfix: possible undefined key in MPEG video files
    * Bugfix: demo.browse to use character set consistently

1.9.7: [2013-07-05] James Heinrich
    * Bugfix: [module.audio-video.quicktime.php] track languages set
      with 15-bit-encoded ISO639-2 language codes not parsed correctly
    * Bugfix: (#1717) QuickTime atom hierarchy broken
    * Bugfix: (#1716) truncate MIDI file could cause infinite loop
    * Bugfix: all source files converted to UTF-8

1.9.6: [2013-06-03] James Heinrich
    » getID3() is now licensed under GPL / LGPL / MozillaPL / gCL
      See license.txt for more details.
    * Bugfix: (#1550) Quicktime video track sample description parsed
      incorrectly
    * Bugfix: (#1550) Quicktime matrix U/V/W values calculated incorrectly
    * [demo.browse] disable edit-tag and delete-file links by default
    * Bugfix: option_max_2gb_check should issue warning not error on >2GB

1.9.5: [2013-02-20] James Heinrich, Dmitry Arkhipov
    » DTS-in-WAV now properly supported
    ¤ DSS files return additional data in new keys, and some existing
      keys have been renamed
    * Bugfix: open_basedir not parsed correctly under Windows
      (thanks yannick*jamontØgmail*com)
    * Bugfix: [demo/demo.browse] might not display file or directory name
      on PHP >=5.4.0 if filename not UTF-8 friendly
    * Bugfix: [demo/demo.zip] could read more uncompressed data than
      required; fail to read file if local data descriptor not set;
      some wrong include files were listed; improved error message display
    * Bugfix: [module.audio-video.riff] INFO comment chunks with null name
      chunk not parsed correctly
    * Bugfix: [module.archive.gz] gzip files with filename stored may have
      filename reduplicated in [gzip][files] output
    * Bugfix: [module.archive.zip] data_descriptor not parsed correctly
    * Bugfix: [module.archive.zip] some newer compression methods unknown
    * Bugfix: [module.archive.zip] not all flags parsed
    * Bugfix: [module.archive.zip] local file header not parsed correctly
      if file has zero values for compressed_size in Local File Header
    * Bugfix: (#1493) better support for >2GB filesize on 32-bit Linux
    * Bugfix: (#1474) unneccesary call to GetDataImageSize in JPEG module
    * Bugfix: (#1470) GIF files falsely detected as TS format
    * Bugfix: (#1431) Matroska did not parse PixelCrop* / DisplayUnit
      (thanks jgerberØwikimedia*org)
    * Bugfix: (#1430) split ID3v2 text values on null separator
    * Bugfix: (#1426) MS Office 2007 file format now recognized as zip.msoffice
    * Bugfix: (#1423) optimized CreateDeepArray function
    * Bugfix: (#1415) add support for DS2 variant of DSS

1.9.4b1: [2012-10-05] James Heinrich, Dmitry Arkhipov, Karl G. Holz
    » New module: extension.cache.sqlite3.php (by Karl G. Holz)
    » New demo: demos/getid3.demo.dirscan.php (by Karl G. Holz)
    » PHP5 standards improvements (thanks phansysØgmail*com)
    » more reliable >4GB file size parsing using COM (if available)
      Scripting.FileSystemObject rather than parsing `dir` output
    * added support for FLAC inside Matroska (audio bitrate cannot
        be determined in this case)
    * XMP module now returns all tags, not just whitelisted ones
    * (#1297) Added detection of MPEG Transport Stream files.
      Stub module.audio-video.ts.php incomplete
    * (#1383) removed unneeded ?> tags (thanks daveØholyfield*info)
    * Bugfix: XMP returns attributes array not just value strings
    * Bugfix: (#1369) ID3v2 IPLS contents not parsed
    * Bugfix: (#1357) demo.mysql.php mysql_table_exists() failed
    * Bugfix: (#1355) copy Foobar2000 QuickTime tags to [comments]
    * Bugfix: (#1351) QuickTime files with zero-sized atom boxes
      could cause infinite loop
    * Bugfix: (#1343) FLAC attached pictures Ogg not handled
    * Bugfix: (#1343) ID3v2 inside WAV "id3 " chunk not handled
    * Bugfix: (#1315) BMP detection was broken
    * Bugfix: (#1309) ID3v2.2 content_group_description (TT2) did
      not copy to same place as ID3v2.3/ID3v2.4 (TIT2)
    * Bugfix: (#1308) [playtime_string] could show hh:mm:60
    * Bugfix: (#1306) extension.cache.mysql.php keyword TYPE->ENGINE
    * Bugfix: (#1295) missing video information if QuickTime file has
      disabled tracks
    * Bugfix: (#1275) MD5/SHA1 data hashes not working properly
      under Windows


1.9.3: [2011-12-13] Dmitry Arkhipov, James Heinrich
    * Matroska module improved:
      1. Added support for A_MS/ACM audio codec
      2. Fixed issues in tags, cues, chapters and clusters parsing
      3. Fixed almost all errors with track_data_offset, errors
         still may occur with Xiph data lacing
      4. Optimized audio/video streams population with usage of the
         official default values for missing elements
      5. Audio/video keys are now populated with data from the
         default stream, not from the first one as before
      6. Full WebM support
    * Bugfix: demo.browse would not pop up warnings when clicked
      if warning contains apostrophe/single-quote character
    * Bugfix: (#1269) ID3v1 genre typo "Trash"->"Thrash" Metal


1.9.2: [2011-12-08] James Heinrich, Dmitry Arkhipov
	» significant rewrite to module.audio-video.matroska.php
    ¤ (#1256) ID3 tags in AIFF 'ID3 ' chunks now parsed
    ¤ (#1039) iXML data in WAV files now returned and parsed into
        [riff][WAVE][iXML][0][data] and [riff][WAVE][iXML][0][parsed]
    ¤ [playtime_string] now returns M:SS if less than 1 hour, and
        H:MM:SS if 1 hour or longer
    * Bugfix: (#1266) variable tablename: extension.cache.mysql.php
    * Bugfix: (#1265) unescaped # in regex in write.id3v2.php
    * Bugfix: (#1252) MediaMonkey writes blank ID3v2 RGAD frames
      and puts replay-gain values in TXXX frames
    * Bugfix: (#1251) FLV playtime could be inaccurate for longer
        files where meta frame is present but meta-playtime is zero
    * Bugfix: (#1216) show hex values of unknown atom names
    * Bugfix: (#1215) undefined variable in PrintHexBytes()
    * Bugfix: FLV audio bitrate was returning kbps not bps
    * Bugfix: missing ) in write.real.php::RemoveReal()
    * Bugfix: replace $this::VERSION with getID3::VERSION in
        extension.cache.*.php


1.9.1: [2011-08-10] James Heinrich
    ¤ ASF Extended Header Object data now (partially) parsed
    * Default getID3 encoding now set to UTF-8 not ISO-8859-1
    * Bugfix: (#1212) truncated Matroska files may result in
        infinite loop and memory exhaustion
    * Bugfix: (#1203) parse RIFF JUNK chunks for version strings
    * Bugfix: (#1201) multi-byte characters strings incorrectly
        displayed by table_var_dump() in demo.browse.php
    * Bugfix: (#1199) prevent PHP warning on malformed ID3v2 APIC
    * Bugfix: (#1196) typo in module.audio-video.quicktime.php
    * Bugfix: (#1195) QuicktimeStoreFrontCodeLookup() broken
    * Bugfix: (#1194) mp4 embedded images not handled correctly
    * Bugfix: (#1193) [image_mime] key not set fo WM/picture data
    * Bugfix: (#1193) ASF Extended Header Object Metadata Library
        now parsed for embedded images and handled per usual style
    * Bugfix: (#1190) demo.mimeonly.php was broken since v1.9.0
    * Bugfix: ID3v2 comment is now called 'comment' not 'comments'
    * Bugfix: AVI unknown codec fourcc would be reported as blank
    * Bugfix: AVI zero-size JUNK chunk would give warning


1.9.0: [2011-06-20] James Heinrich
    » changed all module classes to have proper constructors
      with the actual analysis code moved to function Analyze()
    * removed unnecessary ob_* calls, replaced with appropriate
      checks and judicious use of @ error suppression
    ¤ GETID3_VERSION constant replaced with $getID3->version()
    ¤ picture data is now returned only in the original source
      location and [comments][picture], it is no longer replicated
      in [comments_html], [tags] or [tags_html]
    ¤ Matroska tags are now returned in [comments] as per normal
    ¤ Matroska tags are better supported, including pictures
    ¤ GPS data in MP4 files (e.g. iPhone) is now parsed (#1157)
    ¤ Matroska audio/video tracks with a default flag, the default
      stream flag is now copied to [audio|video][streams] (#1147)
    ¤ Nikon-specific data (NCDT atom) in Quicktime videos now parsed
    ¤ QuickTime atoms 'meta' and 'data' now (mostly) parsed
    * Bugfix: remove false warning of junk data on WAV+ID3v1
    * Bugfix: DolbyDigitalWAV files returned wrong audio bitrate
    * Bugfix: large attachment data in Matroska tags were not
      returned completely.
    * Bugfix: wrong image_mime used for images in demo.browse.php
    * Bugfix: broken preg_match in module.audio.dss.php
    * Bugfix: Lyrics3 end offset was off by 1
    * Bugfix: audio channelmode could be wrong for 2 channels
      (e.g. joint stereo reported as stereo)
    * Bugfix: MultiByteCharString2HTML() would return empty string
      if passed float or int value, now casts to string first
    * Bugfix: FLAC.picture was not returning under [data] +
      [image_mime] per standardized format
    * Bugfix: BigEndian2Int() could incorrectly return negative
      signed synchsafe integer instead of casting to float
    * Bugfix: (#1177) ID3v2.4 extended headers were broken
    * Bugfix: (#1173) some MIDI files not completely parsed
    * Bugfix: (#1171) change helperapps error to nonblocking warning
    * Bugfix: (#1170) possible infinite loop in FLV module
    * Bugfix: (#1169) $this reference in static function (ID3v2)
    * Bugfix: (#1156) demo.mysql.php not working
    * Bugfix: (#1153) badly-tagged files could produce invalid
      argument errors in module.tag.xmp.php
    * Bugfix: (#1152) add error-suppression to iconv() calls
    * Bugfix: (#1151) AAC-ADTS files could sometimes not find sync
    * Bugfix: (#1136) last character of unicode tags (e.g. ASF)
      was being truncated
    * Bugfix: (#1133) write.id3v2.php IsValidURL() was broken
    * Bugfix: (#1126) ID3v2.POPM field was being clobbered
    * Bugfix: (#999, #1154) ID3v2 UFID data was missing


1.8.5: [2011-02-18] James Heinrich
    » support >2GB files on 64-bit PHP
      - note current unofficial 64-bit PHP builds for Windows
        do not actually support 64-bit integers so are still
        subject to normal 32-bit limits (2GB) for file functions
    » PHP v5.0.5 now minimum required version.
      Removed obsolte functions from getid3.lib.php:
        md5_file, sha1_file, image_type_to_mime_type
    » IDivX tags now parsed on AVI files
    ¤ embedded image data is returned inside [comments][picture]
      in a 2-element array (data, image_mime) for all formats
    * $this->overwrite_tags=false is now known to be buggy and
      has been disabled for this version until a full review
      of tag writing can be completed. Certainly affects ID3v2,
      the other writable tag formats may or may not be broken
    * getID3 constructor no longer checks for (or sets) timezone
    * demo.browse.php now shows cover art as inline images
      rather than dumped to separate files
    * [audio][streams][x][language] now set when known
    * Bugfix: RIFF-AVI "JUNK" chunks are now parsed properly,
      including zero-sized ones (no more false errors)
    * Bugfix: msoffice documents now return correct error message
    * Bugfix: demo.browse.php now encodes data according to
      current page encoding (default=UTF-8)
    * Bugfix: (#1120) sometimes incorrect ID3v2 genre parsing
    * Bugfix: (#1116) possibly incorrect warnings (or lack of)
      for RIFFs > 2GB.
    * Bugfix: (#1115) wrong RIFFtype in RIFF files
    * Bugfix: (#1114) wrong MIME type may be set for Matroska
    * Bugfix: (#1113) support DSS v3 files
    * Bugfix: (#1111) cover art in APE tags now supported
    * Bugfix: (#1091) RemoveID3v1() unitialized variables
    * Bugfix: (# 504) do not set Quicktime resolution if
      'tkhd' atom is disabled
    * Bugfix: (#  95) return [quicktime][controller] if known


1.8.4: [2011-02-03] James Heinrich
    * change default encoding in ID3v2 writing to UTF16-LE+BOM
      (or ISO-8859-1 where possible) for better compatability
      with broken versions of Windows Media Player and iTunes
    * Bugfix: [FLV] incorrect overall bitrate in some files
    * Bugfix: (#1102) missing parentheses in write[.id3v2].php
    * Bugfix: (#510) undefined IsValidDottedIP() in write.id3v2.php


1.8.3: [2011-01-18] James Heinrich
    » magic_quotes_gpc must now be disabled to use getID3
    » replace all error-suppressing @$variable calls with
      isset() or empty() as appropriate for some configurations
      where @ does not act to suppress warnings of undefined
      variables (e.g. support forum thread #798)
    * remove SafeStripSlashes() and FixTextFields functions
    * [quicktime] use fourcc if codec name zero-length
    * [quicktime] support "iods" atom
    * Bugfix: (#1099) sometimes incorrect detection of safe_mode
    * Bugfix: (#1095) more robust setting of temp dir
    * Bugfix: (#1093) add support for ClusterSimpleBlock to
      prevent "Undefined index: track_data_offsets" errors
      in Matroska files
    * Bugfix: [riff] prevent errors when RIFF.WAVE.BEXT chunk
      contains null date/time  (thanks moysevichØgmail*com)
    * Bugfix: [quicktime] prevent divide-by-zero errors if
      time_to_sample_table has zero-sample entry
      (thanks moysevichØgmail*com)


1.8.2: [2010-12-06] James Heinrich
    * include startup warning for PHP < v5
    * magic_quotes_runtime must now be disabled to use getID3
    ¤ MusicBrainz / AmpliFIND data more accessible in returned data
      from Quicktime-style files (e.g. MP4/AAC)
    * Bugfix: (#1079) wrong encoding might be used for ID3v2
        text data, and/or garbage data prepended before text
        data; DataLengthIndicator value was being ignored
    * Bugfix: (#1055) clearer warnings on non-EXIF contents in
      JPEG [APP1]
    * Bugfix: (#999) ID3v2 UFID data was missing


1.8.1: [2010-11-25] James Heinrich
    * replaced calls to deprecated mysql_escape_string() with
      mysql_real_escape_string()
    * Bugfix: (#1072) memory limit not handled correctly if
      in gigabytes in php.ini (e.g. "2G")
    * Bugfix: (#1068) wrong encoding for Quicktime tags
    * Bugfix: (#1040) possible infinite loop in genre parsing
    * Bugfix: (#1036) helperapps directory not resolving 8.3
        path names correctly
    * Bugfix: (#1023) dbm cache extension not correctly handling
        types other than "db3"
    * Bugfix: (#1023) mysql cache extension now base64_encodes
        data to make binary-safe. Existing cached data must be
        purged from your database cache
    * Bugfix: (#1007) ClosestStandardMP3Bitrate() not selecting
        most appropriate value
    * Bugfix: (#996) inefficient and buggy ID3v1 and ID3v2
        genre parsing
    * Bugfix: (#974) track number handled incorrectly in
        demo.write.php
    * Bugfix: (#969) tempnam() calls failing with open_basedir
    * Bugfix: (#955) UTF-16LE text files could be falsely
        identified as corrupt mp3 files
    * Bugfix: (#877) detect if mbstring.func_overload is set in php.ini
    * Bugfix: (#858) PHP safe_mode setting in php.ini incorrectly
        handled if set to "Off"
    * Bugfix: (#838) prevent warnings with assorted unhandled
        Quicktime atoms


1.8.0: [2010-11-23] James Heinrich
    » Changes required for PHP v5.3+ compatability, including:
      - change ereg* functions to preg_* equivalents
      - declare functions static as needed
      note: users of PHP v4.x may need to stay with getID3 v1.7.x
    » Added CUE (cuesheet) support
      new file: module.misc.cue.php
      (thanks Nigel Barnes ngbarnesØhotmail*com)
    » Added XMP (Adobe Extensible Metadata Platform) support
      currently used with module.graphic.jpg.php
      new file: module.tag.xmp.php
      (thanks Nigel Barnes ngbarnesØhotmail*com)
    ¤ [jpg][exif][GPS][computed] now exists when possible with
      calculated values (decimal latitude, longitude, altitude, time)
    ¤ Prevent clobbering WMA artist with albumartist value; added WMA
      partofset tag; added WMA tag picture data to WMA comments
      (thanks ngbarnesØhotmail*com)
    ¤ RIFF.WAVE.SNDM (SoundMiner) metadata now parsed
      (thanks emerrittØwbgu*bgsu*edu)
    ¤ FLAC embedded pictures now return [data_length] key
      (thanks darrenburnhillØhotmail*com)
    * added support for a number of new comment atom types added in
      iTunes v4.0-v7.0  (thanks ngbarnesØhotmail*com)
    * demo.browse.php now shows video resolution and framerate (if no
      artist or title info present)
    * additional FLV details parsed, may be faster as well
      (thanks ngbarnesØhotmail*com)
    * Bugfix: DSS files longer than 60 seconds had wrong playtime
    * Bugfix: possible empty array encountered in APE tags
      (thanks csnaitsirchØweb*de)
    * Bugfix: prevent fatal error when calling BigEndian2Int() on
      zero-length string  (thanks taylor*fausakØgmail*com)
    * Bugfix: prevent errors when parsing invalid Vorbis comments
      (thanks dr*dieselØgmail*com)
    * Bugfix: files could not be analyzed from Windows shares
      (e.g. \\SERVER\Directory\Filename.mp3)
    * Bugfix: RAR file opening should use 'filenamepath'
      (thanks adrien*gibratØgmail*com)
    * Bugfix: [asf][codec_list_object][codec_entries][x][description]
      not containing expected comma-seperated values no longer aborts
      (thanks larry_globusØyahoo*com)
    * Bugfix: [id3v2] UFID was not returning data
      (thanks joostØdecock*org)

1.7.9: [2009-03-08] James Heinrich
    » Added DSS (Digital Speech Standard) support
      new file: module.audio.dss.php
      (thanks luke*wilkinsØdtsam*com)
    » Added MPC (Musepack) SV8 support
      (thanks WaldoMonster)
    ¤ some MPC [header] keys renamed to be the same between SV7/SV8
    ¤ start aligning demos CSS styling with v2.x styles
      new file: demos/getid3.css
    ¤ JPEG now returns parsed IPTC tags in [iptc]
    ¤ getid3_lib::GetDataImageSize now requires $imageinfo parameter
    ¤ better support for Matroska files with AC3/DTS/MP3/OGG audio
      (support still lacking for AAC)
    ¤ standardize ID3v2 TCMP key to 'part_of_a_set' between reading
      and writing  (thanks aaron_stormØyahoo*com)
    ¤ added ID3v2 keys 'TCMP','TCP' to for writing iTunes-style tags
      (thanks aaron_stormØyahoo*com)
    ¤ back-ported PICTURE tag handling in FLAC tags
      (thanks WaldoMonster)
    ¤ added alternate method to get [video][frame_rate] from QuickTime
    * added partial support for "TCMP"/"TCP" ID3v2 frames (iTunes
      non-standard part-of-a-compilation tag)
      (thanks aaron_stormØyahoo*com)
    * slightly improved scanning through FLV files speed
      (thanks franki)
    * faster Matroska scanning by stopping at cluster chunks once
      needed header chunks are found (much faster for large files)
    * added workaround for broken tagging programs that miss terminating
      null byte for numeric ID3v2.4 genres
      (thanks yam655Øgmail*com)
    * Bugfix: MultiByteCharString2HTML() did not escape common HTML
      special characters like & and ?
    * Bugfix: cleaned up some malformed HTML errors in demo.browse.php
    * Bugfix: under Windows files >2GB might not be processed due to
      "dir" command not finding file with double directory slashes
    * Bugfix: "MODule (assorted sub-formats)" was falsely matching
      some random files (e.g. JPEGs)  (thanks qwertywin)
    * Bugfix: suppress PHP_notice on failed SWF-compressed
      decompression failure  (thanks mkron)


1.7.8b3: [2008-07-13] James Heinrich
    » Experimental partial support for files > 2GB (gets filesize
      from shell call to "dir" or "ls", parse files with PHP only
      up to 2GB limit). See readme.txt for details on what formats
      work properly and other limitations
    » Initial support for Matroska. Has only been tested with a
      limited number of sample files, please report any bugs
    » Experimental support for PHP-RAR reading. Known buggy, disabled
      by default, enable with care
    ¤ getid3_lib::CastAsInt() now returns ints up to 2^31 (not 2^30)
    ¤ Quicktime: [video] now returns [frame_rate] and [fourcc] for MP4
      video files
    * MP3: headerless VBR files now only have up to 10 blocks of 5000
      frames each scanned by default and bitrate extrapolated from that
      distribution for speed  (thanks glau*stuffØridiculousprods*com)
    * Quicktime: support "co64" atom
    * SWF: lower memory use when compressed SWF files processed
      (thanks doughammondØblueyonder*co*uk)
    * Bugfix: FLV height and width was calculated incorrectly
      (thanks moysevichØgmail*com)
    * Bugfix: FLV GETID3_FLV_TAG_META parsed incorrectly
      (thanks moysevichØgmail*com)
    * Bugfix: Quicktime: 'tkhd' matrix_v and matrix_d were switched
      (thanks rjjmoroØhotmail*com)
    * Bugfix: Quicktime: frame_rate was often incorrect for MP4 video
    * Bugfix: getid3_lib::CastAsInt returned -2147483648 when passed
      2147483648 (0x80000000)


1.7.8b2: [2007-10-15] James Heinrich, Allan Hansen
    * Video bitrate now calculated even if not explicitly stated in
      file metadata, but if overall and audio bitrates are known
    * Bugfix: 'comments_html' missing last letter in id3v2 tags.
    * Bugfix: module objects (e.g. getid3_riff) that are instantiated
      in other modules are explicitly disposed once no longer needed.
    * Bugfix: some AVI files were not returning audio information
      because "strh" chunk was not being read in
    * Bugfix: asf [audio][<streamnumber>][dataformat] should be set
      to "wma" but wasn't
    * Bugfix: [mpeg][audio][bitrate_mode] should always be one of
      ("cbr", "vbr", "abr") but wasn't for some values in
      LAMEvbrMethodLookup()
    * Bugfix: MP3 audio in AVI files could show "cbr" instead of
      correct audio bitrate_mode, and audio bitrate could be slightly
      incorrect if multiple files were scanned in a loop (scanning
      single files produced correct values).
    * Bugfix: remove [audio/video][bitrate] key if falsely set to zero
    * Bugfix: PlaytimeString returned non-matching value for negative
      playtimes (which shouldn't happen either, but now they're at
      least shown correctly, if they happen due to other bugs)
    * Bugfix: Several ASF header values are invalid if the broadcast
      flag is set, getID3() now calculates these values in other
      ways if the broadcast flag is set  (thanks fletchØpobox*com)
    * Bugfix: lyrics3-flags-lyrics field was always false, and there
      never was a lyrics3-flags-timestamp field present even though
      the lyrics3-raw-IND field consisted of "10" (lyrics present,
      timestamp not present).  (thanks i*f*schulzØweb*de)
    * Bugfix: TAR.GZ files produce PHP errors when
      option_gzip_parse_contents == true in module.archive.gzip.php
      (thanks alan*harderØsun*com)


1.7.8b1: [2007-01-08] Allan Hansen
    » Major update to readme.txt
    » PHP 4.2.0 required
    » Tagwriter requires metaflac 1.1.1+ in order to write FLAC tags.
    » Removed broken and non-fixable tagwriting module for real format.
    ! Developers please help fix the above module:
      https://www.getid3.org/phpBB3/viewtopic.php?t=677
    » Avoided security issues with demo.browse.php, demo.write.php and
      demo.mysql.php. These demos are now disabled by default and has
      to be enabled in the source.
    * Bugfix: id3v2 genre broken since 1.7.7.
    » Added DTS module (module.audio.dts.php)
    ¤ ASF/WMV files now return largest video stream dimensions in
      [video][resolution_x] and [video][resolution_y]
    * Bugfix: Minor issues with midi module (avoid PHP_NOTICE).
    * Bugfix: Minor issues with lyrics3 (avoid PHP_NOTICE).
    * Bugfix: PHP_NOTICE issues in MultiByteCharString2HTML()
    * Bugfix: PHP_NOTICE issue  in BigEndian2Float()
    * Bugfix: fread() zero bytes issue in real module.
    * Bugfix: ASF module returned mime type video/x-ms-wma instead of
      video/x-ms-wmv for certain FourCCs.
    * Bugfix: PHP_NOTICE issues with broken ID3v2 tag/garbage.
    * Bugfix: PNG module broken in regards to gIFg and gIFx chunks.
    » Removed detection of short filenames 8dot3 under windows, as
      it only worked for English versions of windows and has other
      problems.
    * Bugfix: Some CBR MP3 files detected as VBR with plenty of warnings.
    * Bugfix: PHP_NOTICE issues in MP3 module.
    * Bugfix: Quicktime returned incorrect frame rate.
    * Bugfix: DivByZero on zero length FLV files.
    * Bugfix: PHP_NOTICE one some FLV files.
    * Bugfix: ID3v2 UTF-8/16 encoded frames terminated by \x00
    * Bugfix: ID3v2 LINK frames iconv error.
    * Bugfix: ID3v2 padding length calculated incorrectly.
    * Bugfix: ID3v2.3 extended headers non-conformance
    » SVG file detection.
    » Added SVG user module (user_modules/module.graphic.svg.php).
      Thanks to Roan Horning.
    » PAR2 file detection (no parsing)
    * Bugfix: Wave files being detected as MP3.
    * Bugfix: ASF padding offset bug.
    * Bugfix: Shorten module not working for wav files with fmt
      chunks <> 16 bytes.
    ¤ RIFF: Zero sized chunk invokes warning instead of error.
    ¤ FLAC: Removed some ['raw'] keys.
    ¤ MPC: Mime type returned: audio/x-musepack

1.7.7: [2006-06-25] Allan Hansen
    * Bugfix: AAC static bitrate cache wrong result when parsing
      several files.
    * Bugfix: Do not return NULL video bitrate for ASF v3.
    * Bugfix: getid3_lib::GetImageSize() broken => JPG module broken.
    * Bugfix: Encoder options should now be returned with correct
      "--alt-preset n" /  "--alt-preset cbr n" when scanning more files.
    * Bugfix: Shorten module not escapeshellarg() filenames (UNIX only).
    * Bugfix: Filenames not escapeshellarg() for md5_data and
      sha1_data (UNIX only).
    * Bugfix: UNIX: head and tail called with -cNNN instead of "-c NNN".
    » Added detection support for PDF and MS Office documents
      (*.doc, *.xls, *.pps, etc)  (thanks zeromassmediaØgmail*com)
    ¤ Bugfix: ID3v2 "TDRC" frame now used as "year" in comments if TYER
      unavailable (TYER is deprecated in ID3v2.4)
      (thanks matthiasØpanczyk*org)
    ¤ Removed GETID3_OS_DIRSLASH, replaced with DIRECTORY_SEPARATOR
    * Bugfix: added LAME preset guessing for presets 410,420,440,490
      (thanks adminØlogbud*com)
    * Bugfix: Added escapeshellarg() call in getid3_lib::hash_data
      (thanks towbØgmx*net)
    » TAR module no longer reads entire file into memory
    » FLV module no longer reads entire file into memory
    * Bugfix: added LAME preset guessing for presets 410,420,440,490
      (thanks adminØlogbud*com)
    * Bugfix: Added escapeshellarg() call in getid3_lib::hash_data
      (thanks towbØgmx*net)
    * Bugfix: Error message when padding in FLAC files were used up.
    * Bugfix: Shorten module not working under windows.
    ¤ Bugfix: gmmktime() instead of mktime().
    ¤ Using gmmktime() instead of mktime() in ISO, ZIP, PNG and RIFF
      modules to avoid E_STRICT notices with PHP5.1+.
    * Bugfix: ['comments_html'] and ['comments'] contains different
      value when having multiple tags (one of them ID3v1) and the
      long field names.

1.7.6: [2006-03-12] James Heinrich
    * Rewrote getid3_lib::GetDataImageSize() to use GetImageSize()
      instead of using code by filØrezox*com
    * Bugfix: incorrect dimensions from disabled Quicktime tracks
      (thanks m-1Øgmx*net)
    * Bugfix: ['codec'] key warning in module.audio-video.asf.php
      (thanks niel*archerØblueyonder*co*uk)
    * Bugfix: undefined array in write.php
      (thanks drewishØkatherinehouse*com)
    * Bugfix: DeleteAPEtag() incorrectly failing when no tag present
      (thanks drewishØkatherinehouse*com)
    * Bugfix: ID3v2 writing frames with URL fields failing when URL
      is not in ISO-8859-1  (thanks drewishØkatherinehouse*com)
    * Bugfix: PHP notices on bad ID3v2 frames
      (thanks cw264701Øohiou*edu)
    * Bugfix: audio & video bitrates sometimes wrong in ASF files
      (thanks kris_kauperØexcite*com)

1.7.5: [2005-12-29] James Heinrich
    » Added FLV (FLash Video) support -- new file:
      module.audio-video.flv.php
      (thanks Seth Kaufman <seth@whirl-i-gig.com> for code)
    » Real tags can now be written (previous Real tag writing
      code was not supposed to be in public releases, as it
      was not complete)
    » GETID3_HELPERAPPSDIR now autodetected under Windows
    ¤ ASF lyrics now returned under [comments][lyrics]
    * Bugfix: removed "--lowpass xxxxx" info from guessed
      LAME presets when source frequency <= 32kHz
    * Bugfix: ID3v2 extended header errors
    * Bugfix: missing ob_end_clean() in write.id3v2.php
      (thanks rasherØgmail*com)

1.7.4: [2005-05-04] James Heinrich
    ¤ Added ['quicktime']['hinting'] key (boolean)
      (thanks jonØwebignition*net)
    * Bugfix: major UTF-8 to UTF-16/ISO-8859-1 conversion
      bug (empty string returned) when using iconv_fallback
      (thanks chrisØfmgp*com)
    * Bugfix: Missing 'lossless' key in RIFF-WAV
      (thanks bobbfwedØcomcast*net)

1.7.3: [2005-04-22] James Heinrich
    » Added TAR support -- new file: module.archive.tar.php
      (thanks Mike Mozolin <teddybearØmail*ru> for code!)
    » Added GZIP support -- new file: module.archive.gzip.php
      (thanks Mike Mozolin <teddybearØmail*ru> for code!)
    * Bugfix: demo.browse.php now displays embedded images
      internally instead of passing local filename as IMG
      SRC (should allow demo.browse.php to correctly show
      embedded images over a network)
      (thanks patpowermanØhotmail*com)
    * Bugfix: minor UTF-8 display issues in demo.browse.php
    * Bugfix: demo.browse.php now works even if the evil
      setting magic_quotes_gpc is turned on
      (thanks patpowermanØhotmail*com)
    * Bugfix: incorrect MIDI playtime for some files
      (thanks joelØoneporpoise*com)
    * Bugfix: 'url_source' typo in module.tag.id3v2.php
      (thanks richardlynchØusers*sourceforge*net)
    * Bugfix: Quicktime 'mvhd' matrix values were wrong
      (thanks webØbobbymac*net)
    ¤ ID3v2 now returns xx/yy for ['track'] (if
      available), with xx in ['tracknum'] and yy in
      ['totaltracks']. Previously ['tracknum'] was not
      available and ['track'] had only xx.
    Bugfixes and improvements to /demo/demo.mysql.php:
      - remix/version parsed from tags and stored in
        database, can be used when renaming files
      - track number can be used for renaming files


1.7.2: [2004-10-18] Allan Hansen
    » Added support for WavPack v4.0+
      (thanks ahØartemis*dk)
    » Removed code for parsing EXE files
      (thanks ahØartemis*dk)
      Removed file: module.misc.exe.php
    * Bugfix: Large ID3v2 tags inside ASF not parsed
      properly under PHP5.
    * Bugfix: Certain Wavpack3 files failed under PHP5 due
      to new undocumented tmpfile() limit (same problem as
      above).
    * Bugfix: New iTunes crashes PHP - temp fix - no tags
      on those files.
    * Bugfix: ['nsv']['NSVs']['framerate_index'] might be
      wrong  (thanks ahØartemis*dk)
    * Bugfix: transparent color was wrong from truecolor
      PNG  (thanks ahØartemis*dk)
    * Bugfix: Changed MPC SV7 header size from 30 to 28,
      this will change hash values for MPC files
      (thanks ahØartemis*dk)
    * Bugfix: Changed MPC SV4-6 header size from 28 to 8,
      this will change hash values for MPC files
      (thanks ahØartemis*dk)
    ¤ Trim/unset wavpack encoder_options to match 2.0.0b2
      output.
    ¤ Commented-out unknown/unused values in NSV and ISO
      modules  (thanks ahØartemis*dk)


1.7.1b1: [July-26-2004] James Heinrich
    » Added support for Apple Lossless Audio Codec
    » Added support for RealAudio Lossless
    » Added support for TTA v3
    » Added support for TIFF
      New file: /getid3/module.graphic.tiff.php
    » Modified iconv_fallback to work with UTF-8, UTF-16, UTF-16LE,
      UTF-16BE and ISO-8859-1 even if iconv() and/or XML support is
      not available. This means that iconv() is no longer required
      for most users of getID3()
      (thanks Jeremia, khleeØbitpass*com)
    » Added support for Monkey's Audio v3.98+ (thanks ahØartemis*dk)
    » Included new demo showing most-basic getID3() usage
      New file: /demos/demo.basic.php
    * Bugfix: LAME3.94+ presets cached incorrectly if multiple files
      are scanned in one batch and first file is LAME3.93 or earlier
      (thanks enoyandØyahoo*com)
    * Bugfix: Added warning if compressed ID3v2 frame decompression
      fails. (thanks Mike Billings)
    * Bugfix: Assorted small fixes to ensure compatability with PHP5
    * Bugfix: ID3v1 genre "Blues" could not be written
      (thanks Jeremia)
    * Bugfix: ['bitrate_mode'] typo in module.audio-video.real.php
      (thanks asukakenjiØusers*sourceforge*net)
    * Bugfix: ['zip']['files'] is now populated with filenames even
      if End Of Central Directory couldn't be parsed
    * Bugfix: ['audio']['lossless'] was incorrect for FLAC
      (thanks WaldoMonster)
    * Bugfix: MD5 File was incorrect in directory browse mode for
      /demo/getid3.browse.php
    * Bugfix: PHP v5 compatability changes (float array keys, fread()
      calls with zero data length)
      (thanks getid3Øjsc*pp*ru)
    * Bugfix: was dying if on compressed ID3v2 frames if
      gzuncompress() function was unavailable
    * Bugfix: ['vqf']['COMM'] was always empty
    * Bugfix: MIDI playtime was missing for single-track MIDI files
    * Bugfix: removed &#0; characters from ['comments_html']
      (thanks p*quaedackersØplanet*nl)
    * Bugfix: improved MIDI playtime accuracy
      (thanks joelØoneporpoise*com)
    * Bugfix: BMP subtypes 4 and 5 were not being identified
    * Bugfix: frame_rate in AVI was incorrectly truncated to integer
    * Bugfix: FLAC cuesheet track index was incorrect
      (thanks tetsuo*yokozukaØoperamail*com)
    ¤ ['quicktime']['display_scale'] now contains the playback scale
      multiplier for QuickTime movies - a movie set to playback at
      double-size will have "2" here. Other values are "1" and "0.5"
    ¤ Added LAME preset guessing for --preset medium with v3.90.3
      (thanks phwipØfish*co*uk)
    ¤ Added $encoding_id3v1 to allow for ID3v1 encodings other than
      the standard ISO-8859-1
    ¤ Default AVI video bitrate_mode is now 'vbr'
      (thanks eltoderØpisem*net)
    Force getID3() to abort if Shorten files have ID3 or APE tags
      (thanks ahØartemis*dk)
    Editable textbox for parent directory in demo.browse.php
      (thanks eltoderØpisem*net)


1.7.0-hotfix [2004-03-17] Allan Hansen
    (hotfix version released by Allan Hansen)
    * Bugfix: PHP 4.1.x compatiblity - fgets($fp) => fgets($fp, 1024)
    * Bugfix: Added default charset to TextEncodingNameLookup() in
      module.tag.id3v2.php
    Ø Removed option_no_iconv
      iconv() support is only a requirement for WMA/WMW/ASF, and for
      destination encodings other than ISO-8859-1 and UTF-8, iconv is
      not needed otherwise. New 'iconv_req' in GetFileFormatArray()
      only set for WMA/WMV/ASF. analyze() now refuses to analyse
      WMA/ASF file if iconv is not present.
    iconv_fallback() only dies on internal errors not missing iconv()


1.7.0: [January-19-2004] James Heinrich
    » Added support for RIFF/CDXA files (MPEG video in RIFF container
      format (thanks chrisØdigitekdesign*com)
    » Added support for TTA v2  (thanks ahØartemis*dk)
    ¤ ID3v2 unsynchronisation scheme disabled by default because most
      tag-reading programs cannot read unsynchronised tags. Can be
      overridden by setting id3v2_use_unsynchronisation to true.
      (thanks mikeØdelusion*org)
    ¤ extention.*.php renamed to extension.*.php
      (thanks tp62Øcornell*edu)
    ¤ /demo/demo.check.php renamed to /demo/demo.browse.php
    ¤ Added id3v2_paddedlength configuration parameter to WriteTags()
      and renamed tag_language to id3v2_tag_language
    ¤ MPEG audio layers are now represented as 1, 2 or 3 instead of
      'I', 'II', or 'III'
    ¤ Added [audio][wformattag] and [video][fourcc] for WAV and AVI
    ¤ Added [audio][streams] which contains one entry for each audio
      stream present in the file (usually only one). The data is a
      copy of what is usually found in [audio]. If there are multiple
      audio streams then [audio] will contain a sum of the bitrates
      of all audio streams, and the data format of the first stream
      (if streams are of different data types)
    ¤ Added BruteForce mode to mp3 scanning. Disabled by default as
      it is extremely slow and only files that are broken enough to
      not really play will gain any benefit from this.
    ¤ Suppress '--resample xxxxx' appended to encoder options for mp3
      with low-quality presets for default sampling frequencies
    ¤ Enhanced LAME preset guessing for pre-3.93 with a better lookup
      table, --resample/--lowpass guessing (thanks phwipØfish*co*uk)
    ¤ RIFF files with non-MP3 contents no longer have
      [audio][encoder_options] set
    ¤ Added [audio][encoder_options] to audio formats where possible
      (including LiteWave, LPAC, OptimFROG, TTA)
    ¤ Moved [quantization] and [max_prediction_order] from
      [lpac][flags] to just [lpac]
    ¤ WavPack flags are now parsed into [wavpack][flags]
    * Bugfix: APEtags with ReplayGain information stored with comma-
      seperated decimal values (ie "0,95" instead of "0.95") were
      giving wrong peak and gain values
    * Bugfix: Filesize > 2GB not always detected correctly
    * Bugfix: Some ID3v2 frames had data key unset incorrectly
      (thanks chrisØdigitekdesign*com)
    * Bugfix: Warnings on empty-strings-only comments
    * Bugfix: ID3v2 tag writing may have had incorrect padding length
      if padded length less than current ID3v2 tag length and
      merge_existing_data is false  (thanks mikeØdelusion*org)
    * Bugfix: hash_data() for SHA1 was broken under Windows
    * Bugfix: BigEndian2Float()/LittleEndian2Float() were broken
    * Bugfix: LAME header calculated track peaks were incorrect for
      LAME3.94a15 and earlier
    * Bugfix: AVIs with VBR MP3 audio data reported incorrect bitrate
      and bitrate_mode
    * Bugfix: AVIs sometimes had incorrect or missing video and total
      bitrates
    * Bugifx: AVIs sometimes had incorrect ['avdataend'] and
      therefore also incorrect data hashes (md5_data, sha1_data)
    * Bugfix: ID3v1 genreid no longer returned for Unknown genre
    * Bugfix: ID3v1 SCMPX genres were broken
    Modified LAME header parsing to correctly process peak track
      value for LAME3.94a16+ (thanks Gabriel)
    md5_file() and sha1_file() now work under Windows in PHP < 4.2.0
      and 4.3.0 respectively with helper apps
    Default md5_data() tempfile location is now system temp directory
      instead of same directory as file (thanks towbØtiscali*de)
    Improved list of RIFF ['INFO'] comment key translations
    More helpful error message when GETID3_HELPERAPPSDIR has spaces
    /demo/demo.browse.php now autogets both MD5 and SHA1 hashes for
      files < 50MB
    Replaced PHP_OS comparisons with GETID3_OS_ISWINDOWS define
      (thanks necroticØusers*sourceforge*net)


1.7.0b5: [December-29-2003] James Heinrich
    » Windows only: Various binary files are now required for some
      file formats, especially for tag writing, as well as md5sum
      (and other) calculations. These binaries are now stored in the
      directory defined as GETID3_HELPERAPPSDIR in getid3.php
      (default is /helperapps/ parallel to /getid3/).
      Note: This directory must not have any spaces in the pathname.
      All neccesary files are available as a seperate download.
      See /helperapps/readme.txt for more information
      New file: /helperapps/readme.txt
    » Unified tag-writing interface for all tag formats
      New file: /getid3/write.php
                /getid3/write.apetag.php
                /getid3/write.id3v1.php
                /getid3/write.id3v2.php
                /getid3/write.lyrics3.php
                /getid3/write.metaflac.php
                /getid3/write.vorbiscomment.php
    » Added support for Shorten - requires shorten binary (head.exe
      is also required under Windows).
      New file: /getid3/module.audio.shorten.php
    » Added support for RKAU
      New file: /getid3/module.audio.rkau.php
    » Added (minimal) support for SZIP
      New file: /getid3/module.archive.szip.php
    » Added MySQL caching extention  (thanks ahØartemis*dk)
      New file: /getid3/extention.cache.mysql.php
    » Added DBM caching extention  (thanks ahØartemis*dk)
      New file: /getid3/extention.cache.dbm.php
    » Added sha1_data hash option  (thanks ahØartemis*dk)
    » Added option to allow getID3() to skip ID3v2 without parsing it
      for faster scanning when ID3v2 data is not required. If you
      want to enable this feature delete /getid3/module.tag.id3v2.php
      (thanks ahØartemis*dk)
    ¤ 8-bit WAV data now calculates MD5 checksums as normal, not
      converting to signed data as before, so stored md5_data_source
      in FLAC files will no longer match md5_data for the equivalent
      decoded 8-bit WAV. A warning will be generated for 8-bit FLAC
      files
    ¤ Added option_no_iconv option to allow getID3() to work
      partially without iconv() support enabled in PHP
      (thanks ahØartemis*dk)
    ¤ All '*_ascii' keys removed for ASF/WMA/WMV files
    ¤ All 'ascii*' keys removed for ID3v2 tags
    ¤ Ogg filetypes now return MIME of "application/ogg" instead of
      the previous "application/x-ogg"
      (thanks blakewattersØusers*sourceforge*net)
    ¤ Force contents of ['id3v2']['comments'] to UTF-8 format from
      whatever encoding each frame may have (text encoding can vary
      from frame to frame in ID3v2)
    ¤ MP3Gain information from APE tags suppressed from ['tags'] and
      parsed into ['replay_gain']
    ¤ ReplayGain information (all formats) changed from "Radio" and
      "Audiophile" to "Track" and "Album" respectively
    ¤ ['volume'] and ['max_noclip_gain'] are now available in both
      ['replay_gain']['track'] and ['replay_gain']['album'] for all
      formats that calculate ReplayGain.
    ¤ ['video']['total_frames'] is available for AVIs
    ¤ All parsed ID3v2 frame data is now in ['id3v2'][XXXX][#]
      (previously some frame types would have numeric array keys if
      multiple instances of that frame type were allowed and other
      frame types would not)
    ¤ ASF/WMA "WM/Picture" images are now parsed in the same manner
      as ID3v2 with the image (ex JPEG) data returned in [data]
      rather than [value]
    * Bugfix: Optional tag processing options were being ignored (ie
      ID3v1 still processed even if option_tag_id3v1 == false)
      (thanks ahØartemis*dk)
    * Bugfix: fixed MultiByteCharString2HTML() for UTF-8
    * Bugfix: Quicktime files not always reporting video frame_rate
    * Bugfix: False ID3v1 synch patterns in APE or Lyrics3 tags are
      now detected and incorrect ID3v1 data not returned
      (thanks sebastian_maresØusers*sourceforge*net for the idea)
    * Bugfix: WMA9 Lossless now reported as lossless
    * Bugfix: two typos in ID3v1 genre list
    * Bugfix: MPEG-2/2.5 ABR/VBR MP3 files had doubled playtime
    * Bugfix: MPEG-2/2.5 LayerII (ie MP2: 24/22.05/16kHz) files were
      not detected due to incorrect frame length calculation
    * Bugfix: MPEG LayerI files were not detected due to incorrect
      frame length calculation (must be multiple of slot length)
    Added alternative md5_data via system call - twice as fast. Needs
      "getID3()-WindowsSupport" to work under Windows.
      (thanks ahØartemis*dk)
    ID3v2.4 compressed frames are now supported
    php_uname() calls changed to use PHP_OS constant
    Added SCMPX extensions to ID3v1 genres (0xF0-0xFE)
    Obfuscated contributor email address in changelog and sourcecode
    Added memory-saving EmbeddedLookup() function for lookup tables
      in RIFF and ID3v2 modules (thanks ahØartemis*dk)
    Major memory patches to many modules by using
      $var = &$INFO_ARRAY_AT_SOME_INDEX
      in place of large multi-dimensional array declarations.
      Memory saved:  RIFF: ~200kB;  ID3v2: ~475kB;  ASF: ~50kB  etc.
      (thanks ahØartemis*dk)


1.7.0b4: [November-19-2003] James Heinrich
   » Support added for MPC files with old SV4-SV6 structure
   » RealVideo now properly supported with resolution, framerate, etc
     (thanks jcsston)
   » RealAudio files with old-style file format (v2-v4) are now
     fully supported
   » Support added for DolbyDigital WAV files (thanks ahØartemis*dk)
   ¤ ['RIFF'] is now ['riff'] to conform to make all root key names
     lowercase
   ¤ ['OFR'] is now ['ofr'] to conform to make all root key names
     lowercase
   ¤ ['tags_html'] is now available as a copy of ['tags'] but
     with all text replaced with an HTML version of all characters
     above chr(127), translated according to whatever the encoding
     of the source tag is, in the HTML form &#1234;
   ¤ CopyTagsToComments() is now available in getid3_lib
   ¤ QuicktimeVR files now return a ['video']['dataformat'] of
     'quicktimevr' instead of 'quicktime' (thanks gtsØtsu*biz)
   ¤ Quicktime video files with DivX, Xvid, 3ivx or MPEG4 video
     streams now return those names as ['video']['dataformat']
   ¤ MPEG video files are now identified with ['video']['codec'] set
     to either 'MPEG-1' or 'MPEG-2' (rather than just 'MPEG'). If you
     see a file wrongly identified, please report it!
     (thanks fccHandler)
   ¤ All bitrate values in ['mpeg']['audio'] is now reported in bps
     rather than kbps (ie 128000 instead of 128) for consistancy
   ¤ AVIs with MP2 audio now report ['audio']['dataformat'] as 'mp2'
     rather than 'wav'  (thanks metalbrainØnetian*com)
   ¤ Added ['md5_data_source'] for OptimFROG
   ¤ AC3 in RIFF-WAV now identified with ['audio']['dataformat']
     returning 'ac3'
   ¤ WavPack ['extra_bc'] now returned as integer
   ¤ WavPack ['extras'] now returned as 3-element array of integers
   ¤ MP3 ['audio']['encoder options'] now returns 'VBR' or 'CBR' only
     (no bitrate) if no LAME preset is used, or 'VBR q??' where ?? is
     a number 0-100 for Fraunhofer-encoded VBR MP3s
   * Bugfix: VBR MP3s could have incorrect bitrate reported
   * Bugfix: Quicktime files with MP4 audio were not returning
     ['video']['dataformat'] (thanks robØmassive-interactive*nl)
   * Bugfix: strpad vs str_pad typo in module.riff.php
     (thanks nicojunØusers*sourceforge*net)
   * Bugfix: ReplayGain information was often wrong for MPC files
   * Bugfix: MD5 and other post-TAIL chunks were not being processed
     in module.audio.optimfrog.php
   * Bugfix: Undefined variable in table_var_dump() in demo/check.php
   * Bugfix: QuickTime files now only return information in [audio]
     or [video] if those exist in the file
   * Bugfix: WavPack no longer tries to read entire compressed data
     chunk
   * Bugfix: Properly handle VBR MP3s with "Info" (rather than
     "Xing") header frame. foobar2000 adds this to MP3 files when
     "Fix MP3 Header" function is used (thanks ahØartemis*dk)
   * Bugfix: Fraunhofer VBRI headers for MP3s were assuming 2-byte
     entries for TOC rather than using stride, and were ignoring the
     scaling value. (thanks sebastianØmaresweb*net)
   Several QuickTime atoms have been added to an exclusion list
     because they have been observed, but I have no idea what they
     are supposed to do so I can't add real support for them, but
     they should not generate warnings (robØmassive-interactive*nl)
   Old MPC encoder (before v1.06) was return as v0.00, now returned
     as 'Buschmann v1.7.0-v1.7.9 or Klemm v0.90-v1.05'
     (thanks ahØartemis*dk)
   Added check for magic_quotes_runtime and code to disable it if
     neccesary (thanks stefan*kischkelØt-online*de)
   Added 3ivx fourCCs to module.audio-video.quicktime.php
   MP3 and AC3 streams are now parsed when contained inside RIFF-WAV
     or RIFF-AVI container formats
   Better detection of named presets in LAME 3.93/3.94


1.7.0b3: [October-17-2003] James Heinrich
   » AC-3 (aka Dolby Digital) is now supported.
     New file: /getid3/module.audio.ac3.php
   * Bugfix: ID3v2-writing function Unsynchronise() was broken, which
     made ID3v2 tag containing binary data (typically pictures) get
     corrupted. (thanks t*coombesØbendigo*vic*gov*au,
     i*kuehlbornØndh*net, mikeØdelusion*org, mikeØftl*com)
   * Bugfix: Zip comments now returned as array instead of string,
     as they're supposed to be.
   * Bugfix: Quicktime/MP4 files may have reported extremely low
     bitrates (thanks spunkØdasspunk*com)
   Improved double-ID3v1 check to prevent false detection when string
     "TAG" is present in APE or Lyrics3
   Fixed /demo/simple.php
   Fixed /demo/joinmp3.php
   Fixed /demo/mimeonly.php
   Fixed /demo/write.php


1.7.0b2: [October-15-2003] James Heinrich
   » TTA Lossless Audio Compressor format now supported.
     (http://tta.iszf.irk.ru)
     New file: /getid3/module.graphic.tta.php
   » PhotoCD (PCD) format now supported. Image data for the three
     lowest resolutions (192x128, 384x256, 768x512) can be optionally
     extracted.
     New file: /getid3/module.graphic.pcd.php
   ¤ RIFF-MP3 files now should return the same ['md5_data'] as the
     identical MP3 file outside the RIFF container
   ¤ Name of LAME preset used (if available, needs LAME v3.90+)
     returned in ['mpeg']['audio']['LAME']['preset_used'] and also as
     part of ['audio']['encoder_options']
   ¤ VQF module now sets ['audio']['encoder_options'] to i.e. CBR96
   ¤ MP3 module now sets ['audio']['encoder_options'] on CBR files
     and all LAME-encoded files
   ¤ MPC module now sets ['audio']['encoder_options']
   ¤ Monkey module now sets ['audio']['encoder_options']
   ¤ AAC module now sets ['audio']['encoder_options'] to profile name
   ¤ ASF module now sets ['audio']['encoder_options']
   ¤ Ogg module adds ['audio']['encoder_options'] -b 128 on
     Ogg Vorbis 1.0+ ABR files
   ¤ Ogg module adds ['audio']['encoder_options'] -q N   on
     Ogg Vorbis 1.0+ VBR files 44k/48k sample rate/stereo files only.
   ¤ Ogg module ['audio']['encoder_options'] "Nominal birate: 80k" to
     other Ogg Vorbis files.
   ¤ ID3v2 track number now returned as string (with leading zeros,
     if present in data) rather than integer (thanks Plamen)
   ¤ ASF module returns ['asf']['comments']['encoding_time_unix'] if
     available (from WM/EncodingTime)
   ¤ Fixed /demo/mysql.php and added some new features:
     - encoder options
     - ID3v2 "Encoded By"
     - non-empty comments
     - total entries in database summary (totals & averages)
     - database version update
   * Bugfix: 'UNICODE' iconv() charset changed to 'UTF-16LE' or
     'UTF-16BE' as appropriate
   * Bugfix: iconv_fallback() function created in case iconv() fails
   * Bugfix: fixed MD5 calls in demo/check.php
   * Bugfix: reenabled detection of APE + Lyrics3 tags in same file
   * Bugfix: ASF module now returns ID3v1 genre as string instead of
     number - patch from Eugene Toder.
   * Bugfix: ASF module now reads non-standard field names,
     i.e. "date" as well as WM/Year - patch from Eugene Toder.
   * Bugfix: ASF module now returns genre as-is if it is not a
     standard ID3v1 genre (thanks wonderboy)
   * Bugfix: Eliminated false-synch problem in MP3 module
   * Bugfix: Fixed missing root ['bitrate'] for most formats
   * Bugfix: ['audio']['compression_ration'] missing for MPC
     (thanks WaldoMonster)
   * Bugfix: NSV module died in 1.7.0b1
   * Bugfix: ASF module died in 1.7.0b1 when WM/Picture preset
   * Bugfix: ASF tracknumber incorrect when specified by WM/Track
     rather than WM/TrackNumber (thanks jgriffiniiiØhotmail*com)
   * Bugfix: MPEG audio+video playtime should now be pretty accurate
     (ie within 0.1% variation at most)
     (thanks mgrimmØhealthtvchannel*org)
   * Bugfix: ID3v2 not being copied to ['tags'] in some cases
   * Bugfix: LAME CBR files with Info tag were being incorrectly
     flagged as VBR (thanks Jojo)
   * Bugfix: LAME tag not being detected for LAME 3.90 (original)
   Changed regex pattern match for MP3 to include 3rd byte for more
     reliable/accurate pattern matching
   Added duplicate-ID3v1 tag checking (two ID3v1 tags, one after the
     other) that has been known to occur with iTunes
     (thanks towbØtiscali*de)
   Added instructions for enabling iconv() support under Windows
   Removed some unneccesary debugging code
   Suppressed duplicate PHP warnings for missing include files
   Included some missing dependencies in various files
   /demo/audioinfo.class.php now copies ['audio']['encoder_options']


1.7.0b1: [2003-09-28] Allan Hansen
   This beta version was not made by James Heinrich. It was made by
   Allan Hansen <ahØartemis*dk> - please send bug reports on this
   beta directly to me.

   James Heinrich will release 1.7.0 final, but it may take some time
   to work out the bugs from the major rewrite.

   This version could be called getID3lite. It makes a lot of checks
   optional and makes it easy to remove support for undesired formats

   It also is more library-like. Older versions of getID3() declared
   an incredible amount of global scope functions and defined several
   constants. 1.7.0beta1 still declares constants, but they are all
   prepended by GETID3_. It declares no global scope functions - they
   are all wrapped into classes.

   » Made getID3() depend on iconv library: compile PHP --with-iconv
   » Created new directory structure
       Moved all demos to demos/
       Moved all getID3() files to getid3/
       Renamed most files to module.something
       Changed header in all module.something to explain what they do
       Simply remove all modules you don't need
       Wrapped all modules into classes
   * Bugfix: Implemented misc patches from Eugene Toder
   * Bugfix: Implemented misc patches from "six"
   ¤ Added root key 'encoding'
   ¤ Added prefix GETID3_ to all defined constants.
   ¤ Wrapped getid3.php into getid3 class
   ¤ Wrapped getid3.functions.php into getid3_lib class
       Removed unused functions
       Moved several functions away from getid3.functions.php and
         into the files where they are actually used.
       Renamed getid3.functions.php to getid3.lib.php
       Moved getid3.rgad.php functions into getid3_lib
       Moved getid3.getimagesize.php funcitons ingo getid3_lib
   ¤ Moved getid3.ogginfo.php into ogg module
   ¤ Combined GetTagOnly() and GetAllFileInfo() in method analyze
   ¤ Removed redundant and unuseful root keys
       'file_modified_time' == filemtime($filename)
       'md5_file' == md5_file($filename)
       'exist' == file_exists($filename)
   ¤ Changed root key ['tags'] from array of string to array of array
     of comments.
   Simplified code for detecting base path.
   Removed ob_ from InitializeFilepointerArray(). That was really a
     ugly HACK to get output from fopen. If user want the reason,
     he should open the file himself!
   Checking for APE tags before lyrics3 - makes Lyrics3 not depend
     on APE tag. It seems to work on my test file.
   Changed ['error'] and ['warning'] in multiple files to append to
     array instead of appending to string. That simplified code in
     getid3.php too.
   Simplified clean-up procedure: simply remove all empty root keys
   Setting tags in individual modules instead of main getid3.php
   Made Bonk and ASF modules non-dependent on id3 modules - id3
     optional.
   Rewrote HandleAllTags() - simplified and convert comments to
     desired encoding.
   Replaced all calls to RoughTranslateUnicodeToASCII() in ASF module
     with a TrimConvert() method. This uses iconv() for conversion.
     It also converts from UNICODE instead of UTF-16BE, as the spec
     says it should.
   Replaced all calls to RoughTranslateUnicodeToASCII() in id3v2
     module with iconv(). id3v2 module also reads
     $ThisFileInfo['encoding'] and converts all comments to this
     format. All other formats just add their comments in their
     native charset, but every comment field in id3v2 can have a
     different encoding, so this is needed.
   Did same thing as above with ISO module. However - it does not
     work. I need to find out how to specify big-endian unicode !=
     UNICODING encoding name given to iconv().
   Built-in assume mp3 format in getid3.php
   Temporarily nuked root key ['comments'] and CopyCommentsToRoot()
   Updated demo/audioinfo.class.php
   Updated demo/check.php - some thing don't work!
   Other demos are out of order!


1.6.5: [October-06-2003] James Heinrich
   » Added support for LiteWave (thanks supportØclearjump*com)
   Ø Split out speedup info from ['OFR']['OFR']['compression'] into
     ['OFR']['OFR']['speedup']
   Ø If EXIF functions for JPEG not available, now warning not error
   Ø ID3v2 track number now returned as string (with leading zeros,
     if present in data) rather than integer (thanks Plamen)
   * Bugfix: now correctly parses cbSize element of WAVEFORMATEX
     structure (thanks supportØclearjump*com)
   * Bugfix: ASF module now reads non-standard field names,
     i.e. "date" as well as WM/Year - patch from Eugene Toder.
   * Bugfix: ASF module now returns genre as-is if it is not a
     standard ID3v1 genre (thanks wonderboy)
   * Bugfix: ['audio']['compression_ration'] missing for MPC
     (thanks WaldoMonster)
   Prevent infinite loop in MP3 histogram if framelength == 0
   Added wFormatTag values 0x00FF and 0x2001 - 0x2005
     (thanks steveØheadbands*com)
   Added "twos" and "sowt" FourCCs for Mac AIFC


1.6.4: [June-30-2003] James Heinrich
   » Added support for free-format MP3s
     (thanks Sebastian Mares for the idea)
   » Compressed (Flash 6+) SWF files are now handled properly
     (thanks alan*cheungØalumni*ust*hk)
   » Added DeleteLyrics3() to getid3.lyrics3.php
   » Added FixID3v1Padding() to getid3.putid3.php
   » Added new simple MP3-splicing sample file
     (thanks tommybobØmailandnews*com for the idea)
     New file: getid3.demo.joinmp3.php
   » Moved all contents of getid3.putid3.php into either
     getid3.id3v1.php or getid3.id3v2.php or getid3.functions.php as
     appropriate
     Removed file: getid3.putid3.php
   ¤ ['error'] and ['warning'] keys now return as arrays, not strings
   ¤ New root key for all files: ['file_modified_time'] (UNIX time)
   ¤ getid3.demo.scandir.php renamed to getid3.demo.mysql.php
   ¤ New demo file returns the MIME type only for a single file
     (thanks adminØe-tones*co*uk for the idea)
     New file: getid3.demo.mimeonly.php
   ¤ Added check for valid ID3v1 padding (strings should be padded
     with null characters but some taggers incorrectly use spaces).
     A warning will be generated if padding is invalid. New boolean
     key ['id3v1']['padding_valid'] indicates padding validity.
   ¤ CleanUpGetAllMP3info() removes more useless root keys for
     unknown-format files
   ¤ Extended LAME information in ['mpeg']['audio']['LAME'] is now
     only returned for LAME v3.90+
   ¤ LAME-encoded MP3s now return
     ['mpeg']['audio']['LAME']['long_version'] as well as
     ['mpeg']['audio']['LAME']['short_version'] - these are identical
     in LAME v3.90+ but older versions will report longer more
     detailed version information if available
   ¤ New Lyrics3 values: ['lyrics3']['raw']['offset_start'] and
     ['lyrics3']['raw']['offset_end']
   ¤ New optional parameter on getAPEtagFilepointer() to scan from a
     defined offset rather than end-of-file to allow scanning of APE
     tags before Lyrics3 tags
   ¤ ['tag_offset_start'] and ['tag_offset_end'] are now present in
     ['ape'], ['lyrics3'], ['id3v1'] and ['id3v2']
   ¤ Numerous changes to the returned structure and content for La
     files, including parsing the seektable (if applicable) and
     parsing RIFF data occuring after the end of the compressed audio
     data (notably RIFF comments)
     (thanks mikeØbevin*de)
   ¤ getSWFHeaderFilepointer() now has optional 3rd parameter
     $ReturnAllTagData (default == false) which if set to true will
     return data on all tags in ['swf']['tags']
   ¤ ['swf']['bgcolor'] now returns the 6-character string
     representing the background color in HTML hex color format
     (thanks ubergeekØubergeek*tv)
   ¤ ['swf']['header']['frame_delay'] is no longer returned
   ¤ getQuicktimeHeaderFilepointer() now has two additional optional
     parameters: $ReturnAtomData (default == true) and
     $ParseAllPossibleAtoms (default == false). Setting
     $ReturnAtomData to false will reduce the size of the returned
     data array by unsetting ['quicktime']['moov'] before returning.
     Leaving $ParseAllPossibleAtoms as false now suppresses parsing
     of several atom types that contain very large tables of data
     that are not typically useful. Atom type suppressed are:
     stts, stss, stsc, stsz, and stco
     (thanks ubergeekØubergeek*tv)
   ¤ ['fileformat'] no longer set to 'id3' if ID3v1 or ID3v2 tag
     detected but no other data format recognized
   * Bugfix: La files now return the correct values for
     ['avdataoffset'] and ['avdataend'] and therefore the correct
     values for ['md5_data'] - note that ['md5_data'] values will not
     match values from previous versions of getID3() - the previous
     versions were incorrect
     (thanks mikeØbevin*de)
   * Bugfix: A temporary file was being created in the web server's
     root directory (not DocumentRoot) each time ['md5_data'] was
     calculated, and not removed due to lack of permissions. Temp
     file is now created (as it was supposed to be) in the directory
     of the file being examined, or the system temp directory, and
     properly removed when done.
   * Bugfix: Several incorrect values were being returned inside
     ['mpeg']['audio']['LAME'] (thanks bouvigneØmp3-tech*org)
   * Bugfix: SWF frame rates values were usually incorrect.
     (thanks alan.cheungØalumni*ust*hk and ubergeekØubergeek*tv)
   * Bugfix: ID3v2.2 files always flagged 4 bytes of invalid padding
     (thanks marcaØmac*com)
   * Bugfix: Lyrics3 without ID3v1 was not working properly
   * Bugfix: Lyrics3, APE & ID3v1 can all now exist in the same file.
     A warning is issued if APE comes after Lyrics3 (because Lyrics3-
     aware taggers probably are not APE-aware and therefore won't be
     able to find the Lyrics3 tag)  (thanks mp3gainØhotmail*com)
   * Bugfix: WriteAPEtag() now writes the APE tag before any Lyrics3
     tags (if present) and removes any incorrect ones that are after
     existing Lyrics3 tags  (thanks mp3gainØhotmail*com)
   * Bugfix: RIFF-WAVE file with incorrect NumberOfSamples values in
     the 'fact' chunk no longer cause incorrect playtime calculation
     (thanks stprasadØindusnetworks*com)
   * Bugfix: getid3.demo.simple.php had undefined variables if the
     file needed to be deep-scanned with assumeFormat
   * Bugfix: fixed previously-incorrect ['avdataend'] values for APE
     and Lyrics3 tags in some cases, which in some cases means that
     ['md5_data'] is different than previously (now correct)
   Much-improved detection of AAC-ADTS, which also means MP3
     format detection should now be nearly twice as fast
   Truncated AVIs and WAVs are now reported
   Number of new features and bugfixes in getid3.demo.mysql.php
   Quicktime 'meta' atoms now parsed, so Quicktime MP4 files can now
     return artist, title, album, etc  (thanks spunkØdasspunk*com)
   Consolidated all comments processing functions (processing the
     ['comments'] and ['tags'] keys) into HandleAllTags() which now
     also checks to ensure that APE tags are really better than ID3v2
     before using them in ['comments']
   Known issue with Meracl ID3 Tag Writer v1.3.4 truncating last byte
     of MP3 file when appending new ID3v1 tag now specifically noted
     (rather than generic Probably Truncated File message)
   getid3.demo.mysql.php now stores last-modified time for each file
   getid3.demo.mysql.php is now case-sensitive for filenames
   getid3.demo.mysql.php can generate M3U playlists of any of the
     groups of files it can select (duplicate filenames, tag types,
     etc.)
   getid3.demo.mysql.php can now find mismatched tag contents and
     filenames
   getid3.demo.check.php now shows total number of errors & warnings
   GetFileFormatArray() now matches actual patterns for MP3 files
     based on the first two bytes of the file, rather than just the
     first one
   Simplified DeleteAPEtag() and made it work properly with Lyrics3


1.6.3: [May-17-2003] James Heinrich
   » Added support for Bonk  (thanks ahØartemis*dk)
     New file: getid3.bonk.php
   » Added support for AVR  (thanks ahØartemis*dk)
     New file: getid3.avr.php
   ¤ Contents of getid3.id3.php moved to getid3.id3v1.php
     Removed file: getid3.id3.php
   ¤ Contents of getid3.frames.php moved to getid3.id3v2.php
     Removed file: getid3.frames.php
   ¤ Returned data structure documentation improved and updated and
     now stored in getid3.structure.txt rather than getid3.readme.txt
     New file: getid3.structure.txt
   ¤ Now including the GNU General Public License in the distribution
     as getid3.license.txt
     New file: getid3.license.txt
   ¤ Added new, optional, parameter to WriteAPEtag() (and also
     GenerateAPEtag()) which must be set to TRUE if the values you
     are passing are already UTF8-encoded, otherwise all data is
     encoded to UTF8 by default. For all ASCII/ANSI data this value
     should be left at the defaul value of FALSE.
   ¤ Added third, optional, parameter to getID3v2Filepointer() -
     $StartingOffset (default == 0) which can parse an ID3v2 tag
     in a file at a position other than the start-of-file.
   ¤ ['video']['pixel_aspect_ratio'] now returned when known
   ¤ AVI files with WMA audio now return ['audio']['dataformat']
     of 'wma' rather than 'wav'
   ¤ ASF-WMA files now return the artist value from WM/AlbumArtist
     in ['comments']['artist']  (thanks msibbaldØsaebauld*com)
   ¤ ASF-WMA files now return the 'author' value from
     ['asf']['content_description'] in ['comments']['artist']
     instead of ['comments']['author']
   ¤ ASF-WMA files now return the 'description' value from
     ['asf']['content_description'] in ['comments']['comment']
     instead of ['comments']['description']
   * Bugfix: APE tag writing with multiple values for a tag (more
     than one ARTIST for example) was not being correctly written
     (thanks ahØartemis*dk)
   * Bugfix: CreateDeepArray() was returning an empty-string key as
     the top-level returned value - ['iso']['files'] now directly
     contains the file listing without an empty array in between.
   * Bugfix: ID3v2 genreid was not being returned in some cases.
   * Bugfix: APEv1 tags would generate error messages
   * Bugfix: APE tags would sometimes show phantom second entry for
     each item (title, artist, etc) with no data
   * Bugfix: APE tag writing was not UTF8-encoding the data -
     non-ASCII characters (above chr(127)) were being incorrectly
     stored  (thanks ahØartemis*dk)
   * Bugfix: getid3.demo.scandir.php had undefined function error
   * Bugfix: getid3.demo.scandir.php would not display list of files
     with no tags
   Added link to getid3.demo.check.php from list of specific-tags
     files in getid3.demo.scandir.php


1.6.2: [May-04-2003] James Heinrich
   » New official mirror site for getID3() - https://www.getid3.org
   » Added basic support for SWF (Flash)  (thanks n8n8Øyahoo*com)
     New file: getid3.swf.php
   » Added experimental support for parsing the audio portion of
     MPEG-video files. I don't have any actual documentation for
     this, so this part is experimental and not guaranteed accurate,
     but it seems to be working OK as far as I have been able to test
     it. Bug reports (or even better - documentation!) are welcome at
     info@getid3.org
   » Added new simple directory-scanning sample file
     New file: getid3.demo.simple.php
   » getid3.demo.write.php now writes APE tags as well.
   ¤ Renamed getid3.write.php to getid3.demo.write.php
   ¤ Renamed audioinfo.class.php to getid3.demo.audioinfo.class.php
   ¤ getid3.php now automatically includes the getid3.functions.php
     function library file, no need to include it seperately.
   ¤ getLyrics3Filepointer() has been changed to be consistant with
     all the other similar function structures - the parameters have
     changed. The old function has been renamed to getLyrics3Data()
   ¤ Added DeleteAPEtag() function to getid3.ape.php
   ¤ HandleID3v1Tag() now only handles ID3v1. Lyrics3 processing is
     now done by HandleLyrics3Tag()
   ¤ If BitrateHistogram is enabled in getOnlyMPEGaudioInfo() it now
     also returns ['mpeg']['audio']['version_distribution'] showing
     the number of frames of each MPEG version (1, 2 or 2.5) - all
     frames *should* be of the same MPEG version
   ¤ getID3v1Filepointer() always returns TRUE now, even if it didn't
     find a valid ID3v1 tag
   ¤ getOnlyMPEGaudioInfo() now looks for MPEG sync in the first 128k
     bytes rather than the first 64k bytes
   ¤ Added dummy function GetAllMP3info() to generate warning not to
     use that deprecated function.
   ¤ ['video']['codec'] is now 'MPEG' for all MPEG video files (this
     will change to 'MPEG-1' or 'MPEG-2' as soon as I figure out how
     to determine that)  (thanks jigalØspill*nl)
   ¤ ['mpeg']['audio']['LAME']['mp3_gain'] renamed to
     ['mpeg']['audio']['LAME']['mp3_gain_db'] (gain in dB)
   ¤ Added ['mpeg']['audio']['LAME']['mp3_gain_factor'] (gain as a
     multiplication factor)
   ¤ Added support for Preset and Surround Info bytes from LAME VBR
     tag (http://gabriel.mp3-tech.org/mp3infotag.html)
   * Bugfix: APE tag writing would put the string 'Array' for all
     values rather than the actual data  (thanks ahØartemis*dk)
   * Bugfix: Warning now generated for VBR MPEG-video files because
     getID3() cannot determine average bitrate. If you know of
     documentation that would tell me how to do this, please email
     info@getid3.org
   * Bugfix: Replay Gain values from Vorbis comments are now
     returned in ['replay_gain'] (and not in ['comments'])
     (thanks ahØartemis*dk)
   * Bugfix: Replay Gain values from APE comments are now correctly
     returned in ['replay_gain']  (thanks ahØartemis*dk)
   * Bugfix: getid3.demo.check.php is now case-insensitive when
     assuming a format for a corrupted file if standard detection
     does not identify the file type.
   * Bugfix: RIFF comments were overwriting/suppressing ID3 comments
     for RIFF-MP3 files  (thanks wmØwofuer*com)
   * Bugfix: RIFF-MP3 files with 'RMP3' chunks instead of 'WAVE' were
     not being correctly identified.
   * Bugfix: ID3v2 padding shorter than the length of an ID3v2 frame
     header was not correctly detected
   * Bugfix: getid3.demo.check.php now does in-depth scanning for MP2
     and MP1 files the same as for MP3 files based on file extension
     if a MPEG-audio structure isn't found immediately at the start
     of the file
   * Bugfix: removed condition where RIFF-WAV was being scanned for
     MPEG-audio signature when it shouldn't be present (non-MP3 WAV)
   * Bugfix: ASF files were not always showing correct audio datatype
   * Bugfix: array_merge_clobber() and array_merge_noclobber() were
     not being conditionally defined in getid3.functions.php
     (thanks rich.martinØreden-anders*com)
   * Bugfix: stream_numbers was not being correctly returned in
     bitrate_mutual_exclusion_object chunks of ASF files
   * Bugfix: Added support for 24kHz and 12kHz audio in ASF files
   * Bugfix: Removed possible undefined offset error in MP3s where
     cannot find synch before end of file
   * Bugfix: Removed potential out-of-memory crash situation when
     parsing Real files with chunks larger than the available memory
     (thanks jigalØspill*nl)
   * Bugfix: ID3v1 was incorrectly taking precedence over ID3v2 in
     the ['comments'] array (thanks lionelflØwanadoo*fr)
   * Bugfix: No longer calculates overall bitrate and playtime for
     VBR MPEG video files based on the audio bitrate.
   * Bugfix: AssumeFormat was not working properly
   Added summary footer line to getid3.demo.check.php
   Added '.mpeg' to the list of assume-format-from-filenames list in
     getid3.demo.check.php
   MPEG-video files now more reliably detected
   A number of additional features have been added to
     getid3.demo.scandir.php
   Added many RIFF-AVI audio types and fourcc video types to the
     lookup functions in getid3.riff.php
   Now identifes files with Lyrics3 v1 tags that are of incorrect
     length (v1 Lyrics3 is supposed to be 5100 bytes long, but
     [unknown program] writes variable-length tags (which is illegal
     for Lyrics3 v1)). getID3() now correctly parses these tags and
     issues a warning.
   Split GetFileFormat() to GetFileFormat() and GetFileFormatArray()
   HTML colors in getid3.demo.check.php are now defined as constant
     variables at the top of the file (if you want to change them)
   Added support for OptimFROG v4.50x (non-alpha) (new header fields)
     (thanks floringhidoØyahoo*com)
   Added support for Lossless Audio v0.4 (thanks mikeØbevin*de)


1.6.1: [March-03-2003] James Heinrich
   » Added support for writing APE v2.
     WriteAPEtag() in getid3.ape.php
     NOTE: APE v1 writing support will *not* be added to future
     versions of getID3()
     (thanks ahØartemis*dk and adamØphysco*com for the idea)
   » Added support for AIFF (Audio Interchange File Format) including
     AIFF, AIFC and 8SVX  (thanks ahØartemis*dk for the idea)
     Removed file: getid3.aiff.php
   » Added support for OptimFROG (v4.50a and v4.2x)
     (thanks ahØartemis*dk for the idea)
     New file: getid3.optimfrog.php
   » Added support for WavPack  (thanks ahØartemis*dk for the idea)
   » Added support for LPAC  (thanks ahØartemis*dk for the idea)
   » Added support for NeXT/Sun .au format
     New file: getid3.au.php
   » Added support for Creative SoundBlaster VOC format
     New file: getid3.voc.php
   » Added support for the BWF (Broadcast Wave File) RIFF chunks
     "bext" and "MEXT"  (thanks Ryan and njhØsurgeradio*co*uk)
   » Added support for the CART (Broadcast Wave File) RIFF chunks
     (thanks Ryan)
   » Added getid3.demo.scandir.php - a sample recursive scanning demo
     that scans every file in a given directory, and all sub-
     directories, and stores the resulting data in MySQL database,
     and then displays a list of duplicate files based on md5_data
   ¤ ['md5_data_source'] now contains the MD5 value for the original
     uncompressed data for formats that store that information
     (currently only FLAC v0.5+). ['md5_data'] (if chosen to be
     calculated) will contain the calculated MD5 value for the
     compressed file. To check if 2 files are identical in every way,
     including all comments: compare ['md5_file']. To check if two
     files were compressed from the same source file: compare
     ['md5_data_source']. To check if the compressed audio/video data
     of two files is identical, even if comments or even the
     container file format is different (MP3 in RIFF container,
     FLAC in Ogg container, etc): compare ['md5_data'].
   ¤ ['md5_data'] for 8-bit WAV files is now calculated based on a
     converted version of the data from unsigned to signed (MSB
     inverted) to match the MD5 value calculated by FLAC
   ¤ New optional parameter added to GetAllFileInfo() -
     $MD5dataIfMD5SourceKnown (default: false). If false the md5_data
     value will NOT be calculated for files (such as FLAC) that have
     ['md5_data_source'] set, even if $MD5data == true.
     (thanks ahØartemis*dk)
   ¤ getid3.check.php renamed to getid3.demo.check.php
   ¤ Added GetTagOnly() function to getid3.php - similar to
     GetAllFileInfo() except only takes a filename as a parameter and
     only returns ID3v2, APE, Lyrics3 and ID3v1 tag information - no
     attempt is made to parse the data contents of the file at all.
     (thanks Phil for the idea)
   ¤ Added ['audio']['lossless'] and ['video']['lossless'] for all
     formats (when known). Both are boolean values - true means the
     data is lossless-compressed, false means the data is lossy-
     compressed.
   ¤ Added ['audio']['compression_ratio'] and/or
     ['video']['compression_ratio'] for all formats. Returns a number
     (usually) less than 1, where 1 represents no compression and 0.5
     represents a compressed file half the size of the original file
   ¤ Added ['video']['bits_per_sample'] to all video formats (when
     known)
   ¤ Added ['video']['frame_rate'] to all video formats (when known)
   ¤ ['fileformat'] set to 'mp1' or 'mp2' instead of 'mp3' when
     ['audio']['dataformat'] is one of those  (thanks ahØartemis*dk)
   ¤ Added 4th parameter to md5_data(), $invertsign, which will invert
     the MSB of each byte before MD5'ing. This is needed for 8-bit
     WAV files because FLAC calculates the stored MD5 value on
     signed data rather than the original byte values. ['md5_data']
     of an 8-bit WAV will now match the ['md5_data_source'] value
     (thanks lichvarmØphoenix*inf*upol*cz)
   ¤ ['ape']['items']['data'] and ['ape']['items']['data_ascii'] now
     contains an array of values, if the tag contains UTF-8 text (as
     opposed to binary data)
   ¤ ['mpeg']['audio']['bitratemode'] renamed to
     ['mpeg']['audio']['bitrate_mode']
   * Bugfix: Removed potential bug that could replace all MP3 file
     contents with only the new ID3v2 tag in getid3.putid3.php
   * Bugfix: md5_data values calculated for RIFF (WAV, AVI) files
     were incorrect  (thanks ahØartemis*dk)
   * Bugfix: MP3 data in an MP4 wrapper fileformat could not identify
     bitrate  (thanks ahØartemis*dk)
   * Bugfix: ['audio'] and/or ['video'] keys would sometimes get
     removed even if not empty
   * Bugfix: Prevented creation of null entries in
     ['RIFF']['WAVE']['INFO'] if a comment entry was not present
   * Bugfix: Potential infinite-loop condition in getid3.ogg.php
     (thanks afshin.behniaØsbcglobal*net)
   * Bugfix: Ogg files with illegal ID3v1 (and/or APE or Lyrics3)
     tags were not finding the last Ogg page
     (thanks afshin.behniaØsbcglobal*net)
   * Bugfix: replay-gain values not properly set from LAME tag
   * Bugfix: RIFF-MP3 had incorrect md5_data
   * Bugfix: the LAME DLL CBR problem of not re-writing the LAME
     frame at the beginning of the data is now detected for MP3s
     with ID3v2 tags as well
   * Bugfix: APE tags with multiple values (ie multiple entries in
     the "artist" tag) are now shown properly in ['ape']['items']
   * Bugfix: fixed condition where APE tag with no ID3v1 tag could be
     mistaken for APE tag with ID3v1 (and incorrectly parsed)
   * Bugfix: added warning if ID3v2 frame has zero-length data
     (thanks cmassetØclubinternet*fr)
   * Bugfix: getid3.frames.php looking for non-existant key in USER
     frames
   Improved detection of RIFF-MP3 data. [unknown program] encodes
     RIFF-WAV data with a chunk name of 'RMP3' instead of the
     standard 'RIFF'
   Encoder now returned in both ['comments'] and ['audio']['encoder']
     for RIFF-WAV files with an INFO.ISFT chunk
   Generate a warning for FLAC files encoded with v0.3 or v0.4
     because audio_signature is not calculated during encoding
     (thanks ahØartemis*dk)
   Modified getid3.check.php to display md5_data_source as well as
     md5_file and md5_data if display-MD5 mode is selected
   Modified getid3.check.php to assume-format based on file extension
     in browse mode if fileformat is found to be 'id3' (formerly only
     if the fileformat was null)
   Changed scaling of BitrateColor() from representing 1-256kbps to
     representing 1-768kbps for better display of high-bitrate files,
     specifically lossless-compressed CD-audio (FLAC, LA, etc)


1.6.0: [January-30-2003] James Heinrich
   » Added support for OggFLAC (FLAC data stored in an Ogg container)
     (thanks ahØartemis*dk for the idea)
   » Added support for Speex (the data stored in an Ogg container)
   » Comments are now available in the root 2-dimensional array
     ['comments'] - each entry in this array will contain one or more
     strings. For example, if there are two artists then
     ['comments']['artist'][0] will contain the first one and
     ['comments']['artist'][1] the other. All keys are forced
     lowercase. Comments will be stored in the ['comments'] array in
     this order of precedence:
     1) Native format tags (ASF, VQF, NSV, RIFF, Quicktime, Vorbis)
     2) APE tags
     3) ID3v2
     4) Lyrics3
     5) ID3v1
     Lower-priority tags will not overwrite or append existing values
     of higher-priority tags (for example, 'artist' in ID3v1 will be
     ignored if already specified in APE), but missing values will be
     filled in (for example, if 'album' is specified in ID3v2 but not
     in APE, it will be included in the ['comments'] array).
     Note: Root keys (['title'], ['artist'], etc) are NOT available
     in this or future versions of getID3().
     (thanks ahØartemis*dk)
   » MD5 hashes are now available for all formats for both the entire
     file (['md5_file']) and the portion of the file containing only
     the audio/video data, stripped of all prepended/appended tags
     like ID3v2, ID3v1, APE, etc - ['md5_data']
     (thanks ahØartemis*dk for alternate md5_file() function that
     runs on UNIX system running PHP < 4.2.0)
     NOTE: Ogg files require the use of vorbiscomment to obtain the
     md5_data value. vorbiscomment must be downloaded from
     http://www.vorbis.com/download.psp and placed in the getID3()
     directory. All Ogg formats (Vorbis, OggFLAC, Speex) are affected
     by this problem, but only OggVorbis files can be processed with
     vorbiscomment. OggFLAC and Speex files will be processed by
     getID3(), but this may result in an incorrect value for md5_data
     in the event that VorbisComments are larger than 1 page (4-8kB).
     NOTE: md5_data for Ogg will not work if PHP is running in Safe
     Mode
   » There is now a wrapper class available, written by Allan Hansen,
     which should simplify extracting most common basic information
     (such as format, bitrate, comments).
     New file: audioinfo.class.php
   » OggWrite() in getid3.ogginfo.php has been replaced with a new
     version that uses vorbiscomment to write the comments, because
     of a reported bug that can corrupt OggVorbis files such they
     cannot be played.
     NOTE: Ogg comment writing now requires the use of vorbiscomment
     which must be downloaded from http://www.vorbis.com/download.psp
     and placed in the getID3() directory.
     NOTE: Ogg comment writing will not work if PHP is running in
     Safe Mode
   ¤ New root key ['tags'] is now always returned for all formats.
     It is an array that may contain any of:
     * Native format tags: 'vqf', 'riff', 'vorbiscomment', 'asf',
       'nsv', 'real', 'midi', 'zip', 'quicktime'
     * Appended data tags:  'ape', 'lyrics3', 'id3v2', 'id3v1'
   ¤ New root key ['audio'] is an array containing any or all of:
       codec, channels, channelmode, bitrate, bits_per_sample,
       dataformat, bitrate_mode, sample_rate, encoder
       Note: This replaces several root keys, including:
         bitrate_audio, bits_per_sample, frequency, channels
   ¤ New root key ['video'] is an array containing any or all of:
       bitrate_mode, bitrate, codec, resolution_x,  resolution_y,
       resolution_y, frame_rate, encoder
       Note: This replaces several root keys, including:
         bitrate_video, resolution_x, resolution_y, frame_rate
   ¤ ['id3']['id3v1'] has moved to ['id3v1']
   ¤ ['id3']['id3v2'] has moved to ['id3v2']
   ¤ ['audiodataoffset'] and ['audiodataend'] have been renamed to
     ['avdataoffset'] and ['avdataend'] respectively
   ¤ GetAllMP3info() has been changed to GetAllFileInfo() with a
     different parameter list ($allowedFormats is no longer a
     parameter).  Check your code where you're calling
     GetAllMP3Info() - you will need to change both the function
     name and the parameter list if you pass more than 2 parameters
   ¤ All formats now return ['audio']['dataformat'] and/or
     ['video']['dataformat'] where appropriate - this goes along with
     ['fileformat'] - ['fileformat'] will return the actual structure
     of the file, whereas ['dataformat'] will return the format of
     the data inside that structure. For example, an Ogg file can
     contain Vobis data (normal), or it can contain FLAC data in the
     Ogg container format. In that case, ['fileformat'] would be
     'ogg', but ['dataformat'] would be 'flac'.
     Note: this means that WAV and AVI files now return a
     ['fileformat'] of 'riff' rather than 'wav' or 'avi'.
   ¤ ['filesize'] is no longer returned for files larger than 2GB
     because PHP does not support large file access. Attempting to
     parse a file larger than 2GB will result in a message stored in
     ['error'] and ['filesize'] not set.
   ¤ APEtag, ID3v1, and ID3v2 are now supported on ALL multimedia
     files - even if illegal by format. Ogg will return warning if
     ID3/APE tags are present.  (thanks ahØartemis*dk)
   ¤ All files: non-critical errors are now returned in the root key
     ['warning'] rather than ['error'] (only critical errors that
     prevent getID3() from correctly parsing the file are returned in
     ['error']  (thanks ahØartemis*dk)
   ¤ Renamed all references to $MP3fileInfo to $ThisFileInfo
   ¤ Joliet now supported for ISO-9660.
     ['iso']['supplementary_volume_descriptor'] is now returned, if
     available, and ['iso']['files'] will contain ASCII equivalents
     of the Unicode directory structure & filenames stored.
   ¤ Moved Monkey's Audio code from getid3.ape.php to seperate file.
     New file: getid3.monkey.php
   ¤ Added new keys for ISO-9660: ['name_ascii'] for directories,
     ['file_identifier_ascii'] for files
   ¤ Added root key ['track'] for CD-audio files
   ¤ Ogg/Vorbis-comment files now have comments returned inside
     ['ogg']['comments_common'] as an array of strings, rather than
     simple strings in ['ogg']
   ¤ Quicktime files now have comments returned inside
     ['quicktime']['comments'] as an array of strings, rather than
     simple strings in ['quicktime']
   ¤ ['mime_type'] is a new root key returned for all supported
     formats (thanks ahØartemis*dk)
   ¤ ['fileformat'] now returns 'mp1' instead of 'mp3' for MPEG-1
     layer-I audio files (thanks ahØartemis*dk)
   ¤ ['mpeg']['audio']['bitratemode'] now returns lowercase
   ¤ MPEG-4 audio files which consist of MP3 data wrapped in a
     Quicktime fileformat will now return the usual data in
     ['mpeg']['audio']
   ¤ Type-1 DV AVIs are now supported
   ¤ DV AVIs will return 1 or 2 in ['RIFF']['video'][x]['dv_type']
   ¤ Changed ['fileformat'] from 'mpg' to 'mpeg' for MPEG video files
   ¤ ASF comments are now stored in ['asf']['comments'] instead of
     ['asf']
   ¤ RealMedia chunk data is now returned inside ['real']['chunks']
     instead of ['real']
   ¤ ['replay_gain'] now properly populated from APE tags
   ¤ Added support for ASF_Old_ASF_Index_Object in ASF files
     (thanks ahØartemis*dk)
   ¤ AAC-ADTS files now return ['aac']['bitrate_distribution']
   ¤ ParseVorbisComments() has been replaced with
     ParseVorbisCommentsFilepointer() (with different parameters)
   ¤ All references to any key ['frequency'] are now ['sample_rate']
   ¤ Moved ID3v2 comments from ['id3v2'] into common root
     ['comments'] structure, and now returns more values than before
   * Bugfix: ['iso']['files'] and ['zip']['files'] could potentially
     contain duplicate entries (in a numeric-indexed array) for files
     if the directory structure specifies files multiple times.
     Entries are now guaranteed unique, with the last entry for the
     file overwriting any former ones.
   * Bugfix: RIFF parsing had numerous issues, including:
     - large AVIs would take a very very long time to parse
     - chunks with odd (not even) sizes would cause the parser fail
     - video and/or audio codecs not always identified
     The ParseRIFF() function has been completely rewritten and fixes
     all known issues with RIFF parsing. Users are, however,
     encouraged to double-check output of any parsed (AVI/WAV/CDDA)
     files.
   * Bugfix: Modified getid3.riff.php to return correct total
     bitrates for AVIs with multiple audio streams
   * Bugfix: GetFileFormat() was not creating array structure
     correctly  (thanks ahØartemis*dk)
   * Bugfix: LAME tag for MP3s can only specify up to 255kbps, so any
     files with actual CBR bitrate of >=256 were reported incorrectly
   * Bugfix: Lyrics3 synched lyrics were not being correctly returned
   * Bugfix: CreateDeepArray() was broken for non-nested cases, which
     meant ZIP and ISO ['files'] structures were broken
   * Bugfix: Incorrect pattern matching for ZIP files meant no zip
     files were being detected as such
   * Bugfix: AAC-ADIF was returning an incorrect number of channels
     (too few) in some cases  (thanks ahØartemis*dk)
   * Bugfix: Vorbis comments were returning an incorrect value for
     ['dataoffset'] in some cases
   * Bugfix: MPEG video ['marker_bit'] and ['vbv_buffer_size'] were
     incorrect
   * Bugfix: ['playtime_string'] could potentially have a value of
     x minutes and 60 seconds (ie 3:60 instead of 4:00)
   Added support for FLAC cuesheets (FLAC 1.1.0+)
     (thanks ahØartemis*dk)
   Improved parsing speed in MP3, MP2 and AAC  (thanks ahØartemis*dk)
   Extra error-checking added to try and identify corrupt files for
     most audio formats  (thanks ahØartemis*dk)
   More accurate playtime calculation for RealMedia
     (thanks ahØartemis*dk)
   Changed all relevant files to use ['audiodataoffset'] and
     ['audiodataend'] rather than ['filesize'] where appropriate
     (thanks ahØartemis*dk)
   Added text encoding type 255 as a duplicate of UTF-16BE but with
     Big-Endian rather than Little-Endian byte order
   Added many RIFF-AVI audio types and fourcc video types to the
     lookup functions in getid3.riff.php
   Added numerous new known GUIDs to getid3.asf.php
   Added PoweredBygetID3() function to easily get a "powered by"
     string with the current getID3() version.
   Added "Morgan Multimedia Motion JPEG2000" (MJ2C), "DivX v5" (DX50)
     and "XviD" (XVID) codecs to list of known codecs in
     getid3.riff.php
   Changed GETID3_INCLUDEPATH path seperators to forced /
     (from \ for Windows)
   Modified getid3.check.php to only change \ directory seperators to
     / on Windows operating systems
   Modified getid3.check.php to handle larger-than-2GB files (which
     now do not return a filesize)
   Modified getid3.check.php to handle ['dataformat_audio'] and
     ['dataformat_video']
   Modified getid3.check.php to show a list of present tags in one
     column rather than one column for each of ID3v1, ID3v2, etc
   Modified getid3.check.php to show MD5 values. Initially disabled
     but can be enabled for a directory with a click. md5_file is
     always calculated when displaying detailed info about a single
     file; md5_data is calculated if the file is < 50MB
   Modified getid3.check.php to show errors and warnings. Details are
     visible with a mouseover or a click.
   Changed getid3.check.php to use SafeStripSlashes instead of a
     manual conditional directory name replacement for special
     characters
   Added sample recursive scanning sample code to getid3.readme.txt
     (thanks lipisinØmail*ru for the idea)


1.5.7: [January-10-2003] James Heinrich
   » Added support for ISO 9660 (CD-ROM image) format. Most-useful
     data is directory structure returned under ['iso']['files']
     Note: Only ISO-9660 supported, not (yet) Joliet extension
     (thanks nebula_djØsofthome*net for the idea)
     New file: getid3.iso.php
   ¤ ZIP files are now parsed by getID3() itself without relying on
     built-in PHP functions and/or ZZipLib support.
     (thanks Vince for the idea)
   ¤ ZIP files now return a simple directory listing with filename
     and filesize info only under ['zip']['files'].
     Note: empty subdirectories will note appear in here, only files
     and non-empty subdirectories. Information for all entries,
     including empty subdirectories, is available under
     ['zip']['central_directory'] (or under ['zip']['entries'] if the
     Central Directory cannot be located (usually due to a trucated
     file).
   ¤ RIFF-WAV files with MP3 data (or MP3s with RIFF headers, if you
     want to think of it that way) now have the MPEG audio portion
     scanned and the usual data returned in ['mpeg']['audio'] if the
     RIFF audio codec has wFormatTag of "85" (identified by getID3()
     as "MPEG Layer 3")
     (thanks ahØartemis*dk for the idea)
   ¤ EXIF data (if present) is returned for JPEG files under
     ['jpg']['exif']  (thanks nebula_djØsofthome*net)
   ¤ ['filepath'] now returned for all files with the directory part
     of the full filename.
   ¤ ['filenamepath'] is now returned for all files (equivalent to
     ['filepath'].'/'.['filename'])
   * Bugfix: ['id3']['id3v2'][<framename>]['dataoffset'] was wrong
   * Bugfix: MP3s tagged with iTunes have an invalid comment field
     frame name ('COM ' - should be 'COMM') but the data is valid
     otherwise; the frame is now renamed to 'COMM' and parsed
     normally (with the error noted in ['error'])
     (thanks kheller2Ømac*com for the sample file)
   * Bugfix: Some ASF/WMA audio files were not being identified as
     any format  (thanks ahØartemis*dk)
   * Bugfix: Warning now generated and ASCII format assumed for
     invalid text encoding values in ID3v2
   * Bugfix: Changed ZIP detection pattern from 'PK' to 'PK\x04\x03'
   * Bugfix: Ogg/FLAC files with large Vorbis comments were dying in
     an infinite loop with lots of error messages due to missing $fd
     parameter on ParseVorbisComments()  (thanks ahØartemis*dk)
   * Bugfix: ['data'] and ['image_mime'] were being returned for all
     Ogg comments even if they were not images for versions of PHP
     that have image_type_to_mime_type() built in (ie PHP 4.3.0+)


1.5.6: [December-31-2002] James Heinrich
   » Added support for NSV (Nullsoft Streaming Video)
     (www.nullsoft.com/nsv/)
     (thanks demonØsoundplanet*com for the idea)
     New file: getid3.nsv.php
   » Added support for CD-audio track files (track01.cda etc)
   ¤ Added standard ['frame_rate'] root value when known (AVI, NSV,
     MPEG-video)
   ¤ ASF files now report ['fileformat'] of:
     'wmv' when Windows Media Video codec v7/v8/v9 is used;
     'wma' when any 'Windows Media Audio' named audio codec is used
           and no video stream is present;
     'asf' in all other cases (audio-only, video-only, or both)
   ¤ Removed support for ZIP functions (will be rewritten to not
     require ZZIPlib support in future versions)
   ¤ Added function SafeStripSlashes() as a drop-in replacement for
     stripslashes(), but that only strips slashes if magic_quotes_gpc
     is set
   ¤ Removed support for remote file scanning (HTTP / FTP)
   ¤ Added ['aac']['frames'] (number of AAC frames in file)
   ¤ Added ['mpeg']['audio']['frame_count'] when a bitrate histogram
     is created
   ¤ Average bitrate for VBR MP3/MP2 is calculated from actual counts
     of frames of various bitrates (rather than relying on the header
     values or filesize) when a bitrate histogram is created
   ¤ RecursiveFrameScanning() split out into seperate function
     (getid3.mp3.php)
   ¤ Removed old function getMP3header() from getid3.mp3.php
   ¤ Changed default MPEG_VALID_CHECK_FRAMES (number of mp3 frames
     scanned to ensure a valid audio sequence has been located) from
     10 to 25. This means scanning will be slightly slower, but more
     reliable/accurate
   * Bugfix: ID3v2.2 - valid frame names not correctly detected
     (thanks maeckerØweb*de for the sample file)
   * Bugfix: ID3v2.2 - valid padding not correctly detected
     (thanks maeckerØweb*de for the sample file)
   * Bugfix: MIDI files with flat key signatures were not being
     correctly reported (thanks alexleeisØshaw*ca for sample file)
   * Bugfix: now returns message in ['error'] if file does not exist
   * Bugfix: ['RIFF']['video'][x]['codec'] wasn't always being
     correctly populated
   * Bugfix: ['bitrate'] was incorrect for multi-stream RealMedia
   * Bugfix: ['playtime_seconds'] was sometimes null or incorrect
     for multi-stream RealMedia
   * Bugfix: ChannelTypeID was incorrect in RVA2 ID3v2.4 frames
   * Bugfix: Fixed potential divide-by-zero error for corrupt FLAC
     files  (thanks ahØartemis*dk)
   * Bugfix: AAC-ADTS was not returning ['bitrate_mode'] unless
     $ReturnExtendedInfo was TRUE  (thanks ahØartemis*dk)
   * Bugfix: LAME-encoded CBR MP3s now properly identified as CBR
     with correct bitrate  (thanks ahØartemis*dk)
   * Bugfix: VBR MP2 (or headerless MP3) is now identified as VBR
     rather than CBR. Note: to obtain VBR bitrate for headerless
     files, the entire file is scanned and a histogram distribution
     of bitrates is created, and the average bitrate calculated from
     that.  (thanks ahØartemis*dk for sample file)
   Added support for DSIZ chunks in VQF, and checks to make sure size
     of audio data matches DSIZ value, if present
     (thanks ahØartemis*dk for sample file)
   Rewrote GetAllMP3info() - removed some unneccesary code, changed
     format-detection routine from ParseAsThisFormat() to
     GetFileFormat() to allow for more flexible format parsing
     (needed for ISO CD-ROM images, helpful for Quicktime and others)
   Changed references in all files from string-cast indexes: ["$i"]
     to non-cast indexes: [$i] where appropriate
   Put a sans-serif 9pt style on all text in getid3.check.php
   getAACADTSheaderFilepointer() now return TRUE if synch is lost
     after the first frame has been successfully parsed (previously
     it would return FALSE if synch was lost at any time, meaning the
     file is most likely MP3, which was incorrect)
     (thanks ahØartemis*dk for sample file)
   Speed improvement code changes to getid3.mp3.php (up to 24% faster
     in some cases)  (thanks ahØartemis*dk for the code)
   Changed all include_once() to require_once()


1.5.5: [November-25-2002] James Heinrich
   » Added support for La (Lossless Audio - www.lossless-audio.com)
     (thanks ahØartemis*dk for the idea)
     New file: getid3.la.php
   ¤ Moved lookup functions from getid3.lookup.php to the files where
     they are used.
     New file: getid3.id3.php
     New file: getid3.rgad.php
     Removed file: getid3.lookup.php
   ¤ getID3v1Filepointer() returns FALSE if ID3v1 tag not found
   ¤ Added new paramter "ReturnExtendedInfo" to the function
     getAACADTSheaderFilepointer() in getid3.aac.php which now
     defaults to FALSE - if TRUE then the data for every frame is
     returned (containing aac_frame_length, adts_buffer_fullness and
     num_raw_data_blocks, which aren't usually very useful). Speed
     improvement with FALSE is about 35%.
   ¤ Now returns fopen() errors in ['error'], for example if a remote
     file is not accessible.
   ¤ Changed default number of MP3 audio frames to scan to determine
     if a valid stream has been found from 5 to 10, now also defined
     as a constant at the top of getid3.mp3.php  This will result in
     slightly slower MP3 parsing, but greater reliability in
     detecting false/invalid/corrupted VBR headers.
   ¤ fopen() errors now displayed in getid3.putid3.php
     (thanks miguel.dieckmannØhamburg*de)
   ¤ Added 4th parameter to decodeMPEGaudioHeader() $ScanAsCBR which
     will force an MP3 audio frame sequence to be force-scanned in
     CBR mode. You should never need to call this directly, it's only
     used internally to scan for MP3 files that have an illegal VBR
     header with CBR data. (thanks fletchØpobox*com)
   * Bugfix: ASF_Marker_Object in getid3.asf.php was always returning
     an error in non-existant "reserved_1" and failing
   * Bugfix: VBR bitrate calculations in getid3.mp3.php only occur if
     ['mpeg']['audio']['VBR_frames'] is defined.
     (thanks fletchØpobox*com)
   * Bugfix: getid3.putid3.php no longer deletes original MP3 if
     ID3v2 tag writing fails (thanks miguel*dieckmannØhamburg*de)
   * Bugfix: incorrect order of if-statement error messages in
     getid3.putid3.php (thanks miguel*dieckmannØhamburg*de)
   getid3.asf.php now notes the error and continues parsing rather
     than failing when it encounters an error parsing a chunk
   Now actually scan 1000 frames for AAC ADTS as reported in the
     v1.5.4 changelog, rather than 100. (thanks ahØartemis*dk)
   Improved scanning speed in getAACADTSheaderFilepointer() by ~30%
     (thanks ahØartemis*dk for the fix)
   Added FileSizeNiceDisplay() function to getid3.functions.php for
     formatting filesize output in kB, MB, GB, etc.


1.5.4: [October-07-2002] James Heinrich
   » Added support for Quicktime.
     New file: getid3.quicktime.php
   » Added support for AAC files, both ADTS and ADIF header formats.
     ADIF format is a pain because it's very similar to standard MP3
     header format, and it's hard to distinguish between the two. I
     have tried to make the detection accurate, but I have a limited
     number of AAC test files to play with so if you have an AAC file
     that gets detected as MP3/MP2 (or vice-versa), please send me
     the details via email at infoØgetid3Øorg
     ADTS format is very slow to parse because to get the bitrate of
     VBR files the whole file has to be stepped through frame by
     frame (getID3() scans up to the first 1000 frames and assumes
     that to be close enough).
     Note: I would suggest commenting out support for AAC (see top of
     GetAllMP3info() function in getid3.php) unless you need it.
     (thanks jfaulØgmx*de for the idea and sample Delphi source code)
     New file: getid3.aac.php
   » Added bitrate distribution analysis option for MP3 VBR files. A
     new boolean parameter for getOnlyMPEGaudioInfo() enabled this
     feature which steps through the MP3 file frame by frame and
     counts how many frames of each bitrate exist. This information
     is returned in ['mpeg']['audio']['bitrate_distribution']
     Caution: this feature is very inefficient for large files and
     takes a very long time and does lots of disk I/O. Use with care.
   ¤ Changed layout of allowedFormats in GetAllMP3info() function in
     getid3.php to allow easy removal of support for any of the
     supported format. As stated above, I recommend commenting out
     AAC unless needed.
   ¤ Added ['flac']['compressed_audio_bytes'],
     ['flac']['uncompressed_audio_bytes'], and
     ['flac']['compression_ratio']
   ¤ Replaced FXPT2DOT30toFloat() function with FixedPoint2_30()
   * Bugfix: getid3.mpc.php was slightly miscalculating the number of
     samples, therefore also bitrate and playtime
     (thanks ahØartemis*dk for the fix)
   * Bugfix: MonkeyCompressionLevelNameLookup() didn't know about
     'insane' compression (thanks ahØartemis*dk for the fix)
   * Bugfix: MonkeySamplesPerFrame() was incorrect for MAC v3.95+
     (thanks ahØartemis*dk for the fix)
   * Bugfix: getid3.check.php wasn't processing the assumeFormat
     directive when (register_globals == off)
   * Bugfix: detecting of synch pattern for MP3 files with invalid
     data at the beginning wasn't always correct, also meant possible
     incorrect bitrate/duration/etc info for such corrupt files.
   getid3.functions.php now includes a replacement utf8_decode()
     function for those PHP installations that are not configured
     with the --with-xml option. (thanks stephaneØtekartists*com)


1.5.3: [September-30-2002] James Heinrich
   » Added support for VQF. (thanks mtØmansonthomas*com for the idea)
     New file: getid3.vqf.php
   » Added support for FLAC. Comments, if present, are returned under
     ['ogg'] because they follow the Ogg Vorbis structure standard.
     New file: getid3.flac.php
   ¤ OS/2-format bitmaps are now correctly interpreted. The format of
     the bitmap is now returned in ['bmp']['type_os'] and
     ['bmp']['type_version']. OS/2 bitmaps can be v1 or v2, Windows
     can be v1, v4 or v5


1.5.2: [September-25-2002] James Heinrich
   » Support for RealMedia (audio & video) added
     Note: only tested on G2 and v5 audio and video files - if anyone
     has older and/or newer sample files, please test it and/or send
     me the sample files.
     (thanks stephaneØtekartists*com for idea)
     New file: getid3.real.php
   » Support for BMP added. Palette and pixel data can optionally be
     extracted as well - this is slow and generally unneccesary, but
     the option is there if you need it. Also includes PlotBMP()
     which will take the extracted pixel data and output it as a true
     color PNG. This function requires GD v2.0+
     Note: Untested on 16-bit and 32-bit BMPs because I couldn't find
     any sample files - if you know of a program that can create such
     files, please email infoØgetid3Øorg
     Note: Support for RGB (uncompressed), RLE8 and RLE4 is included
     and tested. BITFIELDS support is also included for 16- & 32-bit
     formats, but it's untested, so if anybody has any test files
     please send them to infoØgetid3Øorg
     Note: Support currently only for Windows-format BMPs, and trying
     to parse an OS/2-format bitmap leads to unpredictable/invalid
     results.
     New file: getid3.bmp.php
   » PNG now fully parsed, including all information chunks
     New file: getid3.png.php
   ¤ Support for GIF/JPG/PNG moved to seperate files and expanded,
     including standard ['resolution_x'] and ['resolution_y'] as well
     as more thorough parsing of header information
     New file: getid3.gif.php
     New file: getid3.jpg.php
   table_var_dump() simplified and now outputs &#123;-style character
     entities for characters outside the normal alphanumeric range
   CleanOggCommentName() changed to a regular expression
     (thanks chris-getid3Øbolt*cx for rewriting the function)


1.5.1: [September-20-2002] James Heinrich
   » Added support for MPEGplus/Musepack SV7. ['fileformat'] is 'SV7'
     for version 7 files (versions 4, 5 ,6 and 8 are not supported
     yet, but will be of ['fileformat'] SV4, SV5, SV6 and SV8) when
     they are supported (thanks Christian Fritz for the idea)
     New file: getid3.mpc.php
   ¤ ['bitrate_audio'], ['bitrate_video'], ['bitrate_mode'],
     ['channels'], ['resolution_x'], and ['resolution_y'] keys added
     for all appropriate formats
   ¤ Ogg files with a COVERART comment now save and display the
     attached image the same way as is done with ID3v2 APICs
   ¤ ['ogg']['comments'][n]['data'] and
     ['ogg']['comments'][n]['dataoffset'] is now returned for all
     comments. ['ogg']['comments'][n]['data'] is only useful if
     the field is supposed to contain binary data. It is a
     base64_decode()'d version of ['value'].
     ['ogg']['comments'][n]['dataoffset'] is the byte offset in the
     file at which the 'COMMENTNAME=value string' starts, not the
     start of just 'value'
   ¤ ['ogg']['comments'][n]['image_mime'] is now returned if
     ['ogg']['comments'][n]['data'] contains valid image data.
   ¤ More than 3 Ogg pages may now be read in, if the comment data
     is longer than 1 page (usually about 4kB)
   ¤ ['fileformat'] is now 'mp2' rather than 'mp3' if it's MPEG-1,
     Layer-II audio
   ¤ ASF bitrates now calculated even if stream_bitrate_properties
     object not present
   ¤ ['asf']['stream_properties_object'] is now a numeric-key array
     with one entry for each stream - the key being the stream number
   ¤ ['replay_gain'] is returned for all audio formats that support
     it (MP3-LAME, ID3v2, Ogg) (thanks Christian Fritz for the idea)
   ¤ ['mpeg']['audio']['LAME']['RGAD']['radio_replay_gain'] is now
     ['mpeg']['audio']['LAME']['RGAD']['radio'] (same for audiophile)
   ¤ ASF/WMA files now use WM/Track to get track number from if
     WM/TrackNumber is not available (thanks stephaneØtekartists*com)
   ¤ ASF/WMV files now returns ['year'] and ['asf']['year']
   ¤ ASV/WMV files now use ['content_description']['description'] for
     the ['comment'] field (thanks stephaneØtekartists*com)
   ¤ ['track'] is now always returned as an integer
   * Bugfix: Ogg comments that are larger than one data page (usually
     about 4kB) are now correctly parsed (thanks Christian Fritz)
   * Bugfix: Ogg comment data is now UTF8-decoded
   * Bugfix: Ogg comment writing now UTF8-encodes the data
   * Bugfix: playtime for ASF files was off by <preroll> (usually
     between 3 and 12 seconds)
   * Bugfix: ['asf']['stream_properties_objects']['flags'] data was
     possibly incorrect
   * Bugfix: ASF Padding Object was overwriting
     Stream Bitrate Properties Object data (now returned correctly in
     ['asf']['padding_object']
   * Bugfix: ASF Marker Object Reserved_2 field was incorrect
   * Bugfix: ASF Bitrate Mutual Exclusion Object had incorrect stream
     numbers
   Warning displayed if incorrectly-formatted Ogg comment is present
     (known to be an issue with CDex v1.40, but fixed by v1.50b7)
     (thanks Christian Fritz)
   Ogg comment writing now checks for valid comment names
   Added bitrate column in getid3.check.php, and added some formatting
     (font, colour)
   Performance tweaks using bitwise math instead of binary string
     operations


1.5.0: [September-18-2002] James Heinrich
   » Ogg comment writing support added. getid3.write.php has been
     updated to allow for writing comment tags to both MP3 and Ogg.
     Big thanks to Chris Bolt <chris-getid3Øbolt*cx> for writing the
     OggWrite() function and offering it for inclusion in getID3()
     New file: getid3.ogginfo.php
   » Support for Monkey's Audio and APE tag added.
     (thanks Christian Fritz for the idea)
     New file: getid3.ape.php
     ['fileformat'] now returns 'mac' for Monkey's Audio files, or
     'ape' for files with an APE tag (Monkey's Audio or other format)
   » getid3.thumbnail.php has been removed from the distribution and
     the table_var_dump() function now outputs APICs as seperate
     files in the same directory as the analyzed file. This should
     make the image-displaying more reliable as well as reduce
     complexity. The naming convention for the images is
     filename.ext.[byte offset of APIC data].[jpg|gif|png]
     If anybody still has any problems with corrupted images please
     let me know at infoØgetid3Øorg
   » Support for extended Xing/LAME tag
     (see http://users.belgacom.net/gc247244/extra/tag.html)
     Data is returned in ['mpeg']['audio']['LAME']
   ¤ ['ogg']['tracknumber'] has been renamed to ['ogg']['track'] and
     ['track'] is now returned in the root of the array
   ¤ ['ogg']['pageheader'][n]['flag'] has been renamed to
     ['ogg']['pageheader'][n]['flags'] and the unprocessed flag byte
     is available in ['ogg']['pageheader'][n]['flags_raw']
   ¤ ['frequency'] is now returned for WAVE files in the root of the
     array (thanks danielØelectroteque*org)
   ¤ ASF files now return codec, bitrate, resolution, etc information
     under ['asf']['video_media'] or ['asf']['audio_media']
   * Bugfix: RVA2 and EQU2 writing in getid3.putid3.php were
     incorrectly writing Volume Adjustment field
   * Bugfix: EQU2 in getid3.frames.php was reading Volume Adjustment
     as unsigned integer instead of signed integer
   * Bugfix: handling of remote files over HTTP & FTP was broken
     (thanks Vince)
   * Bugfix: incorrect handling of some ASF packets
   ASF/Windows Media format now more fully parsed, including Index
     Objects
   Added several new fourCC video codecs


1.4.3: [September-15-2002] James Heinrich
   » Now parses ASF / WMV / WMA files
   ¤ New file: getid3.asf.php
   * Bugfix: RoughTranslateUnicodeToASCII() would return nothing
     if didn't find a terminator it was expecting
   Added FILETIMEtoUNIXtime() function (for converting 64-bit
     Microsoft FILETIME timestamps, used in ASF files and elsewhere,
     to UNIX Epoch timestamps)
   Added GUIDtoBytestring() and BytestringToGUID() functions


1.4.2: [September-12-2002] James Heinrich
   » getID3() now requires PHP v4.1.0 or higher because it now is
     designed to work with register_globals = off and the new auto-
     globals ($_GET, $_SERVER, etc).
   * Bugfix: VBR MP3 files with Fraunhofer-style VBR header were not
     being correctly detected in most cases
     (thanks dkushnerØoddcast*com and mikeØftl*com for sample files)
   * Bugfix: IsValidTextEncoding() was broken
   * Bugfix: Add stripslashes($EditorFilename) to getid3.write.php
     (writing was broken for files with ' or " in the filename)
     (thanks mikeØftl*com and kthejoker)
   * Bugfix: If there is garbage data between a valid VBR header
     frame and a sequence of valid MPEG-audio frames the VBR data is
     no longer discarded. (thanks to mikeØftl*com for sample
     Fraunhofer-style VBR file produced with MusicMatch v7.2)
   ¤ Changed variable system to work with (register_globals = off)
   ¤ Moved relevant code into seperate PlaytimeString() function
   ¤ Added nl2br() to table_var_dump() for cleaner output
   ¤ Now returns the following keys from Fraunhofer-VBR files:
     ['VBR_seek_offsets'], ['VBR_seek_offsets_stride'],
     ['VBR_offsets_relative'] and ['VBR_offsets_absolute']
   ¤ Added ID3v1matchesID3v2() function and implemented in
     getid3.check.php (thanks to "Guest" in the forums for the idea)
   Changed amount of data read in getid3.getimagesize.php from 10kB
     to entire file. (thanks mikeØftl*com)
   Wrapped function_exists() checks around function definitions in
     getid3.functions.php
   Fixed a lot of E_WARNING and E_NOTICE situations, especially in
     ID3-writing code (getid3.putid3.php, etc)
   Added checks to make sure all needed data is available for writing
     ID3v2 tags


1.4.1b5: [May-30-2002] James Heinrich
   * Bugfix: Unsynchronise() was broken, now fixed
     (thanks mikeØftl*com)
   * Bugfix: GenerateID3v2Tag() now correctly uses non-synchsafe
     integers for frame size descriptors in ID3v2.3 and ID3v2.2
     (thanks mikeØftl*com)
   ¤ Added ['artist'], ['title'], etc keys to root of returned
     array to provide a common place to access any returned info
     from any file type. Currently gets info from ID3v1, ID3v2,
     Ogg, and RIFF/WAVE. Possible returned keys are:
     title, artist, album, year, genre, comment, track
   ¤ Modified LookupGenre() function to search for either genre based
     on numeric ID, or now reverse lookup as well
   ¤ Added ['artist'], ['title'], etc keys to ['RIFF'] information
     if info tags are present
   Added functionality to attach a picture to the ID3v2 tag in
     getid3.write.php
   Sorted genres into alphabetical order (special 3 at end of list)
     in getid3.write.php
   Changed the comment-edit field in getid3.write.php to a multi-line
     <textarea> from a single-line <input>
   getid3.write.php now only writes ID3v2 frames that have data
   Added default TXXX field to getid3.write.php to put a tagger info
     field when writing ID3v2 tags. Description is "ID3v2-tagged by"
     and data is "getID3() v[version] (www.silisoftware.com)"
   Changed getid3.check.php to use the new common info keys
   Improved file-format detection in getid3.check.php - if the auto-
     detect based on the first few bytes of the file doesn't find a
     known format (for example if the header is corrupt), a more
     thorough scan is done based on the file extension
   Added 'Edit ID3' link from getid3.check.php to getid3.write.php for
     MP3 files  (thanks maxØgutalin*com for the idea)
   Added 'Delete file' link from getid3.check.php to getid3.write.php
     allowing you to permanently delete a file (be careful with this!!)
     (thanks maxØgutalin*com for the idea)
   Added some mouse-over titles for links in getid3.check.php


1.4.1b4: [May-15-2002] James Heinrich
   * Bugfix: getid3.check.php wasn't parsing MP3s with invalid headers
     or padding at the beginning of the file - added 'assumeFormat'
     parameter and 'Parse this file as:' options to force parsing in a
     particular format  (thanks Alcohol for the sample file)
   * Bugfix: unset(['fileformat']) and ['error'] added in cases where
     file cannot be parsed in the assumed or forced format


1.4.1b3: [May-01-2002] James Heinrich
   ¤ For Ogg files, now calculates the real average bitrate (returned
     in ['ogg']['bitrate_average']) and so the playtime of the file is
     calculated on actual average bitrate, not nominal bitrate, so it
     should be accurate now  (thanks to stephaneØtekartists*com for
     telling me it was wrong)
   * Bugfix: ID3v2FrameIsAllowed() wasn't behaving properly if the
     writing functions were called for more than one file, because of
     the static array not being cleared between uses. This is an
     updated fix because the one in 1.4.1b2 didn't work :o)
     (thanks soulcatcherØevilsoft*org and yoyo)
   Added rawurlencode() to the filename parameter in table_var_dump()
     for images (wouldn't work with path/file names containing special
     characters (#, &, ", +)  (thanks Christian Fritz)
   getid3.check.php no longer attempts to scan all MIDI tracks in
     directory-browse mode, since this can take a long time. Detailed
     single-file view is still fully scanned (new third parameter for
     getMIDIHeaderFilepointer() controls this)
   Small improvements to MoreNaturalSort()


1.4.1b2: [April-18-2002] James Heinrich
   ¤ GetAllMP3Info()'s 2nd parameter has changed from boolean to string
     (now specifying the parse-this-file-as-this format, like 'mp3',
     but also can be FALSE to mean don't assume any format, auto-detect
     only), and a third parameter (array containing allowed formats)
     has been added. The assumedFormat parameter allows a file to be
     forced to be parsed as a certain format rather than relying on the
     auto-detection of getID3() (ex: an MP3 wrapped in a RIFF/WAV
     header will be auto-detected as RIFF/WAV, but if forced to parse
     as MP3 will extract the original MP3 information)
     (thanks reel_tazØusers*sourceforge*net)
   * Bugfix: ID3v2FrameIsAllowed() wasn't behaving properly if the
     writing functions were called for more than one file, because of
     the static array not being cleared between uses (thanks yoyo)
   * Bugfix: Lyrics3 data wasn't being properly copied from the ['raw']
     keys to the easy keys (['title'], etc.)  (thanks Christian Fritz)
   * Bugfix: some testing code was accidentally left in
     getid3.thumbnail.php  (thanks Christian Fritz)
   * Bugfix: RIFF/WAVE files are now more likely to have all their
     chunks parsed.
   * Bugfix: RIFF/WAVE bitrate & playtime now better calculated
   * Bugfix: MP3 scanning for synch doesn't go beyond 64k now, to stop
     intensive scanning through large file that don't have a synch
     (thanks soulcatcherØevilsoft*org for a weird sample file)
   Improved performance when scanning for MP3 synch (about 600% faster
     if the synch is never found)
   ZIP files no longer return the contents of each compressed file, as
     that would very easily be more data than PHP could handle.
     (thanks davidbullockØtech-center*com)
   getid3.check.php now displays entries in a more natural sort order:
     case insensitive, ignores most punctuation, treats accented chars
     the same as their unaccent equivalent  (thanks mikeØftl*com)
   Added support for SmartSound-format RIFF files (which are regular
     RIFF/WAVE files with the first 4 chars changed from RIFF to SDSS)
   All instances of while(list() = each()) replaced with foreach()


1.4.1b1: [April-11-2002] James Heinrich
   » Parses MIDI files.
     NOTE: very slow at parsing, much slower than any other file type
     NOTE: playtime is generally mostly accurate, but not always 100%
   » Parses ZIP files (if ZZIPlib available, and only in PHP 4.0.7RC1
     and later (see http://www.php.net/manual/en/ref.zip.php)
     NOTE: currently untested as I'm unable to find php_zip.dll for
     PHP/Win32 - if someone has a copy of this file, please email me:
     infoØgetid3Øorg
   » Parses JPEG files (requires GD installed)
   » Parses PNG files  (requires GD v1.6+ installed)
   » Parses GIF files  (requires GD < v1.6 installed)
   » For MP3s, once a valid synch is detected, the next 5 frames are
     also scanned for valid synch signatures, to prevent false
     identification of synch. For corrupt MP3 files this will be a bit
     slower, but hopefully produce more reliable results.
     (Thanks to mpdjØbtinternet*com for bringing this to my attention,
     and xbhoffØpacbell*net for explaining what was happening)
     (Thanks also to macik for helping me with MP3 frame lengths:
     http://66.96.216.160/cgi-bin/YaBB.pl
     ?board=c&action=display&num=1018474068)
   » The actual image data is now displayed (for JPEG, PNG and GIF
     images only) rather than a binary text dump in getid3.check.php
     (specifically table_var_dump()) for APIC frames. Made possible
     by the inclusion of (a modified version of) GetURLImageSize() by
     Filipe Laborde-Basto (www.rezox.com). You can right-click, save-as
     to extract the image to a file.
     NOTE: The actual image data is still returned in ['data']
   ¤ ['image_mime'], ['image_width'], ['image_height'], ['image_bytes']
     are now returned for APICs
   ¤ split parsing functions out into seperate files: lyrics3, id3v1,
     id3v2, mp3, ogg, riff, mpeg, midi, zip
   ¤ ['ogg']['bitrate_ave'] -> ['ogg']['bitrate_nominal'] (thanks to
     stephaneØtekartists*com for pointing out that "nominal" bitrate
     may actually differ significantly from the "average" bitrate)
     The real average bitrate seems to be only extractable by parsing
     the entire file and calculating the average bitrate. This is not
     yet an option, but hopefully in a future version of getID3()
   ¤ ['filename'] now returned for all files
   ¤ ['ogg']['date'] and ['ogg']['description'] now returned when
     available  (thanks stephaneØtekartists*com)
   ¤ ['mpeg']['audio']['crc'] now contains the CRC (if present)
   ¤ ['bitrate'] is now returned as a double instead of an int
   ¤ ['dataoffset'] is now returned for all ID3v2 frames
   * Bugfix: MP3 CRC presence ['mpeg']['audio']['protection'] was being
     reported as opposite of what it actually should be
   * Bugfix: MPEG videos weren't being detected (they were being
     parsed as MP3), and even if they were, there was a typo in
     getMPEGHeaderFilepointer()  (thanks Christian Fritz)
   * Bugfix: getid3.functions.php wasn't being included in
     getid3.write.php  (thanks mikeØftl*com)
   * Bugfix: Browse:___ directory name in getid3.check.php wasn't
     correct with directory names with ' and other strange characters
     (thanks Christian Fritz)
   ID3v2FrameProcessing() now checks to see if the next frame is valid
     after it encounters an invalid FrameID, and if the next frameID
     appears valid, it will just skip the current (invalid) frame and
     continue processing (it would previously abort at the first sign
     of incorrect structure)   (thanks stephaneØtekartists*com)
   getid3.check.php now scans filetypes based on content, not filename
     extension, and shows the filetype in the displayed output. Files
     are only scanned as MP3 if ID3v2 or MPEG-audio signatures are at
     the immediate beginning of the file (MP3 used to be the default
     format), so a corrupt file may not show up as MP3 format in the
     browse screen, but in detail it will scan in-depth
   getid3.check.php now has columns to show the presence of ID3v1,
     ID3v2 and Lyrics3 content
   Helium2 (www.helium2.com) has been known to write ID3v2.4 tags with
     non-synchsafe-integer framesizes, getID3() now checks for this and
     will override and parse the tag as ID3v2.3 if the tag would parse
     fine as ID3v2.3 when it's really specified as ID3v2.4  (thanks
     Christian Fritz for the test files)


1.4.0b9: [April-05-2002] James Heinrich
   » Ogg files now return bitrate and playtime (playtime calculated
     from nominal bitrate and filesize, so it's only approximately
     accurate).  (thanks stephaneØtekartists*com for the idea)
   * Bugfix: ID3v1 tags were not properly being parsed - track, genre
     and comment fields were incorrect.  (thanks Christian Fritz)
   * Bugfix: getid3.check.php would not browse directories with single
     quotes (') or double quotes (") in the directory name.
     (thanks Christian Fritz)
   * Bugfix: Improved detection of MPEG-video files (a sample MP3 file
     had a false MPEG video signature at the beginning), and the MPEG-
     video parsing function now only looks for the MPEG-video header
     in the first 100k bytes of the file, to prevent needlessly
     scanning very large files. Also will not infinitely loop if it
     does not find what it's looking for.  (thanks Christian Fritz)
   ['error'] now returned if MP3 synch doesn't occur at beginning of
     file if ID3v2 not used (ie there's some kind of padding there that
     should not be)
   Reduced use of fread() in getMPEGHeaderFilepointer() (now faster)
   Added "file parsed in x.xxx seconds" to getid3.check.php
   Added "browse: <directory>" link to getid3.check.php
   Changed default ID3v2 majorversion from 2.4 to 2.3 in
     getid3.write.php because Winamp (and probably many other
     ID3v2-aware tools) can only read up to ID3v2.3
     (thanks mikeØftl*com)


1.4.0b8: [April-04-2002] James Heinrich
   » Lyrics3 support added  (thanks Christian Fritz for the idea)
   ¤ check.php renamed to getid3.check.php
   ¤ write.php renamed to getid3.write.php
   ¤ ['id3']['id3v2']['error'] (if present) now reported in ['error']
   ¤ ['mpeg']['audio']['error'] (if present) now reported in ['error']
   * Bugfix: RoughTranslateUnicodeToASCII() was completely mangling
     UTF-16/UTF-16BE encoded text
   * Bugfix: The warning about MP3ext wasn't always showing up
     (thanks davidbullockØtech-center*com)
   getID3v1Filepointer() cleaned up & shortened
   Moved the include_once() statements around so that a minimum of code
     is included


1.4.0b7: [April-03-2002] James Heinrich
   » RIFFs (specifically AVIs) are now more completely parsed,
     almost everything in the returned ['RIFF'] array has been moved
     around and/or restructured. A lot of new data is in there too -
     codecs, frame size, etc.
   ¤ Better recursive parsing of RIFFs (sub-arrays are now in the right
     place)
   * Bugfix: the isset() idea introduced in beta 5 was incorrectly
     implemented, such that ['asciidata'] and ['asciidescription'] were
     never returned - this had the side effect that ID3v2 comments were
     not copied to ['id3']['id3v2']['comment']  (thanks mikeØftl*com)
   * Bugfix: MPEG audio synch wasn't being detected, and therefore MPEG
     audio data not parsed, if no ID3v2 header present in an MP3
   ID3v1 track number only returned if greater than zero
   Removed !== FALSE (introduced in 1.4.0b6) from while(fread()) loops,
     some users were reporting problems with that syntax.
   Changed substr($string, 0, 1) to $string{0} syntax in most files
   Reformatted changelog.txt to 72-column width


1.4.0b6: [April-01-2002] James Heinrich
   * Bugfix: 1.4.0b5 introduced a bug where any RIFF file other than
     PCM WAVE (this includes any compressed WAV, as well as all AVIs)
     would crash getID3()
   Reduced use of fread() in getOggHeaderFilepointer() for increased
     speed
   Added constant FREAD_BUFFER_SIZE for many fread() operations
   Added !== FALSE check to while(fread()) loops
     (thanks davidbullockØtech-center*com)
   Added more entries to RIFFwFormatTagLookup()
     (still looking for a good complete list)
   Converted use of hexdec() in getid3.lookup.php to 0x1234 notation


1.4.0b5: [March-28-2002] James Heinrich
   ¤ Renamed decodeheader() to decodeMPEGaudioHeader()
   * Bugfix: Fixed infinite loop problem for RIFF/WAV files with
     unknown chunks
   * Bugfix: WXXX frames were incorrectly writing from ['URL'] instead
     of ['url']
   * Bugfix: RoughTranslateUnicodeToASCII() wasn't properly decoding
     UTF-16/UTF-16BE
   Changed all quoted strings from " to ' to hopefully improve speed
     (although benchmarks have not yet shown any significant
     improvement in speed)  (thanks davidbullockØtech-center*com)
   Improved code in check.php for dealing with symbolic links
     (thanks davidbullockØtech-center*com)
   Changed '<?' tags to '<?php'  (thanks davidbullockØtech-center*com)
   Added processing time indicator in check.php
     (ie 'directory scanned in 2.45 seconds')
   Replaced all instances of feof() to prevent infinite loop conditions
   Moved lookup portions of decodeMPEGaudioHeader() to
     getid3.lookup.php
   Replaced $arrayname[$index] with $arrayname["$index"] to avoid PHP
     E_NOTICEs  (thanks davidbullockØtech-center*com)
   Wrapped isset() around many if statements, to avoid PHP E_NOTICEs,
     hence improve speed (up to 30x speed improvement reported in some
     cases :)


1.4.0b4: [March-26-2002] James Heinrich
   ¤ RIFF/WAV file format now parsed, returned under ['riff']
   ¤ Support for Relative Gain Adjustment in RIFF/WAV files
   ¤ ['channels'] (1 or 2) now returned for MP3 and WAV files
   ¤ ['bitrate'] now returned (in bits-per-second) at root level for
     MP3 and WAV files
   Added support for RGAD (Relative Gain ADjustment) ID3v2 frames, both
     reading & writing
     (see http://privatewww.essex.ac.uk/~djmrob/replaygain/ for details
     on RGAD)  (thanks Christian Fritz for the idea)
   Removed some test data-dumping from the ID3v2 writing functions
   Language code 'XXX' now returns descriptive string 'unknown' instead
     of NULL
   Seperated out comments from top of getid3.php into getid3.readme.txt
     and changelog.txt
   Split out non-lookup functions from getid3.lookup.php to
     getid3.functions.php


1.4.0b3: [March-25-2002] James Heinrich
   ¤ ['asciidata'] for WXXX frames now returns correct information, but
     under ['asciidescription']  (thanks Christian Fritz)
   ¤ Added ['framenamelong'] to all returned frame data arrays with
     text description of that frame (ie 'RVA2' would return 'Relative
     volume adjustment (2)')  (thanks Christian Fritz)
   ¤ ['datalength'] is now ['indexeddatalength'] in ASPI frames (was
     confliciting with the all-frames ['datalength'] as introduced in
     v1.4.0b1
   ¤ ['datalength'] now returned as integer (rather than double) where
     possible


1.4.0b2: [March-21-2002] James Heinrich
   ¤ ['mpeg']['audio']['bitrate'] now returned as int rather than
     double for VBR files
   * Bugfix: MPEG audio information wasn't being parsed on files that
     had neither ID3v1 or ID3v2
   * Bugfix: COMM/WXXX frames weren't returning 'asciidata' in
     ID3v2.2, which also meant the ['id3']['id3v2']['comment'] field
     wasn't being returned  (thanks stephaneØtekartists*com)
   * Bugfix: file might not be found if filename actually contains
     escaped chars or %xx-formatted characters
     (thanks reel_tazØusers*sourceforge*net)
   Added support for running with Register Globals turned off
     (thanks reel_tazØusers*sourceforge*net)
   Added urlencode() where needed in check.php
     (thanks reel_tazØusers*sourceforge*net)
   Fixed IE buffering/display problem in progress counter in check.php


1.4.0b1: [March-11-2002] James Heinrich
   » ID3v2 writing support via WriteID3v2() in putid3.php
     RemoveID3v2() and RemoveID3v1() functions now available in
     putid3.php  All ID3v1 and ID3v2 writing functions have been moved
     to putid3.php and example file write.php has been added to the
     distribution
   ¤ MPEG audio frame information (bitrate, frequency, etc) now
     returned inside ['mpeg']['audio'] instead of just ['mpeg']
   ¤ MPEG video information now parsed, returned in ['mpeg']['video']
     Note: audio portion of video system files is not yet being parsed
   ¤ All flag bits are now returned as boolean rather than int or
     string
   ¤ RVA2 data now returned as an array (multiple RVA2 tags are
     allowed)
   ¤ RVA2/EQU2 description returned under ['description'] rather than
     ['identification']
   ¤ RVAD/EQUA adjustments now returned as signed integers, rather than
     absolute values which required you to check flag bytes
   ¤ RVRB/REV data no longer returns under ['reverb'] array
   ¤ WXXX/W???/LINK frames now return ['url'] instead of ['URL']
   ¤ USER now properly returns both ['language'] and ['languagename']
   ¤ OWNE now returns ['purchasedateunix'] as a UNIX timestamp
     (only if ['purchasedate'] is a valid date)
   ¤ ['id3']['id3v2']['padding'] now returned with information on padding
   ¤ ['headerlength'] now includes the initial 6 or 10 bytes of the
     ID3v2 header
   ¤ ['artist'], ['title'], ['album'], ['tracknumber'], ['genre'] now
     returned for easier access for Ogg files
   ¤ added ['datalength'] to all ID3v2 frames: length of frame data,
     not including frame header
   ¤ ['fileformat'] now returns 'id3' if there are ID3v1 or ID3v2 tags
     but no audio data
   ¤ ['fileformat'] now returns 'mpg' if it's an MPEG system (video +
     audio) file
   * Bugfix: RVAD was being parsed incorrectly
   * Bugfix: ['currency'] and ['purchasedate'] now correctly returned
     in OWNE
   * Bugfix: Frequncies in 'EQU2' frames were incorrectly double
   * Bugfix: ['bytedeviation'] and ['msdeviation'] now properly
     returned as integer rather than binary string for 'MLLT' frames
   * Bugfix: ['filename'] now properly returned for 'GEOB' frames
   * Bugfix: ['imagetype'] now properly returned for 'PIC' frames in
     ID3v2.2
   * Bugfix: Genre not being written if not set in WriteID3v1()
     (thanks reel_tazØusers*sourceforge*net)
   * Bugfix: Changed write mode to 'r+b' from 'a+' because ID3v1 tags
     were being appended instead of overwritten if they already existed
     (thanks reel_tazØusers*sourceforge*net)
   * Bugfix: open would fail on filenames containing quotes
     (thanks javierØcrackdealer*com)
   * Bugfix: various values were incorrectly returned (unneeded ord())
     in these frames: COMR, USER, ENCR, GRID, PRIV, SIGN
   * Bugfix: ASPI ['bitsperpoint'] was not correctly returned
   * Bugfix: RoughTranslateUnicodeToASCII() was not returning the last
     char for UTF-16
   * Bugfix: ['audiobytes'] now correctly 0 if no synch found
   * Bugfix: GenreLookup was incorrectly returning 'Remix' instead of
     'Blues' for GenreID 0
   Added sample directory browser to check.php
   Seperated out MPEGaudio-parsing functionality into
     getOnlyMPEGaudioInfo() which may be called directly if you don't
     need any ID3 parsing  (thanks djpretzelØcox*rr*com for idea)
   Reduced use of fread() for increased performance in
     getID3v1Filepointer()
   Added clearstatcache() before checking filesize - size after writing
     tag now correct
   Added hack for mp3Rage (www.chaoticsoftware.com) that puts
     ID3v2.3-formatted MIME type instead of 3-char ID3v2.2-format image
     type  (thanks xbhoffØpacbell*net for test file)


1.3.2: [February-15-2002] James Heinrich
   ¤ UFID/UFI, USLT/ULT, COMM/COM, APIC/PIC, GEOB/GEO, CRM, RVA2, EQU2,
     POPM/POP, AENC/CRA, ENCR and GRID frame data now returned under
     numeric array index rather than by ownerID
   ¤ RVA2 frame data is now returned keyed by $channeltypeid instead of
     $frame_idstring
   ¤ WXXX/WXX frame description now returned under ['description']
     instead of ['data']
   Trailing null bytes now trimmed from frame (W??? & T???) text data
     (it shouldn't be there to begin with, but a sample file encoded by
     [unknown program] had data padded to 50 chars with null bytes,
     which caused ParseID3v2GenreString() to freeze).


1.3.1: [February-13-2002] James Heinrich
   * Bugfix: ['playtime_seconds'] and ['playtime_string'] were not
     being returned
   * Bugfix: ['fileformat'] was incorrectly being returned as a
     2-element array
   * Bugfix: USLT wasn't being correctly parsed
   Improved RoughTranslateUnicodeToASCII()
     (thanks reel_tazØusers*sourceforge*net for Unicode test file)


1.3.0: [February-13-2002] James Heinrich
   » ID3v1 writing support via WriteID3v1()
   ¤ MPEG audio frame information (bitrate, frequency, etc) now
     returned inside ['mpeg']
   ¤ ['mpeg']['raw'] returns the integer values of the bits for MPEG
     audio information as returned in ['mpeg'] by decodeheader()
     (thanks reel_tazØusers*sourceforge*net)
   ¤ 'protection', 'padding', 'private', 'copyright' and 'original' now
     return as boolean
   ¤ 'bitrate' and 'frequency' now return as int (except in special
     case of 'free')
   Language name as well as code retured where appropriate
     (ie 'English' and 'eng')
   Text frames with invalid TextEncoding value are now passed through
     anyway
   ID3v1 data (title, artist, album, year, comment) is now trimmed
     (no more nulls)
   RoughTranslateUnicodeToASCII() now uses utf8_decode() for UTF-8


1.2.5: [January-30-2002] James Heinrich
   * Bugfix: Playtime calculations for VBR files were off slightly
     (rounding error)
   * Bugfix: Extended header length was incorrectly calculated
   * Bugfix: Genre strings such as '03' weren't being handled correctly
   More complete support for ID3v2.3 FrameIDs
   Split out getid3.frames.php (FrameID-specific parsing function)
   Split out getid3.lookup.php (assorted lookup-table functions)
   Searches for what directory getid3.*.php support files are in (must
     be same as getid3.php, but doesn't have to be same as main file -
     for example your main file could be /index.php, but including
     /lib/getid3/getid3.php)
   Simplified, tweaked, changed and/or eliminated several functions.


1.2.4: [January-26-2002] James Heinrich
   » Basic support for reading Ogg-Vorbis comment tags


1.2.3: [January-24-2002] James Heinrich
   » ID3v2.2.x 3-char FrameIDs are now fully parsed
     Note: While I've included support for 22 FrameIDs as defined in
     the specs, I don't have test files for all of them. If anyone
     knows of programs that generate any of the untested tags, please
     email infoØgetid3Øorg ! Here's what's tested and not:
       Tested: T??, COM
     Untested: UFI, TXX, W??, WXX, IPL, MCI, ETC, MLL, STC, ULT, SLT,
               RVA, EQU, REV, PIC, GEO, CNT, POP, BUF, CRM, CRA, LNK
   table_var_dump() now displays boolean variables as TRUE or FALSE
   table_var_dump() now uses htmlspecialchars() to avoid broken-table
     problems


1.2.2: [January-18-2002] James Heinrich
   ¤ Parses ID3v2 genres into ['id3']['id3v2']['genreid'] and
     ['id3']['id3v2']['genrelist'] where appropriate
     (thanks stephaneØtekartists*com for the idea)
   Added ID3v2 genre abbreviations 'RX' (remix) and 'CR' (cover)


1.2.1: [January-17-2002] James Heinrich
   * Bugfix: 'mp3' was being returned in ['format'], but 'zip' was
     being returned in ['fileformat'], both are now returned in
     ['fileformat']
   ¤ Splits ['id3']['id3v2']['track'] in the format '5/12' into
     ['track'] = '5' and ['totaltracks'] = '12'
   ¤ Enabled ['id3']['id3v2']['title'] etc for ID3v2.2.x
     (3-char frame names)  (thanks stephaneØtekartists*com)
   ¤ Changed v1.?? version number format to v1.?.?
   Scans through the file until it finds the MPEG synch (start of audio
     frame) - some files encoded by LAME 3.91 had undocumented padding
     after the ID3v2 header; getMP3headerFilepointer() now scans until
     it finds synch (or EOF)  (thanks adamØtrekjapan*com)
   Improved Unicode conversion in RoughTranslateUnicodeToASCII()


1.20:  [January-15-2002] James Heinrich
   » Support for variable-bitrate (VBR) files, both Xing and Fraunhofer
     headers
   » All 4-character FrameIDs are now fully parsed according to the
     specs at http://www.id3.org/id3v2.4.0-frames.txt
     ¤ This means that most no longer return ['flags'] and ['data']
     Note: While I've included support for 30 FrameIDs as defined in
     the specs, I don't have test files for all of them. If anyone
     knows of programs that generate any of the untested tags, please
     email infoØgetid3Øorg ! Here's what's tested and not:
       Tested: UFID, T???, WXXX, USLT, SYLT, COMM, APIC, GEOB
     Untested: TXXX, W???, MCDI, ETCO, MLLT, SYTC, RVA2, EQU2, RVRB,
               PCNT, POPM, RBUF, AENC, USER, OWNE, COMR, ENCR, GRID,
               PRIV, SIGN, SEEK, ASPI
   ¤ Added 'title', 'artist', etc names to ID3v2 data (easier to access
     than the 4-character FrameIDs of the ID3v2 standard)
     (thanks jaksonØgmx.net)
   * Bugfix: added fclose() at end of GetAllMP3Info()
     (thanks stephaneØtekartists*com)
   * Bugfix: ID3v1 wasn't being parsed if ID3v2 wasn't present
     (thanks jaksonØgmx.net)
   * Bugfix: several flags were being parsed incorrectly (the structure
     had changed from ID3v2.3 to ID3v2.4) - v2.3 flags were being
     incorrectly parsed
   Much more compact implementation of decodeheader()
     (thanks jaksonØgmx.net for the idea)
   ID3v1 genres 126 through 147  (thanks jaksonØgmx.net)
   New table_var_dump() function in check.php
     (based partially on idea by jaksonØgmx.net)
   Seperated ID3v1 retrieval into seperate function


1.11:  [December-23-2001] James Heinrich
   All functions merged into file getid3.php
   Updated documentation to reflect new returned information


1.10:  [December-20-2001] James Heinrich
   * Bugfix: ID3v1 Track# was incorrectly being parsed whether it
     existed or not
   Changed calling procedure to recommend using
     GetAllMP3info($filename) from getmp3header.php
   Now includes check.php - example file
   ¤ Checks to see if file is in ZIP or MP3 format
     (returned in ['format'])
     [Ed. Note: ['fileformat'] as of v1.2.1]


1.06:  [November-05-2001] James Heinrich
   * Bugfix: ID3v2.2.x frames weren't being parsed since they use
     6-byte rather than 10-byte headers as v2.3+ does
     (thanks spunkØmac*com for pointing that out)


1.05:  [September-06-2001] James Heinrich
   * Bugfix: ID3v2 was being parsed even if it didn't exist


1.04:  [July-16-2001] James Heinrich
   * Bugfix: typo in Extended Header section (strpad() should be
     str_pad()) (thanks jurroonØyahoo*com)


1.03:  [May-07-2001] James Heinrich
   * Bugfix: Added missing ['id3']['id3v1']['genreid'] and
     ['id3']['id3v1']['genre']


1.02:  [May-05-2001] James Heinrich
   ¤ Added ['getID3version']


1.01:  [May-04-2001] James Heinrich
   » Added support for frame-level de-unsynchronisation (as per
     ID3v2.4.0 specs) in addition to ID3v2.3.x tag-level
     de-unsynchronisation


1.00:  [May-04-2001] James Heinrich
   » Initial public release