2/// getID3() by James Heinrich <info@getid3.org>               //
3//  available at http://getid3.sourceforge.net                 //
4//            or https://www.getid3.org                        //
5//          also https://github.com/JamesHeinrich/getID3       //
7//                                                             //
8// changelog.txt - part of getID3()                            //
9// See readme.txt for more details                             //
10//                                                            ///
13        »  denotes a major feature addition/change
14        ¤  denotes a change in the returned structure
15        !  denotes a cry for help from developers
16* Bugfix:  denotes a fixed bug
18Version History
211.9.20: [2020-06-30] James Heinrich :: 1.9.20-202006061653
22	» add support for DSDIFF audio
23	» add support for TAK lossess audio
24	» add support for IVF video
25	» add detection support for EPUB files
26	» add detection support for HPK archives
27	» add demo.mysqli.php, remove demo.mysql.php
28	¤ QuickTime.uuid now returned as an array (may contain multiple entries)
29	¤ improved PDF support, including page count
30	* bugfix (G:247) array_min incorrect return value
31	* bugfix (G:242) filepointer analysis errors
32	* bugfix (G:238) comments_html may not match comments
33	* bugfix (G:235) prevent disclosing paths when accessing modules directly
34	* bugfix (G:233) Quicktime duplicate attached images
35	* bugfix (G:229) Quicktime timestamps easy access
36	* bugfix (G:228) master.zip did not contain demos
37	* bugfix (G:227) Quicktime check subatoms data length
38	* bugfix (G:226) uuid parsing based on UUID
39	* bugfix (G:225) use comments_html content already generated by modules
40	* bugfix (G:223) ID3v2 slashed genre names
41	* bugfix (G:222) demo.browse filesystem character encoding
42	* bugfix (G:221) option_tags_html=false ignored
43	* bugfix (G:219) Quicktime.UUID now parsed more discriminately for XML and other data types
44	* bugfix (G:218) QuickTime not copying covr to comments
45	* bugfix (G:217) mp3 array offsets of type bool
46	* bugfix (G:216) ID3v2.write allow WMP rating in POPM
47	* bugfix (G:210) PHP 7.4 deprecated get_magic_quotes
48	* bugfix: Quicktime detect null-terminated strings used where Pascal strings should be
49	* bugfix: Quicktime GPS uninitialized array keys
511.9.19: [2019-12-17] James Heinrich :: 1.9.19-201912131005
52	» add placeholder support for WTV (Windows Recorded TV Show)
53	* bugfix (G:210) PHP 7.4 deprecated get_magic_quotes
54	* bugfix (G:207) improved LAME version string parsing
55	* bugfix (G:206) inverted logic in CopyTagsToComments
56	* bugfix (G:203) use getimagesizefromstring if available
57	* Quicktime decode 'uuid' atom for 360fly cameras
591.9.18: [2019-07-24] James Heinrich :: 1.9.18-201907240906
60	* bugfix (G:198) use native hash functions instead of obsolete external binaries
61	* bugfix (G:194) PHP 7.4 compatibility: fix deprecated curly brace array access
62	* bugfix (G:191) unsupported operand types module.audio.ac3.php:763
63	* bugfix (G:189) false UTF-16 <BOM> and no termination strings
64	* bugfix (G:188) add support for DS2 v8
65	* bugfix (G:187) RIFF.WAVE.scot parsing
66	* bugfix (G:184) invalid regex pattern (ID3v1)
67	* bugfix (G:183) reduced information for GIF files with $option_extra_info=false
68	* bugfix (G:175) mp4 max buffer size
69	* bugfix (G:174) TIFF parsing improvements
70	* bugfix (G:121) trailing nulls in ID3v2 strings
71	* standardize "track" -> "track_number"
731.9.17: [2019-02-07] James Heinrich :: 1.9.17-201902071234
74	* bugfix (G:178) HandleAllTags should skip "picture"
75	* bugfix (G:177) error checking for reading more than PHP memory_limit
76	* bugfix (G:176) improved mp3 detection in remote-file demo
77	* bugfix (G:173) Add filepointer option to analyze/openfile function
78	* bugfix (G:170) Add support for WXXX (URL) and APIC (attached picture) subframes inside ID3v2 chapters
79	* bugfix: write.id3v2 year field
80	* bugfix: mp3.APE permit optional " dB" in ReplayGain tags
81	* placeholder support for .xz file format
831.9.16: [2018-10-17] James Heinrich :: 1.9.16-201810171314
84	* bugfix (G:168) Ogg FLAC not parsed
85	* bugfix (G:163) invalid MP3 header error on VBR
86	* bugfix (G:162) prevent writing multiple ID3v2 versions
87	* bugfix (G:161) MP3 VBR header duration
88	* bugfix (G:160) OggOpus duration sometimes incorrect
89	* bugfix (G:157) quicktime GPS invalid argument
90	* bugfix (G:148) MPEG-2 aspect ratio
91	* bugfix (G:147) Quicktime fourcc codec name lookup
92	* bugfix (G:147) Quicktime audio/video bitrate guessing
93	* bugfix (G:145) incompatible variable types
94	* bugfix (G:139) Quicktime islt subatoms >5
95	* bugfix (G:137) ID3v2 semi-numeric genres
96	* bugfix (G:136) ID3v2 unsynchronised typo
97	* bugfix (#2514) FLAC zero-byte block header
98	* bugfix (#2488) MIME types (FLAC, WAV, gzip)
99	* bugfix (#2468) Quicktime video rotation
100	* bugfix (#2207) metaflac + attached pictures
101	* bugfix (#2151) improved demo UNC filename support
102	* bugfix (#1966) fread fail when PHP memory_limit -1
103	* bugfix (#1908) Quicktime rotation detection (using matrix values)
104	* bugfix (#1908) Quicktime "rcif" and "dscp" atoms
105	* bugfix (#1900) demo.joinmp3 cut from end
106	* security: avoid disabled demo reflection
107	* TIFF: expand list of named tags, expose as 'tag_name' key for all entries
108	* Quicktime: parse some GoPro-specific data
109	* helperapps (Windows): updated vorbiscomment.exe, metaflac.exe to v1.3.2
110	* add more image formats supported by getimagesize()
1121.9.15: [2017-10-26] James Heinrich :: 1.9.15-201709291043
113    » (G:108) add basic APNG support
114    » (G:107) add basic WebP support
115    * return RIFF.WAV.CART comments in merged comments section
116    * add support for QuickTime 'loci' chunk
117    * bugfix: (#2124) support for Quicktime/MP4 "chpl" (CHaPter List) atom
118    * bugfix: (G:128) undefinied bsmod in module.ac3
119    * bugfix: (#2114) possible issue with UTF8 filenames and metaflac
120    * bugfix: (G:123) remove MySQL engine and collation from create table
121    * bugfix: (#2066) fix AAC MIME type, remove video key for audio-only files
122    * bugfix: (G:111) QuickTime stsd number_entries deadlock
123    * bugfix: (G:110) PHP memory limit with space
124    * bugfix: (G:109) improved animated GIF support
125    * bugfix: (#1966) GPS track in QuickTime
1271.9.14: [2017-03-27] James Heinrich
128    » Add experimental support for E-AC3
129    * bugfix (G:105): RIFF.WAVE.iXML multiple TIMESTAMP_SAMPLE_RATE
130    * bugfix (G:95): improperly initialized error/warning keys
131    * bugfix (G:94): ID3v2 write support for TXXX
132    * bugfix (G:93): all errors or warnings should pass through class method
1341.9.13: [2016-12-14] James Heinrich
135    * bugfix (G:89): ID3v2.4 custom genres with slashes
136    * bugfix (G:88): large QuickTime files exceed PHP memory limit
137    * bugfix (G:87): ID3v2 write GRID data not working properly
138    * bugfix (G:86): Increase autoloading definitions
139    * bugfix (G:84): ID3v2 available writable frames list
140    * bugfix (G:82): ID3v2 datetime logic
141    * bugfix (G:80): attempt to autodetect ID3v1 encoding
142    * bugfix (G:77): add partial support of DSSv6
143    * bugfix (G:76): add mysqli version of caching extension
144    * bugfix (G:75): mysql cache max key length
145    * bugfix (G:71): custom error handler to catch exif_read_data() errors
146    * bugfix (G:71): add support for mb_convert_encoding
147    * bugfix (G:70): ID3v2 POPM / UFID
148    * bugfix (G:68): workaround broken iTunes ID3v2
149    * bugfix (G:48): Quicktime set MIME to video/mp4 where applicable
150    * bugfix (#1930) fread on pipes
151    * bugfix (#1926) relax ID3v2.IsValidURL check
1531.9.12: [2016-03-02] James Heinrich
154    » Add support for Direct Stream Digital (DSD) /
155      DSD Storage Facility (DSF) file format
156    » Add detection (not parsing) of WebP image format
157    * bugfix (#1910): Quicktime embedded images
1591.9.11: [2015-12-24] James Heinrich
160    * bugfix (G:64): update constructor syntax for PHP 7
161    * bugfix (G:62): infinite loop in large PNG files
162    * bugfix (G:61): ID3v2 remove BOM from frame descriptions
163    * bugfix (G:60): missing "break" in module.audio-video.quicktime.php
164    * bugfix (G:59): .gitignore comments
165    * bugfix (G:58): inconsistency in relation to module.tag.id3v2.php
166    * bugfix (G:57): comparing instead of assign
167    * bugfix (G:56): unsupported MIME type "audio/x-wave"
168    * bugfix (G:55): readme.md variable reference
169    * bugfix (G:54): QuickTime false 1000fps
170    * bugfix (G:53): Quicktime / ID3v2 multiple genres
171    * bugfix (G:52): sys_get_temp_dir in GetDataImageSize
172    * bugfix (#1903): Quicktime meta atom not parsed
173    * demo.joinmp3.php enhancements
174    * m4b (audiobook) chapters not parsed correctly
175    * sqlite3 caching not working
1771.9.10: [2015-09-14] James Heinrich
178    * bugfix (G:49): Declaration of getID3_cached_sqlite3
179    * bugfix (#1892): extension.cache.mysql
180    * bugfix (#1891): duplicate default clause [Quicktime]
181    * bugfix (G:41): incorrect MP3 playtime
182    * bugfix: iconv problems on musl with //TRANSLIT
183    * Add arguments to analyze() for original filesize (and filename)
184    * ID3v2 simplify handling of multiple genres
185    * Corrected merging of multiple genres for ID3v2
186    * getid3_lib::GetDataImageSize return false on error
1881.9.9: [2014-12-18] James Heinrich
189    » Added basic support for OggOpus
190    » Add ID3v2 CHAP + CTOC support
191    * Add composer autoloader
192    * bugfix: removed non-printable ASCII in comment
193    * bugfix: possible memory leak in OggFLAC
194    * bugfix: sys_get_temp_dir undefined before PHP 5.2.1
195    * bugfix: improved fix for XXE security issue (CVE-2014-2053)
196      (thanks nacinØwordpress*org)
197    * bugfix: G:25 ID3v2 LINK utf8_encode not defined
198    * bugfix: G:22 ID3v2 TXXX description encoding
199    * bugfix: #1855 - copy image height/width/etc to comments
200    * bugfix: #1855 - PHP errors in badly written APE/ID3v2 tags
201    * bugfix: #1845 - Quicktime parsing with no PHP memory_limit
202    * bugfix: #1828 - ID3v2 writing unknown frame names
2041.9.8: [2014-05-11] James Heinrich
205    » Add support for AMR (Adaptive Multi-Rate audio codec)
206      new file: module.audio.amr.php
207    » Added composer.json, registered on packagist.org
208    * Added workaround for PHP Bug #39923 (undefined constant IMG_JPG)
209    * Bugfix: (#1813) avoid running out of memory when parsing large
210      Quicktime files
211    * Bugfix: (#1812) potential unwanted high-ASCII characters in errors
212    * Bugfix: close potential XXE security issue (CVE-2014-2053)
213    * Bugfix: (G:10) Avoid warnings from realpath() if SAFE MODE is enabled
214    * Bugfix: (G:12) If [tags] data contains an array of strings then html
215      encoding did not take place.
216    * Bugfix: (G:12) IPTC character set not specified
217    * Bugfix: possible divide by zero error in FLV module
218    * Bugfix: possible undefined key in ID3v2
219    * Bugfix: possible undefined key in MPEG video files
220    * Bugfix: demo.browse to use character set consistently
2221.9.7: [2013-07-05] James Heinrich
223    * Bugfix: [module.audio-video.quicktime.php] track languages set
224      with 15-bit-encoded ISO639-2 language codes not parsed correctly
225    * Bugfix: (#1717) QuickTime atom hierarchy broken
226    * Bugfix: (#1716) truncate MIDI file could cause infinite loop
227    * Bugfix: all source files converted to UTF-8
2291.9.6: [2013-06-03] James Heinrich
230    » getID3() is now licensed under GPL / LGPL / MozillaPL / gCL
231      See license.txt for more details.
232    * Bugfix: (#1550) Quicktime video track sample description parsed
233      incorrectly
234    * Bugfix: (#1550) Quicktime matrix U/V/W values calculated incorrectly
235    * [demo.browse] disable edit-tag and delete-file links by default
236    * Bugfix: option_max_2gb_check should issue warning not error on >2GB
2381.9.5: [2013-02-20] James Heinrich, Dmitry Arkhipov
239    » DTS-in-WAV now properly supported
240    ¤ DSS files return additional data in new keys, and some existing
241      keys have been renamed
242    * Bugfix: open_basedir not parsed correctly under Windows
243      (thanks yannick*jamontØgmail*com)
244    * Bugfix: [demo/demo.browse] might not display file or directory name
245      on PHP >=5.4.0 if filename not UTF-8 friendly
246    * Bugfix: [demo/demo.zip] could read more uncompressed data than
247      required; fail to read file if local data descriptor not set;
248      some wrong include files were listed; improved error message display
249    * Bugfix: [module.audio-video.riff] INFO comment chunks with null name
250      chunk not parsed correctly
251    * Bugfix: [module.archive.gz] gzip files with filename stored may have
252      filename reduplicated in [gzip][files] output
253    * Bugfix: [module.archive.zip] data_descriptor not parsed correctly
254    * Bugfix: [module.archive.zip] some newer compression methods unknown
255    * Bugfix: [module.archive.zip] not all flags parsed
256    * Bugfix: [module.archive.zip] local file header not parsed correctly
257      if file has zero values for compressed_size in Local File Header
258    * Bugfix: (#1493) better support for >2GB filesize on 32-bit Linux
259    * Bugfix: (#1474) unneccesary call to GetDataImageSize in JPEG module
260    * Bugfix: (#1470) GIF files falsely detected as TS format
261    * Bugfix: (#1431) Matroska did not parse PixelCrop* / DisplayUnit
262      (thanks jgerberØwikimedia*org)
263    * Bugfix: (#1430) split ID3v2 text values on null separator
264    * Bugfix: (#1426) MS Office 2007 file format now recognized as zip.msoffice
265    * Bugfix: (#1423) optimized CreateDeepArray function
266    * Bugfix: (#1415) add support for DS2 variant of DSS
2681.9.4b1: [2012-10-05] James Heinrich, Dmitry Arkhipov, Karl G. Holz
269    » New module: extension.cache.sqlite3.php (by Karl G. Holz)
270    » New demo: demos/getid3.demo.dirscan.php (by Karl G. Holz)
271    » PHP5 standards improvements (thanks phansysØgmail*com)
272    » more reliable >4GB file size parsing using COM (if available)
273      Scripting.FileSystemObject rather than parsing `dir` output
274    * added support for FLAC inside Matroska (audio bitrate cannot
275        be determined in this case)
276    * XMP module now returns all tags, not just whitelisted ones
277    * (#1297) Added detection of MPEG Transport Stream files.
278      Stub module.audio-video.ts.php incomplete
279    * (#1383) removed unneeded ?> tags (thanks daveØholyfield*info)
280    * Bugfix: XMP returns attributes array not just value strings
281    * Bugfix: (#1369) ID3v2 IPLS contents not parsed
282    * Bugfix: (#1357) demo.mysql.php mysql_table_exists() failed
283    * Bugfix: (#1355) copy Foobar2000 QuickTime tags to [comments]
284    * Bugfix: (#1351) QuickTime files with zero-sized atom boxes
285      could cause infinite loop
286    * Bugfix: (#1343) FLAC attached pictures Ogg not handled
287    * Bugfix: (#1343) ID3v2 inside WAV "id3 " chunk not handled
288    * Bugfix: (#1315) BMP detection was broken
289    * Bugfix: (#1309) ID3v2.2 content_group_description (TT2) did
290      not copy to same place as ID3v2.3/ID3v2.4 (TIT2)
291    * Bugfix: (#1308) [playtime_string] could show hh:mm:60
292    * Bugfix: (#1306) extension.cache.mysql.php keyword TYPE->ENGINE
293    * Bugfix: (#1295) missing video information if QuickTime file has
294      disabled tracks
295    * Bugfix: (#1275) MD5/SHA1 data hashes not working properly
296      under Windows
2991.9.3: [2011-12-13] Dmitry Arkhipov, James Heinrich
300    * Matroska module improved:
301      1. Added support for A_MS/ACM audio codec
302      2. Fixed issues in tags, cues, chapters and clusters parsing
303      3. Fixed almost all errors with track_data_offset, errors
304         still may occur with Xiph data lacing
305      4. Optimized audio/video streams population with usage of the
306         official default values for missing elements
307      5. Audio/video keys are now populated with data from the
308         default stream, not from the first one as before
309      6. Full WebM support
310    * Bugfix: demo.browse would not pop up warnings when clicked
311      if warning contains apostrophe/single-quote character
312    * Bugfix: (#1269) ID3v1 genre typo "Trash"->"Thrash" Metal
3151.9.2: [2011-12-08] James Heinrich, Dmitry Arkhipov
316	» significant rewrite to module.audio-video.matroska.php
317    ¤ (#1256) ID3 tags in AIFF 'ID3 ' chunks now parsed
318    ¤ (#1039) iXML data in WAV files now returned and parsed into
319        [riff][WAVE][iXML][0][data] and [riff][WAVE][iXML][0][parsed]
320    ¤ [playtime_string] now returns M:SS if less than 1 hour, and
321        H:MM:SS if 1 hour or longer
322    * Bugfix: (#1266) variable tablename: extension.cache.mysql.php
323    * Bugfix: (#1265) unescaped # in regex in write.id3v2.php
324    * Bugfix: (#1252) MediaMonkey writes blank ID3v2 RGAD frames
325      and puts replay-gain values in TXXX frames
326    * Bugfix: (#1251) FLV playtime could be inaccurate for longer
327        files where meta frame is present but meta-playtime is zero
328    * Bugfix: (#1216) show hex values of unknown atom names
329    * Bugfix: (#1215) undefined variable in PrintHexBytes()
330    * Bugfix: FLV audio bitrate was returning kbps not bps
331    * Bugfix: missing ) in write.real.php::RemoveReal()
332    * Bugfix: replace $this::VERSION with getID3::VERSION in
333        extension.cache.*.php
3361.9.1: [2011-08-10] James Heinrich
337    ¤ ASF Extended Header Object data now (partially) parsed
338    * Default getID3 encoding now set to UTF-8 not ISO-8859-1
339    * Bugfix: (#1212) truncated Matroska files may result in
340        infinite loop and memory exhaustion
341    * Bugfix: (#1203) parse RIFF JUNK chunks for version strings
342    * Bugfix: (#1201) multi-byte characters strings incorrectly
343        displayed by table_var_dump() in demo.browse.php
344    * Bugfix: (#1199) prevent PHP warning on malformed ID3v2 APIC
345    * Bugfix: (#1196) typo in module.audio-video.quicktime.php
346    * Bugfix: (#1195) QuicktimeStoreFrontCodeLookup() broken
347    * Bugfix: (#1194) mp4 embedded images not handled correctly
348    * Bugfix: (#1193) [image_mime] key not set fo WM/picture data
349    * Bugfix: (#1193) ASF Extended Header Object Metadata Library
350        now parsed for embedded images and handled per usual style
351    * Bugfix: (#1190) demo.mimeonly.php was broken since v1.9.0
352    * Bugfix: ID3v2 comment is now called 'comment' not 'comments'
353    * Bugfix: AVI unknown codec fourcc would be reported as blank
354    * Bugfix: AVI zero-size JUNK chunk would give warning
3571.9.0: [2011-06-20] James Heinrich
358    » changed all module classes to have proper constructors
359      with the actual analysis code moved to function Analyze()
360    * removed unnecessary ob_* calls, replaced with appropriate
361      checks and judicious use of @ error suppression
362    ¤ GETID3_VERSION constant replaced with $getID3->version()
363    ¤ picture data is now returned only in the original source
364      location and [comments][picture], it is no longer replicated
365      in [comments_html], [tags] or [tags_html]
366    ¤ Matroska tags are now returned in [comments] as per normal
367    ¤ Matroska tags are better supported, including pictures
368    ¤ GPS data in MP4 files (e.g. iPhone) is now parsed (#1157)
369    ¤ Matroska audio/video tracks with a default flag, the default
370      stream flag is now copied to [audio|video][streams] (#1147)
371    ¤ Nikon-specific data (NCDT atom) in Quicktime videos now parsed
372    ¤ QuickTime atoms 'meta' and 'data' now (mostly) parsed
373    * Bugfix: remove false warning of junk data on WAV+ID3v1
374    * Bugfix: DolbyDigitalWAV files returned wrong audio bitrate
375    * Bugfix: large attachment data in Matroska tags were not
376      returned completely.
377    * Bugfix: wrong image_mime used for images in demo.browse.php
378    * Bugfix: broken preg_match in module.audio.dss.php
379    * Bugfix: Lyrics3 end offset was off by 1
380    * Bugfix: audio channelmode could be wrong for 2 channels
381      (e.g. joint stereo reported as stereo)
382    * Bugfix: MultiByteCharString2HTML() would return empty string
383      if passed float or int value, now casts to string first
384    * Bugfix: FLAC.picture was not returning under [data] +
385      [image_mime] per standardized format
386    * Bugfix: BigEndian2Int() could incorrectly return negative
387      signed synchsafe integer instead of casting to float
388    * Bugfix: (#1177) ID3v2.4 extended headers were broken
389    * Bugfix: (#1173) some MIDI files not completely parsed
390    * Bugfix: (#1171) change helperapps error to nonblocking warning
391    * Bugfix: (#1170) possible infinite loop in FLV module
392    * Bugfix: (#1169) $this reference in static function (ID3v2)
393    * Bugfix: (#1156) demo.mysql.php not working
394    * Bugfix: (#1153) badly-tagged files could produce invalid
395      argument errors in module.tag.xmp.php
396    * Bugfix: (#1152) add error-suppression to iconv() calls
397    * Bugfix: (#1151) AAC-ADTS files could sometimes not find sync
398    * Bugfix: (#1136) last character of unicode tags (e.g. ASF)
399      was being truncated
400    * Bugfix: (#1133) write.id3v2.php IsValidURL() was broken
401    * Bugfix: (#1126) ID3v2.POPM field was being clobbered
402    * Bugfix: (#999, #1154) ID3v2 UFID data was missing
4051.8.5: [2011-02-18] James Heinrich
406    » support >2GB files on 64-bit PHP
407      - note current unofficial 64-bit PHP builds for Windows
408        do not actually support 64-bit integers so are still
409        subject to normal 32-bit limits (2GB) for file functions
410    » PHP v5.0.5 now minimum required version.
411      Removed obsolte functions from getid3.lib.php:
412        md5_file, sha1_file, image_type_to_mime_type
413    » IDivX tags now parsed on AVI files
414    ¤ embedded image data is returned inside [comments][picture]
415      in a 2-element array (data, image_mime) for all formats
416    * $this->overwrite_tags=false is now known to be buggy and
417      has been disabled for this version until a full review
418      of tag writing can be completed. Certainly affects ID3v2,
419      the other writable tag formats may or may not be broken
420    * getID3 constructor no longer checks for (or sets) timezone
421    * demo.browse.php now shows cover art as inline images
422      rather than dumped to separate files
423    * [audio][streams][x][language] now set when known
424    * Bugfix: RIFF-AVI "JUNK" chunks are now parsed properly,
425      including zero-sized ones (no more false errors)
426    * Bugfix: msoffice documents now return correct error message
427    * Bugfix: demo.browse.php now encodes data according to
428      current page encoding (default=UTF-8)
429    * Bugfix: (#1120) sometimes incorrect ID3v2 genre parsing
430    * Bugfix: (#1116) possibly incorrect warnings (or lack of)
431      for RIFFs > 2GB.
432    * Bugfix: (#1115) wrong RIFFtype in RIFF files
433    * Bugfix: (#1114) wrong MIME type may be set for Matroska
434    * Bugfix: (#1113) support DSS v3 files
435    * Bugfix: (#1111) cover art in APE tags now supported
436    * Bugfix: (#1091) RemoveID3v1() unitialized variables
437    * Bugfix: (# 504) do not set Quicktime resolution if
438      'tkhd' atom is disabled
439    * Bugfix: (#  95) return [quicktime][controller] if known
4421.8.4: [2011-02-03] James Heinrich
443    * change default encoding in ID3v2 writing to UTF16-LE+BOM
444      (or ISO-8859-1 where possible) for better compatability
445      with broken versions of Windows Media Player and iTunes
446    * Bugfix: [FLV] incorrect overall bitrate in some files
447    * Bugfix: (#1102) missing parentheses in write[.id3v2].php
448    * Bugfix: (#510) undefined IsValidDottedIP() in write.id3v2.php
4511.8.3: [2011-01-18] James Heinrich
452    » magic_quotes_gpc must now be disabled to use getID3
453    » replace all error-suppressing @$variable calls with
454      isset() or empty() as appropriate for some configurations
455      where @ does not act to suppress warnings of undefined
456      variables (e.g. support forum thread #798)
457    * remove SafeStripSlashes() and FixTextFields functions
458    * [quicktime] use fourcc if codec name zero-length
459    * [quicktime] support "iods" atom
460    * Bugfix: (#1099) sometimes incorrect detection of safe_mode
461    * Bugfix: (#1095) more robust setting of temp dir
462    * Bugfix: (#1093) add support for ClusterSimpleBlock to
463      prevent "Undefined index: track_data_offsets" errors
464      in Matroska files
465    * Bugfix: [riff] prevent errors when RIFF.WAVE.BEXT chunk
466      contains null date/time  (thanks moysevichØgmail*com)
467    * Bugfix: [quicktime] prevent divide-by-zero errors if
468      time_to_sample_table has zero-sample entry
469      (thanks moysevichØgmail*com)
4721.8.2: [2010-12-06] James Heinrich
473    * include startup warning for PHP < v5
474    * magic_quotes_runtime must now be disabled to use getID3
475    ¤ MusicBrainz / AmpliFIND data more accessible in returned data
476      from Quicktime-style files (e.g. MP4/AAC)
477    * Bugfix: (#1079) wrong encoding might be used for ID3v2
478        text data, and/or garbage data prepended before text
479        data; DataLengthIndicator value was being ignored
480    * Bugfix: (#1055) clearer warnings on non-EXIF contents in
481      JPEG [APP1]
482    * Bugfix: (#999) ID3v2 UFID data was missing
4851.8.1: [2010-11-25] James Heinrich
486    * replaced calls to deprecated mysql_escape_string() with
487      mysql_real_escape_string()
488    * Bugfix: (#1072) memory limit not handled correctly if
489      in gigabytes in php.ini (e.g. "2G")
490    * Bugfix: (#1068) wrong encoding for Quicktime tags
491    * Bugfix: (#1040) possible infinite loop in genre parsing
492    * Bugfix: (#1036) helperapps directory not resolving 8.3
493        path names correctly
494    * Bugfix: (#1023) dbm cache extension not correctly handling
495        types other than "db3"
496    * Bugfix: (#1023) mysql cache extension now base64_encodes
497        data to make binary-safe. Existing cached data must be
498        purged from your database cache
499    * Bugfix: (#1007) ClosestStandardMP3Bitrate() not selecting
500        most appropriate value
501    * Bugfix: (#996) inefficient and buggy ID3v1 and ID3v2
502        genre parsing
503    * Bugfix: (#974) track number handled incorrectly in
504        demo.write.php
505    * Bugfix: (#969) tempnam() calls failing with open_basedir
506    * Bugfix: (#955) UTF-16LE text files could be falsely
507        identified as corrupt mp3 files
508    * Bugfix: (#877) detect if mbstring.func_overload is set in php.ini
509    * Bugfix: (#858) PHP safe_mode setting in php.ini incorrectly
510        handled if set to "Off"
511    * Bugfix: (#838) prevent warnings with assorted unhandled
512        Quicktime atoms
5151.8.0: [2010-11-23] James Heinrich
516    » Changes required for PHP v5.3+ compatability, including:
517      - change ereg* functions to preg_* equivalents
518      - declare functions static as needed
519      note: users of PHP v4.x may need to stay with getID3 v1.7.x
520    » Added CUE (cuesheet) support
521      new file: module.misc.cue.php
522      (thanks Nigel Barnes ngbarnesØhotmail*com)
523    » Added XMP (Adobe Extensible Metadata Platform) support
524      currently used with module.graphic.jpg.php
525      new file: module.tag.xmp.php
526      (thanks Nigel Barnes ngbarnesØhotmail*com)
527    ¤ [jpg][exif][GPS][computed] now exists when possible with
528      calculated values (decimal latitude, longitude, altitude, time)
529    ¤ Prevent clobbering WMA artist with albumartist value; added WMA
530      partofset tag; added WMA tag picture data to WMA comments
531      (thanks ngbarnesØhotmail*com)
532    ¤ RIFF.WAVE.SNDM (SoundMiner) metadata now parsed
533      (thanks emerrittØwbgu*bgsu*edu)
534    ¤ FLAC embedded pictures now return [data_length] key
535      (thanks darrenburnhillØhotmail*com)
536    * added support for a number of new comment atom types added in
537      iTunes v4.0-v7.0  (thanks ngbarnesØhotmail*com)
538    * demo.browse.php now shows video resolution and framerate (if no
539      artist or title info present)
540    * additional FLV details parsed, may be faster as well
541      (thanks ngbarnesØhotmail*com)
542    * Bugfix: DSS files longer than 60 seconds had wrong playtime
543    * Bugfix: possible empty array encountered in APE tags
544      (thanks csnaitsirchØweb*de)
545    * Bugfix: prevent fatal error when calling BigEndian2Int() on
546      zero-length string  (thanks taylor*fausakØgmail*com)
547    * Bugfix: prevent errors when parsing invalid Vorbis comments
548      (thanks dr*dieselØgmail*com)
549    * Bugfix: files could not be analyzed from Windows shares
550      (e.g. \\SERVER\Directory\Filename.mp3)
551    * Bugfix: RAR file opening should use 'filenamepath'
552      (thanks adrien*gibratØgmail*com)
553    * Bugfix: [asf][codec_list_object][codec_entries][x][description]
554      not containing expected comma-seperated values no longer aborts
555      (thanks larry_globusØyahoo*com)
556    * Bugfix: [id3v2] UFID was not returning data
557      (thanks joostØdecock*org)
5591.7.9: [2009-03-08] James Heinrich
560    » Added DSS (Digital Speech Standard) support
561      new file: module.audio.dss.php
562      (thanks luke*wilkinsØdtsam*com)
563    » Added MPC (Musepack) SV8 support
564      (thanks WaldoMonster)
565    ¤ some MPC [header] keys renamed to be the same between SV7/SV8
566    ¤ start aligning demos CSS styling with v2.x styles
567      new file: demos/getid3.css
568    ¤ JPEG now returns parsed IPTC tags in [iptc]
569    ¤ getid3_lib::GetDataImageSize now requires $imageinfo parameter
570    ¤ better support for Matroska files with AC3/DTS/MP3/OGG audio
571      (support still lacking for AAC)
572    ¤ standardize ID3v2 TCMP key to 'part_of_a_set' between reading
573      and writing  (thanks aaron_stormØyahoo*com)
574    ¤ added ID3v2 keys 'TCMP','TCP' to for writing iTunes-style tags
575      (thanks aaron_stormØyahoo*com)
576    ¤ back-ported PICTURE tag handling in FLAC tags
577      (thanks WaldoMonster)
578    ¤ added alternate method to get [video][frame_rate] from QuickTime
579    * added partial support for "TCMP"/"TCP" ID3v2 frames (iTunes
580      non-standard part-of-a-compilation tag)
581      (thanks aaron_stormØyahoo*com)
582    * slightly improved scanning through FLV files speed
583      (thanks franki)
584    * faster Matroska scanning by stopping at cluster chunks once
585      needed header chunks are found (much faster for large files)
586    * added workaround for broken tagging programs that miss terminating
587      null byte for numeric ID3v2.4 genres
588      (thanks yam655Øgmail*com)
589    * Bugfix: MultiByteCharString2HTML() did not escape common HTML
590      special characters like & and ?
591    * Bugfix: cleaned up some malformed HTML errors in demo.browse.php
592    * Bugfix: under Windows files >2GB might not be processed due to
593      "dir" command not finding file with double directory slashes
594    * Bugfix: "MODule (assorted sub-formats)" was falsely matching
595      some random files (e.g. JPEGs)  (thanks qwertywin)
596    * Bugfix: suppress PHP_notice on failed SWF-compressed
597      decompression failure  (thanks mkron)
6001.7.8b3: [2008-07-13] James Heinrich
601    » Experimental partial support for files > 2GB (gets filesize
602      from shell call to "dir" or "ls", parse files with PHP only
603      up to 2GB limit). See readme.txt for details on what formats
604      work properly and other limitations
605    » Initial support for Matroska. Has only been tested with a
606      limited number of sample files, please report any bugs
607    » Experimental support for PHP-RAR reading. Known buggy, disabled
608      by default, enable with care
609    ¤ getid3_lib::CastAsInt() now returns ints up to 2^31 (not 2^30)
610    ¤ Quicktime: [video] now returns [frame_rate] and [fourcc] for MP4
611      video files
612    * MP3: headerless VBR files now only have up to 10 blocks of 5000
613      frames each scanned by default and bitrate extrapolated from that
614      distribution for speed  (thanks glau*stuffØridiculousprods*com)
615    * Quicktime: support "co64" atom
616    * SWF: lower memory use when compressed SWF files processed
617      (thanks doughammondØblueyonder*co*uk)
618    * Bugfix: FLV height and width was calculated incorrectly
619      (thanks moysevichØgmail*com)
620    * Bugfix: FLV GETID3_FLV_TAG_META parsed incorrectly
621      (thanks moysevichØgmail*com)
622    * Bugfix: Quicktime: 'tkhd' matrix_v and matrix_d were switched
623      (thanks rjjmoroØhotmail*com)
624    * Bugfix: Quicktime: frame_rate was often incorrect for MP4 video
625    * Bugfix: getid3_lib::CastAsInt returned -2147483648 when passed
626      2147483648 (0x80000000)
6291.7.8b2: [2007-10-15] James Heinrich, Allan Hansen
630    * Video bitrate now calculated even if not explicitly stated in
631      file metadata, but if overall and audio bitrates are known
632    * Bugfix: 'comments_html' missing last letter in id3v2 tags.
633    * Bugfix: module objects (e.g. getid3_riff) that are instantiated
634      in other modules are explicitly disposed once no longer needed.
635    * Bugfix: some AVI files were not returning audio information
636      because "strh" chunk was not being read in
637    * Bugfix: asf [audio][<streamnumber>][dataformat] should be set
638      to "wma" but wasn't
639    * Bugfix: [mpeg][audio][bitrate_mode] should always be one of
640      ("cbr", "vbr", "abr") but wasn't for some values in
641      LAMEvbrMethodLookup()
642    * Bugfix: MP3 audio in AVI files could show "cbr" instead of
643      correct audio bitrate_mode, and audio bitrate could be slightly
644      incorrect if multiple files were scanned in a loop (scanning
645      single files produced correct values).
646    * Bugfix: remove [audio/video][bitrate] key if falsely set to zero
647    * Bugfix: PlaytimeString returned non-matching value for negative
648      playtimes (which shouldn't happen either, but now they're at
649      least shown correctly, if they happen due to other bugs)
650    * Bugfix: Several ASF header values are invalid if the broadcast
651      flag is set, getID3() now calculates these values in other
652      ways if the broadcast flag is set  (thanks fletchØpobox*com)
653    * Bugfix: lyrics3-flags-lyrics field was always false, and there
654      never was a lyrics3-flags-timestamp field present even though
655      the lyrics3-raw-IND field consisted of "10" (lyrics present,
656      timestamp not present).  (thanks i*f*schulzØweb*de)
657    * Bugfix: TAR.GZ files produce PHP errors when
658      option_gzip_parse_contents == true in module.archive.gzip.php
659      (thanks alan*harderØsun*com)
6621.7.8b1: [2007-01-08] Allan Hansen
663    » Major update to readme.txt
664    » PHP 4.2.0 required
665    » Tagwriter requires metaflac 1.1.1+ in order to write FLAC tags.
666    » Removed broken and non-fixable tagwriting module for real format.
667    ! Developers please help fix the above module:
668      https://www.getid3.org/phpBB3/viewtopic.php?t=677
669    » Avoided security issues with demo.browse.php, demo.write.php and
670      demo.mysql.php. These demos are now disabled by default and has
671      to be enabled in the source.
672    * Bugfix: id3v2 genre broken since 1.7.7.
673    » Added DTS module (module.audio.dts.php)
674    ¤ ASF/WMV files now return largest video stream dimensions in
675      [video][resolution_x] and [video][resolution_y]
676    * Bugfix: Minor issues with midi module (avoid PHP_NOTICE).
677    * Bugfix: Minor issues with lyrics3 (avoid PHP_NOTICE).
678    * Bugfix: PHP_NOTICE issues in MultiByteCharString2HTML()
679    * Bugfix: PHP_NOTICE issue  in BigEndian2Float()
680    * Bugfix: fread() zero bytes issue in real module.
681    * Bugfix: ASF module returned mime type video/x-ms-wma instead of
682      video/x-ms-wmv for certain FourCCs.
683    * Bugfix: PHP_NOTICE issues with broken ID3v2 tag/garbage.
684    * Bugfix: PNG module broken in regards to gIFg and gIFx chunks.
685    » Removed detection of short filenames 8dot3 under windows, as
686      it only worked for English versions of windows and has other
687      problems.
688    * Bugfix: Some CBR MP3 files detected as VBR with plenty of warnings.
689    * Bugfix: PHP_NOTICE issues in MP3 module.
690    * Bugfix: Quicktime returned incorrect frame rate.
691    * Bugfix: DivByZero on zero length FLV files.
692    * Bugfix: PHP_NOTICE one some FLV files.
693    * Bugfix: ID3v2 UTF-8/16 encoded frames terminated by \x00
694    * Bugfix: ID3v2 LINK frames iconv error.
695    * Bugfix: ID3v2 padding length calculated incorrectly.
696    * Bugfix: ID3v2.3 extended headers non-conformance
697    » SVG file detection.
698    » Added SVG user module (user_modules/module.graphic.svg.php).
699      Thanks to Roan Horning.
700    » PAR2 file detection (no parsing)
701    * Bugfix: Wave files being detected as MP3.
702    * Bugfix: ASF padding offset bug.
703    * Bugfix: Shorten module not working for wav files with fmt
704      chunks <> 16 bytes.
705    ¤ RIFF: Zero sized chunk invokes warning instead of error.
706    ¤ FLAC: Removed some ['raw'] keys.
707    ¤ MPC: Mime type returned: audio/x-musepack
7091.7.7: [2006-06-25] Allan Hansen
710    * Bugfix: AAC static bitrate cache wrong result when parsing
711      several files.
712    * Bugfix: Do not return NULL video bitrate for ASF v3.
713    * Bugfix: getid3_lib::GetImageSize() broken => JPG module broken.
714    * Bugfix: Encoder options should now be returned with correct
715      "--alt-preset n" /  "--alt-preset cbr n" when scanning more files.
716    * Bugfix: Shorten module not escapeshellarg() filenames (UNIX only).
717    * Bugfix: Filenames not escapeshellarg() for md5_data and
718      sha1_data (UNIX only).
719    * Bugfix: UNIX: head and tail called with -cNNN instead of "-c NNN".
720    » Added detection support for PDF and MS Office documents
721      (*.doc, *.xls, *.pps, etc)  (thanks zeromassmediaØgmail*com)
722    ¤ Bugfix: ID3v2 "TDRC" frame now used as "year" in comments if TYER
723      unavailable (TYER is deprecated in ID3v2.4)
724      (thanks matthiasØpanczyk*org)
725    ¤ Removed GETID3_OS_DIRSLASH, replaced with DIRECTORY_SEPARATOR
726    * Bugfix: added LAME preset guessing for presets 410,420,440,490
727      (thanks adminØlogbud*com)
728    * Bugfix: Added escapeshellarg() call in getid3_lib::hash_data
729      (thanks towbØgmx*net)
730    » TAR module no longer reads entire file into memory
731    » FLV module no longer reads entire file into memory
732    * Bugfix: added LAME preset guessing for presets 410,420,440,490
733      (thanks adminØlogbud*com)
734    * Bugfix: Added escapeshellarg() call in getid3_lib::hash_data
735      (thanks towbØgmx*net)
736    * Bugfix: Error message when padding in FLAC files were used up.
737    * Bugfix: Shorten module not working under windows.
738    ¤ Bugfix: gmmktime() instead of mktime().
739    ¤ Using gmmktime() instead of mktime() in ISO, ZIP, PNG and RIFF
740      modules to avoid E_STRICT notices with PHP5.1+.
741    * Bugfix: ['comments_html'] and ['comments'] contains different
742      value when having multiple tags (one of them ID3v1) and the
743      long field names.
7451.7.6: [2006-03-12] James Heinrich
746    * Rewrote getid3_lib::GetDataImageSize() to use GetImageSize()
747      instead of using code by filØrezox*com
748    * Bugfix: incorrect dimensions from disabled Quicktime tracks
749      (thanks m-1Øgmx*net)
750    * Bugfix: ['codec'] key warning in module.audio-video.asf.php
751      (thanks niel*archerØblueyonder*co*uk)
752    * Bugfix: undefined array in write.php
753      (thanks drewishØkatherinehouse*com)
754    * Bugfix: DeleteAPEtag() incorrectly failing when no tag present
755      (thanks drewishØkatherinehouse*com)
756    * Bugfix: ID3v2 writing frames with URL fields failing when URL
757      is not in ISO-8859-1  (thanks drewishØkatherinehouse*com)
758    * Bugfix: PHP notices on bad ID3v2 frames
759      (thanks cw264701Øohiou*edu)
760    * Bugfix: audio & video bitrates sometimes wrong in ASF files
761      (thanks kris_kauperØexcite*com)
7631.7.5: [2005-12-29] James Heinrich
764    » Added FLV (FLash Video) support -- new file:
765      module.audio-video.flv.php
766      (thanks Seth Kaufman <seth@whirl-i-gig.com> for code)
767    » Real tags can now be written (previous Real tag writing
768      code was not supposed to be in public releases, as it
769      was not complete)
770    » GETID3_HELPERAPPSDIR now autodetected under Windows
771    ¤ ASF lyrics now returned under [comments][lyrics]
772    * Bugfix: removed "--lowpass xxxxx" info from guessed
773      LAME presets when source frequency <= 32kHz
774    * Bugfix: ID3v2 extended header errors
775    * Bugfix: missing ob_end_clean() in write.id3v2.php
776      (thanks rasherØgmail*com)
7781.7.4: [2005-05-04] James Heinrich
779    ¤ Added ['quicktime']['hinting'] key (boolean)
780      (thanks jonØwebignition*net)
781    * Bugfix: major UTF-8 to UTF-16/ISO-8859-1 conversion
782      bug (empty string returned) when using iconv_fallback
783      (thanks chrisØfmgp*com)
784    * Bugfix: Missing 'lossless' key in RIFF-WAV
785      (thanks bobbfwedØcomcast*net)
7871.7.3: [2005-04-22] James Heinrich
788    » Added TAR support -- new file: module.archive.tar.php
789      (thanks Mike Mozolin <teddybearØmail*ru> for code!)
790    » Added GZIP support -- new file: module.archive.gzip.php
791      (thanks Mike Mozolin <teddybearØmail*ru> for code!)
792    * Bugfix: demo.browse.php now displays embedded images
793      internally instead of passing local filename as IMG
794      SRC (should allow demo.browse.php to correctly show
795      embedded images over a network)
796      (thanks patpowermanØhotmail*com)
797    * Bugfix: minor UTF-8 display issues in demo.browse.php
798    * Bugfix: demo.browse.php now works even if the evil
799      setting magic_quotes_gpc is turned on
800      (thanks patpowermanØhotmail*com)
801    * Bugfix: incorrect MIDI playtime for some files
802      (thanks joelØoneporpoise*com)
803    * Bugfix: 'url_source' typo in module.tag.id3v2.php
804      (thanks richardlynchØusers*sourceforge*net)
805    * Bugfix: Quicktime 'mvhd' matrix values were wrong
806      (thanks webØbobbymac*net)
807    ¤ ID3v2 now returns xx/yy for ['track'] (if
808      available), with xx in ['tracknum'] and yy in
809      ['totaltracks']. Previously ['tracknum'] was not
810      available and ['track'] had only xx.
811    Bugfixes and improvements to /demo/demo.mysql.php:
812      - remix/version parsed from tags and stored in
813        database, can be used when renaming files
814      - track number can be used for renaming files
8171.7.2: [2004-10-18] Allan Hansen
818    » Added support for WavPack v4.0+
819      (thanks ahØartemis*dk)
820    » Removed code for parsing EXE files
821      (thanks ahØartemis*dk)
822      Removed file: module.misc.exe.php
823    * Bugfix: Large ID3v2 tags inside ASF not parsed
824      properly under PHP5.
825    * Bugfix: Certain Wavpack3 files failed under PHP5 due
826      to new undocumented tmpfile() limit (same problem as
827      above).
828    * Bugfix: New iTunes crashes PHP - temp fix - no tags
829      on those files.
830    * Bugfix: ['nsv']['NSVs']['framerate_index'] might be
831      wrong  (thanks ahØartemis*dk)
832    * Bugfix: transparent color was wrong from truecolor
833      PNG  (thanks ahØartemis*dk)
834    * Bugfix: Changed MPC SV7 header size from 30 to 28,
835      this will change hash values for MPC files
836      (thanks ahØartemis*dk)
837    * Bugfix: Changed MPC SV4-6 header size from 28 to 8,
838      this will change hash values for MPC files
839      (thanks ahØartemis*dk)
840    ¤ Trim/unset wavpack encoder_options to match 2.0.0b2
841      output.
842    ¤ Commented-out unknown/unused values in NSV and ISO
843      modules  (thanks ahØartemis*dk)
8461.7.1b1: [July-26-2004] James Heinrich
847    » Added support for Apple Lossless Audio Codec
848    » Added support for RealAudio Lossless
849    » Added support for TTA v3
850    » Added support for TIFF
851      New file: /getid3/module.graphic.tiff.php
852    » Modified iconv_fallback to work with UTF-8, UTF-16, UTF-16LE,
853      UTF-16BE and ISO-8859-1 even if iconv() and/or XML support is
854      not available. This means that iconv() is no longer required
855      for most users of getID3()
856      (thanks Jeremia, khleeØbitpass*com)
857    » Added support for Monkey's Audio v3.98+ (thanks ahØartemis*dk)
858    » Included new demo showing most-basic getID3() usage
859      New file: /demos/demo.basic.php
860    * Bugfix: LAME3.94+ presets cached incorrectly if multiple files
861      are scanned in one batch and first file is LAME3.93 or earlier
862      (thanks enoyandØyahoo*com)
863    * Bugfix: Added warning if compressed ID3v2 frame decompression
864      fails. (thanks Mike Billings)
865    * Bugfix: Assorted small fixes to ensure compatability with PHP5
866    * Bugfix: ID3v1 genre "Blues" could not be written
867      (thanks Jeremia)
868    * Bugfix: ['bitrate_mode'] typo in module.audio-video.real.php
869      (thanks asukakenjiØusers*sourceforge*net)
870    * Bugfix: ['zip']['files'] is now populated with filenames even
871      if End Of Central Directory couldn't be parsed
872    * Bugfix: ['audio']['lossless'] was incorrect for FLAC
873      (thanks WaldoMonster)
874    * Bugfix: MD5 File was incorrect in directory browse mode for
875      /demo/getid3.browse.php
876    * Bugfix: PHP v5 compatability changes (float array keys, fread()
877      calls with zero data length)
878      (thanks getid3Øjsc*pp*ru)
879    * Bugfix: was dying if on compressed ID3v2 frames if
880      gzuncompress() function was unavailable
881    * Bugfix: ['vqf']['COMM'] was always empty
882    * Bugfix: MIDI playtime was missing for single-track MIDI files
883    * Bugfix: removed &#0; characters from ['comments_html']
884      (thanks p*quaedackersØplanet*nl)
885    * Bugfix: improved MIDI playtime accuracy
886      (thanks joelØoneporpoise*com)
887    * Bugfix: BMP subtypes 4 and 5 were not being identified
888    * Bugfix: frame_rate in AVI was incorrectly truncated to integer
889    * Bugfix: FLAC cuesheet track index was incorrect
890      (thanks tetsuo*yokozukaØoperamail*com)
891    ¤ ['quicktime']['display_scale'] now contains the playback scale
892      multiplier for QuickTime movies - a movie set to playback at
893      double-size will have "2" here. Other values are "1" and "0.5"
894    ¤ Added LAME preset guessing for --preset medium with v3.90.3
895      (thanks phwipØfish*co*uk)
896    ¤ Added $encoding_id3v1 to allow for ID3v1 encodings other than
897      the standard ISO-8859-1
898    ¤ Default AVI video bitrate_mode is now 'vbr'
899      (thanks eltoderØpisem*net)
900    Force getID3() to abort if Shorten files have ID3 or APE tags
901      (thanks ahØartemis*dk)
902    Editable textbox for parent directory in demo.browse.php
903      (thanks eltoderØpisem*net)
9061.7.0-hotfix [2004-03-17] Allan Hansen
907    (hotfix version released by Allan Hansen)
908    * Bugfix: PHP 4.1.x compatiblity - fgets($fp) => fgets($fp, 1024)
909    * Bugfix: Added default charset to TextEncodingNameLookup() in
910      module.tag.id3v2.php
911    Ø Removed option_no_iconv
912      iconv() support is only a requirement for WMA/WMW/ASF, and for
913      destination encodings other than ISO-8859-1 and UTF-8, iconv is
914      not needed otherwise. New 'iconv_req' in GetFileFormatArray()
915      only set for WMA/WMV/ASF. analyze() now refuses to analyse
916      WMA/ASF file if iconv is not present.
917    iconv_fallback() only dies on internal errors not missing iconv()
9201.7.0: [January-19-2004] James Heinrich
921    » Added support for RIFF/CDXA files (MPEG video in RIFF container
922      format (thanks chrisØdigitekdesign*com)
923    » Added support for TTA v2  (thanks ahØartemis*dk)
924    ¤ ID3v2 unsynchronisation scheme disabled by default because most
925      tag-reading programs cannot read unsynchronised tags. Can be
926      overridden by setting id3v2_use_unsynchronisation to true.
927      (thanks mikeØdelusion*org)
928    ¤ extention.*.php renamed to extension.*.php
929      (thanks tp62Øcornell*edu)
930    ¤ /demo/demo.check.php renamed to /demo/demo.browse.php
931    ¤ Added id3v2_paddedlength configuration parameter to WriteTags()
932      and renamed tag_language to id3v2_tag_language
933    ¤ MPEG audio layers are now represented as 1, 2 or 3 instead of
934      'I', 'II', or 'III'
935    ¤ Added [audio][wformattag] and [video][fourcc] for WAV and AVI
936    ¤ Added [audio][streams] which contains one entry for each audio
937      stream present in the file (usually only one). The data is a
938      copy of what is usually found in [audio]. If there are multiple
939      audio streams then [audio] will contain a sum of the bitrates
940      of all audio streams, and the data format of the first stream
941      (if streams are of different data types)
942    ¤ Added BruteForce mode to mp3 scanning. Disabled by default as
943      it is extremely slow and only files that are broken enough to
944      not really play will gain any benefit from this.
945    ¤ Suppress '--resample xxxxx' appended to encoder options for mp3
946      with low-quality presets for default sampling frequencies
947    ¤ Enhanced LAME preset guessing for pre-3.93 with a better lookup
948      table, --resample/--lowpass guessing (thanks phwipØfish*co*uk)
949    ¤ RIFF files with non-MP3 contents no longer have
950      [audio][encoder_options] set
951    ¤ Added [audio][encoder_options] to audio formats where possible
952      (including LiteWave, LPAC, OptimFROG, TTA)
953    ¤ Moved [quantization] and [max_prediction_order] from
954      [lpac][flags] to just [lpac]
955    ¤ WavPack flags are now parsed into [wavpack][flags]
956    * Bugfix: APEtags with ReplayGain information stored with comma-
957      seperated decimal values (ie "0,95" instead of "0.95") were
958      giving wrong peak and gain values
959    * Bugfix: Filesize > 2GB not always detected correctly
960    * Bugfix: Some ID3v2 frames had data key unset incorrectly
961      (thanks chrisØdigitekdesign*com)
962    * Bugfix: Warnings on empty-strings-only comments
963    * Bugfix: ID3v2 tag writing may have had incorrect padding length
964      if padded length less than current ID3v2 tag length and
965      merge_existing_data is false  (thanks mikeØdelusion*org)
966    * Bugfix: hash_data() for SHA1 was broken under Windows
967    * Bugfix: BigEndian2Float()/LittleEndian2Float() were broken
968    * Bugfix: LAME header calculated track peaks were incorrect for
969      LAME3.94a15 and earlier
970    * Bugfix: AVIs with VBR MP3 audio data reported incorrect bitrate
971      and bitrate_mode
972    * Bugfix: AVIs sometimes had incorrect or missing video and total
973      bitrates
974    * Bugifx: AVIs sometimes had incorrect ['avdataend'] and
975      therefore also incorrect data hashes (md5_data, sha1_data)
976    * Bugfix: ID3v1 genreid no longer returned for Unknown genre
977    * Bugfix: ID3v1 SCMPX genres were broken
978    Modified LAME header parsing to correctly process peak track
979      value for LAME3.94a16+ (thanks Gabriel)
980    md5_file() and sha1_file() now work under Windows in PHP < 4.2.0
981      and 4.3.0 respectively with helper apps
982    Default md5_data() tempfile location is now system temp directory
983      instead of same directory as file (thanks towbØtiscali*de)
984    Improved list of RIFF ['INFO'] comment key translations
985    More helpful error message when GETID3_HELPERAPPSDIR has spaces
986    /demo/demo.browse.php now autogets both MD5 and SHA1 hashes for
987      files < 50MB
988    Replaced PHP_OS comparisons with GETID3_OS_ISWINDOWS define
989      (thanks necroticØusers*sourceforge*net)
9921.7.0b5: [December-29-2003] James Heinrich
993    » Windows only: Various binary files are now required for some
994      file formats, especially for tag writing, as well as md5sum
995      (and other) calculations. These binaries are now stored in the
996      directory defined as GETID3_HELPERAPPSDIR in getid3.php
997      (default is /helperapps/ parallel to /getid3/).
998      Note: This directory must not have any spaces in the pathname.
999      All neccesary files are available as a seperate download.
1000      See /helperapps/readme.txt for more information
1001      New file: /helperapps/readme.txt
1002    » Unified tag-writing interface for all tag formats
1003      New file: /getid3/write.php
1004                /getid3/write.apetag.php
1005                /getid3/write.id3v1.php
1006                /getid3/write.id3v2.php
1007                /getid3/write.lyrics3.php
1008                /getid3/write.metaflac.php
1009                /getid3/write.vorbiscomment.php
1010    » Added support for Shorten - requires shorten binary (head.exe
1011      is also required under Windows).
1012      New file: /getid3/module.audio.shorten.php
1013    » Added support for RKAU
1014      New file: /getid3/module.audio.rkau.php
1015    » Added (minimal) support for SZIP
1016      New file: /getid3/module.archive.szip.php
1017    » Added MySQL caching extention  (thanks ahØartemis*dk)
1018      New file: /getid3/extention.cache.mysql.php
1019    » Added DBM caching extention  (thanks ahØartemis*dk)
1020      New file: /getid3/extention.cache.dbm.php
1021    » Added sha1_data hash option  (thanks ahØartemis*dk)
1022    » Added option to allow getID3() to skip ID3v2 without parsing it
1023      for faster scanning when ID3v2 data is not required. If you
1024      want to enable this feature delete /getid3/module.tag.id3v2.php
1025      (thanks ahØartemis*dk)
1026    ¤ 8-bit WAV data now calculates MD5 checksums as normal, not
1027      converting to signed data as before, so stored md5_data_source
1028      in FLAC files will no longer match md5_data for the equivalent
1029      decoded 8-bit WAV. A warning will be generated for 8-bit FLAC
1030      files
1031    ¤ Added option_no_iconv option to allow getID3() to work
1032      partially without iconv() support enabled in PHP
1033      (thanks ahØartemis*dk)
1034    ¤ All '*_ascii' keys removed for ASF/WMA/WMV files
1035    ¤ All 'ascii*' keys removed for ID3v2 tags
1036    ¤ Ogg filetypes now return MIME of "application/ogg" instead of
1037      the previous "application/x-ogg"
1038      (thanks blakewattersØusers*sourceforge*net)
1039    ¤ Force contents of ['id3v2']['comments'] to UTF-8 format from
1040      whatever encoding each frame may have (text encoding can vary
1041      from frame to frame in ID3v2)
1042    ¤ MP3Gain information from APE tags suppressed from ['tags'] and
1043      parsed into ['replay_gain']
1044    ¤ ReplayGain information (all formats) changed from "Radio" and
1045      "Audiophile" to "Track" and "Album" respectively
1046    ¤ ['volume'] and ['max_noclip_gain'] are now available in both
1047      ['replay_gain']['track'] and ['replay_gain']['album'] for all
1048      formats that calculate ReplayGain.
1049    ¤ ['video']['total_frames'] is available for AVIs
1050    ¤ All parsed ID3v2 frame data is now in ['id3v2'][XXXX][#]
1051      (previously some frame types would have numeric array keys if
1052      multiple instances of that frame type were allowed and other
1053      frame types would not)
1054    ¤ ASF/WMA "WM/Picture" images are now parsed in the same manner
1055      as ID3v2 with the image (ex JPEG) data returned in [data]
1056      rather than [value]
1057    * Bugfix: Optional tag processing options were being ignored (ie
1058      ID3v1 still processed even if option_tag_id3v1 == false)
1059      (thanks ahØartemis*dk)
1060    * Bugfix: fixed MultiByteCharString2HTML() for UTF-8
1061    * Bugfix: Quicktime files not always reporting video frame_rate
1062    * Bugfix: False ID3v1 synch patterns in APE or Lyrics3 tags are
1063      now detected and incorrect ID3v1 data not returned
1064      (thanks sebastian_maresØusers*sourceforge*net for the idea)
1065    * Bugfix: WMA9 Lossless now reported as lossless
1066    * Bugfix: two typos in ID3v1 genre list
1067    * Bugfix: MPEG-2/2.5 ABR/VBR MP3 files had doubled playtime
1068    * Bugfix: MPEG-2/2.5 LayerII (ie MP2: 24/22.05/16kHz) files were
1069      not detected due to incorrect frame length calculation
1070    * Bugfix: MPEG LayerI files were not detected due to incorrect
1071      frame length calculation (must be multiple of slot length)
1072    Added alternative md5_data via system call - twice as fast. Needs
1073      "getID3()-WindowsSupport" to work under Windows.
1074      (thanks ahØartemis*dk)
1075    ID3v2.4 compressed frames are now supported
1076    php_uname() calls changed to use PHP_OS constant
1077    Added SCMPX extensions to ID3v1 genres (0xF0-0xFE)
1078    Obfuscated contributor email address in changelog and sourcecode
1079    Added memory-saving EmbeddedLookup() function for lookup tables
1080      in RIFF and ID3v2 modules (thanks ahØartemis*dk)
1081    Major memory patches to many modules by using
1082      $var = &$INFO_ARRAY_AT_SOME_INDEX
1083      in place of large multi-dimensional array declarations.
1084      Memory saved:  RIFF: ~200kB;  ID3v2: ~475kB;  ASF: ~50kB  etc.
1085      (thanks ahØartemis*dk)
10881.7.0b4: [November-19-2003] James Heinrich
1089   » Support added for MPC files with old SV4-SV6 structure
1090   » RealVideo now properly supported with resolution, framerate, etc
1091     (thanks jcsston)
1092   » RealAudio files with old-style file format (v2-v4) are now
1093     fully supported
1094   » Support added for DolbyDigital WAV files (thanks ahØartemis*dk)
1095   ¤ ['RIFF'] is now ['riff'] to conform to make all root key names
1096     lowercase
1097   ¤ ['OFR'] is now ['ofr'] to conform to make all root key names
1098     lowercase
1099   ¤ ['tags_html'] is now available as a copy of ['tags'] but
1100     with all text replaced with an HTML version of all characters
1101     above chr(127), translated according to whatever the encoding
1102     of the source tag is, in the HTML form &#1234;
1103   ¤ CopyTagsToComments() is now available in getid3_lib
1104   ¤ QuicktimeVR files now return a ['video']['dataformat'] of
1105     'quicktimevr' instead of 'quicktime' (thanks gtsØtsu*biz)
1106   ¤ Quicktime video files with DivX, Xvid, 3ivx or MPEG4 video
1107     streams now return those names as ['video']['dataformat']
1108   ¤ MPEG video files are now identified with ['video']['codec'] set
1109     to either 'MPEG-1' or 'MPEG-2' (rather than just 'MPEG'). If you
1110     see a file wrongly identified, please report it!
1111     (thanks fccHandler)
1112   ¤ All bitrate values in ['mpeg']['audio'] is now reported in bps
1113     rather than kbps (ie 128000 instead of 128) for consistancy
1114   ¤ AVIs with MP2 audio now report ['audio']['dataformat'] as 'mp2'
1115     rather than 'wav'  (thanks metalbrainØnetian*com)
1116   ¤ Added ['md5_data_source'] for OptimFROG
1117   ¤ AC3 in RIFF-WAV now identified with ['audio']['dataformat']
1118     returning 'ac3'
1119   ¤ WavPack ['extra_bc'] now returned as integer
1120   ¤ WavPack ['extras'] now returned as 3-element array of integers
1121   ¤ MP3 ['audio']['encoder options'] now returns 'VBR' or 'CBR' only
1122     (no bitrate) if no LAME preset is used, or 'VBR q??' where ?? is
1123     a number 0-100 for Fraunhofer-encoded VBR MP3s
1124   * Bugfix: VBR MP3s could have incorrect bitrate reported
1125   * Bugfix: Quicktime files with MP4 audio were not returning
1126     ['video']['dataformat'] (thanks robØmassive-interactive*nl)
1127   * Bugfix: strpad vs str_pad typo in module.riff.php
1128     (thanks nicojunØusers*sourceforge*net)
1129   * Bugfix: ReplayGain information was often wrong for MPC files
1130   * Bugfix: MD5 and other post-TAIL chunks were not being processed
1131     in module.audio.optimfrog.php
1132   * Bugfix: Undefined variable in table_var_dump() in demo/check.php
1133   * Bugfix: QuickTime files now only return information in [audio]
1134     or [video] if those exist in the file
1135   * Bugfix: WavPack no longer tries to read entire compressed data
1136     chunk
1137   * Bugfix: Properly handle VBR MP3s with "Info" (rather than
1138     "Xing") header frame. foobar2000 adds this to MP3 files when
1139     "Fix MP3 Header" function is used (thanks ahØartemis*dk)
1140   * Bugfix: Fraunhofer VBRI headers for MP3s were assuming 2-byte
1141     entries for TOC rather than using stride, and were ignoring the
1142     scaling value. (thanks sebastianØmaresweb*net)
1143   Several QuickTime atoms have been added to an exclusion list
1144     because they have been observed, but I have no idea what they
1145     are supposed to do so I can't add real support for them, but
1146     they should not generate warnings (robØmassive-interactive*nl)
1147   Old MPC encoder (before v1.06) was return as v0.00, now returned
1148     as 'Buschmann v1.7.0-v1.7.9 or Klemm v0.90-v1.05'
1149     (thanks ahØartemis*dk)
1150   Added check for magic_quotes_runtime and code to disable it if
1151     neccesary (thanks stefan*kischkelØt-online*de)
1152   Added 3ivx fourCCs to module.audio-video.quicktime.php
1153   MP3 and AC3 streams are now parsed when contained inside RIFF-WAV
1154     or RIFF-AVI container formats
1155   Better detection of named presets in LAME 3.93/3.94
11581.7.0b3: [October-17-2003] James Heinrich
1159   » AC-3 (aka Dolby Digital) is now supported.
1160     New file: /getid3/module.audio.ac3.php
1161   * Bugfix: ID3v2-writing function Unsynchronise() was broken, which
1162     made ID3v2 tag containing binary data (typically pictures) get
1163     corrupted. (thanks t*coombesØbendigo*vic*gov*au,
1164     i*kuehlbornØndh*net, mikeØdelusion*org, mikeØftl*com)
1165   * Bugfix: Zip comments now returned as array instead of string,
1166     as they're supposed to be.
1167   * Bugfix: Quicktime/MP4 files may have reported extremely low
1168     bitrates (thanks spunkØdasspunk*com)
1169   Improved double-ID3v1 check to prevent false detection when string
1170     "TAG" is present in APE or Lyrics3
1171   Fixed /demo/simple.php
1172   Fixed /demo/joinmp3.php
1173   Fixed /demo/mimeonly.php
1174   Fixed /demo/write.php
11771.7.0b2: [October-15-2003] James Heinrich
1178   » TTA Lossless Audio Compressor format now supported.
1179     (http://tta.iszf.irk.ru)
1180     New file: /getid3/module.graphic.tta.php
1181   » PhotoCD (PCD) format now supported. Image data for the three
1182     lowest resolutions (192x128, 384x256, 768x512) can be optionally
1183     extracted.
1184     New file: /getid3/module.graphic.pcd.php
1185   ¤ RIFF-MP3 files now should return the same ['md5_data'] as the
1186     identical MP3 file outside the RIFF container
1187   ¤ Name of LAME preset used (if available, needs LAME v3.90+)
1188     returned in ['mpeg']['audio']['LAME']['preset_used'] and also as
1189     part of ['audio']['encoder_options']
1190   ¤ VQF module now sets ['audio']['encoder_options'] to i.e. CBR96
1191   ¤ MP3 module now sets ['audio']['encoder_options'] on CBR files
1192     and all LAME-encoded files
1193   ¤ MPC module now sets ['audio']['encoder_options']
1194   ¤ Monkey module now sets ['audio']['encoder_options']
1195   ¤ AAC module now sets ['audio']['encoder_options'] to profile name
1196   ¤ ASF module now sets ['audio']['encoder_options']
1197   ¤ Ogg module adds ['audio']['encoder_options'] -b 128 on
1198     Ogg Vorbis 1.0+ ABR files
1199   ¤ Ogg module adds ['audio']['encoder_options'] -q N   on
1200     Ogg Vorbis 1.0+ VBR files 44k/48k sample rate/stereo files only.
1201   ¤ Ogg module ['audio']['encoder_options'] "Nominal birate: 80k" to
1202     other Ogg Vorbis files.
1203   ¤ ID3v2 track number now returned as string (with leading zeros,
1204     if present in data) rather than integer (thanks Plamen)
1205   ¤ ASF module returns ['asf']['comments']['encoding_time_unix'] if
1206     available (from WM/EncodingTime)
1207   ¤ Fixed /demo/mysql.php and added some new features:
1208     - encoder options
1209     - ID3v2 "Encoded By"
1210     - non-empty comments
1211     - total entries in database summary (totals & averages)
1212     - database version update
1213   * Bugfix: 'UNICODE' iconv() charset changed to 'UTF-16LE' or
1214     'UTF-16BE' as appropriate
1215   * Bugfix: iconv_fallback() function created in case iconv() fails
1216   * Bugfix: fixed MD5 calls in demo/check.php
1217   * Bugfix: reenabled detection of APE + Lyrics3 tags in same file
1218   * Bugfix: ASF module now returns ID3v1 genre as string instead of
1219     number - patch from Eugene Toder.
1220   * Bugfix: ASF module now reads non-standard field names,
1221     i.e. "date" as well as WM/Year - patch from Eugene Toder.
1222   * Bugfix: ASF module now returns genre as-is if it is not a
1223     standard ID3v1 genre (thanks wonderboy)
1224   * Bugfix: Eliminated false-synch problem in MP3 module
1225   * Bugfix: Fixed missing root ['bitrate'] for most formats
1226   * Bugfix: ['audio']['compression_ration'] missing for MPC
1227     (thanks WaldoMonster)
1228   * Bugfix: NSV module died in 1.7.0b1
1229   * Bugfix: ASF module died in 1.7.0b1 when WM/Picture preset
1230   * Bugfix: ASF tracknumber incorrect when specified by WM/Track
1231     rather than WM/TrackNumber (thanks jgriffiniiiØhotmail*com)
1232   * Bugfix: MPEG audio+video playtime should now be pretty accurate
1233     (ie within 0.1% variation at most)
1234     (thanks mgrimmØhealthtvchannel*org)
1235   * Bugfix: ID3v2 not being copied to ['tags'] in some cases
1236   * Bugfix: LAME CBR files with Info tag were being incorrectly
1237     flagged as VBR (thanks Jojo)
1238   * Bugfix: LAME tag not being detected for LAME 3.90 (original)
1239   Changed regex pattern match for MP3 to include 3rd byte for more
1240     reliable/accurate pattern matching
1241   Added duplicate-ID3v1 tag checking (two ID3v1 tags, one after the
1242     other) that has been known to occur with iTunes
1243     (thanks towbØtiscali*de)
1244   Added instructions for enabling iconv() support under Windows
1245   Removed some unneccesary debugging code
1246   Suppressed duplicate PHP warnings for missing include files
1247   Included some missing dependencies in various files
1248   /demo/audioinfo.class.php now copies ['audio']['encoder_options']
12511.7.0b1: [2003-09-28] Allan Hansen
1252   This beta version was not made by James Heinrich. It was made by
1253   Allan Hansen <ahØartemis*dk> - please send bug reports on this
1254   beta directly to me.
1256   James Heinrich will release 1.7.0 final, but it may take some time
1257   to work out the bugs from the major rewrite.
1259   This version could be called getID3lite. It makes a lot of checks
1260   optional and makes it easy to remove support for undesired formats
1262   It also is more library-like. Older versions of getID3() declared
1263   an incredible amount of global scope functions and defined several
1264   constants. 1.7.0beta1 still declares constants, but they are all
1265   prepended by GETID3_. It declares no global scope functions - they
1266   are all wrapped into classes.
1268   » Made getID3() depend on iconv library: compile PHP --with-iconv
1269   » Created new directory structure
1270       Moved all demos to demos/
1271       Moved all getID3() files to getid3/
1272       Renamed most files to module.something
1273       Changed header in all module.something to explain what they do
1274       Simply remove all modules you don't need
1275       Wrapped all modules into classes
1276   * Bugfix: Implemented misc patches from Eugene Toder
1277   * Bugfix: Implemented misc patches from "six"
1278   ¤ Added root key 'encoding'
1279   ¤ Added prefix GETID3_ to all defined constants.
1280   ¤ Wrapped getid3.php into getid3 class
1281   ¤ Wrapped getid3.functions.php into getid3_lib class
1282       Removed unused functions
1283       Moved several functions away from getid3.functions.php and
1284         into the files where they are actually used.
1285       Renamed getid3.functions.php to getid3.lib.php
1286       Moved getid3.rgad.php functions into getid3_lib
1287       Moved getid3.getimagesize.php funcitons ingo getid3_lib
1288   ¤ Moved getid3.ogginfo.php into ogg module
1289   ¤ Combined GetTagOnly() and GetAllFileInfo() in method analyze
1290   ¤ Removed redundant and unuseful root keys
1291       'file_modified_time' == filemtime($filename)
1292       'md5_file' == md5_file($filename)
1293       'exist' == file_exists($filename)
1294   ¤ Changed root key ['tags'] from array of string to array of array
1295     of comments.
1296   Simplified code for detecting base path.
1297   Removed ob_ from InitializeFilepointerArray(). That was really a
1298     ugly HACK to get output from fopen. If user want the reason,
1299     he should open the file himself!
1300   Checking for APE tags before lyrics3 - makes Lyrics3 not depend
1301     on APE tag. It seems to work on my test file.
1302   Changed ['error'] and ['warning'] in multiple files to append to
1303     array instead of appending to string. That simplified code in
1304     getid3.php too.
1305   Simplified clean-up procedure: simply remove all empty root keys
1306   Setting tags in individual modules instead of main getid3.php
1307   Made Bonk and ASF modules non-dependent on id3 modules - id3
1308     optional.
1309   Rewrote HandleAllTags() - simplified and convert comments to
1310     desired encoding.
1311   Replaced all calls to RoughTranslateUnicodeToASCII() in ASF module
1312     with a TrimConvert() method. This uses iconv() for conversion.
1313     It also converts from UNICODE instead of UTF-16BE, as the spec
1314     says it should.
1315   Replaced all calls to RoughTranslateUnicodeToASCII() in id3v2
1316     module with iconv(). id3v2 module also reads
1317     $ThisFileInfo['encoding'] and converts all comments to this
1318     format. All other formats just add their comments in their
1319     native charset, but every comment field in id3v2 can have a
1320     different encoding, so this is needed.
1321   Did same thing as above with ISO module. However - it does not
1322     work. I need to find out how to specify big-endian unicode !=
1323     UNICODING encoding name given to iconv().
1324   Built-in assume mp3 format in getid3.php
1325   Temporarily nuked root key ['comments'] and CopyCommentsToRoot()
1326   Updated demo/audioinfo.class.php
1327   Updated demo/check.php - some thing don't work!
1328   Other demos are out of order!
13311.6.5: [October-06-2003] James Heinrich
1332   » Added support for LiteWave (thanks supportØclearjump*com)
1333   Ø Split out speedup info from ['OFR']['OFR']['compression'] into
1334     ['OFR']['OFR']['speedup']
1335   Ø If EXIF functions for JPEG not available, now warning not error
1336   Ø ID3v2 track number now returned as string (with leading zeros,
1337     if present in data) rather than integer (thanks Plamen)
1338   * Bugfix: now correctly parses cbSize element of WAVEFORMATEX
1339     structure (thanks supportØclearjump*com)
1340   * Bugfix: ASF module now reads non-standard field names,
1341     i.e. "date" as well as WM/Year - patch from Eugene Toder.
1342   * Bugfix: ASF module now returns genre as-is if it is not a
1343     standard ID3v1 genre (thanks wonderboy)
1344   * Bugfix: ['audio']['compression_ration'] missing for MPC
1345     (thanks WaldoMonster)
1346   Prevent infinite loop in MP3 histogram if framelength == 0
1347   Added wFormatTag values 0x00FF and 0x2001 - 0x2005
1348     (thanks steveØheadbands*com)
1349   Added "twos" and "sowt" FourCCs for Mac AIFC
13521.6.4: [June-30-2003] James Heinrich
1353   » Added support for free-format MP3s
1354     (thanks Sebastian Mares for the idea)
1355   » Compressed (Flash 6+) SWF files are now handled properly
1356     (thanks alan*cheungØalumni*ust*hk)
1357   » Added DeleteLyrics3() to getid3.lyrics3.php
1358   » Added FixID3v1Padding() to getid3.putid3.php
1359   » Added new simple MP3-splicing sample file
1360     (thanks tommybobØmailandnews*com for the idea)
1361     New file: getid3.demo.joinmp3.php
1362   » Moved all contents of getid3.putid3.php into either
1363     getid3.id3v1.php or getid3.id3v2.php or getid3.functions.php as
1364     appropriate
1365     Removed file: getid3.putid3.php
1366   ¤ ['error'] and ['warning'] keys now return as arrays, not strings
1367   ¤ New root key for all files: ['file_modified_time'] (UNIX time)
1368   ¤ getid3.demo.scandir.php renamed to getid3.demo.mysql.php
1369   ¤ New demo file returns the MIME type only for a single file
1370     (thanks adminØe-tones*co*uk for the idea)
1371     New file: getid3.demo.mimeonly.php
1372   ¤ Added check for valid ID3v1 padding (strings should be padded
1373     with null characters but some taggers incorrectly use spaces).
1374     A warning will be generated if padding is invalid. New boolean
1375     key ['id3v1']['padding_valid'] indicates padding validity.
1376   ¤ CleanUpGetAllMP3info() removes more useless root keys for
1377     unknown-format files
1378   ¤ Extended LAME information in ['mpeg']['audio']['LAME'] is now
1379     only returned for LAME v3.90+
1380   ¤ LAME-encoded MP3s now return
1381     ['mpeg']['audio']['LAME']['long_version'] as well as
1382     ['mpeg']['audio']['LAME']['short_version'] - these are identical
1383     in LAME v3.90+ but older versions will report longer more
1384     detailed version information if available
1385   ¤ New Lyrics3 values: ['lyrics3']['raw']['offset_start'] and
1386     ['lyrics3']['raw']['offset_end']
1387   ¤ New optional parameter on getAPEtagFilepointer() to scan from a
1388     defined offset rather than end-of-file to allow scanning of APE
1389     tags before Lyrics3 tags
1390   ¤ ['tag_offset_start'] and ['tag_offset_end'] are now present in
1391     ['ape'], ['lyrics3'], ['id3v1'] and ['id3v2']
1392   ¤ Numerous changes to the returned structure and content for La
1393     files, including parsing the seektable (if applicable) and
1394     parsing RIFF data occuring after the end of the compressed audio
1395     data (notably RIFF comments)
1396     (thanks mikeØbevin*de)
1397   ¤ getSWFHeaderFilepointer() now has optional 3rd parameter
1398     $ReturnAllTagData (default == false) which if set to true will
1399     return data on all tags in ['swf']['tags']
1400   ¤ ['swf']['bgcolor'] now returns the 6-character string
1401     representing the background color in HTML hex color format
1402     (thanks ubergeekØubergeek*tv)
1403   ¤ ['swf']['header']['frame_delay'] is no longer returned
1404   ¤ getQuicktimeHeaderFilepointer() now has two additional optional
1405     parameters: $ReturnAtomData (default == true) and
1406     $ParseAllPossibleAtoms (default == false). Setting
1407     $ReturnAtomData to false will reduce the size of the returned
1408     data array by unsetting ['quicktime']['moov'] before returning.
1409     Leaving $ParseAllPossibleAtoms as false now suppresses parsing
1410     of several atom types that contain very large tables of data
1411     that are not typically useful. Atom type suppressed are:
1412     stts, stss, stsc, stsz, and stco
1413     (thanks ubergeekØubergeek*tv)
1414   ¤ ['fileformat'] no longer set to 'id3' if ID3v1 or ID3v2 tag
1415     detected but no other data format recognized
1416   * Bugfix: La files now return the correct values for
1417     ['avdataoffset'] and ['avdataend'] and therefore the correct
1418     values for ['md5_data'] - note that ['md5_data'] values will not
1419     match values from previous versions of getID3() - the previous
1420     versions were incorrect
1421     (thanks mikeØbevin*de)
1422   * Bugfix: A temporary file was being created in the web server's
1423     root directory (not DocumentRoot) each time ['md5_data'] was
1424     calculated, and not removed due to lack of permissions. Temp
1425     file is now created (as it was supposed to be) in the directory
1426     of the file being examined, or the system temp directory, and
1427     properly removed when done.
1428   * Bugfix: Several incorrect values were being returned inside
1429     ['mpeg']['audio']['LAME'] (thanks bouvigneØmp3-tech*org)
1430   * Bugfix: SWF frame rates values were usually incorrect.
1431     (thanks alan.cheungØalumni*ust*hk and ubergeekØubergeek*tv)
1432   * Bugfix: ID3v2.2 files always flagged 4 bytes of invalid padding
1433     (thanks marcaØmac*com)
1434   * Bugfix: Lyrics3 without ID3v1 was not working properly
1435   * Bugfix: Lyrics3, APE & ID3v1 can all now exist in the same file.
1436     A warning is issued if APE comes after Lyrics3 (because Lyrics3-
1437     aware taggers probably are not APE-aware and therefore won't be
1438     able to find the Lyrics3 tag)  (thanks mp3gainØhotmail*com)
1439   * Bugfix: WriteAPEtag() now writes the APE tag before any Lyrics3
1440     tags (if present) and removes any incorrect ones that are after
1441     existing Lyrics3 tags  (thanks mp3gainØhotmail*com)
1442   * Bugfix: RIFF-WAVE file with incorrect NumberOfSamples values in
1443     the 'fact' chunk no longer cause incorrect playtime calculation
1444     (thanks stprasadØindusnetworks*com)
1445   * Bugfix: getid3.demo.simple.php had undefined variables if the
1446     file needed to be deep-scanned with assumeFormat
1447   * Bugfix: fixed previously-incorrect ['avdataend'] values for APE
1448     and Lyrics3 tags in some cases, which in some cases means that
1449     ['md5_data'] is different than previously (now correct)
1450   Much-improved detection of AAC-ADTS, which also means MP3
1451     format detection should now be nearly twice as fast
1452   Truncated AVIs and WAVs are now reported
1453   Number of new features and bugfixes in getid3.demo.mysql.php
1454   Quicktime 'meta' atoms now parsed, so Quicktime MP4 files can now
1455     return artist, title, album, etc  (thanks spunkØdasspunk*com)
1456   Consolidated all comments processing functions (processing the
1457     ['comments'] and ['tags'] keys) into HandleAllTags() which now
1458     also checks to ensure that APE tags are really better than ID3v2
1459     before using them in ['comments']
1460   Known issue with Meracl ID3 Tag Writer v1.3.4 truncating last byte
1461     of MP3 file when appending new ID3v1 tag now specifically noted
1462     (rather than generic Probably Truncated File message)
1463   getid3.demo.mysql.php now stores last-modified time for each file
1464   getid3.demo.mysql.php is now case-sensitive for filenames
1465   getid3.demo.mysql.php can generate M3U playlists of any of the
1466     groups of files it can select (duplicate filenames, tag types,
1467     etc.)
1468   getid3.demo.mysql.php can now find mismatched tag contents and
1469     filenames
1470   getid3.demo.check.php now shows total number of errors & warnings
1471   GetFileFormatArray() now matches actual patterns for MP3 files
1472     based on the first two bytes of the file, rather than just the
1473     first one
1474   Simplified DeleteAPEtag() and made it work properly with Lyrics3
14771.6.3: [May-17-2003] James Heinrich
1478   » Added support for Bonk  (thanks ahØartemis*dk)
1479     New file: getid3.bonk.php
1480   » Added support for AVR  (thanks ahØartemis*dk)
1481     New file: getid3.avr.php
1482   ¤ Contents of getid3.id3.php moved to getid3.id3v1.php
1483     Removed file: getid3.id3.php
1484   ¤ Contents of getid3.frames.php moved to getid3.id3v2.php
1485     Removed file: getid3.frames.php
1486   ¤ Returned data structure documentation improved and updated and
1487     now stored in getid3.structure.txt rather than getid3.readme.txt
1488     New file: getid3.structure.txt
1489   ¤ Now including the GNU General Public License in the distribution
1490     as getid3.license.txt
1491     New file: getid3.license.txt
1492   ¤ Added new, optional, parameter to WriteAPEtag() (and also
1493     GenerateAPEtag()) which must be set to TRUE if the values you
1494     are passing are already UTF8-encoded, otherwise all data is
1495     encoded to UTF8 by default. For all ASCII/ANSI data this value
1496     should be left at the defaul value of FALSE.
1497   ¤ Added third, optional, parameter to getID3v2Filepointer() -
1498     $StartingOffset (default == 0) which can parse an ID3v2 tag
1499     in a file at a position other than the start-of-file.
1500   ¤ ['video']['pixel_aspect_ratio'] now returned when known
1501   ¤ AVI files with WMA audio now return ['audio']['dataformat']
1502     of 'wma' rather than 'wav'
1503   ¤ ASF-WMA files now return the artist value from WM/AlbumArtist
1504     in ['comments']['artist']  (thanks msibbaldØsaebauld*com)
1505   ¤ ASF-WMA files now return the 'author' value from
1506     ['asf']['content_description'] in ['comments']['artist']
1507     instead of ['comments']['author']
1508   ¤ ASF-WMA files now return the 'description' value from
1509     ['asf']['content_description'] in ['comments']['comment']
1510     instead of ['comments']['description']
1511   * Bugfix: APE tag writing with multiple values for a tag (more
1512     than one ARTIST for example) was not being correctly written
1513     (thanks ahØartemis*dk)
1514   * Bugfix: CreateDeepArray() was returning an empty-string key as
1515     the top-level returned value - ['iso']['files'] now directly
1516     contains the file listing without an empty array in between.
1517   * Bugfix: ID3v2 genreid was not being returned in some cases.
1518   * Bugfix: APEv1 tags would generate error messages
1519   * Bugfix: APE tags would sometimes show phantom second entry for
1520     each item (title, artist, etc) with no data
1521   * Bugfix: APE tag writing was not UTF8-encoding the data -
1522     non-ASCII characters (above chr(127)) were being incorrectly
1523     stored  (thanks ahØartemis*dk)
1524   * Bugfix: getid3.demo.scandir.php had undefined function error
1525   * Bugfix: getid3.demo.scandir.php would not display list of files
1526     with no tags
1527   Added link to getid3.demo.check.php from list of specific-tags
1528     files in getid3.demo.scandir.php
15311.6.2: [May-04-2003] James Heinrich
1532   » New official mirror site for getID3() - https://www.getid3.org
1533   » Added basic support for SWF (Flash)  (thanks n8n8Øyahoo*com)
1534     New file: getid3.swf.php
1535   » Added experimental support for parsing the audio portion of
1536     MPEG-video files. I don't have any actual documentation for
1537     this, so this part is experimental and not guaranteed accurate,
1538     but it seems to be working OK as far as I have been able to test
1539     it. Bug reports (or even better - documentation!) are welcome at
1540     info@getid3.org
1541   » Added new simple directory-scanning sample file
1542     New file: getid3.demo.simple.php
1543   » getid3.demo.write.php now writes APE tags as well.
1544   ¤ Renamed getid3.write.php to getid3.demo.write.php
1545   ¤ Renamed audioinfo.class.php to getid3.demo.audioinfo.class.php
1546   ¤ getid3.php now automatically includes the getid3.functions.php
1547     function library file, no need to include it seperately.
1548   ¤ getLyrics3Filepointer() has been changed to be consistant with
1549     all the other similar function structures - the parameters have
1550     changed. The old function has been renamed to getLyrics3Data()
1551   ¤ Added DeleteAPEtag() function to getid3.ape.php
1552   ¤ HandleID3v1Tag() now only handles ID3v1. Lyrics3 processing is
1553     now done by HandleLyrics3Tag()
1554   ¤ If BitrateHistogram is enabled in getOnlyMPEGaudioInfo() it now
1555     also returns ['mpeg']['audio']['version_distribution'] showing
1556     the number of frames of each MPEG version (1, 2 or 2.5) - all
1557     frames *should* be of the same MPEG version
1558   ¤ getID3v1Filepointer() always returns TRUE now, even if it didn't
1559     find a valid ID3v1 tag
1560   ¤ getOnlyMPEGaudioInfo() now looks for MPEG sync in the first 128k
1561     bytes rather than the first 64k bytes
1562   ¤ Added dummy function GetAllMP3info() to generate warning not to
1563     use that deprecated function.
1564   ¤ ['video']['codec'] is now 'MPEG' for all MPEG video files (this
1565     will change to 'MPEG-1' or 'MPEG-2' as soon as I figure out how
1566     to determine that)  (thanks jigalØspill*nl)
1567   ¤ ['mpeg']['audio']['LAME']['mp3_gain'] renamed to
1568     ['mpeg']['audio']['LAME']['mp3_gain_db'] (gain in dB)
1569   ¤ Added ['mpeg']['audio']['LAME']['mp3_gain_factor'] (gain as a
1570     multiplication factor)
1571   ¤ Added support for Preset and Surround Info bytes from LAME VBR
1572     tag (http://gabriel.mp3-tech.org/mp3infotag.html)
1573   * Bugfix: APE tag writing would put the string 'Array' for all
1574     values rather than the actual data  (thanks ahØartemis*dk)
1575   * Bugfix: Warning now generated for VBR MPEG-video files because
1576     getID3() cannot determine average bitrate. If you know of
1577     documentation that would tell me how to do this, please email
1578     info@getid3.org
1579   * Bugfix: Replay Gain values from Vorbis comments are now
1580     returned in ['replay_gain'] (and not in ['comments'])
1581     (thanks ahØartemis*dk)
1582   * Bugfix: Replay Gain values from APE comments are now correctly
1583     returned in ['replay_gain']  (thanks ahØartemis*dk)
1584   * Bugfix: getid3.demo.check.php is now case-insensitive when
1585     assuming a format for a corrupted file if standard detection
1586     does not identify the file type.
1587   * Bugfix: RIFF comments were overwriting/suppressing ID3 comments
1588     for RIFF-MP3 files  (thanks wmØwofuer*com)
1589   * Bugfix: RIFF-MP3 files with 'RMP3' chunks instead of 'WAVE' were
1590     not being correctly identified.
1591   * Bugfix: ID3v2 padding shorter than the length of an ID3v2 frame
1592     header was not correctly detected
1593   * Bugfix: getid3.demo.check.php now does in-depth scanning for MP2
1594     and MP1 files the same as for MP3 files based on file extension
1595     if a MPEG-audio structure isn't found immediately at the start
1596     of the file
1597   * Bugfix: removed condition where RIFF-WAV was being scanned for
1598     MPEG-audio signature when it shouldn't be present (non-MP3 WAV)
1599   * Bugfix: ASF files were not always showing correct audio datatype
1600   * Bugfix: array_merge_clobber() and array_merge_noclobber() were
1601     not being conditionally defined in getid3.functions.php
1602     (thanks rich.martinØreden-anders*com)
1603   * Bugfix: stream_numbers was not being correctly returned in
1604     bitrate_mutual_exclusion_object chunks of ASF files
1605   * Bugfix: Added support for 24kHz and 12kHz audio in ASF files
1606   * Bugfix: Removed possible undefined offset error in MP3s where
1607     cannot find synch before end of file
1608   * Bugfix: Removed potential out-of-memory crash situation when
1609     parsing Real files with chunks larger than the available memory
1610     (thanks jigalØspill*nl)
1611   * Bugfix: ID3v1 was incorrectly taking precedence over ID3v2 in
1612     the ['comments'] array (thanks lionelflØwanadoo*fr)
1613   * Bugfix: No longer calculates overall bitrate and playtime for
1614     VBR MPEG video files based on the audio bitrate.
1615   * Bugfix: AssumeFormat was not working properly
1616   Added summary footer line to getid3.demo.check.php
1617   Added '.mpeg' to the list of assume-format-from-filenames list in
1618     getid3.demo.check.php
1619   MPEG-video files now more reliably detected
1620   A number of additional features have been added to
1621     getid3.demo.scandir.php
1622   Added many RIFF-AVI audio types and fourcc video types to the
1623     lookup functions in getid3.riff.php
1624   Now identifes files with Lyrics3 v1 tags that are of incorrect
1625     length (v1 Lyrics3 is supposed to be 5100 bytes long, but
1626     [unknown program] writes variable-length tags (which is illegal
1627     for Lyrics3 v1)). getID3() now correctly parses these tags and
1628     issues a warning.
1629   Split GetFileFormat() to GetFileFormat() and GetFileFormatArray()
1630   HTML colors in getid3.demo.check.php are now defined as constant
1631     variables at the top of the file (if you want to change them)
1632   Added support for OptimFROG v4.50x (non-alpha) (new header fields)
1633     (thanks floringhidoØyahoo*com)
1634   Added support for Lossless Audio v0.4 (thanks mikeØbevin*de)
16371.6.1: [March-03-2003] James Heinrich
1638   » Added support for writing APE v2.
1639     WriteAPEtag() in getid3.ape.php
1640     NOTE: APE v1 writing support will *not* be added to future
1641     versions of getID3()
1642     (thanks ahØartemis*dk and adamØphysco*com for the idea)
1643   » Added support for AIFF (Audio Interchange File Format) including
1644     AIFF, AIFC and 8SVX  (thanks ahØartemis*dk for the idea)
1645     Removed file: getid3.aiff.php
1646   » Added support for OptimFROG (v4.50a and v4.2x)
1647     (thanks ahØartemis*dk for the idea)
1648     New file: getid3.optimfrog.php
1649   » Added support for WavPack  (thanks ahØartemis*dk for the idea)
1650   » Added support for LPAC  (thanks ahØartemis*dk for the idea)
1651   » Added support for NeXT/Sun .au format
1652     New file: getid3.au.php
1653   » Added support for Creative SoundBlaster VOC format
1654     New file: getid3.voc.php
1655   » Added support for the BWF (Broadcast Wave File) RIFF chunks
1656     "bext" and "MEXT"  (thanks Ryan and njhØsurgeradio*co*uk)
1657   » Added support for the CART (Broadcast Wave File) RIFF chunks
1658     (thanks Ryan)
1659   » Added getid3.demo.scandir.php - a sample recursive scanning demo
1660     that scans every file in a given directory, and all sub-
1661     directories, and stores the resulting data in MySQL database,
1662     and then displays a list of duplicate files based on md5_data
1663   ¤ ['md5_data_source'] now contains the MD5 value for the original
1664     uncompressed data for formats that store that information
1665     (currently only FLAC v0.5+). ['md5_data'] (if chosen to be
1666     calculated) will contain the calculated MD5 value for the
1667     compressed file. To check if 2 files are identical in every way,
1668     including all comments: compare ['md5_file']. To check if two
1669     files were compressed from the same source file: compare
1670     ['md5_data_source']. To check if the compressed audio/video data
1671     of two files is identical, even if comments or even the
1672     container file format is different (MP3 in RIFF container,
1673     FLAC in Ogg container, etc): compare ['md5_data'].
1674   ¤ ['md5_data'] for 8-bit WAV files is now calculated based on a
1675     converted version of the data from unsigned to signed (MSB
1676     inverted) to match the MD5 value calculated by FLAC
1677   ¤ New optional parameter added to GetAllFileInfo() -
1678     $MD5dataIfMD5SourceKnown (default: false). If false the md5_data
1679     value will NOT be calculated for files (such as FLAC) that have
1680     ['md5_data_source'] set, even if $MD5data == true.
1681     (thanks ahØartemis*dk)
1682   ¤ getid3.check.php renamed to getid3.demo.check.php
1683   ¤ Added GetTagOnly() function to getid3.php - similar to
1684     GetAllFileInfo() except only takes a filename as a parameter and
1685     only returns ID3v2, APE, Lyrics3 and ID3v1 tag information - no
1686     attempt is made to parse the data contents of the file at all.
1687     (thanks Phil for the idea)
1688   ¤ Added ['audio']['lossless'] and ['video']['lossless'] for all
1689     formats (when known). Both are boolean values - true means the
1690     data is lossless-compressed, false means the data is lossy-
1691     compressed.
1692   ¤ Added ['audio']['compression_ratio'] and/or
1693     ['video']['compression_ratio'] for all formats. Returns a number
1694     (usually) less than 1, where 1 represents no compression and 0.5
1695     represents a compressed file half the size of the original file
1696   ¤ Added ['video']['bits_per_sample'] to all video formats (when
1697     known)
1698   ¤ Added ['video']['frame_rate'] to all video formats (when known)
1699   ¤ ['fileformat'] set to 'mp1' or 'mp2' instead of 'mp3' when
1700     ['audio']['dataformat'] is one of those  (thanks ahØartemis*dk)
1701   ¤ Added 4th parameter to md5_data(), $invertsign, which will invert
1702     the MSB of each byte before MD5'ing. This is needed for 8-bit
1703     WAV files because FLAC calculates the stored MD5 value on
1704     signed data rather than the original byte values. ['md5_data']
1705     of an 8-bit WAV will now match the ['md5_data_source'] value
1706     (thanks lichvarmØphoenix*inf*upol*cz)
1707   ¤ ['ape']['items']['data'] and ['ape']['items']['data_ascii'] now
1708     contains an array of values, if the tag contains UTF-8 text (as
1709     opposed to binary data)
1710   ¤ ['mpeg']['audio']['bitratemode'] renamed to
1711     ['mpeg']['audio']['bitrate_mode']
1712   * Bugfix: Removed potential bug that could replace all MP3 file
1713     contents with only the new ID3v2 tag in getid3.putid3.php
1714   * Bugfix: md5_data values calculated for RIFF (WAV, AVI) files
1715     were incorrect  (thanks ahØartemis*dk)
1716   * Bugfix: MP3 data in an MP4 wrapper fileformat could not identify
1717     bitrate  (thanks ahØartemis*dk)
1718   * Bugfix: ['audio'] and/or ['video'] keys would sometimes get
1719     removed even if not empty
1720   * Bugfix: Prevented creation of null entries in
1721     ['RIFF']['WAVE']['INFO'] if a comment entry was not present
1722   * Bugfix: Potential infinite-loop condition in getid3.ogg.php
1723     (thanks afshin.behniaØsbcglobal*net)
1724   * Bugfix: Ogg files with illegal ID3v1 (and/or APE or Lyrics3)
1725     tags were not finding the last Ogg page
1726     (thanks afshin.behniaØsbcglobal*net)
1727   * Bugfix: replay-gain values not properly set from LAME tag
1728   * Bugfix: RIFF-MP3 had incorrect md5_data
1729   * Bugfix: the LAME DLL CBR problem of not re-writing the LAME
1730     frame at the beginning of the data is now detected for MP3s
1731     with ID3v2 tags as well
1732   * Bugfix: APE tags with multiple values (ie multiple entries in
1733     the "artist" tag) are now shown properly in ['ape']['items']
1734   * Bugfix: fixed condition where APE tag with no ID3v1 tag could be
1735     mistaken for APE tag with ID3v1 (and incorrectly parsed)
1736   * Bugfix: added warning if ID3v2 frame has zero-length data
1737     (thanks cmassetØclubinternet*fr)
1738   * Bugfix: getid3.frames.php looking for non-existant key in USER
1739     frames
1740   Improved detection of RIFF-MP3 data. [unknown program] encodes
1741     RIFF-WAV data with a chunk name of 'RMP3' instead of the
1742     standard 'RIFF'
1743   Encoder now returned in both ['comments'] and ['audio']['encoder']
1744     for RIFF-WAV files with an INFO.ISFT chunk
1745   Generate a warning for FLAC files encoded with v0.3 or v0.4
1746     because audio_signature is not calculated during encoding
1747     (thanks ahØartemis*dk)
1748   Modified getid3.check.php to display md5_data_source as well as
1749     md5_file and md5_data if display-MD5 mode is selected
1750   Modified getid3.check.php to assume-format based on file extension
1751     in browse mode if fileformat is found to be 'id3' (formerly only
1752     if the fileformat was null)
1753   Changed scaling of BitrateColor() from representing 1-256kbps to
1754     representing 1-768kbps for better display of high-bitrate files,
1755     specifically lossless-compressed CD-audio (FLAC, LA, etc)
17581.6.0: [January-30-2003] James Heinrich
1759   » Added support for OggFLAC (FLAC data stored in an Ogg container)
1760     (thanks ahØartemis*dk for the idea)
1761   » Added support for Speex (the data stored in an Ogg container)
1762   » Comments are now available in the root 2-dimensional array
1763     ['comments'] - each entry in this array will contain one or more
1764     strings. For example, if there are two artists then
1765     ['comments']['artist'][0] will contain the first one and
1766     ['comments']['artist'][1] the other. All keys are forced
1767     lowercase. Comments will be stored in the ['comments'] array in
1768     this order of precedence:
1769     1) Native format tags (ASF, VQF, NSV, RIFF, Quicktime, Vorbis)
1770     2) APE tags
1771     3) ID3v2
1772     4) Lyrics3
1773     5) ID3v1
1774     Lower-priority tags will not overwrite or append existing values
1775     of higher-priority tags (for example, 'artist' in ID3v1 will be
1776     ignored if already specified in APE), but missing values will be
1777     filled in (for example, if 'album' is specified in ID3v2 but not
1778     in APE, it will be included in the ['comments'] array).
1779     Note: Root keys (['title'], ['artist'], etc) are NOT available
1780     in this or future versions of getID3().
1781     (thanks ahØartemis*dk)
1782   » MD5 hashes are now available for all formats for both the entire
1783     file (['md5_file']) and the portion of the file containing only
1784     the audio/video data, stripped of all prepended/appended tags
1785     like ID3v2, ID3v1, APE, etc - ['md5_data']
1786     (thanks ahØartemis*dk for alternate md5_file() function that
1787     runs on UNIX system running PHP < 4.2.0)
1788     NOTE: Ogg files require the use of vorbiscomment to obtain the
1789     md5_data value. vorbiscomment must be downloaded from
1790     http://www.vorbis.com/download.psp and placed in the getID3()
1791     directory. All Ogg formats (Vorbis, OggFLAC, Speex) are affected
1792     by this problem, but only OggVorbis files can be processed with
1793     vorbiscomment. OggFLAC and Speex files will be processed by
1794     getID3(), but this may result in an incorrect value for md5_data
1795     in the event that VorbisComments are larger than 1 page (4-8kB).
1796     NOTE: md5_data for Ogg will not work if PHP is running in Safe
1797     Mode
1798   » There is now a wrapper class available, written by Allan Hansen,
1799     which should simplify extracting most common basic information
1800     (such as format, bitrate, comments).
1801     New file: audioinfo.class.php
1802   » OggWrite() in getid3.ogginfo.php has been replaced with a new
1803     version that uses vorbiscomment to write the comments, because
1804     of a reported bug that can corrupt OggVorbis files such they
1805     cannot be played.
1806     NOTE: Ogg comment writing now requires the use of vorbiscomment
1807     which must be downloaded from http://www.vorbis.com/download.psp
1808     and placed in the getID3() directory.
1809     NOTE: Ogg comment writing will not work if PHP is running in
1810     Safe Mode
1811   ¤ New root key ['tags'] is now always returned for all formats.
1812     It is an array that may contain any of:
1813     * Native format tags: 'vqf', 'riff', 'vorbiscomment', 'asf',
1814       'nsv', 'real', 'midi', 'zip', 'quicktime'
1815     * Appended data tags:  'ape', 'lyrics3', 'id3v2', 'id3v1'
1816   ¤ New root key ['audio'] is an array containing any or all of:
1817       codec, channels, channelmode, bitrate, bits_per_sample,
1818       dataformat, bitrate_mode, sample_rate, encoder
1819       Note: This replaces several root keys, including:
1820         bitrate_audio, bits_per_sample, frequency, channels
1821   ¤ New root key ['video'] is an array containing any or all of:
1822       bitrate_mode, bitrate, codec, resolution_x,  resolution_y,
1823       resolution_y, frame_rate, encoder
1824       Note: This replaces several root keys, including:
1825         bitrate_video, resolution_x, resolution_y, frame_rate
1826   ¤ ['id3']['id3v1'] has moved to ['id3v1']
1827   ¤ ['id3']['id3v2'] has moved to ['id3v2']
1828   ¤ ['audiodataoffset'] and ['audiodataend'] have been renamed to
1829     ['avdataoffset'] and ['avdataend'] respectively
1830   ¤ GetAllMP3info() has been changed to GetAllFileInfo() with a
1831     different parameter list ($allowedFormats is no longer a
1832     parameter).  Check your code where you're calling
1833     GetAllMP3Info() - you will need to change both the function
1834     name and the parameter list if you pass more than 2 parameters
1835   ¤ All formats now return ['audio']['dataformat'] and/or
1836     ['video']['dataformat'] where appropriate - this goes along with
1837     ['fileformat'] - ['fileformat'] will return the actual structure
1838     of the file, whereas ['dataformat'] will return the format of
1839     the data inside that structure. For example, an Ogg file can
1840     contain Vobis data (normal), or it can contain FLAC data in the
1841     Ogg container format. In that case, ['fileformat'] would be
1842     'ogg', but ['dataformat'] would be 'flac'.
1843     Note: this means that WAV and AVI files now return a
1844     ['fileformat'] of 'riff' rather than 'wav' or 'avi'.
1845   ¤ ['filesize'] is no longer returned for files larger than 2GB
1846     because PHP does not support large file access. Attempting to
1847     parse a file larger than 2GB will result in a message stored in
1848     ['error'] and ['filesize'] not set.
1849   ¤ APEtag, ID3v1, and ID3v2 are now supported on ALL multimedia
1850     files - even if illegal by format. Ogg will return warning if
1851     ID3/APE tags are present.  (thanks ahØartemis*dk)
1852   ¤ All files: non-critical errors are now returned in the root key
1853     ['warning'] rather than ['error'] (only critical errors that
1854     prevent getID3() from correctly parsing the file are returned in
1855     ['error']  (thanks ahØartemis*dk)
1856   ¤ Renamed all references to $MP3fileInfo to $ThisFileInfo
1857   ¤ Joliet now supported for ISO-9660.
1858     ['iso']['supplementary_volume_descriptor'] is now returned, if
1859     available, and ['iso']['files'] will contain ASCII equivalents
1860     of the Unicode directory structure & filenames stored.
1861   ¤ Moved Monkey's Audio code from getid3.ape.php to seperate file.
1862     New file: getid3.monkey.php
1863   ¤ Added new keys for ISO-9660: ['name_ascii'] for directories,
1864     ['file_identifier_ascii'] for files
1865   ¤ Added root key ['track'] for CD-audio files
1866   ¤ Ogg/Vorbis-comment files now have comments returned inside
1867     ['ogg']['comments_common'] as an array of strings, rather than
1868     simple strings in ['ogg']
1869   ¤ Quicktime files now have comments returned inside
1870     ['quicktime']['comments'] as an array of strings, rather than
1871     simple strings in ['quicktime']
1872   ¤ ['mime_type'] is a new root key returned for all supported
1873     formats (thanks ahØartemis*dk)
1874   ¤ ['fileformat'] now returns 'mp1' instead of 'mp3' for MPEG-1
1875     layer-I audio files (thanks ahØartemis*dk)
1876   ¤ ['mpeg']['audio']['bitratemode'] now returns lowercase
1877   ¤ MPEG-4 audio files which consist of MP3 data wrapped in a
1878     Quicktime fileformat will now return the usual data in
1879     ['mpeg']['audio']
1880   ¤ Type-1 DV AVIs are now supported
1881   ¤ DV AVIs will return 1 or 2 in ['RIFF']['video'][x]['dv_type']
1882   ¤ Changed ['fileformat'] from 'mpg' to 'mpeg' for MPEG video files
1883   ¤ ASF comments are now stored in ['asf']['comments'] instead of
1884     ['asf']
1885   ¤ RealMedia chunk data is now returned inside ['real']['chunks']
1886     instead of ['real']
1887   ¤ ['replay_gain'] now properly populated from APE tags
1888   ¤ Added support for ASF_Old_ASF_Index_Object in ASF files
1889     (thanks ahØartemis*dk)
1890   ¤ AAC-ADTS files now return ['aac']['bitrate_distribution']
1891   ¤ ParseVorbisComments() has been replaced with
1892     ParseVorbisCommentsFilepointer() (with different parameters)
1893   ¤ All references to any key ['frequency'] are now ['sample_rate']
1894   ¤ Moved ID3v2 comments from ['id3v2'] into common root
1895     ['comments'] structure, and now returns more values than before
1896   * Bugfix: ['iso']['files'] and ['zip']['files'] could potentially
1897     contain duplicate entries (in a numeric-indexed array) for files
1898     if the directory structure specifies files multiple times.
1899     Entries are now guaranteed unique, with the last entry for the
1900     file overwriting any former ones.
1901   * Bugfix: RIFF parsing had numerous issues, including:
1902     - large AVIs would take a very very long time to parse
1903     - chunks with odd (not even) sizes would cause the parser fail
1904     - video and/or audio codecs not always identified
1905     The ParseRIFF() function has been completely rewritten and fixes
1906     all known issues with RIFF parsing. Users are, however,
1907     encouraged to double-check output of any parsed (AVI/WAV/CDDA)
1908     files.
1909   * Bugfix: Modified getid3.riff.php to return correct total
1910     bitrates for AVIs with multiple audio streams
1911   * Bugfix: GetFileFormat() was not creating array structure
1912     correctly  (thanks ahØartemis*dk)
1913   * Bugfix: LAME tag for MP3s can only specify up to 255kbps, so any
1914     files with actual CBR bitrate of >=256 were reported incorrectly
1915   * Bugfix: Lyrics3 synched lyrics were not being correctly returned
1916   * Bugfix: CreateDeepArray() was broken for non-nested cases, which
1917     meant ZIP and ISO ['files'] structures were broken
1918   * Bugfix: Incorrect pattern matching for ZIP files meant no zip
1919     files were being detected as such
1920   * Bugfix: AAC-ADIF was returning an incorrect number of channels
1921     (too few) in some cases  (thanks ahØartemis*dk)
1922   * Bugfix: Vorbis comments were returning an incorrect value for
1923     ['dataoffset'] in some cases
1924   * Bugfix: MPEG video ['marker_bit'] and ['vbv_buffer_size'] were
1925     incorrect
1926   * Bugfix: ['playtime_string'] could potentially have a value of
1927     x minutes and 60 seconds (ie 3:60 instead of 4:00)
1928   Added support for FLAC cuesheets (FLAC 1.1.0+)
1929     (thanks ahØartemis*dk)
1930   Improved parsing speed in MP3, MP2 and AAC  (thanks ahØartemis*dk)
1931   Extra error-checking added to try and identify corrupt files for
1932     most audio formats  (thanks ahØartemis*dk)
1933   More accurate playtime calculation for RealMedia
1934     (thanks ahØartemis*dk)
1935   Changed all relevant files to use ['audiodataoffset'] and
1936     ['audiodataend'] rather than ['filesize'] where appropriate
1937     (thanks ahØartemis*dk)
1938   Added text encoding type 255 as a duplicate of UTF-16BE but with
1939     Big-Endian rather than Little-Endian byte order
1940   Added many RIFF-AVI audio types and fourcc video types to the
1941     lookup functions in getid3.riff.php
1942   Added numerous new known GUIDs to getid3.asf.php
1943   Added PoweredBygetID3() function to easily get a "powered by"
1944     string with the current getID3() version.
1945   Added "Morgan Multimedia Motion JPEG2000" (MJ2C), "DivX v5" (DX50)
1946     and "XviD" (XVID) codecs to list of known codecs in
1947     getid3.riff.php
1948   Changed GETID3_INCLUDEPATH path seperators to forced /
1949     (from \ for Windows)
1950   Modified getid3.check.php to only change \ directory seperators to
1951     / on Windows operating systems
1952   Modified getid3.check.php to handle larger-than-2GB files (which
1953     now do not return a filesize)
1954   Modified getid3.check.php to handle ['dataformat_audio'] and
1955     ['dataformat_video']
1956   Modified getid3.check.php to show a list of present tags in one
1957     column rather than one column for each of ID3v1, ID3v2, etc
1958   Modified getid3.check.php to show MD5 values. Initially disabled
1959     but can be enabled for a directory with a click. md5_file is
1960     always calculated when displaying detailed info about a single
1961     file; md5_data is calculated if the file is < 50MB
1962   Modified getid3.check.php to show errors and warnings. Details are
1963     visible with a mouseover or a click.
1964   Changed getid3.check.php to use SafeStripSlashes instead of a
1965     manual conditional directory name replacement for special
1966     characters
1967   Added sample recursive scanning sample code to getid3.readme.txt
1968     (thanks lipisinØmail*ru for the idea)
19711.5.7: [January-10-2003] James Heinrich
1972   » Added support for ISO 9660 (CD-ROM image) format. Most-useful
1973     data is directory structure returned under ['iso']['files']
1974     Note: Only ISO-9660 supported, not (yet) Joliet extension
1975     (thanks nebula_djØsofthome*net for the idea)
1976     New file: getid3.iso.php
1977   ¤ ZIP files are now parsed by getID3() itself without relying on
1978     built-in PHP functions and/or ZZipLib support.
1979     (thanks Vince for the idea)
1980   ¤ ZIP files now return a simple directory listing with filename
1981     and filesize info only under ['zip']['files'].
1982     Note: empty subdirectories will note appear in here, only files
1983     and non-empty subdirectories. Information for all entries,
1984     including empty subdirectories, is available under
1985     ['zip']['central_directory'] (or under ['zip']['entries'] if the
1986     Central Directory cannot be located (usually due to a trucated
1987     file).
1988   ¤ RIFF-WAV files with MP3 data (or MP3s with RIFF headers, if you
1989     want to think of it that way) now have the MPEG audio portion
1990     scanned and the usual data returned in ['mpeg']['audio'] if the
1991     RIFF audio codec has wFormatTag of "85" (identified by getID3()
1992     as "MPEG Layer 3")
1993     (thanks ahØartemis*dk for the idea)
1994   ¤ EXIF data (if present) is returned for JPEG files under
1995     ['jpg']['exif']  (thanks nebula_djØsofthome*net)
1996   ¤ ['filepath'] now returned for all files with the directory part
1997     of the full filename.
1998   ¤ ['filenamepath'] is now returned for all files (equivalent to
1999     ['filepath'].'/'.['filename'])
2000   * Bugfix: ['id3']['id3v2'][<framename>]['dataoffset'] was wrong
2001   * Bugfix: MP3s tagged with iTunes have an invalid comment field
2002     frame name ('COM ' - should be 'COMM') but the data is valid
2003     otherwise; the frame is now renamed to 'COMM' and parsed
2004     normally (with the error noted in ['error'])
2005     (thanks kheller2Ømac*com for the sample file)
2006   * Bugfix: Some ASF/WMA audio files were not being identified as
2007     any format  (thanks ahØartemis*dk)
2008   * Bugfix: Warning now generated and ASCII format assumed for
2009     invalid text encoding values in ID3v2
2010   * Bugfix: Changed ZIP detection pattern from 'PK' to 'PK\x04\x03'
2011   * Bugfix: Ogg/FLAC files with large Vorbis comments were dying in
2012     an infinite loop with lots of error messages due to missing $fd
2013     parameter on ParseVorbisComments()  (thanks ahØartemis*dk)
2014   * Bugfix: ['data'] and ['image_mime'] were being returned for all
2015     Ogg comments even if they were not images for versions of PHP
2016     that have image_type_to_mime_type() built in (ie PHP 4.3.0+)
20191.5.6: [December-31-2002] James Heinrich
2020   » Added support for NSV (Nullsoft Streaming Video)
2021     (www.nullsoft.com/nsv/)
2022     (thanks demonØsoundplanet*com for the idea)
2023     New file: getid3.nsv.php
2024   » Added support for CD-audio track files (track01.cda etc)
2025   ¤ Added standard ['frame_rate'] root value when known (AVI, NSV,
2026     MPEG-video)
2027   ¤ ASF files now report ['fileformat'] of:
2028     'wmv' when Windows Media Video codec v7/v8/v9 is used;
2029     'wma' when any 'Windows Media Audio' named audio codec is used
2030           and no video stream is present;
2031     'asf' in all other cases (audio-only, video-only, or both)
2032   ¤ Removed support for ZIP functions (will be rewritten to not
2033     require ZZIPlib support in future versions)
2034   ¤ Added function SafeStripSlashes() as a drop-in replacement for
2035     stripslashes(), but that only strips slashes if magic_quotes_gpc
2036     is set
2037   ¤ Removed support for remote file scanning (HTTP / FTP)
2038   ¤ Added ['aac']['frames'] (number of AAC frames in file)
2039   ¤ Added ['mpeg']['audio']['frame_count'] when a bitrate histogram
2040     is created
2041   ¤ Average bitrate for VBR MP3/MP2 is calculated from actual counts
2042     of frames of various bitrates (rather than relying on the header
2043     values or filesize) when a bitrate histogram is created
2044   ¤ RecursiveFrameScanning() split out into seperate function
2045     (getid3.mp3.php)
2046   ¤ Removed old function getMP3header() from getid3.mp3.php
2047   ¤ Changed default MPEG_VALID_CHECK_FRAMES (number of mp3 frames
2048     scanned to ensure a valid audio sequence has been located) from
2049     10 to 25. This means scanning will be slightly slower, but more
2050     reliable/accurate
2051   * Bugfix: ID3v2.2 - valid frame names not correctly detected
2052     (thanks maeckerØweb*de for the sample file)
2053   * Bugfix: ID3v2.2 - valid padding not correctly detected
2054     (thanks maeckerØweb*de for the sample file)
2055   * Bugfix: MIDI files with flat key signatures were not being
2056     correctly reported (thanks alexleeisØshaw*ca for sample file)
2057   * Bugfix: now returns message in ['error'] if file does not exist
2058   * Bugfix: ['RIFF']['video'][x]['codec'] wasn't always being
2059     correctly populated
2060   * Bugfix: ['bitrate'] was incorrect for multi-stream RealMedia
2061   * Bugfix: ['playtime_seconds'] was sometimes null or incorrect
2062     for multi-stream RealMedia
2063   * Bugfix: ChannelTypeID was incorrect in RVA2 ID3v2.4 frames
2064   * Bugfix: Fixed potential divide-by-zero error for corrupt FLAC
2065     files  (thanks ahØartemis*dk)
2066   * Bugfix: AAC-ADTS was not returning ['bitrate_mode'] unless
2067     $ReturnExtendedInfo was TRUE  (thanks ahØartemis*dk)
2068   * Bugfix: LAME-encoded CBR MP3s now properly identified as CBR
2069     with correct bitrate  (thanks ahØartemis*dk)
2070   * Bugfix: VBR MP2 (or headerless MP3) is now identified as VBR
2071     rather than CBR. Note: to obtain VBR bitrate for headerless
2072     files, the entire file is scanned and a histogram distribution
2073     of bitrates is created, and the average bitrate calculated from
2074     that.  (thanks ahØartemis*dk for sample file)
2075   Added support for DSIZ chunks in VQF, and checks to make sure size
2076     of audio data matches DSIZ value, if present
2077     (thanks ahØartemis*dk for sample file)
2078   Rewrote GetAllMP3info() - removed some unneccesary code, changed
2079     format-detection routine from ParseAsThisFormat() to
2080     GetFileFormat() to allow for more flexible format parsing
2081     (needed for ISO CD-ROM images, helpful for Quicktime and others)
2082   Changed references in all files from string-cast indexes: ["$i"]
2083     to non-cast indexes: [$i] where appropriate
2084   Put a sans-serif 9pt style on all text in getid3.check.php
2085   getAACADTSheaderFilepointer() now return TRUE if synch is lost
2086     after the first frame has been successfully parsed (previously
2087     it would return FALSE if synch was lost at any time, meaning the
2088     file is most likely MP3, which was incorrect)
2089     (thanks ahØartemis*dk for sample file)
2090   Speed improvement code changes to getid3.mp3.php (up to 24% faster
2091     in some cases)  (thanks ahØartemis*dk for the code)
2092   Changed all include_once() to require_once()
20951.5.5: [November-25-2002] James Heinrich
2096   » Added support for La (Lossless Audio - www.lossless-audio.com)
2097     (thanks ahØartemis*dk for the idea)
2098     New file: getid3.la.php
2099   ¤ Moved lookup functions from getid3.lookup.php to the files where
2100     they are used.
2101     New file: getid3.id3.php
2102     New file: getid3.rgad.php
2103     Removed file: getid3.lookup.php
2104   ¤ getID3v1Filepointer() returns FALSE if ID3v1 tag not found
2105   ¤ Added new paramter "ReturnExtendedInfo" to the function
2106     getAACADTSheaderFilepointer() in getid3.aac.php which now
2107     defaults to FALSE - if TRUE then the data for every frame is
2108     returned (containing aac_frame_length, adts_buffer_fullness and
2109     num_raw_data_blocks, which aren't usually very useful). Speed
2110     improvement with FALSE is about 35%.
2111   ¤ Now returns fopen() errors in ['error'], for example if a remote
2112     file is not accessible.
2113   ¤ Changed default number of MP3 audio frames to scan to determine
2114     if a valid stream has been found from 5 to 10, now also defined
2115     as a constant at the top of getid3.mp3.php  This will result in
2116     slightly slower MP3 parsing, but greater reliability in
2117     detecting false/invalid/corrupted VBR headers.
2118   ¤ fopen() errors now displayed in getid3.putid3.php
2119     (thanks miguel.dieckmannØhamburg*de)
2120   ¤ Added 4th parameter to decodeMPEGaudioHeader() $ScanAsCBR which
2121     will force an MP3 audio frame sequence to be force-scanned in
2122     CBR mode. You should never need to call this directly, it's only
2123     used internally to scan for MP3 files that have an illegal VBR
2124     header with CBR data. (thanks fletchØpobox*com)
2125   * Bugfix: ASF_Marker_Object in getid3.asf.php was always returning
2126     an error in non-existant "reserved_1" and failing
2127   * Bugfix: VBR bitrate calculations in getid3.mp3.php only occur if
2128     ['mpeg']['audio']['VBR_frames'] is defined.
2129     (thanks fletchØpobox*com)
2130   * Bugfix: getid3.putid3.php no longer deletes original MP3 if
2131     ID3v2 tag writing fails (thanks miguel*dieckmannØhamburg*de)
2132   * Bugfix: incorrect order of if-statement error messages in
2133     getid3.putid3.php (thanks miguel*dieckmannØhamburg*de)
2134   getid3.asf.php now notes the error and continues parsing rather
2135     than failing when it encounters an error parsing a chunk
2136   Now actually scan 1000 frames for AAC ADTS as reported in the
2137     v1.5.4 changelog, rather than 100. (thanks ahØartemis*dk)
2138   Improved scanning speed in getAACADTSheaderFilepointer() by ~30%
2139     (thanks ahØartemis*dk for the fix)
2140   Added FileSizeNiceDisplay() function to getid3.functions.php for
2141     formatting filesize output in kB, MB, GB, etc.
21441.5.4: [October-07-2002] James Heinrich
2145   » Added support for Quicktime.
2146     New file: getid3.quicktime.php
2147   » Added support for AAC files, both ADTS and ADIF header formats.
2148     ADIF format is a pain because it's very similar to standard MP3
2149     header format, and it's hard to distinguish between the two. I
2150     have tried to make the detection accurate, but I have a limited
2151     number of AAC test files to play with so if you have an AAC file
2152     that gets detected as MP3/MP2 (or vice-versa), please send me
2153     the details via email at infoØgetid3Øorg
2154     ADTS format is very slow to parse because to get the bitrate of
2155     VBR files the whole file has to be stepped through frame by
2156     frame (getID3() scans up to the first 1000 frames and assumes
2157     that to be close enough).
2158     Note: I would suggest commenting out support for AAC (see top of
2159     GetAllMP3info() function in getid3.php) unless you need it.
2160     (thanks jfaulØgmx*de for the idea and sample Delphi source code)
2161     New file: getid3.aac.php
2162   » Added bitrate distribution analysis option for MP3 VBR files. A
2163     new boolean parameter for getOnlyMPEGaudioInfo() enabled this
2164     feature which steps through the MP3 file frame by frame and
2165     counts how many frames of each bitrate exist. This information
2166     is returned in ['mpeg']['audio']['bitrate_distribution']
2167     Caution: this feature is very inefficient for large files and
2168     takes a very long time and does lots of disk I/O. Use with care.
2169   ¤ Changed layout of allowedFormats in GetAllMP3info() function in
2170     getid3.php to allow easy removal of support for any of the
2171     supported format. As stated above, I recommend commenting out
2172     AAC unless needed.
2173   ¤ Added ['flac']['compressed_audio_bytes'],
2174     ['flac']['uncompressed_audio_bytes'], and
2175     ['flac']['compression_ratio']
2176   ¤ Replaced FXPT2DOT30toFloat() function with FixedPoint2_30()
2177   * Bugfix: getid3.mpc.php was slightly miscalculating the number of
2178     samples, therefore also bitrate and playtime
2179     (thanks ahØartemis*dk for the fix)
2180   * Bugfix: MonkeyCompressionLevelNameLookup() didn't know about
2181     'insane' compression (thanks ahØartemis*dk for the fix)
2182   * Bugfix: MonkeySamplesPerFrame() was incorrect for MAC v3.95+
2183     (thanks ahØartemis*dk for the fix)
2184   * Bugfix: getid3.check.php wasn't processing the assumeFormat
2185     directive when (register_globals == off)
2186   * Bugfix: detecting of synch pattern for MP3 files with invalid
2187     data at the beginning wasn't always correct, also meant possible
2188     incorrect bitrate/duration/etc info for such corrupt files.
2189   getid3.functions.php now includes a replacement utf8_decode()
2190     function for those PHP installations that are not configured
2191     with the --with-xml option. (thanks stephaneØtekartists*com)
21941.5.3: [September-30-2002] James Heinrich
2195   » Added support for VQF. (thanks mtØmansonthomas*com for the idea)
2196     New file: getid3.vqf.php
2197   » Added support for FLAC. Comments, if present, are returned under
2198     ['ogg'] because they follow the Ogg Vorbis structure standard.
2199     New file: getid3.flac.php
2200   ¤ OS/2-format bitmaps are now correctly interpreted. The format of
2201     the bitmap is now returned in ['bmp']['type_os'] and
2202     ['bmp']['type_version']. OS/2 bitmaps can be v1 or v2, Windows
2203     can be v1, v4 or v5
22061.5.2: [September-25-2002] James Heinrich
2207   » Support for RealMedia (audio & video) added
2208     Note: only tested on G2 and v5 audio and video files - if anyone
2209     has older and/or newer sample files, please test it and/or send
2210     me the sample files.
2211     (thanks stephaneØtekartists*com for idea)
2212     New file: getid3.real.php
2213   » Support for BMP added. Palette and pixel data can optionally be
2214     extracted as well - this is slow and generally unneccesary, but
2215     the option is there if you need it. Also includes PlotBMP()
2216     which will take the extracted pixel data and output it as a true
2217     color PNG. This function requires GD v2.0+
2218     Note: Untested on 16-bit and 32-bit BMPs because I couldn't find
2219     any sample files - if you know of a program that can create such
2220     files, please email infoØgetid3Øorg
2221     Note: Support for RGB (uncompressed), RLE8 and RLE4 is included
2222     and tested. BITFIELDS support is also included for 16- & 32-bit
2223     formats, but it's untested, so if anybody has any test files
2224     please send them to infoØgetid3Øorg
2225     Note: Support currently only for Windows-format BMPs, and trying
2226     to parse an OS/2-format bitmap leads to unpredictable/invalid
2227     results.
2228     New file: getid3.bmp.php
2229   » PNG now fully parsed, including all information chunks
2230     New file: getid3.png.php
2231   ¤ Support for GIF/JPG/PNG moved to seperate files and expanded,
2232     including standard ['resolution_x'] and ['resolution_y'] as well
2233     as more thorough parsing of header information
2234     New file: getid3.gif.php
2235     New file: getid3.jpg.php
2236   table_var_dump() simplified and now outputs &#123;-style character
2237     entities for characters outside the normal alphanumeric range
2238   CleanOggCommentName() changed to a regular expression
2239     (thanks chris-getid3Øbolt*cx for rewriting the function)
22421.5.1: [September-20-2002] James Heinrich
2243   » Added support for MPEGplus/Musepack SV7. ['fileformat'] is 'SV7'
2244     for version 7 files (versions 4, 5 ,6 and 8 are not supported
2245     yet, but will be of ['fileformat'] SV4, SV5, SV6 and SV8) when
2246     they are supported (thanks Christian Fritz for the idea)
2247     New file: getid3.mpc.php
2248   ¤ ['bitrate_audio'], ['bitrate_video'], ['bitrate_mode'],
2249     ['channels'], ['resolution_x'], and ['resolution_y'] keys added
2250     for all appropriate formats
2251   ¤ Ogg files with a COVERART comment now save and display the
2252     attached image the same way as is done with ID3v2 APICs
2253   ¤ ['ogg']['comments'][n]['data'] and
2254     ['ogg']['comments'][n]['dataoffset'] is now returned for all
2255     comments. ['ogg']['comments'][n]['data'] is only useful if
2256     the field is supposed to contain binary data. It is a
2257     base64_decode()'d version of ['value'].
2258     ['ogg']['comments'][n]['dataoffset'] is the byte offset in the
2259     file at which the 'COMMENTNAME=value string' starts, not the
2260     start of just 'value'
2261   ¤ ['ogg']['comments'][n]['image_mime'] is now returned if
2262     ['ogg']['comments'][n]['data'] contains valid image data.
2263   ¤ More than 3 Ogg pages may now be read in, if the comment data
2264     is longer than 1 page (usually about 4kB)
2265   ¤ ['fileformat'] is now 'mp2' rather than 'mp3' if it's MPEG-1,
2266     Layer-II audio
2267   ¤ ASF bitrates now calculated even if stream_bitrate_properties
2268     object not present
2269   ¤ ['asf']['stream_properties_object'] is now a numeric-key array
2270     with one entry for each stream - the key being the stream number
2271   ¤ ['replay_gain'] is returned for all audio formats that support
2272     it (MP3-LAME, ID3v2, Ogg) (thanks Christian Fritz for the idea)
2273   ¤ ['mpeg']['audio']['LAME']['RGAD']['radio_replay_gain'] is now
2274     ['mpeg']['audio']['LAME']['RGAD']['radio'] (same for audiophile)
2275   ¤ ASF/WMA files now use WM/Track to get track number from if
2276     WM/TrackNumber is not available (thanks stephaneØtekartists*com)
2277   ¤ ASF/WMV files now returns ['year'] and ['asf']['year']
2278   ¤ ASV/WMV files now use ['content_description']['description'] for
2279     the ['comment'] field (thanks stephaneØtekartists*com)
2280   ¤ ['track'] is now always returned as an integer
2281   * Bugfix: Ogg comments that are larger than one data page (usually
2282     about 4kB) are now correctly parsed (thanks Christian Fritz)
2283   * Bugfix: Ogg comment data is now UTF8-decoded
2284   * Bugfix: Ogg comment writing now UTF8-encodes the data
2285   * Bugfix: playtime for ASF files was off by <preroll> (usually
2286     between 3 and 12 seconds)
2287   * Bugfix: ['asf']['stream_properties_objects']['flags'] data was
2288     possibly incorrect
2289   * Bugfix: ASF Padding Object was overwriting
2290     Stream Bitrate Properties Object data (now returned correctly in
2291     ['asf']['padding_object']
2292   * Bugfix: ASF Marker Object Reserved_2 field was incorrect
2293   * Bugfix: ASF Bitrate Mutual Exclusion Object had incorrect stream
2294     numbers
2295   Warning displayed if incorrectly-formatted Ogg comment is present
2296     (known to be an issue with CDex v1.40, but fixed by v1.50b7)
2297     (thanks Christian Fritz)
2298   Ogg comment writing now checks for valid comment names
2299   Added bitrate column in getid3.check.php, and added some formatting
2300     (font, colour)
2301   Performance tweaks using bitwise math instead of binary string
2302     operations
23051.5.0: [September-18-2002] James Heinrich
2306   » Ogg comment writing support added. getid3.write.php has been
2307     updated to allow for writing comment tags to both MP3 and Ogg.
2308     Big thanks to Chris Bolt <chris-getid3Øbolt*cx> for writing the
2309     OggWrite() function and offering it for inclusion in getID3()
2310     New file: getid3.ogginfo.php
2311   » Support for Monkey's Audio and APE tag added.
2312     (thanks Christian Fritz for the idea)
2313     New file: getid3.ape.php
2314     ['fileformat'] now returns 'mac' for Monkey's Audio files, or
2315     'ape' for files with an APE tag (Monkey's Audio or other format)
2316   » getid3.thumbnail.php has been removed from the distribution and
2317     the table_var_dump() function now outputs APICs as seperate
2318     files in the same directory as the analyzed file. This should
2319     make the image-displaying more reliable as well as reduce
2320     complexity. The naming convention for the images is
2321     filename.ext.[byte offset of APIC data].[jpg|gif|png]
2322     If anybody still has any problems with corrupted images please
2323     let me know at infoØgetid3Øorg
2324   » Support for extended Xing/LAME tag
2325     (see http://users.belgacom.net/gc247244/extra/tag.html)
2326     Data is returned in ['mpeg']['audio']['LAME']
2327   ¤ ['ogg']['tracknumber'] has been renamed to ['ogg']['track'] and
2328     ['track'] is now returned in the root of the array
2329   ¤ ['ogg']['pageheader'][n]['flag'] has been renamed to
2330     ['ogg']['pageheader'][n]['flags'] and the unprocessed flag byte
2331     is available in ['ogg']['pageheader'][n]['flags_raw']
2332   ¤ ['frequency'] is now returned for WAVE files in the root of the
2333     array (thanks danielØelectroteque*org)
2334   ¤ ASF files now return codec, bitrate, resolution, etc information
2335     under ['asf']['video_media'] or ['asf']['audio_media']
2336   * Bugfix: RVA2 and EQU2 writing in getid3.putid3.php were
2337     incorrectly writing Volume Adjustment field
2338   * Bugfix: EQU2 in getid3.frames.php was reading Volume Adjustment
2339     as unsigned integer instead of signed integer
2340   * Bugfix: handling of remote files over HTTP & FTP was broken
2341     (thanks Vince)
2342   * Bugfix: incorrect handling of some ASF packets
2343   ASF/Windows Media format now more fully parsed, including Index
2344     Objects
2345   Added several new fourCC video codecs
23481.4.3: [September-15-2002] James Heinrich
2349   » Now parses ASF / WMV / WMA files
2350   ¤ New file: getid3.asf.php
2351   * Bugfix: RoughTranslateUnicodeToASCII() would return nothing
2352     if didn't find a terminator it was expecting
2353   Added FILETIMEtoUNIXtime() function (for converting 64-bit
2354     Microsoft FILETIME timestamps, used in ASF files and elsewhere,
2355     to UNIX Epoch timestamps)
2356   Added GUIDtoBytestring() and BytestringToGUID() functions
23591.4.2: [September-12-2002] James Heinrich
2360   » getID3() now requires PHP v4.1.0 or higher because it now is
2361     designed to work with register_globals = off and the new auto-
2362     globals ($_GET, $_SERVER, etc).
2363   * Bugfix: VBR MP3 files with Fraunhofer-style VBR header were not
2364     being correctly detected in most cases
2365     (thanks dkushnerØoddcast*com and mikeØftl*com for sample files)
2366   * Bugfix: IsValidTextEncoding() was broken
2367   * Bugfix: Add stripslashes($EditorFilename) to getid3.write.php
2368     (writing was broken for files with ' or " in the filename)
2369     (thanks mikeØftl*com and kthejoker)
2370   * Bugfix: If there is garbage data between a valid VBR header
2371     frame and a sequence of valid MPEG-audio frames the VBR data is
2372     no longer discarded. (thanks to mikeØftl*com for sample
2373     Fraunhofer-style VBR file produced with MusicMatch v7.2)
2374   ¤ Changed variable system to work with (register_globals = off)
2375   ¤ Moved relevant code into seperate PlaytimeString() function
2376   ¤ Added nl2br() to table_var_dump() for cleaner output
2377   ¤ Now returns the following keys from Fraunhofer-VBR files:
2378     ['VBR_seek_offsets'], ['VBR_seek_offsets_stride'],
2379     ['VBR_offsets_relative'] and ['VBR_offsets_absolute']
2380   ¤ Added ID3v1matchesID3v2() function and implemented in
2381     getid3.check.php (thanks to "Guest" in the forums for the idea)
2382   Changed amount of data read in getid3.getimagesize.php from 10kB
2383     to entire file. (thanks mikeØftl*com)
2384   Wrapped function_exists() checks around function definitions in
2385     getid3.functions.php
2386   Fixed a lot of E_WARNING and E_NOTICE situations, especially in
2387     ID3-writing code (getid3.putid3.php, etc)
2388   Added checks to make sure all needed data is available for writing
2389     ID3v2 tags
23921.4.1b5: [May-30-2002] James Heinrich
2393   * Bugfix: Unsynchronise() was broken, now fixed
2394     (thanks mikeØftl*com)
2395   * Bugfix: GenerateID3v2Tag() now correctly uses non-synchsafe
2396     integers for frame size descriptors in ID3v2.3 and ID3v2.2
2397     (thanks mikeØftl*com)
2398   ¤ Added ['artist'], ['title'], etc keys to root of returned
2399     array to provide a common place to access any returned info
2400     from any file type. Currently gets info from ID3v1, ID3v2,
2401     Ogg, and RIFF/WAVE. Possible returned keys are:
2402     title, artist, album, year, genre, comment, track
2403   ¤ Modified LookupGenre() function to search for either genre based
2404     on numeric ID, or now reverse lookup as well
2405   ¤ Added ['artist'], ['title'], etc keys to ['RIFF'] information
2406     if info tags are present
2407   Added functionality to attach a picture to the ID3v2 tag in
2408     getid3.write.php
2409   Sorted genres into alphabetical order (special 3 at end of list)
2410     in getid3.write.php
2411   Changed the comment-edit field in getid3.write.php to a multi-line
2412     <textarea> from a single-line <input>
2413   getid3.write.php now only writes ID3v2 frames that have data
2414   Added default TXXX field to getid3.write.php to put a tagger info
2415     field when writing ID3v2 tags. Description is "ID3v2-tagged by"
2416     and data is "getID3() v[version] (www.silisoftware.com)"
2417   Changed getid3.check.php to use the new common info keys
2418   Improved file-format detection in getid3.check.php - if the auto-
2419     detect based on the first few bytes of the file doesn't find a
2420     known format (for example if the header is corrupt), a more
2421     thorough scan is done based on the file extension
2422   Added 'Edit ID3' link from getid3.check.php to getid3.write.php for
2423     MP3 files  (thanks maxØgutalin*com for the idea)
2424   Added 'Delete file' link from getid3.check.php to getid3.write.php
2425     allowing you to permanently delete a file (be careful with this!!)
2426     (thanks maxØgutalin*com for the idea)
2427   Added some mouse-over titles for links in getid3.check.php
24301.4.1b4: [May-15-2002] James Heinrich
2431   * Bugfix: getid3.check.php wasn't parsing MP3s with invalid headers
2432     or padding at the beginning of the file - added 'assumeFormat'
2433     parameter and 'Parse this file as:' options to force parsing in a
2434     particular format  (thanks Alcohol for the sample file)
2435   * Bugfix: unset(['fileformat']) and ['error'] added in cases where
2436     file cannot be parsed in the assumed or forced format
24391.4.1b3: [May-01-2002] James Heinrich
2440   ¤ For Ogg files, now calculates the real average bitrate (returned
2441     in ['ogg']['bitrate_average']) and so the playtime of the file is
2442     calculated on actual average bitrate, not nominal bitrate, so it
2443     should be accurate now  (thanks to stephaneØtekartists*com for
2444     telling me it was wrong)
2445   * Bugfix: ID3v2FrameIsAllowed() wasn't behaving properly if the
2446     writing functions were called for more than one file, because of
2447     the static array not being cleared between uses. This is an
2448     updated fix because the one in 1.4.1b2 didn't work :o)
2449     (thanks soulcatcherØevilsoft*org and yoyo)
2450   Added rawurlencode() to the filename parameter in table_var_dump()
2451     for images (wouldn't work with path/file names containing special
2452     characters (#, &, ", +)  (thanks Christian Fritz)
2453   getid3.check.php no longer attempts to scan all MIDI tracks in
2454     directory-browse mode, since this can take a long time. Detailed
2455     single-file view is still fully scanned (new third parameter for
2456     getMIDIHeaderFilepointer() controls this)
2457   Small improvements to MoreNaturalSort()
24601.4.1b2: [April-18-2002] James Heinrich
2461   ¤ GetAllMP3Info()'s 2nd parameter has changed from boolean to string
2462     (now specifying the parse-this-file-as-this format, like 'mp3',
2463     but also can be FALSE to mean don't assume any format, auto-detect
2464     only), and a third parameter (array containing allowed formats)
2465     has been added. The assumedFormat parameter allows a file to be
2466     forced to be parsed as a certain format rather than relying on the
2467     auto-detection of getID3() (ex: an MP3 wrapped in a RIFF/WAV
2468     header will be auto-detected as RIFF/WAV, but if forced to parse
2469     as MP3 will extract the original MP3 information)
2470     (thanks reel_tazØusers*sourceforge*net)
2471   * Bugfix: ID3v2FrameIsAllowed() wasn't behaving properly if the
2472     writing functions were called for more than one file, because of
2473     the static array not being cleared between uses (thanks yoyo)
2474   * Bugfix: Lyrics3 data wasn't being properly copied from the ['raw']
2475     keys to the easy keys (['title'], etc.)  (thanks Christian Fritz)
2476   * Bugfix: some testing code was accidentally left in
2477     getid3.thumbnail.php  (thanks Christian Fritz)
2478   * Bugfix: RIFF/WAVE files are now more likely to have all their
2479     chunks parsed.
2480   * Bugfix: RIFF/WAVE bitrate & playtime now better calculated
2481   * Bugfix: MP3 scanning for synch doesn't go beyond 64k now, to stop
2482     intensive scanning through large file that don't have a synch
2483     (thanks soulcatcherØevilsoft*org for a weird sample file)
2484   Improved performance when scanning for MP3 synch (about 600% faster
2485     if the synch is never found)
2486   ZIP files no longer return the contents of each compressed file, as
2487     that would very easily be more data than PHP could handle.
2488     (thanks davidbullockØtech-center*com)
2489   getid3.check.php now displays entries in a more natural sort order:
2490     case insensitive, ignores most punctuation, treats accented chars
2491     the same as their unaccent equivalent  (thanks mikeØftl*com)
2492   Added support for SmartSound-format RIFF files (which are regular
2493     RIFF/WAVE files with the first 4 chars changed from RIFF to SDSS)
2494   All instances of while(list() = each()) replaced with foreach()
24971.4.1b1: [April-11-2002] James Heinrich
2498   » Parses MIDI files.
2499     NOTE: very slow at parsing, much slower than any other file type
2500     NOTE: playtime is generally mostly accurate, but not always 100%
2501   » Parses ZIP files (if ZZIPlib available, and only in PHP 4.0.7RC1
2502     and later (see http://www.php.net/manual/en/ref.zip.php)
2503     NOTE: currently untested as I'm unable to find php_zip.dll for
2504     PHP/Win32 - if someone has a copy of this file, please email me:
2505     infoØgetid3Øorg
2506   » Parses JPEG files (requires GD installed)
2507   » Parses PNG files  (requires GD v1.6+ installed)
2508   » Parses GIF files  (requires GD < v1.6 installed)
2509   » For MP3s, once a valid synch is detected, the next 5 frames are
2510     also scanned for valid synch signatures, to prevent false
2511     identification of synch. For corrupt MP3 files this will be a bit
2512     slower, but hopefully produce more reliable results.
2513     (Thanks to mpdjØbtinternet*com for bringing this to my attention,
2514     and xbhoffØpacbell*net for explaining what was happening)
2515     (Thanks also to macik for helping me with MP3 frame lengths:
2517     ?board=c&action=display&num=1018474068)
2518   » The actual image data is now displayed (for JPEG, PNG and GIF
2519     images only) rather than a binary text dump in getid3.check.php
2520     (specifically table_var_dump()) for APIC frames. Made possible
2521     by the inclusion of (a modified version of) GetURLImageSize() by
2522     Filipe Laborde-Basto (www.rezox.com). You can right-click, save-as
2523     to extract the image to a file.
2524     NOTE: The actual image data is still returned in ['data']
2525   ¤ ['image_mime'], ['image_width'], ['image_height'], ['image_bytes']
2526     are now returned for APICs
2527   ¤ split parsing functions out into seperate files: lyrics3, id3v1,
2528     id3v2, mp3, ogg, riff, mpeg, midi, zip
2529   ¤ ['ogg']['bitrate_ave'] -> ['ogg']['bitrate_nominal'] (thanks to
2530     stephaneØtekartists*com for pointing out that "nominal" bitrate
2531     may actually differ significantly from the "average" bitrate)
2532     The real average bitrate seems to be only extractable by parsing
2533     the entire file and calculating the average bitrate. This is not
2534     yet an option, but hopefully in a future version of getID3()
2535   ¤ ['filename'] now returned for all files
2536   ¤ ['ogg']['date'] and ['ogg']['description'] now returned when
2537     available  (thanks stephaneØtekartists*com)
2538   ¤ ['mpeg']['audio']['crc'] now contains the CRC (if present)
2539   ¤ ['bitrate'] is now returned as a double instead of an int
2540   ¤ ['dataoffset'] is now returned for all ID3v2 frames
2541   * Bugfix: MP3 CRC presence ['mpeg']['audio']['protection'] was being
2542     reported as opposite of what it actually should be
2543   * Bugfix: MPEG videos weren't being detected (they were being
2544     parsed as MP3), and even if they were, there was a typo in
2545     getMPEGHeaderFilepointer()  (thanks Christian Fritz)
2546   * Bugfix: getid3.functions.php wasn't being included in
2547     getid3.write.php  (thanks mikeØftl*com)
2548   * Bugfix: Browse:___ directory name in getid3.check.php wasn't
2549     correct with directory names with ' and other strange characters
2550     (thanks Christian Fritz)
2551   ID3v2FrameProcessing() now checks to see if the next frame is valid
2552     after it encounters an invalid FrameID, and if the next frameID
2553     appears valid, it will just skip the current (invalid) frame and
2554     continue processing (it would previously abort at the first sign
2555     of incorrect structure)   (thanks stephaneØtekartists*com)
2556   getid3.check.php now scans filetypes based on content, not filename
2557     extension, and shows the filetype in the displayed output. Files
2558     are only scanned as MP3 if ID3v2 or MPEG-audio signatures are at
2559     the immediate beginning of the file (MP3 used to be the default
2560     format), so a corrupt file may not show up as MP3 format in the
2561     browse screen, but in detail it will scan in-depth
2562   getid3.check.php now has columns to show the presence of ID3v1,
2563     ID3v2 and Lyrics3 content
2564   Helium2 (www.helium2.com) has been known to write ID3v2.4 tags with
2565     non-synchsafe-integer framesizes, getID3() now checks for this and
2566     will override and parse the tag as ID3v2.3 if the tag would parse
2567     fine as ID3v2.3 when it's really specified as ID3v2.4  (thanks
2568     Christian Fritz for the test files)
25711.4.0b9: [April-05-2002] James Heinrich
2572   » Ogg files now return bitrate and playtime (playtime calculated
2573     from nominal bitrate and filesize, so it's only approximately
2574     accurate).  (thanks stephaneØtekartists*com for the idea)
2575   * Bugfix: ID3v1 tags were not properly being parsed - track, genre
2576     and comment fields were incorrect.  (thanks Christian Fritz)
2577   * Bugfix: getid3.check.php would not browse directories with single
2578     quotes (') or double quotes (") in the directory name.
2579     (thanks Christian Fritz)
2580   * Bugfix: Improved detection of MPEG-video files (a sample MP3 file
2581     had a false MPEG video signature at the beginning), and the MPEG-
2582     video parsing function now only looks for the MPEG-video header
2583     in the first 100k bytes of the file, to prevent needlessly
2584     scanning very large files. Also will not infinitely loop if it
2585     does not find what it's looking for.  (thanks Christian Fritz)
2586   ['error'] now returned if MP3 synch doesn't occur at beginning of
2587     file if ID3v2 not used (ie there's some kind of padding there that
2588     should not be)
2589   Reduced use of fread() in getMPEGHeaderFilepointer() (now faster)
2590   Added "file parsed in x.xxx seconds" to getid3.check.php
2591   Added "browse: <directory>" link to getid3.check.php
2592   Changed default ID3v2 majorversion from 2.4 to 2.3 in
2593     getid3.write.php because Winamp (and probably many other
2594     ID3v2-aware tools) can only read up to ID3v2.3
2595     (thanks mikeØftl*com)
25981.4.0b8: [April-04-2002] James Heinrich
2599   » Lyrics3 support added  (thanks Christian Fritz for the idea)
2600   ¤ check.php renamed to getid3.check.php
2601   ¤ write.php renamed to getid3.write.php
2602   ¤ ['id3']['id3v2']['error'] (if present) now reported in ['error']
2603   ¤ ['mpeg']['audio']['error'] (if present) now reported in ['error']
2604   * Bugfix: RoughTranslateUnicodeToASCII() was completely mangling
2605     UTF-16/UTF-16BE encoded text
2606   * Bugfix: The warning about MP3ext wasn't always showing up
2607     (thanks davidbullockØtech-center*com)
2608   getID3v1Filepointer() cleaned up & shortened
2609   Moved the include_once() statements around so that a minimum of code
2610     is included
26131.4.0b7: [April-03-2002] James Heinrich
2614   » RIFFs (specifically AVIs) are now more completely parsed,
2615     almost everything in the returned ['RIFF'] array has been moved
2616     around and/or restructured. A lot of new data is in there too -
2617     codecs, frame size, etc.
2618   ¤ Better recursive parsing of RIFFs (sub-arrays are now in the right
2619     place)
2620   * Bugfix: the isset() idea introduced in beta 5 was incorrectly
2621     implemented, such that ['asciidata'] and ['asciidescription'] were
2622     never returned - this had the side effect that ID3v2 comments were
2623     not copied to ['id3']['id3v2']['comment']  (thanks mikeØftl*com)
2624   * Bugfix: MPEG audio synch wasn't being detected, and therefore MPEG
2625     audio data not parsed, if no ID3v2 header present in an MP3
2626   ID3v1 track number only returned if greater than zero
2627   Removed !== FALSE (introduced in 1.4.0b6) from while(fread()) loops,
2628     some users were reporting problems with that syntax.
2629   Changed substr($string, 0, 1) to $string{0} syntax in most files
2630   Reformatted changelog.txt to 72-column width
26331.4.0b6: [April-01-2002] James Heinrich
2634   * Bugfix: 1.4.0b5 introduced a bug where any RIFF file other than
2635     PCM WAVE (this includes any compressed WAV, as well as all AVIs)
2636     would crash getID3()
2637   Reduced use of fread() in getOggHeaderFilepointer() for increased
2638     speed
2639   Added constant FREAD_BUFFER_SIZE for many fread() operations
2640   Added !== FALSE check to while(fread()) loops
2641     (thanks davidbullockØtech-center*com)
2642   Added more entries to RIFFwFormatTagLookup()
2643     (still looking for a good complete list)
2644   Converted use of hexdec() in getid3.lookup.php to 0x1234 notation
26471.4.0b5: [March-28-2002] James Heinrich
2648   ¤ Renamed decodeheader() to decodeMPEGaudioHeader()
2649   * Bugfix: Fixed infinite loop problem for RIFF/WAV files with
2650     unknown chunks
2651   * Bugfix: WXXX frames were incorrectly writing from ['URL'] instead
2652     of ['url']
2653   * Bugfix: RoughTranslateUnicodeToASCII() wasn't properly decoding
2654     UTF-16/UTF-16BE
2655   Changed all quoted strings from " to ' to hopefully improve speed
2656     (although benchmarks have not yet shown any significant
2657     improvement in speed)  (thanks davidbullockØtech-center*com)
2658   Improved code in check.php for dealing with symbolic links
2659     (thanks davidbullockØtech-center*com)
2660   Changed '<?' tags to '<?php'  (thanks davidbullockØtech-center*com)
2661   Added processing time indicator in check.php
2662     (ie 'directory scanned in 2.45 seconds')
2663   Replaced all instances of feof() to prevent infinite loop conditions
2664   Moved lookup portions of decodeMPEGaudioHeader() to
2665     getid3.lookup.php
2666   Replaced $arrayname[$index] with $arrayname["$index"] to avoid PHP
2667     E_NOTICEs  (thanks davidbullockØtech-center*com)
2668   Wrapped isset() around many if statements, to avoid PHP E_NOTICEs,
2669     hence improve speed (up to 30x speed improvement reported in some
2670     cases :)
26731.4.0b4: [March-26-2002] James Heinrich
2674   ¤ RIFF/WAV file format now parsed, returned under ['riff']
2675   ¤ Support for Relative Gain Adjustment in RIFF/WAV files
2676   ¤ ['channels'] (1 or 2) now returned for MP3 and WAV files
2677   ¤ ['bitrate'] now returned (in bits-per-second) at root level for
2678     MP3 and WAV files
2679   Added support for RGAD (Relative Gain ADjustment) ID3v2 frames, both
2680     reading & writing
2681     (see http://privatewww.essex.ac.uk/~djmrob/replaygain/ for details
2682     on RGAD)  (thanks Christian Fritz for the idea)
2683   Removed some test data-dumping from the ID3v2 writing functions
2684   Language code 'XXX' now returns descriptive string 'unknown' instead
2685     of NULL
2686   Seperated out comments from top of getid3.php into getid3.readme.txt
2687     and changelog.txt
2688   Split out non-lookup functions from getid3.lookup.php to
2689     getid3.functions.php
26921.4.0b3: [March-25-2002] James Heinrich
2693   ¤ ['asciidata'] for WXXX frames now returns correct information, but
2694     under ['asciidescription']  (thanks Christian Fritz)
2695   ¤ Added ['framenamelong'] to all returned frame data arrays with
2696     text description of that frame (ie 'RVA2' would return 'Relative
2697     volume adjustment (2)')  (thanks Christian Fritz)
2698   ¤ ['datalength'] is now ['indexeddatalength'] in ASPI frames (was
2699     confliciting with the all-frames ['datalength'] as introduced in
2700     v1.4.0b1
2701   ¤ ['datalength'] now returned as integer (rather than double) where
2702     possible
27051.4.0b2: [March-21-2002] James Heinrich
2706   ¤ ['mpeg']['audio']['bitrate'] now returned as int rather than
2707     double for VBR files
2708   * Bugfix: MPEG audio information wasn't being parsed on files that
2709     had neither ID3v1 or ID3v2
2710   * Bugfix: COMM/WXXX frames weren't returning 'asciidata' in
2711     ID3v2.2, which also meant the ['id3']['id3v2']['comment'] field
2712     wasn't being returned  (thanks stephaneØtekartists*com)
2713   * Bugfix: file might not be found if filename actually contains
2714     escaped chars or %xx-formatted characters
2715     (thanks reel_tazØusers*sourceforge*net)
2716   Added support for running with Register Globals turned off
2717     (thanks reel_tazØusers*sourceforge*net)
2718   Added urlencode() where needed in check.php
2719     (thanks reel_tazØusers*sourceforge*net)
2720   Fixed IE buffering/display problem in progress counter in check.php
27231.4.0b1: [March-11-2002] James Heinrich
2724   » ID3v2 writing support via WriteID3v2() in putid3.php
2725     RemoveID3v2() and RemoveID3v1() functions now available in
2726     putid3.php  All ID3v1 and ID3v2 writing functions have been moved
2727     to putid3.php and example file write.php has been added to the
2728     distribution
2729   ¤ MPEG audio frame information (bitrate, frequency, etc) now
2730     returned inside ['mpeg']['audio'] instead of just ['mpeg']
2731   ¤ MPEG video information now parsed, returned in ['mpeg']['video']
2732     Note: audio portion of video system files is not yet being parsed
2733   ¤ All flag bits are now returned as boolean rather than int or
2734     string
2735   ¤ RVA2 data now returned as an array (multiple RVA2 tags are
2736     allowed)
2737   ¤ RVA2/EQU2 description returned under ['description'] rather than
2738     ['identification']
2739   ¤ RVAD/EQUA adjustments now returned as signed integers, rather than
2740     absolute values which required you to check flag bytes
2741   ¤ RVRB/REV data no longer returns under ['reverb'] array
2742   ¤ WXXX/W???/LINK frames now return ['url'] instead of ['URL']
2743   ¤ USER now properly returns both ['language'] and ['languagename']
2744   ¤ OWNE now returns ['purchasedateunix'] as a UNIX timestamp
2745     (only if ['purchasedate'] is a valid date)
2746   ¤ ['id3']['id3v2']['padding'] now returned with information on padding
2747   ¤ ['headerlength'] now includes the initial 6 or 10 bytes of the
2748     ID3v2 header
2749   ¤ ['artist'], ['title'], ['album'], ['tracknumber'], ['genre'] now
2750     returned for easier access for Ogg files
2751   ¤ added ['datalength'] to all ID3v2 frames: length of frame data,
2752     not including frame header
2753   ¤ ['fileformat'] now returns 'id3' if there are ID3v1 or ID3v2 tags
2754     but no audio data
2755   ¤ ['fileformat'] now returns 'mpg' if it's an MPEG system (video +
2756     audio) file
2757   * Bugfix: RVAD was being parsed incorrectly
2758   * Bugfix: ['currency'] and ['purchasedate'] now correctly returned
2759     in OWNE
2760   * Bugfix: Frequncies in 'EQU2' frames were incorrectly double
2761   * Bugfix: ['bytedeviation'] and ['msdeviation'] now properly
2762     returned as integer rather than binary string for 'MLLT' frames
2763   * Bugfix: ['filename'] now properly returned for 'GEOB' frames
2764   * Bugfix: ['imagetype'] now properly returned for 'PIC' frames in
2765     ID3v2.2
2766   * Bugfix: Genre not being written if not set in WriteID3v1()
2767     (thanks reel_tazØusers*sourceforge*net)
2768   * Bugfix: Changed write mode to 'r+b' from 'a+' because ID3v1 tags
2769     were being appended instead of overwritten if they already existed
2770     (thanks reel_tazØusers*sourceforge*net)
2771   * Bugfix: open would fail on filenames containing quotes
2772     (thanks javierØcrackdealer*com)
2773   * Bugfix: various values were incorrectly returned (unneeded ord())
2774     in these frames: COMR, USER, ENCR, GRID, PRIV, SIGN
2775   * Bugfix: ASPI ['bitsperpoint'] was not correctly returned
2776   * Bugfix: RoughTranslateUnicodeToASCII() was not returning the last
2777     char for UTF-16
2778   * Bugfix: ['audiobytes'] now correctly 0 if no synch found
2779   * Bugfix: GenreLookup was incorrectly returning 'Remix' instead of
2780     'Blues' for GenreID 0
2781   Added sample directory browser to check.php
2782   Seperated out MPEGaudio-parsing functionality into
2783     getOnlyMPEGaudioInfo() which may be called directly if you don't
2784     need any ID3 parsing  (thanks djpretzelØcox*rr*com for idea)
2785   Reduced use of fread() for increased performance in
2786     getID3v1Filepointer()
2787   Added clearstatcache() before checking filesize - size after writing
2788     tag now correct
2789   Added hack for mp3Rage (www.chaoticsoftware.com) that puts
2790     ID3v2.3-formatted MIME type instead of 3-char ID3v2.2-format image
2791     type  (thanks xbhoffØpacbell*net for test file)
27941.3.2: [February-15-2002] James Heinrich
2796     POPM/POP, AENC/CRA, ENCR and GRID frame data now returned under
2797     numeric array index rather than by ownerID
2798   ¤ RVA2 frame data is now returned keyed by $channeltypeid instead of
2799     $frame_idstring
2800   ¤ WXXX/WXX frame description now returned under ['description']
2801     instead of ['data']
2802   Trailing null bytes now trimmed from frame (W??? & T???) text data
2803     (it shouldn't be there to begin with, but a sample file encoded by
2804     [unknown program] had data padded to 50 chars with null bytes,
2805     which caused ParseID3v2GenreString() to freeze).
28081.3.1: [February-13-2002] James Heinrich
2809   * Bugfix: ['playtime_seconds'] and ['playtime_string'] were not
2810     being returned
2811   * Bugfix: ['fileformat'] was incorrectly being returned as a
2812     2-element array
2813   * Bugfix: USLT wasn't being correctly parsed
2814   Improved RoughTranslateUnicodeToASCII()
2815     (thanks reel_tazØusers*sourceforge*net for Unicode test file)
28181.3.0: [February-13-2002] James Heinrich
2819   » ID3v1 writing support via WriteID3v1()
2820   ¤ MPEG audio frame information (bitrate, frequency, etc) now
2821     returned inside ['mpeg']
2822   ¤ ['mpeg']['raw'] returns the integer values of the bits for MPEG
2823     audio information as returned in ['mpeg'] by decodeheader()
2824     (thanks reel_tazØusers*sourceforge*net)
2825   ¤ 'protection', 'padding', 'private', 'copyright' and 'original' now
2826     return as boolean
2827   ¤ 'bitrate' and 'frequency' now return as int (except in special
2828     case of 'free')
2829   Language name as well as code retured where appropriate
2830     (ie 'English' and 'eng')
2831   Text frames with invalid TextEncoding value are now passed through
2832     anyway
2833   ID3v1 data (title, artist, album, year, comment) is now trimmed
2834     (no more nulls)
2835   RoughTranslateUnicodeToASCII() now uses utf8_decode() for UTF-8
28381.2.5: [January-30-2002] James Heinrich
2839   * Bugfix: Playtime calculations for VBR files were off slightly
2840     (rounding error)
2841   * Bugfix: Extended header length was incorrectly calculated
2842   * Bugfix: Genre strings such as '03' weren't being handled correctly
2843   More complete support for ID3v2.3 FrameIDs
2844   Split out getid3.frames.php (FrameID-specific parsing function)
2845   Split out getid3.lookup.php (assorted lookup-table functions)
2846   Searches for what directory getid3.*.php support files are in (must
2847     be same as getid3.php, but doesn't have to be same as main file -
2848     for example your main file could be /index.php, but including
2849     /lib/getid3/getid3.php)
2850   Simplified, tweaked, changed and/or eliminated several functions.
28531.2.4: [January-26-2002] James Heinrich
2854   » Basic support for reading Ogg-Vorbis comment tags
28571.2.3: [January-24-2002] James Heinrich
2858   » ID3v2.2.x 3-char FrameIDs are now fully parsed
2859     Note: While I've included support for 22 FrameIDs as defined in
2860     the specs, I don't have test files for all of them. If anyone
2861     knows of programs that generate any of the untested tags, please
2862     email infoØgetid3Øorg ! Here's what's tested and not:
2863       Tested: T??, COM
2864     Untested: UFI, TXX, W??, WXX, IPL, MCI, ETC, MLL, STC, ULT, SLT,
2865               RVA, EQU, REV, PIC, GEO, CNT, POP, BUF, CRM, CRA, LNK
2866   table_var_dump() now displays boolean variables as TRUE or FALSE
2867   table_var_dump() now uses htmlspecialchars() to avoid broken-table
2868     problems
28711.2.2: [January-18-2002] James Heinrich
2872   ¤ Parses ID3v2 genres into ['id3']['id3v2']['genreid'] and
2873     ['id3']['id3v2']['genrelist'] where appropriate
2874     (thanks stephaneØtekartists*com for the idea)
2875   Added ID3v2 genre abbreviations 'RX' (remix) and 'CR' (cover)
28781.2.1: [January-17-2002] James Heinrich
2879   * Bugfix: 'mp3' was being returned in ['format'], but 'zip' was
2880     being returned in ['fileformat'], both are now returned in
2881     ['fileformat']
2882   ¤ Splits ['id3']['id3v2']['track'] in the format '5/12' into
2883     ['track'] = '5' and ['totaltracks'] = '12'
2884   ¤ Enabled ['id3']['id3v2']['title'] etc for ID3v2.2.x
2885     (3-char frame names)  (thanks stephaneØtekartists*com)
2886   ¤ Changed v1.?? version number format to v1.?.?
2887   Scans through the file until it finds the MPEG synch (start of audio
2888     frame) - some files encoded by LAME 3.91 had undocumented padding
2889     after the ID3v2 header; getMP3headerFilepointer() now scans until
2890     it finds synch (or EOF)  (thanks adamØtrekjapan*com)
2891   Improved Unicode conversion in RoughTranslateUnicodeToASCII()
28941.20:  [January-15-2002] James Heinrich
2895   » Support for variable-bitrate (VBR) files, both Xing and Fraunhofer
2896     headers
2897   » All 4-character FrameIDs are now fully parsed according to the
2898     specs at http://www.id3.org/id3v2.4.0-frames.txt
2899     ¤ This means that most no longer return ['flags'] and ['data']
2900     Note: While I've included support for 30 FrameIDs as defined in
2901     the specs, I don't have test files for all of them. If anyone
2902     knows of programs that generate any of the untested tags, please
2903     email infoØgetid3Øorg ! Here's what's tested and not:
2904       Tested: UFID, T???, WXXX, USLT, SYLT, COMM, APIC, GEOB
2905     Untested: TXXX, W???, MCDI, ETCO, MLLT, SYTC, RVA2, EQU2, RVRB,
2906               PCNT, POPM, RBUF, AENC, USER, OWNE, COMR, ENCR, GRID,
2907               PRIV, SIGN, SEEK, ASPI
2908   ¤ Added 'title', 'artist', etc names to ID3v2 data (easier to access
2909     than the 4-character FrameIDs of the ID3v2 standard)
2910     (thanks jaksonØgmx.net)
2911   * Bugfix: added fclose() at end of GetAllMP3Info()
2912     (thanks stephaneØtekartists*com)
2913   * Bugfix: ID3v1 wasn't being parsed if ID3v2 wasn't present
2914     (thanks jaksonØgmx.net)
2915   * Bugfix: several flags were being parsed incorrectly (the structure
2916     had changed from ID3v2.3 to ID3v2.4) - v2.3 flags were being
2917     incorrectly parsed
2918   Much more compact implementation of decodeheader()
2919     (thanks jaksonØgmx.net for the idea)
2920   ID3v1 genres 126 through 147  (thanks jaksonØgmx.net)
2921   New table_var_dump() function in check.php
2922     (based partially on idea by jaksonØgmx.net)
2923   Seperated ID3v1 retrieval into seperate function
29261.11:  [December-23-2001] James Heinrich
2927   All functions merged into file getid3.php
2928   Updated documentation to reflect new returned information
29311.10:  [December-20-2001] James Heinrich
2932   * Bugfix: ID3v1 Track# was incorrectly being parsed whether it
2933     existed or not
2934   Changed calling procedure to recommend using
2935     GetAllMP3info($filename) from getmp3header.php
2936   Now includes check.php - example file
2937   ¤ Checks to see if file is in ZIP or MP3 format
2938     (returned in ['format'])
2939     [Ed. Note: ['fileformat'] as of v1.2.1]
29421.06:  [November-05-2001] James Heinrich
2943   * Bugfix: ID3v2.2.x frames weren't being parsed since they use
2944     6-byte rather than 10-byte headers as v2.3+ does
2945     (thanks spunkØmac*com for pointing that out)
29481.05:  [September-06-2001] James Heinrich
2949   * Bugfix: ID3v2 was being parsed even if it didn't exist
29521.04:  [July-16-2001] James Heinrich
2953   * Bugfix: typo in Extended Header section (strpad() should be
2954     str_pad()) (thanks jurroonØyahoo*com)
29571.03:  [May-07-2001] James Heinrich
2958   * Bugfix: Added missing ['id3']['id3v1']['genreid'] and
2959     ['id3']['id3v1']['genre']
29621.02:  [May-05-2001] James Heinrich
2963   ¤ Added ['getID3version']
29661.01:  [May-04-2001] James Heinrich
2967   » Added support for frame-level de-unsynchronisation (as per
2968     ID3v2.4.0 specs) in addition to ID3v2.3.x tag-level
2969     de-unsynchronisation
29721.00:  [May-04-2001] James Heinrich
2973   » Initial public release