From a31560aec4f004e58930277758f5412d86c62adc Mon Sep 17 00:00:00 2001 From: Karl 'vollmerk' Vollmer Date: Mon, 23 Apr 2007 07:31:05 +0000 Subject: it technically logs in and streams.. but thats it, complete rewrite almost everything broken --- admin/index.php | 10 +- config/ampache.cfg.php.dist | 966 +++--- docs/CHANGELOG | 5 + image.php | 33 +- images/ampache.gif | Bin 9631 -> 0 bytes images/ampache.png | Bin 0 -> 7595 bytes index.php | 12 +- lib/album.lib.php | 18 +- lib/class/access.class.php | 14 +- lib/class/album.class.php | 75 +- lib/class/artist.class.php | 42 +- lib/class/catalog.class.php | 227 +- lib/class/dba.class.php | 50 +- lib/class/error.class.php | 142 +- lib/class/flag.class.php | 16 +- lib/class/song.class.php | 90 +- lib/class/stats.class.php | 49 +- lib/class/stream.class.php | 27 +- lib/class/update.class.php | 42 +- lib/class/user.class.php | 90 +- lib/class/vainfo.class.php | 516 +++ lib/debug.lib.php | 196 +- lib/flag.php | 342 -- lib/general.lib.php | 236 +- lib/gettext.php | 10 +- lib/init.php | 208 +- lib/log.lib.php | 4 +- lib/preferences.php | 66 +- lib/song.php | 16 +- lib/stream.lib.php | 8 +- lib/themes.php | 10 +- lib/ui.lib.php | 155 +- login.php | 60 +- modules/getid3/docs/changelog.txt | 491 +++ modules/getid3/docs/dependencies.txt | 79 + modules/getid3/docs/license.commercial.txt | 27 + modules/getid3/docs/license.txt | 340 ++ modules/getid3/docs/readme.txt | 537 ++++ modules/getid3/docs/readme.windows.txt | 59 + modules/getid3/docs/structure.txt | 2261 ++++++++++++++ modules/getid3/extension.cache.dbm.php | 217 ++ modules/getid3/extension.cache.mysql.php | 177 ++ modules/getid3/getid3.php | 1598 ++++++++++ modules/getid3/module.archive.gzip.php | 296 ++ modules/getid3/module.archive.szip.php | 105 + modules/getid3/module.archive.tar.php | 231 ++ modules/getid3/module.archive.zip.php | 510 +++ modules/getid3/module.audio-video.asf.php | 1846 +++++++++++ modules/getid3/module.audio-video.flv.php | 574 ++++ modules/getid3/module.audio-video.mpeg.php | 324 ++ modules/getid3/module.audio-video.nsv.php | 210 ++ modules/getid3/module.audio-video.quicktime.php | 1529 +++++++++ modules/getid3/module.audio-video.real.php | 591 ++++ modules/getid3/module.audio-video.riff.php | 2319 ++++++++++++++ modules/getid3/module.audio-video.swf.php | 154 + modules/getid3/module.audio.aac_adif.php | 311 ++ modules/getid3/module.audio.aac_adts.php | 282 ++ modules/getid3/module.audio.ac3.php | 500 +++ modules/getid3/module.audio.au.php | 184 ++ modules/getid3/module.audio.avr.php | 135 + modules/getid3/module.audio.bonk.php | 235 ++ modules/getid3/module.audio.dts.php | 254 ++ modules/getid3/module.audio.la.php | 196 ++ modules/getid3/module.audio.lpac.php | 148 + modules/getid3/module.audio.midi.php | 552 ++++ modules/getid3/module.audio.monkey.php | 216 ++ modules/getid3/module.audio.mp3.php | 1696 ++++++++++ modules/getid3/module.audio.mpc.php | 211 ++ modules/getid3/module.audio.mpc_old.php | 107 + modules/getid3/module.audio.optimfrog.php | 468 +++ modules/getid3/module.audio.rkau.php | 101 + modules/getid3/module.audio.shorten.php | 121 + modules/getid3/module.audio.tta.php | 125 + modules/getid3/module.audio.voc.php | 240 ++ modules/getid3/module.audio.vqf.php | 164 + modules/getid3/module.audio.wavpack.php | 399 +++ modules/getid3/module.audio.xiph.php | 952 ++++++ modules/getid3/module.graphic.bmp.php | 319 ++ modules/getid3/module.graphic.gif.php | 92 + modules/getid3/module.graphic.jpeg.php | 62 + modules/getid3/module.graphic.pcd.php | 56 + modules/getid3/module.graphic.png.php | 556 ++++ modules/getid3/module.graphic.tiff.php | 215 ++ modules/getid3/module.lib.data_hash.php | 196 ++ modules/getid3/module.lib.iconv_replacement.php | 415 +++ modules/getid3/module.lib.image_size.php | 126 + modules/getid3/module.misc.iso.php | 450 +++ modules/getid3/module.tag.apetag.php | 312 ++ modules/getid3/module.tag.id3v1.php | 324 ++ modules/getid3/module.tag.id3v2.php | 3280 ++++++++++++++++++++ modules/getid3/module.tag.lyrics3.php | 270 ++ modules/getid3/write.apetag.php | 264 ++ modules/getid3/write.flac.php | 155 + modules/getid3/write.id3v1.php | 156 + modules/getid3/write.id3v2.php | 1886 +++++++++++ modules/getid3/write.lyrics3.php | 209 ++ modules/getid3/write.vorbis.php | 166 + modules/id3/changelog.txt | 2375 -------------- modules/id3/dependencies.txt | 24 - modules/id3/getid3/extension.cache.dbm.php | 222 -- modules/id3/getid3/extension.cache.mysql.php | 171 - modules/id3/getid3/getid3.lib.php | 1324 -------- modules/id3/getid3/getid3.php | 1305 -------- modules/id3/getid3/helperapps/readme.txt | 55 - modules/id3/getid3/module.archive.gzip.php | 249 -- modules/id3/getid3/module.archive.rar.php | 32 - modules/id3/getid3/module.archive.szip.php | 97 - modules/id3/getid3/module.archive.tar.php | 167 - modules/id3/getid3/module.archive.zip.php | 415 --- modules/id3/getid3/module.audio-video.asf.php | 1635 ---------- modules/id3/getid3/module.audio-video.bink.php | 70 - modules/id3/getid3/module.audio-video.flv.php | 497 --- modules/id3/getid3/module.audio-video.matroska.php | 78 - modules/id3/getid3/module.audio-video.mpeg.php | 292 -- modules/id3/getid3/module.audio-video.nsv.php | 224 -- .../id3/getid3/module.audio-video.quicktime.php | 1302 -------- modules/id3/getid3/module.audio-video.real.php | 528 ---- modules/id3/getid3/module.audio-video.riff.php | 1995 ------------ modules/id3/getid3/module.audio-video.swf.php | 153 - modules/id3/getid3/module.audio.aac.php | 538 ---- modules/id3/getid3/module.audio.ac3.php | 497 --- modules/id3/getid3/module.audio.au.php | 163 - modules/id3/getid3/module.audio.avr.php | 125 - modules/id3/getid3/module.audio.bonk.php | 213 -- modules/id3/getid3/module.audio.flac.php | 309 -- modules/id3/getid3/module.audio.la.php | 227 -- modules/id3/getid3/module.audio.lpac.php | 125 - modules/id3/getid3/module.audio.midi.php | 520 ---- modules/id3/getid3/module.audio.mod.php | 101 - modules/id3/getid3/module.audio.monkey.php | 202 -- modules/id3/getid3/module.audio.mp3.php | 1937 ------------ modules/id3/getid3/module.audio.mpc.php | 296 -- modules/id3/getid3/module.audio.ogg.php | 543 ---- modules/id3/getid3/module.audio.optimfrog.php | 408 --- modules/id3/getid3/module.audio.rkau.php | 92 - modules/id3/getid3/module.audio.shorten.php | 179 -- modules/id3/getid3/module.audio.tta.php | 107 - modules/id3/getid3/module.audio.voc.php | 205 -- modules/id3/getid3/module.audio.vqf.php | 159 - modules/id3/getid3/module.audio.wavpack.php | 372 --- modules/id3/getid3/module.graphic.bmp.php | 683 ---- modules/id3/getid3/module.graphic.gif.php | 183 -- modules/id3/getid3/module.graphic.jpg.php | 72 - modules/id3/getid3/module.graphic.pcd.php | 130 - modules/id3/getid3/module.graphic.png.php | 519 ---- modules/id3/getid3/module.graphic.svg.php | 52 - modules/id3/getid3/module.graphic.tiff.php | 221 -- modules/id3/getid3/module.misc.exe.php | 59 - modules/id3/getid3/module.misc.iso.php | 386 --- modules/id3/getid3/module.tag.apetag.php | 284 -- modules/id3/getid3/module.tag.id3v1.php | 356 --- modules/id3/getid3/module.tag.id3v2.php | 3130 ------------------- modules/id3/getid3/module.tag.lyrics3.php | 271 -- modules/id3/getid3/write.apetag.php | 228 -- modules/id3/getid3/write.id3v1.php | 104 - modules/id3/getid3/write.id3v2.php | 2038 ------------ modules/id3/getid3/write.lyrics3.php | 78 - modules/id3/getid3/write.metaflac.php | 167 - modules/id3/getid3/write.php | 592 ---- modules/id3/getid3/write.real.php | 295 -- modules/id3/getid3/write.vorbiscomment.php | 124 - modules/id3/helperapps/cygwin1.dll | Bin 971080 -> 0 bytes modules/id3/helperapps/head.exe | Bin 24064 -> 0 bytes modules/id3/helperapps/md5sum.exe | Bin 28160 -> 0 bytes modules/id3/helperapps/metaflac.exe | Bin 118784 -> 0 bytes modules/id3/helperapps/readme.txt | 47 - modules/id3/helperapps/sha1sum.exe | Bin 68096 -> 0 bytes modules/id3/helperapps/shorten.exe | Bin 60928 -> 0 bytes modules/id3/helperapps/tail.exe | Bin 35328 -> 0 bytes modules/id3/helperapps/vorbiscomment.exe | Bin 192512 -> 0 bytes modules/id3/license.txt | 340 -- modules/id3/readme.txt | 329 -- modules/id3/structure.txt | 2247 -------------- modules/id3/vainfo.class.php | 516 --- modules/vauth/auth.lib.php | 20 +- modules/vauth/init.php | 8 +- modules/vauth/session.lib.php | 20 +- play/index.php | 66 +- song.php | 150 - stats.php | 16 +- stream.php | 150 + templates/header.inc | 79 - templates/header.inc.php | 82 + templates/install.css | 37 +- templates/javascript_refresh.inc.php | 4 +- templates/show_admin_info.inc.php | 14 +- templates/show_admin_tools.inc.php | 5 +- templates/show_all_recent.inc.php | 1 + templates/show_box.inc.php | 4 +- templates/show_flagged.inc.php | 6 +- templates/show_index.inc.php | 14 +- templates/show_local_catalog_info.inc.php | 30 +- templates/show_login_form.inc | 31 +- templates/show_playtype_switch.inc.php | 10 +- templates/show_random_albums.inc.php | 6 +- templates/show_recently_played.inc.php | 6 +- templates/show_test.inc | 63 +- templates/show_user_stats.inc.php | 14 +- templates/sidebar.inc.php | 20 +- templates/subnavbar.inc.php | 4 +- test.php | 28 +- themes/classic/images/ampache.gif | Bin 9631 -> 0 bytes themes/classic/images/ampache.png | Bin 0 -> 7595 bytes themes/classic/theme.cfg.php | 56 +- 204 files changed, 33807 insertions(+), 36432 deletions(-) delete mode 100755 images/ampache.gif create mode 100644 images/ampache.png create mode 100755 lib/class/vainfo.class.php delete mode 100644 lib/flag.php create mode 100644 modules/getid3/docs/changelog.txt create mode 100644 modules/getid3/docs/dependencies.txt create mode 100644 modules/getid3/docs/license.commercial.txt create mode 100644 modules/getid3/docs/license.txt create mode 100644 modules/getid3/docs/readme.txt create mode 100644 modules/getid3/docs/readme.windows.txt create mode 100644 modules/getid3/docs/structure.txt create mode 100644 modules/getid3/extension.cache.dbm.php create mode 100644 modules/getid3/extension.cache.mysql.php create mode 100644 modules/getid3/getid3.php create mode 100644 modules/getid3/module.archive.gzip.php create mode 100644 modules/getid3/module.archive.szip.php create mode 100644 modules/getid3/module.archive.tar.php create mode 100644 modules/getid3/module.archive.zip.php create mode 100644 modules/getid3/module.audio-video.asf.php create mode 100644 modules/getid3/module.audio-video.flv.php create mode 100644 modules/getid3/module.audio-video.mpeg.php create mode 100644 modules/getid3/module.audio-video.nsv.php create mode 100644 modules/getid3/module.audio-video.quicktime.php create mode 100644 modules/getid3/module.audio-video.real.php create mode 100644 modules/getid3/module.audio-video.riff.php create mode 100644 modules/getid3/module.audio-video.swf.php create mode 100644 modules/getid3/module.audio.aac_adif.php create mode 100644 modules/getid3/module.audio.aac_adts.php create mode 100644 modules/getid3/module.audio.ac3.php create mode 100644 modules/getid3/module.audio.au.php create mode 100644 modules/getid3/module.audio.avr.php create mode 100644 modules/getid3/module.audio.bonk.php create mode 100644 modules/getid3/module.audio.dts.php create mode 100644 modules/getid3/module.audio.la.php create mode 100644 modules/getid3/module.audio.lpac.php create mode 100644 modules/getid3/module.audio.midi.php create mode 100644 modules/getid3/module.audio.monkey.php create mode 100644 modules/getid3/module.audio.mp3.php create mode 100644 modules/getid3/module.audio.mpc.php create mode 100644 modules/getid3/module.audio.mpc_old.php create mode 100644 modules/getid3/module.audio.optimfrog.php create mode 100644 modules/getid3/module.audio.rkau.php create mode 100644 modules/getid3/module.audio.shorten.php create mode 100644 modules/getid3/module.audio.tta.php create mode 100644 modules/getid3/module.audio.voc.php create mode 100644 modules/getid3/module.audio.vqf.php create mode 100644 modules/getid3/module.audio.wavpack.php create mode 100644 modules/getid3/module.audio.xiph.php create mode 100644 modules/getid3/module.graphic.bmp.php create mode 100644 modules/getid3/module.graphic.gif.php create mode 100644 modules/getid3/module.graphic.jpeg.php create mode 100644 modules/getid3/module.graphic.pcd.php create mode 100644 modules/getid3/module.graphic.png.php create mode 100644 modules/getid3/module.graphic.tiff.php create mode 100644 modules/getid3/module.lib.data_hash.php create mode 100644 modules/getid3/module.lib.iconv_replacement.php create mode 100644 modules/getid3/module.lib.image_size.php create mode 100644 modules/getid3/module.misc.iso.php create mode 100644 modules/getid3/module.tag.apetag.php create mode 100644 modules/getid3/module.tag.id3v1.php create mode 100644 modules/getid3/module.tag.id3v2.php create mode 100644 modules/getid3/module.tag.lyrics3.php create mode 100644 modules/getid3/write.apetag.php create mode 100644 modules/getid3/write.flac.php create mode 100644 modules/getid3/write.id3v1.php create mode 100644 modules/getid3/write.id3v2.php create mode 100644 modules/getid3/write.lyrics3.php create mode 100644 modules/getid3/write.vorbis.php delete mode 100644 modules/id3/changelog.txt delete mode 100644 modules/id3/dependencies.txt delete mode 100644 modules/id3/getid3/extension.cache.dbm.php delete mode 100644 modules/id3/getid3/extension.cache.mysql.php delete mode 100644 modules/id3/getid3/getid3.lib.php delete mode 100644 modules/id3/getid3/getid3.php delete mode 100644 modules/id3/getid3/helperapps/readme.txt delete mode 100644 modules/id3/getid3/module.archive.gzip.php delete mode 100644 modules/id3/getid3/module.archive.rar.php delete mode 100644 modules/id3/getid3/module.archive.szip.php delete mode 100644 modules/id3/getid3/module.archive.tar.php delete mode 100644 modules/id3/getid3/module.archive.zip.php delete mode 100644 modules/id3/getid3/module.audio-video.asf.php delete mode 100644 modules/id3/getid3/module.audio-video.bink.php delete mode 100644 modules/id3/getid3/module.audio-video.flv.php delete mode 100644 modules/id3/getid3/module.audio-video.matroska.php delete mode 100644 modules/id3/getid3/module.audio-video.mpeg.php delete mode 100644 modules/id3/getid3/module.audio-video.nsv.php delete mode 100644 modules/id3/getid3/module.audio-video.quicktime.php delete mode 100644 modules/id3/getid3/module.audio-video.real.php delete mode 100644 modules/id3/getid3/module.audio-video.riff.php delete mode 100644 modules/id3/getid3/module.audio-video.swf.php delete mode 100644 modules/id3/getid3/module.audio.aac.php delete mode 100644 modules/id3/getid3/module.audio.ac3.php delete mode 100644 modules/id3/getid3/module.audio.au.php delete mode 100644 modules/id3/getid3/module.audio.avr.php delete mode 100644 modules/id3/getid3/module.audio.bonk.php delete mode 100644 modules/id3/getid3/module.audio.flac.php delete mode 100644 modules/id3/getid3/module.audio.la.php delete mode 100644 modules/id3/getid3/module.audio.lpac.php delete mode 100644 modules/id3/getid3/module.audio.midi.php delete mode 100644 modules/id3/getid3/module.audio.mod.php delete mode 100644 modules/id3/getid3/module.audio.monkey.php delete mode 100644 modules/id3/getid3/module.audio.mp3.php delete mode 100644 modules/id3/getid3/module.audio.mpc.php delete mode 100644 modules/id3/getid3/module.audio.ogg.php delete mode 100644 modules/id3/getid3/module.audio.optimfrog.php delete mode 100644 modules/id3/getid3/module.audio.rkau.php delete mode 100644 modules/id3/getid3/module.audio.shorten.php delete mode 100644 modules/id3/getid3/module.audio.tta.php delete mode 100644 modules/id3/getid3/module.audio.voc.php delete mode 100644 modules/id3/getid3/module.audio.vqf.php delete mode 100644 modules/id3/getid3/module.audio.wavpack.php delete mode 100644 modules/id3/getid3/module.graphic.bmp.php delete mode 100644 modules/id3/getid3/module.graphic.gif.php delete mode 100644 modules/id3/getid3/module.graphic.jpg.php delete mode 100644 modules/id3/getid3/module.graphic.pcd.php delete mode 100644 modules/id3/getid3/module.graphic.png.php delete mode 100644 modules/id3/getid3/module.graphic.svg.php delete mode 100644 modules/id3/getid3/module.graphic.tiff.php delete mode 100644 modules/id3/getid3/module.misc.exe.php delete mode 100644 modules/id3/getid3/module.misc.iso.php delete mode 100644 modules/id3/getid3/module.tag.apetag.php delete mode 100644 modules/id3/getid3/module.tag.id3v1.php delete mode 100644 modules/id3/getid3/module.tag.id3v2.php delete mode 100644 modules/id3/getid3/module.tag.lyrics3.php delete mode 100644 modules/id3/getid3/write.apetag.php delete mode 100644 modules/id3/getid3/write.id3v1.php delete mode 100644 modules/id3/getid3/write.id3v2.php delete mode 100644 modules/id3/getid3/write.lyrics3.php delete mode 100644 modules/id3/getid3/write.metaflac.php delete mode 100644 modules/id3/getid3/write.php delete mode 100644 modules/id3/getid3/write.real.php delete mode 100644 modules/id3/getid3/write.vorbiscomment.php delete mode 100644 modules/id3/helperapps/cygwin1.dll delete mode 100755 modules/id3/helperapps/head.exe delete mode 100755 modules/id3/helperapps/md5sum.exe delete mode 100755 modules/id3/helperapps/metaflac.exe delete mode 100644 modules/id3/helperapps/readme.txt delete mode 100755 modules/id3/helperapps/sha1sum.exe delete mode 100755 modules/id3/helperapps/shorten.exe delete mode 100755 modules/id3/helperapps/tail.exe delete mode 100755 modules/id3/helperapps/vorbiscomment.exe delete mode 100644 modules/id3/license.txt delete mode 100644 modules/id3/readme.txt delete mode 100644 modules/id3/structure.txt delete mode 100755 modules/id3/vainfo.class.php delete mode 100644 song.php create mode 100644 stream.php delete mode 100644 templates/header.inc create mode 100644 templates/header.inc.php delete mode 100755 themes/classic/images/ampache.gif create mode 100644 themes/classic/images/ampache.png diff --git a/admin/index.php b/admin/index.php index 96f2616f..99631f29 100644 --- a/admin/index.php +++ b/admin/index.php @@ -20,7 +20,7 @@ */ -require ('../lib/init.php'); +require '../lib/init.php'; $action = scrub_in($_REQUEST['action']); @@ -29,12 +29,12 @@ if (!$GLOBALS['user']->has_access(100)) { exit(); } - -show_template('header'); ?> +require_once Config::get('prefix') . '/templates/header.inc.php'; +?>
- +
- +
diff --git a/config/ampache.cfg.php.dist b/config/ampache.cfg.php.dist index 2495d2b6..b41002b2 100644 --- a/config/ampache.cfg.php.dist +++ b/config/ampache.cfg.php.dist @@ -1,539 +1,499 @@ -#### -#################### -# General Config # -#################### - -# This value is used to detect quickly -# if this config file is up to date -# this is compared against a value hardcoded -# into the init script +;### +;################### +; General Config # +;################### + +; This value is used to detect quickly +; if this config file is up to date +; this is compared against a value hardcoded +; into the init script config_version = 2 -#################### -# Path Vars # -#################### - -# The path to your ampache install -# Do not put a trailing / on this path -# For example if your site is located at http://localhost -# than you do not need to enter anything for the web_path -# if it is located at http://localhost/music you need to -# set web_path to /music -# DEFAULT: "" -#web_path = "" - -############################### -# Session and Login Variables # -############################### - -# Hostname of your Database -# DEFAULT: localhost -local_host = localhost - -# Name of your ampache database -# DEFAULT: ampache -local_db = ampache - -# Username for your ampache database -# DEFAULT: "" -local_username = username - -# Password for your ampache database, this can not be blank -# this is a 'forced' security precaution, the default value -# will not work -# DEFAULT: "" -local_pass = password - -# Length that a session will last, the default is very restrictive -# at 15min -# DEFAULT: 900 -local_length = 900 - -# This length defines how long a 'remember me' session and cookie will -# last, the default is 900, same as length. It is up to the administrator -# of the box to increase this, for reference 86400 = 1 day -# 604800 = 1 week and 2419200 = 1 month -# DEAFULT: 900 +;################### +; Path Vars # +;################### + +; The path to your ampache install +; Do not put a trailing / on this path +; For example if your site is located at http://localhost +; than you do not need to enter anything for the web_path +; if it is located at http://localhost/music you need to +; set web_path to /music +; DEFAULT: "" +;web_path = "" + +;############################## +; Session and Login Variables # +;############################## + +; Hostname of your Database +; DEFAULT: localhost +database_hostname = localhost + +; Name of your ampache database +; DEFAULT: ampache +database_name = ampache + +; Username for your ampache database +; DEFAULT: "" +database_username = username + +; Password for your ampache database, this can not be blank +; this is a 'forced' security precaution, the default value +; will not work +; DEFAULT: "" +database_password = password + +; Length that a session will last, the default is very restrictive +; at 15min +; DEFAULT: 900 +session_length = 900 + +; This length defines how long a 'remember me' session and cookie will +; last, the default is 900, same as length. It is up to the administrator +; of the box to increase this, for reference 86400 = 1 day +; 604800 = 1 week and 2419200 = 1 month +; DEAFULT: 900 remember_length = 900 -# Name of the Session/Cookie that will sent to the browser -# default should be fine -# DEFAULT: ampache -sess_name = ampache - -# Lifetime of the Cookie, 0 == Forever (until browser close) , otherwise in terms of seconds -# DEFAULT: 0 -sess_cookielife = 0 - -# Is the cookie a "secure" cookie? -# DEFAULT: 0 -sess_cookiesecure = 0 - -# Auth Methods -# This defines which auth methods vauth will attempt -# to use and in which order, if auto_create isn't enabled -# The user must exist locally as well -# DEFAULT: mysql -# VALUES: mysql,ldap,http -#auth_methods = "ldap" +; Name of the Session/Cookie that will sent to the browser +; default should be fine +; DEFAULT: ampache +session_name = ampache + +; Lifetime of the Cookie, 0 == Forever (until browser close) , otherwise in terms of seconds +; DEFAULT: 0 +session_cookielife = 0 + +; Is the cookie a "secure" cookie? +; DEFAULT: 0 +session_cookiesecure = 0 + +; Auth Methods +; This defines which auth methods vauth will attempt +; to use and in which order, if auto_create isn't enabled +; The user must exist locally as well +; DEFAULT: mysql +; VALUES: mysql,ldap,http auth_methods = "mysql" -###################### -# Program Settings # -###################### +;##################### +; Program Settings # +;##################### -# File Pattern -# This defines which file types Ampache will attempt to catalog -# You can specify any file extension you want in here seperating them -# with a | -# DEFAULT: mp3|mpc|m4p|m4a|mp4|aac|ogg|rm|wma|asf|flac|spx|ra|ape|shn|wv +; File Pattern +; This defines which file types Ampache will attempt to catalog +; You can specify any file extension you want in here seperating them +; with a | +; DEFAULT: mp3|mpc|m4p|m4a|mp4|aac|ogg|rm|wma|asf|flac|spx|ra|ape|shn|wv catalog_file_pattern = "mp3|mpc|m4p|m4a|mp4|aac|ogg|rm|wma|asf|flac|spx|ra|ape|shn|wv" -# Use Access List -# Toggle this on if you want ampache to pay attention to the access list -# and only allow streaming/downloading/xml-rpc from known hosts by default -# xml-rpc will not working without this on. -# DEFAULT: false -#access_control = "false" - -# Require Session -# If this is set to true ampache will make sure that the URL passed when -# attempting to retrieve a song contains a valid Session ID This prevents -# others from guessing URL's -# DEFAULT: true +; Use Access List +; Toggle this on if you want ampache to pay attention to the access list +; and only allow streaming/downloading/xml-rpc from known hosts by default +; xml-rpc will not working without this on. +; DEFAULT: false +;access_control = "false" + +; Require Session +; If this is set to true ampache will make sure that the URL passed when +; attempting to retrieve a song contains a valid Session ID This prevents +; others from guessing URL's +; DEFAULT: true require_session = "true" -# Downsample Remote -# If this is set to true and access control is on any users who are not -# coming from a defined localnet will be automatically downsampled -# regardless of their preferences -# DEFAULT: false -#downsample_remote = "false" - -# Track User IPs -# If this is enabled Ampache will log the IP of every completed login -# it will store user,ip,time at one row per login. The results are -# displayed in Admin --> Users -# DEFAULT: false -#track_user_ip = "false" - -# User IP Cardinality -# This defines how many days worth of IP history Ampache will track -# As it is one row per login on high volume sites you will want to -# clear it every now and then. -# DEFAULT: 42 days -#user_ip_cardinality = "42" - -# Use XML-RPC -# Allow XML-RPC connections, if you don't want _any_ possibility of your -# catalog being streamed from another location comment this out -# DEFAULT: false -#xml_rpc = "false" - -# This setting allows/disallows using zlib to zip up an entire -# playlist/album for download. Even if this is turned on you will -# still need to enabled downloading for the specific user you -# want to be able to use this function -# DEFAULT: false -#allow_zip_download = "false" - -# This setting throttles a persons downloading to the specified -# bytes per second. This is not a 100% guaranteed function, and -# you should really use a server based rate limiter if you want -# to do this correctly. -# DEFAULT: off -# VALUES: any whole number (in bytes per second) -#throttle_download = 10 - -# This determines the tag order for all cataloged -# music. If none of the listed tags are found then -# ampache will default to the first tag format -# that was found. -# POSSIBLE VALUES: id3v1 id3v2 file vorbiscomment -# quicktime ape asf -# DEFAULT: id3v2,id3v1 vorbiscomment quicktime ape -# asf -tag_order = id3v2 -tag_order = id3v1 -tag_order = vorbiscomment -tag_order = quicktime -tag_order = ape -tag_order = asf -#tag_order = file - -# Un comment if don't want ampache to follow symlinks -# DEFAULT: false -#no_symlinks = "false" - -# Use auth? -# If this is set to "Yes" ampache will require a valid -# Username and password. If this is set to false then ampache -# will not ask you for a username and password. false is only -# recommended for internal only instances -# DEFAULT true +; Downsample Remote +; If this is set to true and access control is on any users who are not +; coming from a defined localnet will be automatically downsampled +; regardless of their preferences +; DEFAULT: false +;downsample_remote = "false" + +; Track User IPs +; If this is enabled Ampache will log the IP of every completed login +; it will store user,ip,time at one row per login. The results are +; displayed in Admin --> Users +; DEFAULT: false +;track_user_ip = "false" + +; User IP Cardinality +; This defines how many days worth of IP history Ampache will track +; As it is one row per login on high volume sites you will want to +; clear it every now and then. +; DEFAULT: 42 days +;user_ip_cardinality = "42" + +; Use XML-RPC +; Allow XML-RPC connections, if you don't want _any_ possibility of your +; catalog being streamed from another location comment this out +; DEFAULT: false +;xml_rpc = "false" + +; This setting allows/disallows using zlib to zip up an entire +; playlist/album for download. Even if this is turned on you will +; still need to enabled downloading for the specific user you +; want to be able to use this function +; DEFAULT: false +;allow_zip_download = "false" + +; This setting throttles a persons downloading to the specified +; bytes per second. This is not a 100% guaranteed function, and +; you should really use a server based rate limiter if you want +; to do this correctly. +; DEFAULT: off +; VALUES: any whole number (in bytes per second) +;throttle_download = 10 + +; This determines the tag order for all cataloged +; music. If none of the listed tags are found then +; ampache will default to the first tag format +; that was found. +; POSSIBLE VALUES: id3v1 id3v2 file vorbiscomment +; quicktime ape asf +; DEFAULT: id3v2,id3v1 vorbiscomment quicktime ape +; asf +tag_order = "id3v2,id3v1,vorbiscomment,quicktime,ape,asf" + +; Un comment if don't want ampache to follow symlinks +; DEFAULT: false +;no_symlinks = "false" + +; Use auth? +; If this is set to "Yes" ampache will require a valid +; Username and password. If this is set to false then ampache +; will not ask you for a username and password. false is only +; recommended for internal only instances +; DEFAULT true use_auth = "yes" -# 5 Star Ratings -# This allows ratings for almost any object in ampache -# POSSIBLE VALUES: false true -# DEFAULT: true +; 5 Star Ratings +; This allows ratings for almost any object in ampache +; POSSIBLE VALUES: false true +; DEFAULT: true ratings = "true" -# This options will turn on/off Demo Mode -# If Demo mode is on you can not play songs or update your catalog -# in other words.. leave this commented out -# DEFAULT: false -#demo_mode = "false" - -# Memory Limit -# This defines the "Min" memory limit for PHP if your php.ini -# has a lower value set Ampache will set it up to this. If you -# set it below 16MB getid3() will not work! -# DEFAULT: 24 -#memory_limit = 24 - -# Album Art Preferred Filename -# Specify a filename to look for if you always give the same filename -# i.e. "folder.jpg" Ampache currently only supports jpg/gif and png -# Especially useful if you have a front and a back image in a folder -# comment out if ampache should search for any jpg,gif or png -# DEFAULT: folder.jpg -#album_art_preferred_filename = "folder.jpg" - -# Resize Images * Requires PHP-GD * -# Set this to true if you want Ampache to resize the Album -# art on the fly, this increases load time and CPU usage -# and also requires the PHP-GD library. This is very useful -# If you have high-quality album art and a small upload cap -# DEFAULT: false -#resize_images = "false" - -# Album Art Gather Order -# Simply arrange the following in the order you would like -# ampache to search if you want to disable one of the search -# method simply comment it out valid values are -# POSSIBLE VALUES: db id3 folder amazon -# DEFAULT: db,id3,folder,amazon -album_art_order = "db" -album_art_order = "id3" -album_art_order = "folder" -album_art_order = "amazon" - -# Album Art -# Set this to true if you want album art displayed on pages besides the -# Single Album view, if you have a slow machine, or limited bandwidth -# turning this off can vastly improve performance -# DEFAULT: true +; This options will turn on/off Demo Mode +; If Demo mode is on you can not play songs or update your catalog +; in other words.. leave this commented out +; DEFAULT: false +;demo_mode = "false" + +; Memory Limit +; This defines the "Min" memory limit for PHP if your php.ini +; has a lower value set Ampache will set it up to this. If you +; set it below 16MB getid3() will not work! +; DEFAULT: 24 +;memory_limit = 24 + +; Album Art Preferred Filename +; Specify a filename to look for if you always give the same filename +; i.e. "folder.jpg" Ampache currently only supports jpg/gif and png +; Especially useful if you have a front and a back image in a folder +; comment out if ampache should search for any jpg,gif or png +; DEFAULT: folder.jpg +;album_art_preferred_filename = "folder.jpg" + +; Resize Images * Requires PHP-GD * +; Set this to true if you want Ampache to resize the Album +; art on the fly, this increases load time and CPU usage +; and also requires the PHP-GD library. This is very useful +; If you have high-quality album art and a small upload cap +; DEFAULT: false +;resize_images = "false" + +; Album Art Gather Order +; Simply arrange the following in the order you would like +; ampache to search if you want to disable one of the search +; method simply comment it out valid values are +; POSSIBLE VALUES: db id3 folder amazon +; DEFAULT: db,id3,folder,amazon +album_art_order = "db,id3,folder,amazon" + +; Album Art +; Set this to true if you want album art displayed on pages besides the +; Single Album view, if you have a slow machine, or limited bandwidth +; turning this off can vastly improve performance +; DEFAULT: true show_album_art = "true" -# Amazon Developer Key -# This is needed in order to actually use the amazon album art -# DEFAULT: false -#amazon_developer_key = "" - -# Amazon base urls -# An array of Amazon sites to search. -# NOTE: This will search each of these sites in turn so don't expect it -# to be lightening fast! -# It is strongly recommended that only one of these is selected at any -# one time -# Default: Just the US (.com) +; Amazon Developer Key +; This is needed in order to actually use the amazon album art +; DEFAULT: false +;amazon_developer_key = "" + +; Amazon base urls +; An array of Amazon sites to search. +; NOTE: This will search each of these sites in turn so don't expect it +; to be lightening fast! +; It is strongly recommended that only one of these is selected at any +; one time +; POSSIBLE VALUES: +; http://webservices.amazon.com +; http://webservices.amazon.co.uk +; http://webservices.amazon.de +; http://webservices.amazon.co.jp +; http://webservices.amazon.fr +; http://webservices.amazon.ca +; Default: http://webservices.amazon.com amazon_base_urls = "http://webservices.amazon.com" -#amazon_base_urls = "http://webservices.amazon.co.uk" -#amazon_base_urls = "http://webservices.amazon.de" -#amazon_base_urls = "http://webservices.amazon.co.jp" -#amazon_base_urls = "http://webservices.amazon.fr" -#amazon_base_urls = "http://webservices.amazon.ca" - -# max_amazon_results_pages -# The maximum number of results pages to pull from EACH amazon site -# NOTE: The art search pages through the results returned by your search -# up to this number of pages. As with the base_urls above, this is going -# to take more time, the more pages you ask it to process. -# Of course a good search will return only a few matches anyway. -# It is strongly recommended that you do _not_ change this value -# DEFAULT: 1 page (10 items) + +; max_amazon_results_pages +; The maximum number of results pages to pull from EACH amazon site +; NOTE: The art search pages through the results returned by your search +; up to this number of pages. As with the base_urls above, this is going +; to take more time, the more pages you ask it to process. +; Of course a good search will return only a few matches anyway. +; It is strongly recommended that you do _not_ change this value +; DEFAULT: 1 page (10 items) max_amazon_results_pages = 1 -# Debug -# If this is enabled Ampache will get really chatty -# warning this can crash browser during catalog builds due to -# the amount of text that is dumped out this will also cause -# ampache to write to the log file -# DEFAULT: false -#debug = "false" - -# Debug Level -# This should always be set in conjunction with the -# debug option, it defines how prolific you want the -# debugging in ampache to be. values are 1-5. -# 1 == Errors only -# 2 == Error + Failures (login attempts etc.) -# 3 == ?? -# 4 == ?? (Profit!) -# 5 == Information (cataloging progress etc.) -# DEFAULT: 5 +; Debug +; If this is enabled Ampache will get really chatty +; warning this can crash browser during catalog builds due to +; the amount of text that is dumped out this will also cause +; ampache to write to the log file +; DEFAULT: false +;debug = "false" + +; Debug Level +; This should always be set in conjunction with the +; debug option, it defines how prolific you want the +; debugging in ampache to be. values are 1-5. +; 1 == Errors only +; 2 == Error + Failures (login attempts etc.) +; 3 == ?? +; 4 == ?? (Profit!) +; 5 == Information (cataloging progress etc.) +; DEFAULT: 5 debug_level = 5 -# Path to Log File -# This defines where you want ampache to log events to -# this will only happen if debug is turned on. Do not -# include trailing slash. You will need to make sure that -# your HTTP server has write access to the specified directory -# DEFAULT: NULL -#log_path = "/var/log/ampache" - -# Charset of generated HTML pages -# Default of UTF-8 should work for most people -# DEFAULT: UTF-8 +; Path to Log File +; This defines where you want ampache to log events to +; this will only happen if debug is turned on. Do not +; include trailing slash. You will need to make sure that +; your HTTP server has write access to the specified directory +; DEFAULT: NULL +;log_path = "/var/log/ampache" + +; Charset of generated HTML pages +; Default of UTF-8 should work for most people +; DEFAULT: UTF-8 site_charset = UTF-8 -# Locale Charset -# In some cases this has to be different -# in order for XHTML and other things to work -# This is disabled by default, enabled only -# if needed. It's specifically needed for Russian -# so that is the default -# DEFAULT: cp1251 -#lc_charset = cp1251 - -# Refresh Limit -# This defines the default refresh limit in seconds for -# pages with dynamic content, such as now playing -# DEFAULT: 60 -# Possible Values: Int > 5 +; Locale Charset +; In some cases this has to be different +; in order for XHTML and other things to work +; This is disabled by default, enabled only +; if needed. It's specifically needed for Russian +; so that is the default +; DEFAULT: cp1251 +;lc_charset = cp1251 + +; Refresh Limit +; This defines the default refresh limit in seconds for +; pages with dynamic content, such as now playing +; DEFAULT: 60 +; Possible Values: Int > 5 refresh_limit = "60" -########################################################## -# LDAP login info (optional) # -########################################################## - -# This setting will silently create an ampache account -# for anyone who can login using ldap (or any other login -# extension) -# DEFAULT: false -#auto_create = "false" - -# LDAP filter string to use -# For OpenLDAP use "uid" -# For Microsoft Active Directory (MAD) use "sAMAccountName" -# DEFAULT: null -# ldap_filter = "uid" -# ldap_filter = "sAMAccountName" - -# LDAP objectclass it's required so if you don't know use * -# OpanLDAP objectclass = "*" -# MAD objectclass = "organizationalPerson" -# DEFAULT null -#ldap_objectclass = "*" -#ldap_objectclass = "organizationalPerson" - -# if this is the case, fill these in here: -# DEFAULT: null -#ldap_username = "" -#ldap_password = "" - -# NOT YET IMPLEMENTED!! -# This option checks to see if the specified user is in -# a specific ldap group, allowing you to give access based -# on group membership -# DEFAULT: null -#ldap_require_group = "cn=yourgroup,ou=yourorg,dc=yoursubdomain,dc=yourdomain,dc=yourtld" - -# This is the search dn used to find your user, uid=username is added on to -# This string -# DEFAULT: null -#ldap_search_dn = "ou=People,dc=yoursubdomain,dc=yourdomain,dc=yourtld" - -# This is the address of your ldap server -# DEFAULT: null -#ldap_url = "" - -# Specify where in your ldap db the following fields are stored: -# (comment out if you don't have them) -# OpenLDAP: ldap_name_field = "cn" -# MAD ldap_name_field = "displayname" -# DEFAULT: [none] -#ldap_email_field = "mail" -#ldap_name_field = "cn" - -########################################################## -# Public Registration settings, defaults to disabled # -########################################################## - -# This setting turns on/off public registration. It is -# recommended you leave this off, as it will allow anyone to -# sign up for an account on your server. -# REMEMBER: don't forget to set the mail from address further down in the config. -# DEFAULT: false -#allow_public_registration = "false" - -# Require Captcha Text on Image confirmation -# Turning this on requires the user to correctly -# type in the letters in the image created by Captcha -# Default is off because its very hard to detect if it failed -# to draw, or they failed to enter it. -# DEFAULT: false -#captcha_public_reg = "false" - -# This setting defines the mail domain your in. -# It tries to deliver a test mail before the user can register and uses -# the from address info@"domain.tld". No mail is send from this address it's -# only used to test the existence of a mailbox before accepting user registration. -# DEFAULT: domain.tld -#mail_domain = "domain.tld" - -# This setting will be used as mail from address. -# It will also be used to notify if a registration occurred. -# You need to change this when you activate public_registration. -#mail_from = "info@domain.tld" - -# This setting turns on/off admin notify off registration. -# DEFAULT: false -#admin_notify_reg = "false" - -# This setting will allow all registrants to be auto-approved -# as a user. By default, they will be added as a guest and -# must be "promoted" by the admin. -# POSSIBLE VALUES: guest, user, admin -# DEFAULT: guest -#auto_user = "guest" - -# This will display the user agreement when registering -# For agreement text, edit templates/user_agreement.php -# User will need to accept the agreement before they can register -# DEFAULT: false -#user_agreement = "false" - -######################################################### -# These options control the dynamic down-sampling based # -# on current usage # -# *Note* Down-sampling must be enabled and working # -######################################################### - -# Attempt to optimize bandwidth by dynamically down-sampling -# all connections from users to fit within a maximum bandwidth. -# The benefit is that it won't downsample more than it needs to. As it only -# adjusts the sample rate at the beginning of a song, it may take a few -# minutes to reset all connections to a lower rate. This won't never go higher -# than a user's sample rate and only applies to users who are set to -# the Downsample playback method -# DEFAULT: 576 -#max_bit_rate = 576 - -# If min_bit_rate is set then new streams will be denied if it would -# cause all streams to be down-sampled below this rate. -# DEFAULT: 48 -#min_bit_rate = 48 - - -####################################################### -# These options control how searching works # -####################################################### - -# choices are: artist,album,song_title,song_genre,song_year,song_bitrate,song_min_bitrate,song_filename -# DEFAULT: song_title +;######################################################### +; LDAP login info (optional) # +;######################################################### + +; This setting will silently create an ampache account +; for anyone who can login using ldap (or any other login +; extension) +; DEFAULT: false +;auto_create = "false" + +; LDAP filter string to use +; For OpenLDAP use "uid" +; For Microsoft Active Directory (MAD) use "sAMAccountName" +; DEFAULT: null +; ldap_filter = "sAMAccountName" + +; LDAP objectclass it's required so if you don't know use * +; OpanLDAP objectclass = "*" +; MAD objectclass = "organizationalPerson" +; DEFAULT null +;ldap_objectclass = "organizationalPerson" + +; if this is the case, fill these in here: +; DEFAULT: null +;ldap_username = "" +;ldap_password = "" + +; NOT YET IMPLEMENTED!! +; This option checks to see if the specified user is in +; a specific ldap group, allowing you to give access based +; on group membership +; DEFAULT: null +;ldap_require_group = "cn=yourgroup,ou=yourorg,dc=yoursubdomain,dc=yourdomain,dc=yourtld" + +; This is the search dn used to find your user, uid=username is added on to +; This string +; DEFAULT: null +;ldap_search_dn = "ou=People,dc=yoursubdomain,dc=yourdomain,dc=yourtld" + +; This is the address of your ldap server +; DEFAULT: null +;ldap_url = "" + +; Specify where in your ldap db the following fields are stored: +; (comment out if you don't have them) +; OpenLDAP: ldap_name_field = "cn" +; MAD ldap_name_field = "displayname" +; DEFAULT: [none] +;ldap_email_field = "mail" +;ldap_name_field = "cn" + +;######################################################### +; Public Registration settings, defaults to disabled # +;######################################################### + +; This setting turns on/off public registration. It is +; recommended you leave this off, as it will allow anyone to +; sign up for an account on your server. +; REMEMBER: don't forget to set the mail from address further down in the config. +; DEFAULT: false +;allow_public_registration = "false" + +; Require Captcha Text on Image confirmation +; Turning this on requires the user to correctly +; type in the letters in the image created by Captcha +; Default is off because its very hard to detect if it failed +; to draw, or they failed to enter it. +; DEFAULT: false +;captcha_public_reg = "false" + +; This setting defines the mail domain your in. +; It tries to deliver a test mail before the user can register and uses +; the from address info@"domain.tld". No mail is send from this address it's +; only used to test the existence of a mailbox before accepting user registration. +; DEFAULT: domain.tld +;mail_domain = "domain.tld" + +; This setting will be used as mail from address. +; It will also be used to notify if a registration occurred. +; You need to change this when you activate public_registration. +;mail_from = "info@domain.tld" + +; This setting turns on/off admin notify off registration. +; DEFAULT: false +;admin_notify_reg = "false" + +; This setting will allow all registrants to be auto-approved +; as a user. By default, they will be added as a guest and +; must be "promoted" by the admin. +; POSSIBLE VALUES: guest, user, admin +; DEFAULT: guest +;auto_user = "guest" + +; This will display the user agreement when registering +; For agreement text, edit templates/user_agreement.php +; User will need to accept the agreement before they can register +; DEFAULT: false +;user_agreement = "false" + +;######################################################## +; These options control the dynamic down-sampling based # +; on current usage # +; *Note* Down-sampling must be enabled and working # +;######################################################## + +; Attempt to optimize bandwidth by dynamically down-sampling +; all connections from users to fit within a maximum bandwidth. +; The benefit is that it won't downsample more than it needs to. As it only +; adjusts the sample rate at the beginning of a song, it may take a few +; minutes to reset all connections to a lower rate. This won't never go higher +; than a user's sample rate and only applies to users who are set to +; the Downsample playback method +; DEFAULT: 576 +;max_bit_rate = 576 + +; If min_bit_rate is set then new streams will be denied if it would +; cause all streams to be down-sampled below this rate. +; DEFAULT: 48 +;min_bit_rate = 48 + + +;###################################################### +; These options control how searching works # +;###################################################### + +; choices are: artist,album,song_title,song_genre,song_year,song_bitrate,song_min_bitrate,song_filename +; DEFAULT: song_title search_field = song_title -# choices are: exact,fuzzy -# DEFAULT: fuzzy +; choices are: exact,fuzzy +; DEFAULT: fuzzy search_type = fuzzy -####################################################### -# This option controls what Ampache sends for the Stream name. This -# is most valuable when then 'Type of Playback' is set to downsample. -# because lame seems to strip id3 tags. if you want the Ampache default -# just leave this option commented out. -# -# the format supports the following options: -# -# %A = album name -# %a = artist name -# %C = catalog path -# %c = id3 comment -# %g = genre -# %T = track number -# %t = song title -# %y = year -# %basename = current filename (just the actual filename) -# %catalog = catalog name -# %filename = current filename (full path) -# %type = song type (mp3, ogg, ...) -# -# DEFAULT: %a - %A - %t -#stream_name_format = %a - %A - %t - - -####################################################### -# These options control the down-sampling feature -# this requires you to install some applications such -# as lame that can re-encode the mp3 for you. -# we recommend mp3splt and lame -# %FILE% = filename -# %OFFSET% = offset -# %SAMPLE% = sample rate -# %EOF% = end of file in min.sec -# DEFAULT: mp3splt -qnf %FILE% %OFFSET% %EOF% -o - | lame --mp3input -q 3 -b %SAMPLE% -S - - -downsample_cmd = mp3splt -qnf %FILE% %OFFSET% %EOF% -o - | lame --mp3input -q 3 -b %SAMPLE% -S - - - -####################################################### -# These are commands used to transcode non-streaming -# formats to the target file type for streaming. Any -# file types defined here will automatically be transcoded -# using the stream_cmd_??? regardless of personal preferences -# This can be useful in re-encoding file types that don't stream -# very well, or if the player doesn't support some file types. -# REQUIRED variables -# transcode_TYPE = true -# transcode_TYPE_target = TARGET_FILE_TYPE -# stream_cmd_TYPE = TRANSCODE_COMMAND - -# List of filetypes to transcode +;###################################################### +; These are commands used to transcode non-streaming +; formats to the target file type for streaming. Any +; file types defined here will automatically be transcoded +; using the stream_cmd_??? regardless of personal preferences +; This can be useful in re-encoding file types that don't stream +; very well, or if the player doesn't support some file types. +; This is also the string used when 'downsampling' is selected +; +; REQUIRED variables +; transcode_TYPE = true/false ## True if you want to force transcode +; transcode_TYPE_target = TARGET_FILE_TYPE +; transcode_cmd_TYPE = TRANSCODE_COMMAND +; %FILE% = filename +; %OFFSET% = offset +; %SAMPLE% = sample rate +; %EOF% = end of file in min.sec + + +; List of filetypes to transcode transcode_m4a = true transcode_m4a_target = mp3 -transcode_flac = true +;transcode_flac = true transcode_flac_target = mp3 -#transcode_mpc = false -#transcode_mpc_target = mp3 - -# These are the commands that will be run to transcode the file -stream_cmd_flac = flac -dc %FILE% | lame -r -b 128 -S - - -stream_cmd_m4a = faad -f 2 -w %FILE% | lame -r -b 128 -S - - -#stream_cmd_mpc = - -####################################################### -# these options allow you to configure your rss-feed -# layout. rss exists of two parts, main and song -# main is the information about the feed -# song is the information in the feed. can be multiple -# items. -# -# use_rss = false (values true | false) -# -#DEFAULT: use_rss = false -#use_rss = false -# -# -# rss_main_title = the title for your feed. -# DEFAULT: Ampache for the love of Music +;transcode_mp3 = false +transcode_mp3_target = mp3 + +; These are the commands that will be run to transcode the file +trascode_cmd_flac = flac -dc %FILE% | lame -r -b 128 -S - - +trascode_cmd_m4a = faad -f 2 -w %FILE% | lame -r -b 128 -S - - +transcode_cmd_mp3 = mp3splt -qnf %FILE% %OFFSET% %EOF% -o - | lame --mp3input -q 3 -b %SAMPLE% -S - - + +;###################################################### +; these options allow you to configure your rss-feed +; layout. rss exists of two parts, main and song +; main is the information about the feed +; song is the information in the feed. can be multiple +; items. +; +; use_rss = false (values true | false) +; +;DEFAULT: use_rss = false +;use_rss = false +; +; +; rss_main_title = the title for your feed. +; DEFAULT: Ampache for the love of Music rss_main_title = Ampache for the love of Music -# rss_main_description = the description for your feed -# DEFAULT: Rss feed for Ampache so you can monitor who is listening to what +; rss_main_description = the description for your feed +; DEFAULT: Rss feed for Ampache so you can monitor who is listening to what rss_main_description = Rss feed for Ampache so you can monitor who is listening to what -# rss_main_copyright = here you can enter copyright information if you wish -# DEFAULT: copyright (c) Speedy B for Ampache +; rss_main_copyright = here you can enter copyright information if you wish +; DEFAULT: copyright (c) Speedy B for Ampache rss_main_copyright = copyright (c) Speedy B for Ampache -# rss_song_description = The description of the song. -# It has to start with . this is because xml wont parse if strange -# characters are used in the id3-tag -# usable items: -# $song->f_title -# $song->f_album -# $user->fullname -# $artist -# $album -# DEFAULT: f_title @ $album played by $user->fullname]]> -# FIXME it's hardcoded in lib/rss.lib.php now -#rss_song_description = f_title @ $album played by $user->fullname]]> -###################################################### +; rss_song_description = The description of the song. +; It has to start with . this is because xml wont parse if strange +; characters are used in the id3-tag +; usable items: +; $song->f_title +; $song->f_album +; $user->fullname +; $artist +; $album +; DEFAULT: f_title @ $album played by $user->fullname]]> +; FIXME it's hardcoded in lib/rss.lib.php now +;rss_song_description = f_title @ $album played by $user->fullname]]> +;##################################################### diff --git a/docs/CHANGELOG b/docs/CHANGELOG index 4ea79b77..2e698669 100755 --- a/docs/CHANGELOG +++ b/docs/CHANGELOG @@ -4,6 +4,11 @@ -------------------------------------------------------------------------- v.3.4-Alpha1 + - Fixed an issue with the random album selection that was causing + a full table scan, which could lead to poor performance + with large databases + - Start of Complete rewrite, config file format changed, requires + manual re-creation of /config/ampache.cfg.php - Added some minor sorting to the browse by song - Added ability to search year range (Thx Tom Kiehne) - Updated French and German translations diff --git a/image.php b/image.php index 66f14589..07f15a3e 100644 --- a/image.php +++ b/image.php @@ -1,7 +1,7 @@ get_art(); - - if (isset($r['art'])) { - $art = $r['art']; - $mime = $r['art_mime']; - } - else { + $art = $album->get_art(); + + if (!$art['art_mime']) { header('Content-type: image/gif'); - readfile(conf('prefix') . conf('theme_path') . "/images/blankalbum.gif"); + readfile(Config::get('prefix') . Config::get('theme_path') . '/images/blankalbum.gif'); break; } // else no image // Print the album art - $data = explode("/",$mime); + $data = explode("/",$art['art_mime']); $extension = $data['1']; + +// if (empty($_REQUEST['thumb'])) { + $art_data = $art['art']; +// } + //else { + // $art_data = img_resize($art,$size,$extension,$_REQUEST['id']); + //} + + // Send the headers and output the image header("Content-type: $mime"); header("Content-Disposition: filename=" . $album->name . "." . $extension); - if (empty($_REQUEST['thumb'])) { - echo $art; - } - elseif (!img_resize($art,$size,$extension)) { - echo $art; - } + echo $art_data; + break; } // end switch type diff --git a/images/ampache.gif b/images/ampache.gif deleted file mode 100755 index b085c7f2..00000000 Binary files a/images/ampache.gif and /dev/null differ diff --git a/images/ampache.png b/images/ampache.png new file mode 100644 index 00000000..a106239a Binary files /dev/null and b/images/ampache.png differ diff --git a/index.php b/index.php index f6eef67b..1b9d6f3a 100644 --- a/index.php +++ b/index.php @@ -24,8 +24,8 @@ @discussion Do most of the dirty work of displaying the mp3 catalog */ -require_once('lib/init.php'); -show_template('header'); +require_once 'lib/init.php'; +require_once Config::get('prefix') . '/templates/header.inc.php'; $action = scrub_in($_REQUEST['action']); @@ -34,14 +34,14 @@ $action = scrub_in($_REQUEST['action']); * refresh_javascript include. Must be greater then 5, I'm not * going to let them break their servers */ -if (conf('refresh_limit') > 5) { - $ajax_url = conf('ajax_url') . '?action=reloadnp' . conf('ajax_info'); +if (Config::get('refresh_limit') > 5) { + $ajax_url = Config::get('ajax_url') . '?action=reloadnp' . Config::get('ajax_info'); /* Can't have the & stuff in the Javascript */ $ajax_url = str_replace("&","&",$ajax_url); - require_once(conf('prefix') . '/templates/javascript_refresh.inc.php'); + require_once Config::get('prefix') . '/templates/javascript_refresh.inc.php'; } -require_once(conf('prefix') . '/templates/show_index.inc.php'); +require_once Config::get('prefix') . '/templates/show_index.inc.php'; show_footer(); diff --git a/lib/album.lib.php b/lib/album.lib.php index 29c9e90a..410b189b 100644 --- a/lib/album.lib.php +++ b/lib/album.lib.php @@ -68,15 +68,21 @@ function get_random_albums($count='') { if (!$count) { $count = 5; } - $count = sql_escape($count); + $count = Dba::escape($count); - $sql = "SELECT id FROM album WHERE art IS NOT NULL ORDER BY RAND() LIMIT $count"; - $db_results = mysql_query($sql,dbh()); + // We avoid a table scan by using the id index and then using a rand to pick a row # + $sql = "SELECT `id` FROM `album` WHERE `art` IS NOT NULL"; + $db_results = Dba::query($sql); - $results = array(); + while ($r = Dba::fetch_assoc($db_results)) { + $albums[] = $r['id']; + } + + $total = count($albums); - while ($r = mysql_fetch_assoc($db_results)) { - $results[] = $r['id']; + for ($i=0; $i <= $count; $i++) { + $record = rand(0,$total); + $results[] = $albums[$record]; } return $results; diff --git a/lib/class/access.class.php b/lib/class/access.class.php index ba4548dd..fc01adfb 100644 --- a/lib/class/access.class.php +++ b/lib/class/access.class.php @@ -1,7 +1,7 @@ id Taken from the object */ - function _get_info() { + private function _get_info() { $this->id = intval($this->id); @@ -81,10 +81,9 @@ class Album { $sql = "SELECT COUNT(DISTINCT(song.artist)) as artist_count,album.prefix,album.year,album.name AS album_name,COUNT(song.id) AS song_count," . "artist.name AS artist_name,artist.id AS art_id,artist.prefix AS artist_prefix,album.art AS has_art ". "FROM song,artist,album WHERE album.id='$this->id' AND song.album=album.id AND song.artist=artist.id GROUP BY song.album"; + $db_results = Dba::query($sql); - $db_results = mysql_query($sql, dbh()); - - $results = mysql_fetch_assoc($db_results); + $results = Dba::fetch_assoc($db_results); // If there is art then set it to 1, if not set it to 0, we don't want to cary // around the full blob with every object because it can be pretty big @@ -147,10 +146,10 @@ class Album { */ function format() { - $web_path = conf('web_path'); + $web_path = Config::get('web_path'); /* Truncate the string if it's to long */ - $name = scrub_out(truncate_with_ellipse($this->name,conf('ellipse_threshold_album'))); + $name = scrub_out(truncate_with_ellipse($this->name,Config::get('ellipse_threshold_album'))); $artist = scrub_out($this->artist); $this->f_name = "id . "\" title=\"" . scrub_out($this->name) . "\">" . $name . ""; $this->f_link = "id) . "\" title=\"" . scrub_out($this->name) . "\">" . $name . ""; @@ -182,12 +181,20 @@ class Album { /** * get_art - * This function only pulls art from the database, nothing else - * It should not be called when trying to find new art + * This function only pulls art from the database, if thumb is passed + * it trys to pull the resized art instead, if resized art is found then + * it returns an additional resized=true in the array */ function get_art() { - return $this->get_db_art(); + // Attempt to get the resized art first + $art = $this->get_resized_db_art(); + + if (!is_array($art)) { + $art = $this->get_db_art(); + } + + return $art; } // get_art @@ -371,15 +378,37 @@ class Album { } // get_folder_art() /** - * get_db_art() + * get_resized_db_art + * This looks to see if we have a resized thumbnail that we can load rather then taking + * the fullsized and resizing that + */ + public function get_resized_db_art() { + + $id = Dba::escape($this->id); + + $sql = "SELECT `thumb` AS `art`,`thumb_mime` AS `art_mime` FROM `album` WHERE `id`='$id'"; + $db_results = Dba::query($sql); + + $results = Dba::fetch_assoc($db_results); + if (strlen($results['art_mime'])) { + $results['resized'] = true; + } + else { return false; } + + return $results; + + } // get_resized_db_art + + /** + * get_db_art * returns the album art from the db along with the mime type */ - function get_db_art() { + public function get_db_art() { - $sql = "SELECT art,art_mime FROM album WHERE id='$this->id' AND art_mime IS NOT NULL"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT `art`,`art_mime` FROM `album` WHERE `id`='$this->id'"; + $db_results = Dba::query($sql); - $results = mysql_fetch_assoc($db_results); + $results = Dba::fetch_assoc($db_results); if (!$results['art']) { return array(); } @@ -585,6 +614,22 @@ class Album { } // insert_art + /** + * save_resized_art + * This takes data from a gd resize operation and saves + * it back into the database as a thumbnail + */ + public static function save_resized_art($data,$mime,$album) { + + $data = Dba::escape($data); + $mime = Dba::escape($mime); + $album = Dba::escape($album); + + $sql = "UPDATE `album` SET `thumb`='$data',`thumb_mime`='$mime' " . + "WHERE `album`.`id`='$album'"; + $db_results = Dba::query($sql); + + } // save_resized_art } //end of album class diff --git a/lib/class/artist.class.php b/lib/class/artist.class.php index 6348339e..18fa31cf 100644 --- a/lib/class/artist.class.php +++ b/lib/class/artist.class.php @@ -1,7 +1,7 @@ _get_info(); - if (count($info)) { - /* Assign Vars */ - $this->name = $info['name']; - $this->prefix = $info['prefix']; - } // if info + + foreach ($info as $key=>$value) { + $this->$key = $value; + } // foreach info return true; } //constructor - /*! - @function _get_info - @discussion get's the vars for $this out of the database - @param $this->id Taken from the object + /** + * _get_info + * get's the vars for $this out of the database taken from the object */ - function _get_info() { + private function _get_info() { /* Grab the basic information from the catalog and return it */ - $sql = "SELECT * FROM artist WHERE id='" . sql_escape($this->id) . "'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT * FROM artist WHERE id='" . Dba::escape($this->id) . "'"; + $db_results = Dba::query($sql); - $results = mysql_fetch_assoc($db_results); + $results = Dba::fetch_assoc($db_results); return $results; - } //get_info + } // _get_info /*! @function get_albums @@ -161,9 +159,9 @@ class Artist { $albums = 0; $sql = "SELECT COUNT(song.id) FROM song WHERE song.artist='$this->id' GROUP BY song.album"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - while ($r = mysql_fetch_array($db_results)) { + while ($r = Dba::fetch_row($db_results)) { $songs += $r[0]; $albums++; } @@ -193,7 +191,7 @@ class Artist { $this->full_name = scrub_out(trim($this->prefix . " " . $this->name)); //FIXME: This should be f_link - $this->link = "id . "\" title=\"" . $this->full_name . "\">" . $name . ""; + $this->f_link = "id . "\" title=\"" . $this->full_name . "\">" . $name . ""; // Get the counts $this->get_count(); diff --git a/lib/class/catalog.class.php b/lib/class/catalog.class.php index 50db6749..2f78949b 100644 --- a/lib/class/catalog.class.php +++ b/lib/class/catalog.class.php @@ -1,7 +1,7 @@ id = intval($catalog_id); - - /* Get the information from the db */ - $info = $this->get_info(); - - /* Assign Vars */ - $this->path = $info->path; - $this->name = $info->name; - $this->last_update = $info->last_update; - $this->last_add = $info->last_add; - $this->key = $info->key; - $this->rename_pattern = $info->rename_pattern; - $this->sort_pattern = $info->sort_pattern; - $this->catalog_type = $info->catalog_type; - } //catalog_id + if (!$catalog_id) { return false; } - } //constructor + /* Assign id for use in get_info() */ + $this->id = intval($catalog_id); + /* Get the information from the db */ + $info = $this->_get_info(); - /*! - @function get_info - @discussion get's the vars for $this out of the database - @param $this->id Taken from the object - */ - function get_info() { + foreach ($info as $key=>$value) { + $this->$key = $value; + } + + } //constructor + + /** + * _get_info + * get's the vars for $this out of the database requires an id + */ + private function _get_info() { /* Grab the basic information from the catalog and return it */ - $sql = "SELECT * FROM catalog WHERE id='$this->id'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT * FROM `catalog` WHERE `id`='$this->id'"; + $db_results = Dba::query($sql); - $results = mysql_fetch_object($db_results); + $results = Dba::fetch_assoc($db_results); return $results; - } //get_info + } // _get_info + /** + * get_catalogs + *Pull all the current catalogs + */ + public static function get_catalogs() { - /*! - @function get_catalogs - @discussion Pull all the current catalogs - */ - function get_catalogs() { - - $sql = "SELECT id FROM catalog"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT `id` FROM `catalog`"; + $db_results = Dba::query($sql); - while ($r = mysql_fetch_object($db_results)) { - $results[] = new Catalog($r->id); + while ($r = Dba::fetch_assoc($db_results)) { + $results[] = new Catalog($r['id']); } return $results; @@ -115,10 +105,10 @@ class Catalog { */ function get_catalog_ids() { - $sql = "SELECT id FROM catalog"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT `id` FROM `catalog`"; + $db_results = Dba::qery($sql); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $results[] = $r['id']; } @@ -126,46 +116,89 @@ class Catalog { } // get_catalog_ids - /*! - @function get_catalog_stats - @discussion Pulls information about number of songs etc for a specifc catalog, or all catalogs - calls many other internal functions, returns an object containing results - @param $catalog_id If set tells us to pull from a single catalog, rather than all catalogs - */ - function get_catalog_stats($catalog_id=0) { - - $results->songs = $this->count_songs($catalog_id); - $results->albums = $this->count_albums($catalog_id); - $results->artists = $this->count_artists($catalog_id); - $results->size = $this->get_song_size($catalog_id); - $results->time = $this->get_song_time($catalog_id); + /** + * get_stats + * This returns an hash with the #'s for the different + * objects that are assoicated with this catalog. This is used + * to build the stats box, it also calculates time + */ + public static function get_stats($catalog_id=0) { - } // get_catalog_stats + $results = self::count_songs($catalog_id); + $results = array_merge(self::count_users($catalog_id),$results); +// $results->songs = $this->count_songs($catalog_id); +// $results->albums = $this->count_albums($catalog_id); +// $results->artists = $this->count_artists($catalog_id); +// $results->size = $this->get_song_size($catalog_id); +// $results->time = $this->get_song_time($catalog_id); - /*! - @function get_song_time - @discussion Get the total amount of time (song wise) in all or specific catalog - @param $catalog_id If set tells ut to pick a specific catalog - */ - function get_song_time($catalog_id=0) { + return $results; - $sql = "SELECT SUM(song.time) FROM song"; - if ($catalog_id) { - $sql .= " WHERE catalog='$catalog_id'"; - } + } // get_stats - $db_results = mysql_query($sql, dbh()); + /** + * count_songs + * This returns the current # of songs, albums, artists, genres + * in this catalog + */ + public static function count_songs($catalog_id='') { + + if ($catalog_id) { $catalog_search = "WHERE `catalog`='" . Dba::escape($catalog_id) . "'"; } + + $sql = "SELECT `id`,`album`,`artist`,`genre`,`file`,`size`,`time` FROM `song` $catalog_search"; + $db_results = Dba::query($sql); + + while ($data = Dba::fetch_assoc($db_results)) { + $albums[$data['album']] = true; + $artists[$data['artist']] = true; + $genres[$data['genre']] = true; + $dir = basename($data['file']); + $folders[$dir] = true; + $size += $data['size']; + $time += $data['time']; + $songs++; + } - $results = mysql_fetch_field($db_results); + $results['songs'] = $songs; + $results['albums'] = count($albums); + $results['artists'] = count($artists); + $results['genres'] = count($genres); + $results['folders'] = count($folders); + $results['size'] = $size; + $results['time'] = $time; - /* Do some conversion to get Hours Min Sec */ + return $results; + } // count_songs - return $results; + /** + * count_users + * This returns the total number of users in the ampache instance + */ + public static function count_users($catalog_id='') { + + // Count total users + $sql = "SELECT COUNT(id) FROM `user`"; + $db_results = Dba::query($sql); + $data = Dba::fetch_row($db_results); + $results['users'] = $data['0']; + + // Get the connected users + $time = time(); + $last_seen_time = $time - 1200; + $sql = "SELECT count(DISTINCT s.username) FROM session AS s " . + "INNER JOIN user AS u ON s.username = u.username " . + "WHERE s.expire > " . $time . " " . + "AND u.last_seen > " . $last_seen_time; + $db_results = Dba::query($sql); + $data = Dba::fetch_row($db_results); + + $results['connected'] = $data['0']; - } // get_song_time + return $results; + } // count_users /*! @function get_song_size @@ -233,25 +266,6 @@ class Catalog { } // count_albums - /*! - @function count_songs - @discussion Count the number of songs in all catalogs, or a specific one - @param $catalog_id If set tells us to pick a specific catalog - */ - function count_songs($catalog_id=0) { - - $sql = "SELECT count(*) FROM song"; - if ($catalog_id) { - $sql .= " WHERE catalog='$catalog_id'"; - } - - $db_results = mysql_query($sql, dbh()); - $results = mysql_fetch_field($db_results); - - return $results; - - } // count_songs - /*! @function add_file @discussion adds a single file @@ -585,16 +599,16 @@ class Catalog { * Gets an array of the disabled songs for all catalogs * and returns full song objects with them */ - function get_disabled($count=0) { + public static function get_disabled($count=0) { $results = array(); if ($count) { $limit_clause = " LIMIT $count"; } $sql = "SELECT id FROM song WHERE enabled='0' $limit_clause"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - while ($r = mysql_fetch_array($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $results[] = new Song($r['id']); } @@ -602,7 +616,6 @@ class Catalog { } // get_disabled - /*! @function get_files @discussion Get's an array of .mp3s and returns the filenames diff --git a/lib/class/dba.class.php b/lib/class/dba.class.php index 97810613..b37ca39d 100644 --- a/lib/class/dba.class.php +++ b/lib/class/dba.class.php @@ -21,6 +21,15 @@ /* Make sure they aren't directly accessing it */ if (INIT_LOADED != '1') { exit; } +/** + * Dba + * This is the database abstraction class + * It duplicates the functionality of mysql_??? + * with a few exceptions, the row and assoc will always + * return an array, simplifying checking on the far end + * it will also auto-connect as needed, and has a default + * database simplifying queries in most cases. + */ class Dba { private static $_default_db; @@ -66,6 +75,7 @@ class Dba { /** * fetch_assoc * This emulates the mysql_fetch_assoc and takes a resource result + * we force it to always return an array, albit an empty one */ public static function fetch_assoc($resource) { @@ -80,6 +90,7 @@ class Dba { /** * fetch_row * This emulates the mysql_fetch_row and takes a resource result + * we force it to always return an array, albit an empty one */ public static function fetch_row($resource) { @@ -91,6 +102,21 @@ class Dba { } // fetch_row + /** + * num_rows + * This emulates the mysql_num_rows function which is really + * just a count of rows returned by our select statement, this + * doesn't work for updates or inserts + */ + public static function num_rows($resource) { + + $result = mysql_num_rows($resource); + + if (!$result) { return '0'; } + + return $result; + } // num_rows + /** * _connect * This connects to the database, used by the DBH function @@ -98,10 +124,10 @@ class Dba { private static function _connect($db_name) { if (self::$_default_db == $db_name) { - $username = Config::get('mysql_username'); - $hostname = Config::get('mysql_hostname'); - $password = Config::get('mysql_password'); - $database = Config::get('mysql_database'); + $username = Config::get('database_username'); + $hostname = Config::get('database_hostname'); + $password = Config::get('database_password'); + $database = Config::get('database_name'); } else { // Do this later @@ -111,7 +137,7 @@ class Dba { if (!$dbh) { debug_event('Database','Error unable to connect to database' . mysql_error(),'1'); } $select_db = mysql_select_db($database,$dbh); - + return $dbh; } // _connect @@ -125,13 +151,16 @@ class Dba { if (!$database) { $database = self::$_default_db; } - if (!is_resource(self::$config->get($database))) { + // Assign the Handle name that we are going to store + $handle = 'dbh_' . $database; + + if (!is_resource(Config::get($handle))) { $dbh = self::_connect($database); - self::$config->set($database,$dbh,1); + Config::set($handle,$dbh,1); return $dbh; } else { - return self::$config->get($database); + return Config::get($handle); } @@ -154,10 +183,9 @@ class Dba { * This is the auto init function it sets up the config class * and also sets the default database */ - public static function auto_init() { + public static function _auto_init() { - self::$_default_db = Config::get('mysql_database'); - self::$config = new Config(); + self::$_default_db = Config::get('database_name'); return true; diff --git a/lib/class/error.class.php b/lib/class/error.class.php index 013a2e08..bc839bdb 100644 --- a/lib/class/error.class.php +++ b/lib/class/error.class.php @@ -1,92 +1,80 @@ $description); + // They want us to append the error, add a BR\n and then the message + else { + Error::$state = 1; + Error::$errors[$name] .= "
\n" . $message; + return true; + } - error_results($array,1); - $this->error_state = 1; - return true; - - } // add_error + } // add + /** + * get + * This returns an error by name + */ + public static function get($name) { - /*! - @function has_error - @discussion returns true if the name given has an error, - false if it doesn't - */ - function has_error($name) { + if (!isset(Error::$errors[$name])) { return ''; } - $results = error_results($name); + return Error::$errors[$name]; - if (!empty($results)) { - return true; - } + } // get - return false; + /** + * display + * This prints the error out with a standard Error class span + * Ben Goska: Renamed from print to display, print is reserved + */ + public static function display($name) { - } // has_error + // Be smart about this, if no error don't print + if (!isset(Error::$errors[$name])) { return ''; } - /*! - @function print_error - @discussion prints out the error for a name if it exists - */ - function print_error($name) { + echo '' . Error::$errors[$name] . ''; - if ($this->has_error($name)) { - echo "
" . error_results($name) . "
\n"; - } + } // display - } // print_error -} //end error class -?> +} // Error diff --git a/lib/class/flag.class.php b/lib/class/flag.class.php index 20ed5d8b..d54879f5 100644 --- a/lib/class/flag.class.php +++ b/lib/class/flag.class.php @@ -70,14 +70,14 @@ class Flag { * _get_info * Private function for getting the information for this object from the database */ - function _get_info() { + private function _get_info() { - $id = sql_escape($this->id); + $id = Dba::escape($this->id); - $sql = "SELECT * FROM flagged WHERE id='$id'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT * FROM `flagged` WHERE `id`='$id'"; + $db_results = Dba::query($sql); - $results = mysql_fetch_assoc($db_results); + $results = Dba::fetch_assoc($db_results); return $results; @@ -88,16 +88,16 @@ class Flag { * This returns the id's of the most recently flagged songs, it takes an int * as an argument which is the count of the object you want to return */ - function get_recent($count=0) { + public static function get_recent($count=0) { if ($count) { $limit = " LIMIT " . intval($count); } $results = array(); $sql = "SELECT id FROM flagged ORDER BY date " . $limit; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $results[] = $r['id']; } diff --git a/lib/class/song.class.php b/lib/class/song.class.php index 64c99509..7711ea95 100644 --- a/lib/class/song.class.php +++ b/lib/class/song.class.php @@ -57,39 +57,19 @@ class Song { */ function Song($song_id = 0) { - /* If we have passed an id then do something */ - if ($song_id) { - - /* Assign id for use in get_info() */ - $this->id = intval($song_id); - - /* Get the information from the db */ - if ($info = $this->_get_info()) { - - /* Assign Vars */ - $this->file = $info->file; - $this->album = $info->album; - $this->artist = $info->artist; - $this->title = $info->title; - $this->comment = $info->comment; - $this->year = $info->year; - $this->bitrate = $info->bitrate; - $this->rate = $info->rate; - $this->mode = $info->mode; - $this->size = $info->size; - $this->time = $info->time; - $this->track = $info->track; - $this->genre = $info->genre; - $this->addition_time = $info->addition_time; - $this->catalog = $info->catalog; - $this->played = $info->played; - $this->update_time = $info->update_time; - $this->enabled = $info->enabled; + if (!$song_id) { return false; } + /* Assign id for use in get_info() */ + $this->id = intval($song_id); + + /* Get the information from the db */ + if ($info = $this->_get_info()) { + + foreach ($info as $key=>$value) { + $this->$key = $value; + } // Format the Type of the song $this->format_type(); - } - } } //constructor @@ -100,16 +80,16 @@ class Song { @discussion get's the vars for $this out of the database @param $this->id Taken from the object */ - function _get_info() { + private function _get_info() { /* Grab the basic information from the catalog and return it */ $sql = "SELECT song.id,file,catalog,album,year,artist,". "title,bitrate,rate,mode,size,time,track,genre,played,song.enabled,update_time,". - "addition_time FROM song WHERE song.id = '$this->id'"; + "addition_time FROM `song` WHERE `song`.`id` = '$this->id'"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - $results = mysql_fetch_object($db_results); + $results = Dba::fetch_assoc($db_results); return $results; @@ -229,10 +209,10 @@ class Song { if (!$album_id) { $album_id = $this->album; } - $sql = "SELECT name,prefix FROM album WHERE id='" . sql_escape($album_id) . "'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT `name`,`prefix` FROM `album` WHERE `id`='" . Dba::escape($album_id) . "'"; + $db_results = Dba::query($sql); - $results = mysql_fetch_assoc($db_results); + $results = Dba::fetch_assoc($db_results); if ($results['prefix']) { return $results['prefix'] . " " .$results['name']; @@ -251,10 +231,10 @@ class Song { if (!$artist_id) { $artist_id = $this->artist; } - $sql = "SELECT name,prefix FROM artist WHERE id='" . sql_escape($artist_id) . "'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT name,prefix FROM artist WHERE id='" . Dba::escape($artist_id) . "'"; + $db_results = Dba::query($sql); - $results = mysql_fetch_assoc($db_results); + $results = Dba::fetch_assoc($db_results); if ($results['prefix']) { return $results['prefix'] . " " . $results['name']; @@ -274,10 +254,10 @@ class Song { if (!$genre_id) { $genre_id = $this->genre; } - $sql = "SELECT name FROM genre WHERE id='" . sql_escape($genre_id) . "'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT name FROM genre WHERE id='" . Dba::escape($genre_id) . "'"; + $db_results = Dba::query($sql); - $results = mysql_fetch_assoc($db_results); + $results = Dba::fetch_assoc($db_results); return $results['name']; @@ -681,19 +661,19 @@ class Song { // Format the album name $this->f_album_full = $this->get_album_name(); - $this->f_album = truncate_with_ellipse($this->f_album_full,conf('ellipse_threshold_album')); + $this->f_album = truncate_with_ellipse($this->f_album_full,Config::get('ellipse_threshold_album')); // Format the artist name $this->f_artist_full = $this->get_artist_name(); - $this->f_artist = truncate_with_ellipse($this->f_artist_full,conf('ellipse_threshold_artist')); + $this->f_artist = truncate_with_ellipse($this->f_artist_full,Config::get('ellipse_threshold_artist')); // Format the title - $this->f_title = truncate_with_ellipse($this->title,conf('ellipse_threshold_title')); + $this->f_title = truncate_with_ellipse($this->title,Config::get('ellipse_threshold_title')); // Create Links for the different objects - $this->f_link = "id . "\">$this->f_title"; - $this->f_album_link = "album . "\">$this->f_album"; - $this->f_artist_link = "artist . "\">$this->f_artist"; + $this->f_link = "id . "\">$this->f_title"; + $this->f_album_link = "album . "\">$this->f_album"; + $this->f_artist_link = "artist . "\">$this->f_artist"; // Format the Bitrate $this->f_bitrate = intval($this->bitrate/1000) . "-" . strtoupper($this->mode); @@ -802,7 +782,7 @@ class Song { $user_id = scrub_out($GLOBALS['user']->id); $song_id = $this->id; - if (conf('require_session')) { + if (Config::get('require_session')) { if ($session_id) { $session_string = "&sid=" . $session_id; } @@ -823,10 +803,10 @@ class Song { $this->format(); $song_name = rawurlencode($this->f_artist_full . " - " . $this->title . "." . $type); - $web_path = conf('web_path'); + $web_path = Config::get('web_path'); - if (conf('force_http_play') OR !empty($force_http)) { - $port = conf('http_port'); + if (Config::get('force_http_play') OR !empty($force_http)) { + $port = Config::get('http_port'); if (preg_match("/:\d+/",$web_path)) { $web_path = str_replace("https://", "http://",$web_path); $web_path = preg_replace("/:\d+/",":$port",$web_path); @@ -854,9 +834,9 @@ class Song { $conf_var = 'transcode_' . $this->type; $conf_type = 'transcode_' . $this->type . '_target'; - if (conf($conf_var)) { + if (Config::get($conf_var)) { $this->_transcode = true; - $this->format_type(conf($conf_type)); + $this->format_type(Config::get($conf_type)); debug_event('auto_transcode','Transcoding to ' . $this->type,'5'); return false; } diff --git a/lib/class/stats.class.php b/lib/class/stats.class.php index 965b3362..5eef86d7 100644 --- a/lib/class/stats.class.php +++ b/lib/class/stats.class.php @@ -1,7 +1,7 @@ = '$date'" . " GROUP BY object_id ORDER BY `count` DESC LIMIT $count"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); $results = array(); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $results[] = $r; } @@ -105,29 +105,30 @@ class Stats { * This gets all stats for atype based on user with thresholds and all * If full is passed, doesn't limit based on date */ - function get_user($count,$type,$user,$full='') { + public static function get_user($count,$type,$user,$full='') { $count = intval($count); - $type = $this->validate_type($type); - $user = sql_escape($user); + $type = self::validate_type($type); + $user = Dba::escape($user); /* If full then don't limit on date */ if ($full) { $date = '0'; } else { - $date = time() - (86400*conf('stats_threshold')); + $date = time() - (86400*Config::get('stats_threshold')); } /* Select Objects based on user */ + //FIXME:: Requires table can, look at improving $sql = "SELECT object_id,COUNT(id) AS `count` FROM object_count" . " WHERE object_type='$type' AND date >= '$date' AND user = '$user'" . " GROUP BY object_id ORDER BY `count` DESC LIMIT $count"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); $results = array(); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $results[] = $r; } @@ -140,7 +141,7 @@ class Stats { * This function takes a type and returns only those * which are allowed, ensures good data gets put into the db */ - function validate_type($type) { + public static function validate_type($type) { switch ($type) { case 'artist': @@ -160,5 +161,31 @@ class Stats { } // validate_type + /** + * get_newest + * This returns an array of the newest artists/albums/whatever + * in this ampache instance + */ + public static function get_newest($type,$limit='') { + + if (!$limit) { $limit = Config::get('popular_threshold'); } + + $type = self::validate_type($type); + $object_name = ucfirst($type); + + $sql = "SELECT DISTINCT($type) FROM `song` ORDER BY `addition_time` DESC " . + "LIMIT $limit"; + $db_results = Dba::query($sql); + + while ($r = Dba::fetch_row($db_results)) { + $object = new $object_name($r['0']); + $object->format(); + $items[] = $object; + } // end while results + + return $items; + + } // get_newest + } //Stats class ?> diff --git a/lib/class/stream.class.php b/lib/class/stream.class.php index 8d081824..375e04fe 100644 --- a/lib/class/stream.class.php +++ b/lib/class/stream.class.php @@ -1,7 +1,7 @@ type = $type; $this->songs = $song_ids; - $this->web_path = conf('web_path'); + $this->web_path = Config::get('web_path'); - if (conf('force_http_play')) { - $port = conf('http_port'); + if (Config::get('force_http_play')) { + $port = Config::get('http_port'); $this->web_path = preg_replace("/https/", "http",$this->web_path); $this->web_path = preg_replace("/:\d+/",":$port",$this->web_path); } $this->sess = session_id(); - $this->user_id = $_SESSION['userdata']['username']; + $this->user_id = $GLOBALS['user']->id; } //constructor @@ -120,24 +120,25 @@ class Stream { } // simple_m3u - /*! - @function create_m3u - @discussion creates an m3u file - */ - function create_m3u() { + /** + * create_m3u + * creates an m3u file, this includes the EXTINFO and as such can be + * large with very long playlsits + */ + public function create_m3u() { // Send the client an m3u playlist header("Cache-control: public"); header("Content-Disposition: filename=playlist.m3u"); header("Content-Type: audio/x-mpegurl;"); echo "#EXTM3U\n"; + foreach($this->songs as $song_id) { $song = new Song($song_id); - $song->format_song(); - if ($song->type == ".flac") { $song->type = ".ogg"; } + $song->format(); $song_name = $song->f_artist_full . " - " . $song->title . "." . $song->type; echo "#EXTINF:$song->time," . $song->f_artist_full . " - " . $song->title . "\n"; - $sess = $_COOKIE[conf('sess_name')]; + $sess = $_COOKIE[Config::get('sess_name')]; if($GLOBALS['user']->prefs['play_type'] == 'downsample') { $ds = $GLOBALS['user']->prefs['sample_rate']; } diff --git a/lib/class/update.class.php b/lib/class/update.class.php index bb93a9e5..8c7ebe1e 100644 --- a/lib/class/update.class.php +++ b/lib/class/update.class.php @@ -37,9 +37,9 @@ class Update { - var $key; - var $value; - var $versions; // array containing version information + public $key; + public $value; + public static $versions; // array containing version information /*! @function Update @@ -77,16 +77,16 @@ class Update { because we may not have the update_info table we have to check for it's existance first. */ - function get_version() { + public static function get_version() { /* Make sure that update_info exits */ $sql = "SHOW TABLES LIKE 'update_info'"; - $db_results = mysql_query($sql, dbh()); - if (!is_resource(dbh())) { header("Location: test.php"); } + $db_results = Dba::query($sql); + if (!is_resource(Dba::dbh())) { header("Location: test.php"); } // If no table - if (!mysql_num_rows($db_results)) { + if (!Dba::num_rows($db_results)) { $version = '310000'; @@ -95,9 +95,9 @@ class Update { else { // If we've found the update_info table, let's get the version from it $sql = "SELECT * FROM update_info WHERE `key`='db_version'"; - $db_results = mysql_query($sql, dbh()); - $results = mysql_fetch_object($db_results); - $version = $results->value; + $db_results = Dba::query($sql); + $results = Dba::fetch_assoc($db_results); + $version = $results['value']; } return $version; @@ -117,24 +117,24 @@ class Update { } // format_version - /*! - @function need_update - @discussion checks to see if we need to update - maintain at all - */ - function need_update() { + /** + * need_update + * checks to see if we need to update + * maintain at all + */ + public static function need_update() { - $current_version = $this->get_version(); + $current_version = self::get_version(); - if (!is_array($this->versions)) { - $this->versions = $this->populate_version(); + if (!is_array(self::$versions)) { + self::$versions = self::populate_version(); } /* Go through the versions we have and see if we need to apply any updates */ - foreach ($this->versions as $update) { + foreach (self::$versions as $update) { if ($update['version'] > $current_version) { return true; } @@ -175,7 +175,7 @@ class Update { @discussion just sets an array the current differences that require an update */ - function populate_version() { + public static function populate_version() { /* Define the array */ $version = array(); diff --git a/lib/class/user.class.php b/lib/class/user.class.php index dfd50222..e50b6bb8 100644 --- a/lib/class/user.class.php +++ b/lib/class/user.class.php @@ -54,16 +54,11 @@ class User { $info = $this->_get_info(); if (!count($info)) { return false; } + foreach ($info as $key=>$value) { + $this->$key = $value; + } $this->uid = $info->id; - $this->username = $info->username; - $this->fullname = $info->fullname; - $this->access = $info->access; - $this->disabled = $info->disabled; - $this->email = $info->email; - $this->last_seen = $info->last_seen; - $this->create_date = $info->create_date; - $this->validation = $info->validation; $this->set_preferences(); // Make sure the Full name is always filled @@ -77,16 +72,35 @@ class User { */ function _get_info() { - $id = sql_escape($this->id); + $id = Dba::escape($this->id); $sql = "SELECT * FROM `user` WHERE `id`='" . $id . "'"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - return mysql_fetch_object($db_results); + return Dba::fetch_assoc($db_results); } // _get_info + /** + * get_from_username + * This returns a built user from a username. This is a + * static function so it doesn't require an instance + */ + public static function get_from_username($username) { + + $username = Dba::escape($username); + + $sql = "SELECT `id` FROM `user` WHERE `username`='$username'"; + $db_results = Dba::query($sql); + $results = Dba::fetch_assoc($db_results); + + $user = new User($results['id']); + + return $user; + + } // get_from_username + /** * get_preferences * This is a little more complicate now that we've got many types of preferences @@ -140,10 +154,11 @@ class User { $sql = "SELECT preferences.name,user_preference.value FROM preferences,user_preference WHERE user_preference.user='$this->id' " . "AND user_preference.preference=preferences.id AND preferences.type != 'system'"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - while ($r = mysql_fetch_object($db_results)) { - $this->prefs[$r->name] = $r->value; + while ($r = Dba::fetch_assoc($db_results)) { + $key = $r['name']; + $this->prefs[$key] = $r['value']; } } // get_preferences @@ -153,10 +168,9 @@ class User { */ function get_favorites($type) { - $web_path = conf('web_path'); + $web_path = Config::get('web_path'); - $stats = new Stats(); - $results = $stats->get_user(conf('popular_threshold'),$type,$this->uid,1); + $results = Stats::get_user(Config::get('popular_threshold'),$type,$this->id,1); $items = array(); @@ -165,7 +179,7 @@ class User { if ($type == 'song') { $data = new Song($r['object_id']); $data->count = $r['count']; - $data->format_song(); + $data->format(); $data->f_name = $data->f_link; $items[] = $data; } @@ -173,23 +187,23 @@ class User { elseif ($type == 'album') { $data = new Album($r['object_id']); $data->count = $r['count']; - $data->format_album(); + $data->format(); $items[] = $data; } /* If its an artist */ elseif ($type == 'artist') { $data = new Artist($r['object_id']); $data->count = $r['count']; - $data->format_artist(); - $data->f_name = $data->link; + $data->format(); + $data->f_name = $data->f_link; $items[] = $data; } /* If it's a genre */ elseif ($type == 'genre') { $data = new Genre($r['object_id']); $data->count = $r['count']; - $data->format_genre(); - $data->f_name = $data->link; + $data->format(); + $data->f_name = $data->f_link; $items[] = $data; } @@ -208,24 +222,24 @@ class User { /* First pull all of your ratings of this type */ $sql = "SELECT object_id,user_rating FROM ratings " . - "WHERE object_type='" . sql_escape($type) . "' AND user='" . sql_escape($this->id) . "'"; - $db_results = mysql_query($sql,dbh()); + "WHERE object_type='" . Dba::escape($type) . "' AND user='" . Dba::escape($this->id) . "'"; + $db_results = Dba::query($sql); // Incase they only have one user $users = array(); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { /* Store the fact that you rated this */ $key = $r['object_id']; $ratings[$key] = true; /* Build a key'd array of users with this same rating */ - $sql = "SELECT user FROM ratings WHERE object_type='" . sql_escape($type) . "' " . - "AND user !='" . sql_escape($this->id) . "' AND object_id='" . sql_escape($r['object_id']) . "' " . - "AND user_rating ='" . sql_escape($r['user_rating']) . "'"; - $user_results = mysql_query($sql,dbh()); + $sql = "SELECT user FROM ratings WHERE object_type='" . Dba::escape($type) . "' " . + "AND user !='" . Dba::escape($this->id) . "' AND object_id='" . Dba::escape($r['object_id']) . "' " . + "AND user_rating ='" . Dba::escape($r['user_rating']) . "'"; + $user_results = Dba::query($sql); - while ($user_info = mysql_fetch_assoc($user_results)) { + while ($user_info = Dba::fetch_assoc($user_results)) { $key = $user_info['user']; $users[$key]++; } @@ -243,11 +257,11 @@ class User { /* Find everything they've rated at 4+ */ $sql = "SELECT object_id,user_rating FROM ratings " . - "WHERE user='" . sql_escape($user_id) . "' AND user_rating >='4' AND " . - "object_type = '" . sql_escape($type) . "' ORDER BY user_rating DESC"; - $db_results = mysql_query($sql,dbh()); + "WHERE user='" . Dba::escape($user_id) . "' AND user_rating >='4' AND " . + "object_type = '" . Dba::escape($type) . "' ORDER BY user_rating DESC"; + $db_results = Dba::query($sql); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $key = $r['object_id']; if (isset($ratings[$key])) { continue; } @@ -290,7 +304,7 @@ class User { */ function has_access($needed_level) { - if (!conf('use_auth') || conf('demo_mode')) { return true; } + if (!Config::get('use_auth') || Config::get('demo_mode')) { return true; } if ($this->access >= $needed_level) { return true; } @@ -474,7 +488,7 @@ class User { function update_last_seen() { $sql = "UPDATE user SET last_seen='" . time() . "' WHERE `id`='$this->id'"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); } // update_last_seen @@ -664,7 +678,7 @@ class User { } $item = "[$data->count] - $data->f_name"; - $results[]->link = $item; + $results[]->f_link = $item; } // end foreach items return $results; diff --git a/lib/class/vainfo.class.php b/lib/class/vainfo.class.php new file mode 100755 index 00000000..cdf793ab --- /dev/null +++ b/lib/class/vainfo.class.php @@ -0,0 +1,516 @@ +filename = $file; + if ($encoding) { + $this->encoding = $encoding; + } + else { + $this->encoding = conf('site_charset'); + } + + /* These are needed for the filename mojo */ + $this->_file_pattern = $file_pattern; + $this->_dir_pattern = $dir_pattern; + + // Initialize getID3 engine + $this->_getID3 = new getID3(); + $this->_getID3->option_md5_data = false; + $this->_getID3->option_md5_data_source = false; + $this->_getID3->option_tags_html = false; + $this->_getID3->option_extra_info = false; + $this->_getID3->option_tag_lyrics3 = false; + $this->_getID3->encoding = $this->encoding; + + /* Check for ICONV */ + if (function_exists('iconv')) { + $this->_iconv = true; + } + + } // vainfo + + + /** + * get_info + * This function takes a filename and returns the $_info array + * all filled up with tagie goodness or if specified filename + * pattern goodness + */ + function get_info() { + + /* Get the Raw file information */ + $this->_raw = $this->_getID3->analyze($this->filename); + + /* Figure out what type of file we are dealing with */ + $this->type = $this->_get_type(); + + /* This is very important, figure out th encoding of the + * file + */ + $this->_set_encoding(); + + /* Get the general information about this file */ + $info = $this->_get_info(); + + + /* Gets the Tags */ + $this->tags = $this->_get_tags(); + $this->tags['info'] = $info; + + unset($this->_raw); + + } // get_info + + /** + * _set_encoding + * This function trys to figure out what the encoding + * is based on the file type and sets the _file_encoding + * var to whatever it finds, the default is UTF-8 if we + * can't find anything + */ + function _set_encoding() { + /* Switch on the file type */ + switch ($this->type) { + case 'mp3': + case 'ogg': + case 'flac': + default: + $this->_file_encoding = $this->_raw['encoding']; + break; + } // end switch + + } // _get_encoding + + /** + * _get_type + * This function takes the raw information and figures out + * what type of file we are dealing with for use by the tag + * function + */ + function _get_type() { + + /* There are a few places that the file type can + * come from, in the end we trust the encoding + * type + */ + if ($type = $this->_raw['audio']['streams']['0']['dataformat']) { + $this->_clean_type($type); + return $type; + } + if ($type = $this->_raw['audio']['dataformat']) { + $this->_clean_type($type); + return $type; + } + if ($type = $this->_raw['fileformat']) { + $this->_clean_type($type); + return $type; + } + + return false; + + } // _get_type + + + /** + * _get_tags + * This function takes the raw information and the type and + * attempts to gather the tags and then normalize them into + * ['tag_name']['var'] = value + */ + function _get_tags() { + + $results = array(); + + /* Gather Tag information from the filenames */ + $results['file'] = $this->_parse_filename($this->filename); + + /* Return false if we don't have + * any tags to look at + */ + if (!is_array($this->_raw['tags'])) { + return false; + } + + /* The tags can come in many different shapes and colors + * depending on the encoding time of day and phase of the + * moon + */ + foreach ($this->_raw['tags'] as $key=>$tag_array) { + switch ($key) { + case 'vorbiscomment': + $results[$key] = $this->_parse_vorbiscomment($tag_array); + break; + case 'id3v1': + $results[$key] = $this->_parse_id3v1($tag_array); + break; + case 'id3v2': + $results[$key] = $this->_parse_id3v2($tag_array); + break; + case 'ape': + $results[$key] = $this->_parse_ape($tag_array); + break; + case 'quicktime': + $results[$key] = $this->_parse_quicktime($tag_array); + break; + case 'riff': + $results[$key] = $this->_parse_riff($tag_array); + break; + default: + debug_event('vainfo','Error: Unable to determine tag type of ' . $key . ' for file ' . $this->filename . ' Assuming id3v2','5'); + $results[$key] = $this->_parse_id3v2($tag_array); + break; + } // end switch + + } // end foreach + + return $results; + + } // _get_tags + + /** + * _get_info + * This function gathers and returns the general information + * about a song, vbr/cbr sample rate channels etc + */ + function _get_info() { + + $array = array(); + + /* Try to pull the information directly from + * the audio array + */ + if ($this->_raw['audio']['bitrate_mode']) { + $array['bitrate_mode'] = $this->_raw['audio']['bitrate_mode']; + } + if ($this->_raw['audio']['bitrate']) { + $array['bitrate'] = $this->_raw['audio']['bitrate']; + } + if ($this->_raw['audio']['channels']) { + $array['channels'] = intval($this->_raw['audio']['channels']); + } + if ($this->_raw['audio']['sample_rate']) { + $array['sample_rate'] = intval($this->_raw['audio']['sample_rate']); + } + if ($this->_raw['filesize']) { + $array['filesize'] = intval($this->_raw['filesize']); + } + if ($this->_raw['encoding']) { + $array['encoding'] = $this->_raw['encoding']; + } + if ($this->_raw['mime_type']) { + $array['mime'] = $this->_raw['mime_type']; + } + if ($this->_raw['playtime_seconds']) { + $array['playing_time'] = $this->_raw['playtime_seconds']; + } + + return $array; + + } // _get_info + + /** + * _clean_type + * This standardizes the type that we are given into a reconized + * type + */ + function _clean_type($type) { + + switch ($type) { + case 'mp3': + case 'mp2': + case 'mpeg3': + return 'mp3'; + break; + case 'flac': + return 'flac'; + break; + case 'vorbis': + return 'ogg'; + break; + default: + /* Log the fact that we couldn't figure it out */ + debug_event('vainfo','Unable to determine file type from ' . $type . ' on file ' . $this->filename,'5'); + return 'unknown'; + break; + } // end switch on type + + } // _clean_type + + /** + * _parse_vorbiscomment + * This function takes a vorbiscomment from getid3() and then + * returns the elements translated using iconv if needed in a + * pretty little format + */ + function _parse_vorbiscomment($tags) { + + /* Results array */ + $array = array(); + + /* go through them all! */ + foreach ($tags as $tag=>$data) { + + /* We need to translate a few of these tags */ + switch ($tag) { + case 'tracknumber': + $array['track'] = $this->_clean_tag($data['0']); + break; + case 'date': + $array['year'] = $this->_clean_tag($data['0']); + break; + } // end switch + + $array[$tag] = $this->_clean_tag($data['0']); + + } // end foreach + + return $array; + + } // _parse_vorbiscomment + + /** + * _parse_id3v1 + * This function takes a id3v1 tag set from getid3() and then + * returns the elements translated using iconv if needed in a + * pretty little format + */ + function _parse_id3v1($tags) { + + $array = array(); + + /* Go through all the tags */ + foreach ($tags as $tag=>$data) { + + /* This is our baseline for naming + * so no translation needed + */ + $array[$tag] = $this->_clean_tag($data['0'],$this->_file_encoding); + + } // end foreach + + return $array; + + } // _parse_id3v1 + + /** + * _parse_id3v2 + * This function takes a id3v2 tag set from getid3() and then + * returns the lelements translated using iconv if needed in a + * pretty little format + */ + function _parse_id3v2($tags) { + + $array = array(); + + /* Go through the tags */ + foreach ($tags as $tag=>$data) { + + /** + * the new getid3 handles this differently + * so we now need to account for it :( + */ + switch ($tag) { + case 'track_number': + $array['track'] = $this->_clean_tag($data['0'],$this->_file_encoding); + break; + //case 'content_type': + // $array['genre'] = $this->_clean_tag($data['0'],$this->_file_encoding); + break; + case 'comments': + $array['comment'] = $this->_clean_tag($data['0'],$this->_file_encoding); + break; + default: + $array[$tag] = $this->_clean_tag($data['0'],$this->_file_encoding); + break; + } // end switch on tag + + } // end foreach + + return $array; + + } // _parse_id3v2 + + /** + * _parse_ape + * This function takes ape tags set by getid3() and then + * returns the elements translated using iconv if needed in a + * pretty little format + */ + function _parse_ape($tags) { + + foreach ($tags as $tag=>$data) { + + $array[$tag] = $this->_clean_tag($data['0'],$this->_file_encoding); + + } // end foreach tags + + return $array; + + } // _parse_ape + + /** + * _parse_riff + * this function takes the riff take information passed by getid3() and + * then reformats it so that it matches the other formats. May require iconv + */ + function _parse_riff($tags) { + + foreach ($tags as $tag=>$data) { + + switch ($tag) { + case 'product': + $array['album'] = $this->_clean_tag($data['0'],$this->_file_encoding); + break; + default: + $array[$tag] = $this->_clean_tag($data['0'],$this->_file_encoding); + break; + } // end switch on tag + + } // foreach tags + + return $array; + + } // _parse_riff + + /** + * _parse_quicktime + * this function takes the quicktime tags set by getid3() and then + * returns the elements translated using iconv if needed in a + * pretty little format + */ + function _parse_quicktime($tags) { + + /* Results array */ + $array = array(); + + /* go through them all! */ + foreach ($tags as $tag=>$data) { + + /* We need to translate a few of these tags */ + switch ($tag) { + case 'creation_date': + if (strlen($data['0']) > 4) { + /* Weird Date format, attempt to normalize */ + $data['0'] = date("Y",strtotime($data['0'])); + } + $array['year'] = $this->_clean_tag($data['0']); + break; + } // end switch + + $array[$tag] = $this->_clean_tag($data['0']); + + } // end foreach + + return $array; + + } // _parse_quicktime + + + /** + * _parse_filename + * This function uses the passed file and dir patterns + * To pull out extra tag information and populate it into + * it's own array + */ + function _parse_filename($filename) { + + $results = array(); + + $pattern = $this->_dir_pattern . '/' . $this->_file_pattern; + preg_match_all("/\%\w/",$pattern,$elements); + + $preg_pattern = preg_quote($pattern); + $preg_pattern = preg_replace("/\%\w/","(.+)",$preg_pattern); + $preg_pattern = str_replace("/","\/",$preg_pattern); + $preg_pattern = "/" . $preg_pattern . "\..+$/"; + preg_match($preg_pattern,$filename,$matches); + /* Cut out the Full line, we don't need that */ + array_shift($matches); + + /* Foreach through what we've found */ + foreach ($matches as $key=>$value) { + $new_key = translate_pattern_code($elements['0'][$key]); + if ($new_key) { + $results[$new_key] = $value; + } + } // end foreach matches + + return $results; + + } // _parse_filename + + /** + * _clean_tag + * This function cleans up the tag that it's passed using Iconv + * if we've got it. It also takes an optional encoding param + * for the cases where we know what the tags source encoding + * is, and or if it's different then the encoding recorded + * in the file + */ + function _clean_tag($tag,$encoding='') { + + /* Guess that it's UTF-8 */ + if (!$encoding) { $encoding = 'UTF-8'; } + + if ($this->_iconv AND strcasecmp($encoding,$this->encoding) != 0) { + $charset = $this->encoding . '//TRANSLIT'; + $tag = iconv($encoding,$charset,$tag); + } + + return $tag; + + + + } // _clean_tag + +} // end class vainfo +?> diff --git a/lib/debug.lib.php b/lib/debug.lib.php index ca0d55cb..10ad838f 100644 --- a/lib/debug.lib.php +++ b/lib/debug.lib.php @@ -21,52 +21,29 @@ */ -/* - @header Debug Library - This library is loaded when somehow our mojo has - been lost, it contains functions for checking sql - connections, web paths etc.. +/** + * Debug Library + * This library is loaded when somehow our mojo has + * been lost, it contains functions for checking sql + * connections, web paths etc.. */ -/*! - @function read_config_file - @discussion checks to see if the config - file is readable, overkill I know.. - @param level 0 is readable, 1 detailed info -*/ - - -function read_config_file($file,$level=0) { - - $fp = @fopen($file, 'r'); - - if (!$level) { - return is_resource($fp); - } - - -} // read_config_file - /*! @function check_database @discussion checks the local mysql db and make sure life is good */ -function check_database($host,$username,$pass,$level=0) { +function check_database($host,$username,$pass,$database) { $dbh = @mysql_connect($host, $username, $pass); if (!is_resource($dbh)) { - $error['error_state'] = true; - $error['mysql_error'] = mysql_errno() . ": " . mysql_error() . "\n"; + return false; } if (!$host || !$username || !$pass) { - $error['error_state'] = true; - $error['mysql_error'] .= "
HOST:$host
User:$username
Pass:$pass
"; + return false; } - if ($error['error_state']) { return false; } - return $dbh; } // check_database @@ -101,13 +78,10 @@ function check_database_inserted($dbh,$db_name) { */ function check_php_ver($level=0) { - if (strcmp('4.1.2',phpversion()) > 0) { - $error['error_state'] = true; - $error['php_ver'] = phpversion(); + if (strcmp('5.0.0',phpversion()) > 0) { + return false; } - if ($error['error_state']) { return false; } - return true; } // check_php_ver @@ -119,12 +93,9 @@ function check_php_ver($level=0) { function check_php_mysql() { if (!function_exists('mysql_query')) { - $error['error_state'] = true; - $error['php_mysql'] = false; + return false; } - if ($error['error_state']) { return false; } - return true; } // check_php_mysql @@ -137,12 +108,9 @@ function check_php_mysql() { function check_php_session() { if (!function_exists('session_set_save_handler')) { - $error['error_state'] = true; - $error['php_session'] = false; + return false; } - if ($error['error_state']) { return false; } - return true; } // check_php_session @@ -154,12 +122,9 @@ function check_php_session() { function check_php_iconv() { if (!function_exists('iconv')) { - $error['error_state'] = true; - $error['php_iconv'] = false; + return false; } - if ($error['error_state']) { return false; } - return true; } // check_php_iconv @@ -172,12 +137,9 @@ function check_php_iconv() { function check_php_pcre() { if (!function_exists('preg_match')) { - $error['error_state'] = true; - $error['php_pcre'] = false; + return false; } - if ($error['error_state']) { return false; } - return true; } // check_php_pcre @@ -188,34 +150,33 @@ function check_php_pcre() { least set the needed variables */ function check_config_values($conf) { - $error = new Error(); - if (!$conf['local_host']) { + + if (!$conf['database_hostname']) { return false; } - if (!$conf['local_db']) { + if (!$conf['database_name']) { return false; } - if (!$conf['local_username']) { + if (!$conf['database_username']) { return false; } - if (!$conf['local_pass']) { + if (!$conf['database_password']) { return false; } - if (!$conf['local_length']) { + if (!$conf['session_length']) { return false; } - if (!$conf['sess_name']) { + if (!$conf['session_name']) { return false; } - if (!isset($conf['sess_cookielife'])) { + if (!isset($conf['session_cookielife'])) { return false; } - if (!isset($conf['sess_cookiesecure'])) { + if (!isset($conf['session_cookiesecure'])) { return false; } if (isset($conf['debug'])) { if (!isset($conf['log_path'])) { - $error->add_error('log_path',_("You defined the option \"debug = on\" but didn't define a log path for the log to be stored")); return false; } } @@ -224,117 +185,6 @@ function check_config_values($conf) { } // check_config_values -/*! - @function debug_read_config - @discussion this is the same as the read config function - except it will pull config values with a # before them - (basicly adding a #config="value" check) and not - ever dieing on a config file error -*/ -function debug_read_config($config_file,$debug) { - - $fp = @fopen($config_file,'r'); - if(!is_resource($fp)) return false; - $file_data = fread($fp,filesize($config_file)); - fclose($fp); - - // explode the var by \n's - $data = explode("\n",$file_data); - if($debug) echo "
";
-	$count = 0;
-
-	if (!count($data)) { 
-		debug_event('debug_read_config','Error Unable to Read config file','1'); 	
-		return false; 
-	} 
-
-	$results = array();
-    
-	foreach($data as $value) {
-	        $count++;
-        
-	        $value = trim($value);
-       
-	        if (preg_match("/^#?([\w\d]+)\s+=\s+[\"]{1}(.*?)[\"]{1}$/",$value,$matches)
-	                        || preg_match("/^#?([\w\d]+)\s+=\s+[\']{1}(.*?)[\']{1}$/", $value, $matches)
-	                        || preg_match("/^#?([\w\d]+)\s+=\s+[\'\"]{0}(.*)[\'\"]{0}$/",$value,$matches)) {
-
-
-                	if (is_array($results[$matches[1]]) && isset($matches[2]) ) {
-	                        if($debug) echo "Adding value $matches[2] to existing key $matches[1]\n";
-	                        array_push($results[$matches[1]], $matches[2]);
-	                }
-
-	                elseif (isset($results[$matches[1]]) && isset($matches[2]) ) {
-	                        if($debug) echo "Adding value $matches[2] to existing key $matches[1]\n";
-        	                $results[$matches[1]] = array($results[$matches[1]],$matches[2]);
-	                }
-
-	                elseif ($matches[2] !== "") {
-	                        if($debug) echo "Adding value $matches[2] for key $matches[1]\n";
-	                        $results[$matches[1]] = $matches[2];
-        	        }
-
-	                // if there is something there and it's not a comment
-	                elseif ($value{0} !== "#" AND strlen(trim($value)) > 0 AND !$test AND strlen($matches[2]) > 0) {
-        	                echo "Error Invalid Config Entry --> Line:$count"; return false;
-	                } // elseif it's not a comment and there is something there
-	
-	                else {
-	                        if($debug) echo "Key $matches[1] defined, but no value set\n";
-	                }
-
-        	} // end else
-
-	} // foreach
-
-	if (isset($config_name) && isset(${$config_name}) && count(${$config_name})) {
-		$results[$config_name] = ${$config_name};
-	}
-
-	if($debug) echo "
"; - - return $results; - -} // debug_read_config - -/*! - @function debug_compare_configs - @discussion this takes two config files, and then compares - the results and returns an array of the values - that are missing from the first one passed -*/ -function debug_compare_configs($config,$dist_config) { - - - - /* Get the results from the two difference configs including #'d values */ - $results = debug_read_config($config,0); - $dist_results = debug_read_config($dist_config,0); - - $missing = array(); - - foreach ($dist_results as $key=>$value) { - - if (!isset($results[$key])) { - /* If it's an array we need to split it out */ - if (is_array($value)) { - foreach ($value as $element) { - $missing[$key][] = $element; - } - } - else { - $missing[$key] = $value; - } // end else not array - } // if it's not set - - } // end foreach conf - - return $missing; - -} // debug_compare_configs - - /** * check_putenv * This checks to see if we can manually set the diff --git a/lib/flag.php b/lib/flag.php deleted file mode 100644 index 8f3d0dff..00000000 --- a/lib/flag.php +++ /dev/null @@ -1,342 +0,0 @@ -"; - } -} - -function show_edit_badid3($songid,$flagid) -{ - $song = get_song_info($songid); - require(conf('prefix')."/templates/song_edit.inc"); -} - -function get_flag($id) -{ - if(!is_array($id)) $id = array($id); - $results = array(); - $newid = array_pop($id); - $sql = "SELECT flagged.id,user.username,type,song,date,comment" . - " FROM flagged,user WHERE flagged.user = user.username AND (flagged.song = '$newid'"; - foreach($id as $num) - { - $sql .= " OR flagged.song = '$num'"; - } - $sql .= ")"; - $result = mysql_query($sql, dbh()); - while ($row = mysql_fetch_array($result)) - { - $results[] = $row; - } - if(count($results) == 1) return $results[0]; - else return $results; -} - - -function get_flagged_songs($user = 0) -{ - $sql = "SELECT flagged.id,user.username,type,song,date,comment" . - " FROM flagged,user WHERE flagged.user = user.username AND flagged.type <> 'notify' AND flagged.type <> 'done'"; - - // If the user is not an admin, they can only see songs they've flagged - if($user) - { - if($_SESSION['userdata']['access'] === 'admin') - { - $sql .= " AND user.username = '$user'"; - } - else - { - $sql .= " AND user.username = '".$_SESSION['userdata']['username']."'"; - } - } - - $sql .= " ORDER BY date"; - $result = mysql_query($sql, dbh()); - - $arr = array(); - - while ($flag = mysql_fetch_array($result)) - { - $arr[] = $flag; - } - return $arr; -} - -function accept_new_tags($flags) -{ - if(!is_array($flags)) $flags = array($flags); - foreach($flags as $flag) - { - copy_updated_tag($flag); - } - set_flag_value($flags, 'setid3'); -} - - -function reject_new_tags($flags) -{ - if(!is_array($flags)) $flags = array($flags); - $oldflags = $flags; - $flag = array_pop($flags); - $sql = "DELETE FROM flagged_songs WHERE song = '$flag'"; - - foreach($flags as $flag) - { - $sql .= " OR song = '$flag'"; - } - $result = mysql_query($sql, dbh()); - $user = $_SESSION['userdata']['username']; - set_flag_value($oldflags, 'notify', "Tag changes rejected by $user"); -} - -function set_flag_value($flags, $val, $comment = '') -{ - if(!is_array($flags)) $flags = array($flags); - $user = $_SESSION['userdata']['id']; -/* $flagid = array_pop($flags);*/ - $dbh = dbh(); - foreach($flags as $flagid) - { - $sql = "REPLACE INTO flagged (type,song,comment,user,date)". - " VALUES ('$val','$flagid','$comment','$user','".time()."')"; - $result = mysql_query($sql, $dbh); - } - return $result; -} - -function copy_updated_tag($flag) -{ - $flagdata = get_flag($flag); - $sql = "SELECT * FROM flagged_song WHERE song = '".$flagdata['song']."'"; - $result = mysql_query($sql, dbh()); - $newtag = mysql_fetch_array($result); - - if($newtag['new_artist']) - { - $newtag['artist'] = insert_artist($newtag['new_artist']); - } - if($newtag['new_album']) - { - $newtag['album'] = insert_album($newtag['new_album']); - } - - $sql = "UPDATE song SET ". - "title = '".$newtag['title']."',". - "artist = '".$newtag['artist']."',". - "album = '".$newtag['album']."',". - "track = '".$newtag['track']."',". - "genre = '".$newtag['genre']."',". - "year = '".$newtag['year']."' ". - "WHERE song.id = '".$newtag['song']."'"; - $result = mysql_query($sql, dbh()); - if($result) - { - $sql2 = "DELETE FROM flagged_song WHERE song='".$flagdata['song']."'"; - $result2 = mysql_query($sql2, dbh()); - } - return ($result && $result2); - -} - -function update_flags($songs) -{ - $accepted = array(); - $rejected = array(); - $newflags = array(); - foreach($songs as $song) - { - $accept = scrub_in($_REQUEST[$song.'_accept']); - if($accept === 'accept') $accepted[] = $song; - elseif ($accept === 'reject') $rejected[] = $song; - else - { - $newflag = scrub_in($_REQUEST[$song.'_newflag']); - $newflags[$song] = $newflag; - } - } - - if(count($accepted)) - { - accept_new_tags($accepted); - } - if(count($rejected)) - { - reject_new_tags($rejected); - } - if(count($newflags)) - { - foreach($newflags as $flag=>$type) - { - set_flag_value($flag, $type); - } - } - -} - - -function update_song_info($song) -{ - $user = $_SESSION['userdata']; - - $title = scrub_in($_REQUEST['title']); - $track = scrub_in($_REQUEST['track']); - $genre = scrub_in($_REQUEST['genre']); - $year = scrub_in($_REQUEST['year']); - - if(isset($_REQUEST['update_id3'])) - $update_id3 = 1; - - if(isset($_REQUEST['new_artist']) && $_REQUEST['new_artist'] !== '') - { - $create_artist = 1; - $artist = scrub_in($_REQUEST['new_artist']); - } - else - $artist = scrub_in($_REQUEST['artist']); - - if(isset($_REQUEST['new_album']) && $_REQUEST['new_album'] !== '') - { - $create_album = 1; - $album = scrub_in($_REQUEST['new_album']); - } - else - $album = scrub_in($_REQUEST['album']); - - if(is_array($_REQUEST['genre'])) { - $genre = $genre[0]; - } - - if($user['access'] == 'admin') - // Update the file directly - { - if($create_artist) - { - $artist = insert_artist($artist); - } - if($create_album) - { - $album = insert_album($album); - } - // Escape data (prevent " or ' snafu's) - $title = sql_escape($title); - $artist = sql_escape($artist); - $album = sql_escape($album); - $genre = sql_escape($genre); - $year = sql_escape($year); - - $sql = "UPDATE song SET" . - " title = '$title'," . - " track = '$track'," . - " genre = '$genre'," . - " year = '$year'," . - " artist = '$artist',". - " album = '$album'," . - " update_time = '".time()."'" . - " WHERE id = '$song' LIMIT 1"; - $result = mysql_query($sql, dbh() ); - if($result && $update_id3 ) - { - //Add to flagged table so we can fix the id3 tags - $date = time(); - $sql = "REPLACE INTO flagged SET " . - " type = 'setid3', song = '$song', date = '$date', user = '".$user['id']."'"; - $result = mysql_query($sql, dbh()); - } - } - - else - // Stick in the flagged_songs table to be updated by an admin - { - if($create_artist) $artist_field = 'new_artist'; - else $artist_field = 'artist'; - - if($create_album) $album_field = 'new_album'; - else $album_field = 'album'; - - $sql = "INSERT INTO flagged_song(song,title,track,genre,year,$artist_field,$album_field,update_time) " . - "VALUES ('$song','$title','$track','$genre','$year','$artist','$album','".time()."')"; - $result = mysql_query($sql, dbh() ); - - if($result && $update_id3 ) - { - //Add to flagged table so we can fix the id3 tags - $date = time(); - $sql = "REPLACE INTO flagged SET " . - " type = 'newid3', song = '$song', date = '$date', user = '".$user['id']."'"; - $result = mysql_query($sql, dbh()); - } - echo "Thanks for helping to keep the catalog up to date. Someone will review your changes, and you will be notified on the main page when they're approved."; - - } -} - diff --git a/lib/general.lib.php b/lib/general.lib.php index cb4a1dea..bff578a1 100644 --- a/lib/general.lib.php +++ b/lib/general.lib.php @@ -1,7 +1,7 @@ "; - - $count = 0; - - foreach($data as $value) { - $count++; - - $value = trim($value); - - if (substr($value,0,1) == '#') { continue; } - - if (preg_match("/^([\w\d]+)\s+=\s+[\"]{1}(.*?)[\"]{1}$/",$value,$matches) - || preg_match("/^([\w\d]+)\s+=\s+[\']{1}(.*?)[\']{1}$/", $value, $matches) - || preg_match("/^([\w\d]+)\s+=\s+[\'\"]{0}(.*)[\'\"]{0}$/",$value,$matches)) { - - - if (is_array($results[$matches[1]]) && isset($matches[2]) ) { - if($debug) echo "Adding value $matches[2] to existing key $matches[1]\n"; - array_push($results[$matches[1]], $matches[2]); - } - - elseif (isset($results[$matches[1]]) && isset($matches[2]) ) { - if($debug) echo "Adding value $matches[2] to existing key $matches[1]\n"; - $results[$matches[1]] = array($results[$matches[1]],$matches[2]); - } - - elseif ($matches[2] !== "") { - if($debug) echo "Adding value $matches[2] for key $matches[1]\n"; - $results[$matches[1]] = $matches[2]; - } - - // if there is something there and it's not a comment - elseif ($value{0} !== "#" AND strlen(trim($value)) > 0 AND !$test AND strlen($matches[2]) > 0) { - echo "Error Invalid Config Entry --> Line:$count"; return false; - } // elseif it's not a comment and there is something there - - else { - if($debug) echo "Key $matches[1] defined, but no value set\n"; - } - - } // end else - - } // foreach - - if ($debug) { echo "\n"; } - - return $results; - -} // read_config - /* * Conf function by Robert Hopson * call it with a $parm name to retrieve @@ -164,7 +58,7 @@ function read_config($config_file, $debug=0, $test=0) { * to reset a var pass the array plus * Clobber! replaces global $conf; */ -function conf($param,$clobber=0) +/*function conf($param,$clobber=0) { static $params = array(); @@ -215,37 +109,7 @@ function error_results($param,$clobber=0) else return; } } //error_results - - -/** - * dbh - * Alias for the vauth_dbh function - */ -function dbh() { - - return vauth_dbh(); - -} // dbh - -/*! - @function fix_preferences - @discussion cleans up the preferences */ -function fix_preferences($results) { - - foreach ($results as $key=>$data) { - if (strcasecmp($data, "yes") == "0") { $data = 1; } - if (strcasecmp($data,"true") == "0") { $data = 1; } - if (strcasecmp($data,"enabled") == "0") { $data = 1; } - if (strcasecmp($data,"disabled") == "0") { $data = 0; } - if (strcasecmp($data,"false") == "0") { $data = 0; } - if (strcasecmp($data,"no") == "0") { $data = 0; } - $results[$key] = $data; - } - - return $results; - -} // fix_preferences /** * session_exists @@ -259,10 +123,10 @@ function session_exists($sid,$xml_rpc=0) { $found = true; - $sql = "SELECT * FROM session WHERE id = '$sid'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT * FROM `session` WHERE `id` = '$sid'"; + $db_results = Dba::query($sql); - if (!mysql_num_rows($db_results)) { + if (!Dba::num_rows($db_results)) { $found = false; } @@ -306,12 +170,12 @@ function session_exists($sid,$xml_rpc=0) { */ function extend_session($sid) { - $new_time = time() + conf('local_length'); + $new_time = time() + Config::get('local_length'); if ($_COOKIE['amp_longsess'] == '1') { $new_time = time() + 86400*364; } - $sql = "UPDATE session SET expire='$new_time' WHERE id='$sid'"; - $db_results = mysql_query($sql, dbh()); + $sql = "UPDATE `session` SET `expire`='$new_time' WHERE `id`='$sid'"; + $db_results = Dba::query($sql); } // extend_session @@ -601,8 +465,8 @@ function cleanup_and_exit($playing_id) { function get_global_popular($type) { $stats = new Stats(); - $count = conf('popular_threshold'); - $web_path = conf('web_path'); + $count = Config::get('popular_threshold'); + $web_path = Config::get('web_path'); /* Pull the top */ $results = $stats->get_top($count,$type); @@ -652,43 +516,6 @@ function get_global_popular($type) { } // get_global_popular -/** - * gen_newest - * Get a list of newest $type (which can then be handed to show_info_box - * @package Web Interface - * @catagory Get - * @todo Add Genre - */ -function get_newest ($type = 'artist',$limit='') { - - $dbh = dbh(); - - if (!$limit) { $limit = conf('popular_threshold'); } - - $sql = "SELECT DISTINCT $type FROM song ORDER BY addition_time " . - "DESC LIMIT " . conf('popular_threshold'); - $db_result = mysql_query($sql, $dbh); - - $items = array(); - - while ($r = mysql_fetch_array($db_result)) { - if ( $type == 'artist' ) { - $artist = new Artist($r[0]); - $artist->format_artist(); - $items[] = $artist; - - } - elseif ( $type == 'album' ) { - $album = new Album($r[0]); - $album->format(); - $album->link = $album->f_link; - $items[] = $album; - } - } - - return $items; -} // get_newest - /** * show_info_box * This shows the basic box that popular and newest stuff goes into @@ -698,9 +525,9 @@ function get_newest ($type = 'artist',$limit='') { */ function show_info_box ($title, $type, $items) { - $web_path = conf('web_path'); - $popular_threshold = conf('popular_threshold'); - require (conf('prefix') . '/templates/show_box.inc.php'); + $web_path = Config::get('web_path'); + $popular_threshold = Config::get('popular_threshold'); + require Config::get('prefix') . '/templates/show_box.inc.php'; } // show_info_box @@ -784,7 +611,7 @@ function scrub_out($str) { $str = stripslashes($str); } - $str = htmlentities($str,ENT_QUOTES,conf('site_charset')); + $str = htmlentities($str,ENT_QUOTES,Config::get('site_charset')); return $str; @@ -890,7 +717,7 @@ function logout() { vauth_logout(session_id()); /* Redirect them to the login page */ - header ('Location: ' . conf('web_path') . '/login.php'); + header ('Location: ' . Config::get('web_path') . '/login.php'); return true; @@ -976,10 +803,12 @@ function invert_boolean($value) { */ function get_user_from_username($username) { - $sql = "SELECT `id` FROM `user` WHERE `username`='" . sql_escape($username) . "'"; - $db_results = mysql_query($sql, dbh()); + $username = Dba::escape($username); - $results = mysql_fetch_assoc($db_results); + $sql = "SELECT `id` FROM `user` WHERE `username`='$username'"; + $db_results = Dba::query($sql); + + $results = Dba::fetch_assoc($db_results); $user = new User($results['id']); @@ -1037,5 +866,30 @@ function unhtmlentities ($string) { } // unhtmlentities +/** + * __autoload + * This function automatically loads any missing + * classes as they are called so that we don't have to have + * a million include statements, and load more then we need + */ +function __autoload($class) { + // Lowercase the class + $class = strtolower($class); + + $file = Config::get('prefix') . "/lib/class/$class.class.php"; + + // See if it exists + if (is_readable($file)) { + require_once $file; + if (is_callable($class . '::_auto_init')) { + call_user_func(array($class, '_auto_init')); + } + } + // Else log this as a fatal error + else { + debug_event('__autoload', "'$class' not found!",'1'); + } + +} // __autoload ?> diff --git a/lib/gettext.php b/lib/gettext.php index 4af41a59..ed929241 100644 --- a/lib/gettext.php +++ b/lib/gettext.php @@ -27,22 +27,22 @@ function load_gettext() { /* If we have gettext */ if (function_exists('bindtextdomain')) { - $lang = conf('lang'); + $lang = Config::get('lang'); putenv("LANG=" . $lang); putenv("LANGUAGE=" . $lang); /* Try lang, lang + charset and lang + utf-8 */ setlocale(LC_ALL, $lang, - $lang . '.'. conf('site_charset'), + $lang . '.'. Config::get('site_charset'), $lang . '.UTF-8', $lang . '.utf-8', - $lang . '.' . conf('lc_charset')); + $lang . '.' . Config::get('lc_charset')); /* Bind the Text Domain */ - bindtextdomain('messages', conf('prefix') . "/locale/"); + bindtextdomain('messages', Config::get('prefix') . "/locale/"); textdomain('messages'); if (function_exists('bind_textdomain_codeset')) { - bind_textdomain_codeset('messages',conf('site_charset')); + bind_textdomain_codeset('messages',Config::get('site_charset')); } // if we can codeset the textdomain } // If bindtext domain exists diff --git a/lib/init.php b/lib/init.php index 01d0c6c4..477b525e 100644 --- a/lib/init.php +++ b/lib/init.php @@ -31,7 +31,8 @@ error_reporting(E_ALL ^ E_NOTICE); $ampache_path = dirname(__FILE__); $prefix = realpath($ampache_path . "/../"); $configfile = "$prefix/config/ampache.cfg.php"; -require_once($prefix . "/lib/general.lib.php"); +require_once $prefix . '/lib/general.lib.php'; +require_once $prefix . '/lib/class/config.class.php'; /* Check to see if this is Http or https @@ -55,11 +56,10 @@ if (!file_exists($configfile)) { exit(); } -/* - Try to read the config file, if it fails give them - an explanation -*/ -if (!$results = read_config($configfile,0)) { +// Use the built in PHP function, supress errors here so we can handle it properly +$results = @parse_ini_file($configfile); + +if (!count($results)) { $path = preg_replace("/(.*)\/(\w+\.php)$/","\${1}", $_SERVER['PHP_SELF']); $link = $http_type . $_SERVER['HTTP_HOST'] . $path . "/test.php"; header ("Location: $link"); @@ -67,7 +67,7 @@ if (!$results = read_config($configfile,0)) { } /** This is the version.... fluf nothing more... **/ -$results['version'] = '3.4-Alpha1 (Build 001)'; +$results['version'] = '3.4-Alpha1 (Build 002)'; $results['int_config_version'] = '2'; $results['raw_web_path'] = $results['web_path']; @@ -87,96 +87,67 @@ if (!$results['raw_web_path']) { if (!$_SERVER['SERVER_NAME']) { $_SERVER['SERVER_NAME'] = ''; } -if (!isset($results['auth_methods'])) { - $results['auth_methods'] = array('mysql'); -} -if (!is_array($results['auth_methods'])) { - $results['auth_methods'] = array($results['auth_methods']); -} if (!$results['user_ip_cardinality']) { $results['user_ip_cardinality'] = 42; } if (!$results['local_length']) { - $results['local_length'] = '9000'; + $results['local_length'] = '900'; } /* Variables needed for vauth Module */ $results['cookie_path'] = $results['raw_web_path']; $results['cookie_domain'] = $_SERVER['SERVER_NAME']; -$results['cookie_life'] = $results['sess_cookielife']; -$results['session_name'] = $results['sess_name']; -$results['cookie_secure'] = $results['sess_cookiesecure']; -$results['session_length'] = $results['local_length']; -$results['mysql_password'] = $results['local_pass']; -$results['mysql_username'] = $results['local_username']; -$results['mysql_hostname'] = $results['local_host']; -$results['mysql_db'] = $results['local_db']; +$results['cookie_life'] = $results['session_cookielife']; +$results['cookie_secure'] = $results['session_cookiesecure']; +$results['mysql_password'] = $results['database_password']; +$results['mysql_username'] = $results['database_username']; +$results['mysql_hostname'] = $results['database_hostname']; +$results['mysql_db'] = $results['database_name']; + +// Define that we've loaded the INIT file +define('INIT_LOADED','1'); + +// Vauth Requires +require_once $prefix . '/modules/vauth/init.php'; + +// Library and module includes we can't do with the autoloader +require_once $prefix . '/lib/album.lib.php'; +require_once $prefix . '/lib/artist.lib.php'; +require_once $prefix . '/lib/song.php'; +require_once $prefix . '/lib/search.php'; +require_once $prefix . '/lib/preferences.php'; +require_once $prefix . '/lib/rss.php'; +require_once $prefix . '/lib/log.lib.php'; +require_once $prefix . '/lib/localplay.lib.php'; +require_once $prefix . '/lib/ui.lib.php'; +require_once $prefix . '/lib/gettext.php'; +require_once $prefix . '/lib/batch.lib.php'; +require_once $prefix . '/lib/themes.php'; +require_once $prefix . '/lib/stream.lib.php'; +require_once $prefix . '/lib/playlist.lib.php'; +require_once $prefix . '/lib/democratic.lib.php'; +require_once $prefix . '/lib/xmlrpc.php'; +require_once $prefix . '/modules/xmlrpc/xmlrpc.inc'; +require_once $prefix . '/modules/catalog.php'; +require_once $prefix . '/modules/getid3/getid3.php'; +require_once $prefix . '/modules/infotools/Snoopy.class.php'; +require_once $prefix . '/modules/infotools/AmazonSearchEngine.class.php'; +//require_once $prefix . '/modules/infotools/jamendoSearch.class.php'; /* Temp Fixes */ $results = fix_preferences($results); // Setup Static Arrays -conf($results); - -// Vauth Requires -require_once(conf('prefix') . '/modules/vauth/init.php'); - -// Librarys -require_once(conf('prefix') . '/lib/album.lib.php'); -require_once(conf('prefix') . '/lib/artist.lib.php'); -require_once(conf('prefix') . '/lib/song.php'); -require_once(conf('prefix') . '/lib/search.php'); -require_once(conf('prefix') . '/lib/preferences.php'); -require_once(conf('prefix') . '/lib/rss.php'); -require_once(conf('prefix') . '/lib/log.lib.php'); -require_once(conf('prefix') . '/lib/localplay.lib.php'); -require_once(conf('prefix') . '/lib/ui.lib.php'); -require_once(conf('prefix') . '/lib/gettext.php'); -require_once(conf('prefix') . '/lib/batch.lib.php'); -require_once(conf('prefix') . '/lib/themes.php'); -require_once(conf('prefix') . '/lib/stream.lib.php'); -require_once(conf('prefix') . '/lib/playlist.lib.php'); -require_once(conf('prefix') . '/lib/democratic.lib.php'); -require_once(conf('prefix') . '/modules/catalog.php'); -require_once(conf('prefix') . "/modules/id3/getid3/getid3.php"); -require_once(conf('prefix') . '/modules/id3/vainfo.class.php'); -require_once(conf('prefix') . '/modules/infotools/Snoopy.class.php'); -require_once(conf('prefix') . '/modules/infotools/AmazonSearchEngine.class.php'); -//require_once(conf('prefix') . '/modules/infotools/jamendoSearch.class.php'); -require_once(conf('prefix') . '/lib/xmlrpc.php'); -require_once(conf('prefix') . '/modules/xmlrpc/xmlrpc.inc'); +Config::set_by_array($results,1); // Modules (These are conditionaly included depending upon config values) -if (conf('ratings')) { - require_once(conf('prefix') . '/lib/class/rating.class.php'); - require_once(conf('prefix') . '/lib/rating.lib.php'); +if (Config::get('ratings')) { + require_once $prefix . '/lib/class/rating.class.php'; + require_once $prefix . '/lib/rating.lib.php'; } - -// Classes -require_once(conf('prefix') . '/lib/class/localplay.class.php'); -require_once(conf('prefix') . '/lib/class/plugin.class.php'); -require_once(conf('prefix') . '/lib/class/stats.class.php'); -require_once(conf('prefix') . '/lib/class/catalog.class.php'); -require_once(conf('prefix') . '/lib/class/stream.class.php'); -require_once(conf('prefix') . '/lib/class/playlist.class.php'); -require_once(conf('prefix') . '/lib/class/tmp_playlist.class.php'); -require_once(conf('prefix') . '/lib/class/song.class.php'); -require_once(conf('prefix') . '/lib/class/view.class.php'); -require_once(conf('prefix') . '/lib/class/update.class.php'); -require_once(conf('prefix') . '/lib/class/user.class.php'); -require_once(conf('prefix') . '/lib/class/album.class.php'); -require_once(conf('prefix') . '/lib/class/artist.class.php'); -require_once(conf('prefix') . '/lib/class/access.class.php'); -require_once(conf('prefix') . '/lib/class/error.class.php'); -require_once(conf('prefix') . '/lib/class/genre.class.php'); -require_once(conf('prefix') . '/lib/class/flag.class.php'); -require_once(conf('prefix') . '/lib/class/audioscrobbler.class.php'); - - /* Set a new Error Handler */ -$old_error_handler = set_error_handler("ampache_error_handler"); - +$old_error_handler = set_error_handler('ampache_error_handler'); /* Initilize the Vauth Library */ vauth_init($results); @@ -192,35 +163,8 @@ if ($results['memory_limit'] < 24) { } set_memory_limit($results['memory_limit']); -// Check Session GC mojo, increase if need be -$gc_probability = @ini_get('session.gc_probability'); -$gc_divisor = @ini_get('session.gc_divisor'); - -if (!$gc_divisor) { - $gc_divisor = '100'; -} -if (!$gc_probability) { - $gc_probability = '1'; -} - -// Force GC on 1:5 page loads -if (($gc_divisor / $gc_probability) > 5) { - $new_gc_probability = $gc_divisor * .2; - ini_set('session.gc_probability',$new_gc_probability); -} - -/* Seed the random number */ -srand((double) microtime() * 1000003); - /**** END Set PHP Vars ****/ -/* Check to see if they've tried to set no_session via get/post */ -if (isset($_POST['no_session']) || isset($_GET['no_session'])) { - /* just incase of register globals */ - unset($no_session); - debug_event('no_session','No Session passed as get/post','1'); -} - /* We have to check for HTTP Auth */ if (in_array("http",$results['auth_methods'])) { @@ -237,24 +181,22 @@ if (in_array("http",$results['auth_methods'])) { } // end if http auth -// If we don't want a session -if (NO_SESSION != '1' AND conf('use_auth')) { +// If we want a session +if (NO_SESSION != '1' AND Config::get('use_auth')) { /* Verify Their session */ if (!vauth_check_session()) { logout(); exit; } /* Create the new user */ - $user = get_user_from_username($_SESSION['userdata']['username']); - + $GLOBALS['user'] = User::get_from_username($_SESSION['userdata']['username']); + /* If they user ID doesn't exist deny them */ - if (!$user->uid AND !conf('demo_mode')) { logout(); exit; } + if (!$GLOBALS['user']->id AND !Config::get('demo_mode')) { logout(); exit; } /* Load preferences and theme */ - init_preferences(); set_theme(); - $user->set_preferences(); - $user->update_last_seen(); + $GLOBALS['user']->update_last_seen(); } -elseif (!conf('use_auth')) { +elseif (!Config::get('use_auth')) { $auth['success'] = 1; $auth['username'] = '-1'; $auth['fullname'] = "Ampache User"; @@ -262,37 +204,38 @@ elseif (!conf('use_auth')) { $auth['access'] = "admin"; $auth['offset_limit'] = 50; if (!vauth_check_session()) { vauth_session_create($auth); } - $user = new User(-1); - $user->fullname = 'Ampache User'; - $user->offset_limit = $auth['offset_limit']; - $user->username = '-1'; - $user->access = $auth['access']; + $GLOBALS['user'] = new User(-1); + $GLOBALS['user']->fullname = 'Ampache User'; + $GLOBALS['user']->offset_limit = $auth['offset_limit']; + $GLOBALS['user']->username = '-1'; + $GLOBALS['user']->access = $auth['access']; $_SESSION['userdata']['username'] = $auth['username']; - $user->set_preferences(); - init_preferences(); set_theme(); } +// If Auth, but no session is set else { if (isset($_REQUEST['sessid'])) { $sess_results = vauth_get_session($_REQUEST['sessid']); session_id(scrub_in($_REQUEST['sessid'])); session_start(); } - $user = get_user_from_username($sess_results['username']); - init_preferences(); + $GLOBALS['user'] = User::get_from_username($sess_results['username']); } +// Load the Preferences from the database +init_preferences(); + /* Add in some variables for ajax done here because we need the user */ $ajax_info['ajax_url'] = $results['web_path'] . '/server/ajax.server.php'; -$ajax_info['ajax_info'] = '&user_id=' . $user->id . '&sessid=' . session_id(); -conf($ajax_info); +$ajax_info['ajax_info'] = '&user_id=' . $GLOBALS['user']->id; +Config::set_by_array($ajax_info); unset($ajax_info); // Load gettext mojo load_gettext(); /* Set CHARSET */ -header ("Content-Type: text/html; charset=" . conf('site_charset')); +header ("Content-Type: text/html; charset=" . Config::get('site_charset')); /* Clean up a bit */ unset($array); @@ -301,19 +244,14 @@ unset($results); /* Setup the flip class */ flip_class(array('odd','even')); -/* Setup the Error Class */ -$error = new Error(); - /* Set the Theme */ -$theme = get_theme(conf('theme_name')); +$theme = get_theme(Config::get('theme_name')); +/* Check to see if we need to perform an update */ if (! preg_match('/update\.php/', $_SERVER['PHP_SELF'])) { - $update = new Update(); - if ($update->need_update()) { - header("Location: " . conf('web_path') . "/update.php"); + if (Update::need_update()) { + header("Location: " . Config::get('web_path') . "/update.php"); exit(); } } - -unset($update); ?> diff --git a/lib/log.lib.php b/lib/log.lib.php index 1b2d33e5..66d7263f 100644 --- a/lib/log.lib.php +++ b/lib/log.lib.php @@ -33,7 +33,7 @@ function log_event($username='Unknown',$event_name,$event_description,$log_name= /* must have some name */ if (!strlen($log_name)) { $log_name = 'ampache'; } - $log_filename = conf('log_path') . "/$log_name." . date("Ymd",$log_time) . ".log"; + $log_filename = Config::get('log_path') . "/$log_name." . date("Ymd",$log_time) . ".log"; $log_line = date("Y-m-d H:i:s",$log_time) . " { $username } ( $event_name ) - $event_description \n"; $log_write = error_log($log_line, 3, $log_filename); @@ -109,7 +109,7 @@ function ampache_error_handler($errno, $errstr, $errfile, $errline) { */ function debug_event($type,$message,$level,$file='',$username='') { - if (!conf('debug') || $level > conf('debug_level')) { + if (!Config::get('debug') || $level > Config::get('debug_level')) { return false; } diff --git a/lib/preferences.php b/lib/preferences.php index b1448d94..7e8cc62c 100644 --- a/lib/preferences.php +++ b/lib/preferences.php @@ -175,29 +175,27 @@ function update_preference($username,$name,$pref_id,$value) { } // update_preference -/*! - @function has_preference_access - @discussion makes sure that the user has sufficient - rights to actually set this preference, handle - as allow all, deny X - //FIXME: - // This is no longer needed, we just need to check against preferences.level -*/ +/** + * has_preference_access + * makes sure that the user has sufficient + * rights to actually set this preference, handle + * as allow all, deny X + */ function has_preference_access($name) { /* If it's a demo they don't get jack */ - if (conf('demo_mode')) { + if (Config::get('demo_mode')) { return false; } - $name = sql_escape($name); + $name = Dba::escape($name); /* Check Against the Database Row */ - $sql = "SELECT level FROM preferences " . - "WHERE name='$name'"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT `level` FROM `preferences` " . + "WHERE `name`='$name'"; + $db_results = Dba::query($sql); - $data = mysql_fetch_assoc($db_results); + $data = Dba::fetch_assoc($db_results); $level = $data['level']; @@ -207,7 +205,7 @@ function has_preference_access($name) { return false; -} // has_preference_access +} //has_preference_access /*! @@ -423,28 +421,27 @@ function insert_preference($name,$description,$default,$level,$type,$catagory) { */ function init_preferences() { - /* Get Global Preferences */ $sql = "SELECT preferences.name,user_preference.value FROM preferences,user_preference WHERE user_preference.user='-1' " . " AND user_preference.preference = preferences.id AND preferences.catagory='system'"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $name = $r['name']; $results[$name] = $r['value']; } // end while sys prefs /* Now we need to allow the user to override some stuff that's been set by the above */ $user_id = '-1'; - if ($GLOBALS['user']->username) { - $user_id = sql_escape($GLOBALS['user']->id); + if ($GLOBALS['user']->id) { + $user_id = Dba::escape($GLOBALS['user']->id); } $sql = "SELECT preferences.name,user_preference.value FROM preferences,user_preference WHERE user_preference.user='$user_id' " . " AND user_preference.preference = preferences.id AND preferences.catagory != 'system'"; - $db_results = mysql_query($sql, dbh()); + $db_results = Dba::query($sql); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $name = $r['name']; $results[$name] = $r['value']; } // end while @@ -454,9 +451,7 @@ function init_preferences() { $results['theme_path'] = '/themes/' . $results['theme_name']; } - conf($results,1); - - return true; + Config::set_by_array($results,1); } // init_preferences @@ -529,4 +524,25 @@ function fix_all_users_prefs() { } // fix_all_users_prefs +/** + * fix_preferences + * This takes the preferences, explodes what needs to + * become an array and boolean everythings + */ +function fix_preferences($results) { + + $results['auth_methods'] = explode(",",$results['auth_methods']); + $results['tag_order'] = explode(",",$results['tag_order']); + $results['album_art_order'] = explode(",",$results['album_art_order']); + $results['amazon_base_urls'] = explode(",",$results['amazon_base_urls']); + + foreach ($results as $key=>$data) { + if (strcasecmp($data,"true") == "0") { $results[$key] = 1; } + if (strcasecmp($data,"false") == "0") { $results[$key] = 0; } + } + + return $results; + +} // fix_preferences + ?> diff --git a/lib/song.php b/lib/song.php index 57fab392..5a26d183 100644 --- a/lib/song.php +++ b/lib/song.php @@ -88,12 +88,12 @@ function get_recently_played() { "FROM object_count " . "WHERE object_type='song' " . "ORDER by object_count.date DESC " . - "LIMIT " . conf('popular_threshold'); - $db_results = mysql_query($sql, dbh()); + "LIMIT " . Config::get('popular_threshold'); + $db_results = Dba::query($sql); $results = array(); - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $results[] = $r; } @@ -101,16 +101,6 @@ function get_recently_played() { } // get_recently_played -/*! - @function format_song - @discussion takes a song array and makes it html friendly -*/ -function format_song($song) { - - return $song; - -} // format_song - /** * get_popular_songs * This returns the current popular songs diff --git a/lib/stream.lib.php b/lib/stream.lib.php index d4163ab5..39901d31 100644 --- a/lib/stream.lib.php +++ b/lib/stream.lib.php @@ -58,13 +58,13 @@ function gc_now_playing() { $time = time(); $expire = $time - 3200; // 86400 seconds = 1 day - $session_id = sql_escape($_REQUEST['sid']); + $session_id = Dba::escape($_REQUEST['sid']); if (strlen($session_id)) { $session_sql = " OR session = '$session_id'"; } $sql = "DELETE FROM now_playing WHERE start_time < $expire" . $session_sql; - $db_result = mysql_query($sql, dbh()); + $db_result = Dba::query($sql); } // gc_now_playing @@ -101,9 +101,9 @@ function insert_now_playing($song_id,$uid,$song_length) { $sql = "INSERT INTO now_playing (`song_id`, `user`, `start_time`,`session`)" . " VALUES ('$song_id', '$uid', '$expire','$session_id')"; - $db_result = mysql_query($sql, dbh()); + $db_result = Dba::query($sql); - $insert_id = mysql_insert_id(dbh()); + $insert_id = Dba::insert_id(); return $insert_id; diff --git a/lib/themes.php b/lib/themes.php index 1ce57dae..f2f27740 100644 --- a/lib/themes.php +++ b/lib/themes.php @@ -68,8 +68,8 @@ function get_theme($name) { if (strlen($name) < 1) { return false; } - $config_file = conf('prefix') . "/themes/" . $name . "/theme.cfg.php"; - $results = read_config($config_file); + $config_file = Config::get('prefix') . "/themes/" . $name . "/theme.cfg.php"; + $results = parse_ini_file($config_file); $results['path'] = $name; return $results; @@ -116,9 +116,9 @@ function set_theme_colors($theme_name,$user_id) { */ function set_theme() { - if (strlen(conf('theme_name')) > 0) { - $theme_path = "/themes/" . conf('theme_name'); - conf(array('theme_path'=>$theme_path),1); + if (strlen(Config::get('theme_name')) > 0) { + $theme_path = "/themes/" . Config::get('theme_name'); + Config::set(array('theme_path'=>$theme_path),1); } } // set_theme diff --git a/lib/ui.lib.php b/lib/ui.lib.php index e86aa185..a4668bc4 100644 --- a/lib/ui.lib.php +++ b/lib/ui.lib.php @@ -76,10 +76,8 @@ function flip_class($array=0) { */ function clear_now_playing() { - $sql = "TRUNCATE TABLE now_playing"; - $db_results = mysql_query($sql, dbh()); - - return true; + $sql = "TRUNCATE TABLE `now_playing`"; + $db_results = Dba::query($sql); } // clear_now_playing @@ -89,11 +87,11 @@ function clear_now_playing() { * if it isn't it defines it as a simple return */ if (!function_exists('_')) { - function _($string) { + function _($string) { return $string; - } // _ + } // if _ isn't defined /** @@ -223,9 +221,9 @@ function truncate_with_ellipsis($text, $max=27) { /* Make sure the functions exist before doing the iconv mojo */ if (function_exists('iconv') && function_exists('iconv_substr') && function_exists('iconv_strlen')) { - if (iconv_strlen($text, conf('site_charset')) > $max) { - $text = iconv_substr($text, 0, $max-3, conf('site_charset')); - $text .= iconv("ISO-8859-1", conf('site_charset'), "..."); + if (iconv_strlen($text, Config::get('site_charset')) > $max) { + $text = iconv_substr($text, 0, $max-3, Config::get('site_charset')); + $text .= iconv("ISO-8859-1", Config::get('site_charset'), "..."); } } @@ -247,7 +245,7 @@ function truncate_with_ellipsis($text, $max=27) { */ function show_footer() { - require_once(conf('prefix') . '/templates/footer.inc'); + require_once Config::get('prefix') . '/templates/footer.inc'; } // show_footer @@ -257,10 +255,9 @@ function show_footer() { */ function show_now_playing() { - $dbh = dbh(); - $web_path = conf('web_path'); + $web_path = Config::get('web_path'); $results = get_now_playing(); - require (conf('prefix') . "/templates/show_now_playing.inc"); + require Config::get('prefix') . '/templates/show_now_playing.inc'; } // show_now_playing @@ -296,15 +293,15 @@ function show_play_selected() { */ function get_now_playing($filter='') { - $sql = "SELECT song_id,user FROM now_playing ORDER BY id DESC"; - $db_results = mysql_query($sql, dbh()); + $sql = "SELECT `song_id`,`user` FROM `now_playing` ORDER BY `id` DESC"; + $db_results = Dba::query($sql); $results = array(); /* While we've got stuff playing */ - while ($r = mysql_fetch_assoc($db_results)) { + while ($r = Dba::fetch_assoc($db_results)) { $song = new Song($r['song_id']); - $song->format_song(); + $song->format(); $np_user = new User($r['user']); $results[] = array('song'=>$song,'user'=>$np_user); } // end while @@ -468,7 +465,7 @@ function show_all_popular() { $songs = get_global_popular('song'); $genres = get_global_popular('genre'); - require_once(conf('prefix') . '/templates/show_all_popular.inc.php'); + require_once Config::get('prefix') . '/templates/show_all_popular.inc.php'; } // show_all_popular @@ -480,12 +477,12 @@ function show_all_popular() { * @catagory Display * @author Karl Vollmer */ -function show_all_recent() { +function show_all_recent($limit='') { - $artists = get_newest('artist'); - $albums = get_newest('album'); + $artists = Stats::get_newest('artist',$limit); + $albums = Stats::get_newest('album',$limit); - require_once(conf('prefix') . '/templates/show_all_recent.inc.php'); + require_once Config::get('prefix') . '/templates/show_all_recent.inc.php'; } // show_all_recent @@ -497,47 +494,24 @@ function show_all_recent() { */ function show_local_catalog_info() { - $dbh = dbh(); - /* Before we display anything make sure that they have a catalog */ $query = "SELECT * FROM catalog"; - $db_results = mysql_query($query, $dbh); - if (!mysql_num_rows($db_results)) { + $db_results = Dba::query($query); + + // Make sure we have something to display + if (!Dba::num_rows($db_results)) { show_box_top(); $items[] = "" . _('No Catalogs Found!') . "
"; - $items[] = "" ._('Add a Catalog') . ""; + $items[] = "" ._('Add a Catalog') . ""; show_info_box('','catalog',$items); show_box_bottom(); return false; } - $query = "SELECT count(*) AS songs, SUM(size) AS size, SUM(time) as time FROM song"; - $db_result = mysql_query($query, $dbh); - $songs = mysql_fetch_assoc($db_result); - - $query = "SELECT count(*) FROM album"; - $db_result = mysql_query($query, $dbh); - $albums = mysql_fetch_row($db_result); - - $query = "SELECT count(*) FROM artist"; - $db_result = mysql_query($query, $dbh); - $artists = mysql_fetch_row($db_result); - - $sql = "SELECT count(*) FROM user"; - $db_result = mysql_query($sql, $dbh); - $users = mysql_fetch_row($db_result); + $results = Catalog::get_stats(); - $time = time(); - $last_seen_time = $time - 1200; - $sql = "SELECT count(DISTINCT s.username) FROM session AS s " . - "INNER JOIN user AS u ON s.username = u.username " . - "WHERE s.expire > " . $time . " " . - "AND u.last_seen > " . $last_seen_time; - $db_result = mysql_query($sql, $dbh); - $connected_users = mysql_fetch_row($db_result); - - $hours = floor($songs['time']/3600); - $size = $songs['size']/1048576; + $hours = floor($results['time']/3600); + $size = $results['size']/1048576; $days = floor($hours/24); $hours = $hours%24; @@ -556,23 +530,30 @@ function show_local_catalog_info() { $size_unit = "MB"; } - require(conf('prefix') . "/templates/show_local_catalog_info.inc.php"); + require Config::get('prefix') . '/templates/show_local_catalog_info.inc.php'; } // show_local_catalog_info -/*! - @function img_resize - @discussion this automaticly resizes the image for thumbnail viewing - only works on gif/jpg/png this function also checks to make - sure php-gd is enabled +/** + * img_resize + * this automaticly resizes the image for thumbnail viewing + * only works on gif/jpg/png this function also checks to make + * sure php-gd is enabled */ -function img_resize($image,$size,$type){ +function img_resize($image,$size,$type,$album_id) { /* Make sure they even want us to resize it */ - if (!conf('resize_images')) { - return false; + if (!Config::get('resize_images')) { + return $image['art']; + } + // Already resized + if ($image['resized']) { + debug_event('using_resized','using resized image for Album:' . $album_id,'2'); + return $image['art']; } + $image = $image['art']; + if (!function_exists('gd_info')) { return false; } /* First check for php-gd */ @@ -604,6 +585,8 @@ function img_resize($image,$size,$type){ return false; } + ob_start(); + // determine image type and send it to the client switch ($type) { case 'jpg': @@ -618,6 +601,21 @@ function img_resize($image,$size,$type){ break; } + // Grab this image data and save it into the thumbnail + $data = ob_get_contents(); + ob_end_clean(); + + // If our image create failed don't save it, just return + if (!$data) { + debug_event('IMG_RESIZE','Failed to resize Art from Album:' . $album_id,'3'); + return $image; + } + + // Save what we've got + Album::save_resized_art($data,'image/' . $type,$album_id); + + return $data; + } // img_resize /** @@ -692,14 +690,14 @@ function show_artist_pulldown ($artist_id,$select_name='artist') { */ function show_catalog_pulldown ($name='catalog',$style) { - $sql = "SELECT id,name FROM catalog ORDER BY name"; - $db_result = mysql_query($sql, dbh()); + $sql = "SELECT `id`,`name` FROM `catalog` ORDER BY `name`"; + $db_result = Dba::query($sql); echo "\n\n"; echo "\t\n"; - while ($r = mysql_fetch_assoc($db_result)) { + while ($r = Dba::fetch_assoc($db_result)) { if ($width > 0) { $r['name'] = truncate_with_ellipsis($r['name'],$width); @@ -1183,7 +1180,7 @@ function show_user_select($name,$selected='',$style='') { */ function show_box_top($title='') { - require (conf('prefix') . '/templates/show_box_top.inc.php'); + require Config::get('prefix') . '/templates/show_box_top.inc.php'; } // show_box_top @@ -1194,7 +1191,7 @@ function show_box_top($title='') { */ function show_box_bottom() { - require (conf('prefix') . '/templates/show_box_bottom.inc.php'); + require Config::get('prefix') . '/templates/show_box_bottom.inc.php'; } // show_box_bottom @@ -1224,21 +1221,21 @@ function get_user_icon($name,$hover_name='') { $icon_name = 'icon_' . $name . '.png'; /* Build the image url */ - if (file_exists(conf('prefix') . '/themes/' . $GLOBALS['theme']['path'] . '/images/' . $icon_name)) { - $img_url = conf('web_path') . conf('theme_path') . '/images/' . $icon_name; + if (file_exists(Config::get('prefix') . '/themes/' . Config::get('theme_path') . '/images/' . $icon_name)) { + $img_url = Config::get('web_path') . Config::get('theme_path') . '/images/' . $icon_name; } else { - $img_url = conf('web_path') . '/images/' . $icon_name; + $img_url = Config::get('web_path') . '/images/' . $icon_name; } /* If Hover, then build its url */ if (!empty($hover_name)) { $hover_icon = 'icon_' . $hover_name . '.png'; - if (file_exists(conf('prefix') . '/themes/' . $GLOBALS['theme']['path'] . '/images/' . $icon_name)) { - $hov_url = conf('web_path') . conf('theme_path') . '/images/' . $hover_icon; + if (file_exists(Config::get('prefix') . '/themes/' . Config::get('theme_path') . '/images/' . $icon_name)) { + $hov_url = Config::get('web_path') . Config::get('theme_path') . '/images/' . $hover_icon; } else { - $hov_url = conf('web_path') . '/images/' . $hover_icon; + $hov_url = Config::get('web_path') . '/images/' . $hover_icon; } $hov_txt = "onMouseOver=\"this.src='$hov_url'; return true;\" onMouseOut=\"this.src='$img_url'; return true;\""; diff --git a/login.php b/login.php index 71bd52c4..fa44a925 100644 --- a/login.php +++ b/login.php @@ -1,7 +1,7 @@ check('interface',$_SERVER['REMOTE_ADDR'],'','5')) { +if (Config::get('access_control')) { + if (!Access::check('interface',$_SERVER['REMOTE_ADDR'],'','5')) { debug_event('access_denied','Access Denied:' . $_SERVER['REMOTE_ADDR'] . ' is not in the Interface Access list','3'); access_denied(); } @@ -63,7 +56,7 @@ if ($_POST['username'] && $_POST['password']) { } /* If we are in demo mode let's force auth success */ - if (conf('demo_mode')) { + if (Config::get('demo_mode')) { $auth['success'] = 1; $auth['info']['username'] = "Admin- DEMO"; $auth['info']['fullname'] = "Administrative User"; @@ -73,8 +66,8 @@ if ($_POST['username'] && $_POST['password']) { $username = scrub_in($_POST['username']); $password = scrub_in($_POST['password']); $auth = authenticate($username, $password); - $user = get_user_from_username($username); - + $user = User::get_from_username($username); + if ($user->disabled == '1') { $auth['success'] = false; $auth['error'] = _('User Disabled please contact Admin'); @@ -82,8 +75,8 @@ if ($_POST['username'] && $_POST['password']) { elseif (!$user->username AND $auth['success']) { /* This is run if we want to auto_create users who don't exist (usefull for non mysql auth) */ - if (conf('auto_create')) { - if (!$access = conf('auto_user')) { $access = '5'; } + if (Config::get('auto_create')) { + if (!$access = Config::get('auto_user')) { $access = '5'; } $name = $auth['name']; $email = $auth['email']; @@ -123,8 +116,8 @@ if ($auth['success']) { // // Record the IP of this person! // - if (conf('track_user_ip')) { - $user = get_user_from_username($username); + if (Config::get('track_user_ip')) { + $user = User::get_from_username($username); $user->insert_ip_history(); unset($user); } @@ -132,7 +125,7 @@ if ($auth['success']) { /* Make sure they are actually trying to get to this site and don't try to redirect them back into * an admin section **/ - if (substr($_POST['referrer'],0,strlen(conf('web_path'))) == conf('web_path') AND + if (substr($_POST['referrer'],0,strlen(Config::get('web_path'))) == Config::get('web_path') AND !strstr($_POST['referrer'],"install.php") AND !strstr($_POST['referrer'],"login.php") AND !strstr($_POST['referrer'],"update.php") AND @@ -142,39 +135,20 @@ if ($auth['success']) { header("Location: " . $_POST['referrer']); exit(); } // if we've got a referrer - header("Location: " . conf('web_path') . "/index.php"); + header("Location: " . Config::get('web_path') . "/index.php"); exit(); } // auth success /* If auth failed then setup the error */ else { - $GLOBALS['error']->add_error('general',$auth['error']); + Error::add('general',$auth['error']); } -$htmllang = str_replace("_","-",conf('lang')); -?> - - - - - - - - - <?php echo conf('site_title'); ?> - - - - - -\n"; show_box_top(_('Message of the Day')); - include conf('prefix') . '/config/motd.php'; + include Config::get('prefix') . '/config/motd.php'; show_box_bottom(); echo "\n"; } diff --git a/modules/getid3/docs/changelog.txt b/modules/getid3/docs/changelog.txt new file mode 100644 index 00000000..0a1fb11f --- /dev/null +++ b/modules/getid3/docs/changelog.txt @@ -0,0 +1,491 @@ +// +----------------------------------------------------------------------+ +// | PHP version 5 | +// +----------------------------------------------------------------------+ +// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen | +// +----------------------------------------------------------------------+ +// | This source file is subject to version 2 of the GPL license, | +// | that is bundled with this package in the file license.txt and is | +// | available through the world-wide-web at the following url: | +// | http://www.gnu.org/copyleft/gpl.html | +// +----------------------------------------------------------------------+ +// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org | +// +----------------------------------------------------------------------+ +// | Authors: James Heinrich | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | Changelog | +// +----------------------------------------------------------------------+ +// +// $Id: changelog.txt,v 1.47 2007/02/12 10:00:15 ah Exp $ + + + + » denotes a major feature addition/change + ¤ denotes a change in the returned structure + ! denotes a cry for help from developers +* Bugfix: denotes a fixed bug + + +getID3() 2.x Version History +============================ + + +2.0.0b4: [2007-01-12] Allan Hansen + + GENERAL + » Major update to readme.txt + » Added new section sample apps + » Added well-written sample application "morg". + See sample_apps/morg/screen_shots for more + ¤ option_tags_process now generates root key 'comments' with merged + values from 'tags'. + ¤ Removed option_tags_html. HTML entities is a thing of the past. + Use UTF-8 encoded pages instead. Saves bandwidth and is much easier. + * Bugfix: PHP_NOTICE issue in BigEndian2Float(). + » Tag writing support: ID3v1 + » Tag writing support: APEtag + » Tag writing support: FLAC + » Tag writing support: Ogg Vorbis + » Tag writing support: Lyrics3 + » SVG file detection (no parsing) + » PAR2 file detection (no parsing) + » Got rid of windowed and option_helperapps_dir. Helper apps must be + somewhere in the path, e.g. c:\windows\system32 or /usr/bin + + ASF MODULE: + * Bugfix: Wrong mime type (video/x-ms-wma instead of video/x-ms-wmv) + for certain FourCCs. + * Bugfix: Padding offset bug. + + DATA_HASH MODULE: + ¤ copy md5_data_source to md5_data if option set to true + + DTS MODULE: + » New module (module.audio.dts.php) + + FLV MODULE: + * Bugfix: DivByZero on zero length FLV files. + * Bugfix: PHP_NOTICE one some files. + + ID3v1 MODULE: + ¤ Removed: Padding check. + + ID3v2 MODULE: + * Bugfix: PHP_NOTICE issues with broken ID3v2 tag/garbage. + * Bugfix: UTF-8/16 encoded frames terminated by \x00. + * Bugfix: ID3v2 LINK frames iconv error. + * Bugfix: Padding length calculated incorrectly. + * Bugfix: ID3v2.3 extended headers non-conformance. + + LYRICS3 MODULE + * Bugfix: Minor issues with lyrics3 (avoid PHP_NOTICE). + + PNG MODULE: + * Bugfix: Module broken in regards to gIFg and gIFx chunks. + + MIDI MODULE + * Bugfix: Minor issues with midi module (avoid PHP_NOTICE). + + MP3 MODULE: + * Bugfix: Removed whitespace after ?> + * Bugfix: Some CBR MP3 files detected as VBR with plenty of warnings. + * Bugfix: PHP_NOTICE issues. + + MPC MODULE: + ¤ Mime type returned: audio/x-musepack + + QUICKTIME MODULE: + * Bugfix: TYPO in variable, resulting in unknown errors. + * Bugfix: Incorrect frame rate returned. + + REAL MODULE: + * Bugfix: fread() zero bytes issue. + + RIFF MODULE: + * Bugfix: Wave files being detected as MP3. + ¤ Zero sized chunk invokes warning instead of error. + + SHORTEN MODULE: + * Bugfix: Not working for wav files with fmt chunks <> 16 bytes. + + XIPH MODULE: + » replaygain_reference_loudness from FLAC 1.1.3 moved from comments + to ['replay_gain']['reference_volume']. + » Supporting FLAC 1.1.3 PICTURE block. + ¤ FLAC: Removed some ['raw'] keys. + + +2.0.0b3: [2006-06-25] Allan Hansen + + AAC_ADTS MODULE + * Bugfix: Static bitrate cache wrong result when parsing several files + + ASF MODULE + * Bugfix: Do not return NULL video bitrate for ASF v3. + * Bugfix: ['codec'] key warning in module.audio-video.asf.php from 1.7.6, + * Bugfix: audio & video bitrates sometimes wrong in ASF files from 1.7.6, + ¤ ASF lyrics now returned under [comments][lyrics] from 1.7.5, + + BMP MODULE + * Bugfix: Undocumented bugfix between 1.7.3 and 1.7.6, + + DATA_HASH MODULE + * Bugfix: Filenames not escaped with escapeshellarg() under UNIX. + * Bugfix: UNIX: head and tail called with -cNNN instead of "-c NNN". + + FLV MODULE + » No longer reads entire file into memory. + + ID3v1 MODULE + ¤ Put back id3v1 padding check, since it exists in 1.7.6. + + ID3v2 MODULE + * Bugfix: PHP notices on bad ID3v2 frames from 1.7.6. + * Bugfix: 'url_source' typo in module.tag.id3v2.php from 1.7.3. + ¤ ID3v2 "TDRC" frame now used as "year" in comments if TYER + unavailable (TYER is deprecated in ID3v2.4) + ¤ Bugfix: gmmktime() instead of mktime(). + + ISO MODULE + ¤ Using gmmktime() instead of mktime(). + + GZIP MODULE + ! Module is a memory hog. Reads entire file into memory. It also + gzdeflates() it to memory. Will use lots of memory on huge files. + Please someone rewrite it to work with filepointers and seeking. + » info['gzip']['files'] removed. Contains redundant information only. + » Replaced ['tar'] key with ['parsed_content']. Module can now parse + anything that getID3() can parse - not just tar files. + + JPEG MODULE + * Bugfix: Error when php exif support enabled. + + LYRICS MODULE + ¤ Comments are no longer trimmed. + + QUICKTIME MODULE + * Bugfix: incorrect dimensions from disabled Quicktime tracks from 1.7.6, + ¤ Added ['quicktime']['hinting'] key (boolean) from 1.7.4, + * Bugfix: Quicktime 'mvhd' matrix values were wrong from 1.7.3, + + MIDI MODULE + * Bugfix: Fixed bug that reported wrong playing time on some files. + + MP3 MODULE + » Module fully working. + » Memory caches are reset when scanning new file. Might make analyse + slightly slower, but will save lots of memory. + » Removed unrecommended bruteforce code. + * Bugfix: Encoder options should now return proper "--alt-preset n" / + "--alt-preset cbr n" when scanning more files. + * Bugfix: added LAME preset guessing for presets 410,420,440,490 + (thanks adminØlogbud*com) + + RIFF MODULE + ¤ No longer returns zero bits_per_sample for multiple formats. + * Bugfix: Missing 'lossless' key in RIFF-WAV from 1.7.4. + ¤ Using gmmktime() instead of mktime(). + + SHORTEN MODULE + * Bugfix: Filenames not escaped with escapeshellarg() under UNIX. + + TAR MODULE + » Module rewritten to work with filepointer only. Makes parsing a lot + faster (will fseek() past data). Also saves a lot of memory, expecially + with large files. + » Added warning for non ASCII filenames, which breaks specification. + » info['tar']['files'] removed. Contains redundant information only. Also + causes problems for non ASCII tar files, as filenames are used as keys + in PHP arrays. + + XIPH MODULE + * Bugfix: Error message when padding in FLAC files were used up. + + ZIP MODULE + ¤ Using gmmktime() instead of mktime(). + + ICONV_REPLACEMENT MODULE + * Bugfix: Major UTF-8 to UTF-16/ISO-8859-1 conversion bug (empty string + returned) when iconv() not available - from 1.7.4. + * Bugfix: Other major bugfixes that broke the module. + + demo.joinmp3.php + Demo removed - out of getID3()'s scope. + + PDF files can now be detected, but not parsed/analyzed. + MSOffice files can now be detected, but not parsed/analyzed. + + +2.0.0b2: [2004-11-01] Allan Hansen + + GENERAL + * Bugfixes: Analyzed 3,000 files and compared result with 1.7.2 - several + minor bugs were fixed. Output of 2.0.0 should match 1.7.2 reasonable well. + * Bugfix: fail_id3 and fail_ape code never executed. + Wavpack4 support + Quicktime/MP3-in-MP4, Apple Lossless support + » New encoding_id3v2 option/hack for broken ID3v2 tags + ¤ Tags are no longer trim()ed. + ¤ Some ['bits_per_sample'] == 0 removed + » New option_analyze - disable to detect format only. + » New option_accurate_results - disable to greatly speed up parsing of + AAC/ADTS, headerless MP3/MP2 VBR, midi (later), possible more in future. + Warnings issued when disabled and accuracy affected! + + AAC/ADTS + » Memory caches destroyed after analyze() to free up memory. + + LA MODULE + * Bugfix: RIFF tags now parsed properly + + OPTIMFROG MODULE + * Bugfix: RIFF tags now parsed properly + + WAVPACK MODULE + * Bugfix: RIFF trailer now parsed properly + + QUICKTIME MODULE + ¤ option_extra_info determines whether atom_data is returned + ¤ Removed $ParseAllPossibleAtoms option. We should only return useful data. + zlib support in PHP optional reqirement + * Bugfix: New iTunes crashes PHP - temp fix - no tags on those files. + + RIFF MODULE + * Bugfix: Wavpack3 extra fields now parsed properly. + ¤ RIFF tags in Litewave files now parsed properly + + BONK MODULE + * Bugfix: ['bonk']['ID3']['valid'] now returns bool instead of object + + NSV MODULE + * Bugfix: PCM part ignored + + APETAG MODULE + * Bugfix: APEtag 1.0 broken + + ASF MODULE + ¤ Embedded ID3v2 tags processes again - supported by Windows Media Player. + + DEMOS + » demo.browse.php scans directories faster with inaccurate results. + » demo.browse.php now uses javascript alert to show longer warnings etc + instead of tool tips. + » demo.browse.php now shows embedded covers just like the 1.7.x demo. + » demo.browse.dhtml.php - DHTML version of the browser. Has progressive + display in MSIE - but quite slow when scanning LOTS of files. + » New demo.mime_only.php for returning mime type only. + » Search example in demo.mysql.php + + +2.0.0b1: [2004-08-23] Allan Hansen + + » Major memory savings. 1.7.1 use 25% more memory under PHP 5.0.0 than + PHP 4.3.7. 2.0.0b1 memory usage is comparable to 1.7.1 under PHP 4.3.7. + See Memory.xls for details (will not be included in 2.0.0 final). + Loading all modules requires 4,277 kb of memory (4,171 with iconv() + support in PHP. Some of the modules require more memory while scanning, + as they cache the results - MP3 and AAC/ADTS in particular. + + » New internal testing method. Output of 2.0.0 matches that of 1.7.1 + exactly - except those places where we deliberately changed something. + If something is changed it is because we did not have a test file + to show it. + + » New extras directory. + This contains multiple usefull code snips that really does not + belong to the main getID3() codebase - i.e. stuff that the user most + likely can/will do differently. + + » Deleted getid3_lib.php + - Some common functions moved to getid3.php - getid3_lib declared + there. + - Replaygain function moved to getid3.php - new class + geti3_replaygain. + - iconv() replacement function moved to new lib module. + - md5/sha1 data hash function moved to new lib module. + - Some function moved to the files that use them. + - CopyTagsToComments() moved to extras dir. + - EmbeddedLookup() gone - PHP5 use way more memory that way. + + » magic_quotes_runtime must be disabled before running getID3(). + If you use them, use set_magic_quotes_runtime(0) and + set_magic_quotes_runtime(1) around your getID3() block. + Older versions turned them on and off automatically. This would + require a lot extra code, since they needed being restored before + every first level throw. + + * Bugfix: Fixed multiple bugs in the caching extentions . + + Optimized most modules using new getid3_ReadSequence() + + Checked all(most) code using error_reporting (E_STRICT | E_ALL) + + ¤ Removed all dead modules: EXE, RAR, Bink, Matroska, MOD*. + ¤ Kept magic bytes - getid3 will detect them and do nothing and return + warning instead of error. + + ¤ Disabled quicktime and mpeg modules as they depend on mp3- + + Reformatted and updated dependencies.txt + + + GETID3 MAIN + ¤ getid3 option_tags_html now defaults to false. + ¤ getid3 option_max_2gb_check now defaults to false. + ¤ New getid3 option_tags_images defaults to false. Scan tags for binary + image data - ID3v2 and vorbiscomments only. Possible apetag later. + + + JPEG MODULE + ¤ Renamed module from jpg to jpeg. + ¤ Changed mime type to correct image/jpeg. + ¤ Added optional exif depency to depencies.txt for jpeg files. + + + PNG MODULE + ¤ Made png zlib dependecy optional. + + + BMP MODULE + » Removed unused and unneeded PlotBMP() in bmp module. + Removed extract_palette and extract_data code + - This does not belong in getid3. We should analyze files, not process + them. If the user wants to display bmp files to the browser she can + convert them with ImageMagick or something similar. She will + probably have it installed already to resize user uploaded images. + + + PCD MODULE + » Removed $ExtractData from pcd module - same reason as BMP. + + + SWF MODULE + ¤ Added zlib dependecy REQUIRED for swf. + + + ID3v1 MODULE + ¤ Removed id3v1 padding check - who cares? + - also removed in lyrics3 - if needed - it needs to be done differently + - no access to warnings and no sorting! + + + ID3v2 MODULE + ¤ Made id3v2 zlib dependecy optional. + ¤ id3v2 - images - changed 'image_mime' to actual mime type. + + + AAC MODULE(s) + » Split aac module in two - aac_adif and aac_adts. + This saves memory if user only have files of one type (very likely). + Replaced getid3_lib::Bin2Dec() with bindec() in aac modules - speed. + + + AC3 MODULE + Added ac3 optional dependency to dependencies.txt. + ¤ Changed riff module dependency on mp3 to optional. + Changed wawpack references in riff module to wavpack3. + * Bugfix: RIFFparseWavPackHeader() needs 28 bytes, not 22. + + + ASF MODULE + » Removed id3v1 dependency + » Removed id3v2 dependency + ¤ ASF genres are no longer case adjustet to match standard ID3v1 ones. + ¤ Embedded ID3v2 tags no longer processes. Not part of the ASF spec. + ¤ Changed warning at line 71 to error. + » Removed a lot of unneeded conversions between Bytestring and GUID + » Changed the constants from bytestring to GUID + * Bugfix: Fixed incorrect warning messages on + {4B1ACBE3-100B-11D0-A39B-00A0C90348F6} + {4CFEDB20-75F6-11CF-9C0F-00A0C90349CB} + ¤ Removed objectid, fileid, reserved_1_id and reserved where 'same'_guid + exists. + + + MP3 MODULE + ¤ MARKED MP3 MODULE BROKEN + Removed echoerrors debugcode in mp3 module. + Removed bruteforce code in mp3 module - never executed in 1.7. + Removed $scan_as_cbr - not used. + + + MPC MODULE(s) + » Split mpc module in two - SV7 in "mpc" and SV4-6 in mpc_old. + This saves memory if user only have files of one type (very likely). + + + OGG, FLAC MODULES + » Merged interdependant modules ogg and flac into new module xiph. + ¤ Updated FLACapplicationIDLookup() with 2 new entries. + + + REAL MODULE + ¤ Removed 'unknown' keys. + + + SHORTEN MODULE + » Improved UNIX shorten binary detection. Scanning `which shorten`, + /usr/bin, /usr/local/bin and checking is_executable() + + + ISO MODULE + ¤ Removed unused_ indexes in iso modules - they are afterall not used. + + + DEMOS + » Created new index.php in demos/ explaining what the different demos + does. + + » Rewrote demo.browse.php completely. + - Using public domain HTML abstraction library by Allan Hansen. + - Removed security breach - able to browse any parent directory . + - A $root_path must be set before browsing. + - Screen width option. + - Compressed filename column using title=. + - Removed filesize column - not really that interesting. + - Removed md5data column. + - Removed total at the bottom - the user can probably figure out + how to implement this himself. + - Added Audio column: sample_rate/bits_per_sample/channels columns. + - Added scan_time columns - how long it took getid3 to process the + file. + - Compressed artist, title and warning column using tool_tips. + - Removed delete feature - possible security risk. + - Repeating file header every 20 rows. + - Added audio format/video format to format column. + - Listing supported php modules in footer. + - New colour scheme. + + » Rewrote demo.mysql.php completely. + - Using multiple tables instead of just one. No string is stored + twice. Searching tags should be a lot faster for large databases. + - Multiple artists, titles, genres, etc per file supported. + - Using public domain HTML abstraction library by Allan Hansen. + - Using public domain MySQL abstraction library by Allan Hansen. + - Scanning limited to $audio_path - security. + - Included sample data that can be imported and browsed. + + » Rewrote demo.basic.php + » Removed demo.simple.php - basic should be enough + + » Removed demo.joinmp3.php - this advanced demo should go in the extras + module IF/WHEN the mp3 module is running again. + + ¤ Updated demo.audioinfo.class - minor changes. + + + MISC CODING SPECIFIC + Partial new coding style - some is easily changed with Replace In Files + - New file header - PEAR compatible + - Indentation with four spaces instead of tab - PEAR compatible + - array() changed to as array () - as suggested by PEAR standard + - All(most) function names in MixedCase + - Variables in $my_variable lowercase/underscores + - (bool) $var changed to (bool)$var + - A few "} else {" changed to "else {" to make room for easier + readable comments + + Removed all DivByZero checks. The plan was to catch them, but php + errors and warnings are not exceptions... Something needs to be + done here. + diff --git a/modules/getid3/docs/dependencies.txt b/modules/getid3/docs/dependencies.txt new file mode 100644 index 00000000..df7e5b95 --- /dev/null +++ b/modules/getid3/docs/dependencies.txt @@ -0,0 +1,79 @@ +// +----------------------------------------------------------------------+ +// | PHP version 5 | +// +----------------------------------------------------------------------+ +// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen | +// +----------------------------------------------------------------------+ +// | This source file is subject to version 2 of the GPL license, | +// | that is bundled with this package in the file license.txt and is | +// | available through the world-wide-web at the following url: | +// | http://www.gnu.org/copyleft/gpl.html | +// +----------------------------------------------------------------------+ +// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org | +// +----------------------------------------------------------------------+ +// | Authors: James Heinrich | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | Dependencies | +// +----------------------------------------------------------------------+ +// +// $Id: dependencies.txt,v 1.9 2006/11/16 22:39:59 ah Exp $ + + + +READER MODULES: + + asf riff module required + + bonk id3v2 module optional + + id3v2 id3v1 module required + zlib php support optional + + gzip zlib php support optional + + jpeg exif php support optional + + la riff module required + + lpac riff module required + + lyrics3 apetag module optional + + mpeg mp3 module required + + optimfrog riff module required + + png zlib php support optional + + quicktime mp3 module required + zlib php support optional + + riff mp3 module optional + ac3 module optional + dts module optional + mpeg module optional + + shn shorten binary (shorten.exe on windows) required + + swf zlib php support required + + wavpack riff module required + + xiph vorbiscomment binary (vorbiscomment.exe on windows) for md5/sha1 data hashes on ogg vorbis files. + + + +WRITER MODULES: + + apetag apetag (reader) module required + id3v1 (reader) module required + lyrics3 (reader) module required + + id3v1 id3v1(reader) module required + + lyrics3 lyrics3 (reader) module required + id3v1 (reader) module required + + flac metaflac binary + + vorbis vorbiscomment binary \ No newline at end of file diff --git a/modules/getid3/docs/license.commercial.txt b/modules/getid3/docs/license.commercial.txt new file mode 100644 index 00000000..416e5a14 --- /dev/null +++ b/modules/getid3/docs/license.commercial.txt @@ -0,0 +1,27 @@ + getID3() Commercial License + =========================== + +getID3() is licensed under the "GNU Public License" (GPL) and/or the +"getID3() Commercial License" (gCL). This document describes the gCL. + +--------------------------------------------------------------------- + +The license is non-exclusively granted to a single person or company, +per payment of the license fee, for the lifetime of that person or +company. The license is non-transferrable. + +The gCL grants the licensee the right to use getID3() in commercial +closed-source projects. Modifications may be made to getID3() with no +obligation to release the modified source code. getID3() (or pieces +thereof) may be included in any number of projects authored (in whole +or in part) by the licensee. + +The licensee may use any version of getID3(), past, present or future, +as is most convenient. This license does not entitle the licensee to +receive any technical support, updates or bugfixes, except as such are +made publicly available to all getID3() users. + +The licensee may not sub-license getID3() itself, meaning that any +commercially released product containing all or parts of getID3() must +have added functionality beyond what is available in getID3(); +getID3() itself may not be re-licensed by the licensee. diff --git a/modules/getid3/docs/license.txt b/modules/getid3/docs/license.txt new file mode 100644 index 00000000..9fec8082 --- /dev/null +++ b/modules/getid3/docs/license.txt @@ -0,0 +1,340 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. diff --git a/modules/getid3/docs/readme.txt b/modules/getid3/docs/readme.txt new file mode 100644 index 00000000..d582cd5d --- /dev/null +++ b/modules/getid3/docs/readme.txt @@ -0,0 +1,537 @@ +// +----------------------------------------------------------------------+ +// | PHP version 5 | +// +----------------------------------------------------------------------+ +// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen | +// +----------------------------------------------------------------------+ +// | This source file is subject to version 2 of the GPL license, | +// | that is bundled with this package in the file license.txt and is | +// | available through the world-wide-web at the following url: | +// | http://www.gnu.org/copyleft/gpl.html | +// +----------------------------------------------------------------------+ +// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org | +// +----------------------------------------------------------------------+ +// | Authors: James Heinrich | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | Dependencies | +// +----------------------------------------------------------------------+ +// +// $Id: readme.txt,v 1.6 2006/12/03 19:46:04 ah Exp $ + + This code is released under the GNU GPL: + http://www.gnu.org/copyleft/gpl.html + + +---------------------------------------------+ + | If you do use this code somewhere, send me | + | an email and tell me how/where you used it. | + | | + | If you want to donate, there is a link on | + | http://www.getid3.org for PayPal donations. | + +---------------------------------------------+ + + + +Quick Start +=========================================================================== + +Q: How can I check that getID3() works on my server/files? +A: Unzip getID3() to a directory, then access /demos/demo.browse.php + + + +Sourceforge Notification +=========================================================================== + +It's highly recommended that you sign up for notification from +Sourceforge for when new versions are released. Please visit: +http://sourceforge.net/project/showfiles.php?group_id=55859 +and click the little "monitor package" icon/link. If you're +previously signed up for the mailing list, be aware that it has +been discontinued, only the automated Sourceforge notification +will be used from now on. + + + +What does getID3() do? +=========================================================================== + +Reads & parses (to varying degrees): + ¤ tags: + * APE (v1 and v2) + * ID3v1 (& ID3v1.1) + * ID3v2 (v2.4, v2.3, v2.2) + * Lyrics3 (v1 & v2) + + ¤ audio-lossy: + * MP3/MP2/MP1 + * MPC / Musepack + * Ogg (Vorbis, OggFLAC, Speex) + * RealAudio + * Speex + * VQF + + ¤ audio-lossless: + * AIFF + * AU + * Bonk + * CD-audio (*.cda) + * FLAC + * LA (Lossless Audio) + * LPAC + * MIDI + * Monkey's Audio + * OptimFROG + * RKAU + * VOC + * WAV (RIFF) + * WavPack + + ¤ audio-video: + * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV) + * AVI (RIFF) + * Flash + * MPEG-1 / MPEG-2 + * NSV (Nullsoft Streaming Video) + * Quicktime + * RealVideo + + ¤ still image: + * BMP + * GIF + * JPEG + * PNG + + ¤ data: + * ISO-9660 CD-ROM image (directory structure) + * SZIP (limited support) + * ZIP (directory structure) + + +Writes: + * ID3v1 (& ID3v1.1) + * ID3v2 (v2.3 & v2.4) + * VorbisComment on OggVorbis + * VorbisComment on FLAC (not OggFLAC) + * APE v2 + * Lyrics3 (delete only) + + + +Requirements +=========================================================================== + +* PHP 4.2.0 (or higher) for getID3() 1.7.8 (and up). +* PHP 5.0.0 (or higher) for getID3() 2.0.0 (and up). +* at least 4MB memory for PHP. 8MB is highly recommended. + 12MB is required with all modules loaded. + + + +Usage +=========================================================================== + +See /demos/demo.basic.php for a very basic use of getID3() with no +fancy output, just scanning one file. + +See structure.txt for the returned data structure. + +*> For an example of a complete directory-browsing, <* +*> file-scanning implementation of getID3(), please run <* +*> /demos/demo.browse.php <* + +See /demos/demo.mysql.php for a sample recursive scanning code that +scans every file in a given directory, and all sub-directories, stores +the results in a database and allows various analysis / maintenance +operations + +To analyze remote files over HTTP or FTP you need to copy the file +locally first before running getID3(). Your code would look something +like this: + +// Copy remote file locally to scan with getID3() +$remotefilename = 'http://www.example.com/filename.mp3'; +if ($fp_remote = fopen($remotefilename, 'rb')) { + $localtempfilename = tempnam('/tmp', 'getID3'); + if ($fp_local = fopen($localtempfilename, 'wb')) { + while ($buffer = fread($fp_remote, 8192)) { + fwrite($fp_local, $buffer); + } + fclose($fp_local); + + // Initialize getID3 engine + $getID3 = new getID3; + + $ThisFileInfo = $getID3->analyze($filename); + + // Delete temporary file + unlink($localtempfilename); + } + fclose($fp_remote); +} + + +See /demos/demo.write.php for how to write tags. + + + +What does the returned data structure look like? +=========================================================================== + +See structure.txt + +It is recommended that you look at the output of +/demos/demo.browse.php scanning the file(s) you're interested in to +confirm what data is actually returned for any particular filetype in +general, and your files in particular, as the actual data returned +may vary considerably depending on what information is available in +the file itself. + + + +Notes +=========================================================================== + +getID3() 1.7: +If the format parser encounters a critical problem, it will return +something in $fileinfo['error'], describing the encountered error. If +a less critical error or notice is generated it will appear in +$fileinfo['warning']. Both keys may contain more than one warning or +error. If something is returned in ['error'] then the file was not +correctly parsed and returned data may or may not be correct and/or +complete. If something is returned in ['warning'] (and not ['error']) +then the data that is returned is OK - usually getID3() is reporting +errors in the file that have been worked around due to known bugs in +other programs. Some warnings may indicate that the data that is +returned is OK but that some data could not be extracted due to +errors in the file. + +getID3() 2.0: +See above except errors are thrown (so you will only get one error). + + + +Disclaimer +=========================================================================== + +getID3() has been tested on many systems, on many types of files, +under many operating systems, and is generally believe to be stable +and safe. That being said, there is still the chance there is an +undiscovered and/or unfixed bug that may potentially corrupt your +file, especially within the writing functions. By using getID3() you +agree that it's not my fault if any of your files are corrupted. +In fact, I'm not liable for anything :) + + + +License +=========================================================================== + +GNU General Public License - see license.txt + +This program is free software; you can redistribute it and/or +modify it under the terms of the GNU General Public License +as published by the Free Software Foundation; either version 2 +of the License, or (at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to: +Free Software Foundation, Inc. +59 Temple Place - Suite 330 +Boston, MA 02111-1307, USA. + +FAQ: +Q: Can I use getID3() in my program? Do I need a commercial license? +A: You're generally free to use getID3 however you see fit. The only + case in which you would require a commercial license is if you're + selling your closed-source program that integrates getID3. If you + sell your program including a copy of getID3, that's fine as long + as you include a copy of the sourcecode when you sell it. Or you + can distribute your code without getID3 and say "download it from + getid3.sourceforge.net" + + + +Future Plans +=========================================================================== + +* Writing support for Real +* Better support for MP4 container format +* Support for Matroska (www.matroska.org) + http://corecodec.com/modules.php?op=modload&name=PNphpBB2&file=viewtopic&t=227 +* Scan for appended ID3v2 tag at end of file per ID3v2.4 specs (Section 5.0) +* Support for JPEG-2000 (http://www.morgan-multimedia.com/jpeg2000_overview.htm) +* Support for MOD (mod/stm/s3m/it/xm/mtm/ult/669) +* Support for ACE (thanks Vince) +* Support for Ogg other than Vorbis, Speex and OggFlac (ie. Ogg+Xvid) +* Ability to create Xing/LAME VBR header for VBR MP3s that are missing VBR header +* Ability to "clean" ID3v2 padding (replace invalid padding with valid padding) +* Warn if MP3s change version mid-stream (in full-scan mode) +* check for corrupt/broken mid-file MP3 streams in histogram scan +* Support for lossless-compression formats + (http://www.firstpr.com.au/audiocomp/lossless/#Links) + (http://compression.ca/act-sound.html) + (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm) +* Support for RIFF-INFO chunks + * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html + (thanks Nick Humfrey ) + * http://abcavi.narod.ru/sof/abcavi/infotags.htm + (thanks Kibi) +* Better support for Bink video +* http://www.hr/josip/DSP/AudioFile2.html +* http://www.pcisys.net/~melanson/codecs/ +* Detect mp3PRO +* Support for PSD +* Support for JPC +* Support for JP2 +* Support for JPX +* Support for JB2 +* Support for IFF +* Support for ICO +* Support for ANI +* Support for EXE (comments, author, etc) (thanks p*quaedackersØplanet*nl) +* Support for DVD-IFO (region, subtitles, aspect ratio, etc) + (thanks p*quaedackersØplanet*nl) +* More complete support for SWF - parsing encapsulated MP3 and/or JPEG content + (thanks n8n8Øyahoo*com) +* Support for a2b +* Optional scan-through-frames for AVI verification + (thanks rockcohenØmassive-interactive*nl) +* Support for TTF (thanks infoØbutterflyx*com) +* Support for DSS (http://www.getid3.org/phpBB2/viewtopic.php?t=171) +* Support for SMAF (http://smaf-yamaha.com/what/demo.html) + http://www.getid3.org/phpBB2/viewtopic.php?t=182 +* Support for AMR (http://www.getid3.org/phpBB2/viewtopic.php?t=195) +* Support for 3gpp (http://www.getid3.org/phpBB2/viewtopic.php?t=195) +* Support for ID4 (http://www.wackysoft.cjb.net grizlyY2KØhotmail*com) +* Parse XML data returned in Ogg comments +* Parse XML data from Quicktime SMIL metafiles (klausrathØmac*com) +* ID3v2 genre string creator function +* More complete parsing of JPG +* Support for all old-style ASF packets +* ASF/WMA/WMV tag writing +* Parse declared T??? ID3v2 text information frames, where appropriate + (thanks Christian Fritz for the idea) +* Recognize encoder: + http://www.guerillasoft.com/EncSpot2/index.html + http://ff123.net/identify.html + http://www.hydrogenaudio.org/?act=ST&f=16&t=9414 + http://www.hydrogenaudio.org/?showtopic=11785 +* Support for other OS/2 bitmap structures: Bitmap Array('BA'), + Color Icon('CI'), Color Pointer('CP'), Icon('IC'), Pointer ('PT') + http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm +* Support for WavPack RAW mode +* ASF/WMA/WMV data packet parsing +* ID3v2FrameFlagsLookupTagAlter() +* ID3v2FrameFlagsLookupFileAlter() +* obey ID3v2 tag alter/preserve/discard rules +* http://www.geocities.com/SiliconValley/Sector/9654/Softdoc/Illyrium/Aolyr.htm +* proper checking for LINK/LNK frame validity in ID3v2 writing +* proper checking for ASPI-TLEN frame validity in ID3v2 writing +* proper checking for COMR frame validity in ID3v2 writing +* http://www.geocities.co.jp/SiliconValley-Oakland/3664/index.html +* decode GEOB ID3v2 structure as encoded by RealJukebox, + decode NCON ID3v2 structure as encoded by MusicMatch + (probably won't happen - the formats are proprietary) + + + +Known Bugs/Issues in getID3() that may be fixed eventually +=========================================================================== + +* Cannot determine bitrate for MPEG video with VBR video data + (need documentation) +* Interlace/progressive cannot be determined for MPEG video + (need documentation) +* MIDI playtime is sometimes inaccurate +* AAC-RAW mode files cannot be identified +* WavPack-RAW mode files cannot be identified +* mp4 files report lots of "Unknown QuickTime atom type" + (need documentation) +* Encrypted ASF/WMA/WMV files warn about "unhandled GUID + ASF_Content_Encryption_Object" +* Bitrate split between audio and video cannot be calculated for + NSV, only the total bitrate. (need documentation) +* All Ogg formats (Vorbis, OggFLAC, Speex) are affected by the + problem of large VorbisComments spanning multiple Ogg pages, but + but only OggVorbis files can be processed with vorbiscomment. +* The version of "head" supplied with Mac OS 10.2.8 (maybe other + versions too) does only understands a single option (-n) and + therefore fails. getID3 ignores this and returns wrong md5_data. + + + +Known Bugs/Issues in getID3() that cannot be fixed +-------------------------------------------------- + +* Files larger than 2GB (of any format) cannot be parsed by + getID3() due to limitations in the PHP filesystem functions + + + +Known Bugs/Issues in other programs +----------------------------------- + +* Winamp (up to v2.80 at least) does not support ID3v2.4 tags, + only ID3v2.3 + see: http://forums.winamp.com/showthread.php?postid=387524 +* Some versions of Helium2 (www.helium2.com) do not write + ID3v2.4-compliant Frame Sizes, even though the tag is marked + as ID3v2.4) (detected by getID3()) +* MP3ext V3.3.17 places a non-compliant padding string at the end + of the ID3v2 header. This is supposedly fixed in v3.4b21 but + only if you manually add a registry key. This fix is not yet + confirmed. (detected by getID3()) +* CDex v1.40 (fixed by v1.50b7) writes non-compliant Ogg comment + strings, supposed to be in the format "NAME=value" but actually + written just "value" (detected by getID3()) +* Oggenc 0.9-rc3 flags the encoded file as ABR whether it's + actually ABR or VBR. +* iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably + other versions are too) writes ID3v2.3 comment tags using a + frame name 'COM ' which is not valid for ID3v2.3+ (it's an + ID3v2.2-style frame name) (detected by getID3()) +* MP2enc does not encode mono CBR MP2 files properly (half speed + sound and double playtime) +* MP2enc does not encode mono VBR MP2 files properly (actually + encoded as stereo) +* tooLAME does not encode mono VBR MP2 files properly (actually + encoded as stereo) +* AACenc encodes files in VBR mode (actually ABR) even if CBR is + specified +* AAC/ADIF - bitrate_mode = cbr for vbr files +* LAME 3.90-3.92 prepends one frame of null data (space for the + LAME/VBR header, but it never gets written) when encoding in CBR + mode with the DLL +* Ahead Nero encodes TwinVQF with a DSIZ value (which is supposed + to be the filesize in bytes) of "0" for TwinVQF v1.0 and "1" for + TwinVQF v2.0 (detected by getID3()) +* Ahead Nero encodes TwinVQF files 1 second shorter than they + should be +* AAC-ADTS files are always actually encoded VBR, even if CBR mode + is specified (the CBR-mode switches on the encoder enable ABR + mode, not CBR as such, but it's not possible to tell the + difference between such ABR files and true VBR) +* STREAMINFO.audio_signature in OggFLAC is always null. "The reason + it's like that is because there is no seeking support in + libOggFLAC yet, so it has no way to go back and write the + computed sum after encoding. Seeking support in Ogg FLAC is the + #1 item for the next release." - Josh Coalson (FLAC developer) + NOTE: getID3() will calculate md5_data in a method similar to + other file formats, but that value cannot be compared to the + md5_data value from FLAC data in a FLAC file format. +* STREAMINFO.audio_signature is not calculated in FLAC v0.3.0 & + v0.4.0 - getID3() will calculate md5_data in a method similar to + other file formats, but that value cannot be compared to the + md5_data value from FLAC v0.5.0+ +* RioPort (various versions including 2.0 and 3.11) tags ID3v2 with + a WCOM frame that has no data portion +* Earlier versions of Coolplayer adds illegal ID3 tags to Ogg Vorbis + files, thus making them corrupt. +* Meracl ID3 Tag Writer v1.3.4 (and older) incorrectly truncates the + last byte of data from an MP3 file when appending a new ID3v1 tag. + (detected by getID3()) +* Lossless-Audio files encoded with and without the -noseek switch + do actually differ internally and therefore cannot match md5_data +* iTunes has been known to append a new ID3v1 tag on the end of an + existing ID3v1 tag when ID3v2 tag is also present + (detected by getID3()) + + + + +Reference material: +=========================================================================== + +[www.id3.org material now mirrored at http://id3lib.sourceforge.net/id3/] +* http://www.id3.org/id3v2.4.0-structure.txt +* http://www.id3.org/id3v2.4.0-frames.txt +* http://www.id3.org/id3v2.4.0-changes.txt +* http://www.id3.org/id3v2.3.0.txt +* http://www.id3.org/id3v2-00.txt +* http://www.id3.org/mp3frame.html +* http://minnie.tuhs.org/pipermail/mp3encoder/2001-January/001800.html +* http://www.dv.co.yu/mpgscript/mpeghdr.htm +* http://www.mp3-tech.org/programmer/frame_header.html +* http://users.belgacom.net/gc247244/extra/tag.html +* http://gabriel.mp3-tech.org/mp3infotag.html +* http://www.id3.org/iso4217.html +* http://www.unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT +* http://www.xiph.org/ogg/vorbis/doc/framing.html +* http://www.xiph.org/ogg/vorbis/doc/v-comment.html +* http://leknor.com/code/php/class.ogg.php.txt +* http://www.id3.org/iso639-2.html +* http://www.id3.org/lyrics3.html +* http://www.id3.org/lyrics3200.html +* http://www.psc.edu/general/software/packages/ieee/ieee.html +* http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html +* http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html +* http://www.jmcgowan.com/avi.html +* http://www.wotsit.org/ +* http://www.herdsoft.com/ti/davincie/davp3xo2.htm +* http://www.mathdogs.com/vorbis-illuminated/bitstream-appendix.html +* "Standard MIDI File Format" by Dustin Caldwell (from www.wotsit.org) +* http://midistudio.com/Help/GMSpecs_Patches.htm +* http://www.xiph.org/archives/vorbis/200109/0459.html +* http://www.replaygain.org/ +* http://www.lossless-audio.com/ +* http://download.microsoft.com/download/winmediatech40/Doc/1.0/WIN98MeXP/EN-US/ASF_Specification_v.1.0.exe +* http://mediaxw.sourceforge.net/files/doc/Active%20Streaming%20Format%20(ASF)%201.0%20Specification.pdf +* http://www.uni-jena.de/~pfk/mpp/sv8/ +* http://jfaul.de/atl/ +* http://www.uni-jena.de/~pfk/mpp/ +* http://www.libpng.org/pub/png/spec/png-1.2-pdg.html +* http://www.real.com/devzone/library/creating/rmsdk/doc/rmff.htm +* http://www.fastgraph.com/help/bmp_os2_header_format.html +* http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm +* http://flac.sourceforge.net/format.html +* http://www.research.att.com/projects/mpegaudio/mpeg2.html +* http://www.audiocoding.com/wiki/index.php?page=AAC +* http://libmpeg.org/mpeg4/doc/w2203tfs.pdf +* http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt +* http://developer.apple.com/techpubs/quicktime/qtdevdocs/RM/frameset.htm +* http://www.nullsoft.com/nsv/ +* http://www.wotsit.org/download.asp?f=iso9660 +* http://sandbox.mc.edu/~bennet/cs110/tc/tctod.html +* http://www.cdroller.com/htm/readdata.html +* http://www.speex.org/manual/node10.html +* http://www.harmony-central.com/Computer/Programming/aiff-file-format.doc +* http://www.faqs.org/rfcs/rfc2361.html +* http://ghido.shelter.ro/ +* http://www.ebu.ch/tech_t3285.pdf +* http://www.sr.se/utveckling/tu/bwf +* http://ftp.aessc.org/pub/aes46-2002.pdf +* http://cartchunk.org:8080/ +* http://www.broadcastpapers.com/radio/cartchunk01.htm +* http://www.hr/josip/DSP/AudioFile2.html +* http://home.attbi.com/~chris.bagwell/AudioFormats-11.html +* http://www.pure-mac.com/extkey.html +* http://cesnet.dl.sourceforge.net/sourceforge/bonkenc/bonk-binary-format-0.9.txt +* http://www.headbands.com/gspot/ +* http://www.openswf.org/spec/SWFfileformat.html +* http://j-faul.virtualave.net/ +* http://www.btinternet.com/~AnthonyJ/Atari/programming/avr_format.html +* http://cui.unige.ch/OSG/info/AudioFormats/ap11.html +* http://sswf.sourceforge.net/SWFalexref.html +* http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt +* http://www-lehre.informatik.uni-osnabrueck.de/~fbstark/diplom/docs/swf/Flash_Uncovered.htm +* http://developer.apple.com/quicktime/icefloe/dispatch012.html +* http://www.csdn.net/Dev/Format/graphics/PCD.htm +* http://tta.iszf.irk.ru/ +* http://www.atsc.org/standards/a_52a.pdf +* http://www.alanwood.net/unicode/ +* http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html +* http://www.its.msstate.edu/net/real/reports/config/tags.stats +* http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt +* http://brennan.young.net/Comp/LiveStage/things.html +* http://www.multiweb.cz/twoinches/MP3inside.htm +* http://www.geocities.co.jp/SiliconValley-Oakland/3664/alittle.html#GenreExtended +* http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/ +* http://www.unicode.org/unicode/faq/utf_bom.html +* http://tta.corecodec.org/?menu=format +* http://www.scvi.net/nsvformat.htm +* http://pda.etsi.org/pda/queryform.asp diff --git a/modules/getid3/docs/readme.windows.txt b/modules/getid3/docs/readme.windows.txt new file mode 100644 index 00000000..59ba4af8 --- /dev/null +++ b/modules/getid3/docs/readme.windows.txt @@ -0,0 +1,59 @@ +// +----------------------------------------------------------------------+ +// | PHP version 5 | +// +----------------------------------------------------------------------+ +// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen | +// +----------------------------------------------------------------------+ +// | This source file is subject to version 2 of the GPL license, | +// | that is bundled with this package in the file license.txt and is | +// | available through the world-wide-web at the following url: | +// | http://www.gnu.org/copyleft/gpl.html | +// +----------------------------------------------------------------------+ +// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org | +// +----------------------------------------------------------------------+ +// | Authors: James Heinrich | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | List of binary files required under Windows for some features and/or | +// | file formats. | +// +----------------------------------------------------------------------+ +// +// $Id: readme.windows.txt,v 1.1 2006/12/03 21:12:11 ah Exp $ + + + +Windows users may want to download the latest version of the +"getID3()-WindowsSupport" package and extract it to c:\windows\system32 +or another directory in the system path. + +The package is required for these features: + + * Shorten support. + * md5_data/sha1_data of Ogg Vorbis files + +The package will also greatly speed up calculation of md5_data for other +files. + + + +Included files: +===================================================== + +Taken from http://www.cygwin.com/ +* cygwin1.dll + +Taken from http://unxutils.sourceforge.net/ +* head.exe +* md5sum.exe +* tail.exe + +Taken from http://ebible.org/mpj/software.htm +* sha1sum.exe + +Taken from http://www.vorbis.com/download.psp +* vorbiscomment.exe + +Taken from http://flac.sourceforge.net/download.html +* metaflac.exe + +Taken from http://www.etree.org/shncom.html +* shorten.exe diff --git a/modules/getid3/docs/structure.txt b/modules/getid3/docs/structure.txt new file mode 100644 index 00000000..d100392f --- /dev/null +++ b/modules/getid3/docs/structure.txt @@ -0,0 +1,2261 @@ +// +----------------------------------------------------------------------+ +// | PHP version 5 | +// +----------------------------------------------------------------------+ +// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen | +// +----------------------------------------------------------------------+ +// | This source file is subject to version 2 of the GPL license, | +// | that is bundled with this package in the file license.txt and is | +// | available through the world-wide-web at the following url: | +// | http://www.gnu.org/copyleft/gpl.html | +// +----------------------------------------------------------------------+ +// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org | +// +----------------------------------------------------------------------+ +// | Authors: James Heinrich | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | Dependencies | +// +----------------------------------------------------------------------+ +// +// $Id: structure.txt,v 1.3 2006/11/02 10:47:59 ah Exp $ + + +What does the returned data structure look like? +================================================ + +Hint: If you take a look at the nicely-formatted output of +/demos/demo.browse.php you can generally see where the data you want +is returned. + +Note that what is described below is only a rough guide to what data +is actually returned by getID3(), since the actual data returned +depends entirely on what data is in your file, what type of file it +is, what kind of data is in the tags, etc. In addition, some formats +(Quicktime for example) use a freeform recursive structure that is +impossible to document completely. + +In the vast majority of cases, all the data you'll need is located +in the root of the array or the special arrays described below in +Section 1 (['audio'], ['video'], ['tags_html'], ['replay_gain']). + +It is suggested that for most applications you should use tag data +from the root ['tags_html'] array, as this is the only location +where data is stored in a consistant format: HTML-compatible +character entities (ie Ӓ) for characters outside the 0x20-0x7F +range (printable ISO-8859-1 characters). This data can be used as-is +for output in HTML, and can be converted to whatever character set +you wish to use if the output is not HTML. + +If you want to merge all available tags (for example, ID3v2 + ID3v1) +into one array, you can call +getid3_lib::CopyTagsToComments($ThisFileInfo) +and you'll then have ['comments'] and ['comments_html'] which are +identical to ['tags'] and ['tags_html'] except the array is one +dimension shorter (no tag type array keys). For example, artist is: +['tags_html']['id3v1']['artist'][0] or ['comments_html']['artist'][0] + + +Some commonly-used information is found in these locations: + +File type: ['fileformat'] // ex 'mp3' +Song length: ['playtime_string'] // ex '3:45' (minutes:seconds) + ['playtime_seconds'] // ex 225.13 (seconds) +Overall bitrate: ['bitrate'] // ex 113485.71 (bits-per-second - divide by 1000 for kbps) +Audio frequency: ['audio']['sample_rate'] // ex 44100 (Hertz) +Artist name: ['comments_html']['artist'][0] // ex 'Elvis' (if CopyTagsToComments() is used - see above) + // more than one artist may be present, you may want to use implode: + // implode(' & ', ['comments_html']['artist']) + + +///////////////////////////////////////////////////////////////// + +array() { + // SECTION 1: Values that are present for most or all file types + + ['getID3version']=>string() // version of getID3() that scanned this file (ex: '1.6.2') + ['error']=>array() // if present, contains one or more fatal error messages + ['warning']=>array() // if present, contains one or more non-fatal warning messages + ['exist']=>boolean() // does this file actually exist? + ['fileformat']=>string() // one of the standard filetype abbreviations ('mp3', 'riff', 'quicktime', etc) + ['filename']=>string() // filename only, no path + ['filenamepath']=>string() // full filename with path + ['filepath']=>string() // path to file, not including filename + ['filesize']=>integer() // filesize in bytes + ['md5_file']=>string() // md5 hash of entire file + ['md5_data']=>string() // md5 hash of portion of file excluding prepended and appeneded metainformation tags (ID3, APE, etc) - may be identical to ['md5_file'] + ['md5_data_source']=>string() // md5 hash of original source file before compression (currently used by FLAC, OptimFROG, WavPack v4+) + ['sha1_file']=>string() // sha1 hash of entire file + ['sha1_data']=>string() // sha1 hash of portion of file excluding prepended and appeneded metainformation tags (ID3, APE, etc) - may be identical to ['md5_file'] + ['avdataoffset']=>integer() // offset in bytes where audio/video data starts and prepended tags end + ['avdataend']=>integer() // offset in bytes where audio/video data ends and appended tags start + ['bitrate']=>double() // average bitrate for entire file (all audio/video streams), in bits per second + ['mime_type']=>string() // if present, MIME type of scanned file + ['playtime_seconds']=>double() // playing time of file, in seconds + ['playtime_string']=>string() // playing time of file, formatted as : + ['tags']=>array() // array of all metainformation tags present in file ('id3v1', 'id3v2', 'ape', 'riff', 'asf', etc) + ['audio']=>array() { + ['bitrate']=>double() // average bitrate for audio portion of file (all audio streams), in bits per second + ['bitrate_mode']=>string() // 'cbr' (Constant Bit Rate) or 'vbr' (Variable Bit Rate) + ['bits_per_sample']=>integer() // + ['channelmode']=>string() // 'mono' or 'stereo' + ['channels']=>integer() // number of audio channels + ['codec']=>string() // name of audio compression codec + ['compression_ratio']=>double() // ratio of compressed byte size of audio to uncompressed size + ['dataformat']=>string() // one of the standard filetype abbreviations ('mp3', 'wma', etc) + ['encoder']=>string() // name and version of encoder used to create file, if known + ['lossless']=>boolean() // true = lossless compression; false = lossy compression + ['sample_rate']=>integer() + } + ['video']=>array() { + ['bitrate']=>integer() // average bitrate for video portion of file (all video streams), in bits per second + ['bitrate_mode']=>string() // 'cbr' (Constant Bit Rate) or 'vbr' (Variable Bit Rate) + ['bits_per_sample']=>integer() // + ['codec']=>string() // name of video compression codec + ['compression_ratio']=>double() // ratio of compressed byte size of video to uncompressed size + ['dataformat']=>string() // one of the standard filetype abbreviations ('avi', 'mpeg', etc) + ['encoder']=>string() // name and version of encoder used to create file, if known + ['frame_rate']=>double() // frames per second + ['lossless']=>boolean() // true = lossless compression; false = lossy compression + ['resolution_x']=>integer() // horizontal dimension of video/image in pixels + ['resolution_y']=>integer() // vertical dimension of video/image in pixels + ['pixel_aspect_ratio']=>double() // pixel display aspect ratio + } + ['tags']=>array() { // array of array of strings containing best data from any available metainformation tag (APE, ID3v2, ID3v1, Lyrics3, Vorbis, ASF, RIFF, Real, etc.) + []=>array() // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + } + ['tags_html']=>array() { // identical to ['tags'], but with all entries converted to HTML entities as appropriate from various source encodings + []=>array() // + } + ['replay_gain']=>array() { // replay gain information combined from any source that contains this information (LAME, ID3v2, Vorbis, APE, etc) + ['audiophile']=>array() { + ['adjustment']=>double() + ['originator']=>string() + ['peak']=>double() + } + ['radio']=>array() { + ['adjustment']=>double() + ['originator']=>string() + ['peak']=>double() + } + } + + + // SECTION 2: Values that are present for specific file types only + + ['aac']=>array() { // AAC - Advanced Audio Coding / MPEG-4 + ['bitrate_distribution']=>array() // + ['header']=>array() { // + ['channel_configuration']=>integer() // + ['crc_present']=>boolean() // + ['home']=>boolean() // + ['layer']=>integer() // + ['mpeg_version']=>integer() // + ['original']=>boolean() // + ['private']=>boolean() // + ['profile_id']=>integer() // + ['profile_text']=>string() // + ['sample_frequency']=>integer() // + ['sample_frequency_index']=>integer() // + ['synch']=>integer() // + } // + ['header_type']=>string() // + } // + // + ['ape']=>array() // + { // + ['comments']=>array() { // array of array of strings containing best data from any available metainformation tag (APE, ID3v2, ID3v1, Lyrics3, Vorbis, ASF, RIFF, Real, etc.) + []=>array() // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + } // + ['footer']=>array() // + { // + ['flags']=>array() // + ['raw']=>array() // + ['tag_version']=>integer() // + } // + ['header']=>array() // + { // + ['flags']=>array() // + ['raw']=>array() // + ['tag_version']=>integer() // + } // + ['items']=>array() { // array of array of strings containing metainformation + []=>array() { // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + ['data']=>array() { // array of one or more Unicode values + ['data_ascii']=>array() { // array of values converted approximately from Unicode to ASCII + ['flags']=>array() // + } // + } // + ['tag_offset_end']=>integer() // + ['tag_offset_start']=>integer() // + } // + + + ['asf']=>array() { // ASF - Advanced Streaming Format (ASF, Windows Media Audio (WMA), Windows Media Video (WMV)) + ['audio_media']=>array() { // + []=>array() { // + ['bitrate']=>integer() // + ['bits_per_sample']=>integer() // + ['channels']=>integer() // + ['codec']=>string() // + ['codec_data']=>string() // + ['codec_data_size']=>integer() // + ['raw']=>array() { // + ['nAvgBytesPerSec']=>integer() // + ['wBitsPerSample']=>integer() // + ['nBlockAlign']=>integer() // + ['nChannels']=>integer() // + ['nSamplesPerSec']=>integer() // + ['wFormatTag']=>integer() // + } // + ['sample_rate']=>integer() // + } // + } // + ['codec_list']=>array() { // + ['codec_entries']=>array() { // + []=>array() { // + ['description']=>string() // + ['description_ascii']=>string() // + ['information']=>string() // + ['name']=>string() // + ['name_ascii']=>string() // + ['type']=>string() // + ['type_raw']=>integer() // + } // + } // + ['codec_entries_count']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['reserved']=>string() // + ['reserved_guid']=>string() // + } // + ['comments']=>array() { // array of comment values, derived from ['content_description'] + ['album']=>string() // + ['artist']=>string() // + ['comment']=>string() // + ['copyright']=>string() // + ['genre']=>string() // + ['title']=>string() // + ['track']=>string() // + ['year']=>string() // + } // + ['content_description']=>array() { // raw values - should use values from ['comments'] instead + ['author']=>string() // + ['author_ascii']=>string() // + ['author_length']=>integer() // + ['copyright']=>string() // + ['copyright_ascii']=>string() // + ['copyright_length']=>integer() // + ['description']=>string() // + ['description_ascii']=>string() // + ['description_length']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['rating']=>string() // + ['rating_ascii']=>string() // + ['rating_length']=>integer() // + ['title']=>string() // + ['title_ascii']=>string() // + ['title_length']=>integer() // + } // + ['data_object']=>array() { // + ['fileid']=>string() // + ['fileid_guid']=>string() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['reserved']=>integer() // + ['total_data_packets']=>integer() // + } // + ['extended_content_description']=>array() { // + ['content_descriptors']=>array() { // + []=>array() { // + ['name']=>string() // + ['name_ascii']=>string() // + ['name_length']=>integer() // + ['value']=>string() // + ['value_ascii']=>string() // + ['value_length']=>integer() // + ['value_type']=>integer() // + } // + } // + ['content_descriptors_count']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + } // + ['file_properties_object']=>array() { // + ['creation_date']=>double() // + ['creation_date_unix']=>double() // + ['data_packets']=>integer() // + ['fileid']=>string() // + ['fileid_guid']=>string() // + ['filesize']=>integer() // + ['flags']=>array() { // + ['broadcast']=>boolean() // + ['seekable']=>boolean() // + } // + ['flags_raw']=>integer() // + ['max_bitrate']=>integer() // + ['max_packet_size']=>integer() // + ['min_packet_size']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['play_duration']=>double() // + ['preroll']=>integer() // + ['send_duration']=>double() // + } // + ['header_extension_object']=>array() { // + ['extension_data']=>integer() // + ['extension_data_size']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['reserved_1']=>string() // + ['reserved_1_guid']=>string() // + ['reserved_2']=>integer() // + } // + ['header_object']=>array() { // + ['headerobjects']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['reserved1']=>integer() // + ['reserved2']=>integer() // + } // + ['marker_object']=>array() { // + ['markers_count']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['reserved']=>string() // + ['reserved_2']=>integer() // + ['reserved_guid']=>string() // + } // + ['stream_bitrate_properties']=>array() { // + ['bitrate_records']=>array() { // + []=>array() { // + ['bitrate']=>integer() // + ['flags_raw']=>integer() // + ['flags']=>array() { // + ['stream_number']=>integer() // + } // + } // + } // + ['bitrate_records_count']=>integer() // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + } // + ['stream_properties_object']=>array() { // + []=>array() { // + ['error_correct_data']=>string() // + ['error_correct_guid']=>string() // + ['error_correct_type']=>string() // + ['error_data_length']=>integer() // + ['flags_raw']=>integer() // + ['flags']=>array() { // + ['encrypted']=>boolean() // + } // + ['objectid']=>string() // + ['objectid_guid']=>string() // + ['objectsize']=>integer() // + ['stream_type']=>string() // + ['stream_type_guid']=>string() // + ['time_offset']=>integer() // + ['type_data_length']=>integer() // + ['type_specific_data']=>string() // + } // + } // + ['video_media']=>array() { // + []=>array() { // + ['flags']=>integer() // + ['format_data']=>array() { // + ['bits_per_pixel']=>integer() // + ['codec']=>string() // + ['codec_data']=>boolean() // + ['codec_fourcc']=>string() // + ['colors_important']=>integer() // + ['colors_used']=>integer() // + ['format_data_size']=>integer() // + ['horizontal_pels']=>integer() // + ['image_height']=>integer() // + ['image_size']=>integer() // + ['image_width']=>integer() // + ['reserved']=>integer() // + ['vertical_pels']=>integer() // + } // + ['format_data_size']=>integer() // + ['image_height']=>integer() // + ['image_width']=>integer() // + } // + } // + } // + + + ['au']=>array() { // AU - Next/Sun AUdio format + ['bits_per_sample']=>integer() // + ['channels']=>integer() // + ['comment']=>string() // + ['data_format']=>string() // + ['data_format_id']=>integer() // + ['data_size']=>integer() // + ['header_length']=>integer() // + ['sample_rate']=>integer() // + ['used_bits_per_sample']=>integer() // + } // + + + ['bmp']=>array() { // BMP - OS/2 or Windows BitMaP + ['header']=>array() { // + ['compression']=>string() // + ['raw']=>array() { // + ['bits_per_pixel']=>integer() // + ['bmp_data_size']=>integer() // + ['colors_important']=>integer() // + ['colors_used']=>integer() // + ['compression']=>integer() // + ['data_offset']=>integer() // + ['filesize']=>integer() // + ['header_size']=>integer() // + ['height']=>integer() // + ['identifier']=>string() // + ['planes']=>integer() // + ['resolution_h']=>integer() // + ['resolution_v']=>integer() // + ['width']=>integer() // + } // + } // + ['type_os']=>string() // + ['type_version']=>integer() // + } // + + + ['bonk']=>array() { // BONK - lossy/lossless audio compression (www.bonkenc.org) + ['BONK']=>array() { // + ['channels']=>integer() // + ['downsampling_ratio']=>integer() // + ['joint_stereo']=>boolean() // + ['lossless']=>boolean() // + ['number_samples']=>integer() // + ['number_taps']=>integer() // + ['offset']=>integer() // + ['sample_rate']=>integer() // + ['samples_per_packet']=>integer() // + ['size']=>integer() // + ['version']=>integer() // + } // + ['INFO']=>array() { // + ['size']=>integer() // + ['offset']=>integer() // + ['version']=>integer() // + []=>array() { // + ['nextbit']=>integer() // + ['offset']=>integer() // + } // + } // + ['dataend']=>integer() // + ['dataoffset']=>integer() // + } // + + + ['flac']=>array() { // FLAC - Free Lossless Audio Compressor + ['SEEKTABLE']=>array() { // + []=>array() { // + ['offset']=>integer() // + ['samples']=>integer() // + } // + ['placeholders']=>integer() // + ['raw']=>array() { // + ['block_data']=>string() // + ['block_length']=>integer() // + ['block_type']=>integer() // + ['block_type_text']=>string() // + ['last_meta_block']=>boolean() // + ['offset']=>integer() // + } // + } // + ['STREAMINFO']=>array() { // + ['audio_signature']=>string() // + ['bits_per_sample']=>integer() // + ['channels']=>integer() // + ['max_block_size']=>integer() // + ['max_frame_size']=>integer() // + ['min_block_size']=>integer() // + ['min_frame_size']=>integer() // + ['raw']=>array() { // + ['block_data']=>string() // + ['block_length']=>integer() // + ['block_type']=>integer() // + ['block_type_text']=>string() // + ['last_meta_block']=>boolean() // + ['offset']=>integer() // + } // + ['sample_rate']=>integer() // + ['samples_stream']=>integer() // + } // + ['VORBIS_COMMENT']=>array() { // + ['raw']=>array() { // + ['block_data']=>string() // + ['block_length']=>integer() // + ['block_type']=>integer() // + ['block_type_text']=>string() // + ['last_meta_block']=>boolean() // + ['offset']=>integer() // + } // + } // + ['compressed_audio_bytes']=>integer() // + ['compression_ratio']=>double() // + ['uncompressed_audio_bytes']=>integer() // + } // + + + ['gif']=>array() { // GIF - Graphics Interchange Format + ['global_color_table']=>array() { // + []=>integer() // + } // + ['header']=>array() { // + ['bits_per_pixel']=>integer() // + ['flags']=>array() { // + ['global_color_sorted']=>boolean() // + ['global_color_table']=>boolean() // + } // + ['global_color_size']=>integer() // + ['raw']=>array() { // + ['aspect_ratio']=>integer() // + ['bg_color_index']=>integer() // + ['flags']=>integer() // + ['height']=>integer() // + ['identifier']=>string() // + ['version']=>string() // + ['width']=>integer() // + } // + } // + ['version']=>string() // + } // + + + ['id3v1']=>array() { // ID3v1 + ['album']=>string() // + ['artist']=>string() // + ['comment']=>string() // + ['genre']=>string() // + ['genreid']=>integer() // + ['title']=>string() // + ['track']=>integer() // + ['year']=>string() // + ['padding_valid']=>boolean() // + ['comments']=>array() // + ['tag_offset_start']=>integer() // + ['tag_offset_end']=>integer() // + } // + + + ['id3v2']=>array() { // ID3v2 - www.id3.org + []=>array() { // can be any of the 4-character (3-character in ID3v2.2) frame names allowed in the ID3v2 spec. Exact contents of returned array data varies with frame type. + []=>array() { // some frames types allow multiple values ('COMM' for example), others do not and do not have this array level + ['asciidata']=>boolean() // + ['asciidescription']=>string() // + ['data']=>boolean() // + ['datalength']=>integer() // + ['dataoffset']=>integer() // + ['description']=>string() // + ['encoding']=>string() // + ['encodingid']=>integer() // + ['flags']=>array() { // + ['Encryption']=>boolean() // + ['FileAlterPreservation']=>boolean() // + ['GroupingIdentity']=>boolean() // + ['ReadOnly']=>boolean() // + ['TagAlterPreservation']=>boolean() // + ['compression']=>boolean() // + } // + ['framenamelong']=>string() // + ['language']=>string() // + ['languagename']=>string() // + } // + } // + ['comments']=>array() { // array of array of strings containing best data from any available metainformation tag (APE, ID3v2, ID3v1, Lyrics3, Vorbis, ASF, RIFF, Real, etc.) + []=>array() // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + } // + ['flags']=>array() { // + ['experim']=>string() // + ['exthead']=>string() // + ['unsynch']=>string() // + } // + ['header']=>boolean() // + ['headerlength']=>integer() // + ['majorversion']=>integer() // + ['minorversion']=>integer() // + ['padding']=>array() { // + ['length']=>integer() // + ['start']=>integer() // + ['valid']=>boolean() // + } // + ['tag_offset_end']=>integer() // + ['tag_offset_start']=>integer() // + } // + + + ['iso']=>array() { // ISO-9660 - CD-ROM Image + ['directories']=>array() { // + []=>array() { // + []=>array() { // + ['file_flags']=>array() { // + ['associated']=>boolean() // + ['directory']=>boolean() // + ['extended']=>boolean() // + ['hidden']=>boolean() // + ['multiple']=>boolean() // + ['permissions']=>boolean() // + } // + ['file_identifier_ascii']=>string() // + ['filename']=>string() // + ['filesize']=>integer() // + ['offset_bytes']=>integer() // + ['raw']=>array() { // + ['extended_attribute_length']=>integer() // + ['file_flags']=>integer() // + ['file_identifier']=>string() // + ['file_identifier_length']=>integer() // + ['file_unit_size']=>integer() // + ['filesize']=>integer() // + ['interleave_gap_size']=>integer() // + ['length']=>integer() // + ['offset_logical']=>integer() // + ['recording_date_time']=>string() // + ['volume_sequence_number']=>integer() // + } // + ['recording_timestamp']=>integer() // + } // + } // + } // + ['files']=>array() { // multidimensional tree-structure array listing of all files and directories in image + []=>array() // entries of type array are directories (key is directory name), may contain files and/or other subdirectories + []=>integer() // entries of type integer are files (key is file name, value is file size in bytes) + } // + ['path_table']=>array() { // + ['directories']=>array() { // + []=>array() { // + ['extended_length']=>integer() // + ['full_path']=>string() // + ['length']=>integer() // + ['location_bytes']=>integer() // + ['location_logical']=>integer() // + ['name']=>string() // + ['name_ascii']=>string() // + ['parent_directory']=>integer() // + } // + } // + ['offset']=>integer() // + ['raw']=>string() // + } // + ['primary_volume_descriptor']=>array() { // + ['abstract_file_identifier']=>string() // + ['application_identifier']=>string() // + ['bibliographic_file_identifier']=>string() // + ['copyright_file_identifier']=>string() // + ['data_preparer_identifier']=>string() // + ['offset']=>integer() // + ['publisher_identifier']=>string() // + ['raw']=>array() { // + ['abstract_file_identifier']=>string() // + ['application_data']=>string() // + ['application_identifier']=>string() // + ['bibliographic_file_identifier']=>string() // + ['copyright_file_identifier']=>string() // + ['data_preparer_identifier']=>string() // + ['file_structure_version']=>integer() // + ['logical_block_size']=>integer() // + ['path_table_l_location']=>integer() // + ['path_table_l_opt_location']=>integer() // + ['path_table_m_location']=>integer() // + ['path_table_m_opt_location']=>integer() // + ['path_table_size']=>integer() // + ['publisher_identifier']=>string() // + ['root_directory_record']=>string() // + ['standard_identifier']=>string() // + ['system_identifier']=>string() // + ['unused_1']=>string() // + ['unused_2']=>string() // + ['unused_3']=>string() // + ['unused_4']=>integer() // + ['volume_creation_date_time']=>string() // + ['volume_descriptor_type']=>integer() // + ['volume_descriptor_version']=>integer() // + ['volume_effective_date_time']=>string() // + ['volume_expiration_date_time']=>string() // + ['volume_identifier']=>string() // + ['volume_modification_date_time']=>string() // + ['volume_sequence_number']=>integer() // + ['volume_set_identifier']=>string() // + ['volume_set_size']=>integer() // + ['volume_space_size']=>integer() // + } // + ['system_identifier']=>string() // + ['volume_creation_date_time']=>integer() // + ['volume_effective_date_time']=>boolean() // + ['volume_expiration_date_time']=>boolean() // + ['volume_identifier']=>string() // + ['volume_modification_date_time']=>integer() // + ['volume_set_identifier']=>string() // + } // + ['supplementary_volume_descriptor']=>array() { // + ['abstract_file_identifier']=>string() // + ['application_identifier']=>string() // + ['bibliographic_file_identifier']=>string() // + ['copyright_file_identifier']=>string() // + ['data_preparer_identifier']=>string() // + ['offset']=>integer() // + ['publisher_identifier']=>string() // + ['raw']=>array() { // + ['abstract_file_identifier']=>string() // + ['application_data']=>string() // + ['application_identifier']=>string() // + ['bibliographic_file_identifier']=>string() // + ['copyright_file_identifier']=>string() // + ['data_preparer_identifier']=>string() // + ['file_structure_version']=>integer() // + ['logical_block_size']=>integer() // + ['path_table_l_location']=>integer() // + ['path_table_l_opt_location']=>integer() // + ['path_table_m_location']=>integer() // + ['path_table_m_opt_location']=>integer() // + ['path_table_size']=>integer() // + ['publisher_identifier']=>string() // + ['root_directory_record']=>string() // + ['standard_identifier']=>string() // + ['system_identifier']=>string() // + ['unused_1']=>string() // + ['unused_2']=>string() // + ['unused_3']=>string() // + ['unused_4']=>integer() // + ['volume_creation_date_time']=>string() // + ['volume_descriptor_type']=>integer() // + ['volume_descriptor_version']=>integer() // + ['volume_effective_date_time']=>string() // + ['volume_expiration_date_time']=>string() // + ['volume_identifier']=>string() // + ['volume_modification_date_time']=>string() // + ['volume_sequence_number']=>integer() // + ['volume_set_identifier']=>string() // + ['volume_set_size']=>integer() // + ['volume_space_size']=>integer() // + } // + ['system_identifier']=>string() // + ['volume_creation_date_time']=>integer() // + ['volume_effective_date_time']=>boolean() // + ['volume_expiration_date_time']=>boolean() // + ['volume_identifier']=>string() // + ['volume_modification_date_time']=>integer() // + ['volume_set_identifier']=>string() // + } // + } // + + + ['jpg']=>array() { // JPEG - still image + ['exif']=>array() // data returned from PHP's exif_read_data() function + } // + + + ['la']=>array() { // LA - Lossless Audio (www.lossless-audio.com) + ['raw']=>array() { + ['format']=>integer() // + ['flags']=>integer() // + } // + ['flags']=>array() { // + ['seekable']=>boolean() // + ['high_compression']=>boolean() // + } // + ['bits_per_sample']=>integer() // + ['bytes_per_sample']=>integer() // + ['bytes_per_second']=>integer() // + ['channels']=>integer() // + ['compression_ratio']=>double() // + ['format_size']=>integer() // + ['header_size']=>integer() // + ['original_crc']=>double() // + ['sample_rate']=>integer() // + ['samples']=>integer() // + ['uncompressed_size']=>integer() // + ['version']=>double() // + ['version_major']=>integer() // + ['version_minor']=>integer() // + ['footerstart']=>double() // + } + + + ['lpac']=>array() { // LPAC - Lossless Predictive Audio Compressor + ['block_length']=>integer() // + ['file_version']=>integer() // + ['flags']=>array() { // + ['16_bit']=>boolean() // + ['24_bit']=>boolean() // + ['adaptive_prediction_order']=>boolean() // + ['adaptive_quantization']=>boolean() // + ['fast_compress']=>boolean() // + ['is_wave']=>boolean() // + ['joint_stereo']=>boolean() // + ['max_prediction_order']=>integer() // + ['quantization']=>integer() // + ['random_access']=>boolean() // + ['stereo']=>boolean() // + } // + ['raw']=>array() { // + ['audio_type']=>integer() // + ['parameters']=>double() // + } // + ['total_samples']=>integer() // + } // + + + ['lyrics3']=>array() { // Lyrics3 - metainformation tags + ['comments']=>array() { // + ['album']=>string() // + ['artist']=>string() // + ['author']=>string() // + ['comment']=>string() // + ['title']=>string() // + } // + ['flags']=>array() { // + ['lyrics']=>boolean() // + ['timestamps']=>boolean() // + } // + ['images']=>array() { // + []=>array() { // + ['description']=>string() // + ['filename']=>string() // + ['timestamp']=>integer() // + } // + } // + ['raw']=>array() { // + ['offset_start']=>integer() // + ['offset_end']=>integer() // + ['AUT']=>string() // + ['EAL']=>string() // + ['EAR']=>string() // + ['ETT']=>string() // + ['IMG']=>string() // + ['IND']=>string() // + ['INF']=>string() // + ['LYR']=>string() // + ['lyrics3tagsize']=>integer() // + ['lyrics3version']=>integer() // + ['unparsed']=>string() // + } // + ['synchedlyrics']=>array() { // + []=>string() // + } // + ['unsynchedlyrics']=>string() // + } // + + + ['midi']=>array() { // MIDI (Musical Instrument Digital Interface) - sequenced music + ['comments']=>array() { // + ['comment']=>string() // + ['copyright']=>string() // + } // + ['keysignature']=>array() { // + []=>string() // + } // + ['raw']=>array() { // + ['events']=>array() { // + []=>array() { // + []=>array() { // + ['us_qnote']=>integer() // + } // + } // + } // + ['fileformat']=>integer() // + ['headersize']=>integer() // + ['ticksperqnote']=>integer() // + ['track']=>array() { // + []=>array() { // + ['instrument']=>string() // + ['instrumentid']=>integer() // + ['name']=>string() // + } // + } // + ['tracks']=>integer() // + } // + ['timesignature']=>array() { // + []=>string() // + } // + ['totalticks']=>integer() // + } // + + + ['monkeys_audio']=>array() { // Monkey's Audio - lossless audio compression + ['bitrate']=>double() // + ['bits_per_sample']=>integer() // + ['channels']=>integer() // + ['compressed_size']=>integer() // + ['compression']=>string() // + ['compression_ratio']=>double() // + ['flags']=>array() { // + ['24-bit']=>boolean() // + ['8-bit']=>boolean() // + ['crc-32']=>boolean() // + ['no_wav_header']=>boolean() // + ['peak_level']=>boolean() // + ['seek_elements']=>boolean() // + } // + ['frames']=>integer() // + ['peak_level']=>integer() // + ['peak_ratio']=>double() // + ['playtime']=>double() // + ['raw']=>array() { // + ['header_tag']=>string() // + ['nChannels']=>integer() // + ['nCompressionLevel']=>integer() // + ['nFinalFrameSamples']=>integer() // + ['nFormatFlags']=>integer() // + ['nPeakLevel']=>integer() // + ['nSampleRate']=>integer() // + ['nSeekElements']=>integer() // + ['nTotalFrames']=>integer() // + ['nVersion']=>integer() // + ['nWAVHeaderBytes']=>integer() // + ['nWAVTerminatingBytes']=>integer() // + } // + ['sample_rate']=>integer() // + ['samples']=>integer() // + ['samples_per_frame']=>integer() // + ['uncompressed_size']=>integer() // + ['version']=>double() // + } // + + + ['mpc']=>array() { // MPC (Musepack) - lossy audio compression + ['header']=>array() { // + ['album_gain_db']=>integer() // + ['album_peak']=>integer() // + ['album_peak_db']=>boolean() // + ['title_gain_db']=>integer() // + ['title_peak']=>integer() // + ['title_peak_db']=>boolean() // + ['begin_loud']=>boolean() // + ['end_loud']=>boolean() // + ['encoder_version']=>string() // + ['frame_count']=>integer() // + ['intensity_stereo']=>boolean() // + ['last_frame_length']=>integer() // + ['max_level']=>integer() // + ['max_subband']=>integer() // + ['mid_side_stereo']=>boolean() // + ['profile']=>string() // + ['sample_rate']=>integer() // + ['samples']=>integer() // + ['size']=>integer() // + ['stream_major_version']=>integer() // + ['stream_minor_version']=>integer() // + ['true_gapless']=>boolean() // + ['raw']=>array() { // + ['album_gain']=>integer() // + ['album_peak']=>integer() // + ['encoder_version']=>integer() // + ['preamble']=>string() // + ['profile']=>integer() // + ['sample_rate']=>integer() // + ['title_gain']=>integer() // + ['title_peak']=>integer() // + } // + } // + } // + + + ['mpeg']=>array() { // MPEG (Motion Picture Experts Group) - MPEG video and/or MPEG audio (MP3/MP2/MP1) + ['audio']=>array() { // + ['LAME']=>array() { // + ['RGAD']=>array() { // + ['peak_amplitude']=>double() // + } // + ['ath_type']=>integer() // + ['audio_bytes']=>integer() // + ['bitrate_min']=>integer() // + ['encoder_delay']=>integer() // + ['encoding_flags']=>array() { // + ['nogap_next']=>boolean() // + ['nogap_prev']=>boolean() // + ['nspsytune']=>boolean() // + ['nssafejoint']=>boolean() // + } // + ['end_padding']=>integer() // + ['lame_tag_crc']=>integer() // + ['lowpass_frequency']=>integer() // + ['mp3_gain_db']=>double() // + ['mp3_gain_factor']=>double() // + ['mp3_gain_raw']=>integer() // + ['music_crc']=>integer() // + ['noise_shaping']=>integer() // + ['noise_shaping_raw']=>integer() // + ['not_optimal_quality']=>boolean() // + ['not_optimal_quality_raw']=>integer() // + ['preset_used_id']=>integer() // + ['short_version']=>string() // ex: "LAME 3.93" + ['long_version']=>string() // (pre-v3.90 only) ex: "LAME 3.88 (alpha)" + ['source_sample_freq']=>string() // + ['source_sample_freq_raw']=>integer() // + ['stereo_mode']=>string() // + ['stereo_mode_raw']=>integer() // + ['surround_info']=>string() // + ['surround_info_id']=>integer() // + ['tag_revision']=>integer() // + ['vbr_method']=>string() // + ['vbr_method_raw']=>integer() // + } // + ['VBR_bitrate']=>double() // + ['VBR_bytes']=>integer() // + ['VBR_frames']=>integer() // + ['VBR_method']=>string() // + ['VBR_scale']=>integer() // + ['bitrate']=>integer() // + ['bitrate_distribution']=>array() { // + ['free']=>integer() // + ['8']=>integer() // + ['16']=>integer() // + ['24']=>integer() // + ['32']=>integer() // + ['40']=>integer() // + ['48']=>integer() // + ['56']=>integer() // + ['64']=>integer() // + ['80']=>integer() // + ['96']=>integer() // + ['112']=>integer() // + ['128']=>integer() // + ['144']=>integer() // + ['160']=>integer() // + } // + ['bitrate_mode']=>string() // + ['channelmode']=>string() // + ['channels']=>integer() // + ['copyright']=>boolean() // + ['crc']=>integer() // + ['emphasis']=>string() // + ['frame_count']=>integer() // + ['framelength']=>integer() // + ['layer']=>integer() // + ['modeextension']=>string() // + ['original']=>boolean() // + ['padding']=>boolean() // + ['private']=>boolean() // + ['protection']=>boolean() // + ['raw']=>array() { // + ['bitrate']=>integer() // + ['channelmode']=>integer() // + ['copyright']=>integer() // + ['emphasis']=>integer() // + ['layer']=>integer() // + ['modeextension']=>integer() // + ['original']=>integer() // + ['padding']=>integer() // + ['private']=>integer() // + ['protection']=>integer() // + ['sample_rate']=>integer() // + ['synch']=>integer() // + ['version']=>integer() // + } // + ['sample_rate']=>integer() // + ['stereo_distribution']=>array() { // + ['dual channel']=>integer() // + ['joint stereo']=>integer() // + ['mono']=>integer() // + ['stereo']=>integer() // + } // + ['toc']=>array() { // + []=>integer() // + } // + ['version']=>string() // + ['version_distribution']=>array() { // + []=>integer() // + []=>integer() // + ['2.5']=>integer() // + } // + ['xing_flags']=>array() { // + ['bytes']=>boolean() // + ['frames']=>boolean() // + ['toc']=>boolean() // + ['vbr_scale']=>boolean() // + } // + ['xing_flags_raw']=>string() // + } // + ['video']=>array() { // + ['bitrate']=>integer() // + ['bitrate_mode']=>string() // + ['frame_rate']=>double() // + ['framesize_horizontal']=>integer() // + ['framesize_vertical']=>integer() // + ['pixel_aspect_ratio']=>double() // + ['pixel_aspect_ratio_text']=>string() // + ['raw']=>array() { // + ['bitrate']=>integer() // + ['constrained_param_flag']=>integer() // + ['frame_rate']=>integer() // + ['framesize_horizontal']=>integer() // + ['framesize_vertical']=>integer() // + ['intra_quant_flag']=>integer() // + ['marker_bit']=>integer() // + ['pixel_aspect_ratio']=>integer() // + ['vbv_buffer_size']=>integer() // + } // + } // + } // + + + ['nsv']=>array() { // NSV - Nullsoft Streaming Video + ['NSVf']=>array() { // + ['TOC_entries_1']=>integer() // + ['TOC_entries_2']=>integer() // + ['file_size']=>integer() // + ['header_length']=>integer() // + ['identifier']=>string() // + ['meta_size']=>integer() // + ['metadata']=>string() // + ['playtime_ms']=>integer() // + } // + ['NSVs']=>array() { // + ['audio_codec']=>string() // + ['frame_rate']=>double() // + ['framerate_index']=>integer() // + ['identifier']=>string() // + ['offset']=>integer() // + ['resolution_x']=>integer() // + ['resolution_y']=>integer() // + ['unknown1b']=>integer() // + ['unknown1c']=>integer() // + ['unknown1d']=>integer() // + ['unknown2a']=>integer() // + ['unknown2b']=>integer() // + ['unknown2c']=>integer() // + ['unknown2d']=>integer() // + ['unknown3a']=>integer() // + ['unknown3b']=>integer() // + ['unknown3c']=>integer() // + ['unknown3d']=>integer() // + ['video_codec']=>string() // + } // + ['comments']=>array() { // + ['aspect']=>string() // + ['title']=>string() // + } // + } // + + + ['ofr']=>array() { // OFR (OptimFROG) - lossless audio compression + ['COMP']=>array() { // + []=>array() { // + ['channel_configuration']=>string() // + ['crc_32']=>boolean() // + ['encoder']=>string() // + ['offset']=>integer() // + ['raw']=>array() { // + ['algorithm_id']=>integer() // + ['channel_configuration']=>integer() // + ['encoder_id']=>integer() // + ['sample_type']=>integer() // + } // + ['sample_count']=>integer() // + ['sample_type']=>string() // + ['size']=>integer() // + } // + } // + ['HEAD']=>array() { // + ['offset']=>integer() // + ['size']=>integer() // + } // + ['OFR ']=>array() { // + ['channel_config']=>integer() // + ['channels']=>integer() // + ['compression']=>string() // + ['encoder']=>string() // + ['offset']=>integer() // + ['raw']=>array() { // + ['compression']=>integer() // + ['encoder_id']=>integer() // + ['sample_type']=>integer() // + } // + ['sample_rate']=>integer() // + ['sample_type']=>string() // + ['size']=>integer() // + ['total_samples']=>integer() // + } // + ['TAIL']=>array() { // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + + + ['ogg']=>array() { // OGG - container format for Ogg Vorbis, OggFLAC, Speex, etc + ['bitrate_average']=>double() // + ['bitrate_max']=>integer() // + ['bitrate_min']=>integer() // + ['bitrate_nominal']=>integer() // + ['bitstreamversion']=>integer() // + ['blocksize_large']=>integer() // + ['blocksize_small']=>integer() // + ['comments']=>array() { // array of array of strings containing best data from any available metainformation tag (APE, ID3v2, ID3v1, Lyrics3, Vorbis, ASF, RIFF, Real, etc.) + []=>array() // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + } // + ['comments_raw']=>array() { // + []=>array() { // + ['dataoffset']=>integer() // + ['key']=>string() // + ['size']=>integer() // + ['value']=>string() // + } // + } // + ['numberofchannels']=>integer() // + ['pageheader']=>array() { // + []=>array() { // + ['flags']=>array() { // + ['bos']=>boolean() // + ['eos']=>boolean() // + ['fresh']=>boolean() // + } // + ['flags_raw']=>integer() // + ['header_end_offset']=>integer() // + ['packet_type']=>integer() // + ['page_checksum']=>double() // + ['page_end_offset']=>integer() // + ['page_length']=>integer() // + ['page_segments']=>integer() // + ['page_seqno']=>integer() // + ['page_start_offset']=>integer() // + ['pcm_abs_position']=>integer() // + ['segment_table']=>array() { // + []=>integer() // + } // + ['stream_serialno']=>integer() // + ['stream_structver']=>integer() // + ['stream_type']=>string() // + } // + ['eos']=>array() { // + ['flags']=>array() { // + ['bos']=>boolean() // + ['eos']=>boolean() // + ['fresh']=>boolean() // + } // + ['flags_raw']=>integer() // + ['header_end_offset']=>integer() // + ['page_checksum']=>double() // + ['page_end_offset']=>integer() // + ['page_length']=>integer() // + ['page_segments']=>integer() // + ['page_seqno']=>integer() // + ['page_start_offset']=>integer() // + ['pcm_abs_position']=>integer() // + ['segment_table']=>array() { // + []=>integer() // + } // + ['stream_serialno']=>integer() // + ['stream_structver']=>integer() // + } // + } // + ['samplerate']=>integer() // + ['samples']=>integer() // + ['stop_bit']=>integer() // + ['vendor']=>string() // + } // + + + ['png']=>array() { // PNG (Portable Network Graphics) - still image + ['IDAT']=>array() { // + []=>array() { // + ['header']=>array() { // + ['crc']=>integer() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + } // + } // + ['IEND']=>array() { // + ['header']=>array() { // + ['crc']=>double() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + } // + ['IHDR']=>array() { // + ['color_type']=>array() { // + ['alpha']=>boolean() // + ['palette']=>boolean() // + ['true_color']=>boolean() // + } // + ['compression_method_text']=>string() // + ['header']=>array() { // + ['crc']=>double() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + ['height']=>integer() // + ['raw']=>array() { // + ['bit_depth']=>integer() // + ['color_type']=>integer() // + ['compression_method']=>integer() // + ['filter_method']=>integer() // + ['interlace_method']=>integer() // + } // + ['width']=>integer() // + } // + ['PLTE']=>array() { // + ['header']=>array() { // + ['crc']=>double() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + []=>integer() // + } // + ['comments']=>array() { // array of array of strings containing best data from any available metainformation tag (APE, ID3v2, ID3v1, Lyrics3, Vorbis, ASF, RIFF, Real, etc.) + []=>array() // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + } // + ['gAMA']=>array() { // + ['gamma']=>double() // + ['header']=>array() { // + ['crc']=>integer() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + } // + ['oFFs']=>array() { // + ['header']=>array() { // + ['crc']=>double() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + ['position_x']=>integer() // + ['position_y']=>integer() // + ['unit']=>string() // + ['unit_specifier']=>integer() // + } // + ['pHYs']=>array() { // + ['header']=>array() { // + ['crc']=>integer() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + ['pixels_per_unit_x']=>integer() // + ['pixels_per_unit_y']=>integer() // + ['unit']=>string() // + ['unit_specifier']=>integer() // + } // + ['pcLb']=>array() { // + ['header']=>array() { // + ['crc']=>double() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + } // + ['tEXt']=>array() { // + ['header']=>array() { // + ['crc']=>integer() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + ['keyword']=>string() // + ['text']=>string() // + } // + ['tIME']=>array() { // + ['day']=>integer() // + ['header']=>array() { // + ['crc']=>integer() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + ['hour']=>integer() // + ['minute']=>integer() // + ['month']=>integer() // + ['second']=>integer() // + ['unix']=>integer() // + ['year']=>integer() // + } // + ['tRNS']=>array() { // + ['header']=>array() { // + ['crc']=>double() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + ['transparent_color_blue']=>integer() // + ['transparent_color_green']=>integer() // + ['transparent_color_red']=>integer() // + } // + ['zTXt']=>array() { // + ['compressed_text']=>string() // + ['compression_method']=>integer() // + ['compression_method_text']=>string() // + ['header']=>array() { // + ['crc']=>double() // + ['data']=>string() // + ['data_length']=>integer() // + ['flags']=>array() { // + ['ancilliary']=>boolean() // + ['private']=>boolean() // + ['reserved']=>boolean() // + ['safe_to_copy']=>boolean() // + } // + ['type_raw']=>double() // + ['type_text']=>string() // + } // + ['keyword']=>string() // + ['text']=>string() // + } // + } // + + + ['quicktime']=>array() { // Quicktime - video/audio + ['']=>array() { // + ['name']=>boolean() // + ['offset']=>integer() // + ['size']=>integer() // + } // + ['audio']=>array() { // + ['bit_depth']=>integer() // + ['channels']=>integer() // + ['codec']=>string() // + ['sample_rate']=>double() // + } // + ['free']=>array() { // + ['name']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + ['mdat']=>array() { // + ['name']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + ['moov']=>array() { // + ['hierarchy']=>string() // + ['name']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + ['subatoms']=>array() // This is an undocumentably-complex recursive array, typically containing a huge amount of seemingly disorganized data. Avoid this like the plague. + } // + ['time_scale']=>integer() // + ['display_scale']=>integer() // 1 = normal; 0.5 = half; 2 = double + ['video']=>array() { // + ['codec']=>string() // + ['color_depth']=>integer() // + ['color_depth_name']=>string() // + ['resolution_x']=>double() // + ['resolution_y']=>double() // + } // + ['wide']=>array() { // + ['name']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + + + ['real']=>array() { // Real (RealAudio / RealVideo) - audio/video + ['chunks']=>array() { // + []=>array() { // + ['file_version']=>integer() // + ['headers_count']=>integer() // + ['length']=>integer() // + ['name']=>string() // + ['object_version']=>integer() // + ['offset']=>integer() // + } // + []=>array() { // + ['avg_bit_rate']=>integer() // + ['avg_packet_size']=>integer() // + ['data_offset']=>integer() // + ['duration']=>integer() // + ['flags']=>array() { // + ['live_broadcast']=>boolean() // + ['perfect_play']=>boolean() // + ['save_enabled']=>boolean() // + } // + ['flags_raw']=>integer() // + ['index_offset']=>integer() // + ['length']=>integer() // + ['max_bit_rate']=>integer() // + ['max_packet_size']=>integer() // + ['name']=>string() // + ['num_packets']=>integer() // + ['num_streams']=>integer() // + ['object_version']=>integer() // + ['offset']=>integer() // + ['preroll']=>integer() // + } // + } // + ['comments']=>array() { // + ['artist']=>string() // + ['comment']=>string() // + ['title']=>string() // + } // + } // + + + ['riff']=>array() { // RIFF (Resource Interchange File Format) - audio/video container format (AVI, WAV, CDDA, etc) + ['AIFC']=>array() { // + ['COMM']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['FVER']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['INST']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['MARK']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['SSND']=>array() { // + []=>array() { // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + } // + ['AIFF']=>array() { // + ['(c) ']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['COMM']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['SSND']=>array() { // + []=>array() { // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + } // + ['AVI ']=>array() { // + ['JUNK']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['hdrl']=>array() { // + ['avih']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['odml']=>array() { // + ['dmlh']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + } // + ['strl']=>array() { // + ['JUNK']=>array() { // + []=>array() { // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['strf']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['strh']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['strn']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + } // + } // + ['idx1']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['movi']=>array() { // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['CDDA']=>array() { // + ['fmt ']=>array() { // + []=>array() { // + ['data']=>string() // + ['disc_id']=>integer() // + ['offset']=>integer() // + ['playtime_frames']=>integer() // + ['playtime_seconds']=>double() // + ['size']=>integer() // + ['start_offset_frame']=>integer() // + ['start_offset_seconds']=>double() // + ['track_num']=>integer() // + ['unknown1']=>integer() // + ['unknown6']=>integer() // + ['unknown7']=>integer() // + } // + } // + } // + ['WAVE']=>array() { // + ['DISP']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['INFO']=>array() { // + ['IART']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['ICMT']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['ICOP']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['IENG']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['IGNR']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['IKEY']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['IMED']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['INAM']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['ISBJ']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['ISFT']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['ISRC']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['ISRF']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['ITCH']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + } // + ['MEXT']=>array() { // + []=>array() { // + ['anciliary_data_length']=>integer() // + ['data']=>string() // + ['flags']=>array() { // + ['anciliary_data_free']=>boolean() // + ['anciliary_data_left']=>boolean() // + ['anciliary_data_right']=>boolean() // + ['homogenous']=>boolean() // + } // + ['offset']=>integer() // + ['raw']=>array() { // + ['anciliary_data_def']=>integer() // + ['sound_information']=>integer() // + } // + ['size']=>integer() // + } // + } // + ['bext']=>array() { // + []=>array() { // + ['author']=>string() // + ['bwf_version']=>integer() // + ['coding_history']=>array() { // + []=>string() // + } // + ['data']=>string() // + ['offset']=>integer() // + ['origin_date']=>string() // + ['origin_date_unix']=>integer() // + ['origin_time']=>string() // + ['reference']=>string() // + ['reserved']=>integer() // + ['size']=>integer() // + ['time_reference']=>integer() // + ['title']=>string() // + } // + } // + ['cart']=>array() { // + []=>array() { // + ['artist']=>string() // + ['category']=>string() // + ['classification']=>string() // + ['client_id']=>string() // + ['cut_id']=>string() // + ['data']=>string() // + ['end_date']=>string() // + ['end_time']=>string() // + ['offset']=>integer() // + ['out_cue']=>string() // + ['post_time']=>array() { // + []=>array() { // + ['timer_value']=>integer() // + ['usage_fourcc']=>string() // + } // + } // + ['producer_app_id']=>string() // + ['producer_app_version']=>string() // + ['size']=>integer() // + ['start_date']=>string() // + ['start_time']=>string() // + ['tag_text']=>array() { // + []=>string() // + } // + ['title']=>string() // + ['url']=>string() // + ['user_defined_text']=>string() // + ['version']=>string() // + ['zero_db_reference']=>integer() // + } // + } // + ['data']=>array() { // + []=>array() { // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['fact']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['fmt ']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + ['rgad']=>array() { // + []=>array() { // + ['data']=>string() // + ['offset']=>integer() // + ['size']=>integer() // + } // + } // + } // + ['audio']=>array() { // + []=>array() { // + ['bitrate']=>integer() // + ['bits_per_sample']=>integer() // + ['channels']=>integer() // + ['codec']=>string() // + ['sample_rate']=>integer() // + } // + ['bits_per_sample']=>integer() // + ['channels']=>integer() // + ['codec_fourcc']=>string() // + ['codec_name']=>string() // + ['sample_rate']=>integer() // + ['total_samples']=>integer() // + } // + ['comments']=>array() { // array of array of strings containing best data from any available metainformation tag (APE, ID3v2, ID3v1, Lyrics3, Vorbis, ASF, RIFF, Real, etc.) + []=>array() // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + } // + ['header_size']=>integer() // + ['raw']=>array() { // + ['avih']=>array() { // + ['dwFlags']=>integer() // + ['dwHeight']=>integer() // + ['dwInitialFrames']=>integer() // + ['dwLength']=>integer() // + ['dwMaxBytesPerSec']=>integer() // + ['dwMicroSecPerFrame']=>integer() // + ['dwPaddingGranularity']=>integer() // + ['dwRate']=>integer() // + ['dwScale']=>integer() // + ['dwStart']=>integer() // + ['dwStreams']=>integer() // + ['dwSuggestedBufferSize']=>integer() // + ['dwTotalFrames']=>integer() // + ['dwWidth']=>integer() // + ['flags']=>array() { // + ['capturedfile']=>boolean() // + ['copyrighted']=>boolean() // + ['hasindex']=>boolean() // + ['interleaved']=>boolean() // + ['mustuseindex']=>boolean() // + ['trustcktype']=>boolean() // + } // + } // + ['fact']=>array() { // + ['NumberOfSamples']=>integer() // + } // + ['fmt ']=>array() { // + ['nAvgBytesPerSec']=>integer() // + ['wBitsPerSample']=>integer() // + ['nBlockAlign']=>integer() // + ['nChannels']=>integer() // + ['nSamplesPerSec']=>integer() // + ['wFormatTag']=>integer() // + } // + ['rgad']=>array() { // + ['audiophile']=>array() { // + ['adjustment']=>integer() // + ['name']=>integer() // + ['originator']=>integer() // + ['signbit']=>integer() // + } // + ['fPeakAmplitude']=>double() // + ['nAudiophileRgAdjust']=>integer() // + ['nRadioRgAdjust']=>integer() // + ['radio']=>array() { // + ['adjustment']=>integer() // + ['name']=>integer() // + ['originator']=>integer() // + ['signbit']=>integer() // + } // + } // + ['strf']=>array() { // + ['auds']=>array() { // + []=>array() { // + ['nAvgBytesPerSec']=>integer() // + ['wBitsPerSample']=>integer() // + ['nBlockAlign']=>integer() // + ['nChannels']=>integer() // + ['nSamplesPerSec']=>integer() // + ['wFormatTag']=>integer() // + } // + } // + ['vids']=>array() { // + []=>array() { // + ['biBitCount']=>integer() // + ['biClrImportant']=>integer() // + ['biClrUsed']=>integer() // + ['biHeight']=>integer() // + ['biPlanes']=>integer() // + ['biSize']=>integer() // + ['biSizeImage']=>integer() // + ['biWidth']=>integer() // + ['biXPelsPerMeter']=>integer() // + ['biYPelsPerMeter']=>integer() // + ['fourcc']=>string() // + } // + } // + } // + ['strh']=>array() { // + []=>array() { // + ['dwFlags']=>integer() // + ['dwInitialFrames']=>integer() // + ['dwLength']=>integer() // + ['dwQuality']=>integer() // + ['dwRate']=>integer() // + ['dwSampleSize']=>integer() // + ['dwScale']=>integer() // + ['dwStart']=>integer() // + ['dwSuggestedBufferSize']=>integer() // + ['fccHandler']=>string() // + ['fccType']=>string() // + ['rcFrame']=>integer() // + ['wLanguage']=>integer() // + ['wPriority']=>integer() // + } // + } // + } // + ['rgad']=>array() { // + ['audiophile']=>array() { // + ['adjustment']=>double() // + ['name']=>string() // + ['originator']=>string() // + } // + ['peakamplitude']=>double() // + ['radio']=>array() { // + ['adjustment']=>double() // + ['name']=>string() // + ['originator']=>string() // + } // + } // + ['video']=>array() { // + []=>array() { // + ['codec']=>string() // + ['frame_height']=>integer() // + ['frame_rate']=>double() // + ['frame_width']=>integer() // + } // + } // + ['litewave']=>array() { // http://www.clearjump.com + ['raw']=>array() { // + ['compression_method']=>integer() // 1=lossy; 2=lossless + ['compression_flags']=>integer() // + ['m_dwScale']=>integer() // scalefactor for lossy compression - related to m_wQuality as: $m_wQuality = round((2000 - $m_dwScale) / 20) + ['m_dwBlockSize']=>integer() // number of samples in encoded blocks + ['m_wQuality']=>integer() // quality factor (0=most compressed lossy; 99=best quality lossy; 100=lossless) + ['m_wMarkDistance']=>integer() // distance between marks in bytes + ['m_wReserved']=>integer() // + ['m_dwOrgSize']=>integer() // original file size in bytes + ['m_bFactExists']=>integer() // indicates if 'fact' chunk exists in the original file + ['m_dwRiffChunkSize']=>integer() // riff chunk size in the original file + } // + ['quality_factor']=>integer() // alias of ['raw']['m_wQuality'] + } // + } // + + + ['shn']=>array() { // Shorten - lossless audio compression + ['seektable']=>array() { // + ['length']=>integer() // + ['offset']=>integer() // + ['present']=>boolean() // + } // + ['version']=>integer() // + } // + + + ['swf']=>array() { // SWF - ShockWave Flash (www.openswf.org) + ['header']=>array() { // + ['frame_count']=>integer() // + ['frame_height']=>integer() // + ['frame_width']=>integer() // + ['length']=>integer() // + ['signature']=>string() // + ['version']=>integer() // + } // + ['bgcolor']=>string() // + ['tags']=>array() // + } // + + + ['voc']=>array() { // VOC - SoundBlaster VOC audio format + ['blocks']=>array() { // + []=>array() { // + ['bits_per_sample']=>integer() // + ['block_offset']=>integer() // + ['block_size']=>integer() // + ['block_type_id']=>integer() // + ['channels']=>integer() // + ['compression_name']=>string() // + ['compression_type']=>integer() // + ['pack_method']=>integer() // + ['sample_rate']=>integer() // + ['sample_rate_id']=>integer() // + ['stereo']=>boolean() // + ['time_constant']=>integer() // + ['wFormat']=>integer() // + } // + } // + ['compressed_bits_per_sample']=>integer() // + ['header']=>array() { // + ['datablock_offset']=>integer() // + ['major_version']=>integer() // + ['minor_version']=>integer() // + } // + } // + + + ['vqf']=>array() { // VQF - transform-domain weighted interleave Vector Quantization Format (lossy audio) + ['COMM']=>array() { // + ['bitrate']=>integer() // + ['channel_mode']=>integer() // + ['sample_rate']=>integer() // + ['security_level']=>integer() // + } // + ['DSIZ']=>integer() // + ['comments']=>array() { // array of array of strings containing best data from any available metainformation tag (APE, ID3v2, ID3v1, Lyrics3, Vorbis, ASF, RIFF, Real, etc.) + []=>array() // can be anything, usually 'artist', 'title', etc. Contains array of one or more values (eg: multiple artists are possible) + } // + ['raw']=>array() { // + ['header_tag']=>string() // + ['size']=>integer() // + ['version']=>string() // + } // + } // + + + ['wavpack']=>array() { // WavPack - lossless audio compression + ['bits']=>integer() // + ['crc1']=>double() // + ['crc2']=>integer() // + ['extension']=>string() // + ['extra_bc']=>string() // + ['extras']=>string() // + ['flags_raw']=>integer() // + ['offset']=>integer() // + ['shift']=>integer() // + ['size']=>integer() // + ['total_samples']=>integer() // + ['version']=>integer() // + } // + + + ['zip']=>array() { // ZIP - lossless data compression + ['central_directory']=>array() { // + []=>array() { // + ['compressed_size']=>integer() // + ['compression_method']=>string() // + ['create_version']=>string() // + ['entry_offset']=>integer() // + ['extract_version']=>string() // + ['filename']=>string() // + ['flags']=>array() { // + ['compression_speed']=>string() // + ['data_descriptor_used']=>boolean() // + ['encrypted']=>boolean() // + } // + ['host_os']=>string() // + ['last_modified_timestamp']=>integer() // + ['offset']=>integer() // + ['raw']=>array() { // + ['compressed_size']=>integer() // + ['compression_method']=>integer() // + ['crc_32']=>double() // + ['create_version']=>integer() // + ['disk_number_start']=>integer() // + ['external_file_attrib']=>double() // + ['extra_field_length']=>integer() // + ['extract_version']=>integer() // + ['file_comment_length']=>integer() // + ['filename_length']=>integer() // + ['general_flags']=>integer() // + ['internal_file_attrib']=>integer() // + ['last_mod_file_date']=>integer() // + ['last_mod_file_time']=>integer() // + ['local_header_offset']=>integer() // + ['signature']=>integer() // + ['uncompressed_size']=>integer() // + } // + ['uncompressed_size']=>integer() // + } // + } // + ['comments']=>array() { // + ['comment']=>string() // + } // + ['compressed_size']=>integer() // + ['compression_method']=>string() // + ['compression_speed']=>string() // + ['end_central_directory']=>array() { // + ['comment']=>string() // + ['comment_length']=>integer() // + ['directory_entries_this_disk']=>integer() // + ['directory_entries_total']=>integer() // + ['directory_offset']=>integer() // + ['directory_size']=>integer() // + ['disk_number_current']=>integer() // + ['disk_number_start_directory']=>integer() // + ['offset']=>integer() // + ['signature']=>integer() // + } // + ['entries']=>array() { // + []=>array() { // + ['compressed_size']=>integer() // + ['compression_method']=>string() // + ['extract_version']=>string() // + ['filename']=>string() // + ['flags']=>array() { // + ['compression_speed']=>string() // + ['data_descriptor_used']=>boolean() // + ['encrypted']=>boolean() // + } // + ['host_os']=>string() // + ['last_modified_timestamp']=>integer() // + ['offset']=>integer() // + ['raw']=>array() { // + ['compressed_size']=>integer() // + ['compression_method']=>integer() // + ['crc_32']=>integer() // + ['extra_field_length']=>integer() // + ['extract_version']=>integer() // + ['filename_length']=>integer() // + ['general_flags']=>integer() // + ['last_mod_file_date']=>integer() // + ['last_mod_file_time']=>integer() // + ['signature']=>integer() // + ['uncompressed_size']=>integer() // + } // + ['uncompressed_size']=>integer() // + } // + } // + ['entries_count']=>integer() // + ['files']=>array() { // multidimensional tree-structure array listing of all files and directories in image + []=>array() // entries of type array are directories (key is directory name), may contain files and/or other subdirectories + []=>integer() // entries of type integer are files (key is file name, value is file size in bytes) + } // + ['uncompressed_size']=>integer() // + } // +} // diff --git a/modules/getid3/extension.cache.dbm.php b/modules/getid3/extension.cache.dbm.php new file mode 100644 index 00000000..4c70b3eb --- /dev/null +++ b/modules/getid3/extension.cache.dbm.php @@ -0,0 +1,217 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | extension.cache.mysql.php | +// | MySQL Cache Extension. | +// | dependencies: getid3. | +// +----------------------------------------------------------------------+ +// +// $Id: extension.cache.dbm.php,v 1.2 2006/11/02 10:47:59 ah Exp $ + + +/** +* This is a caching extension for getID3(). It works the exact same +* way as the getID3 class, but return cached information very fast +* +* Example: (see also demo.cache.dbm.php in /demo/) +* +* Normal getID3 usage (example): +* +* require_once 'getid3/getid3.php'; +* $getid3 = new getid3; +* $getid3->encoding = 'UTF-8'; +* try { +* $info1 = $getid3->Analyse('file1.flac'); +* $info2 = $getid3->Analyse('file2.wv'); +* .... +* +* getID3_cached usage: +* +* require_once 'getid3/getid3.php'; +* require_once 'getid3/getid3/extension.cache.mysql.php'; +* $getid3 = new getid3_cached_mysql('localhost', 'database', 'username', 'password'); +* $getid3->encoding = 'UTF-8'; +* try { +* $info1 = $getid3->analyse('file1.flac'); +* $info2 = $getid3->analyse('file2.wv'); +* ... +* +* +* Supported Cache Types +* +* SQL Databases: (use extension.cache.mysql) +* +* cache_type cache_options +* ------------------------------------------------------------------- +* mysql host, database, username, password +* +* +* DBM-Style Databases: (this extension) +* +* cache_type cache_options +* ------------------------------------------------------------------- +* gdbm dbm_filename, lock_filename +* ndbm dbm_filename, lock_filename +* db2 dbm_filename, lock_filename +* db3 dbm_filename, lock_filename +* db4 dbm_filename, lock_filename (PHP5 required) +* +* PHP must have write access to both dbm_filename and lock_filename. +* +* +* Recommended Cache Types +* +* Infrequent updates, many reads any DBM +* Frequent updates mysql +*/ + + +class getid3_cached_dbm extends getid3 +{ + + public function __construct($cache_type, $dbm_filename, $lock_filename) { + + // Check for dba extension + if (!extension_loaded('dba')) { + throw new getid3_exception('PHP is not compiled with dba support, required to use DBM style cache.'); + } + + if (!in_array($cache_type, dba_handlers())) { + throw new getid3_exception('PHP is not compiled --with '.$cache_type.' support, required to use DBM style cache.'); + } + + // Create lock file if needed + if (!file_exists($lock_filename)) { + if (!touch($lock_filename)) { + die('failed to create lock file: ' . $lock_filename); + } + } + + // Open lock file for writing + if (!is_writeable($lock_filename)) { + die('lock file: ' . $lock_filename . ' is not writable'); + } + $this->lock = fopen($lock_filename, 'w'); + + // Acquire exclusive write lock to lock file + flock($this->lock, LOCK_EX); + + // Create dbm-file if needed + if (!file_exists($dbm_filename)) { + if (!touch($dbm_filename)) { + die('failed to create dbm file: ' . $dbm_filename); + } + } + + // Try to open dbm file for writing + $this->dba = @dba_open($dbm_filename, 'w', $cache_type); + if (!$this->dba) { + + // Failed - create new dbm file + $this->dba = dba_open($dbm_filename, 'n', $cache_type); + + if (!$this->dba) { + die('failed to create dbm file: ' . $dbm_filename); + } + + // Insert getID3 version number + dba_insert(getid3::VERSION, getid3::VERSION, $this->dba); + } + + // Init misc values + $this->cache_type = $cache_type; + $this->dbm_filename = $dbm_filename; + + // Register destructor + register_shutdown_function(array($this, '__destruct')); + + // Check version number and clear cache if changed + if (dba_fetch(getid3::VERSION, $this->dba) != getid3::VERSION) { + $this->clear_cache(); + } + + parent::__construct(); + } + + + + public function __destruct() { + + // Close dbm file + @dba_close($this->dba); + + // Release exclusive lock + @flock($this->lock, LOCK_UN); + + // Close lock file + @fclose($this->lock); + } + + + + public function clear_cache() { + + // Close dbm file + dba_close($this->dba); + + // Create new dbm file + $this->dba = dba_open($this->dbm_filename, 'n', $this->cache_type); + + if (!$this->dba) { + die('failed to clear cache/recreate dbm file: ' . $this->dbm_filename); + } + + // Insert getID3 version number + dba_insert(getid3::VERSION, getid3::VERSION, $this->dba); + + // Reregister shutdown function + register_shutdown_function(array($this, '__destruct')); + } + + + + // public: analyze file + public function Analyze($filename) { + + if (file_exists($filename)) { + + // Calc key filename::mod_time::size - should be unique + $key = $filename . '::' . filemtime($filename) . '::' . filesize($filename); + + // Loopup key + $result = dba_fetch($key, $this->dba); + + // Hit + if ($result !== false) { + return unserialize($result); + } + } + + // Miss + $result = parent::Analyze($filename); + + // Save result + if (file_exists($filename)) { + dba_insert($key, serialize($result), $this->dba); + } + + return $result; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/extension.cache.mysql.php b/modules/getid3/extension.cache.mysql.php new file mode 100644 index 00000000..7174030f --- /dev/null +++ b/modules/getid3/extension.cache.mysql.php @@ -0,0 +1,177 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | extension.cache.mysql.php | +// | MySQL Cache Extension. | +// | dependencies: getid3. | +// +----------------------------------------------------------------------+ +// +// $Id: extension.cache.mysql.php,v 1.2 2006/11/02 10:47:59 ah Exp $ + + +/** +* This is a caching extension for getID3(). It works the exact same +* way as the getID3 class, but return cached information very fast +* +* Example: (see also demo.cache.mysql.php in /demo/) +* +* Normal getID3 usage (example): +* +* require_once 'getid3/getid3.php'; +* $getid3 = new getid3; +* $getid3->encoding = 'UTF-8'; +* try { +* $info1 = $getid3->Analyse('file1.flac'); +* $info2 = $getid3->Analyse('file2.wv'); +* .... +* +* getID3_cached usage: +* +* require_once 'getid3/getid3.php'; +* require_once 'getid3/getid3/extension.cache.mysql.php'; +* $getid3 = new getid3_cached_mysql('localhost', 'database', 'username', 'password'); +* $getid3->encoding = 'UTF-8'; +* try { +* $info1 = $getid3->analyse('file1.flac'); +* $info2 = $getid3->analyse('file2.wv'); +* ... +* +* +* Supported Cache Types (this extension) +* +* SQL Databases: +* +* cache_type cache_options +* ------------------------------------------------------------------- +* mysql host, database, username, password +* +* +* DBM-Style Databases: (use extension.cache.dbm) +* +* cache_type cache_options +* ------------------------------------------------------------------- +* gdbm dbm_filename, lock_filename +* ndbm dbm_filename, lock_filename +* db2 dbm_filename, lock_filename +* db3 dbm_filename, lock_filename +* db4 dbm_filename, lock_filename (PHP5 required) +* +* PHP must have write access to both dbm_filename and lock_filename. +* +* +* Recommended Cache Types +* +* Infrequent updates, many reads any DBM +* Frequent updates mysql +*/ + + +class getid3_cached_mysql extends getID3 +{ + + private $cursor; + private $connection; + + + public function __construct($host, $database, $username, $password) { + + // Check for mysql support + if (!function_exists('mysql_pconnect')) { + throw new getid3_exception('PHP not compiled with mysql support.'); + } + + // Connect to database + $this->connection = @mysql_pconnect($host, $username, $password); + if (!$this->connection) { + throw new getid3_exception('mysql_pconnect() failed - check permissions and spelling.'); + } + + // Select database + if (!@mysql_select_db($database, $this->connection)) { + throw new getid3_exception('Cannot use database '.$database); + } + + // Create cache table if not exists + $this->create_table(); + + // Check version number and clear cache if changed + $this->cursor = mysql_query("SELECT `value` FROM `getid3_cache` WHERE (`filename` = '".getid3::VERSION."') AND (`filesize` = '-1') AND (`filetime` = '-1') AND (`analyzetime` = '-1')", $this->connection); + list($version) = @mysql_fetch_array($this->cursor); + if ($version != getid3::VERSION) { + $this->clear_cache(); + } + + parent::__construct(); + } + + + + public function clear_cache() { + + $this->cursor = mysql_query("DELETE FROM `getid3_cache`", $this->connection); + $this->cursor = mysql_query("INSERT INTO `getid3_cache` VALUES ('".getid3::VERSION."', -1, -1, -1, '".getid3::VERSION."')", $this->connection); + } + + + + public function Analyze($filename) { + + if (file_exists($filename)) { + + // Short-hands + $filetime = filemtime($filename); + $filesize = filesize($filename); + $filenam2 = mysql_escape_string($filename); + + // Loopup file + $this->cursor = mysql_query("SELECT `value` FROM `getid3_cache` WHERE (`filename`='".$filenam2."') AND (`filesize`='".$filesize."') AND (`filetime`='".$filetime."')", $this->connection); + list($result) = @mysql_fetch_array($this->cursor); + + // Hit + if ($result) { + return unserialize($result); + } + } + + // Miss + $result = parent::Analyze($filename); + + // Save result + if (file_exists($filename)) { + $res2 = mysql_escape_string(serialize($result)); + $this->cursor = mysql_query("INSERT INTO `getid3_cache` (`filename`, `filesize`, `filetime`, `analyzetime`, `value`) VALUES ('".$filenam2."', '".$filesize."', '".$filetime."', '".time()."', '".$res2."')", $this->connection); + } + return $result; + } + + + + // (re)create sql table + private function create_table($drop = false) { + + $this->cursor = mysql_query("CREATE TABLE IF NOT EXISTS `getid3_cache` ( + `filename` VARCHAR(255) NOT NULL DEFAULT '', + `filesize` INT(11) NOT NULL DEFAULT '0', + `filetime` INT(11) NOT NULL DEFAULT '0', + `analyzetime` INT(11) NOT NULL DEFAULT '0', + `value` TEXT NOT NULL, + PRIMARY KEY (`filename`,`filesize`,`filetime`)) TYPE=MyISAM", $this->connection); + echo mysql_error($this->connection); + } +} + + +?> \ No newline at end of file diff --git a/modules/getid3/getid3.php b/modules/getid3/getid3.php new file mode 100644 index 00000000..7f6a8eb8 --- /dev/null +++ b/modules/getid3/getid3.php @@ -0,0 +1,1598 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | getid3.php | +// | Main getID3() file. | +// | dependencies: modules. | +// +----------------------------------------------------------------------+ +// +// $Id: getid3.php,v 1.26 2006/12/25 23:44:23 ah Exp $ + + +class getid3 +{ + //// Settings Section - do NOT modify this file - change setting after newing getid3! + + // Encoding + public $encoding = 'ISO-8859-1'; // CASE SENSITIVE! - i.e. (must be supported by iconv() - see http://www.gnu.org/software/libiconv/). Examples: ISO-8859-1 UTF-8 UTF-16 UTF-16BE. + public $encoding_id3v1 = 'ISO-8859-1'; // Override SPECIFICATION encoding for broken ID3v1 tags caused by bad tag programs. Examples: 'EUC-CN' for "Chinese MP3s" and 'CP1251' for "Cyrillic". + public $encoding_id3v2 = 'ISO-8859-1'; // Override ISO-8859-1 encoding for broken ID3v2 tags caused by BRAINDEAD tag programs that writes system codepage as 'ISO-8859-1' instead of UTF-8. + + // Tags - disable for speed + public $option_tag_id3v1 = true; // Read and process ID3v1 tags. + public $option_tag_id3v2 = true; // Read and process ID3v2 tags. + public $option_tag_lyrics3 = true; // Read and process Lyrics3 tags. + public $option_tag_apetag = true; // Read and process APE tags. + + // Misc calucations - disable for speed + public $option_analyze = true; // Analyze file - disable if you only need to detect file format. + public $option_accurate_results = true; // Disable to greatly speed up parsing of some file formats at the cost of accuracy. + public $option_tags_process = true; // Copy tags to root key 'tags' and 'comments' and encode to $this->encoding. + public $option_tags_images = false; // Scan tags for binary image data - ID3v2 and vorbiscomments only. + public $option_extra_info = true; // Calculate/return additional info such as bitrate, channelmode etc. + public $option_max_2gb_check = false; // Check whether file is larger than 2 Gb and thus not supported by PHP. + + // Misc data hashes - slow - require hash module + public $option_md5_data = false; // Get MD5 sum of data part - slow. + public $option_md5_data_source = false; // Use MD5 of source file if available - only FLAC, MAC, OptimFROG and Wavpack4. + public $option_sha1_data = false; // Get SHA1 sum of data part - slow. + + // Public variables + public $filename; // Filename of file being analysed. + public $fp; // Filepointer to file being analysed. + public $info; // Result array. + + // Protected variables + protected $include_path; // getid3 include path. + protected $warnings = array (); + protected $iconv_present; + + // Class constants + const VERSION = '2.0.0b4'; + const FREAD_BUFFER_SIZE = 16384; // Read buffer size in bytes. + const ICONV_TEST_STRING = ' !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘’“”•–—˜™š›œžŸ ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ'; + + + + // Constructor - check PHP enviroment and load library. + public function __construct() { + + // Static varibles - no need to recalc every time we new getid3. + static $include_path; + static $iconv_present; + + + static $initialized; + if ($initialized) { + + // Import static variables + $this->include_path = $include_path; + $this->iconv_present = $iconv_present; + + // Run init checks only on first instance. + return; + } + + // Get include_path + $this->include_path = $include_path = dirname(__FILE__) . '/'; + + // Check for presence of iconv() and make sure it works (simpel test only). + if (function_exists('iconv') && @iconv('UTF-16LE', 'ISO-8859-1', @iconv('ISO-8859-1', 'UTF-16LE', getid3::ICONV_TEST_STRING)) == getid3::ICONV_TEST_STRING) { + $this->iconv_present = $iconv_present = true; + } + + // iconv() not present - load replacement module. + else { + $this->include_module('lib.iconv_replacement'); + $this->iconv_present = $iconv_present = false; + } + + + // Require magic_quotes_runtime off + if (get_magic_quotes_runtime()) { + throw new getid3_exception('magic_quotes_runtime must be disabled before running getID3(). Surround getid3 block by set_magic_quotes_runtime(0) and set_magic_quotes_runtime(1).'); + } + + + // Check memory limit. + $memory_limit = ini_get('memory_limit'); + if (eregi('([0-9]+)M', $memory_limit, $matches)) { + // could be stored as "16M" rather than 16777216 for example + $memory_limit = $matches[1] * 1048576; + } + if ($memory_limit <= 0) { + // Should not happen. + } elseif ($memory_limit <= 4194304) { + $this->warning('[SERIOUS] PHP has less than 4 Mb available memory and will very likely run out. Increase memory_limit in php.ini.'); + } elseif ($memory_limit <= 12582912) { + $this->warning('PHP has less than 12 Mb available memory and might run out if all modules are loaded. Increase memory_limit in php.ini if needed.'); + } + + + // Check safe_mode off + if ((bool)ini_get('safe_mode')) { + $this->warning('Safe mode is on, shorten support disabled, md5data/sha1data for ogg vorbis disabled, ogg vorbis/flac tag writing disabled.'); + } + + $initialized = true; + } + + + + // Analyze file by name + public function Analyze($filename) { + + // Init and save values + $this->filename = $filename; + $this->warnings = array (); + + // Init result array and set parameters + $this->info = array (); + $this->info['GETID3_VERSION'] = getid3::VERSION; + + // Remote files not supported + if (preg_match('/^(ht|f)tp:\/\//', $filename)) { + throw new getid3_exception('Remote files are not supported - please copy the file locally first.'); + } + + // Open local file + if (!$this->fp = @fopen($filename, 'rb')) { + throw new getid3_exception('Could not open file "'.$filename.'"'); + } + + // Set filesize related parameters + $this->info['filesize'] = filesize($filename); + $this->info['avdataoffset'] = 0; + $this->info['avdataend'] = $this->info['filesize']; + + // Option_max_2gb_check + if ($this->option_max_2gb_check) { + // PHP doesn't support integers larger than 31-bit (~2GB) + // filesize() simply returns (filesize % (pow(2, 32)), no matter the actual filesize + // ftell() returns 0 if seeking to the end is beyond the range of unsigned integer + fseek($this->fp, 0, SEEK_END); + if ((($this->info['filesize'] != 0) && (ftell($this->fp) == 0)) || + ($this->info['filesize'] < 0) || + (ftell($this->fp) < 0)) { + unset($this->info['filesize']); + fclose($this->fp); + throw new getid3_exception('File is most likely larger than 2GB and is not supported by PHP.'); + } + } + + + // ID3v2 detection (NOT parsing) done to make fileformat easier. + if (!$this->option_tag_id3v2) { + + fseek($this->fp, 0, SEEK_SET); + $header = fread($this->fp, 10); + if (substr($header, 0, 3) == 'ID3' && strlen($header) == 10) { + $this->info['id3v2']['header'] = true; + $this->info['id3v2']['majorversion'] = ord($header{3}); + $this->info['id3v2']['minorversion'] = ord($header{4}); + $this->info['avdataoffset'] += getid3_lib::BigEndian2Int(substr($header, 6, 4), 1) + 10; // length of ID3v2 tag in 10-byte header doesn't include 10-byte header length + } + } + + + // Handle tags + foreach (array ("id3v2", "id3v1", "apetag", "lyrics3") as $tag_name) { + + $option_tag = 'option_tag_' . $tag_name; + if ($this->$option_tag) { + $this->include_module('tag.'.$tag_name); + try { + $tag_class = 'getid3_' . $tag_name; + $tag = new $tag_class($this); + $tag->Analyze(); + } + catch (getid3_exception $e) { + throw $e; + } + } + } + + + + //// Determine file format by magic bytes in file header. + + // Read 32 kb file data + fseek($this->fp, $this->info['avdataoffset'], SEEK_SET); + $filedata = fread($this->fp, 32774); + + // Get huge FileFormatArray + $file_format_array = getid3::GetFileFormatArray(); + + // Identify file format - loop through $format_info and detect with reg expr + foreach ($file_format_array as $name => $info) { + + if (preg_match('/'.$info['pattern'].'/s', $filedata)) { // The /s switch on preg_match() forces preg_match() NOT to treat newline (0x0A) characters as special chars but do a binary match + + // Format detected but not supported + if (!@$info['module'] || !@$info['group']) { + fclose($this->fp); + $this->info['fileformat'] = $name; + $this->info['mime_type'] = $info['mime_type']; + $this->warning('Format only detected. Parsing not available yet.'); + $this->info['warning'] = $this->warnings; + return $this->info; + } + + $determined_format = $info; // copy $info deleted by foreach() + continue; + } + } + + // Unable to determine file format + if (!@$determined_format) { + + // Too many mp3 encoders on the market put gabage in front of mpeg files + // use assume format on these if format detection failed + if (preg_match('/\.mp[123a]$/i', $filename)) { + $determined_format = $file_format_array['mp3']; + } + + else { + fclose($this->fp); + throw new getid3_exception('Unable to determine file format'); + } + } + + // Free memory + unset($file_format_array); + + // Check for illegal ID3 tags + if (@$determined_format['fail_id3'] && (@$this->info['id3v1'] || @$this->info['id3v2'])) { + if ($determined_format['fail_id3'] === 'ERROR') { + fclose($this->fp); + throw new getid3_exception('ID3 tags not allowed on this file type.'); + } + elseif ($determined_format['fail_id3'] === 'WARNING') { + @$this->info['id3v1'] and $this->warning('ID3v1 tags not allowed on this file type.'); + @$this->info['id3v2'] and $this->warning('ID3v2 tags not allowed on this file type.'); + } + } + + // Check for illegal APE tags + if (@$determined_format['fail_ape'] && @$this->info['tags']['ape']) { + if ($determined_format['fail_ape'] === 'ERROR') { + fclose($this->fp); + throw new getid3_exception('APE tags not allowed on this file type.'); + } elseif ($determined_format['fail_ape'] === 'WARNING') { + $this->warning('APE tags not allowed on this file type.'); + } + } + + + // Set mime type + $this->info['mime_type'] = $determined_format['mime_type']; + + // Calc module file name + $determined_format['include'] = 'module.'.$determined_format['group'].'.'.$determined_format['module'].'.php'; + + // Supported format signature pattern detected, but module deleted. + if (!file_exists($this->include_path.$determined_format['include'])) { + fclose($this->fp); + throw new getid3_exception('Format not supported, module, '.$determined_format['include'].', was removed.'); + } + + // Include module + $this->include_module($determined_format['group'].'.'.$determined_format['module']); + + // Instantiate module class and analyze + $class_name = 'getid3_'.$determined_format['module']; + if (!class_exists($class_name)) { + throw new getid3_exception('Format not supported, module, '.$determined_format['include'].', is corrupt.'); + } + $class = new $class_name($this); + + try { + $this->option_analyze and $class->Analyze(); + } + catch (getid3_exception $e) { + throw $e; + } + catch (Exception $e) { + throw new getid3_exception('Corrupt file.'); + } + + // Close file + fclose($this->fp); + + // Optional - Process all tags - copy to 'tags' and convert charsets + if ($this->option_tags_process) { + $this->HandleAllTags(); + } + + + //// Optional - perform more calculations + if ($this->option_extra_info) { + + // Set channelmode on audio + if (@$this->info['audio']['channels'] == '1') { + $this->info['audio']['channelmode'] = 'mono'; + } elseif (@$this->info['audio']['channels'] == '2') { + $this->info['audio']['channelmode'] = 'stereo'; + } + + // Calculate combined bitrate - audio + video + $combined_bitrate = 0; + $combined_bitrate += (isset($this->info['audio']['bitrate']) ? $this->info['audio']['bitrate'] : 0); + $combined_bitrate += (isset($this->info['video']['bitrate']) ? $this->info['video']['bitrate'] : 0); + if (($combined_bitrate > 0) && empty($this->info['bitrate'])) { + $this->info['bitrate'] = $combined_bitrate; + } + if (!isset($this->info['playtime_seconds']) && !empty($this->info['bitrate'])) { + $this->info['playtime_seconds'] = (($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['bitrate']; + } + + // Set playtime string + if (!empty($this->info['playtime_seconds']) && empty($this->info['playtime_string'])) { + $this->info['playtime_string'] = floor(round($this->info['playtime_seconds']) / 60) . ':' . str_pad(floor(round($this->info['playtime_seconds']) % 60), 2, 0, STR_PAD_LEFT);; + } + + + // CalculateCompressionRatioVideo() { + if (@$this->info['video'] && @$this->info['video']['resolution_x'] && @$this->info['video']['resolution_y'] && @$this->info['video']['bits_per_sample']) { + + // From static image formats + if (in_array($this->info['video']['dataformat'], array ('bmp', 'gif', 'jpeg', 'jpg', 'png', 'tiff'))) { + $frame_rate = 1; + $bitrate_compressed = $this->info['filesize'] * 8; + } + + // From video formats + else { + $frame_rate = @$this->info['video']['frame_rate']; + $bitrate_compressed = @$this->info['video']['bitrate']; + } + + if ($frame_rate && $bitrate_compressed) { + $this->info['video']['compression_ratio'] = $bitrate_compressed / ($this->info['video']['resolution_x'] * $this->info['video']['resolution_y'] * $this->info['video']['bits_per_sample'] * $frame_rate); + } + } + + + // CalculateCompressionRatioAudio() { + if (@$this->info['audio']['bitrate'] && @$this->info['audio']['channels'] && @$this->info['audio']['sample_rate']) { + $this->info['audio']['compression_ratio'] = $this->info['audio']['bitrate'] / ($this->info['audio']['channels'] * $this->info['audio']['sample_rate'] * (@$this->info['audio']['bits_per_sample'] ? $this->info['audio']['bits_per_sample'] : 16)); + } + + if (@$this->info['audio']['streams']) { + foreach ($this->info['audio']['streams'] as $stream_number => $stream_data) { + if (@$stream_data['bitrate'] && @$stream_data['channels'] && @$stream_data['sample_rate']) { + $this->info['audio']['streams'][$stream_number]['compression_ratio'] = $stream_data['bitrate'] / ($stream_data['channels'] * $stream_data['sample_rate'] * (@$stream_data['bits_per_sample'] ? $stream_data['bits_per_sample'] : 16)); + } + } + } + + + // CalculateReplayGain() { + if (@$this->info['replay_gain']) { + if (!@$this->info['replay_gain']['reference_volume']) { + $this->info['replay_gain']['reference_volume'] = 89; + } + if (isset($this->info['replay_gain']['track']['adjustment'])) { + $this->info['replay_gain']['track']['volume'] = $this->info['replay_gain']['reference_volume'] - $this->info['replay_gain']['track']['adjustment']; + } + if (isset($this->info['replay_gain']['album']['adjustment'])) { + $this->info['replay_gain']['album']['volume'] = $this->info['replay_gain']['reference_volume'] - $this->info['replay_gain']['album']['adjustment']; + } + + if (isset($this->info['replay_gain']['track']['peak'])) { + $this->info['replay_gain']['track']['max_noclip_gain'] = 0 - 20 * log10($this->info['replay_gain']['track']['peak']); + } + if (isset($this->info['replay_gain']['album']['peak'])) { + $this->info['replay_gain']['album']['max_noclip_gain'] = 0 - 20 * log10($this->info['replay_gain']['album']['peak']); + } + } + + + // ProcessAudioStreams() { + if (@!$this->info['audio']['streams'] && (@$this->info['audio']['bitrate'] || @$this->info['audio']['channels'] || @$this->info['audio']['sample_rate'])) { + foreach ($this->info['audio'] as $key => $value) { + if ($key != 'streams') { + $this->info['audio']['streams'][0][$key] = $value; + } + } + } + } + + + // Get the md5/sha1sum of the audio/video portion of the file - without ID3/APE/Lyrics3/etc header/footer tags. + if ($this->option_md5_data || $this->option_sha1_data) { + + // Load data-hash library if needed + $this->include_module('lib.data_hash'); + + if ($this->option_sha1_data) { + new getid3_lib_data_hash($this, 'sha1'); + } + + if ($this->option_md5_data) { + + // no md5_data_source or option disabled -- md5_data_source supported by FLAC, MAC, OptimFROG, Wavpack4 + if (!$this->option_md5_data_source || !@$this->info['md5_data_source']) { + new getid3_lib_data_hash($this, 'md5'); + } + + // copy md5_data_source to md5_data if option set to true + elseif ($this->option_md5_data_source && @$this->info['md5_data_source']) { + $this->info['md5_data'] = $this->info['md5_data_source']; + } + } + } + + // Set warnings + if ($this->warnings) { + $this->info['warning'] = $this->warnings; + } + + // Return result + return $this->info; + } + + + + // Return array of warnings + public function warnings() { + + return $this->warnings; + } + + + + // Add warning(s) to $this->warnings[] + public function warning($message) { + + if (is_array($message)) { + $this->warnings = array_merge($this->warnings, $message); + } + else { + $this->warnings[] = $message; + } + } + + + + // Clear all warnings when cloning + public function __clone() { + + $this->warnings = array (); + + // Copy info array, otherwise it will be a reference. + $temp = $this->info; + unset($this->info); + $this->info = $temp; + } + + + + // Convert string between charsets -- iconv() wrapper + public function iconv($in_charset, $out_charset, $string, $drop01 = false) { + + if ($drop01 && ($string === "\x00" || $string === "\x01")) { + return ''; + } + + + if (!$this->iconv_present) { + return getid3_iconv_replacement::iconv($in_charset, $out_charset, $string); + } + + + // iconv() present + if ($result = @iconv($in_charset, $out_charset.'//TRANSLIT', $string)) { + + if ($out_charset == 'ISO-8859-1') { + return rtrim($result, "\x00"); + } + return $result; + } + + $this->warning('iconv() was unable to convert the string: "' . $string . '" from ' . $in_charset . ' to ' . $out_charset); + return $string; + } + + + + public function include_module($name) { + + if (!file_exists($this->include_path.'module.'.$name.'.php')) { + throw new getid3_exception('Required module.'.$name.'.php is missing.'); + } + + include_once($this->include_path.'module.'.$name.'.php'); + } + + + + public function include_module_optional($name) { + + if (!file_exists($this->include_path.'module.'.$name.'.php')) { + return; + } + + include_once($this->include_path.'module.'.$name.'.php'); + return true; + } + + + // Return array containing information about all supported formats + public static function GetFileFormatArray() { + + static $format_info = array ( + + // Audio formats + + // AC-3 - audio - Dolby AC-3 / Dolby Digital + 'ac3' => array ( + 'pattern' => '^\x0B\x77', + 'group' => 'audio', + 'module' => 'ac3', + 'mime_type' => 'audio/ac3', + ), + + // AAC - audio - Advanced Audio Coding (AAC) - ADIF format + 'adif' => array ( + 'pattern' => '^ADIF', + 'group' => 'audio', + 'module' => 'aac_adif', + 'mime_type' => 'application/octet-stream', + 'fail_ape' => 'WARNING', + ), + + + // AAC - audio - Advanced Audio Coding (AAC) - ADTS format (very similar to MP3) + 'adts' => array ( + 'pattern' => '^\xFF[\xF0-\xF1\xF8-\xF9]', + 'group' => 'audio', + 'module' => 'aac_adts', + 'mime_type' => 'application/octet-stream', + 'fail_ape' => 'WARNING', + ), + + + // AU - audio - NeXT/Sun AUdio (AU) + 'au' => array ( + 'pattern' => '^\.snd', + 'group' => 'audio', + 'module' => 'au', + 'mime_type' => 'audio/basic', + ), + + // AVR - audio - Audio Visual Research + 'avr' => array ( + 'pattern' => '^2BIT', + 'group' => 'audio', + 'module' => 'avr', + 'mime_type' => 'application/octet-stream', + ), + + // BONK - audio - Bonk v0.9+ + 'bonk' => array ( + 'pattern' => '^\x00(BONK|INFO|META| ID3)', + 'group' => 'audio', + 'module' => 'bonk', + 'mime_type' => 'audio/xmms-bonk', + ), + + // DTS - audio - Dolby Theatre System + 'dts' => array( + 'pattern' => '^\x7F\xFE\x80\x01', + 'group' => 'audio', + 'module' => 'dts', + 'mime_type' => 'audio/dts', + ), + + // FLAC - audio - Free Lossless Audio Codec + 'flac' => array ( + 'pattern' => '^fLaC', + 'group' => 'audio', + 'module' => 'xiph', + 'mime_type' => 'audio/x-flac', + ), + + // LA - audio - Lossless Audio (LA) + 'la' => array ( + 'pattern' => '^LA0[2-4]', + 'group' => 'audio', + 'module' => 'la', + 'mime_type' => 'application/octet-stream', + ), + + // LPAC - audio - Lossless Predictive Audio Compression (LPAC) + 'lpac' => array ( + 'pattern' => '^LPAC', + 'group' => 'audio', + 'module' => 'lpac', + 'mime_type' => 'application/octet-stream', + ), + + // MIDI - audio - MIDI (Musical Instrument Digital Interface) + 'midi' => array ( + 'pattern' => '^MThd', + 'group' => 'audio', + 'module' => 'midi', + 'mime_type' => 'audio/midi', + ), + + // MAC - audio - Monkey's Audio Compressor + 'mac' => array ( + 'pattern' => '^MAC ', + 'group' => 'audio', + 'module' => 'monkey', + 'mime_type' => 'application/octet-stream', + ), + + // MOD - audio - MODule (assorted sub-formats) + 'mod' => array ( + 'pattern' => '^.{1080}(M.K.|[5-9]CHN|[1-3][0-9]CH)', + 'mime_type' => 'audio/mod', + ), + + // MOD - audio - MODule (Impulse Tracker) + 'it' => array ( + 'pattern' => '^IMPM', + 'mime_type' => 'audio/it', + ), + + // MOD - audio - MODule (eXtended Module, various sub-formats) + 'xm' => array ( + 'pattern' => '^Extended Module', + 'mime_type' => 'audio/xm', + ), + + // MOD - audio - MODule (ScreamTracker) + 's3m' => array ( + 'pattern' => '^.{44}SCRM', + 'mime_type' => 'audio/s3m', + ), + + // MPC - audio - Musepack / MPEGplus SV7+ + 'mpc' => array ( + 'pattern' => '^(MP\+)', + 'group' => 'audio', + 'module' => 'mpc', + 'mime_type' => 'audio/x-musepack', + ), + + // MPC - audio - Musepack / MPEGplus SV4-6 + 'mpc_old' => array ( + 'pattern' => '^([\x00\x01\x10\x11\x40\x41\x50\x51\x80\x81\x90\x91\xC0\xC1\xD0\xD1][\x20-37][\x00\x20\x40\x60\x80\xA0\xC0\xE0])', + 'group' => 'audio', + 'module' => 'mpc_old', + 'mime_type' => 'application/octet-stream', + ), + + + // MP3 - audio - MPEG-audio Layer 3 (very similar to AAC-ADTS) + 'mp3' => array ( + 'pattern' => '^\xFF[\xE2-\xE7\xF2-\xF7\xFA-\xFF][\x00-\xEB]', + 'group' => 'audio', + 'module' => 'mp3', + 'mime_type' => 'audio/mpeg', + ), + + // OFR - audio - OptimFROG + 'ofr' => array ( + 'pattern' => '^(\*RIFF|OFR)', + 'group' => 'audio', + 'module' => 'optimfrog', + 'mime_type' => 'application/octet-stream', + ), + + // RKAU - audio - RKive AUdio compressor + 'rkau' => array ( + 'pattern' => '^RKA', + 'group' => 'audio', + 'module' => 'rkau', + 'mime_type' => 'application/octet-stream', + ), + + // SHN - audio - Shorten + 'shn' => array ( + 'pattern' => '^ajkg', + 'group' => 'audio', + 'module' => 'shorten', + 'mime_type' => 'audio/xmms-shn', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // TTA - audio - TTA Lossless Audio Compressor (http://tta.corecodec.org) + 'tta' => array ( + 'pattern' => '^TTA', // could also be '^TTA(\x01|\x02|\x03|2|1)' + 'group' => 'audio', + 'module' => 'tta', + 'mime_type' => 'application/octet-stream', + ), + + // VOC - audio - Creative Voice (VOC) + 'voc' => array ( + 'pattern' => '^Creative Voice File', + 'group' => 'audio', + 'module' => 'voc', + 'mime_type' => 'audio/voc', + ), + + // VQF - audio - transform-domain weighted interleave Vector Quantization Format (VQF) + 'vqf' => array ( + 'pattern' => '^TWIN', + 'group' => 'audio', + 'module' => 'vqf', + 'mime_type' => 'application/octet-stream', + ), + + // WV - audio - WavPack (v4.0+) + 'vw' => array( + 'pattern' => '^wvpk', + 'group' => 'audio', + 'module' => 'wavpack', + 'mime_type' => 'application/octet-stream', + ), + + + // Audio-Video formats + + // ASF - audio/video - Advanced Streaming Format, Windows Media Video, Windows Media Audio + 'asf' => array ( + 'pattern' => '^\x30\x26\xB2\x75\x8E\x66\xCF\x11\xA6\xD9\x00\xAA\x00\x62\xCE\x6C', + 'group' => 'audio-video', + 'module' => 'asf', + 'mime_type' => 'video/x-ms-asf', + ), + + // BINK - audio/video - Bink / Smacker + 'bink' => array( + 'pattern' => '^(BIK|SMK)', + 'mime_type' => 'application/octet-stream', + ), + + // FLV - audio/video - FLash Video + 'flv' => array( + 'pattern' => '^FLV\x01', + 'group' => 'audio-video', + 'module' => 'flv', + 'mime_type' => 'video/x-flv', + ), + + // MKAV - audio/video - Mastroka + 'matroska' => array ( + 'pattern' => '^\x1A\x45\xDF\xA3', + 'mime_type' => 'application/octet-stream', + ), + + // MPEG - audio/video - MPEG (Moving Pictures Experts Group) + 'mpeg' => array ( + 'pattern' => '^\x00\x00\x01(\xBA|\xB3)', + 'group' => 'audio-video', + 'module' => 'mpeg', + 'mime_type' => 'video/mpeg', + ), + + // NSV - audio/video - Nullsoft Streaming Video (NSV) + 'nsv' => array ( + 'pattern' => '^NSV[sf]', + 'group' => 'audio-video', + 'module' => 'nsv', + 'mime_type' => 'application/octet-stream', + ), + + // Ogg - audio/video - Ogg (Ogg Vorbis, OggFLAC, Speex, Ogg Theora(*), Ogg Tarkin(*)) + 'ogg' => array ( + 'pattern' => '^OggS', + 'group' => 'audio', + 'module' => 'xiph', + 'mime_type' => 'application/ogg', + 'fail_id3' => 'WARNING', + 'fail_ape' => 'WARNING', + ), + + // QT - audio/video - Quicktime + 'quicktime' => array ( + 'pattern' => '^.{4}(cmov|free|ftyp|mdat|moov|pnot|skip|wide)', + 'group' => 'audio-video', + 'module' => 'quicktime', + 'mime_type' => 'video/quicktime', + ), + + // RIFF - audio/video - Resource Interchange File Format (RIFF) / WAV / AVI / CD-audio / SDSS = renamed variant used by SmartSound QuickTracks (www.smartsound.com) / FORM = Audio Interchange File Format (AIFF) + 'riff' => array ( + 'pattern' => '^(RIFF|SDSS|FORM)', + 'group' => 'audio-video', + 'module' => 'riff', + 'mime_type' => 'audio/x-wave', + 'fail_ape' => 'WARNING', + ), + + // Real - audio/video - RealAudio, RealVideo + 'real' => array ( + 'pattern' => '^(\.RMF|.ra)', + 'group' => 'audio-video', + 'module' => 'real', + 'mime_type' => 'audio/x-realaudio', + ), + + // SWF - audio/video - ShockWave Flash + 'swf' => array ( + 'pattern' => '^(F|C)WS', + 'group' => 'audio-video', + 'module' => 'swf', + 'mime_type' => 'application/x-shockwave-flash', + ), + + + // Still-Image formats + + // BMP - still image - Bitmap (Windows, OS/2; uncompressed, RLE8, RLE4) + 'bmp' => array ( + 'pattern' => '^BM', + 'group' => 'graphic', + 'module' => 'bmp', + 'mime_type' => 'image/bmp', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // GIF - still image - Graphics Interchange Format + 'gif' => array ( + 'pattern' => '^GIF', + 'group' => 'graphic', + 'module' => 'gif', + 'mime_type' => 'image/gif', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // JPEG - still image - Joint Photographic Experts Group (JPEG) + 'jpeg' => array ( + 'pattern' => '^\xFF\xD8\xFF', + 'group' => 'graphic', + 'module' => 'jpeg', + 'mime_type' => 'image/jpeg', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // PCD - still image - Kodak Photo CD + 'pcd' => array ( + 'pattern' => '^.{2048}PCD_IPI\x00', + 'group' => 'graphic', + 'module' => 'pcd', + 'mime_type' => 'image/x-photo-cd', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + + // PNG - still image - Portable Network Graphics (PNG) + 'png' => array ( + 'pattern' => '^\x89\x50\x4E\x47\x0D\x0A\x1A\x0A', + 'group' => 'graphic', + 'module' => 'png', + 'mime_type' => 'image/png', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + + // SVG - still image - Scalable Vector Graphics (SVG) + 'svg' => array( + 'pattern' => ' 'image/svg+xml', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + + // TIFF - still image - Tagged Information File Format (TIFF) + 'tiff' => array ( + 'pattern' => '^(II\x2A\x00|MM\x00\x2A)', + 'group' => 'graphic', + 'module' => 'tiff', + 'mime_type' => 'image/tiff', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + + // Data formats + + 'exe' => array( + 'pattern' => '^MZ', + 'mime_type' => 'application/octet-stream', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // ISO - data - International Standards Organization (ISO) CD-ROM Image + 'iso' => array ( + 'pattern' => '^.{32769}CD001', + 'group' => 'misc', + 'module' => 'iso', + 'mime_type' => 'application/octet-stream', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // RAR - data - RAR compressed data + 'rar' => array( + 'pattern' => '^Rar\!', + 'mime_type' => 'application/octet-stream', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // SZIP - audio - SZIP compressed data + 'szip' => array ( + 'pattern' => '^SZ\x0A\x04', + 'group' => 'archive', + 'module' => 'szip', + 'mime_type' => 'application/octet-stream', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // TAR - data - TAR compressed data + 'tar' => array( + 'pattern' => '^.{100}[0-9\x20]{7}\x00[0-9\x20]{7}\x00[0-9\x20]{7}\x00[0-9\x20\x00]{12}[0-9\x20\x00]{12}', + 'group' => 'archive', + 'module' => 'tar', + 'mime_type' => 'application/x-tar', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // GZIP - data - GZIP compressed data + 'gz' => array( + 'pattern' => '^\x1F\x8B\x08', + 'group' => 'archive', + 'module' => 'gzip', + 'mime_type' => 'application/x-gzip', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + + // ZIP - data - ZIP compressed data + 'zip' => array ( + 'pattern' => '^PK\x03\x04', + 'group' => 'archive', + 'module' => 'zip', + 'mime_type' => 'application/zip', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + + // PAR2 - data - Parity Volume Set Specification 2.0 + 'par2' => array ( + 'pattern' => '^PAR2\x00PKT', + 'mime_type' => 'application/octet-stream', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + + // PDF - data - Portable Document Format + 'pdf' => array( + 'pattern' => '^\x25PDF', + 'mime_type' => 'application/pdf', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + + // DOC - data - Microsoft Word + 'msoffice' => array( + 'pattern' => '^\xD0\xCF\x11\xE0', // D0CF11E == DOCFILE == Microsoft Office Document + 'mime_type' => 'application/octet-stream', + 'fail_id3' => 'ERROR', + 'fail_ape' => 'ERROR', + ), + ); + + return $format_info; + } + + + + // Recursive over array - converts array to $encoding charset from $this->encoding + function CharConvert(&$array, $encoding) { + + // Identical encoding - end here + if ($encoding == $this->encoding) { + return; + } + + // Loop thru array + foreach ($array as $key => $value) { + + // Go recursive + if (is_array($value)) { + $this->CharConvert($array[$key], $encoding); + } + + // Convert string + elseif (is_string($value)) { + $array[$key] = $this->iconv($encoding, $this->encoding, $value); + } + } + } + + + + // Convert and copy tags + protected function HandleAllTags() { + + // Key name => array (tag name, character encoding) + static $tags = array ( + 'asf' => array ('asf', 'UTF-16LE'), + 'midi' => array ('midi', 'ISO-8859-1'), + 'nsv' => array ('nsv', 'ISO-8859-1'), + 'ogg' => array ('vorbiscomment', 'UTF-8'), + 'png' => array ('png', 'UTF-8'), + 'tiff' => array ('tiff', 'ISO-8859-1'), + 'quicktime' => array ('quicktime', 'ISO-8859-1'), + 'real' => array ('real', 'ISO-8859-1'), + 'vqf' => array ('vqf', 'ISO-8859-1'), + 'zip' => array ('zip', 'ISO-8859-1'), + 'riff' => array ('riff', 'ISO-8859-1'), + 'lyrics3' => array ('lyrics3', 'ISO-8859-1'), + 'id3v1' => array ('id3v1', ''), // change below - cannot assign variable to static array + 'id3v2' => array ('id3v2', 'UTF-8'), // module converts all frames to UTF-8 + 'ape' => array ('ape', 'UTF-8') + ); + $tags['id3v1'][1] = $this->encoding_id3v1; + + // Loop thru tags array + foreach ($tags as $comment_name => $tag_name_encoding_array) { + list($tag_name, $encoding) = $tag_name_encoding_array; + + // Fill in default encoding type if not already present + @$this->info[$comment_name] and $this->info[$comment_name]['encoding'] = $encoding; + + // Copy comments if key name set + if (@$this->info[$comment_name]['comments']) { + + foreach ($this->info[$comment_name]['comments'] as $tag_key => $value_array) { + foreach ($value_array as $key => $value) { + if (strlen(trim($value)) > 0) { + $this->info['tags'][$tag_name][trim($tag_key)][] = $value; // do not trim!! Unicode characters will get mangled if trailing nulls are removed! + } + } + + } + + if (!@$this->info['tags'][$tag_name]) { + // comments are set but contain nothing but empty strings, so skip + continue; + } + + $this->CharConvert($this->info['tags'][$tag_name], $encoding); + } + } + + + // Merge comments from ['tags'] into common ['comments'] + if (@$this->info['tags']) { + + foreach ($this->info['tags'] as $tag_type => $tag_array) { + + foreach ($tag_array as $tag_name => $tagdata) { + + foreach ($tagdata as $key => $value) { + + if (!empty($value)) { + + if (empty($this->info['comments'][$tag_name])) { + + // fall through and append value + } + elseif ($tag_type == 'id3v1') { + + $new_value_length = strlen(trim($value)); + foreach ($this->info['comments'][$tag_name] as $existing_key => $existing_value) { + $old_value_length = strlen(trim($existing_value)); + if (($new_value_length <= $old_value_length) && (substr($existing_value, 0, $new_value_length) == trim($value))) { + // new value is identical but shorter-than (or equal-length to) one already in comments - skip + break 2; + } + } + } + else { + + $new_value_length = strlen(trim($value)); + foreach ($this->info['comments'][$tag_name] as $existing_key => $existing_value) { + $old_value_length = strlen(trim($existing_value)); + if (($new_value_length > $old_value_length) && (substr(trim($value), 0, strlen($existing_value)) == $existing_value)) { + $this->info['comments'][$tag_name][$existing_key] = trim($value); + break 2; + } + } + } + + if (empty($this->info['comments'][$tag_name]) || !in_array(trim($value), $this->info['comments'][$tag_name])) { + $this->info['comments'][$tag_name][] = trim($value); + } + } + } + } + } + } + + return true; + } +} + + +abstract class getid3_handler +{ + + protected $getid3; // pointer + + protected $data_string_flag = false; // analyzing filepointer or string + protected $data_string; // string to analyze + protected $data_string_position = 0; // seek position in string + + + public function __construct(getID3 $getid3) { + + $this->getid3 = $getid3; + } + + + // Analyze from file pointer + abstract public function Analyze(); + + + + // Analyze from string instead + public function AnalyzeString(&$string) { + + // Enter string mode + $this->data_string_flag = true; + $this->data_string = $string; + + // Save info + $saved_avdataoffset = $this->getid3->info['avdataoffset']; + $saved_avdataend = $this->getid3->info['avdataend']; + $saved_filesize = $this->getid3->info['filesize']; + + // Reset some info + $this->getid3->info['avdataoffset'] = 0; + $this->getid3->info['avdataend'] = $this->getid3->info['filesize'] = strlen($string); + + // Analyze + $this->Analyze(); + + // Restore some info + $this->getid3->info['avdataoffset'] = $saved_avdataoffset; + $this->getid3->info['avdataend'] = $saved_avdataend; + $this->getid3->info['filesize'] = $saved_filesize; + + // Exit string mode + $this->data_string_flag = false; + } + + + protected function ftell() { + + if ($this->data_string_flag) { + return $this->data_string_position; + } + return ftell($this->getid3->fp); + } + + + protected function fread($bytes) { + + if ($this->data_string_flag) { + $this->data_string_position += $bytes; + return substr($this->data_string, $this->data_string_position - $bytes, $bytes); + } + return fread($this->getid3->fp, $bytes); + } + + + protected function fseek($bytes, $whence = SEEK_SET) { + + if ($this->data_string_flag) { + switch ($whence) { + case SEEK_SET: + $this->data_string_position = $bytes; + return; + + case SEEK_CUR: + $this->data_string_position += $bytes; + return; + + case SEEK_END: + $this->data_string_position = strlen($this->data_string) + $bytes; + return; + } + } + return fseek($this->getid3->fp, $bytes, $whence); + } + +} + + + + +abstract class getid3_handler_write +{ + protected $filename; + protected $user_abort; + + private $fp_lock; + private $owner; + private $group; + private $perms; + + + public function __construct($filename) { + + if (!file_exists($filename)) { + throw new getid3_exception('File does not exist: "' . $filename . '"'); + } + + if (!is_writeable($filename)) { + throw new getid3_exception('File is not writeable: "' . $filename . '"'); + } + + if (!is_writeable(dirname($filename))) { + throw new getid3_exception('Directory is not writeable: ' . dirname($filename) . ' (need to write lock file).'); + } + + $this->user_abort = ignore_user_abort(true); + + $this->fp_lock = fopen($filename . '.getid3.lock', 'w'); + flock($this->fp_lock, LOCK_EX); + + $this->filename = $filename; + } + + + public function __destruct() { + + flock($this->fp_lock, LOCK_UN); + fclose($this->fp_lock); + unlink($this->filename . '.getid3.lock'); + + ignore_user_abort($this->user_abort); + } + + + protected function save_permissions() { + + $this->owner = fileowner($this->filename); + $this->group = filegroup($this->filename); + $this->perms = fileperms($this->filename); + } + + + protected function restore_permissions() { + + @chown($this->filename, $this->owner); + @chgrp($this->filename, $this->group); + @chmod($this->filename, $this->perms); + } + + + abstract public function read(); + + abstract public function write(); + + abstract public function remove(); + +} + + + + +class getid3_exception extends Exception +{ + public $message; + +} + + + + +class getid3_lib +{ + + // Convert Little Endian byte string to int - max 32 bits + public static function LittleEndian2Int($byte_word, $signed = false) { + + return getid3_lib::BigEndian2Int(strrev($byte_word), $signed); + } + + + + // Convert number to Little Endian byte string + public static function LittleEndian2String($number, $minbytes=1, $synchsafe=false) { + $intstring = ''; + while ($number > 0) { + if ($synchsafe) { + $intstring = $intstring.chr($number & 127); + $number >>= 7; + } else { + $intstring = $intstring.chr($number & 255); + $number >>= 8; + } + } + return str_pad($intstring, $minbytes, "\x00", STR_PAD_RIGHT); + } + + + + // Convert Big Endian byte string to int - max 32 bits + public static function BigEndian2Int($byte_word, $signed = false) { + + $int_value = 0; + $byte_wordlen = strlen($byte_word); + + for ($i = 0; $i < $byte_wordlen; $i++) { + $int_value += ord($byte_word{$i}) * pow(256, ($byte_wordlen - 1 - $i)); + } + + if ($signed) { + $sign_mask_bit = 0x80 << (8 * ($byte_wordlen - 1)); + if ($int_value & $sign_mask_bit) { + $int_value = 0 - ($int_value & ($sign_mask_bit - 1)); + } + } + + return $int_value; + } + + + + // Convert Big Endian byte sybc safe string to int - max 32 bits + public static function BigEndianSyncSafe2Int($byte_word) { + + $int_value = 0; + $byte_wordlen = strlen($byte_word); + + // disregard MSB, effectively 7-bit bytes + for ($i = 0; $i < $byte_wordlen; $i++) { + $int_value = $int_value | (ord($byte_word{$i}) & 0x7F) << (($byte_wordlen - 1 - $i) * 7); + } + return $int_value; + } + + + + // Convert Big Endian byte string to bit string + public static function BigEndian2Bin($byte_word) { + + $bin_value = ''; + $byte_wordlen = strlen($byte_word); + for ($i = 0; $i < $byte_wordlen; $i++) { + $bin_value .= str_pad(decbin(ord($byte_word{$i})), 8, '0', STR_PAD_LEFT); + } + return $bin_value; + } + + + + public static function BigEndian2Float($byte_word) { + + // ANSI/IEEE Standard 754-1985, Standard for Binary Floating Point Arithmetic + // http://www.psc.edu/general/software/packages/ieee/ieee.html + // http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee.html + + $bit_word = getid3_lib::BigEndian2Bin($byte_word); + if (!$bit_word) { + return 0; + } + $sign_bit = $bit_word{0}; + + switch (strlen($byte_word) * 8) { + case 32: + $exponent_bits = 8; + $fraction_bits = 23; + break; + + case 64: + $exponent_bits = 11; + $fraction_bits = 52; + break; + + case 80: + // 80-bit Apple SANE format + // http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/ + $exponent_string = substr($bit_word, 1, 15); + $is_normalized = intval($bit_word{16}); + $fraction_string = substr($bit_word, 17, 63); + $exponent = pow(2, getid3_lib::Bin2Dec($exponent_string) - 16383); + $fraction = $is_normalized + getid3_lib::DecimalBinary2Float($fraction_string); + $float_value = $exponent * $fraction; + if ($sign_bit == '1') { + $float_value *= -1; + } + return $float_value; + break; + + default: + return false; + break; + } + $exponent_string = substr($bit_word, 1, $exponent_bits); + $fraction_string = substr($bit_word, $exponent_bits + 1, $fraction_bits); + $exponent = bindec($exponent_string); + $fraction = bindec($fraction_string); + + if (($exponent == (pow(2, $exponent_bits) - 1)) && ($fraction != 0)) { + // Not a Number + $float_value = false; + } elseif (($exponent == (pow(2, $exponent_bits) - 1)) && ($fraction == 0)) { + if ($sign_bit == '1') { + $float_value = '-infinity'; + } else { + $float_value = '+infinity'; + } + } elseif (($exponent == 0) && ($fraction == 0)) { + if ($sign_bit == '1') { + $float_value = -0; + } else { + $float_value = 0; + } + $float_value = ($sign_bit ? 0 : -0); + } elseif (($exponent == 0) && ($fraction != 0)) { + // These are 'unnormalized' values + $float_value = pow(2, (-1 * (pow(2, $exponent_bits - 1) - 2))) * getid3_lib::DecimalBinary2Float($fraction_string); + if ($sign_bit == '1') { + $float_value *= -1; + } + } elseif ($exponent != 0) { + $float_value = pow(2, ($exponent - (pow(2, $exponent_bits - 1) - 1))) * (1 + getid3_lib::DecimalBinary2Float($fraction_string)); + if ($sign_bit == '1') { + $float_value *= -1; + } + } + return (float) $float_value; + } + + + + public static function LittleEndian2Float($byte_word) { + + return getid3_lib::BigEndian2Float(strrev($byte_word)); + } + + + + public static function DecimalBinary2Float($binary_numerator) { + $numerator = bindec($binary_numerator); + $denominator = bindec('1'.str_repeat('0', strlen($binary_numerator))); + return ($numerator / $denominator); + } + + + public static function PrintHexBytes($string, $hex=true, $spaces=true, $html_safe=true) { + + $return_string = ''; + for ($i = 0; $i < strlen($string); $i++) { + if ($hex) { + $return_string .= str_pad(dechex(ord($string{$i})), 2, '0', STR_PAD_LEFT); + } else { + $return_string .= ' '.(ereg("[\x20-\x7E]", $string{$i}) ? $string{$i} : '¤'); + } + if ($spaces) { + $return_string .= ' '; + } + } + if ($html_safe) { + $return_string = htmlentities($return_string); + } + return $return_string; + } + + + + // Process header data string - read several values with algorithm and add to target + // algorithm is one one the getid3_lib::Something2Something() function names + // parts_array is index => length - $target[index] = algorithm(substring(data)) + // - OR just substring(data) if length is negative! + // indexes == 'IGNORE**' are ignored + + public static function ReadSequence($algorithm, &$target, &$data, $offset, $parts_array) { + + // Loop thru $parts_array + foreach ($parts_array as $target_string => $length) { + + // Add to target + if (!strstr($target_string, 'IGNORE')) { + + // substr(....length) + if ($length < 0) { + $target[$target_string] = substr($data, $offset, -$length); + } + + // algorithm(substr(...length)) + else { + $target[$target_string] = getid3_lib::$algorithm(substr($data, $offset, $length)); + } + } + + // Move pointer + $offset += abs($length); + } + } + +} + + + +class getid3_lib_replaygain +{ + + public static function NameLookup($name_code) { + + static $lookup = array ( + 0 => 'not set', + 1 => 'Track Gain Adjustment', + 2 => 'Album Gain Adjustment' + ); + + return @$lookup[$name_code]; + } + + + + public static function OriginatorLookup($originator_code) { + + static $lookup = array ( + 0 => 'unspecified', + 1 => 'pre-set by artist/producer/mastering engineer', + 2 => 'set by user', + 3 => 'determined automatically' + ); + + return @$lookup[$originator_code]; + } + + + + public static function AdjustmentLookup($raw_adjustment, $sign_bit) { + + return (float)$raw_adjustment / 10 * ($sign_bit == 1 ? -1 : 1); + } + + + + public static function GainString($name_code, $originator_code, $replaygain) { + + $sign_bit = $replaygain < 0 ? 1 : 0; + + $stored_replaygain = intval(round($replaygain * 10)); + $gain_string = str_pad(decbin($name_code), 3, '0', STR_PAD_LEFT); + $gain_string .= str_pad(decbin($originator_code), 3, '0', STR_PAD_LEFT); + $gain_string .= $sign_bit; + $gain_string .= str_pad(decbin($stored_replaygain), 9, '0', STR_PAD_LEFT); + + return $gain_string; + } + +} + + + + +?> \ No newline at end of file diff --git a/modules/getid3/module.archive.gzip.php b/modules/getid3/module.archive.gzip.php new file mode 100644 index 00000000..03843428 --- /dev/null +++ b/modules/getid3/module.archive.gzip.php @@ -0,0 +1,296 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.archive.gzip.php | +// | module for analyzing GZIP files | +// | dependencies: PHP compiled with zlib support (optional) | +// +----------------------------------------------------------------------+ +// | Module originally written by Mike Mozolin | +// +----------------------------------------------------------------------+ +// +// $Id: module.archive.gzip.php,v 1.4 2006/12/04 16:00:35 ah Exp $ + + + +class getid3_gzip extends getid3_handler +{ + + // public: Optional file list - disable for speed. + public $option_gzip_parse_contents = true; // decode gzipped files, if possible, and parse recursively (.tar.gz for example) + + + // Reads the gzip-file + function Analyze() { + + $info = &$this->getid3->info; + + $info['fileformat'] = 'gzip'; + + $start_length = 10; + $unpack_header = 'a1id1/a1id2/a1cmethod/a1flags/a4mtime/a1xflags/a1os'; + + //+---+---+---+---+---+---+---+---+---+---+ + //|ID1|ID2|CM |FLG| MTIME |XFL|OS | + //+---+---+---+---+---+---+---+---+---+---+ + + @fseek($this->getid3->fp, 0); + $buffer = @fread($this->getid3->fp, $info['filesize']); + + $arr_members = explode("\x1F\x8B\x08", $buffer); + + while (true) { + $is_wrong_members = false; + $num_members = intval(count($arr_members)); + for ($i = 0; $i < $num_members; $i++) { + if (strlen($arr_members[$i]) == 0) { + continue; + } + $buf = "\x1F\x8B\x08".$arr_members[$i]; + + $attr = unpack($unpack_header, substr($buf, 0, $start_length)); + if (!$this->get_os_type(ord($attr['os']))) { + + // Merge member with previous if wrong OS type + $arr_members[$i - 1] .= $buf; + $arr_members[$i] = ''; + $is_wrong_members = true; + continue; + } + } + if (!$is_wrong_members) { + break; + } + } + + $fpointer = 0; + $idx = 0; + for ($i = 0; $i < $num_members; $i++) { + if (strlen($arr_members[$i]) == 0) { + continue; + } + $info_gzip_member_header_idx = &$info['gzip']['member_header'][++$idx]; + + $buff = "\x1F\x8B\x08".$arr_members[$i]; + + $attr = unpack($unpack_header, substr($buff, 0, $start_length)); + $info_gzip_member_header_idx['filemtime'] = getid3_lib::LittleEndian2Int($attr['mtime']); + $info_gzip_member_header_idx['raw']['id1'] = ord($attr['cmethod']); + $info_gzip_member_header_idx['raw']['id2'] = ord($attr['cmethod']); + $info_gzip_member_header_idx['raw']['cmethod'] = ord($attr['cmethod']); + $info_gzip_member_header_idx['raw']['os'] = ord($attr['os']); + $info_gzip_member_header_idx['raw']['xflags'] = ord($attr['xflags']); + $info_gzip_member_header_idx['raw']['flags'] = ord($attr['flags']); + + $info_gzip_member_header_idx['flags']['crc16'] = (bool) ($info_gzip_member_header_idx['raw']['flags'] & 0x02); + $info_gzip_member_header_idx['flags']['extra'] = (bool) ($info_gzip_member_header_idx['raw']['flags'] & 0x04); + $info_gzip_member_header_idx['flags']['filename'] = (bool) ($info_gzip_member_header_idx['raw']['flags'] & 0x08); + $info_gzip_member_header_idx['flags']['comment'] = (bool) ($info_gzip_member_header_idx['raw']['flags'] & 0x10); + + $info_gzip_member_header_idx['compression'] = $this->get_xflag_type($info_gzip_member_header_idx['raw']['xflags']); + + $info_gzip_member_header_idx['os'] = $this->get_os_type($info_gzip_member_header_idx['raw']['os']); + if (!$info_gzip_member_header_idx['os']) { + $info['error'][] = 'Read error on gzip file'; + return false; + } + + $fpointer = 10; + $arr_xsubfield = array (); + + // bit 2 - FLG.FEXTRA + //+---+---+=================================+ + //| XLEN |...XLEN bytes of "extra field"...| + //+---+---+=================================+ + + if ($info_gzip_member_header_idx['flags']['extra']) { + $w_xlen = substr($buff, $fpointer, 2); + $xlen = getid3_lib::LittleEndian2Int($w_xlen); + $fpointer += 2; + + $info_gzip_member_header_idx['raw']['xfield'] = substr($buff, $fpointer, $xlen); + + // Extra SubFields + //+---+---+---+---+==================================+ + //|SI1|SI2| LEN |... LEN bytes of subfield data ...| + //+---+---+---+---+==================================+ + + $idx = 0; + while (true) { + if ($idx >= $xlen) { + break; + } + $si1 = ord(substr($buff, $fpointer + $idx++, 1)); + $si2 = ord(substr($buff, $fpointer + $idx++, 1)); + if (($si1 == 0x41) && ($si2 == 0x70)) { + $w_xsublen = substr($buff, $fpointer+$idx, 2); + $xsublen = getid3_lib::LittleEndian2Int($w_xsublen); + $idx += 2; + $arr_xsubfield[] = substr($buff, $fpointer+$idx, $xsublen); + $idx += $xsublen; + } else { + break; + } + } + $fpointer += $xlen; + } + + // bit 3 - FLG.FNAME + //+=========================================+ + //|...original file name, zero-terminated...| + //+=========================================+ + // GZIP files may have only one file, with no filename, so assume original filename is current filename without .gz + + $info_gzip_member_header_idx['filename'] = eregi_replace('.gz$', '', @$info['filename']); + if ($info_gzip_member_header_idx['flags']['filename']) { + while (true) { + if (ord($buff[$fpointer]) == 0) { + $fpointer++; + break; + } + $info_gzip_member_header_idx['filename'] .= $buff[$fpointer]; + $fpointer++; + } + } + + // bit 4 - FLG.FCOMMENT + //+===================================+ + //|...file comment, zero-terminated...| + //+===================================+ + + if ($info_gzip_member_header_idx['flags']['comment']) { + while (true) { + if (ord($buff[$fpointer]) == 0) { + $fpointer++; + break; + } + $info_gzip_member_header_idx['comment'] .= $buff[$fpointer]; + $fpointer++; + } + } + + // bit 1 - FLG.FHCRC + //+---+---+ + //| CRC16 | + //+---+---+ + + if ($info_gzip_member_header_idx['flags']['crc16']) { + $w_crc = substr($buff, $fpointer, 2); + $info_gzip_member_header_idx['crc16'] = getid3_lib::LittleEndian2Int($w_crc); + $fpointer += 2; + } + + // bit 0 - FLG.FTEXT + //if ($info_gzip_member_header_idx['raw']['flags'] & 0x01) { + // Ignored... + //} + // bits 5, 6, 7 - reserved + + $info_gzip_member_header_idx['crc32'] = getid3_lib::LittleEndian2Int(substr($buff, strlen($buff) - 8, 4)); + $info_gzip_member_header_idx['filesize'] = getid3_lib::LittleEndian2Int(substr($buff, strlen($buff) - 4)); + + if ($this->option_gzip_parse_contents) { + + // Try to inflate GZip + + if (!function_exists('gzinflate')) { + $this->getid3->warning('PHP does not have zlib support - contents not parsed.'); + return true; + } + + $csize = 0; + $inflated = ''; + $chkcrc32 = ''; + + $cdata = substr($buff, $fpointer); + $cdata = substr($cdata, 0, strlen($cdata) - 8); + $csize = strlen($cdata); + $inflated = gzinflate($cdata); + + // Calculate CRC32 for inflated content + $info_gzip_member_header_idx['crc32_valid'] = (bool) (sprintf('%u', crc32($inflated)) == $info_gzip_member_header_idx['crc32']); + + + //// Analyse contents + + // write content to temp file + if (($temp_file_name = tempnam('*', 'getID3')) === false) { + throw new getid3_exception('Unable to create temporary file.'); + } + + if ($tmp = fopen($temp_file_name, 'wb')) { + fwrite($tmp, $inflated); + fclose($tmp); + + // clone getid3 - we want same settings + $clone = clone $this->getid3; + unset($clone->info); + try { + $clone->Analyze($temp_file_name); + $info_gzip_member_header_idx['parsed_content'] = $clone->info; + } + catch (getid3_exception $e) { + // unable to parse contents + } + + unlink($temp_file_name); + } + + // Unknown/unhandled format + else { + + } + } + } + return true; + } + + + // Converts the OS type + public static function get_os_type($key) { + static $os_type = array ( + '0' => 'FAT filesystem (MS-DOS, OS/2, NT/Win32)', + '1' => 'Amiga', + '2' => 'VMS (or OpenVMS)', + '3' => 'Unix', + '4' => 'VM/CMS', + '5' => 'Atari TOS', + '6' => 'HPFS filesystem (OS/2, NT)', + '7' => 'Macintosh', + '8' => 'Z-System', + '9' => 'CP/M', + '10' => 'TOPS-20', + '11' => 'NTFS filesystem (NT)', + '12' => 'QDOS', + '13' => 'Acorn RISCOS', + '255' => 'unknown' + ); + return @$os_type[$key]; + } + + + // Converts the eXtra FLags + public static function get_xflag_type($key) { + static $xflag_type = array ( + '0' => 'unknown', + '2' => 'maximum compression', + '4' => 'fastest algorithm' + ); + return @$xflag_type[$key]; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.archive.szip.php b/modules/getid3/module.archive.szip.php new file mode 100644 index 00000000..6cd0f985 --- /dev/null +++ b/modules/getid3/module.archive.szip.php @@ -0,0 +1,105 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.archive.szip.php | +// | module for analyzing SZIP compressed files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.archive.szip.php,v 1.2 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_szip extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $szip_rkau = fread($getid3->fp, 6); + + // Magic bytes: 'SZ'."\x0A\x04" + + $getid3->info['fileformat'] = 'szip'; + + $getid3->info['szip']['major_version'] = getid3_lib::BigEndian2Int(substr($szip_rkau, 4, 1)); + $getid3->info['szip']['minor_version'] = getid3_lib::BigEndian2Int(substr($szip_rkau, 5, 1)); + + while (!feof($getid3->fp)) { + $next_block_id = fread($getid3->fp, 2); + switch ($next_block_id) { + case 'SZ': + // Note that szip files can be concatenated, this has the same effect as + // concatenating the files. this also means that global header blocks + // might be present between directory/data blocks. + fseek($getid3->fp, 4, SEEK_CUR); + break; + + case 'BH': + $bh_header_bytes = getid3_lib::BigEndian2Int(fread($getid3->fp, 3)); + $bh_header_data = fread($getid3->fp, $bh_header_bytes); + $bh_header_offset = 0; + while (strpos($bh_header_data, "\x00", $bh_header_offset) > 0) { + //filename as \0 terminated string (empty string indicates end) + //owner as \0 terminated string (empty is same as last file) + //group as \0 terminated string (empty is same as last file) + //3 byte filelength in this block + //2 byte access flags + //4 byte creation time (like in unix) + //4 byte modification time (like in unix) + //4 byte access time (like in unix) + + $bh_data_array['filename'] = substr($bh_header_data, $bh_header_offset, strcspn($bh_header_data, "\x00")); + $bh_header_offset += (strlen($bh_data_array['filename']) + 1); + + $bh_data_array['owner'] = substr($bh_header_data, $bh_header_offset, strcspn($bh_header_data, "\x00")); + $bh_header_offset += (strlen($bh_data_array['owner']) + 1); + + $bh_data_array['group'] = substr($bh_header_data, $bh_header_offset, strcspn($bh_header_data, "\x00")); + $bh_header_offset += (strlen($bh_data_array['group']) + 1); + + $bh_data_array['filelength'] = getid3_lib::BigEndian2Int(substr($bh_header_data, $bh_header_offset, 3)); + $bh_header_offset += 3; + + $bh_data_array['access_flags'] = getid3_lib::BigEndian2Int(substr($bh_header_data, $bh_header_offset, 2)); + $bh_header_offset += 2; + + $bh_data_array['creation_time'] = getid3_lib::BigEndian2Int(substr($bh_header_data, $bh_header_offset, 4)); + $bh_header_offset += 4; + + $bh_data_array['modification_time'] = getid3_lib::BigEndian2Int(substr($bh_header_data, $bh_header_offset, 4)); + $bh_header_offset += 4; + + $bh_data_array['access_time'] = getid3_lib::BigEndian2Int(substr($bh_header_data, $bh_header_offset, 4)); + $bh_header_offset += 4; + + $getid3->info['szip']['BH'][] = $bh_data_array; + } + break; + + default: + break 2; + } + } + + return true; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.archive.tar.php b/modules/getid3/module.archive.tar.php new file mode 100644 index 00000000..d0af3368 --- /dev/null +++ b/modules/getid3/module.archive.tar.php @@ -0,0 +1,231 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.archive.tar.php | +// | module for analyzing TAR files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// | Module originally written by Mike Mozolin | +// +----------------------------------------------------------------------+ +// +// $Id: module.archive.tar.php,v 1.2 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_tar extends getid3_handler +{ + + function Analyze() { + + $info = &$this->getid3->info; + + $info['fileformat'] = 'tar'; + + $fp = $this->getid3->fp; + + fseek($fp, 0); + + $unpack_header = 'a100fname/a8mode/a8uid/a8gid/a12size/a12mtime/a8chksum/a1typflag/a100lnkname/a6magic/a2ver/a32uname/a32gname/a8devmaj/a8devmin/a155/prefix'; + + $null_512k = str_repeat("\0", 512); // end-of-file marker + + $already_warned = false; + + while (!feof($fp)) { + + $buffer = fread($fp, 512); + + // check the block + $checksum = 0; + for ($i = 0; $i < 148; $i++) { + $checksum += ord(substr($buffer, $i, 1)); + } + for ($i = 148; $i < 156; $i++) { + $checksum += ord(' '); + } + for ($i = 156; $i < 512; $i++) { + $checksum += ord(substr($buffer, $i, 1)); + } + $attr = unpack($unpack_header, $buffer); + $name = trim(@$attr['fname']); + $mode = octdec(trim(@$attr['mode'])); + $uid = octdec(trim(@$attr['uid'])); + $gid = octdec(trim(@$attr['gid'])); + $size = octdec(trim(@$attr['size'])); + $mtime = octdec(trim(@$attr['mtime'])); + $chksum = octdec(trim(@$attr['chksum'])); + $typflag = trim(@$attr['typflag']); + $lnkname = trim(@$attr['lnkname']); + $magic = trim(@$attr['magic']); + $ver = trim(@$attr['ver']); + $uname = trim(@$attr['uname']); + $gname = trim(@$attr['gname']); + $devmaj = octdec(trim(@$attr['devmaj'])); + $devmin = octdec(trim(@$attr['devmin'])); + $prefix = trim(@$attr['prefix']); + + // EOF Found + if (($checksum == 256) && ($chksum == 0)) { + break; + } + + // Check if filename if 7bit as spec requires + if (!$already_warned) { + for ($i = 0; $i < strlen($name); $i++) { + if ($name{$i} < chr(32) || $name{$i} > chr(127)) { + $this->getid3->warning('Some filenames contains extended characters, which breaks the tar specifation. This is not uncommon, but you will have to handle the character encoding for filenames yourself.'); + $already_warned = true; + break; + } + } + } + + if ($prefix) { + $name = $prefix.'/'.$name; + } + if ((preg_match('#/$#', $name)) && !$name) { + $typeflag = 5; + } + + // If it's the end of the tar-file... + if ($buffer == $null_512k) { + break; + } + + // Protect against tar-files with garbage at the end + if ($name == '') { + break; + } + + $info['tar']['file_details'][$name] = array ( + 'name' => $name, + 'mode_raw' => $mode, + 'mode' => getid3_tar::display_perms($mode), + 'uid' => $uid, + 'gid' => $gid, + 'size' => $size, + 'mtime' => $mtime, + 'chksum' => $chksum, + 'typeflag' => getid3_tar::get_flag_type($typflag), + 'linkname' => $lnkname, + 'magic' => $magic, + 'version' => $ver, + 'uname' => $uname, + 'gname' => $gname, + 'devmajor' => $devmaj, + 'devminor' => $devmin + ); + + // Skip the next chunk + fseek($fp, $size, SEEK_CUR); + + // Throw away padding + if ($size % 512) { + fseek($fp, 512 - $diff, SEEK_CUR); + } + + } + return true; + } + + + // Parses the file mode to file permissions + public static function display_perms($mode) { + + // Determine Type + if ($mode & 0x1000) { + $type='p'; // FIFO pipe + } + elseif ($mode & 0x2000) { + $type='c'; // Character special + } + elseif ($mode & 0x4000) { + $type='d'; // Directory + } + elseif ($mode & 0x6000) { + $type='b'; // Block special + } + elseif ($mode & 0x8000) { + $type='-'; // Regular + } + elseif ($mode & 0xA000) { + $type='l'; // Symbolic Link + } + elseif ($mode & 0xC000) { + $type='s'; // Socket + } + else { + $type='u'; // UNKNOWN + } + + // Determine permissions + $owner['read'] = (($mode & 00400) ? 'r' : '-'); + $owner['write'] = (($mode & 00200) ? 'w' : '-'); + $owner['execute'] = (($mode & 00100) ? 'x' : '-'); + $group['read'] = (($mode & 00040) ? 'r' : '-'); + $group['write'] = (($mode & 00020) ? 'w' : '-'); + $group['execute'] = (($mode & 00010) ? 'x' : '-'); + $world['read'] = (($mode & 00004) ? 'r' : '-'); + $world['write'] = (($mode & 00002) ? 'w' : '-'); + $world['execute'] = (($mode & 00001) ? 'x' : '-'); + + // Adjust for SUID, SGID and sticky bit + if ($mode & 0x800) { + $owner['execute'] = ($owner['execute'] == 'x') ? 's' : 'S'; + } + if ($mode & 0x400) { + $group['execute'] = ($group['execute'] == 'x') ? 's' : 'S'; + } + if ($mode & 0x200) { + $world['execute'] = ($world['execute'] == 'x') ? 't' : 'T'; + } + + $s = sprintf('%1s', $type); + $s .= sprintf('%1s%1s%1s', $owner['read'], $owner['write'], $owner['execute']); + $s .= sprintf('%1s%1s%1s', $group['read'], $group['write'], $group['execute']); + $s .= sprintf('%1s%1s%1s'."\n", $world['read'], $world['write'], $world['execute']); + + return $s; + } + + + // Converts the file type + public static function get_flag_type($typflag) { + + static $flag_types = array ( + '0' => 'LF_NORMAL', + '1' => 'LF_LINK', + '2' => 'LF_SYNLINK', + '3' => 'LF_CHR', + '4' => 'LF_BLK', + '5' => 'LF_DIR', + '6' => 'LF_FIFO', + '7' => 'LF_CONFIG', + 'D' => 'LF_DUMPDIR', + 'K' => 'LF_LONGLINK', + 'L' => 'LF_LONGNAME', + 'M' => 'LF_MULTIVOL', + 'N' => 'LF_NAMES', + 'S' => 'LF_SPARSE', + 'V' => 'LF_VOLHDR' + ); + + return @$flag_types[$typflag]; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.archive.zip.php b/modules/getid3/module.archive.zip.php new file mode 100644 index 00000000..bb84538b --- /dev/null +++ b/modules/getid3/module.archive.zip.php @@ -0,0 +1,510 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.archive.zip.php | +// | Module for analyzing pkZip files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.archive.zip.php,v 1.4 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_zip extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['zip'] = array (); + $info_zip = &$getid3->info['zip']; + + $getid3->info['fileformat'] = 'zip'; + + $info_zip['encoding'] = 'ISO-8859-1'; + $info_zip['files'] = array (); + $info_zip['compressed_size'] = $info_zip['uncompressed_size'] = $info_zip['entries_count'] = 0; + + $eocd_search_data = ''; + $eocd_search_counter = 0; + while ($eocd_search_counter++ < 512) { + + fseek($getid3->fp, -128 * $eocd_search_counter, SEEK_END); + $eocd_search_data = fread($getid3->fp, 128).$eocd_search_data; + + if (strstr($eocd_search_data, 'PK'."\x05\x06")) { + + $eocd_position = strpos($eocd_search_data, 'PK'."\x05\x06"); + fseek($getid3->fp, (-128 * $eocd_search_counter) + $eocd_position, SEEK_END); + $info_zip['end_central_directory'] = $this->ZIPparseEndOfCentralDirectory(); + + fseek($getid3->fp, $info_zip['end_central_directory']['directory_offset'], SEEK_SET); + $info_zip['entries_count'] = 0; + while ($central_directoryentry = $this->ZIPparseCentralDirectory($getid3->fp)) { + $info_zip['central_directory'][] = $central_directoryentry; + $info_zip['entries_count']++; + $info_zip['compressed_size'] += $central_directoryentry['compressed_size']; + $info_zip['uncompressed_size'] += $central_directoryentry['uncompressed_size']; + + if ($central_directoryentry['uncompressed_size'] > 0) { + $info_zip['files'] = getid3_zip::array_merge_clobber($info_zip['files'], getid3_zip::CreateDeepArray($central_directoryentry['filename'], '/', $central_directoryentry['uncompressed_size'])); + } + } + + if ($info_zip['entries_count'] == 0) { + throw new getid3_exception('No Central Directory entries found (truncated file?)'); + } + + if (!empty($info_zip['end_central_directory']['comment'])) { + $info_zip['comments']['comment'][] = $info_zip['end_central_directory']['comment']; + } + + if (isset($info_zip['central_directory'][0]['compression_method'])) { + $info_zip['compression_method'] = $info_zip['central_directory'][0]['compression_method']; + } + if (isset($info_zip['central_directory'][0]['flags']['compression_speed'])) { + $info_zip['compression_speed'] = $info_zip['central_directory'][0]['flags']['compression_speed']; + } + if (isset($info_zip['compression_method']) && ($info_zip['compression_method'] == 'store') && !isset($info_zip['compression_speed'])) { + $info_zip['compression_speed'] = 'store'; + } + + return true; + } + } + + if ($this->getZIPentriesFilepointer()) { + + // central directory couldn't be found and/or parsed + // scan through actual file data entries, recover as much as possible from probable trucated file + if (@$info_zip['compressed_size'] > ($getid3->info['filesize'] - 46 - 22)) { + throw new getid3_exception('Warning: Truncated file! - Total compressed file sizes ('.$info_zip['compressed_size'].' bytes) is greater than filesize minus Central Directory and End Of Central Directory structures ('.($getid3->info['filesize'] - 46 - 22).' bytes)'); + } + throw new getid3_exception('Cannot find End Of Central Directory - returned list of files in [zip][entries] array may not be complete'); + } + + //throw new getid3_exception('Cannot find End Of Central Directory (truncated file?)'); + } + + + + private function getZIPHeaderFilepointerTopDown() { + + // shortcut + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'zip'; + + $getid3->info['zip'] = array (); + $info_zip['compressed_size'] = $info_zip['uncompressed_size'] = $info_zip['entries_count'] = 0; + + rewind($getid3->fp); + while ($fileentry = $this->ZIPparseLocalFileHeader()) { + $info_zip['entries'][] = $fileentry; + $info_zip['entries_count']++; + } + if ($info_zip['entries_count'] == 0) { + throw new getid3_exception('No Local File Header entries found'); + } + + $info_zip['entries_count'] = 0; + while ($central_directoryentry = $this->ZIPparseCentralDirectory($getid3->fp)) { + $info_zip['central_directory'][] = $central_directoryentry; + $info_zip['entries_count']++; + $info_zip['compressed_size'] += $central_directoryentry['compressed_size']; + $info_zip['uncompressed_size'] += $central_directoryentry['uncompressed_size']; + } + if ($info_zip['entries_count'] == 0) { + throw new getid3_exception('No Central Directory entries found (truncated file?)'); + } + + if ($eocd = $this->ZIPparseEndOfCentralDirectory()) { + $info_zip['end_central_directory'] = $eocd; + } else { + throw new getid3_exception('No End Of Central Directory entry found (truncated file?)'); + } + + if (!@$info_zip['end_central_directory']['comment']) { + $info_zip['comments']['comment'][] = $info_zip['end_central_directory']['comment']; + } + + return true; + } + + + + private function getZIPentriesFilepointer() { + + // shortcut + $getid3 = $this->getid3; + + $getid3->info['zip'] = array (); + $info_zip['compressed_size'] = $info_zip['uncompressed_size'] = $info_zip['entries_count'] = 0; + + rewind($getid3->fp); + while ($fileentry = $this->ZIPparseLocalFileHeader($getid3->fp)) { + $info_zip['entries'][] = $fileentry; + $info_zip['entries_count']++; + $info_zip['compressed_size'] += $fileentry['compressed_size']; + $info_zip['uncompressed_size'] += $fileentry['uncompressed_size']; + } + if ($info_zip['entries_count'] == 0) { + throw new getid3_exception('No Local File Header entries found'); + } + + return true; + } + + + + private function ZIPparseLocalFileHeader() { + + // shortcut + $getid3 = $this->getid3; + + $local_file_header['offset'] = ftell($getid3->fp); + + $zip_local_file_header = fread($getid3->fp, 30); + + $local_file_header['raw']['signature'] = getid3_lib::LittleEndian2Int(substr($zip_local_file_header, 0, 4)); + + // Invalid Local File Header Signature + if ($local_file_header['raw']['signature'] != 0x04034B50) { + fseek($getid3->fp, $local_file_header['offset'], SEEK_SET); // seek back to where filepointer originally was so it can be handled properly + return false; + } + + getid3_lib::ReadSequence('LittleEndian2Int', $local_file_header['raw'], $zip_local_file_header, 4, + array ( + 'extract_version' => 2, + 'general_flags' => 2, + 'compression_method' => 2, + 'last_mod_file_time' => 2, + 'last_mod_file_date' => 2, + 'crc_32' => 2, + 'compressed_size' => 2, + 'uncompressed_size' => 2, + 'filename_length' => 2, + 'extra_field_length' => 2 + ) + ); + + $local_file_header['extract_version'] = sprintf('%1.1f', $local_file_header['raw']['extract_version'] / 10); + $local_file_header['host_os'] = $this->ZIPversionOSLookup(($local_file_header['raw']['extract_version'] & 0xFF00) >> 8); + $local_file_header['compression_method'] = $this->ZIPcompressionMethodLookup($local_file_header['raw']['compression_method']); + $local_file_header['compressed_size'] = $local_file_header['raw']['compressed_size']; + $local_file_header['uncompressed_size'] = $local_file_header['raw']['uncompressed_size']; + $local_file_header['flags'] = $this->ZIPparseGeneralPurposeFlags($local_file_header['raw']['general_flags'], $local_file_header['raw']['compression_method']); + $local_file_header['last_modified_timestamp'] = $this->DOStime2UNIXtime($local_file_header['raw']['last_mod_file_date'], $local_file_header['raw']['last_mod_file_time']); + + $filename_extra_field_length = $local_file_header['raw']['filename_length'] + $local_file_header['raw']['extra_field_length']; + if ($filename_extra_field_length > 0) { + $zip_local_file_header .= fread($getid3->fp, $filename_extra_field_length); + + if ($local_file_header['raw']['filename_length'] > 0) { + $local_file_header['filename'] = substr($zip_local_file_header, 30, $local_file_header['raw']['filename_length']); + } + if ($local_file_header['raw']['extra_field_length'] > 0) { + $local_file_header['raw']['extra_field_data'] = substr($zip_local_file_header, 30 + $local_file_header['raw']['filename_length'], $local_file_header['raw']['extra_field_length']); + } + } + + $local_file_header['data_offset'] = ftell($getid3->fp); + fseek($getid3->fp, $local_file_header['raw']['compressed_size'], SEEK_CUR); + + if ($local_file_header['flags']['data_descriptor_used']) { + $data_descriptor = fread($getid3->fp, 12); + + getid3_lib::ReadSequence('LittleEndian2Int', $local_file_header['data_descriptor'], $data_descriptor, 0, + array ( + 'crc_32' => 4, + 'compressed_size' => 4, + 'uncompressed_size' => 4 + ) + ); + } + + return $local_file_header; + } + + + + private function ZIPparseCentralDirectory() { + + // shortcut + $getid3 = $this->getid3; + + $central_directory['offset'] = ftell($getid3->fp); + + $zip_central_directory = fread($getid3->fp, 46); + + $central_directory['raw']['signature'] = getid3_lib::LittleEndian2Int(substr($zip_central_directory, 0, 4)); + + // invalid Central Directory Signature + if ($central_directory['raw']['signature'] != 0x02014B50) { + fseek($getid3->fp, $central_directory['offset'], SEEK_SET); // seek back to where filepointer originally was so it can be handled properly + return false; + } + + getid3_lib::ReadSequence('LittleEndian2Int', $central_directory['raw'], $zip_central_directory, 4, + array ( + 'create_version' => 2, + 'extract_version' => 2, + 'general_flags' => 2, + 'compression_method' => 2, + 'last_mod_file_time' => 2, + 'last_mod_file_date' => 2, + 'crc_32' => 4, + 'compressed_size' => 4, + 'uncompressed_size' => 4, + 'filename_length' => 2, + 'extra_field_length' => 2, + 'file_comment_length' => 2, + 'disk_number_start' => 2, + 'internal_file_attrib' => 2, + 'external_file_attrib' => 4, + 'local_header_offset' => 4 + ) + ); + + $central_directory['entry_offset'] = $central_directory['raw']['local_header_offset']; + $central_directory['create_version'] = sprintf('%1.1f', $central_directory['raw']['create_version'] / 10); + $central_directory['extract_version'] = sprintf('%1.1f', $central_directory['raw']['extract_version'] / 10); + $central_directory['host_os'] = $this->ZIPversionOSLookup(($central_directory['raw']['extract_version'] & 0xFF00) >> 8); + $central_directory['compression_method'] = $this->ZIPcompressionMethodLookup($central_directory['raw']['compression_method']); + $central_directory['compressed_size'] = $central_directory['raw']['compressed_size']; + $central_directory['uncompressed_size'] = $central_directory['raw']['uncompressed_size']; + $central_directory['flags'] = $this->ZIPparseGeneralPurposeFlags($central_directory['raw']['general_flags'], $central_directory['raw']['compression_method']); + $central_directory['last_modified_timestamp'] = $this->DOStime2UNIXtime($central_directory['raw']['last_mod_file_date'], $central_directory['raw']['last_mod_file_time']); + + $filename_extra_field_comment_length = $central_directory['raw']['filename_length'] + $central_directory['raw']['extra_field_length'] + $central_directory['raw']['file_comment_length']; + if ($filename_extra_field_comment_length > 0) { + $filename_extra_field_comment = fread($getid3->fp, $filename_extra_field_comment_length); + + if ($central_directory['raw']['filename_length'] > 0) { + $central_directory['filename']= substr($filename_extra_field_comment, 0, $central_directory['raw']['filename_length']); + } + if ($central_directory['raw']['extra_field_length'] > 0) { + $central_directory['raw']['extra_field_data'] = substr($filename_extra_field_comment, $central_directory['raw']['filename_length'], $central_directory['raw']['extra_field_length']); + } + if ($central_directory['raw']['file_comment_length'] > 0) { + $central_directory['file_comment'] = substr($filename_extra_field_comment, $central_directory['raw']['filename_length'] + $central_directory['raw']['extra_field_length'], $central_directory['raw']['file_comment_length']); + } + } + + return $central_directory; + } + + + + private function ZIPparseEndOfCentralDirectory() { + + // shortcut + $getid3 = $this->getid3; + + $end_of_central_directory['offset'] = ftell($getid3->fp); + + $zip_end_of_central_directory = fread($getid3->fp, 22); + + $end_of_central_directory['signature'] = getid3_lib::LittleEndian2Int(substr($zip_end_of_central_directory, 0, 4)); + + // invalid End Of Central Directory Signature + if ($end_of_central_directory['signature'] != 0x06054B50) { + fseek($getid3->fp, $end_of_central_directory['offset'], SEEK_SET); // seek back to where filepointer originally was so it can be handled properly + return false; + } + + getid3_lib::ReadSequence('LittleEndian2Int', $end_of_central_directory, $zip_end_of_central_directory, 4, + array ( + 'disk_number_current' => 2, + 'disk_number_start_directory' => 2, + 'directory_entries_this_disk' => 2, + 'directory_entries_total' => 2, + 'directory_size' => 4, + 'directory_offset' => 4, + 'comment_length' => 2 + ) + ); + + if ($end_of_central_directory['comment_length'] > 0) { + $end_of_central_directory['comment'] = fread($getid3->fp, $end_of_central_directory['comment_length']); + } + + return $end_of_central_directory; + } + + + + public static function ZIPparseGeneralPurposeFlags($flag_bytes, $compression_method) { + + $parsed_flags['encrypted'] = (bool)($flag_bytes & 0x0001); + + switch ($compression_method) { + case 6: + $parsed_flags['dictionary_size'] = (($flag_bytes & 0x0002) ? 8192 : 4096); + $parsed_flags['shannon_fano_trees'] = (($flag_bytes & 0x0004) ? 3 : 2); + break; + + case 8: + case 9: + switch (($flag_bytes & 0x0006) >> 1) { + case 0: + $parsed_flags['compression_speed'] = 'normal'; + break; + case 1: + $parsed_flags['compression_speed'] = 'maximum'; + break; + case 2: + $parsed_flags['compression_speed'] = 'fast'; + break; + case 3: + $parsed_flags['compression_speed'] = 'superfast'; + break; + } + break; + } + $parsed_flags['data_descriptor_used'] = (bool)($flag_bytes & 0x0008); + + return $parsed_flags; + } + + + + public static function ZIPversionOSLookup($index) { + + static $lookup = array ( + 0 => 'MS-DOS and OS/2 (FAT / VFAT / FAT32 file systems)', + 1 => 'Amiga', + 2 => 'OpenVMS', + 3 => 'Unix', + 4 => 'VM/CMS', + 5 => 'Atari ST', + 6 => 'OS/2 H.P.F.S.', + 7 => 'Macintosh', + 8 => 'Z-System', + 9 => 'CP/M', + 10 => 'Windows NTFS', + 11 => 'MVS', + 12 => 'VSE', + 13 => 'Acorn Risc', + 14 => 'VFAT', + 15 => 'Alternate MVS', + 16 => 'BeOS', + 17 => 'Tandem' + ); + return (isset($lookup[$index]) ? $lookup[$index] : '[unknown]'); + } + + + + public static function ZIPcompressionMethodLookup($index) { + + static $lookup = array ( + 0 => 'store', + 1 => 'shrink', + 2 => 'reduce-1', + 3 => 'reduce-2', + 4 => 'reduce-3', + 5 => 'reduce-4', + 6 => 'implode', + 7 => 'tokenize', + 8 => 'deflate', + 9 => 'deflate64', + 10 => 'PKWARE Date Compression Library Imploding' + ); + return (isset($lookup[$index]) ? $lookup[$index] : '[unknown]'); + } + + + + public static function DOStime2UNIXtime($DOSdate, $DOStime) { + + /* + // wFatDate + // Specifies the MS-DOS date. The date is a packed 16-bit value with the following format: + // Bits Contents + // 0-4 Day of the month (1-31) + // 5-8 Month (1 = January, 2 = February, and so on) + // 9-15 Year offset from 1980 (add 1980 to get actual year) + + $UNIXday = ($DOSdate & 0x001F); + $UNIXmonth = (($DOSdate & 0x01E0) >> 5); + $UNIXyear = (($DOSdate & 0xFE00) >> 9) + 1980; + + // wFatTime + // Specifies the MS-DOS time. The time is a packed 16-bit value with the following format: + // Bits Contents + // 0-4 Second divided by 2 + // 5-10 Minute (0-59) + // 11-15 Hour (0-23 on a 24-hour clock) + + $UNIXsecond = ($DOStime & 0x001F) * 2; + $UNIXminute = (($DOStime & 0x07E0) >> 5); + $UNIXhour = (($DOStime & 0xF800) >> 11); + + return gmmktime($UNIXhour, $UNIXminute, $UNIXsecond, $UNIXmonth, $UNIXday, $UNIXyear); + */ + return gmmktime(($DOStime & 0xF800) >> 11, ($DOStime & 0x07E0) >> 5, ($DOStime & 0x001F) * 2, ($DOSdate & 0x01E0) >> 5, $DOSdate & 0x001F, (($DOSdate & 0xFE00) >> 9) + 1980); + } + + + + public static function array_merge_clobber($array1, $array2) { + + // written by kcØhireability*com + // taken from http://www.php.net/manual/en/function.array-merge-recursive.php + + if (!is_array($array1) || !is_array($array2)) { + return false; + } + + $newarray = $array1; + foreach ($array2 as $key => $val) { + if (is_array($val) && isset($newarray[$key]) && is_array($newarray[$key])) { + $newarray[$key] = getid3_zip::array_merge_clobber($newarray[$key], $val); + } else { + $newarray[$key] = $val; + } + } + return $newarray; + } + + + + public static function CreateDeepArray($array_path, $separator, $value) { + + // assigns $value to a nested array path: + // $foo = getid3_lib::CreateDeepArray('/path/to/my', '/', 'file.txt') + // is the same as: + // $foo = array ('path'=>array('to'=>'array('my'=>array('file.txt')))); + // or + // $foo['path']['to']['my'] = 'file.txt'; + + while ($array_path{0} == $separator) { + $array_path = substr($array_path, 1); + } + if (($pos = strpos($array_path, $separator)) !== false) { + return array (substr($array_path, 0, $pos) => getid3_zip::CreateDeepArray(substr($array_path, $pos + 1), $separator, $value)); + } + + return array ($array_path => $value); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.asf.php b/modules/getid3/module.audio-video.asf.php new file mode 100644 index 00000000..56b5b0c9 --- /dev/null +++ b/modules/getid3/module.audio-video.asf.php @@ -0,0 +1,1846 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio-video.php | +// | Module for analyzing Microsoft ASF, WMA and WMV files. | +// | dependencies: module.audio-video.riff.php | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.asf.php,v 1.7 2006/12/01 22:39:48 ah Exp $ + + + +class getid3_asf extends getid3_handler +{ + + const Extended_Stream_Properties_Object = '14E6A5CB-C672-4332-8399-A96952065B5A'; + const Padding_Object = '1806D474-CADF-4509-A4BA-9AABCB96AAE8'; + const Payload_Ext_Syst_Pixel_Aspect_Ratio = '1B1EE554-F9EA-4BC8-821A-376B74E4C4B8'; + const Script_Command_Object = '1EFB1A30-0B62-11D0-A39B-00A0C90348F6'; + const No_Error_Correction = '20FB5700-5B55-11CF-A8FD-00805F5C442B'; + const Content_Branding_Object = '2211B3FA-BD23-11D2-B4B7-00A0C955FC6E'; + const Content_Encryption_Object = '2211B3FB-BD23-11D2-B4B7-00A0C955FC6E'; + const Digital_Signature_Object = '2211B3FC-BD23-11D2-B4B7-00A0C955FC6E'; + const Extended_Content_Encryption_Object = '298AE614-2622-4C17-B935-DAE07EE9289C'; + const Simple_Index_Object = '33000890-E5B1-11CF-89F4-00A0C90349CB'; + const Degradable_JPEG_Media = '35907DE0-E415-11CF-A917-00805F5C442B'; + const Payload_Extension_System_Timecode = '399595EC-8667-4E2D-8FDB-98814CE76C1E'; + const Binary_Media = '3AFB65E2-47EF-40F2-AC2C-70A90D71D343'; + const Timecode_Index_Object = '3CB73FD0-0C4A-4803-953D-EDF7B6228F0C'; + const Metadata_Library_Object = '44231C94-9498-49D1-A141-1D134E457054'; + const Reserved_3 = '4B1ACBE3-100B-11D0-A39B-00A0C90348F6'; + const Reserved_4 = '4CFEDB20-75F6-11CF-9C0F-00A0C90349CB'; + const Command_Media = '59DACFC0-59E6-11D0-A3AC-00A0C90348F6'; + const Header_Extension_Object = '5FBF03B5-A92E-11CF-8EE3-00C00C205365'; + const Media_Object_Index_Parameters_Obj = '6B203BAD-3F11-4E84-ACA8-D7613DE2CFA7'; + const Header_Object = '75B22630-668E-11CF-A6D9-00AA0062CE6C'; + const Content_Description_Object = '75B22633-668E-11CF-A6D9-00AA0062CE6C'; + const Error_Correction_Object = '75B22635-668E-11CF-A6D9-00AA0062CE6C'; + const Data_Object = '75B22636-668E-11CF-A6D9-00AA0062CE6C'; + const Web_Stream_Media_Subtype = '776257D4-C627-41CB-8F81-7AC7FF1C40CC'; + const Stream_Bitrate_Properties_Object = '7BF875CE-468D-11D1-8D82-006097C9A2B2'; + const Language_List_Object = '7C4346A9-EFE0-4BFC-B229-393EDE415C85'; + const Codec_List_Object = '86D15240-311D-11D0-A3A4-00A0C90348F6'; + const Reserved_2 = '86D15241-311D-11D0-A3A4-00A0C90348F6'; + const File_Properties_Object = '8CABDCA1-A947-11CF-8EE4-00C00C205365'; + const File_Transfer_Media = '91BD222C-F21C-497A-8B6D-5AA86BFC0185'; + const Old_RTP_Extension_Data = '96800C63-4C94-11D1-837B-0080C7A37F95'; + const Advanced_Mutual_Exclusion_Object = 'A08649CF-4775-4670-8A16-6E35357566CD'; + const Bandwidth_Sharing_Object = 'A69609E6-517B-11D2-B6AF-00C04FD908E9'; + const Reserved_1 = 'ABD3D211-A9BA-11CF-8EE6-00C00C205365'; + const Bandwidth_Sharing_Exclusive = 'AF6060AA-5197-11D2-B6AF-00C04FD908E9'; + const Bandwidth_Sharing_Partial = 'AF6060AB-5197-11D2-B6AF-00C04FD908E9'; + const JFIF_Media = 'B61BE100-5B4E-11CF-A8FD-00805F5C442B'; + const Stream_Properties_Object = 'B7DC0791-A9B7-11CF-8EE6-00C00C205365'; + const Video_Media = 'BC19EFC0-5B4D-11CF-A8FD-00805F5C442B'; + const Audio_Spread = 'BFC3CD50-618F-11CF-8BB2-00AA00B4E220'; + const Metadata_Object = 'C5F8CBEA-5BAF-4877-8467-AA8C44FA4CCA'; + const Payload_Ext_Syst_Sample_Duration = 'C6BD9450-867F-4907-83A3-C77921B733AD'; + const Group_Mutual_Exclusion_Object = 'D1465A40-5A79-4338-B71B-E36B8FD6C249'; + const Extended_Content_Description_Object = 'D2D0A440-E307-11D2-97F0-00A0C95EA850'; + const Stream_Prioritization_Object = 'D4FED15B-88D3-454F-81F0-ED5C45999E24'; + const Payload_Ext_System_Content_Type = 'D590DC20-07BC-436C-9CF7-F3BBFBF1A4DC'; + const Old_File_Properties_Object = 'D6E229D0-35DA-11D1-9034-00A0C90349BE'; + const Old_ASF_Header_Object = 'D6E229D1-35DA-11D1-9034-00A0C90349BE'; + const Old_ASF_Data_Object = 'D6E229D2-35DA-11D1-9034-00A0C90349BE'; + const Index_Object = 'D6E229D3-35DA-11D1-9034-00A0C90349BE'; + const Old_Stream_Properties_Object = 'D6E229D4-35DA-11D1-9034-00A0C90349BE'; + const Old_Content_Description_Object = 'D6E229D5-35DA-11D1-9034-00A0C90349BE'; + const Old_Script_Command_Object = 'D6E229D6-35DA-11D1-9034-00A0C90349BE'; + const Old_Marker_Object = 'D6E229D7-35DA-11D1-9034-00A0C90349BE'; + const Old_Component_Download_Object = 'D6E229D8-35DA-11D1-9034-00A0C90349BE'; + const Old_Stream_Group_Object = 'D6E229D9-35DA-11D1-9034-00A0C90349BE'; + const Old_Scalable_Object = 'D6E229DA-35DA-11D1-9034-00A0C90349BE'; + const Old_Prioritization_Object = 'D6E229DB-35DA-11D1-9034-00A0C90349BE'; + const Bitrate_Mutual_Exclusion_Object = 'D6E229DC-35DA-11D1-9034-00A0C90349BE'; + const Old_Inter_Media_Dependency_Object = 'D6E229DD-35DA-11D1-9034-00A0C90349BE'; + const Old_Rating_Object = 'D6E229DE-35DA-11D1-9034-00A0C90349BE'; + const Index_Parameters_Object = 'D6E229DF-35DA-11D1-9034-00A0C90349BE'; + const Old_Color_Table_Object = 'D6E229E0-35DA-11D1-9034-00A0C90349BE'; + const Old_Language_List_Object = 'D6E229E1-35DA-11D1-9034-00A0C90349BE'; + const Old_Audio_Media = 'D6E229E2-35DA-11D1-9034-00A0C90349BE'; + const Old_Video_Media = 'D6E229E3-35DA-11D1-9034-00A0C90349BE'; + const Old_Image_Media = 'D6E229E4-35DA-11D1-9034-00A0C90349BE'; + const Old_Timecode_Media = 'D6E229E5-35DA-11D1-9034-00A0C90349BE'; + const Old_Text_Media = 'D6E229E6-35DA-11D1-9034-00A0C90349BE'; + const Old_MIDI_Media = 'D6E229E7-35DA-11D1-9034-00A0C90349BE'; + const Old_Command_Media = 'D6E229E8-35DA-11D1-9034-00A0C90349BE'; + const Old_No_Error_Concealment = 'D6E229EA-35DA-11D1-9034-00A0C90349BE'; + const Old_Scrambled_Audio = 'D6E229EB-35DA-11D1-9034-00A0C90349BE'; + const Old_No_Color_Table = 'D6E229EC-35DA-11D1-9034-00A0C90349BE'; + const Old_SMPTE_Time = 'D6E229ED-35DA-11D1-9034-00A0C90349BE'; + const Old_ASCII_Text = 'D6E229EE-35DA-11D1-9034-00A0C90349BE'; + const Old_Unicode_Text = 'D6E229EF-35DA-11D1-9034-00A0C90349BE'; + const Old_HTML_Text = 'D6E229F0-35DA-11D1-9034-00A0C90349BE'; + const Old_URL_Command = 'D6E229F1-35DA-11D1-9034-00A0C90349BE'; + const Old_Filename_Command = 'D6E229F2-35DA-11D1-9034-00A0C90349BE'; + const Old_ACM_Codec = 'D6E229F3-35DA-11D1-9034-00A0C90349BE'; + const Old_VCM_Codec = 'D6E229F4-35DA-11D1-9034-00A0C90349BE'; + const Old_QuickTime_Codec = 'D6E229F5-35DA-11D1-9034-00A0C90349BE'; + const Old_DirectShow_Transform_Filter = 'D6E229F6-35DA-11D1-9034-00A0C90349BE'; + const Old_DirectShow_Rendering_Filter = 'D6E229F7-35DA-11D1-9034-00A0C90349BE'; + const Old_No_Enhancement = 'D6E229F8-35DA-11D1-9034-00A0C90349BE'; + const Old_Unknown_Enhancement_Type = 'D6E229F9-35DA-11D1-9034-00A0C90349BE'; + const Old_Temporal_Enhancement = 'D6E229FA-35DA-11D1-9034-00A0C90349BE'; + const Old_Spatial_Enhancement = 'D6E229FB-35DA-11D1-9034-00A0C90349BE'; + const Old_Quality_Enhancement = 'D6E229FC-35DA-11D1-9034-00A0C90349BE'; + const Old_Number_of_Channels_Enhancement = 'D6E229FD-35DA-11D1-9034-00A0C90349BE'; + const Old_Frequency_Response_Enhancement = 'D6E229FE-35DA-11D1-9034-00A0C90349BE'; + const Old_Media_Object = 'D6E229FF-35DA-11D1-9034-00A0C90349BE'; + const Mutex_Language = 'D6E22A00-35DA-11D1-9034-00A0C90349BE'; + const Mutex_Bitrate = 'D6E22A01-35DA-11D1-9034-00A0C90349BE'; + const Mutex_Unknown = 'D6E22A02-35DA-11D1-9034-00A0C90349BE'; + const Old_ASF_Placeholder_Object = 'D6E22A0E-35DA-11D1-9034-00A0C90349BE'; + const Old_Data_Unit_Extension_Object = 'D6E22A0F-35DA-11D1-9034-00A0C90349BE'; + const Web_Stream_Format = 'DA1E6B13-8359-4050-B398-388E965BF00C'; + const Payload_Ext_System_File_Name = 'E165EC0E-19ED-45D7-B4A7-25CBD1E28E9B'; + const Marker_Object = 'F487CD01-A951-11CF-8EE6-00C00C205365'; + const Timecode_Index_Parameters_Object = 'F55E496D-9797-4B5D-8C8B-604DFE9BFB24'; + const Audio_Media = 'F8699E40-5B4D-11CF-A8FD-00805F5C442B'; + const Media_Object_Index_Object = 'FEB103F8-12AD-4C64-840F-2A1D2F7AD48C'; + const Alt_Extended_Content_Encryption_Obj = 'FF889EF1-ADEE-40DA-9E71-98704BB928CE'; + + + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->include_module('audio-video.riff'); + + !isset($getid3->info['audio']) and $getid3->info['audio'] = array (); + !isset($getid3->info['video']) and $getid3->info['video'] = array (); + $getid3->info['asf']['comments'] = $getid3->info['asf']['header_object'] = array (); + + $info_audio = &$getid3->info['audio']; + $info_video = &$getid3->info['video']; + $info_asf = &$getid3->info['asf']; + $info_asf_comments = &$info_asf['comments']; + $info_asf_header_object = &$info_asf['header_object']; + + // ASF structure: + // * Header Object [required] + // * File Properties Object [required] (global file attributes) + // * Stream Properties Object [required] (defines media stream & characteristics) + // * Header Extension Object [required] (additional functionality) + // * Content Description Object (bibliographic information) + // * Script Command Object (commands for during playback) + // * Marker Object (named jumped points within the file) + // * Data Object [required] + // * Data Packets + // * Index Object + + // Header Object: (mandatory, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for header object - getid3_asf::Header_Object + // Object Size QWORD 64 // size of header object, including 30 bytes of Header Object header + // Number of Header Objects DWORD 32 // number of objects in header object + // Reserved1 BYTE 8 // hardcoded: 0x01 + // Reserved2 BYTE 8 // hardcoded: 0x02 + + $getid3->info['fileformat'] = 'asf'; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $header_object_data = fread($getid3->fp, 30); + + $info_asf_header_object['objectid_guid'] = getid3_asf::BytestringToGUID(substr($header_object_data, 0, 16)); + + if ($info_asf_header_object['objectid_guid'] != getid3_asf::Header_Object) { + throw new getid3_exception('ASF header GUID {'.$info_asf_header_object['objectid_guid'].'} does not match expected "getid3_asf::Header_Object" GUID {'.getid3_asf::Header_Object.'}'); + } + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_header_object, $header_object_data, 16, + array ( + 'objectsize' => 8, + 'headerobjects' => 4, + 'reserved1' => 1, + 'reserved2' => 1 + ) + ); + + $asf_header_data = fread($getid3->fp, $info_asf_header_object['objectsize'] - 30); + $offset = 0; + + for ($header_objects_counter = 0; $header_objects_counter < $info_asf_header_object['headerobjects']; $header_objects_counter++) { + + $next_object_guid = substr($asf_header_data, $offset, 16); + $offset += 16; + + $next_object_size = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 8)); + $offset += 8; + + $next_object_guidtext = getid3_asf::BytestringToGUID($next_object_guid); + + switch ($next_object_guidtext) { + + case getid3_asf::File_Properties_Object: + + // File Properties Object: (mandatory, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for file properties object - getid3_asf::File_Properties_Object + // Object Size QWORD 64 // size of file properties object, including 104 bytes of File Properties Object header + // File ID GUID 128 // unique ID - identical to File ID in Data Object + // File Size QWORD 64 // entire file in bytes. Invalid if Broadcast Flag == 1 + // Creation Date QWORD 64 // date & time of file creation. Maybe invalid if Broadcast Flag == 1 + // Data Packets Count QWORD 64 // number of data packets in Data Object. Invalid if Broadcast Flag == 1 + // Play Duration QWORD 64 // playtime, in 100-nanosecond units. Invalid if Broadcast Flag == 1 + // Send Duration QWORD 64 // time needed to send file, in 100-nanosecond units. Players can ignore this value. Invalid if Broadcast Flag == 1 + // Preroll QWORD 64 // time to buffer data before starting to play file, in 1-millisecond units. If <> 0, PlayDuration and PresentationTime have been offset by this amount + // Flags DWORD 32 // + // * Broadcast Flag bits 1 (0x01) // file is currently being written, some header values are invalid + // * Seekable Flag bits 1 (0x02) // is file seekable + // * Reserved bits 30 (0xFFFFFFFC) // reserved - set to zero + // Minimum Data Packet Size DWORD 32 // in bytes. should be same as Maximum Data Packet Size. Invalid if Broadcast Flag == 1 + // Maximum Data Packet Size DWORD 32 // in bytes. should be same as Minimum Data Packet Size. Invalid if Broadcast Flag == 1 + // Maximum Bitrate DWORD 32 // maximum instantaneous bitrate in bits per second for entire file, including all data streams and ASF overhead + + $info_asf['file_properties_object'] = array (); + $info_asf_file_properties_object = &$info_asf['file_properties_object']; + + $info_asf_file_properties_object['objectid_guid'] = $next_object_guidtext; + $info_asf_file_properties_object['objectsize'] = $next_object_size; + + $info_asf_file_properties_object['fileid_guid'] = getid3_asf::BytestringToGUID(substr($asf_header_data, $offset, 16)); + $offset += 16; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_file_properties_object, $asf_header_data, $offset, + array ( + 'filesize' => 8, + 'creation_date' => 8, + 'data_packets' => 8, + 'play_duration' => 8, + 'send_duration' => 8, + 'preroll' => 8, + 'flags_raw' => 4, + 'min_packet_size' => 4, + 'max_packet_size' => 4, + 'max_bitrate' => 4 + ) + ); + + $offset += 64 ; + + $info_asf_file_properties_object['creation_date_unix'] = getid3_asf::FiletimeToUNIXtime($info_asf_file_properties_object['creation_date']); + $info_asf_file_properties_object['flags']['broadcast'] = (bool)($info_asf_file_properties_object['flags_raw'] & 0x0001); + $info_asf_file_properties_object['flags']['seekable'] = (bool)($info_asf_file_properties_object['flags_raw'] & 0x0002); + + $getid3->info['playtime_seconds'] = ($info_asf_file_properties_object['play_duration'] / 10000000) - ($info_asf_file_properties_object['preroll'] / 1000); + $getid3->info['bitrate'] = ($info_asf_file_properties_object['filesize'] * 8) / $getid3->info['playtime_seconds']; + break; + + + case getid3_asf::Stream_Properties_Object: + + // Stream Properties Object: (mandatory, one per media stream) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for stream properties object - getid3_asf::Stream_Properties_Object + // Object Size QWORD 64 // size of stream properties object, including 78 bytes of Stream Properties Object header + // Stream Type GUID 128 // getid3_asf::Audio_Media, getid3_asf::Video_Media or getid3_asf::Command_Media + // Error Correction Type GUID 128 // getid3_asf::Audio_Spread for audio-only streams, getid3_asf::No_Error_Correction for other stream types + // Time Offset QWORD 64 // 100-nanosecond units. typically zero. added to all timestamps of samples in the stream + // Type-Specific Data Length DWORD 32 // number of bytes for Type-Specific Data field + // Error Correction Data Length DWORD 32 // number of bytes for Error Correction Data field + // Flags WORD 16 // + // * Stream Number bits 7 (0x007F) // number of this stream. 1 <= valid <= 127 + // * Reserved bits 8 (0x7F80) // reserved - set to zero + // * Encrypted Content Flag bits 1 (0x8000) // stream contents encrypted if set + // Reserved DWORD 32 // reserved - set to zero + // Type-Specific Data BYTESTREAM variable // type-specific format data, depending on value of Stream Type + // Error Correction Data BYTESTREAM variable // error-correction-specific format data, depending on value of Error Correct Type + + // There is one getid3_asf::Stream_Properties_Object for each stream (audio, video) but the + // stream number isn't known until halfway through decoding the structure, hence it + // it is decoded to a temporary variable and then stuck in the appropriate index later + + $stream_properties_object_data['objectid_guid'] = $next_object_guidtext; + $stream_properties_object_data['objectsize'] = $next_object_size; + + getid3_lib::ReadSequence('LittleEndian2Int', $stream_properties_object_data, $asf_header_data, $offset, + array ( + 'stream_type' => -16, + 'error_correct_type' => -16, + 'time_offset' => 8, + 'type_data_length' => 4, + 'error_data_length' => 4, + 'flags_raw' => 2 + ) + ); + + $stream_properties_stream_number = $stream_properties_object_data['flags_raw'] & 0x007F; + $stream_properties_object_data['flags']['encrypted'] = (bool)($stream_properties_object_data['flags_raw'] & 0x8000); + + $stream_properties_object_data['stream_type_guid'] = getid3_asf::BytestringToGUID($stream_properties_object_data['stream_type']); + $stream_properties_object_data['error_correct_guid'] = getid3_asf::BytestringToGUID($stream_properties_object_data['error_correct_type']); + + $offset += 54; // 50 bytes + 4 bytes reserved - DWORD + + $stream_properties_object_data['type_specific_data'] = substr($asf_header_data, $offset, $stream_properties_object_data['type_data_length']); + $offset += $stream_properties_object_data['type_data_length']; + + $stream_properties_object_data['error_correct_data'] = substr($asf_header_data, $offset, $stream_properties_object_data['error_data_length']); + $offset += $stream_properties_object_data['error_data_length']; + + switch ($stream_properties_object_data['stream_type_guid']) { + + case getid3_asf::Audio_Media: + + $info_audio['dataformat'] = (@$info_audio['dataformat'] ? $info_audio['dataformat'] : 'asf'); + $info_audio['bitrate_mode'] = (@$info_audio['bitrate_mode'] ? $info_audio['bitrate_mode'] : 'cbr'); + + $audiodata = getid3_riff::RIFFparseWAVEFORMATex(substr($stream_properties_object_data['type_specific_data'], 0, 16)); + unset($audiodata['raw']); + $info_audio = getid3_riff::array_merge_noclobber($audiodata, $info_audio); + break; + + + case getid3_asf::Video_Media: + + $info_video['dataformat'] = (@$info_video['dataformat'] ? $info_video['dataformat'] : 'asf'); + $info_video['bitrate_mode'] = (@$info_video['bitrate_mode'] ? $info_video['bitrate_mode'] : 'cbr'); + break; + + + /* does nothing but eat memory + case getid3_asf::Command_Media: + default: + // do nothing + break; + */ + } + + $info_asf['stream_properties_object'][$stream_properties_stream_number] = $stream_properties_object_data; + unset($stream_properties_object_data); // clear for next stream, if any + break; + + + case getid3_asf::Header_Extension_Object: + + // Header Extension Object: (mandatory, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Header Extension object - getid3_asf::Header_Extension_Object + // Object Size QWORD 64 // size of Header Extension object, including 46 bytes of Header Extension Object header + // Reserved Field 1 GUID 128 // hardcoded: getid3_asf::Reserved_1 + // Reserved Field 2 WORD 16 // hardcoded: 0x00000006 + // Header Extension Data Size DWORD 32 // in bytes. valid: 0, or > 24. equals object size minus 46 + // Header Extension Data BYTESTREAM variable // array of zero or more extended header objects + + $info_asf['header_extension_object'] = array (); + $info_asf_header_extension_object = &$info_asf['header_extension_object']; + + $info_asf_header_extension_object['objectid_guid'] = $next_object_guidtext; + $info_asf_header_extension_object['objectsize'] = $next_object_size; + $info_asf_header_extension_object['reserved_1_guid'] = getid3_asf::BytestringToGUID(substr($asf_header_data, $offset, 16)); + $offset += 16; + + if ($info_asf_header_extension_object['reserved_1_guid'] != getid3_asf::Reserved_1) { + $getid3->warning('header_extension_object.reserved_1 GUID ('.$info_asf_header_extension_object['reserved_1_guid'].') does not match expected "getid3_asf::Reserved_1" GUID ('.getid3_asf::Reserved_1.')'); + break; + } + + $info_asf_header_extension_object['reserved_2'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + if ($info_asf_header_extension_object['reserved_2'] != 6) { + $getid3->warning('header_extension_object.reserved_2 ('.getid3_lib::PrintHexBytes($info_asf_header_extension_object['reserved_2']).') does not match expected value of "6"'); + break; + } + + $info_asf_header_extension_object['extension_data_size'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 4)); + $offset += 4; + + $info_asf_header_extension_object['extension_data'] = substr($asf_header_data, $offset, $info_asf_header_extension_object['extension_data_size']); + $offset += $info_asf_header_extension_object['extension_data_size']; + break; + + + case getid3_asf::Codec_List_Object: + + // Codec List Object: (optional, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Codec List object - getid3_asf::Codec_List_Object + // Object Size QWORD 64 // size of Codec List object, including 44 bytes of Codec List Object header + // Reserved GUID 128 // hardcoded: 86D15241-311D-11D0-A3A4-00A0C90348F6 + // Codec Entries Count DWORD 32 // number of entries in Codec Entries array + // Codec Entries array of: variable // + // * Type WORD 16 // 0x0001 = Video Codec, 0x0002 = Audio Codec, 0xFFFF = Unknown Codec + // * Codec Name Length WORD 16 // number of Unicode characters stored in the Codec Name field + // * Codec Name WCHAR variable // array of Unicode characters - name of codec used to create the content + // * Codec Description Length WORD 16 // number of Unicode characters stored in the Codec Description field + // * Codec Description WCHAR variable // array of Unicode characters - description of format used to create the content + // * Codec Information Length WORD 16 // number of Unicode characters stored in the Codec Information field + // * Codec Information BYTESTREAM variable // opaque array of information bytes about the codec used to create the content + + $info_asf['codec_list_object'] = array (); + $info_asf_codec_list_object = &$info_asf['codec_list_object']; + + $info_asf_codec_list_object['objectid_guid'] = $next_object_guidtext; + $info_asf_codec_list_object['objectsize'] = $next_object_size; + + $info_asf_codec_list_object['reserved_guid'] = getid3_asf::BytestringToGUID(substr($asf_header_data, $offset, 16)); + $offset += 16; + + if ($info_asf_codec_list_object['reserved_guid'] != '86D15241-311D-11D0-A3A4-00A0C90348F6') { + $getid3->warning('codec_list_object.reserved GUID {'.$info_asf_codec_list_object['reserved_guid'].'} does not match expected "getid3_asf::Reserved_1" GUID {86D15241-311D-11D0-A3A4-00A0C90348F6}'); + break; + } + + $info_asf_codec_list_object['codec_entries_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 4)); + $offset += 4; + + for ($codec_entry_counter = 0; $codec_entry_counter < $info_asf_codec_list_object['codec_entries_count']; $codec_entry_counter++) { + + $info_asf_codec_list_object['codec_entries'][$codec_entry_counter] = array (); + $info_asf_codec_list_object_codecentries_current = &$info_asf_codec_list_object['codec_entries'][$codec_entry_counter]; + + $info_asf_codec_list_object_codecentries_current['type_raw'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_codec_list_object_codecentries_current['type'] = getid3_asf::ASFCodecListObjectTypeLookup($info_asf_codec_list_object_codecentries_current['type_raw']); + + $codec_name_length = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)) * 2; // 2 bytes per character + $offset += 2; + + $info_asf_codec_list_object_codecentries_current['name'] = substr($asf_header_data, $offset, $codec_name_length); + $offset += $codec_name_length; + + $codec_description_length = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)) * 2; // 2 bytes per character + $offset += 2; + + $info_asf_codec_list_object_codecentries_current['description'] = substr($asf_header_data, $offset, $codec_description_length); + $offset += $codec_description_length; + + $codec_information_length = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_codec_list_object_codecentries_current['information'] = substr($asf_header_data, $offset, $codec_information_length); + $offset += $codec_information_length; + + if ($info_asf_codec_list_object_codecentries_current['type_raw'] == 2) { + + // audio codec + if (strpos($info_asf_codec_list_object_codecentries_current['description'], ',') === false) { + throw new getid3_exception('[asf][codec_list_object][codec_entries]['.$codec_entry_counter.'][description] expected to contain comma-seperated list of parameters: "'.$info_asf_codec_list_object_codecentries_current['description'].'"'); + } + list($audio_codec_bitrate, $audio_codec_frequency, $audio_codec_channels) = explode(',', $this->TrimConvert($info_asf_codec_list_object_codecentries_current['description'])); + $info_audio['codec'] = $this->TrimConvert($info_asf_codec_list_object_codecentries_current['name']); + + if (!isset($info_audio['bitrate']) && strstr($audio_codec_bitrate, 'kbps')) { + $info_audio['bitrate'] = (int)(trim(str_replace('kbps', '', $audio_codec_bitrate)) * 1000); + } + + if (!isset($info_video['bitrate']) && isset($info_audio['bitrate']) && isset($info_asf['file_properties_object']['max_bitrate']) && ($info_asf_codec_list_object['codec_entries_count'] > 1)) { + $info_video['bitrate'] = $info_asf['file_properties_object']['max_bitrate'] - $info_audio['bitrate']; + } + + if (!@$info_video['bitrate'] && @$info_audio['bitrate'] && @$getid3->info['bitrate']) { + $info_video['bitrate'] = $getid3->info['bitrate'] - $info_audio['bitrate']; + } + + $audio_codec_frequency = (int)trim(str_replace('kHz', '', $audio_codec_frequency)); + + static $sample_rate_lookup = array ( + 8 => 8000, 8000 => 8000, + 11 => 11025, 11025 => 11025, + 12 => 12000, 12000 => 12000, + 16 => 16000, 16000 => 16000, + 22 => 22050, 22050 => 22050, + 24 => 24000, 24000 => 24000, + 32 => 32000, 32000 => 32000, + 44 => 44100, 44100 => 44100, + 48 => 48000, 48000 => 48000, + ); + + $info_audio['sample_rate'] = @$sample_rate_lookup[$audio_codec_frequency]; + + if (!$info_audio['sample_rate']) { + $getid3->warning('unknown frequency: "'.$audio_codec_frequency.'" ('.$this->TrimConvert($info_asf_codec_list_object_codecentries_current['description']).')'); + break; + } + + if (!isset($info_audio['channels'])) { + if (strstr($audio_codec_channels, 'stereo')) { + $info_audio['channels'] = 2; + } elseif (strstr($audio_codec_channels, 'mono')) { + $info_audio['channels'] = 1; + } + } + } + } + break; + + + case getid3_asf::Script_Command_Object: + + // Script Command Object: (optional, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Script Command object - getid3_asf::Script_Command_Object + // Object Size QWORD 64 // size of Script Command object, including 44 bytes of Script Command Object header + // Reserved GUID 128 // hardcoded: 4B1ACBE3-100B-11D0-A39B-00A0C90348F6 + // Commands Count WORD 16 // number of Commands structures in the Script Commands Objects + // Command Types Count WORD 16 // number of Command Types structures in the Script Commands Objects + // Command Types array of: variable // + // * Command Type Name Length WORD 16 // number of Unicode characters for Command Type Name + // * Command Type Name WCHAR variable // array of Unicode characters - name of a type of command + // Commands array of: variable // + // * Presentation Time DWORD 32 // presentation time of that command, in milliseconds + // * Type Index WORD 16 // type of this command, as a zero-based index into the array of Command Types of this object + // * Command Name Length WORD 16 // number of Unicode characters for Command Name + // * Command Name WCHAR variable // array of Unicode characters - name of this command + + // shortcut + $info_asf['script_command_object'] = array (); + $info_asf_script_command_object = &$info_asf['script_command_object']; + + $info_asf_script_command_object['objectid_guid'] = $next_object_guidtext; + $info_asf_script_command_object['objectsize'] = $next_object_size; + $info_asf_script_command_object['reserved_guid'] = getid3_asf::BytestringToGUID(substr($asf_header_data, $offset, 16)); + $offset += 16; + + if ($info_asf_script_command_object['reserved_guid'] != '4B1ACBE3-100B-11D0-A39B-00A0C90348F6') { + $getid3->warning('script_command_object.reserved GUID {'.$info_asf_script_command_object['reserved_guid'].'} does not match expected GUID {4B1ACBE3-100B-11D0-A39B-00A0C90348F6}'); + break; + } + + $info_asf_script_command_object['commands_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_script_command_object['command_types_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + for ($command_types_counter = 0; $command_types_counter < $info_asf_script_command_object['command_types_count']; $command_types_counter++) { + + $command_type_name_length = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)) * 2; // 2 bytes per character + $offset += 2; + + $info_asf_script_command_object['command_types'][$command_types_counter]['name'] = substr($asf_header_data, $offset, $command_type_name_length); + $offset += $command_type_name_length; + } + + for ($commands_counter = 0; $commands_counter < $info_asf_script_command_object['commands_count']; $commands_counter++) { + + $info_asf_script_command_object['commands'][$commands_counter]['presentation_time'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 4)); + $offset += 4; + + $info_asf_script_command_object['commands'][$commands_counter]['type_index'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $command_type_name_length = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)) * 2; // 2 bytes per character + $offset += 2; + + $info_asf_script_command_object['commands'][$commands_counter]['name'] = substr($asf_header_data, $offset, $command_type_name_length); + $offset += $command_type_name_length; + } + break; + + + case getid3_asf::Marker_Object: + + // Marker Object: (optional, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Marker object - getid3_asf::Marker_Object + // Object Size QWORD 64 // size of Marker object, including 48 bytes of Marker Object header + // Reserved GUID 128 // hardcoded: 4CFEDB20-75F6-11CF-9C0F-00A0C90349CB + // Markers Count DWORD 32 // number of Marker structures in Marker Object + // Reserved WORD 16 // hardcoded: 0x0000 + // Name Length WORD 16 // number of bytes in the Name field + // Name WCHAR variable // name of the Marker Object + // Markers array of: variable // + // * Offset QWORD 64 // byte offset into Data Object + // * Presentation Time QWORD 64 // in 100-nanosecond units + // * Entry Length WORD 16 // length in bytes of (Send Time + Flags + Marker Description Length + Marker Description + Padding) + // * Send Time DWORD 32 // in milliseconds + // * Flags DWORD 32 // hardcoded: 0x00000000 + // * Marker Description Length DWORD 32 // number of bytes in Marker Description field + // * Marker Description WCHAR variable // array of Unicode characters - description of marker entry + // * Padding BYTESTREAM variable // optional padding bytes + + $info_asf['marker_object'] = array (); + $info_asf_marker_object = &$info_asf['marker_object']; + + $info_asf_marker_object['objectid_guid'] = $next_object_guidtext; + $info_asf_marker_object['objectsize'] = $next_object_size; + $info_asf_marker_object['reserved_guid'] = getid3_asf::BytestringToGUID(substr($asf_header_data, $offset, 16)); + $offset += 16; + + if ($info_asf_marker_object['reserved_guid'] != '4CFEDB20-75F6-11CF-9C0F-00A0C90349CB') { + $getid3->warning('marker_object.reserved GUID {'.$info_asf_marker_object['reserved_guid'].'} does not match expected GUID {4CFEDB20-75F6-11CF-9C0F-00A0C90349CB}'); + break; + } + + $info_asf_marker_object['markers_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 4)); + $offset += 4; + + $info_asf_marker_object['reserved_2'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + if ($info_asf_marker_object['reserved_2'] != 0) { + $getid3->warning('marker_object.reserved_2 ('.getid3_lib::PrintHexBytes($info_asf_marker_object['reserved_2']).') does not match expected value of "0"'); + break; + } + + $info_asf_marker_object['name_length'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_marker_object['name'] = substr($asf_header_data, $offset, $info_asf_marker_object['name_length']); + $offset += $info_asf_marker_object['name_length']; + + for ($markers_counter = 0; $markers_counter < $info_asf_marker_object['markers_count']; $markers_counter++) { + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_marker_object['markers'][$markers_counter], $asf_header_data, $offset, + array ( + 'offset' => 8, + 'presentation_time' => 8, + 'entry_length' => 2, + 'send_time' => 4, + 'flags' => 4, + 'marker_description_length' => 4 + ) + ); + $offset += 30; + + $info_asf_marker_object['markers'][$markers_counter]['marker_description'] = substr($asf_header_data, $offset, $info_asf_marker_object['markers'][$markers_counter]['marker_description_length']); + $offset += $info_asf_marker_object['markers'][$markers_counter]['marker_description_length']; + + $padding_length = $info_asf_marker_object['markers'][$markers_counter]['entry_length'] - 4 - 4 - 4 - $info_asf_marker_object['markers'][$markers_counter]['marker_description_length']; + if ($padding_length > 0) { + $info_asf_marker_object['markers'][$markers_counter]['padding'] = substr($asf_header_data, $offset, $padding_length); + $offset += $padding_length; + } + } + break; + + + case getid3_asf::Bitrate_Mutual_Exclusion_Object: + + // Bitrate Mutual Exclusion Object: (optional) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Bitrate Mutual Exclusion object - getid3_asf::Bitrate_Mutual_Exclusion_Object + // Object Size QWORD 64 // size of Bitrate Mutual Exclusion object, including 42 bytes of Bitrate Mutual Exclusion Object header + // Exlusion Type GUID 128 // nature of mutual exclusion relationship. one of: (getid3_asf::Mutex_Bitrate, getid3_asf::Mutex_Unknown) + // Stream Numbers Count WORD 16 // number of video streams + // Stream Numbers WORD variable // array of mutually exclusive video stream numbers. 1 <= valid <= 127 + + // shortcut + $info_asf['bitrate_mutual_exclusion_object'] = array (); + $info_asf_bitrate_mutual_exclusion_object = &$info_asf['bitrate_mutual_exclusion_object']; + + $info_asf_bitrate_mutual_exclusion_object['objectid_guid'] = $next_object_guidtext; + $info_asf_bitrate_mutual_exclusion_object['objectsize'] = $next_object_size; + $info_asf_bitrate_mutual_exclusion_object['reserved_guid'] = getid3_asf::BytestringToGUID(substr($asf_header_data, $offset, 16)); + $offset += 16; + + if ($info_asf_bitrate_mutual_exclusion_object['reserved_guid'] != getid3_asf::Mutex_Bitrate && $info_asf_bitrate_mutual_exclusion_object['reserved_guid'] != getid3_asf::Mutex_Unknown) { + $getid3->warning('bitrate_mutual_exclusion_object.reserved GUID {'.$info_asf_bitrate_mutual_exclusion_object['reserved_guid'].'} does not match expected "getid3_asf::Mutex_Bitrate" GUID {'.getid3_asf::Mutex_Bitrate.'} or "getid3_asf::Mutex_Unknown" GUID {'.getid3_asf::Mutex_Unknown.'}'); + break; + } + + $info_asf_bitrate_mutual_exclusion_object['stream_numbers_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + for ($stream_number_counter = 0; $stream_number_counter < $info_asf_bitrate_mutual_exclusion_object['stream_numbers_count']; $stream_number_counter++) { + $info_asf_bitrate_mutual_exclusion_object['stream_numbers'][$stream_number_counter] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + } + break; + + + case getid3_asf::Error_Correction_Object: + + // Error Correction Object: (optional, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Error Correction object - getid3_asf::Error_Correction_Object + // Object Size QWORD 64 // size of Error Correction object, including 44 bytes of Error Correction Object header + // Error Correction Type GUID 128 // type of error correction. one of: (getid3_asf::No_Error_Correction, getid3_asf::Audio_Spread) + // Error Correction Data Length DWORD 32 // number of bytes in Error Correction Data field + // Error Correction Data BYTESTREAM variable // structure depends on value of Error Correction Type field + + $info_asf['error_correction_object'] = array (); + $info_asf_error_correction_object = &$info_asf['error_correction_object']; + + $info_asf_error_correction_object['objectid_guid'] = $next_object_guidtext; + $info_asf_error_correction_object['objectsize'] = $next_object_size; + $info_asf_error_correction_object['error_correction_type'] = substr($asf_header_data, $offset, 16); + $offset += 16; + + $info_asf_error_correction_object['error_correction_guid'] = getid3_asf::BytestringToGUID($info_asf_error_correction_object['error_correction_type']); + $info_asf_error_correction_object['error_correction_data_length'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 4)); + $offset += 4; + + switch ($info_asf_error_correction_object['error_correction_type_guid']) { + + case getid3_asf::No_Error_Correction: + + // should be no data, but just in case there is, skip to the end of the field + $offset += $info_asf_error_correction_object['error_correction_data_length']; + break; + + + case getid3_asf::Audio_Spread: + + // Field Name Field Type Size (bits) + // Span BYTE 8 // number of packets over which audio will be spread. + // Virtual Packet Length WORD 16 // size of largest audio payload found in audio stream + // Virtual Chunk Length WORD 16 // size of largest audio payload found in audio stream + // Silence Data Length WORD 16 // number of bytes in Silence Data field + // Silence Data BYTESTREAM variable // hardcoded: 0x00 * (Silence Data Length) bytes + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_error_correction_object, $asf_header_data, $offset, + array ( + 'span' => 1, + 'virtual_packet_length' => 2, + 'virtual_chunk_length' => 2, + 'silence_data_length' => 2 + ) + ); + $offset += 7; + + $info_asf_error_correction_object['silence_data'] = substr($asf_header_data, $offset, $info_asf_error_correction_object['silence_data_length']); + $offset += $info_asf_error_correction_object['silence_data_length']; + break; + + default: + $getid3->warning('error_correction_object.error_correction_type GUID {'.$info_asf_error_correction_object['reserved_guid'].'} does not match expected "getid3_asf::No_Error_Correction" GUID {'.getid3_asf::No_Error_Correction.'} or "getid3_asf::Audio_Spread" GUID {'.getid3_asf::Audio_Spread.'}'); + break; + } + + break; + + + case getid3_asf::Content_Description_Object: + + // Content Description Object: (optional, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Content Description object - getid3_asf::Content_Description_Object + // Object Size QWORD 64 // size of Content Description object, including 34 bytes of Content Description Object header + // Title Length WORD 16 // number of bytes in Title field + // Author Length WORD 16 // number of bytes in Author field + // Copyright Length WORD 16 // number of bytes in Copyright field + // Description Length WORD 16 // number of bytes in Description field + // Rating Length WORD 16 // number of bytes in Rating field + // Title WCHAR 16 // array of Unicode characters - Title + // Author WCHAR 16 // array of Unicode characters - Author + // Copyright WCHAR 16 // array of Unicode characters - Copyright + // Description WCHAR 16 // array of Unicode characters - Description + // Rating WCHAR 16 // array of Unicode characters - Rating + + $info_asf['content_description_object'] = array (); + $info_asf_content_description_object = &$info_asf['content_description_object']; + + $info_asf_content_description_object['objectid_guid'] = $next_object_guidtext; + $info_asf_content_description_object['objectsize'] = $next_object_size; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_content_description_object, $asf_header_data, $offset, + array ( + 'title_length' => 2, + 'author_length' => 2, + 'copyright_length' => 2, + 'description_length' => 2, + 'rating_length' => 2 + ) + ); + $offset += 10; + + $info_asf_content_description_object['title'] = substr($asf_header_data, $offset, $info_asf_content_description_object['title_length']); + $offset += $info_asf_content_description_object['title_length']; + + $info_asf_content_description_object['author'] = substr($asf_header_data, $offset, $info_asf_content_description_object['author_length']); + $offset += $info_asf_content_description_object['author_length']; + + $info_asf_content_description_object['copyright'] = substr($asf_header_data, $offset, $info_asf_content_description_object['copyright_length']); + $offset += $info_asf_content_description_object['copyright_length']; + + $info_asf_content_description_object['description'] = substr($asf_header_data, $offset, $info_asf_content_description_object['description_length']); + $offset += $info_asf_content_description_object['description_length']; + + $info_asf_content_description_object['rating'] = substr($asf_header_data, $offset, $info_asf_content_description_object['rating_length']); + $offset += $info_asf_content_description_object['rating_length']; + + foreach (array ('title'=>'title', 'author'=>'artist', 'copyright'=>'copyright', 'description'=>'comment', 'rating'=>'rating') as $key_to_copy_from => $key_to_copy_to) { + if (!empty($info_asf_content_description_object[$key_to_copy_from])) { + $info_asf_comments[$key_to_copy_to][] = getid3_asf::TrimTerm($info_asf_content_description_object[$key_to_copy_from]); + } + } + break; + + + case getid3_asf::Extended_Content_Description_Object: + + // Extended Content Description Object: (optional, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Extended Content Description object - getid3_asf::Extended_Content_Description_Object + // Object Size QWORD 64 // size of ExtendedContent Description object, including 26 bytes of Extended Content Description Object header + // Content Descriptors Count WORD 16 // number of entries in Content Descriptors list + // Content Descriptors array of: variable // + // * Descriptor Name Length WORD 16 // size in bytes of Descriptor Name field + // * Descriptor Name WCHAR variable // array of Unicode characters - Descriptor Name + // * Descriptor Value Data Type WORD 16 // Lookup array: + // 0x0000 = Unicode String (variable length) + // 0x0001 = BYTE array (variable length) + // 0x0002 = BOOL (DWORD, 32 bits) + // 0x0003 = DWORD (DWORD, 32 bits) + // 0x0004 = QWORD (QWORD, 64 bits) + // 0x0005 = WORD (WORD, 16 bits) + // * Descriptor Value Length WORD 16 // number of bytes stored in Descriptor Value field + // * Descriptor Value variable variable // value for Content Descriptor + + $info_asf['extended_content_description_object'] = array (); + $info_asf_extended_content_description_object = &$info_asf['extended_content_description_object']; + + $info_asf_extended_content_description_object['objectid_guid'] = $next_object_guidtext; + $info_asf_extended_content_description_object['objectsize'] = $next_object_size; + $info_asf_extended_content_description_object['content_descriptors_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + for ($extended_content_descriptors_counter = 0; $extended_content_descriptors_counter < $info_asf_extended_content_description_object['content_descriptors_count']; $extended_content_descriptors_counter++) { + + $info_asf_extended_content_description_object['content_descriptors'][$extended_content_descriptors_counter] = array (); + $info_asf_extended_content_description_object_content_descriptor_current = &$info_asf_extended_content_description_object['content_descriptors'][$extended_content_descriptors_counter]; + + $info_asf_extended_content_description_object_content_descriptor_current['base_offset'] = $offset + 30; + $info_asf_extended_content_description_object_content_descriptor_current['name_length'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_extended_content_description_object_content_descriptor_current['name'] = substr($asf_header_data, $offset, $info_asf_extended_content_description_object_content_descriptor_current['name_length']); + $offset += $info_asf_extended_content_description_object_content_descriptor_current['name_length']; + + $info_asf_extended_content_description_object_content_descriptor_current['value_type'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_extended_content_description_object_content_descriptor_current['value_length'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_extended_content_description_object_content_descriptor_current['value'] = substr($asf_header_data, $offset, $info_asf_extended_content_description_object_content_descriptor_current['value_length']); + $offset += $info_asf_extended_content_description_object_content_descriptor_current['value_length']; + + switch ($info_asf_extended_content_description_object_content_descriptor_current['value_type']) { + + case 0x0000: // Unicode string + break; + + case 0x0001: // BYTE array + // do nothing + break; + + case 0x0002: // BOOL + $info_asf_extended_content_description_object_content_descriptor_current['value'] = (bool)getid3_lib::LittleEndian2Int($info_asf_extended_content_description_object_content_descriptor_current['value']); + break; + + case 0x0003: // DWORD + case 0x0004: // QWORD + case 0x0005: // WORD + $info_asf_extended_content_description_object_content_descriptor_current['value'] = getid3_lib::LittleEndian2Int($info_asf_extended_content_description_object_content_descriptor_current['value']); + break; + + default: + $getid3->warning('extended_content_description.content_descriptors.'.$extended_content_descriptors_counter.'.value_type is invalid ('.$info_asf_extended_content_description_object_content_descriptor_current['value_type'].')'); + break; + } + + switch ($this->TrimConvert(strtolower($info_asf_extended_content_description_object_content_descriptor_current['name']))) { + + case 'wm/albumartist': + case 'artist': + $info_asf_comments['artist'] = array (getid3_asf::TrimTerm($info_asf_extended_content_description_object_content_descriptor_current['value'])); + break; + + + case 'wm/albumtitle': + case 'album': + $info_asf_comments['album'] = array (getid3_asf::TrimTerm($info_asf_extended_content_description_object_content_descriptor_current['value'])); + break; + + + case 'wm/genre': + case 'genre': + $genre = getid3_asf::TrimTerm($info_asf_extended_content_description_object_content_descriptor_current['value']); + $info_asf_comments['genre'] = array ($genre); + break; + + + case 'wm/tracknumber': + case 'tracknumber': + $info_asf_comments['track'] = array (intval(getid3_asf::TrimTerm($info_asf_extended_content_description_object_content_descriptor_current['value']))); + break; + + + case 'wm/track': + if (empty($info_asf_comments['track'])) { + $info_asf_comments['track'] = array (1 + $this->TrimConvert($info_asf_extended_content_description_object_content_descriptor_current['value'])); + } + break; + + + case 'wm/year': + case 'year': + case 'date': + $info_asf_comments['year'] = array ( getid3_asf::TrimTerm($info_asf_extended_content_description_object_content_descriptor_current['value'])); + break; + + + case 'wm/lyrics': + case 'lyrics': + $info_asf_comments['lyrics'] = array ( getid3_asf::TrimTerm($info_asf_extended_content_description_object_content_descriptor_current['value'])); + break; + + + case 'isvbr': + if ($info_asf_extended_content_description_object_content_descriptor_current['value']) { + $info_audio['bitrate_mode'] = 'vbr'; + $info_video['bitrate_mode'] = 'vbr'; + } + break; + + + case 'id3': + + // id3v2 parsing might not be enabled + if (class_exists('getid3_id3v2')) { + + // Clone getid3 + $clone = clone $getid3; + + // Analyse clone by string + $id3v2 = new getid3_id3v2($clone); + $id3v2->AnalyzeString($info_asf_extended_content_description_object_content_descriptor_current['value']); + + // Import from clone and destroy + $getid3->info['id3v2'] = $clone->info['id3v2']; + $getid3->warnings($clone->warnings()); + unset($clone); + } + break; + + + case 'wm/encodingtime': + $info_asf_extended_content_description_object_content_descriptor_current['encoding_time_unix'] = getid3_asf::FiletimeToUNIXtime($info_asf_extended_content_description_object_content_descriptor_current['value']); + $info_asf_comments['encoding_time_unix'] = array ($info_asf_extended_content_description_object_content_descriptor_current['encoding_time_unix']); + break; + + + case 'wm/picture': + + //typedef struct _WMPicture{ + // LPWSTR pwszMIMEType; + // BYTE bPictureType; + // LPWSTR pwszDescription; + // DWORD dwDataLen; + // BYTE* pbData; + //} WM_PICTURE; + + $info_asf_extended_content_description_object_content_descriptor_current['image_type_id'] = getid3_lib::LittleEndian2Int($info_asf_extended_content_description_object_content_descriptor_current['value']{0}); + $info_asf_extended_content_description_object_content_descriptor_current['image_type'] = getid3_asf::WMpictureTypeLookup($info_asf_extended_content_description_object_content_descriptor_current['image_type_id']); + $info_asf_extended_content_description_object_content_descriptor_current['image_size'] = getid3_lib::LittleEndian2Int(substr($info_asf_extended_content_description_object_content_descriptor_current['value'], 1, 4)); + $info_asf_extended_content_description_object_content_descriptor_current['image_mime'] = ''; + + $wm_picture_offset = 5; + + do { + $next_byte_pair = substr($info_asf_extended_content_description_object_content_descriptor_current['value'], $wm_picture_offset, 2); + $wm_picture_offset += 2; + $info_asf_extended_content_description_object_content_descriptor_current['image_mime'] .= $next_byte_pair; + } while ($next_byte_pair !== "\x00\x00"); + + $info_asf_extended_content_description_object_content_descriptor_current['image_description'] = ''; + + do { + $next_byte_pair = substr($info_asf_extended_content_description_object_content_descriptor_current['value'], $wm_picture_offset, 2); + $wm_picture_offset += 2; + $info_asf_extended_content_description_object_content_descriptor_current['image_description'] .= $next_byte_pair; + } while ($next_byte_pair !== "\x00\x00"); + + $info_asf_extended_content_description_object_content_descriptor_current['dataoffset'] = $wm_picture_offset; + $info_asf_extended_content_description_object_content_descriptor_current['data'] = substr($info_asf_extended_content_description_object_content_descriptor_current['value'], $wm_picture_offset); + unset($info_asf_extended_content_description_object_content_descriptor_current['value']); + break; + + default: + switch ($info_asf_extended_content_description_object_content_descriptor_current['value_type']) { + case 0: // Unicode string + if (substr($this->TrimConvert($info_asf_extended_content_description_object_content_descriptor_current['name']), 0, 3) == 'WM/') { + $info_asf_comments[str_replace('wm/', '', strtolower($this->TrimConvert($info_asf_extended_content_description_object_content_descriptor_current['name'])))] = array (getid3_asf::TrimTerm($info_asf_extended_content_description_object_content_descriptor_current['value'])); + } + break; + + case 1: + break; + } + break; + } + + } + break; + + + case getid3_asf::Stream_Bitrate_Properties_Object: + + // Stream Bitrate Properties Object: (optional, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Stream Bitrate Properties object - getid3_asf::Stream_Bitrate_Properties_Object + // Object Size QWORD 64 // size of Extended Content Description object, including 26 bytes of Stream Bitrate Properties Object header + // Bitrate Records Count WORD 16 // number of records in Bitrate Records + // Bitrate Records array of: variable // + // * Flags WORD 16 // + // * * Stream Number bits 7 (0x007F) // number of this stream + // * * Reserved bits 9 (0xFF80) // hardcoded: 0 + // * Average Bitrate DWORD 32 // in bits per second + + // shortcut + $info_asf['stream_bitrate_properties_object'] = array (); + $info_asf_stream_bitrate_properties_object = &$info_asf['stream_bitrate_properties_object']; + + $info_asf_stream_bitrate_properties_object['objectid_guid'] = $next_object_guidtext; + $info_asf_stream_bitrate_properties_object['objectsize'] = $next_object_size; + $info_asf_stream_bitrate_properties_object['bitrate_records_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + for ($bitrate_records_counter = 0; $bitrate_records_counter < $info_asf_stream_bitrate_properties_object['bitrate_records_count']; $bitrate_records_counter++) { + + $info_asf_stream_bitrate_properties_object['bitrate_records'][$bitrate_records_counter]['flags_raw'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 2)); + $offset += 2; + + $info_asf_stream_bitrate_properties_object['bitrate_records'][$bitrate_records_counter]['flags']['stream_number'] = $info_asf_stream_bitrate_properties_object['bitrate_records'][$bitrate_records_counter]['flags_raw'] & 0x007F; + + $info_asf_stream_bitrate_properties_object['bitrate_records'][$bitrate_records_counter]['bitrate'] = getid3_lib::LittleEndian2Int(substr($asf_header_data, $offset, 4)); + $offset += 4; + } + break; + + + case getid3_asf::Padding_Object: + + // Padding Object: (optional) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Padding object - getid3_asf::Padding_Object + // Object Size QWORD 64 // size of Padding object, including 24 bytes of ASF Padding Object header + // Padding Data BYTESTREAM variable // ignore + + // shortcut + $info_asf['padding_object'] = array (); + $info_asf_paddingobject = &$info_asf['padding_object']; + + $info_asf_paddingobject['objectid_guid'] = $next_object_guidtext; + $info_asf_paddingobject['objectsize'] = $next_object_size; + $info_asf_paddingobject['padding_length'] = $info_asf_paddingobject['objectsize'] - 16 - 8; + $info_asf_paddingobject['padding'] = substr($asf_header_data, $offset, $info_asf_paddingobject['padding_length']); + $offset += ($next_object_size - 16 - 8); + break; + + + case getid3_asf::Extended_Content_Encryption_Object: + case getid3_asf::Content_Encryption_Object: + + // WMA DRM - just ignore + $offset += ($next_object_size - 16 - 8); + break; + + + default: + + // Implementations shall ignore any standard or non-standard object that they do not know how to handle. + if (getid3_asf::GUIDname($next_object_guidtext)) { + $getid3->warning('unhandled GUID "'.getid3_asf::GUIDname($next_object_guidtext).'" {'.$next_object_guidtext.'} in ASF header at offset '.($offset - 16 - 8)); + } else { + $getid3->warning('unknown GUID {'.$next_object_guidtext.'} in ASF header at offset '.($offset - 16 - 8)); + } + $offset += ($next_object_size - 16 - 8); + break; + } + } + + if (isset($info_asf_stream_bitrate_properties['bitrate_records_count'])) { + $asf_bitrate_audio = 0; + $asf_bitrate_video = 0; + + for ($bitrate_records_counter = 0; $bitrate_records_counter < $info_asf_stream_bitrate_properties['bitrate_records_count']; $bitrate_records_counter++) { + if (isset($info_asf_codec_list_object['codec_entries'][$bitrate_records_counter])) { + switch ($info_asf_codec_list_object['codec_entries'][$bitrate_records_counter]['type_raw']) { + + case 1: + $asf_bitrate_video += $info_asf_stream_bitrate_properties['bitrate_records'][$bitrate_records_counter]['bitrate']; + break; + + case 2: + $asf_bitrate_audio += $info_asf_stream_bitrate_properties['bitrate_records'][$bitrate_records_counter]['bitrate']; + break; + } + } + } + if ($asf_bitrate_audio > 0) { + $info_audio['bitrate'] = $asf_bitrate_audio; + } + if ($asf_bitrate_video > 0) { + $info_video['bitrate'] = $asf_bitrate_video; + } + } + + if (isset($info_asf['stream_properties_object']) && is_array($info_asf['stream_properties_object'])) { + + $info_audio['bitrate'] = 0; + $info_video['bitrate'] = 0; + + foreach ($info_asf['stream_properties_object'] as $stream_number => $stream_data) { + + switch ($stream_data['stream_type_guid']) { + + case getid3_asf::Audio_Media: + + // Field Name Field Type Size (bits) + // Codec ID / Format Tag WORD 16 // unique ID of audio codec - defined as wFormatTag field of WAVEFORMATEX structure + // Number of Channels WORD 16 // number of channels of audio - defined as nChannels field of WAVEFORMATEX structure + // Samples Per Second DWORD 32 // in Hertz - defined as nSamplesPerSec field of WAVEFORMATEX structure + // Average number of Bytes/sec DWORD 32 // bytes/sec of audio stream - defined as nAvgBytesPerSec field of WAVEFORMATEX structure + // Block Alignment WORD 16 // block size in bytes of audio codec - defined as nBlockAlign field of WAVEFORMATEX structure + // Bits per sample WORD 16 // bits per sample of mono data. set to zero for variable bitrate codecs. defined as wBitsPerSample field of WAVEFORMATEX structure + // Codec Specific Data Size WORD 16 // size in bytes of Codec Specific Data buffer - defined as cbSize field of WAVEFORMATEX structure + // Codec Specific Data BYTESTREAM variable // array of codec-specific data bytes + + // shortcut + $info_asf['audio_media'][$stream_number] = array (); + $info_asf_audio_media_current_stream = &$info_asf['audio_media'][$stream_number]; + + $audio_media_offset = 0; + + $info_asf_audio_media_current_stream = getid3_riff::RIFFparseWAVEFORMATex(substr($stream_data['type_specific_data'], $audio_media_offset, 16)); + + $audio_media_offset += 16; + + $info_audio['lossless'] = false; + switch ($info_asf_audio_media_current_stream['raw']['wFormatTag']) { + case 0x0001: // PCM + case 0x0163: // WMA9 Lossless + $info_audio['lossless'] = true; + break; + } + + if (!empty($info_asf['stream_bitrate_properties_object']['bitrate_records'])) { + foreach ($info_asf['stream_bitrate_properties_object']['bitrate_records'] as $data_array) { + if (@$data_array['flags']['stream_number'] == $stream_number) { + $info_asf_audio_media_current_stream['bitrate'] = $data_array['bitrate']; + $info_audio['bitrate'] += $data_array['bitrate']; + break; + } + } + } else { + if (@$info_asf_audio_media_current_stream['bytes_sec']) { + $info_audio['bitrate'] += $info_asf_audio_media_current_stream['bytes_sec'] * 8; + } elseif (@$info_asf_audio_media_current_stream['bitrate']) { + $info_audio['bitrate'] += $info_asf_audio_media_current_stream['bitrate']; + } + } + + $info_audio['streams'][$stream_number] = $info_asf_audio_media_current_stream; + $info_audio['streams'][$stream_number]['wformattag'] = $info_asf_audio_media_current_stream['raw']['wFormatTag']; + $info_audio['streams'][$stream_number]['lossless'] = $info_audio['lossless']; + $info_audio['streams'][$stream_number]['bitrate'] = $info_audio['bitrate']; + unset($info_audio['streams'][$stream_number]['raw']); + + $info_asf_audio_media_current_stream['codec_data_size'] = getid3_lib::LittleEndian2Int(substr($stream_data['type_specific_data'], $audio_media_offset, 2)); + $audio_media_offset += 2; + + $info_asf_audio_media_current_stream['codec_data'] = substr($stream_data['type_specific_data'], $audio_media_offset, $info_asf_audio_media_current_stream['codec_data_size']); + $audio_media_offset += $info_asf_audio_media_current_stream['codec_data_size']; + break; + + + case getid3_asf::Video_Media: + + // Field Name Field Type Size (bits) + // Encoded Image Width DWORD 32 // width of image in pixels + // Encoded Image Height DWORD 32 // height of image in pixels + // Reserved Flags BYTE 8 // hardcoded: 0x02 + // Format Data Size WORD 16 // size of Format Data field in bytes + // Format Data array of: variable // + // * Format Data Size DWORD 32 // number of bytes in Format Data field, in bytes - defined as biSize field of BITMAPINFOHEADER structure + // * Image Width LONG 32 // width of encoded image in pixels - defined as biWidth field of BITMAPINFOHEADER structure + // * Image Height LONG 32 // height of encoded image in pixels - defined as biHeight field of BITMAPINFOHEADER structure + // * Reserved WORD 16 // hardcoded: 0x0001 - defined as biPlanes field of BITMAPINFOHEADER structure + // * Bits Per Pixel Count WORD 16 // bits per pixel - defined as biBitCount field of BITMAPINFOHEADER structure + // * Compression ID FOURCC 32 // fourcc of video codec - defined as biCompression field of BITMAPINFOHEADER structure + // * Image Size DWORD 32 // image size in bytes - defined as biSizeImage field of BITMAPINFOHEADER structure + // * Horizontal Pixels / Meter DWORD 32 // horizontal resolution of target device in pixels per meter - defined as biXPelsPerMeter field of BITMAPINFOHEADER structure + // * Vertical Pixels / Meter DWORD 32 // vertical resolution of target device in pixels per meter - defined as biYPelsPerMeter field of BITMAPINFOHEADER structure + // * Colors Used Count DWORD 32 // number of color indexes in the color table that are actually used - defined as biClrUsed field of BITMAPINFOHEADER structure + // * Important Colors Count DWORD 32 // number of color index required for displaying bitmap. if zero, all colors are required. defined as biClrImportant field of BITMAPINFOHEADER structure + // * Codec Specific Data BYTESTREAM variable // array of codec-specific data bytes + + $info_asf['video_media'][$stream_number] = array (); + $info_asf_video_media_current_stream = &$info_asf['video_media'][$stream_number]; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_video_media_current_stream, $stream_data['type_specific_data'], 0, + array ( + 'image_width' => 4, + 'image_height' => 4, + 'flags' => 1, + 'format_data_size'=> 2 + ) + ); + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_video_media_current_stream['format_data'], $stream_data['type_specific_data'], 11, + array ( + 'format_data_size' => 4, + 'image_width' => 4, + 'image_height' => 4, + 'reserved' => 2, + 'bits_per_pixel' => 2, + 'codec_fourcc' => -4, + 'image_size' => 4, + 'horizontal_pels' => 4, + 'vertical_pels' => 4, + 'colors_used' => 4, + 'colors_important' => 4 + ) + ); + + $info_asf_video_media_current_stream['format_data']['codec_data'] = substr($stream_data['type_specific_data'], 51); + + if (!empty($info_asf['stream_bitrate_properties_object']['bitrate_records'])) { + foreach ($info_asf['stream_bitrate_properties_object']['bitrate_records'] as $data_array) { + if (@$data_array['flags']['stream_number'] == $stream_number) { + $info_asf_video_media_current_stream['bitrate'] = $data_array['bitrate']; + $info_video['streams'][$stream_number]['bitrate'] = $data_array['bitrate']; + $info_video['bitrate'] += $data_array['bitrate']; + + break; + } + } + } + + $info_asf_video_media_current_stream['format_data']['codec'] = getid3_riff::RIFFfourccLookup($info_asf_video_media_current_stream['format_data']['codec_fourcc']); + + $info_video['streams'][$stream_number]['fourcc'] = $info_asf_video_media_current_stream['format_data']['codec_fourcc']; + $info_video['streams'][$stream_number]['codec'] = $info_asf_video_media_current_stream['format_data']['codec']; + $info_video['streams'][$stream_number]['resolution_x'] = $info_asf_video_media_current_stream['image_width']; + $info_video['streams'][$stream_number]['resolution_y'] = $info_asf_video_media_current_stream['image_height']; + $info_video['streams'][$stream_number]['bits_per_sample'] = $info_asf_video_media_current_stream['format_data']['bits_per_pixel']; + break; + + default: + break; + } + } + } + + while (ftell($getid3->fp) < $getid3->info['avdataend']) { + + $next_object_data_header = fread($getid3->fp, 24); + $offset = 0; + + $next_object_guid = substr($next_object_data_header, 0, 16); + $offset += 16; + + $next_object_guidtext = getid3_asf::BytestringToGUID($next_object_guid); + $next_object_size = getid3_lib::LittleEndian2Int(substr($next_object_data_header, $offset, 8)); + $offset += 8; + + switch ($next_object_guidtext) { + + case getid3_asf::Data_Object: + + // Data Object: (mandatory, one only) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Data object - getid3_asf::Data_Object + // Object Size QWORD 64 // size of Data object, including 50 bytes of Data Object header. may be 0 if FilePropertiesObject.BroadcastFlag == 1 + // File ID GUID 128 // unique identifier. identical to File ID field in Header Object + // Total Data Packets QWORD 64 // number of Data Packet entries in Data Object. invalid if FilePropertiesObject.BroadcastFlag == 1 + // Reserved WORD 16 // hardcoded: 0x0101 + + // shortcut + $info_asf['data_object'] = array (); + $info_asf_data_object = &$info_asf['data_object']; + + $data_object_data = $next_object_data_header.fread($getid3->fp, 50 - 24); + $offset = 24; + + $info_asf_data_object['objectid_guid'] = $next_object_guidtext; + $info_asf_data_object['objectsize'] = $next_object_size; + + $info_asf_data_object['fileid_guid'] = getid3_asf::BytestringToGUID(substr($data_object_data, $offset, 16)); + $offset += 16; + + $info_asf_data_object['total_data_packets'] = getid3_lib::LittleEndian2Int(substr($data_object_data, $offset, 8)); + $offset += 8; + + $info_asf_data_object['reserved'] = getid3_lib::LittleEndian2Int(substr($data_object_data, $offset, 2)); + $offset += 2; + + if ($info_asf_data_object['reserved'] != 0x0101) { + $getid3->warning('data_object.reserved ('.getid3_lib::PrintHexBytes($info_asf_data_object['reserved']).') does not match expected value of "0x0101"'); + break; + } + + // Data Packets array of: variable // + // * Error Correction Flags BYTE 8 // + // * * Error Correction Data Length bits 4 // if Error Correction Length Type == 00, size of Error Correction Data in bytes, else hardcoded: 0000 + // * * Opaque Data Present bits 1 // + // * * Error Correction Length Type bits 2 // number of bits for size of the error correction data. hardcoded: 00 + // * * Error Correction Present bits 1 // If set, use Opaque Data Packet structure, else use Payload structure + // * Error Correction Data + + $getid3->info['avdataoffset'] = ftell($getid3->fp); + fseek($getid3->fp, ($info_asf_data_object['objectsize'] - 50), SEEK_CUR); // skip actual audio/video data + $getid3->info['avdataend'] = ftell($getid3->fp); + break; + + + case getid3_asf::Simple_Index_Object: + + // Simple Index Object: (optional, recommended, one per video stream) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for Simple Index object - getid3_asf::Data_Object + // Object Size QWORD 64 // size of Simple Index object, including 56 bytes of Simple Index Object header + // File ID GUID 128 // unique identifier. may be zero or identical to File ID field in Data Object and Header Object + // Index Entry Time Interval QWORD 64 // interval between index entries in 100-nanosecond units + // Maximum Packet Count DWORD 32 // maximum packet count for all index entries + // Index Entries Count DWORD 32 // number of Index Entries structures + // Index Entries array of: variable // + // * Packet Number DWORD 32 // number of the Data Packet associated with this index entry + // * Packet Count WORD 16 // number of Data Packets to sent at this index entry + + // shortcut + $info_asf['simple_index_object'] = array (); + $info_asf_simple_index_object = &$info_asf['simple_index_object']; + + $info_asf_simple_index_object['objectid_guid'] = $next_object_guidtext; + $info_asf_simple_index_object['objectsize'] = $next_object_size; + + $simple_index_object_data = $next_object_data_header.fread($getid3->fp, 56 - 24); + + $info_asf_simple_index_object['fileid_guid'] = getid3_asf::BytestringToGUID(substr($simple_index_object_data, 24, 16)); + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_simple_index_object, $simple_index_object_data, 40, + array ( + 'index_entry_time_interval' => 8, + 'maximum_packet_count' => 4, + 'index_entries_count' => 4 + ) + ); + + $offset = 56; + + $index_entries_data = $simple_index_object_data.fread($getid3->fp, 6 * $info_asf_simple_index_object['index_entries_count']); + for ($index_entries_counter = 0; $index_entries_counter < $info_asf_simple_index_object['index_entries_count']; $index_entries_counter++) { + + $info_asf_simple_index_object['index_entries'][$index_entries_counter]['packet_number'] = getid3_lib::LittleEndian2Int(substr($index_entries_data, $offset, 4)); + $offset += 4; + + $info_asf_simple_index_object['index_entries'][$index_entries_counter]['packet_count'] = getid3_lib::LittleEndian2Int(substr($index_entries_data, $offset, 4)); + $offset += 2; + } + break; + + + case getid3_asf::Index_Object: + + // 6.2 ASF top-level Index Object (optional but recommended when appropriate, 0 or 1) + // Field Name Field Type Size (bits) + // Object ID GUID 128 // GUID for the Index Object - getid3_asf::Index_Object + // Object Size QWORD 64 // Specifies the size, in bytes, of the Index Object, including at least 34 bytes of Index Object header + // Index Entry Time Interval DWORD 32 // Specifies the time interval between each index entry in ms. + // Index Specifiers Count WORD 16 // Specifies the number of Index Specifiers structures in this Index Object. + // Index Blocks Count DWORD 32 // Specifies the number of Index Blocks structures in this Index Object. + + // Index Entry Time Interval DWORD 32 // Specifies the time interval between index entries in milliseconds. This value cannot be 0. + // Index Specifiers Count WORD 16 // Specifies the number of entries in the Index Specifiers list. Valid values are 1 and greater. + // Index Specifiers array of: varies // + // * Stream Number WORD 16 // Specifies the stream number that the Index Specifiers refer to. Valid values are between 1 and 127. + // * Index Type WORD 16 // Specifies Index Type values as follows: + // 1 = Nearest Past Data Packet - indexes point to the data packet whose presentation time is closest to the index entry time. + // 2 = Nearest Past Media Object - indexes point to the closest data packet containing an entire object or first fragment of an object. + // 3 = Nearest Past Cleanpoint. - indexes point to the closest data packet containing an entire object (or first fragment of an object) that has the Cleanpoint Flag set. + // Nearest Past Cleanpoint is the most common type of index. + // Index Entry Count DWORD 32 // Specifies the number of Index Entries in the block. + // * Block Positions QWORD varies // Specifies a list of byte offsets of the beginnings of the blocks relative to the beginning of the first Data Packet (i.e., the beginning of the Data Object + 50 bytes). The number of entries in this list is specified by the value of the Index Specifiers Count field. The order of those byte offsets is tied to the order in which Index Specifiers are listed. + // * Index Entries array of: varies // + // * * Offsets DWORD varies // An offset value of 0xffffffff indicates an invalid offset value + + // shortcut + $info_asf['asf_index_object'] = array (); + $info_asf_asf_index_object = &$info_asf['asf_index_object']; + + $asf_index_object_data = $next_object_data_header.fread($getid3->fp, 34 - 24); + + $info_asf_asf_index_object['objectid_guid'] = $next_object_guidtext; + $info_asf_asf_index_object['objectsize'] = $next_object_size; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_asf_asf_index_object, $asf_index_object_data, 24, + array ( + 'entry_time_interval' =>4, + 'index_specifiers_count' =>2, + 'index_blocks_count' =>4 + ) + ); + + $offset = 34; + + $asf_index_object_data .= fread($getid3->fp, 4 * $info_asf_asf_index_object['index_specifiers_count']); + + for ($index_specifiers_counter = 0; $index_specifiers_counter < $info_asf_asf_index_object['index_specifiers_count']; $index_specifiers_counter++) { + + $index_specifier_stream_number = getid3_lib::LittleEndian2Int(substr($asf_index_object_data, $offset, 2)); + $offset += 2; + + $info_asf_asf_index_object['index_specifiers'][$index_specifiers_counter]['stream_number'] = $index_specifier_stream_number; + + $info_asf_asf_index_object['index_specifiers'][$index_specifiers_counter]['index_type'] = getid3_lib::LittleEndian2Int(substr($asf_index_object_data, $offset, 2)); + $offset += 2; + + $info_asf_asf_index_object['index_specifiers'][$index_specifiers_counter]['index_type_text'] = getid3_asf::ASFIndexObjectIndexTypeLookup($info_asf_asf_index_object['index_specifiers'][$index_specifiers_counter]['index_type']); + } + + $asf_index_object_data .= fread($getid3->fp, 4); + $info_asf_asf_index_object['index_entry_count'] = getid3_lib::LittleEndian2Int(substr($asf_index_object_data, $offset, 4)); + $offset += 4; + + $asf_index_object_data .= fread($getid3->fp, 8 * $info_asf_asf_index_object['index_specifiers_count']); + + for ($index_specifiers_counter = 0; $index_specifiers_counter < $info_asf_asf_index_object['index_specifiers_count']; $index_specifiers_counter++) { + $info_asf_asf_index_object['block_positions'][$index_specifiers_counter] = getid3_lib::LittleEndian2Int(substr($asf_index_object_data, $offset, 8)); + $offset += 8; + } + + $asf_index_object_data .= fread($getid3->fp, 4 * $info_asf_asf_index_object['index_specifiers_count'] * $info_asf_asf_index_object['index_entry_count']); + + for ($index_entry_counter = 0; $index_entry_counter < $info_asf_asf_index_object['index_entry_count']; $index_entry_counter++) { + for ($index_specifiers_counter = 0; $index_specifiers_counter < $info_asf_asf_index_object['index_specifiers_count']; $index_specifiers_counter++) { + $info_asf_asf_index_object['offsets'][$index_specifiers_counter][$index_entry_counter] = getid3_lib::LittleEndian2Int(substr($asf_index_object_data, $offset, 4)); + $offset += 4; + } + } + break; + + + default: + + // Implementations shall ignore any standard or non-standard object that they do not know how to handle. + if (getid3_asf::GUIDname($next_object_guidtext)) { + $getid3->warning('unhandled GUID "'.getid3_asf::GUIDname($next_object_guidtext).'" {'.$next_object_guidtext.'} in ASF body at offset '.($offset - 16 - 8)); + } else { + $getid3->warning('unknown GUID {'.$next_object_guidtext.'} in ASF body at offset '.(ftell($getid3->fp) - 16 - 8)); + } + fseek($getid3->fp, ($next_object_size - 16 - 8), SEEK_CUR); + break; + } + } + + if (isset($info_asf_codec_list_object['codec_entries']) && is_array($info_asf_codec_list_object['codec_entries'])) { + foreach ($info_asf_codec_list_object['codec_entries'] as $stream_number => $stream_data) { + switch ($stream_data['information']) { + case 'WMV1': + case 'WMV2': + case 'WMV3': + case 'MSS1': + case 'MSS2': + case 'WMVA': + case 'WVC1': + case 'WMVP': + case 'WVP2': + $info_video['dataformat'] = 'wmv'; + $getid3->info['mime_type'] = 'video/x-ms-wmv'; + break; + + case 'MP42': + case 'MP43': + case 'MP4S': + case 'mp4s': + $info_video['dataformat'] = 'asf'; + $getid3->info['mime_type'] = 'video/x-ms-asf'; + break; + + default: + switch ($stream_data['type_raw']) { + case 1: + if (strstr($this->TrimConvert($stream_data['name']), 'Windows Media')) { + $info_video['dataformat'] = 'wmv'; + if ($getid3->info['mime_type'] == 'video/x-ms-asf') { + $getid3->info['mime_type'] = 'video/x-ms-wmv'; + } + } + break; + + case 2: + if (strstr($this->TrimConvert($stream_data['name']), 'Windows Media')) { + $info_audio['dataformat'] = 'wma'; + if ($getid3->info['mime_type'] == 'video/x-ms-asf') { + $getid3->info['mime_type'] = 'audio/x-ms-wma'; + } + } + break; + + } + break; + } + } + } + + switch (@$info_audio['codec']) { + case 'MPEG Layer-3': + $info_audio['dataformat'] = 'mp3'; + break; + + default: + break; + } + + if (isset($info_asf_codec_list_object['codec_entries'])) { + foreach ($info_asf_codec_list_object['codec_entries'] as $stream_number => $stream_data) { + switch ($stream_data['type_raw']) { + + case 1: // video + $info_video['encoder'] = $this->TrimConvert($info_asf_codec_list_object['codec_entries'][$stream_number]['name']); + break; + + case 2: // audio + $info_audio['encoder'] = $this->TrimConvert($info_asf_codec_list_object['codec_entries'][$stream_number]['name']); + $info_audio['encoder_options'] = $this->TrimConvert($info_asf_codec_list_object['codec_entries'][0]['description']); + $info_audio['codec'] = $info_audio['encoder']; + break; + + default: + $getid3->warning('Unknown streamtype: [codec_list_object][codec_entries]['.$stream_number.'][type_raw] == '.$stream_data['type_raw']); + break; + + } + } + } + + if (isset($getid3->info['audio'])) { + $info_audio['lossless'] = (isset($info_audio['lossless']) ? $info_audio['lossless'] : false); + $info_audio['dataformat'] = (!empty($info_audio['dataformat']) ? $info_audio['dataformat'] : 'asf'); + } + + if (!empty($info_video['dataformat'])) { + $info_video['lossless'] = (isset($info_audio['lossless']) ? $info_audio['lossless'] : false); + $info_video['pixel_aspect_ratio'] = (isset($info_audio['pixel_aspect_ratio']) ? $info_audio['pixel_aspect_ratio'] : (float)1); + $info_video['dataformat'] = (!empty($info_video['dataformat']) ? $info_video['dataformat'] : 'asf'); + } + + $getid3->info['bitrate'] = @$info_audio['bitrate'] + @$info_video['bitrate']; + + if (empty($info_audio)) { + unset($getid3->info['audio']); + } + + if (empty($info_video)) { + unset($getid3->info['video']); + } + + return true; + } + + + + // Remove terminator 00 00 and convert UNICODE to Latin-1 + private function TrimConvert($string) { + + // remove terminator, only if present (it should be, but...) + if (substr($string, strlen($string) - 2, 2) == "\x00\x00") { + $string = substr($string, 0, strlen($string) - 2); + } + + // convert + return trim($this->getid3->iconv('UTF-16LE', 'ISO-8859-1', $string), ' '); + } + + + + private function WMpictureTypeLookup($wm_picture_type) { + + static $lookup = array ( + 0x03 => 'Front Cover', + 0x04 => 'Back Cover', + 0x00 => 'User Defined', + 0x05 => 'Leaflet Page', + 0x06 => 'Media Label', + 0x07 => 'Lead Artist', + 0x08 => 'Artist', + 0x09 => 'Conductor', + 0x0A => 'Band', + 0x0B => 'Composer', + 0x0C => 'Lyricist', + 0x0D => 'Recording Location', + 0x0E => 'During Recording', + 0x0F => 'During Performance', + 0x10 => 'Video Screen Capture', + 0x12 => 'Illustration', + 0x13 => 'Band Logotype', + 0x14 => 'Publisher Logotype' + ); + + return isset($lookup[$wm_picture_type]) ? $this->getid3->iconv('ISO-8859-1', 'UTF-16LE', $lookup[$wm_picture_type]) : ''; + } + + + + public static function ASFCodecListObjectTypeLookup($codec_list_type) { + + static $lookup = array ( + 0x0001 => 'Video Codec', + 0x0002 => 'Audio Codec', + 0xFFFF => 'Unknown Codec' + ); + + return (isset($lookup[$codec_list_type]) ? $lookup[$codec_list_type] : 'Invalid Codec Type'); + } + + + + public static function GUIDname($guid_string) { + + static $lookup = array ( + getid3_asf::Extended_Stream_Properties_Object => 'Extended_Stream_Properties_Object', + getid3_asf::Padding_Object => 'Padding_Object', + getid3_asf::Payload_Ext_Syst_Pixel_Aspect_Ratio => 'Payload_Ext_Syst_Pixel_Aspect_Ratio', + getid3_asf::Script_Command_Object => 'Script_Command_Object', + getid3_asf::No_Error_Correction => 'No_Error_Correction', + getid3_asf::Content_Branding_Object => 'Content_Branding_Object', + getid3_asf::Content_Encryption_Object => 'Content_Encryption_Object', + getid3_asf::Digital_Signature_Object => 'Digital_Signature_Object', + getid3_asf::Extended_Content_Encryption_Object => 'Extended_Content_Encryption_Object', + getid3_asf::Simple_Index_Object => 'Simple_Index_Object', + getid3_asf::Degradable_JPEG_Media => 'Degradable_JPEG_Media', + getid3_asf::Payload_Extension_System_Timecode => 'Payload_Extension_System_Timecode', + getid3_asf::Binary_Media => 'Binary_Media', + getid3_asf::Timecode_Index_Object => 'Timecode_Index_Object', + getid3_asf::Metadata_Library_Object => 'Metadata_Library_Object', + getid3_asf::Reserved_3 => 'Reserved_3', + getid3_asf::Reserved_4 => 'Reserved_4', + getid3_asf::Command_Media => 'Command_Media', + getid3_asf::Header_Extension_Object => 'Header_Extension_Object', + getid3_asf::Media_Object_Index_Parameters_Obj => 'Media_Object_Index_Parameters_Obj', + getid3_asf::Header_Object => 'Header_Object', + getid3_asf::Content_Description_Object => 'Content_Description_Object', + getid3_asf::Error_Correction_Object => 'Error_Correction_Object', + getid3_asf::Data_Object => 'Data_Object', + getid3_asf::Web_Stream_Media_Subtype => 'Web_Stream_Media_Subtype', + getid3_asf::Stream_Bitrate_Properties_Object => 'Stream_Bitrate_Properties_Object', + getid3_asf::Language_List_Object => 'Language_List_Object', + getid3_asf::Codec_List_Object => 'Codec_List_Object', + getid3_asf::Reserved_2 => 'Reserved_2', + getid3_asf::File_Properties_Object => 'File_Properties_Object', + getid3_asf::File_Transfer_Media => 'File_Transfer_Media', + getid3_asf::Old_RTP_Extension_Data => 'Old_RTP_Extension_Data', + getid3_asf::Advanced_Mutual_Exclusion_Object => 'Advanced_Mutual_Exclusion_Object', + getid3_asf::Bandwidth_Sharing_Object => 'Bandwidth_Sharing_Object', + getid3_asf::Reserved_1 => 'Reserved_1', + getid3_asf::Bandwidth_Sharing_Exclusive => 'Bandwidth_Sharing_Exclusive', + getid3_asf::Bandwidth_Sharing_Partial => 'Bandwidth_Sharing_Partial', + getid3_asf::JFIF_Media => 'JFIF_Media', + getid3_asf::Stream_Properties_Object => 'Stream_Properties_Object', + getid3_asf::Video_Media => 'Video_Media', + getid3_asf::Audio_Spread => 'Audio_Spread', + getid3_asf::Metadata_Object => 'Metadata_Object', + getid3_asf::Payload_Ext_Syst_Sample_Duration => 'Payload_Ext_Syst_Sample_Duration', + getid3_asf::Group_Mutual_Exclusion_Object => 'Group_Mutual_Exclusion_Object', + getid3_asf::Extended_Content_Description_Object => 'Extended_Content_Description_Object', + getid3_asf::Stream_Prioritization_Object => 'Stream_Prioritization_Object', + getid3_asf::Payload_Ext_System_Content_Type => 'Payload_Ext_System_Content_Type', + getid3_asf::Old_File_Properties_Object => 'Old_File_Properties_Object', + getid3_asf::Old_ASF_Header_Object => 'Old_ASF_Header_Object', + getid3_asf::Old_ASF_Data_Object => 'Old_ASF_Data_Object', + getid3_asf::Index_Object => 'Index_Object', + getid3_asf::Old_Stream_Properties_Object => 'Old_Stream_Properties_Object', + getid3_asf::Old_Content_Description_Object => 'Old_Content_Description_Object', + getid3_asf::Old_Script_Command_Object => 'Old_Script_Command_Object', + getid3_asf::Old_Marker_Object => 'Old_Marker_Object', + getid3_asf::Old_Component_Download_Object => 'Old_Component_Download_Object', + getid3_asf::Old_Stream_Group_Object => 'Old_Stream_Group_Object', + getid3_asf::Old_Scalable_Object => 'Old_Scalable_Object', + getid3_asf::Old_Prioritization_Object => 'Old_Prioritization_Object', + getid3_asf::Bitrate_Mutual_Exclusion_Object => 'Bitrate_Mutual_Exclusion_Object', + getid3_asf::Old_Inter_Media_Dependency_Object => 'Old_Inter_Media_Dependency_Object', + getid3_asf::Old_Rating_Object => 'Old_Rating_Object', + getid3_asf::Index_Parameters_Object => 'Index_Parameters_Object', + getid3_asf::Old_Color_Table_Object => 'Old_Color_Table_Object', + getid3_asf::Old_Language_List_Object => 'Old_Language_List_Object', + getid3_asf::Old_Audio_Media => 'Old_Audio_Media', + getid3_asf::Old_Video_Media => 'Old_Video_Media', + getid3_asf::Old_Image_Media => 'Old_Image_Media', + getid3_asf::Old_Timecode_Media => 'Old_Timecode_Media', + getid3_asf::Old_Text_Media => 'Old_Text_Media', + getid3_asf::Old_MIDI_Media => 'Old_MIDI_Media', + getid3_asf::Old_Command_Media => 'Old_Command_Media', + getid3_asf::Old_No_Error_Concealment => 'Old_No_Error_Concealment', + getid3_asf::Old_Scrambled_Audio => 'Old_Scrambled_Audio', + getid3_asf::Old_No_Color_Table => 'Old_No_Color_Table', + getid3_asf::Old_SMPTE_Time => 'Old_SMPTE_Time', + getid3_asf::Old_ASCII_Text => 'Old_ASCII_Text', + getid3_asf::Old_Unicode_Text => 'Old_Unicode_Text', + getid3_asf::Old_HTML_Text => 'Old_HTML_Text', + getid3_asf::Old_URL_Command => 'Old_URL_Command', + getid3_asf::Old_Filename_Command => 'Old_Filename_Command', + getid3_asf::Old_ACM_Codec => 'Old_ACM_Codec', + getid3_asf::Old_VCM_Codec => 'Old_VCM_Codec', + getid3_asf::Old_QuickTime_Codec => 'Old_QuickTime_Codec', + getid3_asf::Old_DirectShow_Transform_Filter => 'Old_DirectShow_Transform_Filter', + getid3_asf::Old_DirectShow_Rendering_Filter => 'Old_DirectShow_Rendering_Filter', + getid3_asf::Old_No_Enhancement => 'Old_No_Enhancement', + getid3_asf::Old_Unknown_Enhancement_Type => 'Old_Unknown_Enhancement_Type', + getid3_asf::Old_Temporal_Enhancement => 'Old_Temporal_Enhancement', + getid3_asf::Old_Spatial_Enhancement => 'Old_Spatial_Enhancement', + getid3_asf::Old_Quality_Enhancement => 'Old_Quality_Enhancement', + getid3_asf::Old_Number_of_Channels_Enhancement => 'Old_Number_of_Channels_Enhancement', + getid3_asf::Old_Frequency_Response_Enhancement => 'Old_Frequency_Response_Enhancement', + getid3_asf::Old_Media_Object => 'Old_Media_Object', + getid3_asf::Mutex_Language => 'Mutex_Language', + getid3_asf::Mutex_Bitrate => 'Mutex_Bitrate', + getid3_asf::Mutex_Unknown => 'Mutex_Unknown', + getid3_asf::Old_ASF_Placeholder_Object => 'Old_ASF_Placeholder_Object', + getid3_asf::Old_Data_Unit_Extension_Object => 'Old_Data_Unit_Extension_Object', + getid3_asf::Web_Stream_Format => 'Web_Stream_Format', + getid3_asf::Payload_Ext_System_File_Name => 'Payload_Ext_System_File_Name', + getid3_asf::Marker_Object => 'Marker_Object', + getid3_asf::Timecode_Index_Parameters_Object => 'Timecode_Index_Parameters_Object', + getid3_asf::Audio_Media => 'Audio_Media', + getid3_asf::Media_Object_Index_Object => 'Media_Object_Index_Object', + getid3_asf::Alt_Extended_Content_Encryption_Obj => 'Alt_Extended_Content_Encryption_Obj' + ); + + return @$lookup[$guid_string]; + } + + + + public static function ASFIndexObjectIndexTypeLookup($id) { + + static $lookup = array ( + 1 => 'Nearest Past Data Packet', + 2 => 'Nearest Past Media Object', + 3 => 'Nearest Past Cleanpoint' + ); + + return (isset($lookup[$id]) ? $lookup[$id] : 'invalid'); + } + + + + public static function GUIDtoBytestring($guid_string) { + + // Microsoft defines these 16-byte (128-bit) GUIDs in the strangest way: + // first 4 bytes are in little-endian order + // next 2 bytes are appended in little-endian order + // next 2 bytes are appended in little-endian order + // next 2 bytes are appended in big-endian order + // next 6 bytes are appended in big-endian order + + // AaBbCcDd-EeFf-GgHh-IiJj-KkLlMmNnOoPp is stored as this 16-byte string: + // $Dd $Cc $Bb $Aa $Ff $Ee $Hh $Gg $Ii $Jj $Kk $Ll $Mm $Nn $Oo $Pp + + $hex_byte_char_string = chr(hexdec(substr($guid_string, 6, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 4, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 2, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 0, 2))); + + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 11, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 9, 2))); + + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 16, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 14, 2))); + + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 19, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 21, 2))); + + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 24, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 26, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 28, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 30, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 32, 2))); + $hex_byte_char_string .= chr(hexdec(substr($guid_string, 34, 2))); + + return $hex_byte_char_string; + } + + + + public static function BytestringToGUID($byte_string) { + + $guid_string = str_pad(dechex(ord($byte_string{3})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{2})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{1})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{0})), 2, '0', STR_PAD_LEFT); + $guid_string .= '-'; + $guid_string .= str_pad(dechex(ord($byte_string{5})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{4})), 2, '0', STR_PAD_LEFT); + $guid_string .= '-'; + $guid_string .= str_pad(dechex(ord($byte_string{7})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{6})), 2, '0', STR_PAD_LEFT); + $guid_string .= '-'; + $guid_string .= str_pad(dechex(ord($byte_string{8})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{9})), 2, '0', STR_PAD_LEFT); + $guid_string .= '-'; + $guid_string .= str_pad(dechex(ord($byte_string{10})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{11})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{12})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{13})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{14})), 2, '0', STR_PAD_LEFT); + $guid_string .= str_pad(dechex(ord($byte_string{15})), 2, '0', STR_PAD_LEFT); + + return strtoupper($guid_string); + } + + + + public static function FiletimeToUNIXtime($file_time, $round=true) { + + // FILETIME is a 64-bit unsigned integer representing + // the number of 100-nanosecond intervals since January 1, 1601 + // UNIX timestamp is number of seconds since January 1, 1970 + // 116444736000000000 = 10000000 * 60 * 60 * 24 * 365 * 369 + 89 leap days + + $time = ($file_time - 116444736000000000) / 10000000; + + if ($round) { + return intval(round($time)); + } + + return $time; + } + + + + public static function TrimTerm($string) { + + // remove terminator, only if present (it should be, but...) + if (substr($string, -2) == "\x00\x00") { + $string = substr($string, 0, -2); + } + return $string; + } + + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.flv.php b/modules/getid3/module.audio-video.flv.php new file mode 100644 index 00000000..669122cf --- /dev/null +++ b/modules/getid3/module.audio-video.flv.php @@ -0,0 +1,574 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.archive.gzip.php | +// | module for analyzing GZIP files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// | FLV module by Seth Kaufman | +// | | +// | * version 0.1 (26 June 2005) | +// | | +// | minor modifications by James Heinrich | +// | * version 0.1.1 (15 July 2005) | +// | | +// | Support for On2 VP6 codec and meta information by | +// | Steve Webster | +// | * version 0.2 (22 February 2006) | +// | | +// | Modified to not read entire file into memory | +// | by James Heinrich | +// | * version 0.3 (15 June 2006) | +// | | +// | Modifications by Allan Hansen | +// | Adapted module for PHP5 and getID3 2.0.0. | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.flv.php,v 1.7 2006/11/10 11:20:12 ah Exp $ + + + +class getid3_flv extends getid3_handler +{ + + const TAG_AUDIO = 8; + const TAG_VIDEO = 9; + const TAG_META = 18; + + const VIDEO_H263 = 2; + const VIDEO_SCREEN = 3; + const VIDEO_VP6 = 4; + + + public function Analyze() + { + $info = &$this->getid3->info; + + $info['flv'] = array (); + $info_flv = &$info['flv']; + + fseek($this->getid3->fp, $info['avdataoffset'], SEEK_SET); + + $flv_data_length = $info['avdataend'] - $info['avdataoffset']; + $flv_header = fread($this->getid3->fp, 5); + + $info['fileformat'] = 'flv'; + $info_flv['header']['signature'] = substr($flv_header, 0, 3); + $info_flv['header']['version'] = getid3_lib::BigEndian2Int(substr($flv_header, 3, 1)); + $type_flags = getid3_lib::BigEndian2Int(substr($flv_header, 4, 1)); + + $info_flv['header']['hasAudio'] = (bool) ($type_flags & 0x04); + $info_flv['header']['hasVideo'] = (bool) ($type_flags & 0x01); + + $frame_size_data_length = getid3_lib::BigEndian2Int(fread($this->getid3->fp, 4)); + $flv_header_frame_length = 9; + if ($frame_size_data_length > $flv_header_frame_length) { + fseek($this->getid3->fp, $frame_size_data_length - $flv_header_frame_length, SEEK_CUR); + } + + $duration = 0; + while ((ftell($this->getid3->fp) + 1) < $info['avdataend']) { + + $this_tag_header = fread($this->getid3->fp, 16); + + $previous_tag_length = getid3_lib::BigEndian2Int(substr($this_tag_header, 0, 4)); + $tag_type = getid3_lib::BigEndian2Int(substr($this_tag_header, 4, 1)); + $data_length = getid3_lib::BigEndian2Int(substr($this_tag_header, 5, 3)); + $timestamp = getid3_lib::BigEndian2Int(substr($this_tag_header, 8, 3)); + $last_header_byte = getid3_lib::BigEndian2Int(substr($this_tag_header, 15, 1)); + $next_offset = ftell($this->getid3->fp) - 1 + $data_length; + + switch ($tag_type) { + + case getid3_flv::TAG_AUDIO: + if (!isset($info_flv['audio']['audioFormat'])) { + $info_flv['audio']['audioFormat'] = $last_header_byte & 0x07; + $info_flv['audio']['audioRate'] = ($last_header_byte & 0x30) / 0x10; + $info_flv['audio']['audioSampleSize'] = ($last_header_byte & 0x40) / 0x40; + $info_flv['audio']['audioType'] = ($last_header_byte & 0x80) / 0x80; + } + break; + + + case getid3_flv::TAG_VIDEO: + if (!isset($info_flv['video']['videoCodec'])) { + $info_flv['video']['videoCodec'] = $last_header_byte & 0x07; + + $flv_video_header = fread($this->getid3->fp, 11); + + if ($info_flv['video']['videoCodec'] != getid3_flv::VIDEO_VP6) { + + $picture_size_type = (getid3_lib::BigEndian2Int(substr($flv_video_header, 3, 2))) >> 7; + $picture_size_type = $picture_size_type & 0x0007; + $info_flv['header']['videoSizeType'] = $picture_size_type; + + switch ($picture_size_type) { + case 0: + $picture_size_enc = getid3_lib::BigEndian2Int(substr($flv_video_header, 5, 2)); + $picture_size_enc <<= 1; + $info['video']['resolution_x'] = ($picture_size_enc & 0xFF00) >> 8; + $picture_size_enc = getid3_lib::BigEndian2Int(substr($flv_video_header, 6, 2)); + $picture_size_enc <<= 1; + $info['video']['resolution_y'] = ($picture_size_enc & 0xFF00) >> 8; + break; + + case 1: + $picture_size_enc = getid3_lib::BigEndian2Int(substr($flv_video_header, 5, 4)); + $picture_size_enc <<= 1; + $info['video']['resolution_x'] = ($picture_size_enc & 0xFFFF0000) >> 16; + + $picture_size_enc = getid3_lib::BigEndian2Int(substr($flv_video_header, 7, 4)); + $picture_size_enc <<= 1; + $info['video']['resolution_y'] = ($picture_size_enc & 0xFFFF0000) >> 16; + break; + + case 2: + $info['video']['resolution_x'] = 352; + $info['video']['resolution_y'] = 288; + break; + + case 3: + $info['video']['resolution_x'] = 176; + $info['video']['resolution_y'] = 144; + break; + + case 4: + $info['video']['resolution_x'] = 128; + $info['video']['resolution_y'] = 96; + break; + + case 5: + $info['video']['resolution_x'] = 320; + $info['video']['resolution_y'] = 240; + break; + + case 6: + $info['video']['resolution_x'] = 160; + $info['video']['resolution_y'] = 120; + break; + + default: + $info['video']['resolution_x'] = 0; + $info['video']['resolution_y'] = 0; + break; + } + } + } + break; + + + // Meta tag + case getid3_flv::TAG_META: + + fseek($this->getid3->fp, -1, SEEK_CUR); + $reader = new AMFReader(new AMFStream(fread($this->getid3->fp, $data_length))); + $event_name = $reader->readData(); + $info['meta'][$event_name] = $reader->readData(); + unset($reader); + + $info['video']['frame_rate'] = @$info['meta']['onMetaData']['framerate']; + $info['video']['resolution_x'] = @$info['meta']['onMetaData']['width']; + $info['video']['resolution_y'] = @$info['meta']['onMetaData']['height']; + break; + + default: + // noop + break; + } + + if ($timestamp > $duration) { + $duration = $timestamp; + } + + fseek($this->getid3->fp, $next_offset, SEEK_SET); + } + + if ($info['playtime_seconds'] = $duration / 1000) { + $info['bitrate'] = ($info['avdataend'] - $info['avdataoffset']) / $info['playtime_seconds']; + } + + if ($info_flv['header']['hasAudio']) { + $info['audio']['codec'] = $this->FLVaudioFormat($info_flv['audio']['audioFormat']); + $info['audio']['sample_rate'] = $this->FLVaudioRate($info_flv['audio']['audioRate']); + $info['audio']['bits_per_sample'] = $this->FLVaudioBitDepth($info_flv['audio']['audioSampleSize']); + + $info['audio']['channels'] = $info_flv['audio']['audioType'] + 1; // 0=mono,1=stereo + $info['audio']['lossless'] = ($info_flv['audio']['audioFormat'] ? false : true); // 0=uncompressed + $info['audio']['dataformat'] = 'flv'; + } + if (@$info_flv['header']['hasVideo']) { + $info['video']['codec'] = $this->FLVvideoCodec($info_flv['video']['videoCodec']); + $info['video']['dataformat'] = 'flv'; + $info['video']['lossless'] = false; + } + + return true; + } + + + public static function FLVaudioFormat($id) { + + static $lookup = array( + 0 => 'uncompressed', + 1 => 'ADPCM', + 2 => 'mp3', + 5 => 'Nellymoser 8kHz mono', + 6 => 'Nellymoser', + ); + return (@$lookup[$id] ? @$lookup[$id] : false); + } + + + public static function FLVaudioRate($id) { + + static $lookup = array( + 0 => 5500, + 1 => 11025, + 2 => 22050, + 3 => 44100, + ); + return (@$lookup[$id] ? @$lookup[$id] : false); + } + + + public static function FLVaudioBitDepth($id) { + + static $lookup = array( + 0 => 8, + 1 => 16, + ); + return (@$lookup[$id] ? @$lookup[$id] : false); + } + + + public static function FLVvideoCodec($id) { + + static $lookup = array( + getid3_flv::VIDEO_H263 => 'Sorenson H.263', + getid3_flv::VIDEO_SCREEN => 'Screen video', + getid3_flv::VIDEO_VP6 => 'On2 VP6', + ); + return (@$lookup[$id] ? @$lookup[$id] : false); + } +} + + + +class AMFStream +{ + public $bytes; + public $pos; + + + public function AMFStream($bytes) { + + $this->bytes = $bytes; + $this->pos = 0; + } + + + public function readByte() { + + return getid3_lib::BigEndian2Int(substr($this->bytes, $this->pos++, 1)); + } + + + public function readInt() { + + return ($this->readByte() << 8) + $this->readByte(); + } + + + public function readLong() { + + return ($this->readByte() << 24) + ($this->readByte() << 16) + ($this->readByte() << 8) + $this->readByte(); + } + + + public function readDouble() { + + return getid3_lib::BigEndian2Float($this->read(8)); + } + + + public function readUTF() { + + $length = $this->readInt(); + return $this->read($length); + } + + + public function readLongUTF() { + + $length = $this->readLong(); + return $this->read($length); + } + + + public function read($length) { + + $val = substr($this->bytes, $this->pos, $length); + $this->pos += $length; + return $val; + } + + + public function peekByte() { + + $pos = $this->pos; + $val = $this->readByte(); + $this->pos = $pos; + return $val; + } + + + public function peekInt() { + + $pos = $this->pos; + $val = $this->readInt(); + $this->pos = $pos; + return $val; + } + + + public function peekLong() { + + $pos = $this->pos; + $val = $this->readLong(); + $this->pos = $pos; + return $val; + } + + + public function peekDouble() { + + $pos = $this->pos; + $val = $this->readDouble(); + $this->pos = $pos; + return $val; + } + + + public function peekUTF() { + + $pos = $this->pos; + $val = $this->readUTF(); + $this->pos = $pos; + return $val; + } + + + public function peekLongUTF() { + + $pos = $this->pos; + $val = $this->readLongUTF(); + $this->pos = $pos; + return $val; + } +} + + + +class AMFReader +{ + public $stream; + + public function __construct($stream) { + + $this->stream = $stream; + } + + + public function readData() { + + $value = null; + + $type = $this->stream->readByte(); + + switch($type) { + // Double + case 0: + $value = $this->readDouble(); + break; + + // Boolean + case 1: + $value = $this->readBoolean(); + break; + + // String + case 2: + $value = $this->readString(); + break; + + // Object + case 3: + $value = $this->readObject(); + break; + + // null + case 6: + return null; + break; + + // Mixed array + case 8: + $value = $this->readMixedArray(); + break; + + // Array + case 10: + $value = $this->readArray(); + break; + + // Date + case 11: + $value = $this->readDate(); + break; + + // Long string + case 13: + $value = $this->readLongString(); + break; + + // XML (handled as string) + case 15: + $value = $this->readXML(); + break; + + // Typed object (handled as object) + case 16: + $value = $this->readTypedObject(); + break; + + // Long string + default: + $value = '(unknown or unsupported data type)'; + break; + } + + return $value; + } + + + public function readDouble() { + + return $this->stream->readDouble(); + } + + + public function readBoolean() { + + return $this->stream->readByte() == 1; + } + + + public function readString() { + + return $this->stream->readUTF(); + } + + + public function readObject() { + + // Get highest numerical index - ignored + $highestIndex = $this->stream->readLong(); + + $data = array(); + + while ($key = $this->stream->readUTF()) { + // Mixed array record ends with empty string (0x00 0x00) and 0x09 + if (($key == '') && ($this->stream->peekByte() == 0x09)) { + // Consume byte + $this->stream->readByte(); + break; + } + + $data[$key] = $this->readData(); + } + + return $data; + } + + + public function readMixedArray() { + + // Get highest numerical index - ignored + $highestIndex = $this->stream->readLong(); + + $data = array(); + + while ($key = $this->stream->readUTF()) { + // Mixed array record ends with empty string (0x00 0x00) and 0x09 + if (($key == '') && ($this->stream->peekByte() == 0x09)) { + // Consume byte + $this->stream->readByte(); + break; + } + + if (is_numeric($key)) { + $key = (float) $key; + } + + $data[$key] = $this->readData(); + } + + return $data; + } + + + public function readArray() { + + $length = $this->stream->readLong(); + + $data = array(); + + for ($i = 0; $i < count($length); $i++) { + $data[] = $this->readData(); + } + + return $data; + } + + + public function readDate() { + + $timestamp = $this->stream->readDouble(); + $timezone = $this->stream->readInt(); + return $timestamp; + } + + + public function readLongString() { + + return $this->stream->readLongUTF(); + } + + + public function readXML() { + + return $this->stream->readLongUTF(); + } + + + public function readTypedObject() { + + $className = $this->stream->readUTF(); + return $this->readObject(); + } +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.mpeg.php b/modules/getid3/module.audio-video.mpeg.php new file mode 100644 index 00000000..bab3f321 --- /dev/null +++ b/modules/getid3/module.audio-video.mpeg.php @@ -0,0 +1,324 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio-video.mpeg.php | +// | Module for analyzing MPEG files | +// | dependencies: module.audio.mp3.php | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.mpeg.php,v 1.3 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_mpeg extends getid3_handler +{ + + const VIDEO_PICTURE_START = "\x00\x00\x01\x00"; + const VIDEO_USER_DATA_START = "\x00\x00\x01\xB2"; + const VIDEO_SEQUENCE_HEADER = "\x00\x00\x01\xB3"; + const VIDEO_SEQUENCE_ERROR = "\x00\x00\x01\xB4"; + const VIDEO_EXTENSION_START = "\x00\x00\x01\xB5"; + const VIDEO_SEQUENCE_END = "\x00\x00\x01\xB7"; + const VIDEO_GROUP_START = "\x00\x00\x01\xB8"; + const AUDIO_START = "\x00\x00\x01\xC0"; + + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['mpeg']['video']['raw'] = array (); + $info_mpeg_video = &$getid3->info['mpeg']['video']; + $info_mpeg_video_raw = &$info_mpeg_video['raw']; + + $getid3->info['video'] = array (); + $info_video = &$getid3->info['video']; + + $getid3->include_module('audio.mp3'); + + if ($getid3->info['avdataend'] <= $getid3->info['avdataoffset']) { + throw new getid3_exception('"avdataend" ('.$getid3->info['avdataend'].') is unexpectedly less-than-or-equal-to "avdataoffset" ('.$getid3->info['avdataoffset'].')'); + } + + $getid3->info['fileformat'] = 'mpeg'; + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $mpeg_stream_data = fread($getid3->fp, min(100000, $getid3->info['avdataend'] - $getid3->info['avdataoffset'])); + $mpeg_stream_data_length = strlen($mpeg_stream_data); + + $video_chunk_offset = 0; + while (substr($mpeg_stream_data, $video_chunk_offset++, 4) !== getid3_mpeg::VIDEO_SEQUENCE_HEADER) { + if ($video_chunk_offset >= $mpeg_stream_data_length) { + throw new getid3_exception('Could not find start of video block in the first 100,000 bytes (or before end of file) - this might not be an MPEG-video file?'); + } + } + + // Start code 32 bits + // horizontal frame size 12 bits + // vertical frame size 12 bits + // pixel aspect ratio 4 bits + // frame rate 4 bits + // bitrate 18 bits + // marker bit 1 bit + // VBV buffer size 10 bits + // constrained parameter flag 1 bit + // intra quant. matrix flag 1 bit + // intra quant. matrix values 512 bits (present if matrix flag == 1) + // non-intra quant. matrix flag 1 bit + // non-intra quant. matrix values 512 bits (present if matrix flag == 1) + + $info_video['dataformat'] = 'mpeg'; + + $video_chunk_offset += (strlen(getid3_mpeg::VIDEO_SEQUENCE_HEADER) - 1); + + $frame_size_dword = getid3_lib::BigEndian2Int(substr($mpeg_stream_data, $video_chunk_offset, 3)); + $video_chunk_offset += 3; + + $aspect_ratio_frame_rate_dword = getid3_lib::BigEndian2Int(substr($mpeg_stream_data, $video_chunk_offset, 1)); + $video_chunk_offset += 1; + + $assorted_information = getid3_lib::BigEndian2Bin(substr($mpeg_stream_data, $video_chunk_offset, 4)); + $video_chunk_offset += 4; + + $info_mpeg_video_raw['framesize_horizontal'] = ($frame_size_dword & 0xFFF000) >> 12; // 12 bits for horizontal frame size + $info_mpeg_video_raw['framesize_vertical'] = ($frame_size_dword & 0x000FFF); // 12 bits for vertical frame size + $info_mpeg_video_raw['pixel_aspect_ratio'] = ($aspect_ratio_frame_rate_dword & 0xF0) >> 4; + $info_mpeg_video_raw['frame_rate'] = ($aspect_ratio_frame_rate_dword & 0x0F); + + $info_mpeg_video['framesize_horizontal'] = $info_mpeg_video_raw['framesize_horizontal']; + $info_mpeg_video['framesize_vertical'] = $info_mpeg_video_raw['framesize_vertical']; + + $info_mpeg_video['pixel_aspect_ratio'] = $this->MPEGvideoAspectRatioLookup($info_mpeg_video_raw['pixel_aspect_ratio']); + $info_mpeg_video['pixel_aspect_ratio_text'] = $this->MPEGvideoAspectRatioTextLookup($info_mpeg_video_raw['pixel_aspect_ratio']); + $info_mpeg_video['frame_rate'] = $this->MPEGvideoFramerateLookup($info_mpeg_video_raw['frame_rate']); + + $info_mpeg_video_raw['bitrate'] = bindec(substr($assorted_information, 0, 18)); + $info_mpeg_video_raw['marker_bit'] = (bool)bindec($assorted_information{18}); + $info_mpeg_video_raw['vbv_buffer_size'] = bindec(substr($assorted_information, 19, 10)); + $info_mpeg_video_raw['constrained_param_flag'] = (bool)bindec($assorted_information{29}); + $info_mpeg_video_raw['intra_quant_flag'] = (bool)bindec($assorted_information{30}); + + if ($info_mpeg_video_raw['intra_quant_flag']) { + + // read 512 bits + $info_mpeg_video_raw['intra_quant'] = getid3_lib::BigEndian2Bin(substr($mpeg_stream_data, $video_chunk_offset, 64)); + $video_chunk_offset += 64; + + $info_mpeg_video_raw['non_intra_quant_flag'] = (bool)bindec($info_mpeg_video_raw['intra_quant']{511}); + $info_mpeg_video_raw['intra_quant'] = bindec($assorted_information{31}).substr(getid3_lib::BigEndian2Bin(substr($mpeg_stream_data, $video_chunk_offset, 64)), 0, 511); + + if ($info_mpeg_video_raw['non_intra_quant_flag']) { + $info_mpeg_video_raw['non_intra_quant'] = substr($mpeg_stream_data, $video_chunk_offset, 64); + $video_chunk_offset += 64; + } + + } else { + + $info_mpeg_video_raw['non_intra_quant_flag'] = (bool)bindec($assorted_information{31}); + if ($info_mpeg_video_raw['non_intra_quant_flag']) { + $info_mpeg_video_raw['non_intra_quant'] = substr($mpeg_stream_data, $video_chunk_offset, 64); + $video_chunk_offset += 64; + } + } + + if ($info_mpeg_video_raw['bitrate'] == 0x3FFFF) { // 18 set bits + + $getid3->warning('This version of getID3() cannot determine average bitrate of VBR MPEG video files'); + $info_mpeg_video['bitrate_mode'] = 'vbr'; + + } else { + + $info_mpeg_video['bitrate'] = $info_mpeg_video_raw['bitrate'] * 400; + $info_mpeg_video['bitrate_mode'] = 'cbr'; + $info_video['bitrate'] = $info_mpeg_video['bitrate']; + } + + $info_video['resolution_x'] = $info_mpeg_video['framesize_horizontal']; + $info_video['resolution_y'] = $info_mpeg_video['framesize_vertical']; + $info_video['frame_rate'] = $info_mpeg_video['frame_rate']; + $info_video['bitrate_mode'] = $info_mpeg_video['bitrate_mode']; + $info_video['pixel_aspect_ratio'] = $info_mpeg_video['pixel_aspect_ratio']; + $info_video['lossless'] = false; + $info_video['bits_per_sample'] = 24; + + + //0x000001B3 begins the sequence_header of every MPEG video stream. + //But in MPEG-2, this header must immediately be followed by an + //extension_start_code (0x000001B5) with a sequence_extension ID (1). + //(This extension contains all the additional MPEG-2 stuff.) + //MPEG-1 doesn't have this extension, so that's a sure way to tell the + //difference between MPEG-1 and MPEG-2 video streams. + + $info_video['codec'] = substr($mpeg_stream_data, $video_chunk_offset, 4) == getid3_mpeg::VIDEO_EXTENSION_START ? 'MPEG-2' : 'MPEG-1'; + + $audio_chunk_offset = 0; + while (true) { + while (substr($mpeg_stream_data, $audio_chunk_offset++, 4) !== getid3_mpeg::AUDIO_START) { + if ($audio_chunk_offset >= $mpeg_stream_data_length) { + break 2; + } + } + + for ($i = 0; $i <= 7; $i++) { + // some files have the MPEG-audio header 8 bytes after the end of the $00 $00 $01 $C0 signature, some have it up to 13 bytes (or more?) after + // I have no idea why or what the difference is, so this is a stupid hack. + // If anybody has any better idea of what's going on, please let me know - info@getid3.org + + // make copy of info + $dummy = $getid3->info; + + // clone getid3 - better safe than sorry + $clone = clone $this->getid3; + + // check + $mp3 = new getid3_mp3($clone); + if ($mp3->decodeMPEGaudioHeader($getid3->fp, ($audio_chunk_offset + 3) + 8 + $i, $dummy, false)) { + + $getid3->info = $dummy; + $getid3->info['audio']['bitrate_mode'] = 'cbr'; + $getid3->info['audio']['lossless'] = false; + break 2; + } + + // destroy copy + unset($dummy); + } + } + + // Temporary hack to account for interleaving overhead: + if (!empty($info_video['bitrate']) && !empty($getid3->info['audio']['bitrate'])) { + $getid3->info['playtime_seconds'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / ($info_video['bitrate'] + $getid3->info['audio']['bitrate']); + + // Interleaved MPEG audio/video files have a certain amount of overhead that varies + // by both video and audio bitrates, and not in any sensible, linear/logarithmic patter + // Use interpolated lookup tables to approximately guess how much is overhead, because + // playtime is calculated as filesize / total-bitrate + $getid3->info['playtime_seconds'] *= $this->MPEGsystemNonOverheadPercentage($info_video['bitrate'], $getid3->info['audio']['bitrate']); + + //switch ($info_video['bitrate']) { + // case('5000000'): + // $multiplier = 0.93292642112380355828048824319889; + // break; + // case('5500000'): + // $multiplier = 0.93582895375200989965359777343219; + // break; + // case('6000000'): + // $multiplier = 0.93796247714820932532911373859139; + // break; + // case('7000000'): + // $multiplier = 0.9413264083635103463010117778776; + // break; + // default: + // $multiplier = 1; + // break; + //} + //$getid3->info['playtime_seconds'] *= $multiplier; + //$getid3->warning('Interleaved MPEG audio/video playtime may be inaccurate. With current hack should be within a few seconds of accurate. Report to info@getid3.org if off by more than 10 seconds.'); + + if ($info_video['bitrate'] < 50000) { + $getid3->warning('Interleaved MPEG audio/video playtime may be slightly inaccurate for video bitrates below 100kbps. Except in extreme low-bitrate situations, error should be less than 1%. Report to info@getid3.org if greater than this.'); + } + } + + return true; + } + + + + public static function MPEGsystemNonOverheadPercentage($video_bitrate, $audio_bitrate) { + + $overhead_percentage = 0; + + $audio_bitrate = max(min($audio_bitrate / 1000, 384), 32); // limit to range of 32kbps - 384kbps (should be only legal bitrates, but maybe VBR?) + $video_bitrate = max(min($video_bitrate / 1000, 10000), 10); // limit to range of 10kbps - 10Mbps (beyond that curves flatten anyways, no big loss) + + //OMBB[audiobitrate] = array ( video-10kbps, video-100kbps, video-1000kbps, video-10000kbps) + static $overhead_multiplier_by_bitrate = array ( + 32 => array (0, 0.9676287944368530, 0.9802276264360310, 0.9844916183244460, 0.9852821845179940), + 48 => array (0, 0.9779100089209830, 0.9787770035359320, 0.9846738664076130, 0.9852683013799960), + 56 => array (0, 0.9731249855367600, 0.9776624308938040, 0.9832606361852130, 0.9843922606633340), + 64 => array (0, 0.9755642683275760, 0.9795256705493390, 0.9836573009193170, 0.9851122539404470), + 96 => array (0, 0.9788025247497290, 0.9798553314148700, 0.9822956869792560, 0.9834815119124690), + 128 => array (0, 0.9816940050925480, 0.9821675936072120, 0.9829756927470870, 0.9839763420152050), + 160 => array (0, 0.9825894094561180, 0.9820913399073960, 0.9823907143253970, 0.9832821783651570), + 192 => array (0, 0.9832038474336260, 0.9825731694317960, 0.9821028622712400, 0.9828262076447620), + 224 => array (0, 0.9836516298538770, 0.9824718601823890, 0.9818302180625380, 0.9823735101626480), + 256 => array (0, 0.9845863022094920, 0.9837229411967540, 0.9824521662210830, 0.9828645172100790), + 320 => array (0, 0.9849565280263180, 0.9837683142805110, 0.9822885275960400, 0.9824424382727190), + 384 => array (0, 0.9856094774357600, 0.9844573394432720, 0.9825970399837330, 0.9824673808303890) + ); + + $bitrate_to_use_min = $bitrate_to_use_max = $previous_bitrate = 32; + + foreach ($overhead_multiplier_by_bitrate as $key => $value) { + + if ($audio_bitrate >= $previous_bitrate) { + $bitrate_to_use_min = $previous_bitrate; + } + if ($audio_bitrate < $key) { + $bitrate_to_use_max = $key; + break; + } + $previous_bitrate = $key; + } + + $factor_a = ($bitrate_to_use_max - $audio_bitrate) / ($bitrate_to_use_max - $bitrate_to_use_min); + + $video_bitrate_log10 = log10($video_bitrate); + $video_factor_min1 = $overhead_multiplier_by_bitrate[$bitrate_to_use_min][floor($video_bitrate_log10)]; + $video_factor_min2 = $overhead_multiplier_by_bitrate[$bitrate_to_use_max][floor($video_bitrate_log10)]; + $video_factor_max1 = $overhead_multiplier_by_bitrate[$bitrate_to_use_min][ceil($video_bitrate_log10)]; + $video_factor_max2 = $overhead_multiplier_by_bitrate[$bitrate_to_use_max][ceil($video_bitrate_log10)]; + $factor_v = $video_bitrate_log10 - floor($video_bitrate_log10); + + $overhead_percentage = $video_factor_min1 * $factor_a * $factor_v; + $overhead_percentage += $video_factor_min2 * (1 - $factor_a) * $factor_v; + $overhead_percentage += $video_factor_max1 * $factor_a * (1 - $factor_v); + $overhead_percentage += $video_factor_max2 * (1 - $factor_a) * (1 - $factor_v); + + return $overhead_percentage; + } + + + + public static function MPEGvideoFramerateLookup($raw_frame_rate) { + + $lookup = array (0, 23.976, 24, 25, 29.97, 30, 50, 59.94, 60); + + return (float)(isset($lookup[$raw_frame_rate]) ? $lookup[$raw_frame_rate] : 0); + } + + + + public static function MPEGvideoAspectRatioLookup($raw_aspect_ratio) { + + $lookup = array (0, 1, 0.6735, 0.7031, 0.7615, 0.8055, 0.8437, 0.8935, 0.9157, 0.9815, 1.0255, 1.0695, 1.0950, 1.1575, 1.2015, 0); + + return (float)(isset($lookup[$raw_aspect_ratio]) ? $lookup[$raw_aspect_ratio] : 0); + } + + + + public static function MPEGvideoAspectRatioTextLookup($raw_aspect_ratio) { + + $lookup = array ('forbidden', 'square pixels', '0.6735', '16:9, 625 line, PAL', '0.7615', '0.8055', '16:9, 525 line, NTSC', '0.8935', '4:3, 625 line, PAL, CCIR601', '0.9815', '1.0255', '1.0695', '4:3, 525 line, NTSC, CCIR601', '1.1575', '1.2015', 'reserved'); + + return (isset($lookup[$raw_aspect_ratio]) ? $lookup[$raw_aspect_ratio] : ''); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.nsv.php b/modules/getid3/module.audio-video.nsv.php new file mode 100644 index 00000000..0ff8e75c --- /dev/null +++ b/modules/getid3/module.audio-video.nsv.php @@ -0,0 +1,210 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio-video.nsv.php | +// | module for analyzing Nullsoft NSV files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.nsv.php,v 1.3 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_nsv extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'nsv'; + $getid3->info['audio']['dataformat'] = 'nsv'; + $getid3->info['video']['dataformat'] = 'nsv'; + $getid3->info['audio']['lossless'] = false; + $getid3->info['video']['lossless'] = false; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $nsv_header = fread($getid3->fp, 4); + + switch ($nsv_header) { + + case 'NSVs': + $this->getNSVsHeader(); + break; + + case 'NSVf': + if ($this->getNSVfHeader()) { + $this->getNSVsHeader($getid3->info['nsv']['NSVf']['header_length']); + } + break; + + default: + throw new getid3_exception('Expecting "NSVs" or "NSVf" at offset '.$getid3->info['avdataoffset'].', found "'.$nsv_header.'"'); + break; + } + + if (!isset($getid3->info['nsv']['NSVf'])) { + $getid3->warning('NSVf header not present - cannot calculate playtime or bitrate'); + } + + return true; + } + + + + private function getNSVsHeader($file_offset = 0) { + + $getid3 = $this->getid3; + + fseek($getid3->fp, $file_offset, SEEK_SET); + $nsvs_header = fread($getid3->fp, 28); + + $getid3->info['nsv']['NSVs'] = array (); + $info_nsv_NSVs = &$getid3->info['nsv']['NSVs']; + + $info_nsv_NSVs['identifier'] = substr($nsvs_header, 0, 4); + if ($info_nsv_NSVs['identifier'] != 'NSVs') { + throw new getid3_exception('expected "NSVs" at offset ('.$file_offset.'), found "'.$info_nsv_NSVs['identifier'].'" instead'); + } + + $info_nsv_NSVs['offset'] = $file_offset; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_nsv_NSVs, $nsvs_header, 4, + array ( + 'video_codec' => -4, // string + 'audio_codec' => -4, // string + 'resolution_x' => 2, + 'resolution_y' => 2, + 'framerate_index' => 1, + ) + ); + + if ($info_nsv_NSVs['audio_codec'] == 'PCM ') { + + getid3_lib::ReadSequence('LittleEndian2Int', $info_nsv_NSVs, $nsvs_header, 24, + array ( + 'bits_channel' => 1, + 'channels' => 1, + 'sample_rate' => 2 + ) + ); + $getid3->info['audio']['sample_rate'] = $info_nsv_NSVs['sample_rate']; + + } + + $getid3->info['video']['resolution_x'] = $info_nsv_NSVs['resolution_x']; + $getid3->info['video']['resolution_y'] = $info_nsv_NSVs['resolution_y']; + $info_nsv_NSVs['frame_rate'] = getid3_nsv::NSVframerateLookup($info_nsv_NSVs['framerate_index']); + $getid3->info['video']['frame_rate'] = $info_nsv_NSVs['frame_rate']; + $getid3->info['video']['bits_per_sample'] = 24; + $getid3->info['video']['pixel_aspect_ratio'] = (float)1; + + return true; + } + + + + private function getNSVfHeader($file_offset = 0, $get_toc_offsets=false) { + + $getid3 = $this->getid3; + + fseek($getid3->fp, $file_offset, SEEK_SET); + $nsvf_header = fread($getid3->fp, 28); + + $getid3->info['nsv']['NSVf'] = array (); + $info_nsv_NSVf = &$getid3->info['nsv']['NSVf']; + + $info_nsv_NSVf['identifier'] = substr($nsvf_header, 0, 4); + if ($info_nsv_NSVf['identifier'] != 'NSVf') { + throw new getid3_exception('expected "NSVf" at offset ('.$file_offset.'), found "'.$info_nsv_NSVf['identifier'].'" instead'); + } + + $getid3->info['nsv']['NSVs']['offset'] = $file_offset; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_nsv_NSVf, $nsvf_header, 4, + array ( + 'header_length' => 4, + 'file_size' => 4, + 'playtime_ms' => 4, + 'meta_size' => 4, + 'TOC_entries_1' => 4, + 'TOC_entries_2' => 4 + ) + ); + + if ($info_nsv_NSVf['playtime_ms'] == 0) { + throw new getid3_exception('Corrupt NSV file: NSVf.playtime_ms == zero'); + } + + if ($info_nsv_NSVf['file_size'] > $getid3->info['avdataend']) { + $getid3->warning('truncated file - NSVf header indicates '.$info_nsv_NSVf['file_size'].' bytes, file actually '.$getid3->info['avdataend'].' bytes'); + } + + $nsvf_header .= fread($getid3->fp, $info_nsv_NSVf['meta_size'] + (4 * $info_nsv_NSVf['TOC_entries_1']) + (4 * $info_nsv_NSVf['TOC_entries_2'])); + $nsvf_headerlength = strlen($nsvf_header); + $info_nsv_NSVf['metadata'] = substr($nsvf_header, 28, $info_nsv_NSVf['meta_size']); + + $offset = 28 + $info_nsv_NSVf['meta_size']; + if ($get_toc_offsets) { + $toc_counter = 0; + while ($toc_counter < $info_nsv_NSVf['TOC_entries_1']) { + if ($toc_counter < $info_nsv_NSVf['TOC_entries_1']) { + $info_nsv_NSVf['TOC_1'][$toc_counter] = getid3_lib::LittleEndian2Int(substr($nsvf_header, $offset, 4)); + $offset += 4; + $toc_counter++; + } + } + } + + if (trim($info_nsv_NSVf['metadata']) != '') { + $info_nsv_NSVf['metadata'] = str_replace('`', "\x01", $info_nsv_NSVf['metadata']); + $comment_pair_array = explode("\x01".' ', $info_nsv_NSVf['metadata']); + foreach ($comment_pair_array as $comment_pair) { + if (strstr($comment_pair, '='."\x01")) { + list($key, $value) = explode('='."\x01", $comment_pair, 2); + $getid3->info['nsv']['comments'][strtolower($key)][] = trim(str_replace("\x01", '', $value)); + } + } + } + + $getid3->info['playtime_seconds'] = $info_nsv_NSVf['playtime_ms'] / 1000; + $getid3->info['bitrate'] = ($info_nsv_NSVf['file_size'] * 8) / $getid3->info['playtime_seconds']; + + return true; + } + + + + public static function NSVframerateLookup($frame_rate_index) { + + if ($frame_rate_index <= 127) { + return (float)$frame_rate_index; + } + + static $lookup = array ( + 129 => 29.970, + 131 => 23.976, + 133 => 14.985, + 197 => 59.940, + 199 => 47.952 + ); + return (isset($lookup[$frame_rate_index]) ? $lookup[$frame_rate_index] : false); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.quicktime.php b/modules/getid3/module.audio-video.quicktime.php new file mode 100644 index 00000000..559c1065 --- /dev/null +++ b/modules/getid3/module.audio-video.quicktime.php @@ -0,0 +1,1529 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio-video.quicktime.php | +// | Module for analyzing Quicktime, MP3-in-MP4 and Apple Lossless files. | +// | dependencies: module.audio.mp3.php | +// | zlib support in PHP (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.quicktime.php,v 1.7 2006/11/02 16:03:28 ah Exp $ + + + +class getid3_quicktime extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $info = &$getid3->info; + + $getid3->include_module('audio.mp3'); + + $info['quicktime'] = array (); + $info_quicktime = &$info['quicktime']; + + $info['fileformat'] = 'quicktime'; + $info_quicktime['hinting'] = false; + + fseek($getid3->fp, $info['avdataoffset'], SEEK_SET); + + $offset = $atom_counter = 0; + + while ($offset < $info['avdataend']) { + + fseek($getid3->fp, $offset, SEEK_SET); + $atom_header = fread($getid3->fp, 8); + + $atom_size = getid3_lib::BigEndian2Int(substr($atom_header, 0, 4)); + $atom_name = substr($atom_header, 4, 4); + + $info_quicktime[$atom_name]['name'] = $atom_name; + $info_quicktime[$atom_name]['size'] = $atom_size; + $info_quicktime[$atom_name]['offset'] = $offset; + + if (($offset + $atom_size) > $info['avdataend']) { + throw new getid3_exception('Atom at offset '.$offset.' claims to go beyond end-of-file (length: '.$atom_size.' bytes)'); + } + + if ($atom_size == 0) { + // Furthermore, for historical reasons the list of atoms is optionally + // terminated by a 32-bit integer set to 0. If you are writing a program + // to read user data atoms, you should allow for the terminating 0. + break; + } + + switch ($atom_name) { + + case 'mdat': // Media DATa atom + // 'mdat' contains the actual data for the audio/video + if (($atom_size > 8) && (!isset($info['avdataend_tmp']) || ($info_quicktime[$atom_name]['size'] > ($info['avdataend_tmp'] - $info['avdataoffset'])))) { + + $info['avdataoffset'] = $info_quicktime[$atom_name]['offset'] + 8; + $old_av_data_end = $info['avdataend']; + $info['avdataend'] = $info_quicktime[$atom_name]['offset'] + $info_quicktime[$atom_name]['size']; + + + //// MP3 + + if (!$getid3->include_module_optional('audio.mp3')) { + $getid3->warning('MP3 skipped because mpeg module is missing.'); + } + + else { + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + + if (getid3_mp3::MPEGaudioHeaderValid(getid3_mp3::MPEGaudioHeaderDecode(fread($clone->fp, 4)))) { + + $mp3 = new getid3_mp3($clone); + $mp3->AnalyzeMPEGaudioInfo(); + + // Import from clone and destroy + if (isset($clone->info['mpeg']['audio'])) { + + $info['mpeg']['audio'] = $clone->info['mpeg']['audio']; + + $info['audio']['dataformat'] = 'mp3'; + $info['audio']['codec'] = (!empty($info['mpeg']['audio']['encoder']) ? $info['mpeg']['audio']['encoder'] : (!empty($info['mpeg']['audio']['codec']) ? $info['mpeg']['audio']['codec'] : (!empty($info['mpeg']['audio']['LAME']) ? 'LAME' :'mp3'))); + $info['audio']['sample_rate'] = $info['mpeg']['audio']['sample_rate']; + $info['audio']['channels'] = $info['mpeg']['audio']['channels']; + $info['audio']['bitrate'] = $info['mpeg']['audio']['bitrate']; + $info['audio']['bitrate_mode'] = strtolower($info['mpeg']['audio']['bitrate_mode']); + $info['bitrate'] = $info['audio']['bitrate']; + + $getid3->warning($clone->warnings()); + unset($clone); + } + } + } + + $info['avdataend'] = $old_av_data_end; + unset($old_av_data_end); + + } + break; + + + case 'free': // FREE space atom + case 'skip': // SKIP atom + case 'wide': // 64-bit expansion placeholder atom + // 'free', 'skip' and 'wide' are just padding, contains no useful data at all + break; + + + default: + $atom_hierarchy = array (); + $info_quicktime[$atom_name] = $this->QuicktimeParseAtom($atom_name, $atom_size, fread($getid3->fp, $atom_size), $offset, $atom_hierarchy); + break; + } + + $offset += $atom_size; + $atom_counter++; + } + + if (!empty($info['avdataend_tmp'])) { + // this value is assigned to a temp value and then erased because + // otherwise any atoms beyond the 'mdat' atom would not get parsed + $info['avdataend'] = $info['avdataend_tmp']; + unset($info['avdataend_tmp']); + } + + if (!isset($info['bitrate']) && isset($info['playtime_seconds'])) { + $info['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $info['playtime_seconds']; + } + + if (isset($info['bitrate']) && !isset($info['audio']['bitrate']) && !isset($info_quicktime['video'])) { + $info['audio']['bitrate'] = $info['bitrate']; + } + + if ((@$info['audio']['dataformat'] == 'mp4') && empty($info['video']['resolution_x'])) { + $info['fileformat'] = 'mp4'; + $info['mime_type'] = 'audio/mp4'; + unset($info['video']['dataformat']); + } + + if (!$getid3->option_extra_info) { + unset($info_quicktime['moov']); + } + + if (empty($info['audio']['dataformat']) && !empty($info_quicktime['audio'])) { + $info['audio']['dataformat'] = 'quicktime'; + } + + if (empty($info['video']['dataformat']) && !empty($info_quicktime['video'])) { + $info['video']['dataformat'] = 'quicktime'; + } + + return true; + } + + + + private function QuicktimeParseAtom($atom_name, $atom_size, $atom_data, $base_offset, &$atom_hierarchy) { + + // http://developer.apple.com/techpubs/quicktime/qtdevdocs/APIREF/INDEX/atomalphaindex.htm + + $getid3 = $this->getid3; + + $info = &$getid3->info; + $info_quicktime = &$info['quicktime']; + + array_push($atom_hierarchy, $atom_name); + $atom_structure['hierarchy'] = implode(' ', $atom_hierarchy); + $atom_structure['name'] = $atom_name; + $atom_structure['size'] = $atom_size; + $atom_structure['offset'] = $base_offset; + + switch ($atom_name) { + case 'moov': // MOVie container atom + case 'trak': // TRAcK container atom + case 'clip': // CLIPping container atom + case 'matt': // track MATTe container atom + case 'edts': // EDiTS container atom + case 'tref': // Track REFerence container atom + case 'mdia': // MeDIA container atom + case 'minf': // Media INFormation container atom + case 'dinf': // Data INFormation container atom + case 'udta': // User DaTA container atom + case 'stbl': // Sample TaBLe container atom + case 'cmov': // Compressed MOVie container atom + case 'rmra': // Reference Movie Record Atom + case 'rmda': // Reference Movie Descriptor Atom + case 'gmhd': // Generic Media info HeaDer atom (seen on QTVR) + $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $base_offset + 8, $atom_hierarchy); + break; + + + case '©cpy': + case '©day': + case '©dir': + case '©ed1': + case '©ed2': + case '©ed3': + case '©ed4': + case '©ed5': + case '©ed6': + case '©ed7': + case '©ed8': + case '©ed9': + case '©fmt': + case '©inf': + case '©prd': + case '©prf': + case '©req': + case '©src': + case '©wrt': + case '©nam': + case '©cmt': + case '©wrn': + case '©hst': + case '©mak': + case '©mod': + case '©PRD': + case '©swr': + case '©aut': + case '©ART': + case '©trk': + case '©alb': + case '©com': + case '©gen': + case '©ope': + case '©url': + case '©enc': + $atom_structure['data_length'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 2)); + $atom_structure['language_id'] = getid3_lib::BigEndian2Int(substr($atom_data, 2, 2)); + $atom_structure['data'] = substr($atom_data, 4); + + $atom_structure['language'] = $this->QuicktimeLanguageLookup($atom_structure['language_id']); + if (empty($info['comments']['language']) || (!in_array($atom_structure['language'], $info['comments']['language']))) { + $info['comments']['language'][] = $atom_structure['language']; + } + $this->CopyToAppropriateCommentsSection($atom_name, $atom_structure['data']); + break; + + + case 'play': // auto-PLAY atom + $atom_structure['autoplay'] = (bool)getid3_lib::BigEndian2Int(substr($atom_data, 0, 1)); + + $info_quicktime['autoplay'] = $atom_structure['autoplay']; + break; + + + case 'WLOC': // Window LOCation atom + $atom_structure['location_x'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 2)); + $atom_structure['location_y'] = getid3_lib::BigEndian2Int(substr($atom_data, 2, 2)); + break; + + + case 'LOOP': // LOOPing atom + case 'SelO': // play SELection Only atom + case 'AllF': // play ALL Frames atom + $atom_structure['data'] = getid3_lib::BigEndian2Int($atom_data); + break; + + + case 'name': // + case 'MCPS': // Media Cleaner PRo + case '@PRM': // adobe PReMiere version + case '@PRQ': // adobe PRemiere Quicktime version + $atom_structure['data'] = $atom_data; + break; + + + case 'cmvd': // Compressed MooV Data atom + // Code by ubergeekØubergeek*tv based on information from + // http://developer.apple.com/quicktime/icefloe/dispatch012.html + $atom_structure['unCompressedSize'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 4)); + + $compressed_file_data = substr($atom_data, 4); + if (!function_exists('gzuncompress')) { + $getid3->warning('PHP does not have zlib support - cannot decompress MOV atom at offset '.$atom_structure['offset']); + } + elseif ($uncompressed_header = @gzuncompress($compressed_file_data)) { + $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($uncompressed_header, 0, $atom_hierarchy); + } else { + $getid3->warning('Error decompressing compressed MOV atom at offset '.$atom_structure['offset']); + } + break; + + + case 'dcom': // Data COMpression atom + $atom_structure['compression_id'] = $atom_data; + $atom_structure['compression_text'] = getid3_quicktime::QuicktimeDCOMLookup($atom_data); + break; + + + case 'rdrf': // Reference movie Data ReFerence atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, + 'reference_type_name' => -4, + 'reference_length' => 4, + ) + ); + + $atom_structure['flags']['internal_data'] = (bool)($atom_structure['flags_raw'] & 0x000001); + + switch ($atom_structure['reference_type_name']) { + case 'url ': + $atom_structure['url'] = $this->NoNullString(substr($atom_data, 12)); + break; + + case 'alis': + $atom_structure['file_alias'] = substr($atom_data, 12); + break; + + case 'rsrc': + $atom_structure['resource_alias'] = substr($atom_data, 12); + break; + + default: + $atom_structure['data'] = substr($atom_data, 12); + break; + } + break; + + + case 'rmqu': // Reference Movie QUality atom + $atom_structure['movie_quality'] = getid3_lib::BigEndian2Int($atom_data); + break; + + + case 'rmcs': // Reference Movie Cpu Speed atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'cpu_speed_rating' => 2 + ) + ); + break; + + + case 'rmvc': // Reference Movie Version Check atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'gestalt_selector' => -4, + 'gestalt_value_mask' => 4, + 'gestalt_value' => 4, + 'gestalt_check_type' => 2 + ) + ); + break; + + + case 'rmcd': // Reference Movie Component check atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'component_type' => -4, + 'component_subtype' => -4, + 'component_manufacturer' => -4, + 'component_flags_raw' => 4, + 'component_flags_mask' => 4, + 'component_min_version' => 4 + ) + ); + break; + + + case 'rmdr': // Reference Movie Data Rate atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'data_rate' => 4 + ) + ); + + $atom_structure['data_rate_bps'] = $atom_structure['data_rate'] * 10; + break; + + + case 'rmla': // Reference Movie Language Atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'language_id' => 2 + ) + ); + + $atom_structure['language'] = $this->QuicktimeLanguageLookup($atom_structure['language_id']); + if (empty($info['comments']['language']) || (!in_array($atom_structure['language'], $info['comments']['language']))) { + $info['comments']['language'][] = $atom_structure['language']; + } + break; + + + case 'rmla': // Reference Movie Language Atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'track_id' => 2 + ) + ); + break; + + + case 'ptv ': // Print To Video - defines a movie's full screen mode + // http://developer.apple.com/documentation/QuickTime/APIREF/SOURCESIV/at_ptv-_pg.htm + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'display_size_raw' => 2, + 'reserved_1' => 2, // hardcoded: 0x0000 + 'reserved_2' => 2, // hardcoded: 0x0000 + 'slide_show_flag' => 1, + 'play_on_open_flag' => 1 + ) + ); + + $atom_structure['flags']['play_on_open'] = (bool)$atom_structure['play_on_open_flag']; + $atom_structure['flags']['slide_show'] = (bool)$atom_structure['slide_show_flag']; + + $ptv_lookup[0] = 'normal'; + $ptv_lookup[1] = 'double'; + $ptv_lookup[2] = 'half'; + $ptv_lookup[3] = 'full'; + $ptv_lookup[4] = 'current'; + if (isset($ptv_lookup[$atom_structure['display_size_raw']])) { + $atom_structure['display_size'] = $ptv_lookup[$atom_structure['display_size_raw']]; + } else { + $getid3->warning('unknown "ptv " display constant ('.$atom_structure['display_size_raw'].')'); + } + break; + + + case 'stsd': // Sample Table Sample Description atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'number_entries' => 4 + ) + ); + $stsd_entries_data_offset = 8; + for ($i = 0; $i < $atom_structure['number_entries']; $i++) { + + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure['sample_description_table'][$i], $atom_data, $stsd_entries_data_offset, + array ( + 'size' => 4, + 'data_format' => -4, + 'reserved' => 6, + 'reference_index' => 2 + ) + ); + + $atom_structure['sample_description_table'][$i]['data'] = substr($atom_data, 16+$stsd_entries_data_offset, ($atom_structure['sample_description_table'][$i]['size'] - 4 - 4 - 6 - 2)); + $stsd_entries_data_offset += 16 + ($atom_structure['sample_description_table'][$i]['size'] - 4 - 4 - 6 - 2); + + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure['sample_description_table'][$i], $atom_structure['sample_description_table'][$i]['data'], 0, + array ( + 'encoder_version' => 2, + 'encoder_revision' => 2, + 'encoder_vendor' => -4 + ) + ); + + switch ($atom_structure['sample_description_table'][$i]['encoder_vendor']) { + + case "\x00\x00\x00\x00": + // audio atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure['sample_description_table'][$i], $atom_structure['sample_description_table'][$i]['data'], 8, + array ( + 'audio_channels' => 2, + 'audio_bit_depth' => 2, + 'audio_compression_id' => 2, + 'audio_packet_size' => 2 + ) + ); + + $atom_structure['sample_description_table'][$i]['audio_sample_rate'] = getid3_quicktime::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 16, 4)); + + switch ($atom_structure['sample_description_table'][$i]['data_format']) { + + case 'mp4v': + $info['fileformat'] = 'mp4'; + throw new getid3_exception('This version of getID3() does not fully support MPEG-4 audio/video streams'); + + case 'qtvr': + $info['video']['dataformat'] = 'quicktimevr'; + break; + + case 'mp4a': + default: + $info_quicktime['audio']['codec'] = $this->QuicktimeAudioCodecLookup($atom_structure['sample_description_table'][$i]['data_format']); + $info_quicktime['audio']['sample_rate'] = $atom_structure['sample_description_table'][$i]['audio_sample_rate']; + $info_quicktime['audio']['channels'] = $atom_structure['sample_description_table'][$i]['audio_channels']; + $info_quicktime['audio']['bit_depth'] = $atom_structure['sample_description_table'][$i]['audio_bit_depth']; + $info['audio']['codec'] = $info_quicktime['audio']['codec']; + $info['audio']['sample_rate'] = $info_quicktime['audio']['sample_rate']; + $info['audio']['channels'] = $info_quicktime['audio']['channels']; + $info['audio']['bits_per_sample'] = $info_quicktime['audio']['bit_depth']; + switch ($atom_structure['sample_description_table'][$i]['data_format']) { + case 'raw ': // PCM + case 'alac': // Apple Lossless Audio Codec + $info['audio']['lossless'] = true; + break; + default: + $info['audio']['lossless'] = false; + break; + } + break; + } + break; + + default: + switch ($atom_structure['sample_description_table'][$i]['data_format']) { + case 'mp4s': + $info['fileformat'] = 'mp4'; + break; + + default: + // video atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure['sample_description_table'][$i], $atom_structure['sample_description_table'][$i]['data'], 8, + array ( + 'video_temporal_quality' => 4, + 'video_spatial_quality' => 4, + 'video_frame_width' => 2, + 'video_frame_height' => 2 + ) + ); + $atom_structure['sample_description_table'][$i]['video_resolution_x'] = getid3_quicktime::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 20, 4)); + $atom_structure['sample_description_table'][$i]['video_resolution_y'] = getid3_quicktime::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 24, 4)); + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure['sample_description_table'][$i], $atom_structure['sample_description_table'][$i]['data'], 28, + array ( + 'video_data_size' => 4, + 'video_frame_count' => 2, + 'video_encoder_name_len' => 1 + ) + ); + $atom_structure['sample_description_table'][$i]['video_encoder_name'] = substr($atom_structure['sample_description_table'][$i]['data'], 35, $atom_structure['sample_description_table'][$i]['video_encoder_name_len']); + $atom_structure['sample_description_table'][$i]['video_pixel_color_depth'] = getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 66, 2)); + $atom_structure['sample_description_table'][$i]['video_color_table_id'] = getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 68, 2)); + + $atom_structure['sample_description_table'][$i]['video_pixel_color_type'] = (($atom_structure['sample_description_table'][$i]['video_pixel_color_depth'] > 32) ? 'grayscale' : 'color'); + $atom_structure['sample_description_table'][$i]['video_pixel_color_name'] = $this->QuicktimeColorNameLookup($atom_structure['sample_description_table'][$i]['video_pixel_color_depth']); + + if ($atom_structure['sample_description_table'][$i]['video_pixel_color_name'] != 'invalid') { + $info_quicktime['video']['codec_fourcc'] = $atom_structure['sample_description_table'][$i]['data_format']; + $info_quicktime['video']['codec_fourcc_lookup'] = $this->QuicktimeVideoCodecLookup($atom_structure['sample_description_table'][$i]['data_format']); + $info_quicktime['video']['codec'] = $atom_structure['sample_description_table'][$i]['video_encoder_name']; + $info_quicktime['video']['color_depth'] = $atom_structure['sample_description_table'][$i]['video_pixel_color_depth']; + $info_quicktime['video']['color_depth_name'] = $atom_structure['sample_description_table'][$i]['video_pixel_color_name']; + + $info['video']['codec'] = $info_quicktime['video']['codec']; + $info['video']['bits_per_sample'] = $info_quicktime['video']['color_depth']; + } + $info['video']['lossless'] = false; + $info['video']['pixel_aspect_ratio'] = (float)1; + break; + } + break; + } + switch (strtolower($atom_structure['sample_description_table'][$i]['data_format'])) { + case 'mp4a': + $info['audio']['dataformat'] = $info_quicktime['audio']['codec'] = 'mp4'; + break; + + case '3ivx': + case '3iv1': + case '3iv2': + $info['video']['dataformat'] = '3ivx'; + break; + + case 'xvid': + $info['video']['dataformat'] = 'xvid'; + break; + + case 'mp4v': + $info['video']['dataformat'] = 'mpeg4'; + break; + + case 'divx': + case 'div1': + case 'div2': + case 'div3': + case 'div4': + case 'div5': + case 'div6': + //$TDIVXileInfo['video']['dataformat'] = 'divx'; + break; + + default: + // do nothing + break; + } + unset($atom_structure['sample_description_table'][$i]['data']); + } + break; + + + case 'stts': // Sample Table Time-to-Sample atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'number_entries' => 4 + ) + ); + + $stts_entries_data_offset = 8; + $frame_rate_calculator_array = array (); + for ($i = 0; $i < $atom_structure['number_entries']; $i++) { + + $atom_structure['time_to_sample_table'][$i]['sample_count'] = getid3_lib::BigEndian2Int(substr($atom_data, $stts_entries_data_offset, 4)); + $stts_entries_data_offset += 4; + + $atom_structure['time_to_sample_table'][$i]['sample_duration'] = getid3_lib::BigEndian2Int(substr($atom_data, $stts_entries_data_offset, 4)); + $stts_entries_data_offset += 4; + + if (!empty($info_quicktime['time_scale']) && (@$atoms_structure['time_to_sample_table'][$i]['sample_duration'] > 0)) { + + $stts_new_framerate = $info_quicktime['time_scale'] / $atom_structure['time_to_sample_table'][$i]['sample_duration']; + if ($stts_new_framerate <= 60) { + // some atoms have durations of "1" giving a very large framerate, which probably is not right + $info['video']['frame_rate'] = max(@$info['video']['frame_rate'], $stts_new_framerate); + } + } + //@$frame_rate_calculator_array[($info_quicktime['time_scale'] / $atom_structure['time_to_sample_table'][$i]['sample_duration'])] += $atom_structure['time_to_sample_table'][$i]['sample_count']; + } + /* + $stts_frames_total = 0; + $stts_seconds_total = 0; + foreach ($frame_rate_calculator_array as $frames_per_second => $frame_count) { + if (($frames_per_second > 60) || ($frames_per_second < 1)) { + // not video FPS information, probably audio information + $stts_frames_total = 0; + $stts_seconds_total = 0; + break; + } + $stts_frames_total += $frame_count; + $stts_seconds_total += $frame_count / $frames_per_second; + } + if (($stts_frames_total > 0) && ($stts_seconds_total > 0)) { + if (($stts_frames_total / $stts_seconds_total) > @$info['video']['frame_rate']) { + $info['video']['frame_rate'] = $stts_frames_total / $stts_seconds_total; + } + } + */ + break; + + + case 'stss': // Sample Table Sync Sample (key frames) atom + /* + $atom_structure['version'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 1)); + $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($atom_data, 1, 3)); // hardcoded: 0x0000 + $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data, 4, 4)); + $stss_entries_data_offset = 8; + for ($i = 0; $i < $atom_structure['number_entries']; $i++) { + $atom_structure['time_to_sample_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stss_entries_data_offset, 4)); + $stss_entries_data_offset += 4; + } + */ + break; + + + case 'stsc': // Sample Table Sample-to-Chunk atom + /* + $atom_structure['version'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 1)); + $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($atom_data, 1, 3)); // hardcoded: 0x0000 + $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data, 4, 4)); + $stsc_entries_data_offset = 8; + for ($i = 0; $i < $atom_structure['number_entries']; $i++) { + $atom_structure['sample_to_chunk_table'][$i]['first_chunk'] = getid3_lib::BigEndian2Int(substr($atom_data, $stsc_entries_data_offset, 4)); + $stsc_entries_data_offset += 4; + $atom_structure['sample_to_chunk_table'][$i]['samples_per_chunk'] = getid3_lib::BigEndian2Int(substr($atom_data, $stsc_entries_data_offset, 4)); + $stsc_entries_data_offset += 4; + $atom_structure['sample_to_chunk_table'][$i]['sample_description'] = getid3_lib::BigEndian2Int(substr($atom_data, $stsc_entries_data_offset, 4)); + $stsc_entries_data_offset += 4; + } + */ + break; + + + case 'stsz': // Sample Table SiZe atom + /* + $atom_structure['version'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 1)); + $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($atom_data, 1, 3)); // hardcoded: 0x0000 + $atom_structure['sample_size'] = getid3_lib::BigEndian2Int(substr($atom_data, 4, 4)); + $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data, 8, 4)); + $stsz_entries_data_offset = 12; + if ($atom_structure['sample_size'] == 0) { + for ($i = 0; $i < $atom_structure['number_entries']; $i++) { + $atom_structure['sample_size_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stsz_entries_data_offset, 4)); + $stsz_entries_data_offset += 4; + } + } + */ + break; + + + case 'stco': // Sample Table Chunk Offset atom + /* + $atom_structure['version'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 1)); + $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($atom_data, 1, 3)); // hardcoded: 0x0000 + $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data, 4, 4)); + $stco_entries_data_offset = 8; + for ($i = 0; $i < $atom_structure['number_entries']; $i++) { + $atom_structure['chunk_offset_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stco_entries_data_offset, 4)); + $stco_entries_data_offset += 4; + } + */ + break; + + + case 'dref': // Data REFerence atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'number_entries' => 4 + ) + ); + + $dref_data_offset = 8; + for ($i = 0; $i < $atom_structure['number_entries']; $i++) { + + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure['data_references'][$i], $atom_data, $dref_data_offset, + array ( + 'size' => 4, + 'type' => -4, + 'version' => 1, + 'flags_raw' => 3 // hardcoded: 0x0000 + ) + ); + $dref_data_offset += 12; + + $atom_structure['data_references'][$i]['data'] = substr($atom_data, $dref_data_offset, ($atom_structure['data_references'][$i]['size'] - 4 - 4 - 1 - 3)); + $dref_data_offset += ($atom_structure['data_references'][$i]['size'] - 4 - 4 - 1 - 3); + + $atom_structure['data_references'][$i]['flags']['self_reference'] = (bool)($atom_structure['data_references'][$i]['flags_raw'] & 0x001); + } + break; + + + case 'gmin': // base Media INformation atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'graphics_mode' => 2, + 'opcolor_red' => 2, + 'opcolor_green' => 2, + 'opcolor_blue' => 2, + 'balance' => 2, + 'reserved' => 2 + ) + ); + break; + + + case 'smhd': // Sound Media information HeaDer atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'balance' => 2, + 'reserved' => 2 + ) + ); + break; + + + case 'vmhd': // Video Media information HeaDer atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, + 'graphics_mode' => 2, + 'opcolor_red' => 2, + 'opcolor_green' => 2, + 'opcolor_blue' => 2 + ) + ); + $atom_structure['flags']['no_lean_ahead'] = (bool)($atom_structure['flags_raw'] & 0x001); + break; + + + case 'hdlr': // HanDLeR reference atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'component_type' => -4, + 'component_subtype' => -4, + 'component_manufacturer' => -4, + 'component_flags_raw' => 4, + 'component_flags_mask' => 4 + ) + ); + + $atom_structure['component_name'] = substr(substr($atom_data, 24), 1); /// Pascal2String + + if (($atom_structure['component_subtype'] == 'STpn') && ($atom_structure['component_manufacturer'] == 'zzzz')) { + $info['video']['dataformat'] = 'quicktimevr'; + } + break; + + + case 'mdhd': // MeDia HeaDer atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'creation_time' => 4, + 'modify_time' => 4, + 'time_scale' => 4, + 'duration' => 4, + 'language_id' => 2, + 'quality' => 2 + ) + ); + + if ($atom_structure['time_scale'] == 0) { + throw new getid3_exception('Corrupt Quicktime file: mdhd.time_scale == zero'); + } + $info_quicktime['time_scale'] = max(@$info['quicktime']['time_scale'], $atom_structure['time_scale']); + + $atom_structure['creation_time_unix'] = (int)($atom_structure['creation_time'] - 2082844800); // DateMac2Unix() + $atom_structure['modify_time_unix'] = (int)($atom_structure['modify_time'] - 2082844800); // DateMac2Unix() + $atom_structure['playtime_seconds'] = $atom_structure['duration'] / $atom_structure['time_scale']; + $atom_structure['language'] = $this->QuicktimeLanguageLookup($atom_structure['language_id']); + if (empty($info['comments']['language']) || (!in_array($atom_structure['language'], $info['comments']['language']))) { + $info['comments']['language'][] = $atom_structure['language']; + } + break; + + + case 'pnot': // Preview atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'modification_date' => 4, // "standard Macintosh format" + 'version_number' => 2, // hardcoded: 0x00 + 'atom_type' => -4, // usually: 'PICT' + 'atom_index' => 2 // usually: 0x01 + ) + ); + $atom_structure['modification_date_unix'] = (int)($atom_structure['modification_date'] - 2082844800); // DateMac2Unix() + break; + + + case 'crgn': // Clipping ReGioN atom + $atom_structure['region_size'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 2)); // The Region size, Region boundary box, + $atom_structure['boundary_box'] = getid3_lib::BigEndian2Int(substr($atom_data, 2, 8)); // and Clipping region data fields + $atom_structure['clipping_data'] = substr($atom_data, 10); // constitute a QuickDraw region. + break; + + + case 'load': // track LOAD settings atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'preload_start_time' => 4, + 'preload_duration' => 4, + 'preload_flags_raw' => 4, + 'default_hints_raw' => 4 + ) + ); + + $atom_structure['default_hints']['double_buffer'] = (bool)($atom_structure['default_hints_raw'] & 0x0020); + $atom_structure['default_hints']['high_quality'] = (bool)($atom_structure['default_hints_raw'] & 0x0100); + break; + + + case 'tmcd': // TiMe CoDe atom + case 'chap': // CHAPter list atom + case 'sync': // SYNChronization atom + case 'scpt': // tranSCriPT atom + case 'ssrc': // non-primary SouRCe atom + for ($i = 0; $i < (strlen($atom_data) % 4); $i++) { + $atom_structure['track_id'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $i * 4, 4)); + } + break; + + + case 'elst': // Edit LiST atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, // hardcoded: 0x0000 + 'number_entries' => 4 + ) + ); + + for ($i = 0; $i < $atom_structure['number_entries']; $i++ ) { + $atom_structure['edit_list'][$i]['track_duration'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($i * 12) + 0, 4)); + $atom_structure['edit_list'][$i]['media_time'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($i * 12) + 4, 4)); + $atom_structure['edit_list'][$i]['media_rate'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 8 + ($i * 12) + 8, 4)); + } + break; + + + case 'kmat': // compressed MATte atom + $atom_structure['version'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 1)); + $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($atom_data, 1, 3)); // hardcoded: 0x0000 + $atom_structure['matte_data_raw'] = substr($atom_data, 4); + break; + + + case 'ctab': // Color TABle atom + $atom_structure['color_table_seed'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 4)); // hardcoded: 0x00000000 + $atom_structure['color_table_flags'] = getid3_lib::BigEndian2Int(substr($atom_data, 4, 2)); // hardcoded: 0x8000 + $atom_structure['color_table_size'] = getid3_lib::BigEndian2Int(substr($atom_data, 6, 2)) + 1; + for ($colortableentry = 0; $colortableentry < $atom_structure['color_table_size']; $colortableentry++) { + $atom_structure['color_table'][$colortableentry]['alpha'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 0, 2)); + $atom_structure['color_table'][$colortableentry]['red'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 2, 2)); + $atom_structure['color_table'][$colortableentry]['green'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 4, 2)); + $atom_structure['color_table'][$colortableentry]['blue'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 6, 2)); + } + break; + + + case 'mvhd': // MoVie HeaDer atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, + 'creation_time' => 4, + 'modify_time' => 4, + 'time_scale' => 4, + 'duration' => 4 + ) + ); + + $atom_structure['preferred_rate'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 20, 4)); + $atom_structure['preferred_volume'] = getid3_quicktime::FixedPoint8_8(substr($atom_data, 24, 2)); + $atom_structure['reserved'] = substr($atom_data, 26, 10); + $atom_structure['matrix_a'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 36, 4)); + $atom_structure['matrix_b'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 40, 4)); + $atom_structure['matrix_u'] = getid3_quicktime::FixedPoint2_30(substr($atom_data, 44, 4)); + $atom_structure['matrix_c'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 48, 4)); + $atom_structure['matrix_d'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 52, 4)); + $atom_structure['matrix_v'] = getid3_quicktime::FixedPoint2_30(substr($atom_data, 56, 4)); + $atom_structure['matrix_x'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 60, 4)); + $atom_structure['matrix_y'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 64, 4)); + $atom_structure['matrix_w'] = getid3_quicktime::FixedPoint2_30(substr($atom_data, 68, 4)); + + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 72, + array ( + 'preview_time' => 4, + 'preview_duration' => 4, + 'poster_time' => 4, + 'selection_time' => 4, + 'selection_duration' => 4, + 'current_time' => 4, + 'next_track_id' => 4 + ) + ); + + if ($atom_structure['time_scale'] == 0) { + throw new getid3_exception('Corrupt Quicktime file: mvhd.time_scale == zero'); + } + + $atom_structure['creation_time_unix'] = (int)($atom_structure['creation_time'] - 2082844800); // DateMac2Unix() + $atom_structure['modify_time_unix'] = (int)($atom_structure['modify_time'] - 2082844800); // DateMac2Unix() + $info_quicktime['time_scale'] = max(@$info['quicktime']['time_scale'], $atom_structure['time_scale']); + $info_quicktime['display_scale'] = $atom_structure['matrix_a']; + $info['playtime_seconds'] = $atom_structure['duration'] / $atom_structure['time_scale']; + break; + + + case 'tkhd': // TracK HeaDer atom + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'version' => 1, + 'flags_raw' => 3, + 'creation_time' => 4, + 'modify_time' => 4, + 'trackid' => 4, + 'reserved1' => 4, + 'duration' => 4, + 'reserved2' => 8, + 'layer' => 2, + 'alternate_group' => 2 + ) + ); + + $atom_structure['volume'] = getid3_quicktime::FixedPoint8_8(substr($atom_data, 36, 2)); + $atom_structure['reserved3'] = getid3_lib::BigEndian2Int(substr($atom_data, 38, 2)); + $atom_structure['matrix_a'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 40, 4)); + $atom_structure['matrix_b'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 44, 4)); + $atom_structure['matrix_u'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 48, 4)); + $atom_structure['matrix_c'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 52, 4)); + $atom_structure['matrix_v'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 56, 4)); + $atom_structure['matrix_d'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 60, 4)); + $atom_structure['matrix_x'] = getid3_quicktime::FixedPoint2_30(substr($atom_data, 64, 4)); + $atom_structure['matrix_y'] = getid3_quicktime::FixedPoint2_30(substr($atom_data, 68, 4)); + $atom_structure['matrix_w'] = getid3_quicktime::FixedPoint2_30(substr($atom_data, 72, 4)); + $atom_structure['width'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 76, 4)); + $atom_structure['height'] = getid3_quicktime::FixedPoint16_16(substr($atom_data, 80, 4)); + + $atom_structure['flags']['enabled'] = (bool)($atom_structure['flags_raw'] & 0x0001); + $atom_structure['flags']['in_movie'] = (bool)($atom_structure['flags_raw'] & 0x0002); + $atom_structure['flags']['in_preview'] = (bool)($atom_structure['flags_raw'] & 0x0004); + $atom_structure['flags']['in_poster'] = (bool)($atom_structure['flags_raw'] & 0x0008); + $atom_structure['creation_time_unix'] = (int)($atom_structure['creation_time'] - 2082844800); // DateMac2Unix() + $atom_structure['modify_time_unix'] = (int)($atom_structure['modify_time'] - 2082844800); // DateMac2Unix() + + if (!isset($info['video']['resolution_x']) || !isset($info['video']['resolution_y'])) { + $info['video']['resolution_x'] = $atom_structure['width']; + $info['video']['resolution_y'] = $atom_structure['height']; + } + + if ($atom_structure['flags']['enabled'] == 1) { + $info['video']['resolution_x'] = max($info['video']['resolution_x'], $atom_structure['width']); + $info['video']['resolution_y'] = max($info['video']['resolution_y'], $atom_structure['height']); + } + + if (!empty($info['video']['resolution_x']) && !empty($info['video']['resolution_y'])) { + $info_quicktime['video']['resolution_x'] = $info['video']['resolution_x']; + $info_quicktime['video']['resolution_y'] = $info['video']['resolution_y']; + } else { + unset($info['video']['resolution_x']); + unset($info['video']['resolution_y']); + unset($info_quicktime['video']); + } + break; + + + case 'meta': // METAdata atom + // http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt + $next_tag_position = strpos($atom_data, '©'); + while ($next_tag_position < strlen($atom_data)) { + $meta_item_size = getid3_lib::BigEndian2Int(substr($atom_data, $next_tag_position - 4, 4)) - 4; + if ($meta_item_size == -4) { + break; + } + $meta_item_raw = substr($atom_data, $next_tag_position, $meta_item_size); + $meta_item_key = substr($meta_item_raw, 0, 4); + $meta_item_data = substr($meta_item_raw, 20); + $next_tag_position += $meta_item_size + 4; + + $this->CopyToAppropriateCommentsSection($meta_item_key, $meta_item_data); + } + break; + + case 'ftyp': // FileTYPe (?) atom (for MP4 it seems) + getid3_lib::ReadSequence('BigEndian2Int', $atom_structure, $atom_data, 0, + array ( + 'signature' => -4, + 'unknown_1' => 4, + 'fourcc' => -4, + ) + ); + break; + + case 'mdat': // Media DATa atom + case 'free': // FREE space atom + case 'skip': // SKIP atom + case 'wide': // 64-bit expansion placeholder atom + // 'mdat' data is too big to deal with, contains no useful metadata + // 'free', 'skip' and 'wide' are just padding, contains no useful data at all + + // When writing QuickTime files, it is sometimes necessary to update an atom's size. + // It is impossible to update a 32-bit atom to a 64-bit atom since the 32-bit atom + // is only 8 bytes in size, and the 64-bit atom requires 16 bytes. Therefore, QuickTime + // puts an 8-byte placeholder atom before any atoms it may have to update the size of. + // In this way, if the atom needs to be converted from a 32-bit to a 64-bit atom, the + // placeholder atom can be overwritten to obtain the necessary 8 extra bytes. + // The placeholder atom has a type of kWideAtomPlaceholderType ( 'wide' ). + break; + + + case 'nsav': // NoSAVe atom + // http://developer.apple.com/technotes/tn/tn2038.html + $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 4)); + break; + + case 'ctyp': // Controller TYPe atom (seen on QTVR) + // http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt + // some controller names are: + // 0x00 + 'std' for linear movie + // 'none' for no controls + $atom_structure['ctyp'] = substr($atom_data, 0, 4); + switch ($atom_structure['ctyp']) { + case 'qtvr': + $info['video']['dataformat'] = 'quicktimevr'; + break; + } + break; + + case 'pano': // PANOrama track (seen on QTVR) + $atom_structure['pano'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 4)); + break; + + case 'hint': // HINT track + case 'hinf': // + case 'hinv': // + case 'hnti': // + $info['quicktime']['hinting'] = true; + break; + + case 'imgt': // IMaGe Track reference (kQTVRImageTrackRefType) (seen on QTVR) + for ($i = 0; $i < ($atom_structure['size'] - 8); $i += 4) { + $atom_structure['imgt'][] = getid3_lib::BigEndian2Int(substr($atom_data, $i, 4)); + } + break; + + case 'FXTC': // Something to do with Adobe After Effects (?) + case 'PrmA': + case 'code': + case 'FIEL': // this is NOT "fiel" (Field Ordering) as describe here: http://developer.apple.com/documentation/QuickTime/QTFF/QTFFChap3/chapter_4_section_2.html + // Observed-but-not-handled atom types are just listed here + // to prevent warnings being generated + $atom_structure['data'] = $atom_data; + break; + + default: + $getid3->warning('Unknown QuickTime atom type: "'.$atom_name.'" at offset '.$base_offset); + $atom_structure['data'] = $atom_data; + break; + } + array_pop($atom_hierarchy); + return $atom_structure; + } + + + + private function QuicktimeParseContainerAtom($atom_data, $base_offset, &$atom_hierarchy) { + + if ((strlen($atom_data) == 4) && (getid3_lib::BigEndian2Int($atom_data) == 0x00000000)) { + return false; + } + + $atom_structure = false; + $subatom_offset = 0; + + while ($subatom_offset < strlen($atom_data)) { + + $subatom_size = getid3_lib::BigEndian2Int(substr($atom_data, $subatom_offset + 0, 4)); + $subatom_name = substr($atom_data, $subatom_offset + 4, 4); + $subatom_data = substr($atom_data, $subatom_offset + 8, $subatom_size - 8); + + if ($subatom_size == 0) { + // Furthermore, for historical reasons the list of atoms is optionally + // terminated by a 32-bit integer set to 0. If you are writing a program + // to read user data atoms, you should allow for the terminating 0. + return $atom_structure; + } + + $atom_structure[] = $this->QuicktimeParseAtom($subatom_name, $subatom_size, $subatom_data, $base_offset + $subatom_offset, $atom_hierarchy); + + $subatom_offset += $subatom_size; + } + return $atom_structure; + } + + + + private function CopyToAppropriateCommentsSection($key_name, $data) { + + // http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt + + static $translator = array ( + '©cpy' => 'copyright', + '©day' => 'creation_date', + '©dir' => 'director', + '©ed1' => 'edit1', + '©ed2' => 'edit2', + '©ed3' => 'edit3', + '©ed4' => 'edit4', + '©ed5' => 'edit5', + '©ed6' => 'edit6', + '©ed7' => 'edit7', + '©ed8' => 'edit8', + '©ed9' => 'edit9', + '©fmt' => 'format', + '©inf' => 'information', + '©prd' => 'producer', + '©prf' => 'performers', + '©req' => 'system_requirements', + '©src' => 'source_credit', + '©wrt' => 'writer', + '©nam' => 'title', + '©cmt' => 'comment', + '©wrn' => 'warning', + '©hst' => 'host_computer', + '©mak' => 'make', + '©mod' => 'model', + '©PRD' => 'product', + '©swr' => 'software', + '©aut' => 'author', + '©ART' => 'artist', + '©trk' => 'track', + '©alb' => 'album', + '©com' => 'comment', + '©gen' => 'genre', + '©ope' => 'composer', + '©url' => 'url', + '©enc' => 'encoder' + ); + + if (isset($translator[$key_name])) { + $this->getid3->info['quicktime']['comments'][$translator[$key_name]][] = $data; + } + + return true; + } + + + + public static function QuicktimeLanguageLookup($language_id) { + + static $lookup = array ( + 0 => 'English', + 1 => 'French', + 2 => 'German', + 3 => 'Italian', + 4 => 'Dutch', + 5 => 'Swedish', + 6 => 'Spanish', + 7 => 'Danish', + 8 => 'Portuguese', + 9 => 'Norwegian', + 10 => 'Hebrew', + 11 => 'Japanese', + 12 => 'Arabic', + 13 => 'Finnish', + 14 => 'Greek', + 15 => 'Icelandic', + 16 => 'Maltese', + 17 => 'Turkish', + 18 => 'Croatian', + 19 => 'Chinese (Traditional)', + 20 => 'Urdu', + 21 => 'Hindi', + 22 => 'Thai', + 23 => 'Korean', + 24 => 'Lithuanian', + 25 => 'Polish', + 26 => 'Hungarian', + 27 => 'Estonian', + 28 => 'Lettish', + 28 => 'Latvian', + 29 => 'Saamisk', + 29 => 'Lappish', + 30 => 'Faeroese', + 31 => 'Farsi', + 31 => 'Persian', + 32 => 'Russian', + 33 => 'Chinese (Simplified)', + 34 => 'Flemish', + 35 => 'Irish', + 36 => 'Albanian', + 37 => 'Romanian', + 38 => 'Czech', + 39 => 'Slovak', + 40 => 'Slovenian', + 41 => 'Yiddish', + 42 => 'Serbian', + 43 => 'Macedonian', + 44 => 'Bulgarian', + 45 => 'Ukrainian', + 46 => 'Byelorussian', + 47 => 'Uzbek', + 48 => 'Kazakh', + 49 => 'Azerbaijani', + 50 => 'AzerbaijanAr', + 51 => 'Armenian', + 52 => 'Georgian', + 53 => 'Moldavian', + 54 => 'Kirghiz', + 55 => 'Tajiki', + 56 => 'Turkmen', + 57 => 'Mongolian', + 58 => 'MongolianCyr', + 59 => 'Pashto', + 60 => 'Kurdish', + 61 => 'Kashmiri', + 62 => 'Sindhi', + 63 => 'Tibetan', + 64 => 'Nepali', + 65 => 'Sanskrit', + 66 => 'Marathi', + 67 => 'Bengali', + 68 => 'Assamese', + 69 => 'Gujarati', + 70 => 'Punjabi', + 71 => 'Oriya', + 72 => 'Malayalam', + 73 => 'Kannada', + 74 => 'Tamil', + 75 => 'Telugu', + 76 => 'Sinhalese', + 77 => 'Burmese', + 78 => 'Khmer', + 79 => 'Lao', + 80 => 'Vietnamese', + 81 => 'Indonesian', + 82 => 'Tagalog', + 83 => 'MalayRoman', + 84 => 'MalayArabic', + 85 => 'Amharic', + 86 => 'Tigrinya', + 87 => 'Galla', + 87 => 'Oromo', + 88 => 'Somali', + 89 => 'Swahili', + 90 => 'Ruanda', + 91 => 'Rundi', + 92 => 'Chewa', + 93 => 'Malagasy', + 94 => 'Esperanto', + 128 => 'Welsh', + 129 => 'Basque', + 130 => 'Catalan', + 131 => 'Latin', + 132 => 'Quechua', + 133 => 'Guarani', + 134 => 'Aymara', + 135 => 'Tatar', + 136 => 'Uighur', + 137 => 'Dzongkha', + 138 => 'JavaneseRom' + ); + + return (isset($lookup[$language_id]) ? $lookup[$language_id] : 'invalid'); + } + + + + public static function QuicktimeVideoCodecLookup($codec_id) { + + static $lookup = array ( + '3IVX' => '3ivx MPEG-4', + '3IV1' => '3ivx MPEG-4 v1', + '3IV2' => '3ivx MPEG-4 v2', + 'avr ' => 'AVR-JPEG', + 'base' => 'Base', + 'WRLE' => 'BMP', + 'cvid' => 'Cinepak', + 'clou' => 'Cloud', + 'cmyk' => 'CMYK', + 'yuv2' => 'ComponentVideo', + 'yuvu' => 'ComponentVideoSigned', + 'yuvs' => 'ComponentVideoUnsigned', + 'dvc ' => 'DVC-NTSC', + 'dvcp' => 'DVC-PAL', + 'dvpn' => 'DVCPro-NTSC', + 'dvpp' => 'DVCPro-PAL', + 'fire' => 'Fire', + 'flic' => 'FLC', + 'b48r' => '48RGB', + 'gif ' => 'GIF', + 'smc ' => 'Graphics', + 'h261' => 'H261', + 'h263' => 'H263', + 'IV41' => 'Indeo4', + 'jpeg' => 'JPEG', + 'PNTG' => 'MacPaint', + 'msvc' => 'Microsoft Video1', + 'mjpa' => 'Motion JPEG-A', + 'mjpb' => 'Motion JPEG-B', + 'myuv' => 'MPEG YUV420', + 'dmb1' => 'OpenDML JPEG', + 'kpcd' => 'PhotoCD', + '8BPS' => 'Planar RGB', + 'png ' => 'PNG', + 'qdrw' => 'QuickDraw', + 'qdgx' => 'QuickDrawGX', + 'raw ' => 'RAW', + '.SGI' => 'SGI', + 'b16g' => '16Gray', + 'b64a' => '64ARGB', + 'SVQ1' => 'Sorenson Video 1', + 'SVQ1' => 'Sorenson Video 3', + 'syv9' => 'Sorenson YUV9', + 'tga ' => 'Targa', + 'b32a' => '32AlphaGray', + 'tiff' => 'TIFF', + 'path' => 'Vector', + 'rpza' => 'Video', + 'ripl' => 'WaterRipple', + 'WRAW' => 'Windows RAW', + 'y420' => 'YUV420' + ); + + return (isset($lookup[$codec_id]) ? $lookup[$codec_id] : ''); + } + + + + public static function QuicktimeAudioCodecLookup($codec_id) { + + static $lookup = array ( + '.mp3' => 'Fraunhofer MPEG Layer-III alias', + 'aac ' => 'ISO/IEC 14496-3 AAC', + 'agsm' => 'Apple GSM 10:1', + 'alac' => 'Apple Lossless Audio Codec', + 'alaw' => 'A-law 2:1', + 'conv' => 'Sample Format', + 'dvca' => 'DV', + 'dvi ' => 'DV 4:1', + 'eqal' => 'Frequency Equalizer', + 'fl32' => '32-bit Floating Point', + 'fl64' => '64-bit Floating Point', + 'ima4' => 'Interactive Multimedia Association 4:1', + 'in24' => '24-bit Integer', + 'in32' => '32-bit Integer', + 'lpc ' => 'LPC 23:1', + 'MAC3' => 'Macintosh Audio Compression/Expansion (MACE) 3:1', + 'MAC6' => 'Macintosh Audio Compression/Expansion (MACE) 6:1', + 'mixb' => '8-bit Mixer', + 'mixw' => '16-bit Mixer', + 'mp4a' => 'ISO/IEC 14496-3 AAC', + "MS'\x00\x02" => 'Microsoft ADPCM', + "MS'\x00\x11" => 'DV IMA', + "MS\x00\x55" => 'Fraunhofer MPEG Layer III', + 'NONE' => 'No Encoding', + 'Qclp' => 'Qualcomm PureVoice', + 'QDM2' => 'QDesign Music 2', + 'QDMC' => 'QDesign Music 1', + 'ratb' => '8-bit Rate', + 'ratw' => '16-bit Rate', + 'raw ' => 'raw PCM', + 'sour' => 'Sound Source', + 'sowt' => 'signed/two\'s complement (Little Endian)', + 'str1' => 'Iomega MPEG layer II', + 'str2' => 'Iomega MPEG *layer II', + 'str3' => 'Iomega MPEG **layer II', + 'str4' => 'Iomega MPEG ***layer II', + 'twos' => 'signed/two\'s complement (Big Endian)', + 'ulaw' => 'mu-law 2:1', + ); + + return (isset($lookup[$codec_id]) ? $lookup[$codec_id] : ''); + } + + + + public static function QuicktimeDCOMLookup($compression_id) { + + static $lookup = array ( + 'zlib' => 'ZLib Deflate', + 'adec' => 'Apple Compression' + ); + + return (isset($lookup[$compression_id]) ? $lookup[$compression_id] : ''); + } + + + + public static function QuicktimeColorNameLookup($color_depth_id) { + + static $lookup = array ( + 1 => '2-color (monochrome)', + 2 => '4-color', + 4 => '16-color', + 8 => '256-color', + 16 => 'thousands (16-bit color)', + 24 => 'millions (24-bit color)', + 32 => 'millions+ (32-bit color)', + 33 => 'black & white', + 34 => '4-gray', + 36 => '16-gray', + 40 => '256-gray', + ); + + return (isset($lookup[$color_depth_id]) ? $lookup[$color_depth_id] : 'invalid'); + } + + + + public static function NoNullString($null_terminated_string) { + + // remove the single null terminator on null terminated strings + if (substr($null_terminated_string, strlen($null_terminated_string) - 1, 1) === "\x00") { + return substr($null_terminated_string, 0, strlen($null_terminated_string) - 1); + } + + return $null_terminated_string; + } + + + + public static function FixedPoint8_8($raw_data) { + + return getid3_lib::BigEndian2Int($raw_data{0}) + (float)(getid3_lib::BigEndian2Int($raw_data{1}) / 256); + } + + + + public static function FixedPoint16_16($raw_data) { + + return getid3_lib::BigEndian2Int(substr($raw_data, 0, 2)) + (float)(getid3_lib::BigEndian2Int(substr($raw_data, 2, 2)) / 65536); + } + + + + public static function FixedPoint2_30($raw_data) { + + $binary_string = getid3_lib::BigEndian2Bin($raw_data); + return bindec(substr($binary_string, 0, 2)) + (float)(bindec(substr($binary_string, 2, 30)) / 1073741824); + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.real.php b/modules/getid3/module.audio-video.real.php new file mode 100644 index 00000000..fd28c18b --- /dev/null +++ b/modules/getid3/module.audio-video.real.php @@ -0,0 +1,591 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio-video.real.php | +// | Module for analyzing Real Audio/Video files | +// | dependencies: module.audio-video.riff.php | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.real.php,v 1.4 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_real extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->include_module('audio-video.riff'); + + $getid3->info['fileformat'] = 'real'; + $getid3->info['bitrate'] = 0; + $getid3->info['playtime_seconds'] = 0; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $chunk_counter = 0; + + while (ftell($getid3->fp) < $getid3->info['avdataend']) { + + $chunk_data = fread($getid3->fp, 8); + $chunk_name = substr($chunk_data, 0, 4); + $chunk_size = getid3_lib::BigEndian2Int(substr($chunk_data, 4, 4)); + + if ($chunk_name == '.ra'."\xFD") { + $chunk_data .= fread($getid3->fp, $chunk_size - 8); + + if ($this->ParseOldRAheader(substr($chunk_data, 0, 128), $getid3->info['real']['old_ra_header'])) { + + $getid3->info['audio']['dataformat'] = 'real'; + $getid3->info['audio']['lossless'] = false; + $getid3->info['audio']['sample_rate'] = $getid3->info['real']['old_ra_header']['sample_rate']; + $getid3->info['audio']['bits_per_sample'] = $getid3->info['real']['old_ra_header']['bits_per_sample']; + $getid3->info['audio']['channels'] = $getid3->info['real']['old_ra_header']['channels']; + + $getid3->info['playtime_seconds'] = 60 * ($getid3->info['real']['old_ra_header']['audio_bytes'] / $getid3->info['real']['old_ra_header']['bytes_per_minute']); + $getid3->info['audio']['bitrate'] = 8 * ($getid3->info['real']['old_ra_header']['audio_bytes'] / $getid3->info['playtime_seconds']); + $getid3->info['audio']['codec'] = $this->RealAudioCodecFourCClookup($getid3->info['real']['old_ra_header']['fourcc'], $getid3->info['audio']['bitrate']); + + foreach ($getid3->info['real']['old_ra_header']['comments'] as $key => $value_array) { + + if (strlen(trim($value_array[0])) > 0) { + $getid3->info['real']['comments'][$key][] = trim($value_array[0]); + } + } + return true; + } + + throw new getid3_exception('There was a problem parsing this RealAudio file. Please submit it for analysis to http://www.getid3.org/upload/ or info@getid3.org'); + } + + $getid3->info['real']['chunks'][$chunk_counter] = array (); + $info_real_chunks_current_chunk = &$getid3->info['real']['chunks'][$chunk_counter]; + + $info_real_chunks_current_chunk['name'] = $chunk_name; + $info_real_chunks_current_chunk['offset'] = ftell($getid3->fp) - 8; + $info_real_chunks_current_chunk['length'] = $chunk_size; + + if (($info_real_chunks_current_chunk['offset'] + $info_real_chunks_current_chunk['length']) > $getid3->info['avdataend']) { + $getid3->warning('Chunk "'.$info_real_chunks_current_chunk['name'].'" at offset '.$info_real_chunks_current_chunk['offset'].' claims to be '.$info_real_chunks_current_chunk['length'].' bytes long, which is beyond end of file'); + return false; + } + + if ($chunk_size > (getid3::FREAD_BUFFER_SIZE + 8)) { + $chunk_data .= fread($getid3->fp, getid3::FREAD_BUFFER_SIZE - 8); + fseek($getid3->fp, $info_real_chunks_current_chunk['offset'] + $chunk_size, SEEK_SET); + + } elseif(($chunk_size - 8) > 0) { + $chunk_data .= fread($getid3->fp, $chunk_size - 8); + } + $offset = 8; + + switch ($chunk_name) { + + case '.RMF': // RealMedia File Header + + $info_real_chunks_current_chunk['object_version'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + switch ($info_real_chunks_current_chunk['object_version']) { + + case 0: + $info_real_chunks_current_chunk['file_version'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 4)); + $offset += 4; + + $info_real_chunks_current_chunk['headers_count'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 4)); + $offset += 4; + break; + + default: + //$getid3->warning('Expected .RMF-object_version to be "0", actual value is "'.$info_real_chunks_current_chunk['object_version'].'" (should not be a problem)'; + break; + + } + break; + + + case 'PROP': // Properties Header + + $info_real_chunks_current_chunk['object_version'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + if ($info_real_chunks_current_chunk['object_version'] == 0) { + + getid3_lib::ReadSequence('BigEndian2Int', $info_real_chunks_current_chunk, $chunk_data, $offset, + array ( + 'max_bit_rate' => 4, + 'avg_bit_rate' => 4, + 'max_packet_size' => 4, + 'avg_packet_size' => 4, + 'num_packets' => 4, + 'duration' => 4, + 'preroll' => 4, + 'index_offset' => 4, + 'data_offset' => 4, + 'num_streams' => 2, + 'flags_raw' => 2 + ) + ); + $offset += 40; + + $getid3->info['playtime_seconds'] = $info_real_chunks_current_chunk['duration'] / 1000; + if ($info_real_chunks_current_chunk['duration'] > 0) { + $getid3->info['bitrate'] += $info_real_chunks_current_chunk['avg_bit_rate']; + } + + $info_real_chunks_current_chunk['flags']['save_enabled'] = (bool)($info_real_chunks_current_chunk['flags_raw'] & 0x0001); + $info_real_chunks_current_chunk['flags']['perfect_play'] = (bool)($info_real_chunks_current_chunk['flags_raw'] & 0x0002); + $info_real_chunks_current_chunk['flags']['live_broadcast'] = (bool)($info_real_chunks_current_chunk['flags_raw'] & 0x0004); + } + break; + + + case 'MDPR': // Media Properties Header + + $info_real_chunks_current_chunk['object_version'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + if ($info_real_chunks_current_chunk['object_version'] == 0) { + + getid3_lib::ReadSequence('BigEndian2Int', $info_real_chunks_current_chunk, $chunk_data, $offset, + array ( + 'stream_number' => 2, + 'max_bit_rate' => 4, + 'avg_bit_rate' => 4, + 'max_packet_size' => 4, + 'avg_packet_size' => 4, + 'start_time' => 4, + 'preroll' => 4, + 'duration' => 4, + 'stream_name_size' => 1 + ) + ); + $offset += 31; + + $info_real_chunks_current_chunk['stream_name'] = substr($chunk_data, $offset, $info_real_chunks_current_chunk['stream_name_size']); + $offset += $info_real_chunks_current_chunk['stream_name_size']; + + $info_real_chunks_current_chunk['mime_type_size'] = getid3_lib::BigEndian2Int($chunk_data{$offset++}); + + $info_real_chunks_current_chunk['mime_type'] = substr($chunk_data, $offset, $info_real_chunks_current_chunk['mime_type_size']); + $offset += $info_real_chunks_current_chunk['mime_type_size']; + + $info_real_chunks_current_chunk['type_specific_len'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 4)); + $offset += 4; + + $info_real_chunks_current_chunk['type_specific_data'] = substr($chunk_data, $offset, $info_real_chunks_current_chunk['type_specific_len']); + $offset += $info_real_chunks_current_chunk['type_specific_len']; + + $info_real_chunks_current_chunk_typespecificdata = &$info_real_chunks_current_chunk['type_specific_data']; + + switch ($info_real_chunks_current_chunk['mime_type']) { + + case 'video/x-pn-realvideo': + case 'video/x-pn-multirate-realvideo': + // http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html + + $info_real_chunks_current_chunk['video_info'] = array (); + $info_real_chunks_current_chunk_video_info = &$info_real_chunks_current_chunk['video_info']; + + getid3_lib::ReadSequence('BigEndian2Int', $info_real_chunks_current_chunk_video_info, $info_real_chunks_current_chunk_typespecificdata, 0, + array ( + 'dwSize' => 4, + 'fourcc1' => -4, + 'fourcc2' => -4, + 'width' => 2, + 'height' => 2, + 'bits_per_sample' => 2, + 'IGNORE-unknown1' => 2, + 'IGNORE-unknown2' => 2, + 'frames_per_second' => 2, + 'IGNORE-unknown3' => 2, + 'IGNORE-unknown4' => 2, + 'IGNORE-unknown5' => 2, + 'IGNORE-unknown6' => 2, + 'IGNORE-unknown7' => 2, + 'IGNORE-unknown8' => 2, + 'IGNORE-unknown9' => 2 + ) + ); + + $info_real_chunks_current_chunk_video_info['codec'] = getid3_riff::RIFFfourccLookup($info_real_chunks_current_chunk_video_info['fourcc2']); + + $getid3->info['video']['resolution_x'] = $info_real_chunks_current_chunk_video_info['width']; + $getid3->info['video']['resolution_y'] = $info_real_chunks_current_chunk_video_info['height']; + $getid3->info['video']['frame_rate'] = (float)$info_real_chunks_current_chunk_video_info['frames_per_second']; + $getid3->info['video']['codec'] = $info_real_chunks_current_chunk_video_info['codec']; + $getid3->info['video']['bits_per_sample'] = $info_real_chunks_current_chunk_video_info['bits_per_sample']; + break; + + + case 'audio/x-pn-realaudio': + case 'audio/x-pn-multirate-realaudio': + + $this->ParseOldRAheader($info_real_chunks_current_chunk_typespecificdata, $info_real_chunks_current_chunk['parsed_audio_data']); + + $getid3->info['audio']['sample_rate'] = $info_real_chunks_current_chunk['parsed_audio_data']['sample_rate']; + $getid3->info['audio']['bits_per_sample'] = $info_real_chunks_current_chunk['parsed_audio_data']['bits_per_sample']; + $getid3->info['audio']['channels'] = $info_real_chunks_current_chunk['parsed_audio_data']['channels']; + + if (!empty($getid3->info['audio']['dataformat'])) { + foreach ($getid3->info['audio'] as $key => $value) { + if ($key != 'streams') { + $getid3->info['audio']['streams'][$info_real_chunks_current_chunk['stream_number']][$key] = $value; + } + } + } + break; + + + case 'logical-fileinfo': + + $info_real_chunks_current_chunk['logical_fileinfo']['logical_fileinfo_length'] = getid3_lib::BigEndian2Int(substr($info_real_chunks_current_chunk_typespecificdata, 0, 4)); + // $info_real_chunks_current_chunk['logical_fileinfo']['IGNORE-unknown1'] = getid3_lib::BigEndian2Int(substr($info_real_chunks_current_chunk_typespecificdata, 4, 4)); + $info_real_chunks_current_chunk['logical_fileinfo']['num_tags'] = getid3_lib::BigEndian2Int(substr($info_real_chunks_current_chunk_typespecificdata, 8, 4)); + // $info_real_chunks_current_chunk['logical_fileinfo']['IGNORE-unknown2'] = getid3_lib::BigEndian2Int(substr($info_real_chunks_current_chunk_typespecificdata, 12, 4)); + break; + + } + + + if (empty($getid3->info['playtime_seconds'])) { + $getid3->info['playtime_seconds'] = max($getid3->info['playtime_seconds'], ($info_real_chunks_current_chunk['duration'] + $info_real_chunks_current_chunk['start_time']) / 1000); + } + + if ($info_real_chunks_current_chunk['duration'] > 0) { + + switch ($info_real_chunks_current_chunk['mime_type']) { + + case 'audio/x-pn-realaudio': + case 'audio/x-pn-multirate-realaudio': + + $getid3->info['audio']['bitrate'] = (isset($getid3->info['audio']['bitrate']) ? $getid3->info['audio']['bitrate'] : 0) + $info_real_chunks_current_chunk['avg_bit_rate']; + $getid3->info['audio']['codec'] = $this->RealAudioCodecFourCClookup($info_real_chunks_current_chunk['parsed_audio_data']['fourcc'], $getid3->info['audio']['bitrate']); + $getid3->info['audio']['dataformat'] = 'real'; + $getid3->info['audio']['lossless'] = false; + break; + + + case 'video/x-pn-realvideo': + case 'video/x-pn-multirate-realvideo': + + $getid3->info['video']['bitrate'] = (isset($getid3->info['video']['bitrate']) ? $getid3->info['video']['bitrate'] : 0) + $info_real_chunks_current_chunk['avg_bit_rate']; + $getid3->info['video']['bitrate_mode'] = 'cbr'; + $getid3->info['video']['dataformat'] = 'real'; + $getid3->info['video']['lossless'] = false; + $getid3->info['video']['pixel_aspect_ratio'] = (float)1; + break; + + + case 'audio/x-ralf-mpeg4-generic': + + $getid3->info['audio']['bitrate'] = (isset($getid3->info['audio']['bitrate']) ? $getid3->info['audio']['bitrate'] : 0) + $info_real_chunks_current_chunk['avg_bit_rate']; + $getid3->info['audio']['codec'] = 'RealAudio Lossless'; + $getid3->info['audio']['dataformat'] = 'real'; + $getid3->info['audio']['lossless'] = true; + break; + + } + + $getid3->info['bitrate'] = (isset($getid3->info['video']['bitrate']) ? $getid3->info['video']['bitrate'] : 0) + (isset($getid3->info['audio']['bitrate']) ? $getid3->info['audio']['bitrate'] : 0); + } + } + break; + + + case 'CONT': // Content Description Header (text comments) + + $info_real_chunks_current_chunk['object_version'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + if ($info_real_chunks_current_chunk['object_version'] == 0) { + + $info_real_chunks_current_chunk['title_len'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + $info_real_chunks_current_chunk['title'] = (string) substr($chunk_data, $offset, $info_real_chunks_current_chunk['title_len']); + $offset += $info_real_chunks_current_chunk['title_len']; + + $info_real_chunks_current_chunk['artist_len'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + $info_real_chunks_current_chunk['artist'] = (string) substr($chunk_data, $offset, $info_real_chunks_current_chunk['artist_len']); + $offset += $info_real_chunks_current_chunk['artist_len']; + + $info_real_chunks_current_chunk['copyright_len'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + $info_real_chunks_current_chunk['copyright'] = (string) substr($chunk_data, $offset, $info_real_chunks_current_chunk['copyright_len']); + $offset += $info_real_chunks_current_chunk['copyright_len']; + + $info_real_chunks_current_chunk['comment_len'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + $info_real_chunks_current_chunk['comment'] = (string) substr($chunk_data, $offset, $info_real_chunks_current_chunk['comment_len']); + $offset += $info_real_chunks_current_chunk['comment_len']; + + foreach (array ('title'=>'title', 'artist'=>'artist', 'copyright'=>'copyright', 'comment'=>'comment') as $key => $val) { + if ($info_real_chunks_current_chunk[$key]) { + $getid3->info['real']['comments'][$val][] = trim($info_real_chunks_current_chunk[$key]); + } + } + } + break; + + + case 'DATA': // Data Chunk Header + + // do nothing + break; + + + case 'INDX': // Index Section Header + + $info_real_chunks_current_chunk['object_version'] = getid3_lib::BigEndian2Int(substr($chunk_data, $offset, 2)); + $offset += 2; + + if ($info_real_chunks_current_chunk['object_version'] == 0) { + + getid3_lib::ReadSequence('BigEndian2Int', $info_real_chunks_current_chunk, $chunk_data, $offset, + array ( + 'num_indices' => 4, + 'stream_number' => 2, + 'next_index_header' => 4 + ) + ); + $offset += 10; + + if ($info_real_chunks_current_chunk['next_index_header'] == 0) { + // last index chunk found, ignore rest of file + break 2; + } else { + // non-last index chunk, seek to next index chunk (skipping actual index data) + fseek($getid3->fp, $info_real_chunks_current_chunk['next_index_header'], SEEK_SET); + } + } + break; + + + default: + $getid3->warning('Unhandled RealMedia chunk "'.$chunk_name.'" at offset '.$info_real_chunks_current_chunk['offset']); + break; + } + $chunk_counter++; + } + + if (!empty($getid3->info['audio']['streams'])) { + + $getid3->info['audio']['bitrate'] = 0; + + foreach ($getid3->info['audio']['streams'] as $key => $value_array) { + $getid3->info['audio']['bitrate'] += $value_array['bitrate']; + } + } + + return true; + } + + + + public static function ParseOldRAheader($old_ra_header_data, &$parsed_array) { + + // http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html + + $parsed_array = array (); + $parsed_array['magic'] = substr($old_ra_header_data, 0, 4); + + if ($parsed_array['magic'] != '.ra'."\xFD") { + return false; + } + + $parsed_array['version1'] = getid3_lib::BigEndian2Int(substr($old_ra_header_data, 4, 2)); + + if ($parsed_array['version1'] < 3) { + + return false; + } + + if ($parsed_array['version1'] == 3) { + + $parsed_array['fourcc1'] = '.ra3'; + $parsed_array['bits_per_sample'] = 16; // hard-coded for old versions? + $parsed_array['sample_rate'] = 8000; // hard-coded for old versions? + + getid3_lib::ReadSequence('BigEndian2Int', $parsed_array, $old_ra_header_data, 6, + array ( + 'header_size' => 2, + 'channels' => 2, // always 1 (?) + 'IGNORE-unknown1' => 2, + 'IGNORE-unknown2' => 2, + 'IGNORE-unknown3' => 2, + 'bytes_per_minute' => 2, + 'audio_bytes' => 4, + ) + ); + + $parsed_array['comments_raw'] = substr($old_ra_header_data, 22, $parsed_array['header_size'] - 22 + 1); // not including null terminator + + $comment_offset = 0; + + foreach (array ('title', 'artist', 'copyright') as $name) { + $comment_length = getid3_lib::BigEndian2Int($parsed_array['comments_raw']{$comment_offset++}); + $parsed_array['comments'][$name][]= substr($parsed_array['comments_raw'], $comment_offset, $comment_length); + $comment_offset += $comment_length; + } + + $comment_offset++; // final null terminator (?) + $comment_offset++; // fourcc length (?) should be 4 + + $parsed_array['fourcc'] = substr($old_ra_header_data, 23 + $comment_offset, 4); + + + } elseif ($parsed_array['version1'] <= 5) { + + getid3_lib::ReadSequence('BigEndian2Int', $parsed_array, $old_ra_header_data, 6, + array ( + 'IGNORE-unknown1' => 2, + 'fourcc1' => -4, + 'file_size' => 4, + 'version2' => 2, + 'header_size' => 4, + 'codec_flavor_id' => 2, + 'coded_frame_size' => 4, + 'audio_bytes' => 4, + 'bytes_per_minute' => 4, + 'IGNORE-unknown5' => 4, + 'sub_packet_h' => 2, + 'frame_size' => 2, + 'sub_packet_size' => 2, + 'IGNORE-unknown6' => 2 + ) + ); + + switch ($parsed_array['version1']) { + + case 4: + + getid3_lib::ReadSequence('BigEndian2Int', $parsed_array, $old_ra_header_data, 48, + array ( + 'sample_rate' => 2, + 'IGNORE-unknown8' => 2, + 'bits_per_sample' => 2, + 'channels' => 2, + 'length_fourcc2' => 1, + 'fourcc2' => -4, + 'length_fourcc3' => 1, + 'fourcc3' => -4, + 'IGNORE-unknown9' => 1, + 'IGNORE-unknown10' => 2, + ) + ); + + $parsed_array['comments_raw'] = substr($old_ra_header_data, 69, $parsed_array['header_size'] - 69 + 16); + + $comment_offset = 0; + + foreach (array ('title', 'artist', 'copyright') as $name) { + $comment_length = getid3_lib::BigEndian2Int($parsed_array['comments_raw']{$comment_offset++}); + $parsed_array['comments'][$name][]= substr($parsed_array['comments_raw'], $comment_offset, $comment_length); + $comment_offset += $comment_length; + } + break; + + + case 5: + + getid3_lib::ReadSequence('BigEndian2Int', $parsed_array, $old_ra_header_data, 48, + array ( + 'sample_rate' => 4, + 'sample_rate2' => 4, + 'bits_per_sample' => 4, + 'channels' => 2, + 'genr' => -4, + 'fourcc3' => -4, + ) + ); + $parsed_array['comments'] = array (); + break; + + } + + $parsed_array['fourcc'] = $parsed_array['fourcc3']; + + } + + foreach ($parsed_array['comments'] as $key => $value) { + + if ($parsed_array['comments'][$key][0] === false) { + $parsed_array['comments'][$key][0] = ''; + } + } + + return true; + } + + + + public static function RealAudioCodecFourCClookup($fourcc, $bitrate) { + + // http://www.its.msstate.edu/net/real/reports/config/tags.stats + // http://www.freelists.org/archives/matroska-devel/06-2003/fullthread18.html + + static $lookup; + + if (empty($lookup)) { + $lookup['14_4'][8000] = 'RealAudio v2 (14.4kbps)'; + $lookup['14.4'][8000] = 'RealAudio v2 (14.4kbps)'; + $lookup['lpcJ'][8000] = 'RealAudio v2 (14.4kbps)'; + $lookup['28_8'][15200] = 'RealAudio v2 (28.8kbps)'; + $lookup['28.8'][15200] = 'RealAudio v2 (28.8kbps)'; + $lookup['sipr'][4933] = 'RealAudio v4 (5kbps Voice)'; + $lookup['sipr'][6444] = 'RealAudio v4 (6.5kbps Voice)'; + $lookup['sipr'][8444] = 'RealAudio v4 (8.5kbps Voice)'; + $lookup['sipr'][16000] = 'RealAudio v4 (16kbps Wideband)'; + $lookup['dnet'][8000] = 'RealAudio v3 (8kbps Music)'; + $lookup['dnet'][16000] = 'RealAudio v3 (16kbps Music Low Response)'; + $lookup['dnet'][15963] = 'RealAudio v3 (16kbps Music Mid/High Response)'; + $lookup['dnet'][20000] = 'RealAudio v3 (20kbps Music Stereo)'; + $lookup['dnet'][32000] = 'RealAudio v3 (32kbps Music Mono)'; + $lookup['dnet'][31951] = 'RealAudio v3 (32kbps Music Stereo)'; + $lookup['dnet'][39965] = 'RealAudio v3 (40kbps Music Mono)'; + $lookup['dnet'][40000] = 'RealAudio v3 (40kbps Music Stereo)'; + $lookup['dnet'][79947] = 'RealAudio v3 (80kbps Music Mono)'; + $lookup['dnet'][80000] = 'RealAudio v3 (80kbps Music Stereo)'; + + $lookup['dnet'][0] = 'RealAudio v3'; + $lookup['sipr'][0] = 'RealAudio v4'; + $lookup['cook'][0] = 'RealAudio G2'; + $lookup['atrc'][0] = 'RealAudio 8'; + } + + $round_bitrate = intval(round($bitrate)); + + if (isset($lookup[$fourcc][$round_bitrate])) { + return $lookup[$fourcc][$round_bitrate]; + } + + if (isset($lookup[$fourcc][0])) { + return $lookup[$fourcc][0]; + } + + return $fourcc; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.riff.php b/modules/getid3/module.audio-video.riff.php new file mode 100644 index 00000000..96bad165 --- /dev/null +++ b/modules/getid3/module.audio-video.riff.php @@ -0,0 +1,2319 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio-video.riff.php | +// | module for analyzing RIFF files: | +// | Wave, AVI, AIFF/AIFC, (MP3,AC3)/RIFF, Wavpack3, 8SVX | +// | dependencies: module.audio.mp3.php (optional) | +// | module.audio.ac3.php (optional) | +// | module.audio.dts.php (optional) | +// | module.audio-video.mpeg.php (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.riff.php,v 1.10 2006/12/03 20:13:17 ah Exp $ + + + +class getid3_riff extends getid3_handler +{ + + private $endian_function = 'LittleEndian2Int'; + + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['riff']['raw'] = array (); + $info_riff = &$getid3->info['riff']; + $info_riff_raw = &$info_riff['raw']; + $info_audio = &$getid3->info['audio']; + $info_video = &$getid3->info['video']; + $info_avdataoffset = &$getid3->info['avdataoffset']; + $info_avdataend = &$getid3->info['avdataend']; + $info_audio_dataformat = &$info_audio['dataformat']; + $info_riff_audio = &$info_riff['audio']; + $info_riff_video = &$info_riff['video']; + + $original['avdataend'] = $info_avdataend; + + $this->fseek($info_avdataoffset, SEEK_SET); + $riff_header = $this->fread(12); + + $riff_sub_type = substr($riff_header, 8, 4); + + switch (substr($riff_header, 0, 4)) { + + case 'FORM': + $getid3->info['fileformat'] = 'aiff'; + $this->endian_function = 'BigEndian2Int'; + $riff_header_size = getid3_lib::BigEndian2Int(substr($riff_header, 4, 4)); + $info_riff[$riff_sub_type] = $this->ParseRIFF($info_avdataoffset + 12, $info_avdataoffset + $riff_header_size); + $info_riff['header_size'] = $riff_header_size; + break; + + + case 'RIFF': + case 'SDSS': // SDSS is identical to RIFF, just renamed. Used by SmartSound QuickTracks (www.smartsound.com) + case 'RMP3': // RMP3 is identical to RIFF, just renamed. Used by [unknown program] when creating RIFF-MP3s + + if ($riff_sub_type == 'RMP3') { + $riff_sub_type = 'WAVE'; + } + + $getid3->info['fileformat'] = 'riff'; + $this->endian_function = 'LittleEndian2Int'; + $riff_header_size = getid3_lib::LittleEndian2Int(substr($riff_header, 4, 4)); + $info_riff[$riff_sub_type] = $this->ParseRIFF($info_avdataoffset + 12, $info_avdataoffset + $riff_header_size); + $info_riff['header_size'] = $riff_header_size; + if ($riff_sub_type == 'WAVE') { + $info_riff_wave = &$info_riff['WAVE']; + } + break; + + + default: + throw new getid3_exception('Cannot parse RIFF (this is maybe not a RIFF / WAV / AVI file?) - expecting "FORM|RIFF|SDSS|RMP3" found "'.$riff_sub_type.'" instead'); + } + + $endian_function = $this->endian_function; + + $stream_index = 0; + switch ($riff_sub_type) { + + case 'WAVE': + + if (empty($info_audio['bitrate_mode'])) { + $info_audio['bitrate_mode'] = 'cbr'; + } + + if (empty($info_audio_dataformat)) { + $info_audio_dataformat = 'wav'; + } + + if (isset($info_riff_wave['data'][0]['offset'])) { + $info_avdataoffset = $info_riff_wave['data'][0]['offset'] + 8; + $info_avdataend = $info_avdataoffset + $info_riff_wave['data'][0]['size']; + } + + if (isset($info_riff_wave['fmt '][0]['data'])) { + + $info_riff_audio[$stream_index] = getid3_riff::RIFFparseWAVEFORMATex($info_riff_wave['fmt '][0]['data']); + $info_audio['wformattag'] = $info_riff_audio[$stream_index]['raw']['wFormatTag']; + $info_riff_raw['fmt '] = $info_riff_audio[$stream_index]['raw']; + unset($info_riff_audio[$stream_index]['raw']); + $info_audio['streams'][$stream_index] = $info_riff_audio[$stream_index]; + + $info_audio = getid3_riff::array_merge_noclobber($info_audio, $info_riff_audio[$stream_index]); + if (substr($info_audio['codec'], 0, strlen('unknown: 0x')) == 'unknown: 0x') { + $getid3->warning('Audio codec = '.$info_audio['codec']); + } + $info_audio['bitrate'] = $info_riff_audio[$stream_index]['bitrate']; + + $getid3->info['playtime_seconds'] = (float)((($info_avdataend - $info_avdataoffset) * 8) / $info_audio['bitrate']); + + $info_audio['lossless'] = false; + + if (isset($info_riff_wave['data'][0]['offset']) && isset($info_riff_raw['fmt ']['wFormatTag'])) { + + switch ($info_riff_raw['fmt ']['wFormatTag']) { + + case 0x0001: // PCM + $info_audio['lossless'] = true; + break; + + case 0x2000: // AC-3 + $info_audio_dataformat = 'ac3'; + break; + + default: + // do nothing + break; + + } + } + + $info_audio['streams'][$stream_index]['wformattag'] = $info_audio['wformattag']; + $info_audio['streams'][$stream_index]['bitrate_mode'] = $info_audio['bitrate_mode']; + $info_audio['streams'][$stream_index]['lossless'] = $info_audio['lossless']; + $info_audio['streams'][$stream_index]['dataformat'] = $info_audio_dataformat; + } + + + if (isset($info_riff_wave['rgad'][0]['data'])) { + + // shortcuts + $rgadData = &$info_riff_wave['rgad'][0]['data']; + $info_riff_raw['rgad'] = array ('track'=>array(), 'album'=>array()); + $info_riff_raw_rgad = &$info_riff_raw['rgad']; + $info_riff_raw_rgad_track = &$info_riff_raw_rgad['track']; + $info_riff_raw_rgad_album = &$info_riff_raw_rgad['album']; + + $info_riff_raw_rgad['fPeakAmplitude'] = getid3_riff::BigEndian2Float(strrev(substr($rgadData, 0, 4))); // LittleEndian2Float() + $info_riff_raw_rgad['nRadioRgAdjust'] = getid3_lib::$endian_function(substr($rgadData, 4, 2)); + $info_riff_raw_rgad['nAudiophileRgAdjust'] = getid3_lib::$endian_function(substr($rgadData, 6, 2)); + + $n_track_rg_adjust_bit_string = str_pad(decbin($info_riff_raw_rgad['nRadioRgAdjust']), 16, '0', STR_PAD_LEFT); + $n_album_rg_adjust_bit_string = str_pad(decbin($info_riff_raw_rgad['nAudiophileRgAdjust']), 16, '0', STR_PAD_LEFT); + + $info_riff_raw_rgad_track['name'] = bindec(substr($n_track_rg_adjust_bit_string, 0, 3)); + $info_riff_raw_rgad_track['originator'] = bindec(substr($n_track_rg_adjust_bit_string, 3, 3)); + $info_riff_raw_rgad_track['signbit'] = bindec($n_track_rg_adjust_bit_string[6]); + $info_riff_raw_rgad_track['adjustment'] = bindec(substr($n_track_rg_adjust_bit_string, 7, 9)); + $info_riff_raw_rgad_album['name'] = bindec(substr($n_album_rg_adjust_bit_string, 0, 3)); + $info_riff_raw_rgad_album['originator'] = bindec(substr($n_album_rg_adjust_bit_string, 3, 3)); + $info_riff_raw_rgad_album['signbit'] = bindec($n_album_rg_adjust_bit_string[6]); + $info_riff_raw_rgad_album['adjustment'] = bindec(substr($n_album_rg_adjust_bit_string, 7, 9)); + + $info_riff['rgad']['peakamplitude'] = $info_riff_raw_rgad['fPeakAmplitude']; + if (($info_riff_raw_rgad_track['name'] != 0) && ($info_riff_raw_rgad_track['originator'] != 0)) { + $info_riff['rgad']['track']['name'] = getid3_lib_replaygain::NameLookup($info_riff_raw_rgad_track['name']); + $info_riff['rgad']['track']['originator'] = getid3_lib_replaygain::OriginatorLookup($info_riff_raw_rgad_track['originator']); + $info_riff['rgad']['track']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($info_riff_raw_rgad_track['adjustment'], $info_riff_raw_rgad_track['signbit']); + } + + if (($info_riff_raw_rgad_album['name'] != 0) && ($info_riff_raw_rgad_album['originator'] != 0)) { + $info_riff['rgad']['album']['name'] = getid3_lib_replaygain::NameLookup($info_riff_raw_rgad_album['name']); + $info_riff['rgad']['album']['originator'] = getid3_lib_replaygain::OriginatorLookup($info_riff_raw_rgad_album['originator']); + $info_riff['rgad']['album']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($info_riff_raw_rgad_album['adjustment'], $info_riff_raw_rgad_album['signbit']); + } + } + + if (isset($info_riff_wave['fact'][0]['data'])) { + + $info_riff_raw['fact']['NumberOfSamples'] = getid3_lib::$endian_function(substr($info_riff_wave['fact'][0]['data'], 0, 4)); + + // This should be a good way of calculating exact playtime, but some sample files have had incorrect number of samples, so cannot use this method + // if (!empty($info_riff_raw['fmt ']['nSamplesPerSec'])) { + // $getid3->info['playtime_seconds'] = (float)$info_riff_raw['fact']['NumberOfSamples'] / $info_riff_raw['fmt ']['nSamplesPerSec']; + // } + } + + + if (!empty($info_riff_raw['fmt ']['nAvgBytesPerSec'])) { + $info_audio['bitrate'] = (int)$info_riff_raw['fmt ']['nAvgBytesPerSec'] * 8; + } + + if (isset($info_riff_wave['bext'][0]['data'])) { + + $info_riff_wave_bext_0 = &$info_riff_wave['bext'][0]; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_riff_wave_bext_0, $info_riff_wave_bext_0['data'], 0, + array ( + 'title' => -256, + 'author' => -32, + 'reference' => -32, + 'origin_date' => -10, + 'origin_time' => -8, + 'time_reference' => 8, + 'bwf_version' => 1, + 'reserved' => 254 + ) + ); + + foreach (array ('title', 'author', 'reference') as $key) { + $info_riff_wave_bext_0[$key] = trim($info_riff_wave_bext_0[$key]); + } + + $info_riff_wave_bext_0['coding_history'] = explode("\r\n", trim(substr($info_riff_wave_bext_0['data'], 601))); + + $info_riff_wave_bext_0['origin_date_unix'] = gmmktime(substr($info_riff_wave_bext_0['origin_time'], 0, 2), + substr($info_riff_wave_bext_0['origin_time'], 3, 2), + substr($info_riff_wave_bext_0['origin_time'], 6, 2), + substr($info_riff_wave_bext_0['origin_date'], 5, 2), + substr($info_riff_wave_bext_0['origin_date'], 8, 2), + substr($info_riff_wave_bext_0['origin_date'], 0, 4)); + + $info_riff['comments']['author'][] = $info_riff_wave_bext_0['author']; + $info_riff['comments']['title'][] = $info_riff_wave_bext_0['title']; + } + + if (isset($info_riff_wave['MEXT'][0]['data'])) { + + $info_riff_wave_mext_0 = &$info_riff_wave['MEXT'][0]; + + $info_riff_wave_mext_0['raw']['sound_information'] = getid3_lib::LittleEndian2Int(substr($info_riff_wave_mext_0['data'], 0, 2)); + $info_riff_wave_mext_0['flags']['homogenous'] = (bool)($info_riff_wave_mext_0['raw']['sound_information'] & 0x0001); + if ($info_riff_wave_mext_0['flags']['homogenous']) { + $info_riff_wave_mext_0['flags']['padding'] = ($info_riff_wave_mext_0['raw']['sound_information'] & 0x0002) ? false : true; + $info_riff_wave_mext_0['flags']['22_or_44'] = (bool)($info_riff_wave_mext_0['raw']['sound_information'] & 0x0004); + $info_riff_wave_mext_0['flags']['free_format'] = (bool)($info_riff_wave_mext_0['raw']['sound_information'] & 0x0008); + + $info_riff_wave_mext_0['nominal_frame_size'] = getid3_lib::LittleEndian2Int(substr($info_riff_wave_mext_0['data'], 2, 2)); + } + $info_riff_wave_mext_0['anciliary_data_length'] = getid3_lib::LittleEndian2Int(substr($info_riff_wave_mext_0['data'], 6, 2)); + $info_riff_wave_mext_0['raw']['anciliary_data_def'] = getid3_lib::LittleEndian2Int(substr($info_riff_wave_mext_0['data'], 8, 2)); + $info_riff_wave_mext_0['flags']['anciliary_data_left'] = (bool)($info_riff_wave_mext_0['raw']['anciliary_data_def'] & 0x0001); + $info_riff_wave_mext_0['flags']['anciliary_data_free'] = (bool)($info_riff_wave_mext_0['raw']['anciliary_data_def'] & 0x0002); + $info_riff_wave_mext_0['flags']['anciliary_data_right'] = (bool)($info_riff_wave_mext_0['raw']['anciliary_data_def'] & 0x0004); + } + + if (isset($info_riff_wave['cart'][0]['data'])) { + + $info_riff_wave_cart_0 = &$info_riff_wave['cart'][0]; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_riff_wave_cart_0, $info_riff_wave_cart_0['data'], 0, + array ( + 'version' => -4, + 'title' => -64, + 'artist' => -64, + 'cut_id' => -64, + 'client_id' => -64, + 'category' => -64, + 'classification' => -64, + 'out_cue' => -64, + 'start_date' => -10, + 'start_time' => -8, + 'end_date' => -10, + 'end_time' => -8, + 'producer_app_id' => -64, + 'producer_app_version' => -64, + 'user_defined_text' => -64, + ) + ); + + foreach (array ('artist', 'cut_id', 'client_id', 'category', 'classification', 'out_cue', 'start_date', 'start_time', 'end_date', 'end_time', 'producer_app_id', 'producer_app_version', 'user_defined_text') as $key) { + $info_riff_wave_cart_0[$key] = trim($info_riff_wave_cart_0[$key]); + } + + $info_riff_wave_cart_0['zero_db_reference'] = getid3_lib::LittleEndian2Int(substr($info_riff_wave_cart_0['data'], 680, 4), true); + + for ($i = 0; $i < 8; $i++) { + $info_riff_wave_cart_0['post_time'][$i]['usage_fourcc'] = substr($info_riff_wave_cart_0['data'], 684 + ($i * 8), 4); + $info_riff_wave_cart_0['post_time'][$i]['timer_value'] = getid3_lib::LittleEndian2Int(substr($info_riff_wave_cart_0['data'], 684 + ($i * 8) + 4, 4)); + } + $info_riff_wave_cart_0['url'] = trim(substr($info_riff_wave_cart_0['data'], 748, 1024)); + $info_riff_wave_cart_0['tag_text'] = explode("\r\n", trim(substr($info_riff_wave_cart_0['data'], 1772))); + + $info_riff['comments']['artist'][] = $info_riff_wave_cart_0['artist']; + $info_riff['comments']['title'][] = $info_riff_wave_cart_0['title']; + } + + if (!isset($info_audio['bitrate']) && isset($info_riff_audio[$stream_index]['bitrate'])) { + $info_audio['bitrate'] = $info_riff_audio[$stream_index]['bitrate']; + $getid3->info['playtime_seconds'] = (float)((($info_avdataend - $info_avdataoffset) * 8) / $info_audio['bitrate']); + } + + if (@$getid3->info['wavpack']) { + + if (!$this->data_string_flag) { + + $info_audio_dataformat = 'wavpack'; + $info_audio['bitrate_mode'] = 'vbr'; + $info_audio['encoder'] = 'WavPack v'.$getid3->info['wavpack']['version']; + + // Reset to the way it was - RIFF parsing will have messed this up + $info_avdataend = $original['avdataend']; + $info_audio['bitrate'] = (($info_avdataend - $info_avdataoffset) * 8) / $getid3->info['playtime_seconds']; + + $this->fseek($info_avdataoffset - 44, SEEK_SET); + $riff_data = $this->fread(44); + $orignal_riff_header_size = getid3_lib::LittleEndian2Int(substr($riff_data, 4, 4)) + 8; + $orignal_riff_data_size = getid3_lib::LittleEndian2Int(substr($riff_data, 40, 4)) + 44; + + if ($orignal_riff_header_size > $orignal_riff_data_size) { + $info_avdataend -= ($orignal_riff_header_size - $orignal_riff_data_size); + $this->fseek($info_avdataend, SEEK_SET); + $riff_data .= $this->fread($orignal_riff_header_size - $orignal_riff_data_size); + } + + // move the data chunk after all other chunks (if any) + // so that the RIFF parser doesn't see EOF when trying + // to skip over the data chunk + $riff_data = substr($riff_data, 0, 36).substr($riff_data, 44).substr($riff_data, 36, 8); + + // Save audio info key + $saved_info_audio = $info_audio; + + // Analyze riff_data + $this->AnalyzeString($riff_data); + + // Restore info key + $info_audio = $saved_info_audio; + } + } + + if (isset($info_riff_raw['fmt ']['wFormatTag'])) { + + switch ($info_riff_raw['fmt ']['wFormatTag']) { + + case 0x08AE: // ClearJump LiteWave + $info_audio['bitrate_mode'] = 'vbr'; + $info_audio_dataformat = 'litewave'; + + //typedef struct tagSLwFormat { + // WORD m_wCompFormat; // low byte defines compression method, high byte is compression flags + // DWORD m_dwScale; // scale factor for lossy compression + // DWORD m_dwBlockSize; // number of samples in encoded blocks + // WORD m_wQuality; // alias for the scale factor + // WORD m_wMarkDistance; // distance between marks in bytes + // WORD m_wReserved; + // + // //following paramters are ignored if CF_FILESRC is not set + // DWORD m_dwOrgSize; // original file size in bytes + // WORD m_bFactExists; // indicates if 'fact' chunk exists in the original file + // DWORD m_dwRiffChunkSize; // riff chunk size in the original file + // + // PCMWAVEFORMAT m_OrgWf; // original wave format + // }SLwFormat, *PSLwFormat; + + $info_riff['litewave']['raw'] = array (); + $info_riff_litewave = &$info_riff['litewave']; + $info_riff_litewave_raw = &$info_riff_litewave['raw']; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_riff_litewave_raw, $info_riff_wave['fmt '][0]['data'], 18, + array ( + 'compression_method' => 1, + 'compression_flags' => 1, + 'm_dwScale' => 4, + 'm_dwBlockSize' => 4, + 'm_wQuality' => 2, + 'm_wMarkDistance' => 2, + 'm_wReserved' => 2, + 'm_dwOrgSize' => 4, + 'm_bFactExists' => 2, + 'm_dwRiffChunkSize' => 4 + ) + ); + + //$info_riff_litewave['quality_factor'] = intval(round((2000 - $info_riff_litewave_raw['m_dwScale']) / 20)); + $info_riff_litewave['quality_factor'] = $info_riff_litewave_raw['m_wQuality']; + + $info_riff_litewave['flags']['raw_source'] = ($info_riff_litewave_raw['compression_flags'] & 0x01) ? false : true; + $info_riff_litewave['flags']['vbr_blocksize'] = ($info_riff_litewave_raw['compression_flags'] & 0x02) ? false : true; + $info_riff_litewave['flags']['seekpoints'] = (bool)($info_riff_litewave_raw['compression_flags'] & 0x04); + + $info_audio['lossless'] = (($info_riff_litewave_raw['m_wQuality'] == 100) ? true : false); + $info_audio['encoder_options'] = '-q'.$info_riff_litewave['quality_factor']; + break; + } + } + + if ($info_avdataend > $getid3->info['filesize']) { + + switch (@$info_audio_dataformat) { + + case 'wavpack': // WavPack + case 'lpac': // LPAC + case 'ofr': // OptimFROG + case 'ofs': // OptimFROG DualStream + // lossless compressed audio formats that keep original RIFF headers - skip warning + break; + + + case 'litewave': + + if (($info_avdataend - $getid3->info['filesize']) == 1) { + // LiteWave appears to incorrectly *not* pad actual output file + // to nearest WORD boundary so may appear to be short by one + // byte, in which case - skip warning + } else { + // Short by more than one byte, throw warning + $getid3->warning('Probably truncated file - expecting '.$info_riff[$riff_sub_type]['data'][0]['size'].' bytes of data, only found '.($getid3->info['filesize'] - $info_avdataoffset).' (short by '.($info_riff[$riff_sub_type]['data'][0]['size'] - ($getid3->info['filesize'] - $info_avdataoffset)).' bytes)'); + } + break; + + + default: + + if ((($info_avdataend - $getid3->info['filesize']) == 1) && (($info_riff[$riff_sub_type]['data'][0]['size'] % 2) == 0) && ((($getid3->info['filesize'] - $info_avdataoffset) % 2) == 1)) { + // output file appears to be incorrectly *not* padded to nearest WORD boundary + // Output less severe warning + $getid3->warning('File should probably be padded to nearest WORD boundary, but it is not (expecting '.$info_riff[$riff_sub_type]['data'][0]['size'].' bytes of data, only found '.($getid3->info['filesize'] - $info_avdataoffset).' therefore short by '.($info_riff[$riff_sub_type]['data'][0]['size'] - ($getid3->info['filesize'] - $info_avdataoffset)).' bytes)'); + $info_avdataend = $getid3->info['filesize']; + break; + + } + // Short by more than one byte, throw warning + $getid3->warning('Probably truncated file - expecting '.$info_riff[$riff_sub_type]['data'][0]['size'].' bytes of data, only found '.($getid3->info['filesize'] - $info_avdataoffset).' (short by '.($info_riff[$riff_sub_type]['data'][0]['size'] - ($getid3->info['filesize'] - $info_avdataoffset)).' bytes)'); + $info_avdataend = $getid3->info['filesize']; + break; + } + } + + if (!empty($getid3->info['mpeg']['audio']['LAME']['audio_bytes'])) { + if ((($info_avdataend - $info_avdataoffset) - $getid3->info['mpeg']['audio']['LAME']['audio_bytes']) == 1) { + $info_avdataend--; + $getid3->warning('Extra null byte at end of MP3 data assumed to be RIFF padding and therefore ignored'); + } + } + + if (@$info_audio_dataformat == 'ac3') { + unset($info_audio['bits_per_sample']); + if (!empty($getid3->info['ac3']['bitrate']) && ($getid3->info['ac3']['bitrate'] != $info_audio['bitrate'])) { + $info_audio['bitrate'] = $getid3->info['ac3']['bitrate']; + } + } + break; + + + case 'AVI ': + $info_video['bitrate_mode'] = 'vbr'; // maybe not, but probably + $info_video['dataformat'] = 'avi'; + $getid3->info['mime_type'] = 'video/avi'; + + if (isset($info_riff[$riff_sub_type]['movi']['offset'])) { + $info_avdataoffset = $info_riff[$riff_sub_type]['movi']['offset'] + 8; + $info_avdataend = $info_avdataoffset + $info_riff[$riff_sub_type]['movi']['size']; + if ($info_avdataend > $getid3->info['filesize']) { + $getid3->warning('Probably truncated file - expecting '.$info_riff[$riff_sub_type]['movi']['size'].' bytes of data, only found '.($getid3->info['filesize'] - $info_avdataoffset).' (short by '.($info_riff[$riff_sub_type]['movi']['size'] - ($getid3->info['filesize'] - $info_avdataoffset)).' bytes)'); + $info_avdataend = $getid3->info['filesize']; + } + } + + if (isset($info_riff['AVI ']['hdrl']['avih'][$stream_index]['data'])) { + $avihData = $info_riff['AVI ']['hdrl']['avih'][$stream_index]['data']; + + $info_riff_raw['avih'] = array (); + $info_riff_raw_avih = &$info_riff_raw['avih']; + + getid3_lib::ReadSequence($this->endian_function, $info_riff_raw_avih, $avihData, 0, + array ( + 'dwMicroSecPerFrame' => 4, // frame display rate (or 0L) + 'dwMaxBytesPerSec' => 4, // max. transfer rate + 'dwPaddingGranularity' => 4, // pad to multiples of this size; normally 2K. + 'dwFlags' => 4, // the ever-present flags + 'dwTotalFrames' => 4, // # frames in file + 'dwInitialFrames' => 4, + 'dwStreams' => 4, + 'dwSuggestedBufferSize' => 4, + 'dwWidth' => 4, + 'dwHeight' => 4, + 'dwScale' => 4, + 'dwRate' => 4, + 'dwStart' => 4, + 'dwLength' => 4 + ) + ); + + $info_riff_raw_avih['flags']['hasindex'] = (bool)($info_riff_raw_avih['dwFlags'] & 0x00000010); + $info_riff_raw_avih['flags']['mustuseindex'] = (bool)($info_riff_raw_avih['dwFlags'] & 0x00000020); + $info_riff_raw_avih['flags']['interleaved'] = (bool)($info_riff_raw_avih['dwFlags'] & 0x00000100); + $info_riff_raw_avih['flags']['trustcktype'] = (bool)($info_riff_raw_avih['dwFlags'] & 0x00000800); + $info_riff_raw_avih['flags']['capturedfile'] = (bool)($info_riff_raw_avih['dwFlags'] & 0x00010000); + $info_riff_raw_avih['flags']['copyrighted'] = (bool)($info_riff_raw_avih['dwFlags'] & 0x00020010); + + $info_riff_video[$stream_index] = array (); + $info_riff_video_current = &$info_riff_video[$stream_index]; + + if ($info_riff_raw_avih['dwWidth'] > 0) { + $info_riff_video_current['frame_width'] = $info_riff_raw_avih['dwWidth']; + $info_video['resolution_x'] = $info_riff_video_current['frame_width']; + } + + if ($info_riff_raw_avih['dwHeight'] > 0) { + $info_riff_video_current['frame_height'] = $info_riff_raw_avih['dwHeight']; + $info_video['resolution_y'] = $info_riff_video_current['frame_height']; + } + + if ($info_riff_raw_avih['dwTotalFrames'] > 0) { + $info_riff_video_current['total_frames'] = $info_riff_raw_avih['dwTotalFrames']; + $info_video['total_frames'] = $info_riff_video_current['total_frames']; + } + + $info_riff_video_current['frame_rate'] = round(1000000 / $info_riff_raw_avih['dwMicroSecPerFrame'], 3); + $info_video['frame_rate'] = $info_riff_video_current['frame_rate']; + } + + if (isset($info_riff['AVI ']['hdrl']['strl']['strh'][0]['data'])) { + if (is_array($info_riff['AVI ']['hdrl']['strl']['strh'])) { + for ($i = 0; $i < count($info_riff['AVI ']['hdrl']['strl']['strh']); $i++) { + if (isset($info_riff['AVI ']['hdrl']['strl']['strh'][$i]['data'])) { + $strh_data = $info_riff['AVI ']['hdrl']['strl']['strh'][$i]['data']; + $strh_fcc_type = substr($strh_data, 0, 4); + + if (isset($info_riff['AVI ']['hdrl']['strl']['strf'][$i]['data'])) { + $strf_data = $info_riff['AVI ']['hdrl']['strl']['strf'][$i]['data']; + + // shortcut + $info_riff_raw_strf_strh_fcc_type_stream_index = &$info_riff_raw['strf'][$strh_fcc_type][$stream_index]; + + switch ($strh_fcc_type) { + case 'auds': + $info_audio['bitrate_mode'] = 'cbr'; + $info_audio_dataformat = 'wav'; + if (isset($info_riff_audio) && is_array($info_riff_audio)) { + $stream_index = count($info_riff_audio); + } + + $info_riff_audio[$stream_index] = getid3_riff::RIFFparseWAVEFORMATex($strf_data); + $info_audio['wformattag'] = $info_riff_audio[$stream_index]['raw']['wFormatTag']; + + // shortcut + $info_audio['streams'][$stream_index] = $info_riff_audio[$stream_index]; + $info_audio_streams_currentstream = &$info_audio['streams'][$stream_index]; + + if (@$info_audio_streams_currentstream['bits_per_sample'] === 0) { + unset($info_audio_streams_currentstream['bits_per_sample']); + } + $info_audio_streams_currentstream['wformattag'] = $info_audio_streams_currentstream['raw']['wFormatTag']; + unset($info_audio_streams_currentstream['raw']); + + // shortcut + $info_riff_raw['strf'][$strh_fcc_type][$stream_index] = $info_riff_audio[$stream_index]['raw']; + + unset($info_riff_audio[$stream_index]['raw']); + $info_audio = getid3_riff::array_merge_noclobber($info_audio, $info_riff_audio[$stream_index]); + + $info_audio['lossless'] = false; + switch ($info_riff_raw_strf_strh_fcc_type_stream_index['wFormatTag']) { + + case 0x0001: // PCM + $info_audio_dataformat = 'wav'; + $info_audio['lossless'] = true; + break; + + case 0x0050: // MPEG Layer 2 or Layer 1 + $info_audio_dataformat = 'mp2'; // Assume Layer-2 + break; + + case 0x0055: // MPEG Layer 3 + $info_audio_dataformat = 'mp3'; + break; + + case 0x00FF: // AAC + $info_audio_dataformat = 'aac'; + break; + + case 0x0161: // Windows Media v7 / v8 / v9 + case 0x0162: // Windows Media Professional v9 + case 0x0163: // Windows Media Lossess v9 + $info_audio_dataformat = 'wma'; + break; + + case 0x2000: // AC-3 + $info_audio_dataformat = 'ac3'; + break; + + case 0x2001: // DTS + $info_audio_dataformat = 'dts'; + break; + + default: + $info_audio_dataformat = 'wav'; + break; + } + $info_audio_streams_currentstream['dataformat'] = $info_audio_dataformat; + $info_audio_streams_currentstream['lossless'] = $info_audio['lossless']; + $info_audio_streams_currentstream['bitrate_mode'] = $info_audio['bitrate_mode']; + break; + + + case 'iavs': + case 'vids': + // shortcut + $info_riff_raw['strh'][$i] = array (); + $info_riff_raw_strh_current = &$info_riff_raw['strh'][$i]; + + getid3_lib::ReadSequence($this->endian_function, $info_riff_raw_strh_current, $strh_data, 0, + array ( + 'fccType' => -4, // same as $strh_fcc_type; + 'fccHandler' => -4, + 'dwFlags' => 4, // Contains AVITF_* flags + 'wPriority' => 2, + 'wLanguage' => 2, + 'dwInitialFrames' => 4, + 'dwScale' => 4, + 'dwRate' => 4, + 'dwStart' => 4, + 'dwLength' => 4, + 'dwSuggestedBufferSize' => 4, + 'dwQuality' => 4, + 'dwSampleSize' => 4, + 'rcFrame' => 4 + ) + ); + + $info_riff_video_current['codec'] = getid3_riff::RIFFfourccLookup($info_riff_raw_strh_current['fccHandler']); + $info_video['fourcc'] = $info_riff_raw_strh_current['fccHandler']; + + if (!$info_riff_video_current['codec'] && isset($info_riff_raw_strf_strh_fcc_type_stream_index['fourcc']) && getid3_riff::RIFFfourccLookup($info_riff_raw_strf_strh_fcc_type_stream_index['fourcc'])) { + $info_riff_video_current['codec'] = getid3_riff::RIFFfourccLookup($info_riff_raw_strf_strh_fcc_type_stream_index['fourcc']); + $info_video['fourcc'] = $info_riff_raw_strf_strh_fcc_type_stream_index['fourcc']; + } + + $info_video['codec'] = $info_riff_video_current['codec']; + $info_video['pixel_aspect_ratio'] = (float)1; + + switch ($info_riff_raw_strh_current['fccHandler']) { + + case 'HFYU': // Huffman Lossless Codec + case 'IRAW': // Intel YUV Uncompressed + case 'YUY2': // Uncompressed YUV 4:2:2 + $info_video['lossless'] = true; + break; + + default: + $info_video['lossless'] = false; + break; + } + + switch ($strh_fcc_type) { + + case 'vids': + getid3_lib::ReadSequence($this->endian_function, $info_riff_raw_strf_strh_fcc_type_stream_index, $strf_data, 0, + array ( + 'biSize' => 4, // number of bytes required by the BITMAPINFOHEADER structure + 'biWidth' => 4, // width of the bitmap in pixels + 'biHeight' => 4, // height of the bitmap in pixels. If biHeight is positive, the bitmap is a 'bottom-up' DIB and its origin is the lower left corner. If biHeight is negative, the bitmap is a 'top-down' DIB and its origin is the upper left corner + 'biPlanes' => 2, // number of color planes on the target device. In most cases this value must be set to 1 + 'biBitCount' => 2, // Specifies the number of bits per pixels + 'fourcc' => -4, // + 'biSizeImage' => 4, // size of the bitmap data section of the image (the actual pixel data, excluding BITMAPINFOHEADER and RGBQUAD structures) + 'biXPelsPerMeter' => 4, // horizontal resolution, in pixels per metre, of the target device + 'biYPelsPerMeter' => 4, // vertical resolution, in pixels per metre, of the target device + 'biClrUsed' => 4, // actual number of color indices in the color table used by the bitmap. If this value is zero, the bitmap uses the maximum number of colors corresponding to the value of the biBitCount member for the compression mode specified by biCompression + 'biClrImportant' => 4 // number of color indices that are considered important for displaying the bitmap. If this value is zero, all colors are important + ) + ); + + $info_video['bits_per_sample'] = $info_riff_raw_strf_strh_fcc_type_stream_index['biBitCount']; + + if ($info_riff_video_current['codec'] == 'DV') { + $info_riff_video_current['dv_type'] = 2; + } + break; + + case 'iavs': + $info_riff_video_current['dv_type'] = 1; + break; + } + break; + + default: + $getid3->warning('Unhandled fccType for stream ('.$i.'): "'.$strh_fcc_type.'"'); + break; + + } + } + } + + if (isset($info_riff_raw_strf_strh_fcc_type_stream_index['fourcc']) && getid3_riff::RIFFfourccLookup($info_riff_raw_strf_strh_fcc_type_stream_index['fourcc'])) { + + $info_riff_video_current['codec'] = getid3_riff::RIFFfourccLookup($info_riff_raw_strf_strh_fcc_type_stream_index['fourcc']); + $info_video['codec'] = $info_riff_video_current['codec']; + $info_video['fourcc'] = $info_riff_raw_strf_strh_fcc_type_stream_index['fourcc']; + + switch ($info_riff_raw_strf_strh_fcc_type_stream_index['fourcc']) { + + case 'HFYU': // Huffman Lossless Codec + case 'IRAW': // Intel YUV Uncompressed + case 'YUY2': // Uncompressed YUV 4:2:2 + $info_video['lossless'] = true; + $info_video['bits_per_sample'] = 24; + break; + + default: + $info_video['lossless'] = false; + $info_video['bits_per_sample'] = 24; + break; + } + + } + } + } + } + break; + + + case 'CDDA': + $info_audio['bitrate_mode'] = 'cbr'; + $info_audio_dataformat = 'cda'; + $info_audio['lossless'] = true; + unset($getid3->info['mime_type']); + + $info_avdataoffset = 44; + + if (isset($info_riff['CDDA']['fmt '][0]['data'])) { + + $info_riff_cdda_fmt_0 = &$info_riff['CDDA']['fmt '][0]; + + getid3_lib::ReadSequence($this->endian_function, $info_riff_cdda_fmt_0, $info_riff_cdda_fmt_0['data'], 0, + array ( + 'unknown1' => 2, + 'track_num' => 2, + 'disc_id' => 4, + 'start_offset_frame' => 4, + 'playtime_frames' => 4, + 'unknown6' => 4, + 'unknown7' => 4 + ) + ); + + $info_riff_cdda_fmt_0['start_offset_seconds'] = (float)$info_riff_cdda_fmt_0['start_offset_frame'] / 75; + $info_riff_cdda_fmt_0['playtime_seconds'] = (float)$info_riff_cdda_fmt_0['playtime_frames'] / 75; + $getid3->info['comments']['track'] = $info_riff_cdda_fmt_0['track_num']; + $getid3->info['playtime_seconds'] = $info_riff_cdda_fmt_0['playtime_seconds']; + + // hardcoded data for CD-audio + $info_audio['sample_rate'] = 44100; + $info_audio['channels'] = 2; + $info_audio['bits_per_sample'] = 16; + $info_audio['bitrate'] = $info_audio['sample_rate'] * $info_audio['channels'] * $info_audio['bits_per_sample']; + $info_audio['bitrate_mode'] = 'cbr'; + } + break; + + + case 'AIFF': + case 'AIFC': + $info_audio['bitrate_mode'] = 'cbr'; + $info_audio_dataformat = 'aiff'; + $info_audio['lossless'] = true; + $getid3->info['mime_type'] = 'audio/x-aiff'; + + if (isset($info_riff[$riff_sub_type]['SSND'][0]['offset'])) { + $info_avdataoffset = $info_riff[$riff_sub_type]['SSND'][0]['offset'] + 8; + $info_avdataend = $info_avdataoffset + $info_riff[$riff_sub_type]['SSND'][0]['size']; + if ($info_avdataend > $getid3->info['filesize']) { + if (($info_avdataend == ($getid3->info['filesize'] + 1)) && (($getid3->info['filesize'] % 2) == 1)) { + // structures rounded to 2-byte boundary, but dumb encoders + // forget to pad end of file to make this actually work + } else { + $getid3->warning('Probable truncated AIFF file: expecting '.$info_riff[$riff_sub_type]['SSND'][0]['size'].' bytes of audio data, only '.($getid3->info['filesize'] - $info_avdataoffset).' bytes found'); + } + $info_avdataend = $getid3->info['filesize']; + } + } + + if (isset($info_riff[$riff_sub_type]['COMM'][0]['data'])) { + + // shortcut + $info_riff_RIFFsubtype_COMM_0_data = &$info_riff[$riff_sub_type]['COMM'][0]['data']; + + $info_riff_audio['channels'] = getid3_lib::BigEndianSyncSafe2Int(substr($info_riff_RIFFsubtype_COMM_0_data, 0, 2)); + $info_riff_audio['total_samples'] = getid3_lib::BigEndian2Int( substr($info_riff_RIFFsubtype_COMM_0_data, 2, 4)); + $info_riff_audio['bits_per_sample'] = getid3_lib::BigEndianSyncSafe2Int(substr($info_riff_RIFFsubtype_COMM_0_data, 6, 2)); + $info_riff_audio['sample_rate'] = (int)getid3_riff::BigEndian2Float(substr($info_riff_RIFFsubtype_COMM_0_data, 8, 10)); + + if ($info_riff[$riff_sub_type]['COMM'][0]['size'] > 18) { + $info_riff_audio['codec_fourcc'] = substr($info_riff_RIFFsubtype_COMM_0_data, 18, 4); + $codec_name_size = getid3_lib::BigEndian2Int(substr($info_riff_RIFFsubtype_COMM_0_data, 22, 1)); + $info_riff_audio['codec_name'] = substr($info_riff_RIFFsubtype_COMM_0_data, 23, $codec_name_size); + + switch ($info_riff_audio['codec_name']) { + + case 'NONE': + $info_audio['codec'] = 'Pulse Code Modulation (PCM)'; + $info_audio['lossless'] = true; + break; + + case '': + switch ($info_riff_audio['codec_fourcc']) { + + // http://developer.apple.com/qa/snd/snd07.html + case 'sowt': + $info_riff_audio['codec_name'] = 'Two\'s Compliment Little-Endian PCM'; + $info_audio['lossless'] = true; + break; + + case 'twos': + $info_riff_audio['codec_name'] = 'Two\'s Compliment Big-Endian PCM'; + $info_audio['lossless'] = true; + break; + + default: + break; + } + break; + + default: + $info_audio['codec'] = $info_riff_audio['codec_name']; + $info_audio['lossless'] = false; + break; + } + } + + $info_audio['channels'] = $info_riff_audio['channels']; + + if ($info_riff_audio['bits_per_sample'] > 0) { + $info_audio['bits_per_sample'] = $info_riff_audio['bits_per_sample']; + } + + $info_audio['sample_rate'] = $info_riff_audio['sample_rate']; + $getid3->info['playtime_seconds'] = $info_riff_audio['total_samples'] / $info_audio['sample_rate']; + } + + if (isset($info_riff[$riff_sub_type]['COMT'])) { + + $comment_count = getid3_lib::BigEndian2Int(substr($info_riff[$riff_sub_type]['COMT'][0]['data'], 0, 2)); + $offset = 2; + + for ($i = 0; $i < $comment_count; $i++) { + + $getid3->info['comments_raw'][$i]['timestamp'] = getid3_lib::BigEndian2Int( substr($info_riff[$riff_sub_type]['COMT'][0]['data'], $offset, 4)); + $offset += 4; + + $getid3->info['comments_raw'][$i]['marker_id'] = getid3_lib::BigEndianSyncSafe2Int(substr($info_riff[$riff_sub_type]['COMT'][0]['data'], $offset, 2)); + $offset += 2; + + $comment_length = getid3_lib::BigEndian2Int( substr($info_riff[$riff_sub_type]['COMT'][0]['data'], $offset, 2)); + $offset += 2; + + $getid3->info['comments_raw'][$i]['comment'] = substr($info_riff[$riff_sub_type]['COMT'][0]['data'], $offset, $comment_length); + $offset += $comment_length; + + $getid3->info['comments_raw'][$i]['timestamp_unix'] = getid3_riff::DateMac2Unix($getid3->info['comments_raw'][$i]['timestamp']); + $info_riff['comments']['comment'][] = $getid3->info['comments_raw'][$i]['comment']; + } + } + + foreach (array ('NAME'=>'title', 'author'=>'artist', '(c) '=>'copyright', 'ANNO'=>'comment') as $key => $value) { + if (isset($info_riff[$riff_sub_type][$key][0]['data'])) { + $info_riff['comments'][$value][] = $info_riff[$riff_sub_type][$key][0]['data']; + } + } + break; + + + case '8SVX': + $info_audio['bitrate_mode'] = 'cbr'; + $info_audio_dataformat = '8svx'; + $info_audio['bits_per_sample'] = 8; + $info_audio['channels'] = 1; // overridden below, if need be + $getid3->info['mime_type'] = 'audio/x-aiff'; + + if (isset($info_riff[$riff_sub_type]['BODY'][0]['offset'])) { + $info_avdataoffset = $info_riff[$riff_sub_type]['BODY'][0]['offset'] + 8; + $info_avdataend = $info_avdataoffset + $info_riff[$riff_sub_type]['BODY'][0]['size']; + if ($info_avdataend > $getid3->info['filesize']) { + $getid3->warning('Probable truncated AIFF file: expecting '.$info_riff[$riff_sub_type]['BODY'][0]['size'].' bytes of audio data, only '.($getid3->info['filesize'] - $info_avdataoffset).' bytes found'); + } + } + + if (isset($info_riff[$riff_sub_type]['VHDR'][0]['offset'])) { + // shortcut + $info_riff_riff_sub_type_vhdr_0 = &$info_riff[$riff_sub_type]['VHDR'][0]; + + getid3_lib::ReadSequence('BigEndian2Int', $info_riff_riff_sub_type_vhdr_0, $info_riff_riff_sub_type_vhdr_0['data'], 0, + array ( + 'oneShotHiSamples' => 4, + 'repeatHiSamples' => 4, + 'samplesPerHiCycle' => 4, + 'samplesPerSec' => 2, + 'ctOctave' => 1, + 'sCompression' => 1, + 'Volume' => -4 + ) + ); + + $info_riff_riff_sub_type_vhdr_0['Volume'] = getid3_riff::FixedPoint16_16($info_riff_riff_sub_type_vhdr_0['Volume']); + + $info_audio['sample_rate'] = $info_riff_riff_sub_type_vhdr_0['samplesPerSec']; + + switch ($info_riff_riff_sub_type_vhdr_0['sCompression']) { + case 0: + $info_audio['codec'] = 'Pulse Code Modulation (PCM)'; + $info_audio['lossless'] = true; + $actual_bits_per_sample = 8; + break; + + case 1: + $info_audio['codec'] = 'Fibonacci-delta encoding'; + $info_audio['lossless'] = false; + $actual_bits_per_sample = 4; + break; + + default: + $getid3->warning('Unexpected sCompression value in 8SVX.VHDR chunk - expecting 0 or 1, found "'.sCompression.'"'); + break; + } + } + + if (isset($info_riff[$riff_sub_type]['CHAN'][0]['data'])) { + $ChannelsIndex = getid3_lib::BigEndian2Int(substr($info_riff[$riff_sub_type]['CHAN'][0]['data'], 0, 4)); + switch ($ChannelsIndex) { + case 6: // Stereo + $info_audio['channels'] = 2; + break; + + case 2: // Left channel only + case 4: // Right channel only + $info_audio['channels'] = 1; + break; + + default: + $getid3->warning('Unexpected value in 8SVX.CHAN chunk - expecting 2 or 4 or 6, found "'.$ChannelsIndex.'"'); + break; + } + + } + + foreach (array ('NAME'=>'title', 'author'=>'artist', '(c) '=>'copyright', 'ANNO'=>'comment') as $key => $value) { + if (isset($info_riff[$riff_sub_type][$key][0]['data'])) { + $info_riff['comments'][$value][] = $info_riff[$riff_sub_type][$key][0]['data']; + } + } + + $info_audio['bitrate'] = $info_audio['sample_rate'] * $actual_bits_per_sample * $info_audio['channels']; + if (!empty($info_audio['bitrate'])) { + $getid3->info['playtime_seconds'] = ($info_avdataend - $info_avdataoffset) / ($info_audio['bitrate'] / 8); + } + break; + + + case 'CDXA': + + $getid3->info['mime_type'] = 'video/mpeg'; + if (!empty($info_riff['CDXA']['data'][0]['size'])) { + $GETID3_ERRORARRAY = &$getid3->info['warning']; + + if (!$getid3->include_module_optional('audio-video.mpeg')) { + $getid3->warning('MPEG skipped because mpeg module is missing.'); + } + + else { + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + + // Analyse + $mpeg = new getid3_mpeg($clone); + $mpeg->Analyze(); + + // Import from clone and destroy + $getid3->info['audio'] = $clone->info['audio']; + $getid3->info['video'] = $clone->info['video']; + $getid3->info['mpeg'] = $clone->info['mpeg']; + $getid3->info['warning'] = $clone->info['warning']; + + unset($clone); + } + } + + break; + + + default: + throw new getid3_exception('Unknown RIFF type: expecting one of (WAVE|RMP3|AVI |CDDA|AIFF|AIFC|8SVX|CDXA), found "'.$riff_sub_type.'" instead'); + } + + + if (@$info_riff_raw['fmt ']['wFormatTag'] == 1) { + + // http://www.mega-nerd.com/erikd/Blog/Windiots/dts.html + $this->fseek($getid3->info['avdataoffset'], SEEK_SET); + $bytes4 = $this->fread(4); + + // DTSWAV + if (preg_match('/^\xFF\x1F\x00\xE8/s', $bytes4)) { + $info_audio_dataformat = 'dts'; + } + + // DTS, but this probably shouldn't happen + elseif (preg_match('/^\x7F\xFF\x80\x01/s', $bytes4)) { + $info_audio_dataformat = 'dts'; + } + } + + if (@is_array($info_riff_wave['DISP'])) { + $info_riff['comments']['title'][] = trim(substr($info_riff_wave['DISP'][count($info_riff_wave['DISP']) - 1]['data'], 4)); + } + + if (@is_array($info_riff_wave['INFO'])) { + getid3_riff::RIFFCommentsParse($info_riff_wave['INFO'], $info_riff['comments']); + } + + if (isset($info_riff_wave['INFO']) && is_array($info_riff_wave['INFO'])) { + + foreach (array ('IARL' => 'archivallocation', 'IART' => 'artist', 'ICDS' => 'costumedesigner', 'ICMS' => 'commissionedby', 'ICMT' => 'comment', 'ICNT' => 'country', 'ICOP' => 'copyright', 'ICRD' => 'creationdate', 'IDIM' => 'dimensions', 'IDIT' => 'digitizationdate', 'IDPI' => 'resolution', 'IDST' => 'distributor', 'IEDT' => 'editor', 'IENG' => 'engineers', 'IFRM' => 'accountofparts', 'IGNR' => 'genre', 'IKEY' => 'keywords', 'ILGT' => 'lightness', 'ILNG' => 'language', 'IMED' => 'orignalmedium', 'IMUS' => 'composer', 'INAM' => 'title', 'IPDS' => 'productiondesigner', 'IPLT' => 'palette', 'IPRD' => 'product', 'IPRO' => 'producer', 'IPRT' => 'part', 'IRTD' => 'rating', 'ISBJ' => 'subject', 'ISFT' => 'software', 'ISGN' => 'secondarygenre', 'ISHP' => 'sharpness', 'ISRC' => 'sourcesupplier', 'ISRF' => 'digitizationsource', 'ISTD' => 'productionstudio', 'ISTR' => 'starring', 'ITCH' => 'encoded_by', 'IWEB' => 'url', 'IWRI' => 'writer') as $key => $value) { + if (isset($info_riff_wave['INFO'][$key])) { + foreach ($info_riff_wave['INFO'][$key] as $comment_id => $comment_data) { + if (trim($comment_data['data']) != '') { + $info_riff['comments'][$value][] = trim($comment_data['data']); + } + } + } + } + } + + if (empty($info_audio['encoder']) && !empty($getid3->info['mpeg']['audio']['LAME']['short_version'])) { + $info_audio['encoder'] = $getid3->info['mpeg']['audio']['LAME']['short_version']; + } + + if (!isset($getid3->info['playtime_seconds'])) { + $getid3->info['playtime_seconds'] = 0; + } + + if (isset($info_riff_raw['avih']['dwTotalFrames']) && isset($info_riff_raw['avih']['dwMicroSecPerFrame'])) { + $getid3->info['playtime_seconds'] = $info_riff_raw['avih']['dwTotalFrames'] * ($info_riff_raw['avih']['dwMicroSecPerFrame'] / 1000000); + } + + if ($getid3->info['playtime_seconds'] > 0) { + if (isset($info_riff_audio) && isset($info_riff_video)) { + + if (!isset($getid3->info['bitrate'])) { + $getid3->info['bitrate'] = ((($info_avdataend - $info_avdataoffset) / $getid3->info['playtime_seconds']) * 8); + } + + } elseif (isset($info_riff_audio) && !isset($info_riff_video)) { + + if (!isset($info_audio['bitrate'])) { + $info_audio['bitrate'] = ((($info_avdataend - $info_avdataoffset) / $getid3->info['playtime_seconds']) * 8); + } + + } elseif (!isset($info_riff_audio) && isset($info_riff_video)) { + + if (!isset($info_video['bitrate'])) { + $info_video['bitrate'] = ((($info_avdataend - $info_avdataoffset) / $getid3->info['playtime_seconds']) * 8); + } + + } + } + + + if (isset($info_riff_video) && isset($info_audio['bitrate']) && ($info_audio['bitrate'] > 0) && ($getid3->info['playtime_seconds'] > 0)) { + + $getid3->info['bitrate'] = ((($info_avdataend - $info_avdataoffset) / $getid3->info['playtime_seconds']) * 8); + $info_audio['bitrate'] = 0; + $info_video['bitrate'] = $getid3->info['bitrate']; + foreach ($info_riff_audio as $channelnumber => $audioinfoarray) { + $info_video['bitrate'] -= $audioinfoarray['bitrate']; + $info_audio['bitrate'] += $audioinfoarray['bitrate']; + } + if ($info_video['bitrate'] <= 0) { + unset($info_video['bitrate']); + } + if ($info_audio['bitrate'] <= 0) { + unset($info_audio['bitrate']); + } + } + + if (isset($getid3->info['mpeg']['audio'])) { + $info_audio_dataformat = 'mp'.$getid3->info['mpeg']['audio']['layer']; + $info_audio['sample_rate'] = $getid3->info['mpeg']['audio']['sample_rate']; + $info_audio['channels'] = $getid3->info['mpeg']['audio']['channels']; + $info_audio['bitrate'] = $getid3->info['mpeg']['audio']['bitrate']; + $info_audio['bitrate_mode'] = strtolower($getid3->info['mpeg']['audio']['bitrate_mode']); + + if (!empty($getid3->info['mpeg']['audio']['codec'])) { + $info_audio['codec'] = $getid3->info['mpeg']['audio']['codec'].' '.$info_audio['codec']; + } + + if (!empty($info_audio['streams'])) { + foreach ($info_audio['streams'] as $streamnumber => $streamdata) { + if ($streamdata['dataformat'] == $info_audio_dataformat) { + $info_audio['streams'][$streamnumber]['sample_rate'] = $info_audio['sample_rate']; + $info_audio['streams'][$streamnumber]['channels'] = $info_audio['channels']; + $info_audio['streams'][$streamnumber]['bitrate'] = $info_audio['bitrate']; + $info_audio['streams'][$streamnumber]['bitrate_mode'] = $info_audio['bitrate_mode']; + $info_audio['streams'][$streamnumber]['codec'] = $info_audio['codec']; + } + } + } + $info_audio['encoder_options'] = getid3_mp3::GuessEncoderOptions($getid3->info); + } + + + if (!empty($info_riff_raw['fmt ']['wBitsPerSample']) && ($info_riff_raw['fmt ']['wBitsPerSample'] > 0)) { + switch ($info_audio_dataformat) { + case 'ac3': + // ignore bits_per_sample + break; + + default: + $info_audio['bits_per_sample'] = $info_riff_raw['fmt ']['wBitsPerSample']; + break; + } + } + + + if (empty($info_riff_raw)) { + unset($info_riff['raw']); + } + if (empty($info_riff_audio)) { + unset($info_riff['audio']); + } + if (empty($info_riff_video)) { + unset($info_riff['video']); + } + if (empty($info_audio_dataformat)) { + unset($info_audio['dataformat']); + } + if (empty($getid3->info['audio'])) { + unset($getid3->info['audio']); + } + if (empty($info_video)) { + unset($getid3->info['video']); + } + + return true; + } + + + + public function ParseRIFF($start_offset, $max_offset) { + + $getid3 = $this->getid3; + + $info = &$getid3->info; + + $endian_function = $this->endian_function; + + $max_offset = min($max_offset, $info['avdataend']); + + $riff_chunk = false; + + $this->fseek($start_offset, SEEK_SET); + + while ($this->ftell() < $max_offset) { + + $chunk_name = $this->fread(4); + + if (strlen($chunk_name) < 4) { + throw new getid3_exception('Expecting chunk name at offset '.($this->ftell() - 4).' but found nothing. Aborting RIFF parsing.'); + } + + $chunk_size = getid3_lib::$endian_function($this->fread(4)); + + if ($chunk_size == 0) { + continue; + throw new getid3_exception('Chunk size at offset '.($this->ftell() - 4).' is zero. Aborting RIFF parsing.'); + } + + if (($chunk_size % 2) != 0) { + // all structures are packed on word boundaries + $chunk_size++; + } + + switch ($chunk_name) { + + case 'LIST': + $list_name = $this->fread(4); + + switch ($list_name) { + + case 'movi': + case 'rec ': + $riff_chunk[$list_name]['offset'] = $this->ftell() - 4; + $riff_chunk[$list_name]['size'] = $chunk_size; + + static $parsed_audio_stream = false; + + if (!$parsed_audio_stream) { + $where_we_were = $this->ftell(); + $audio_chunk_header = $this->fread(12); + $audio_chunk_stream_num = substr($audio_chunk_header, 0, 2); + $audio_chunk_stream_type = substr($audio_chunk_header, 2, 2); + $audio_chunk_size = getid3_lib::LittleEndian2Int(substr($audio_chunk_header, 4, 4)); + + if ($audio_chunk_stream_type == 'wb') { + $first_four_bytes = substr($audio_chunk_header, 8, 4); + + + //// MPEG + + if (preg_match('/^\xFF[\xE2-\xE7\xF2-\xF7\xFA-\xFF][\x00-\xEB]/s', $first_four_bytes)) { + + if (!$getid3->include_module_optional('audio.mp3')) { + $getid3->warning('MP3 skipped because mp3 module is missing.'); + } + + elseif (getid3_mp3::MPEGaudioHeaderBytesValid($first_four_bytes)) { + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + $clone->info['avdataoffset'] = $this->ftell() - 4; + $clone->info['avdataend'] = $this->ftell() + $audio_chunk_size; + + $mp3 = new getid3_mp3($clone); + $mp3->AnalyzeMPEGaudioInfo(); + + // Import from clone and destroy + if (isset($clone->info['mpeg']['audio'])) { + + $info['mpeg']['audio'] = $clone->info['mpeg']['audio']; + + $info['audio']['dataformat'] = 'mp'.$info['mpeg']['audio']['layer']; + $info['audio']['sample_rate'] = $info['mpeg']['audio']['sample_rate']; + $info['audio']['channels'] = $info['mpeg']['audio']['channels']; + $info['audio']['bitrate'] = $info['mpeg']['audio']['bitrate']; + $info['audio']['bitrate_mode'] = strtolower($info['mpeg']['audio']['bitrate_mode']); + $info['bitrate'] = $info['audio']['bitrate']; + + $getid3->warning($clone->warnings()); + unset($clone); + } + } + } + + //// AC3-WAVE + + elseif (preg_match('/^\x0B\x77/s', $first_four_bytes)) { + + if (!$getid3->include_module_optional('audio.ac3')) { + $getid3->warning('AC3 skipped because ac3 module is missing.'); + } + + else { + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + $clone->info['avdataoffset'] = $this->ftell() - 4; + $clone->info['avdataend'] = $this->ftell() + $audio_chunk_size; + + // Analyze clone by fp + $ac3 = new getid3_ac3($clone); + $ac3->Analyze(); + + // Import from clone and destroy + $info['audio'] = $clone->info['audio']; + $info['ac3'] = $clone->info['ac3']; + $getid3->warning($clone->warnings()); + unset($clone); + } + } + } + + $parsed_audio_stream = true; + $this->fseek($where_we_were, SEEK_SET); + + } + $this->fseek($chunk_size - 4, SEEK_CUR); + break; + + default: + if (!isset($riff_chunk[$list_name])) { + $riff_chunk[$list_name] = array (); + } + $list_chunk_parent = $list_name; + $list_chunk_max_offset = $this->ftell() - 4 + $chunk_size; + if ($parsed_chunk = $this->ParseRIFF($this->ftell(), $this->ftell() + $chunk_size - 4)) { + $riff_chunk[$list_name] = array_merge_recursive($riff_chunk[$list_name], $parsed_chunk); + } + break; + } + break; + + + default: + + $this_index = 0; + if (isset($riff_chunk[$chunk_name]) && is_array($riff_chunk[$chunk_name])) { + $this_index = count($riff_chunk[$chunk_name]); + } + $riff_chunk[$chunk_name][$this_index]['offset'] = $this->ftell() - 8; + $riff_chunk[$chunk_name][$this_index]['size'] = $chunk_size; + switch ($chunk_name) { + case 'data': + $info['avdataoffset'] = $this->ftell(); + $info['avdataend'] = $info['avdataoffset'] + $chunk_size; + + $riff_data_chunk_contents_test = $this->fread(36); + + + //// This is probably MP3 data + + if ((strlen($riff_data_chunk_contents_test) > 0) && preg_match('/^\xFF[\xE2-\xE7\xF2-\xF7\xFA-\xFF][\x00-\xEB]/s', substr($riff_data_chunk_contents_test, 0, 4))) { + + try { + + if (!$getid3->include_module_optional('audio.mp3')) { + $getid3->warning('MP3 skipped because mp3 module is missing.'); + } + + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + + if (getid3_mp3::MPEGaudioHeaderBytesValid(substr($riff_data_chunk_contents_test, 0, 4))) { + + $mp3 = new getid3_mp3($clone); + $mp3->AnalyzeMPEGaudioInfo(); + + // Import from clone and destroy + if (isset($clone->info['mpeg']['audio'])) { + + $info['mpeg']['audio'] = $clone->info['mpeg']['audio']; + + $info['audio']['sample_rate'] = $info['mpeg']['audio']['sample_rate']; + $info['audio']['channels'] = $info['mpeg']['audio']['channels']; + $info['audio']['bitrate'] = $info['mpeg']['audio']['bitrate']; + $info['audio']['bitrate_mode'] = strtolower($info['mpeg']['audio']['bitrate_mode']); + $info['bitrate'] = $info['audio']['bitrate']; + + $getid3->warning($clone->warnings()); + unset($clone); + } + } + } + catch (Exception $e) { + // do nothing - not MP3 data + } + } + + + //// This is probably AC-3 data + + elseif ((strlen($riff_data_chunk_contents_test) > 0) && (substr($riff_data_chunk_contents_test, 0, 2) == "\x0B\x77")) { + + if (!$getid3->include_module_optional('audio.ac3')) { + $getid3->warning('AC3 skipped because ac3 module is missing.'); + } + + else { + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + $clone->info['avdataoffset'] = $riff_chunk[$chunk_name][$this_index]['offset']; + $clone->info['avdataend'] = $clone->info['avdataoffset'] + $riff_chunk[$chunk_name][$this_index]['size']; + + // Analyze clone by fp + $ac3 = new getid3_ac3($clone); + $ac3->Analyze(); + + // Import from clone and destroy + $info['audio'] = $clone->info['audio']; + $info['ac3'] = $clone->info['ac3']; + $getid3->warning($clone->warnings()); + unset($clone); + } + } + + + // Dolby Digital WAV + // AC-3 content, but not encoded in same format as normal AC-3 file + // For one thing, byte order is swapped + + elseif ((strlen($riff_data_chunk_contents_test) > 0) && (substr($riff_data_chunk_contents_test, 8, 2) == "\x77\x0B")) { + + if (!$getid3->include_module_optional('audio.ac3')) { + $getid3->warning('AC3 skipped because ac3 module is missing.'); + } + + else { + + // Extract ac3 data to string + $ac3_data = ''; + for ($i = 0; $i < 28; $i += 2) { + // swap byte order + $ac3_data .= substr($riff_data_chunk_contents_test, 8 + $i + 1, 1); + $ac3_data .= substr($riff_data_chunk_contents_test, 8 + $i + 0, 1); + } + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + $clone->info['avdataoffset'] = 0; + $clone->info['avdataend'] = 20; + + // Analyse clone by string + $ac3 = new getid3_ac3($clone); + $ac3->AnalyzeString($ac3_data); + + // Import from clone and destroy + $info['audio'] = $clone->info['audio']; + $info['ac3'] = $clone->info['ac3']; + $getid3->warning($clone->warnings()); + unset($clone); + } + } + + + if ((strlen($riff_data_chunk_contents_test) > 0) && (substr($riff_data_chunk_contents_test, 0, 4) == 'wvpk')) { + + // This is WavPack data + $info['wavpack']['offset'] = $riff_chunk[$chunk_name][$this_index]['offset']; + $info['wavpack']['size'] = getid3_lib::LittleEndian2Int(substr($riff_data_chunk_contents_test, 4, 4)); + $this->RIFFparseWavPackHeader(substr($riff_data_chunk_contents_test, 8, 28)); + + } else { + + // This is some other kind of data (quite possibly just PCM) + // do nothing special, just skip it + + } + $this->fseek($riff_chunk[$chunk_name][$this_index]['offset'] + 8 + $chunk_size, SEEK_SET); + break; + + case 'bext': + case 'cart': + case 'fmt ': + case 'MEXT': + case 'DISP': + // always read data in + $riff_chunk[$chunk_name][$this_index]['data'] = $this->fread($chunk_size); + break; + + default: + if (!empty($list_chunk_parent) && (($riff_chunk[$chunk_name][$this_index]['offset'] + $riff_chunk[$chunk_name][$this_index]['size']) <= $list_chunk_max_offset)) { + $riff_chunk[$list_chunk_parent][$chunk_name][$this_index]['offset'] = $riff_chunk[$chunk_name][$this_index]['offset']; + $riff_chunk[$list_chunk_parent][$chunk_name][$this_index]['size'] = $riff_chunk[$chunk_name][$this_index]['size']; + unset($riff_chunk[$chunk_name][$this_index]['offset']); + unset($riff_chunk[$chunk_name][$this_index]['size']); + if (isset($riff_chunk[$chunk_name][$this_index]) && empty($riff_chunk[$chunk_name][$this_index])) { + unset($riff_chunk[$chunk_name][$this_index]); + } + if (isset($riff_chunk[$chunk_name]) && empty($riff_chunk[$chunk_name])) { + unset($riff_chunk[$chunk_name]); + } + $riff_chunk[$list_chunk_parent][$chunk_name][$this_index]['data'] = $this->fread($chunk_size); + } elseif ($chunk_size < 2048) { + // only read data in if smaller than 2kB + $riff_chunk[$chunk_name][$this_index]['data'] = $this->fread($chunk_size); + } else { + $this->fseek($chunk_size, SEEK_CUR); + } + break; + } + break; + + } + + } + + return $riff_chunk; + } + + + + private function RIFFparseWavPackHeader($wavpack3_chunk_data) { + + // typedef struct { + // char ckID [4]; + // long ckSize; + // short version; + // short bits; // added for version 2.00 + // short flags, shift; // added for version 3.00 + // long total_samples, crc, crc2; + // char extension [4], extra_bc, extras [3]; + // } WavpackHeader; + + $this->getid3->info['wavpack'] = array (); + $info_wavpack = &$this->getid3->info['wavpack']; + + $info_wavpack['version'] = getid3_lib::LittleEndian2Int(substr($wavpack3_chunk_data, 0, 2)); + + if ($info_wavpack['version'] >= 2) { + $info_wavpack['bits'] = getid3_lib::LittleEndian2Int(substr($wavpack3_chunk_data, 2, 2)); + } + + if ($info_wavpack['version'] >= 3) { + + getid3_lib::ReadSequence('LittleEndian2Int', $info_wavpack, $wavpack3_chunk_data, 4, + array ( + 'flags_raw' => 2, + 'shift' => 2, + 'total_samples' => 4, + 'crc1' => 4, + 'crc2' => 4, + 'extension' => -4, + 'extra_bc' => 1 + ) + ); + + for ($i = 0; $i < 3; $i++) { + $info_wavpack['extras'][] = getid3_lib::LittleEndian2Int($wavpack3_chunk_data{25 + $i}); + } + + $info_wavpack['flags'] = array (); + $info_wavpack_flags = &$info_wavpack['flags']; + + $info_wavpack_flags['mono'] = (bool)($info_wavpack['flags_raw'] & 0x000001); + $info_wavpack_flags['fast_mode'] = (bool)($info_wavpack['flags_raw'] & 0x000002); + $info_wavpack_flags['raw_mode'] = (bool)($info_wavpack['flags_raw'] & 0x000004); + $info_wavpack_flags['calc_noise'] = (bool)($info_wavpack['flags_raw'] & 0x000008); + $info_wavpack_flags['high_quality'] = (bool)($info_wavpack['flags_raw'] & 0x000010); + $info_wavpack_flags['3_byte_samples'] = (bool)($info_wavpack['flags_raw'] & 0x000020); + $info_wavpack_flags['over_20_bits'] = (bool)($info_wavpack['flags_raw'] & 0x000040); + $info_wavpack_flags['use_wvc'] = (bool)($info_wavpack['flags_raw'] & 0x000080); + $info_wavpack_flags['noiseshaping'] = (bool)($info_wavpack['flags_raw'] & 0x000100); + $info_wavpack_flags['very_fast_mode'] = (bool)($info_wavpack['flags_raw'] & 0x000200); + $info_wavpack_flags['new_high_quality'] = (bool)($info_wavpack['flags_raw'] & 0x000400); + $info_wavpack_flags['cancel_extreme'] = (bool)($info_wavpack['flags_raw'] & 0x000800); + $info_wavpack_flags['cross_decorrelation'] = (bool)($info_wavpack['flags_raw'] & 0x001000); + $info_wavpack_flags['new_decorrelation'] = (bool)($info_wavpack['flags_raw'] & 0x002000); + $info_wavpack_flags['joint_stereo'] = (bool)($info_wavpack['flags_raw'] & 0x004000); + $info_wavpack_flags['extra_decorrelation'] = (bool)($info_wavpack['flags_raw'] & 0x008000); + $info_wavpack_flags['override_noiseshape'] = (bool)($info_wavpack['flags_raw'] & 0x010000); + $info_wavpack_flags['override_jointstereo'] = (bool)($info_wavpack['flags_raw'] & 0x020000); + $info_wavpack_flags['copy_source_filetime'] = (bool)($info_wavpack['flags_raw'] & 0x040000); + $info_wavpack_flags['create_exe'] = (bool)($info_wavpack['flags_raw'] & 0x080000); + } + + return true; + } + + + + public function AnalyzeString(&$string) { + + // Rewrite header_size in header + $new_header_size = getid3_lib::LittleEndian2String(strlen($string), 4); + for ($i = 0; $i < 4; $i++) { + $string{$i + 4} = $new_header_size{$i}; + } + + return parent::AnalyzeString($string); + } + + + + public static function RIFFparseWAVEFORMATex($wave_format_ex_data) { + + $wave_format_ex['raw'] = array (); + $wave_format_ex_raw = &$wave_format_ex['raw']; + + getid3_lib::ReadSequence('LittleEndian2Int', $wave_format_ex_raw, $wave_format_ex_data, 0, + array ( + 'wFormatTag' => 2, + 'nChannels' => 2, + 'nSamplesPerSec' => 4, + 'nAvgBytesPerSec' => 4, + 'nBlockAlign' => 2, + 'wBitsPerSample' => 2 + ) + ); + + if (strlen($wave_format_ex_data) > 16) { + $wave_format_ex_raw['cbSize'] = getid3_lib::LittleEndian2Int(substr($wave_format_ex_data, 16, 2)); + } + + $wave_format_ex['codec'] = getid3_riff::RIFFwFormatTagLookup($wave_format_ex_raw['wFormatTag']); + $wave_format_ex['channels'] = $wave_format_ex_raw['nChannels']; + $wave_format_ex['sample_rate'] = $wave_format_ex_raw['nSamplesPerSec']; + $wave_format_ex['bitrate'] = $wave_format_ex_raw['nAvgBytesPerSec'] * 8; + if (@$wave_format_ex_raw['wBitsPerSample']) { + $wave_format_ex['bits_per_sample'] = $wave_format_ex_raw['wBitsPerSample']; + } + + return $wave_format_ex; + } + + + + public static function RIFFwFormatTagLookup($w_format_tag) { + + static $lookup = array ( + 0x0000 => 'Microsoft Unknown Wave Format', + 0x0001 => 'Pulse Code Modulation (PCM)', + 0x0002 => 'Microsoft ADPCM', + 0x0003 => 'IEEE Float', + 0x0004 => 'Compaq Computer VSELP', + 0x0005 => 'IBM CVSD', + 0x0006 => 'Microsoft A-Law', + 0x0007 => 'Microsoft mu-Law', + 0x0008 => 'Microsoft DTS', + 0x0010 => 'OKI ADPCM', + 0x0011 => 'Intel DVI/IMA ADPCM', + 0x0012 => 'Videologic MediaSpace ADPCM', + 0x0013 => 'Sierra Semiconductor ADPCM', + 0x0014 => 'Antex Electronics G.723 ADPCM', + 0x0015 => 'DSP Solutions DigiSTD', + 0x0016 => 'DSP Solutions DigiFIX', + 0x0017 => 'Dialogic OKI ADPCM', + 0x0018 => 'MediaVision ADPCM', + 0x0019 => 'Hewlett-Packard CU', + 0x0020 => 'Yamaha ADPCM', + 0x0021 => 'Speech Compression Sonarc', + 0x0022 => 'DSP Group TrueSpeech', + 0x0023 => 'Echo Speech EchoSC1', + 0x0024 => 'Audiofile AF36', + 0x0025 => 'Audio Processing Technology APTX', + 0x0026 => 'AudioFile AF10', + 0x0027 => 'Prosody 1612', + 0x0028 => 'LRC', + 0x0030 => 'Dolby AC2', + 0x0031 => 'Microsoft GSM 6.10', + 0x0032 => 'MSNAudio', + 0x0033 => 'Antex Electronics ADPCME', + 0x0034 => 'Control Resources VQLPC', + 0x0035 => 'DSP Solutions DigiREAL', + 0x0036 => 'DSP Solutions DigiADPCM', + 0x0037 => 'Control Resources CR10', + 0x0038 => 'Natural MicroSystems VBXADPCM', + 0x0039 => 'Crystal Semiconductor IMA ADPCM', + 0x003A => 'EchoSC3', + 0x003B => 'Rockwell ADPCM', + 0x003C => 'Rockwell Digit LK', + 0x003D => 'Xebec', + 0x0040 => 'Antex Electronics G.721 ADPCM', + 0x0041 => 'G.728 CELP', + 0x0042 => 'MSG723', + 0x0050 => 'MPEG Layer-2 or Layer-1', + 0x0052 => 'RT24', + 0x0053 => 'PAC', + 0x0055 => 'MPEG Layer-3', + 0x0059 => 'Lucent G.723', + 0x0060 => 'Cirrus', + 0x0061 => 'ESPCM', + 0x0062 => 'Voxware', + 0x0063 => 'Canopus Atrac', + 0x0064 => 'G.726 ADPCM', + 0x0065 => 'G.722 ADPCM', + 0x0066 => 'DSAT', + 0x0067 => 'DSAT Display', + 0x0069 => 'Voxware Byte Aligned', + 0x0070 => 'Voxware AC8', + 0x0071 => 'Voxware AC10', + 0x0072 => 'Voxware AC16', + 0x0073 => 'Voxware AC20', + 0x0074 => 'Voxware MetaVoice', + 0x0075 => 'Voxware MetaSound', + 0x0076 => 'Voxware RT29HW', + 0x0077 => 'Voxware VR12', + 0x0078 => 'Voxware VR18', + 0x0079 => 'Voxware TQ40', + 0x0080 => 'Softsound', + 0x0081 => 'Voxware TQ60', + 0x0082 => 'MSRT24', + 0x0083 => 'G.729A', + 0x0084 => 'MVI MV12', + 0x0085 => 'DF G.726', + 0x0086 => 'DF GSM610', + 0x0088 => 'ISIAudio', + 0x0089 => 'Onlive', + 0x0091 => 'SBC24', + 0x0092 => 'Dolby AC3 SPDIF', + 0x0093 => 'MediaSonic G.723', + 0x0094 => 'Aculab PLC Prosody 8kbps', + 0x0097 => 'ZyXEL ADPCM', + 0x0098 => 'Philips LPCBB', + 0x0099 => 'Packed', + 0x00FF => 'AAC', + 0x0100 => 'Rhetorex ADPCM', + 0x0101 => 'IBM mu-law', + 0x0102 => 'IBM A-law', + 0x0103 => 'IBM AVC Adaptive Differential Pulse Code Modulation (ADPCM)', + 0x0111 => 'Vivo G.723', + 0x0112 => 'Vivo Siren', + 0x0123 => 'Digital G.723', + 0x0125 => 'Sanyo LD ADPCM', + 0x0130 => 'Sipro Lab Telecom ACELP NET', + 0x0131 => 'Sipro Lab Telecom ACELP 4800', + 0x0132 => 'Sipro Lab Telecom ACELP 8V3', + 0x0133 => 'Sipro Lab Telecom G.729', + 0x0134 => 'Sipro Lab Telecom G.729A', + 0x0135 => 'Sipro Lab Telecom Kelvin', + 0x0140 => 'Windows Media Video V8', + 0x0150 => 'Qualcomm PureVoice', + 0x0151 => 'Qualcomm HalfRate', + 0x0155 => 'Ring Zero Systems TUB GSM', + 0x0160 => 'Microsoft Audio 1', + 0x0161 => 'Windows Media Audio V7 / V8 / V9', + 0x0162 => 'Windows Media Audio Professional V9', + 0x0163 => 'Windows Media Audio Lossless V9', + 0x0200 => 'Creative Labs ADPCM', + 0x0202 => 'Creative Labs Fastspeech8', + 0x0203 => 'Creative Labs Fastspeech10', + 0x0210 => 'UHER Informatic GmbH ADPCM', + 0x0220 => 'Quarterdeck', + 0x0230 => 'I-link Worldwide VC', + 0x0240 => 'Aureal RAW Sport', + 0x0250 => 'Interactive Products HSX', + 0x0251 => 'Interactive Products RPELP', + 0x0260 => 'Consistent Software CS2', + 0x0270 => 'Sony SCX', + 0x0300 => 'Fujitsu FM Towns Snd', + 0x0400 => 'BTV Digital', + 0x0401 => 'Intel Music Coder', + 0x0450 => 'QDesign Music', + 0x0680 => 'VME VMPCM', + 0x0681 => 'AT&T Labs TPC', + 0x08AE => 'ClearJump LiteWave', + 0x1000 => 'Olivetti GSM', + 0x1001 => 'Olivetti ADPCM', + 0x1002 => 'Olivetti CELP', + 0x1003 => 'Olivetti SBC', + 0x1004 => 'Olivetti OPR', + 0x1100 => 'Lernout & Hauspie Codec (0x1100)', + 0x1101 => 'Lernout & Hauspie CELP Codec (0x1101)', + 0x1102 => 'Lernout & Hauspie SBC Codec (0x1102)', + 0x1103 => 'Lernout & Hauspie SBC Codec (0x1103)', + 0x1104 => 'Lernout & Hauspie SBC Codec (0x1104)', + 0x1400 => 'Norris', + 0x1401 => 'AT&T ISIAudio', + 0x1500 => 'Soundspace Music Compression', + 0x181C => 'VoxWare RT24 Speech', + 0x1FC4 => 'NCT Soft ALF2CD (www.nctsoft.com)', + 0x2000 => 'Dolby AC3', + 0x2001 => 'Dolby DTS', + 0x2002 => 'WAVE_FORMAT_14_4', + 0x2003 => 'WAVE_FORMAT_28_8', + 0x2004 => 'WAVE_FORMAT_COOK', + 0x2005 => 'WAVE_FORMAT_DNET', + 0x674F => 'Ogg Vorbis 1', + 0x6750 => 'Ogg Vorbis 2', + 0x6751 => 'Ogg Vorbis 3', + 0x676F => 'Ogg Vorbis 1+', + 0x6770 => 'Ogg Vorbis 2+', + 0x6771 => 'Ogg Vorbis 3+', + 0x7A21 => 'GSM-AMR (CBR, no SID)', + 0x7A22 => 'GSM-AMR (VBR, including SID)', + 0xFFFE => 'WAVE_FORMAT_EXTENSIBLE', + 0xFFFF => 'WAVE_FORMAT_DEVELOPMENT' + ); + + return @$lookup[$w_format_tag]; + } + + + + public static function RIFFfourccLookup($four_cc) { + + static $lookup = array ( + 'swot' => 'http://developer.apple.com/qa/snd/snd07.html', + '____' => 'No Codec (____)', + '_BIT' => 'BI_BITFIELDS (Raw RGB)', + '_JPG' => 'JPEG compressed', + '_PNG' => 'PNG compressed W3C/ISO/IEC (RFC-2083)', + '_RAW' => 'Full Frames (Uncompressed)', + '_RGB' => 'Raw RGB Bitmap', + '_RL4' => 'RLE 4bpp RGB', + '_RL8' => 'RLE 8bpp RGB', + '3IV1' => '3ivx MPEG-4 v1', + '3IV2' => '3ivx MPEG-4 v2', + '3IVX' => '3ivx MPEG-4', + 'AASC' => 'Autodesk Animator', + 'ABYR' => 'Kensington ?ABYR?', + 'AEMI' => 'Array Microsystems VideoONE MPEG1-I Capture', + 'AFLC' => 'Autodesk Animator FLC', + 'AFLI' => 'Autodesk Animator FLI', + 'AMPG' => 'Array Microsystems VideoONE MPEG', + 'ANIM' => 'Intel RDX (ANIM)', + 'AP41' => 'AngelPotion Definitive', + 'ASV1' => 'Asus Video v1', + 'ASV2' => 'Asus Video v2', + 'ASVX' => 'Asus Video 2.0 (audio)', + 'AUR2' => 'AuraVision Aura 2 Codec - YUV 4:2:2', + 'AURA' => 'AuraVision Aura 1 Codec - YUV 4:1:1', + 'AVDJ' => 'Independent JPEG Group\'s codec (AVDJ)', + 'AVRN' => 'Independent JPEG Group\'s codec (AVRN)', + 'AYUV' => '4:4:4 YUV (AYUV)', + 'AZPR' => 'Quicktime Apple Video (AZPR)', + 'BGR ' => 'Raw RGB32', + 'BLZ0' => 'FFmpeg MPEG-4', + 'BTVC' => 'Conexant Composite Video', + 'BINK' => 'RAD Game Tools Bink Video', + 'BT20' => 'Conexant Prosumer Video', + 'BTCV' => 'Conexant Composite Video Codec', + 'BW10' => 'Data Translation Broadway MPEG Capture', + 'CC12' => 'Intel YUV12', + 'CDVC' => 'Canopus DV', + 'CFCC' => 'Digital Processing Systems DPS Perception', + 'CGDI' => 'Microsoft Office 97 Camcorder Video', + 'CHAM' => 'Winnov Caviara Champagne', + 'CJPG' => 'Creative WebCam JPEG', + 'CLJR' => 'Cirrus Logic YUV 4:1:1', + 'CMYK' => 'Common Data Format in Printing (Colorgraph)', + 'CPLA' => 'Weitek 4:2:0 YUV Planar', + 'CRAM' => 'Microsoft Video 1 (CRAM)', + 'cvid' => 'Radius Cinepak', + 'CVID' => 'Radius Cinepak', + 'CWLT' => 'Microsoft Color WLT DIB', + 'CYUV' => 'Creative Labs YUV', + 'CYUY' => 'ATI YUV', + 'D261' => 'H.261', + 'D263' => 'H.263', + 'DIB ' => 'Device Independent Bitmap', + 'DIV1' => 'FFmpeg OpenDivX', + 'DIV2' => 'Microsoft MPEG-4 v1/v2', + 'DIV3' => 'DivX ;-) MPEG-4 v3.x Low-Motion', + 'DIV4' => 'DivX ;-) MPEG-4 v3.x Fast-Motion', + 'DIV5' => 'DivX MPEG-4 v5.x', + 'DIV6' => 'DivX ;-) (MS MPEG-4 v3.x)', + 'DIVX' => 'DivX MPEG-4 v4 (OpenDivX / Project Mayo)', + 'divx' => 'DivX MPEG-4', + 'DMB1' => 'Matrox Rainbow Runner hardware MJPEG', + 'DMB2' => 'Paradigm MJPEG', + 'DSVD' => '?DSVD?', + 'DUCK' => 'Duck TrueMotion 1.0', + 'DPS0' => 'DPS/Leitch Reality Motion JPEG', + 'DPSC' => 'DPS/Leitch PAR Motion JPEG', + 'DV25' => 'Matrox DVCPRO codec', + 'DV50' => 'Matrox DVCPRO50 codec', + 'DVC ' => 'IEC 61834 and SMPTE 314M (DVC/DV Video)', + 'DVCP' => 'IEC 61834 and SMPTE 314M (DVC/DV Video)', + 'DVHD' => 'IEC Standard DV 1125 lines @ 30fps / 1250 lines @ 25fps', + 'DVMA' => 'Darim Vision DVMPEG (dummy for MPEG compressor) (www.darvision.com)', + 'DVSL' => 'IEC Standard DV compressed in SD (SDL)', + 'DVAN' => '?DVAN?', + 'DVE2' => 'InSoft DVE-2 Videoconferencing', + 'dvsd' => 'IEC 61834 and SMPTE 314M DVC/DV Video', + 'DVSD' => 'IEC 61834 and SMPTE 314M DVC/DV Video', + 'DVX1' => 'Lucent DVX1000SP Video Decoder', + 'DVX2' => 'Lucent DVX2000S Video Decoder', + 'DVX3' => 'Lucent DVX3000S Video Decoder', + 'DX50' => 'DivX v5', + 'DXT1' => 'Microsoft DirectX Compressed Texture (DXT1)', + 'DXT2' => 'Microsoft DirectX Compressed Texture (DXT2)', + 'DXT3' => 'Microsoft DirectX Compressed Texture (DXT3)', + 'DXT4' => 'Microsoft DirectX Compressed Texture (DXT4)', + 'DXT5' => 'Microsoft DirectX Compressed Texture (DXT5)', + 'DXTC' => 'Microsoft DirectX Compressed Texture (DXTC)', + 'DXTn' => 'Microsoft DirectX Compressed Texture (DXTn)', + 'EM2V' => 'Etymonix MPEG-2 I-frame (www.etymonix.com)', + 'EKQ0' => 'Elsa ?EKQ0?', + 'ELK0' => 'Elsa ?ELK0?', + 'ESCP' => 'Eidos Escape', + 'ETV1' => 'eTreppid Video ETV1', + 'ETV2' => 'eTreppid Video ETV2', + 'ETVC' => 'eTreppid Video ETVC', + 'FLIC' => 'Autodesk FLI/FLC Animation', + 'FRWT' => 'Darim Vision Forward Motion JPEG (www.darvision.com)', + 'FRWU' => 'Darim Vision Forward Uncompressed (www.darvision.com)', + 'FLJP' => 'D-Vision Field Encoded Motion JPEG', + 'FRWA' => 'SoftLab-Nsk Forward Motion JPEG w/ alpha channel', + 'FRWD' => 'SoftLab-Nsk Forward Motion JPEG', + 'FVF1' => 'Iterated Systems Fractal Video Frame', + 'GLZW' => 'Motion LZW (gabest@freemail.hu)', + 'GPEG' => 'Motion JPEG (gabest@freemail.hu)', + 'GWLT' => 'Microsoft Greyscale WLT DIB', + 'H260' => 'Intel ITU H.260 Videoconferencing', + 'H261' => 'Intel ITU H.261 Videoconferencing', + 'H262' => 'Intel ITU H.262 Videoconferencing', + 'H263' => 'Intel ITU H.263 Videoconferencing', + 'H264' => 'Intel ITU H.264 Videoconferencing', + 'H265' => 'Intel ITU H.265 Videoconferencing', + 'H266' => 'Intel ITU H.266 Videoconferencing', + 'H267' => 'Intel ITU H.267 Videoconferencing', + 'H268' => 'Intel ITU H.268 Videoconferencing', + 'H269' => 'Intel ITU H.269 Videoconferencing', + 'HFYU' => 'Huffman Lossless Codec', + 'HMCR' => 'Rendition Motion Compensation Format (HMCR)', + 'HMRR' => 'Rendition Motion Compensation Format (HMRR)', + 'I263' => 'FFmpeg I263 decoder', + 'IF09' => 'Indeo YVU9 ("YVU9 with additional delta-frame info after the U plane")', + 'IUYV' => 'Interlaced version of UYVY (www.leadtools.com)', + 'IY41' => 'Interlaced version of Y41P (www.leadtools.com)', + 'IYU1' => '12 bit format used in mode 2 of the IEEE 1394 Digital Camera 1.04 spec IEEE standard', + 'IYU2' => '24 bit format used in mode 2 of the IEEE 1394 Digital Camera 1.04 spec IEEE standard', + 'IYUV' => 'Planar YUV format (8-bpp Y plane, followed by 8-bpp 2×2 U and V planes)', + 'i263' => 'Intel ITU H.263 Videoconferencing (i263)', + 'I420' => 'Intel Indeo 4', + 'IAN ' => 'Intel Indeo 4 (RDX)', + 'ICLB' => 'InSoft CellB Videoconferencing', + 'IGOR' => 'Power DVD', + 'IJPG' => 'Intergraph JPEG', + 'ILVC' => 'Intel Layered Video', + 'ILVR' => 'ITU-T H.263+', + 'IPDV' => 'I-O Data Device Giga AVI DV Codec', + 'IR21' => 'Intel Indeo 2.1', + 'IRAW' => 'Intel YUV Uncompressed', + 'IV30' => 'Intel Indeo 3.0', + 'IV31' => 'Intel Indeo 3.1', + 'IV32' => 'Ligos Indeo 3.2', + 'IV33' => 'Ligos Indeo 3.3', + 'IV34' => 'Ligos Indeo 3.4', + 'IV35' => 'Ligos Indeo 3.5', + 'IV36' => 'Ligos Indeo 3.6', + 'IV37' => 'Ligos Indeo 3.7', + 'IV38' => 'Ligos Indeo 3.8', + 'IV39' => 'Ligos Indeo 3.9', + 'IV40' => 'Ligos Indeo Interactive 4.0', + 'IV41' => 'Ligos Indeo Interactive 4.1', + 'IV42' => 'Ligos Indeo Interactive 4.2', + 'IV43' => 'Ligos Indeo Interactive 4.3', + 'IV44' => 'Ligos Indeo Interactive 4.4', + 'IV45' => 'Ligos Indeo Interactive 4.5', + 'IV46' => 'Ligos Indeo Interactive 4.6', + 'IV47' => 'Ligos Indeo Interactive 4.7', + 'IV48' => 'Ligos Indeo Interactive 4.8', + 'IV49' => 'Ligos Indeo Interactive 4.9', + 'IV50' => 'Ligos Indeo Interactive 5.0', + 'JBYR' => 'Kensington ?JBYR?', + 'JPEG' => 'Still Image JPEG DIB', + 'JPGL' => 'Pegasus Lossless Motion JPEG', + 'KMVC' => 'Team17 Software Karl Morton\'s Video Codec', + 'LSVM' => 'Vianet Lighting Strike Vmail (Streaming) (www.vianet.com)', + 'LEAD' => 'LEAD Video Codec', + 'Ljpg' => 'LEAD MJPEG Codec', + 'MDVD' => 'Alex MicroDVD Video (hacked MS MPEG-4) (www.tiasoft.de)', + 'MJPA' => 'Morgan Motion JPEG (MJPA) (www.morgan-multimedia.com)', + 'MJPB' => 'Morgan Motion JPEG (MJPB) (www.morgan-multimedia.com)', + 'MMES' => 'Matrox MPEG-2 I-frame', + 'MP2v' => 'Microsoft S-Mpeg 4 version 1 (MP2v)', + 'MP42' => 'Microsoft S-Mpeg 4 version 2 (MP42)', + 'MP43' => 'Microsoft S-Mpeg 4 version 3 (MP43)', + 'MP4S' => 'Microsoft S-Mpeg 4 version 3 (MP4S)', + 'MP4V' => 'FFmpeg MPEG-4', + 'MPG1' => 'FFmpeg MPEG 1/2', + 'MPG2' => 'FFmpeg MPEG 1/2', + 'MPG3' => 'FFmpeg DivX ;-) (MS MPEG-4 v3)', + 'MPG4' => 'Microsoft MPEG-4', + 'MPGI' => 'Sigma Designs MPEG', + 'MPNG' => 'PNG images decoder', + 'MSS1' => 'Microsoft Windows Screen Video', + 'MSZH' => 'LCL (Lossless Codec Library) (www.geocities.co.jp/Playtown-Denei/2837/LRC.htm)', + 'M261' => 'Microsoft H.261', + 'M263' => 'Microsoft H.263', + 'M4S2' => 'Microsoft Fully Compliant MPEG-4 v2 simple profile (M4S2)', + 'm4s2' => 'Microsoft Fully Compliant MPEG-4 v2 simple profile (m4s2)', + 'MC12' => 'ATI Motion Compensation Format (MC12)', + 'MCAM' => 'ATI Motion Compensation Format (MCAM)', + 'MJ2C' => 'Morgan Multimedia Motion JPEG2000', + 'mJPG' => 'IBM Motion JPEG w/ Huffman Tables', + 'MJPG' => 'Microsoft Motion JPEG DIB', + 'MP42' => 'Microsoft MPEG-4 (low-motion)', + 'MP43' => 'Microsoft MPEG-4 (fast-motion)', + 'MP4S' => 'Microsoft MPEG-4 (MP4S)', + 'mp4s' => 'Microsoft MPEG-4 (mp4s)', + 'MPEG' => 'Chromatic Research MPEG-1 Video I-Frame', + 'MPG4' => 'Microsoft MPEG-4 Video High Speed Compressor', + 'MPGI' => 'Sigma Designs MPEG', + 'MRCA' => 'FAST Multimedia Martin Regen Codec', + 'MRLE' => 'Microsoft Run Length Encoding', + 'MSVC' => 'Microsoft Video 1', + 'MTX1' => 'Matrox ?MTX1?', + 'MTX2' => 'Matrox ?MTX2?', + 'MTX3' => 'Matrox ?MTX3?', + 'MTX4' => 'Matrox ?MTX4?', + 'MTX5' => 'Matrox ?MTX5?', + 'MTX6' => 'Matrox ?MTX6?', + 'MTX7' => 'Matrox ?MTX7?', + 'MTX8' => 'Matrox ?MTX8?', + 'MTX9' => 'Matrox ?MTX9?', + 'MV12' => 'Motion Pixels Codec (old)', + 'MWV1' => 'Aware Motion Wavelets', + 'nAVI' => 'SMR Codec (hack of Microsoft MPEG-4) (IRC #shadowrealm)', + 'NT00' => 'NewTek LightWave HDTV YUV w/ Alpha (www.newtek.com)', + 'NUV1' => 'NuppelVideo', + 'NTN1' => 'Nogatech Video Compression 1', + 'NVS0' => 'nVidia GeForce Texture (NVS0)', + 'NVS1' => 'nVidia GeForce Texture (NVS1)', + 'NVS2' => 'nVidia GeForce Texture (NVS2)', + 'NVS3' => 'nVidia GeForce Texture (NVS3)', + 'NVS4' => 'nVidia GeForce Texture (NVS4)', + 'NVS5' => 'nVidia GeForce Texture (NVS5)', + 'NVT0' => 'nVidia GeForce Texture (NVT0)', + 'NVT1' => 'nVidia GeForce Texture (NVT1)', + 'NVT2' => 'nVidia GeForce Texture (NVT2)', + 'NVT3' => 'nVidia GeForce Texture (NVT3)', + 'NVT4' => 'nVidia GeForce Texture (NVT4)', + 'NVT5' => 'nVidia GeForce Texture (NVT5)', + 'PIXL' => 'MiroXL, Pinnacle PCTV', + 'PDVC' => 'I-O Data Device Digital Video Capture DV codec', + 'PGVV' => 'Radius Video Vision', + 'PHMO' => 'IBM Photomotion', + 'PIM1' => 'MPEG Realtime (Pinnacle Cards)', + 'PIM2' => 'Pegasus Imaging ?PIM2?', + 'PIMJ' => 'Pegasus Imaging Lossless JPEG', + 'PVEZ' => 'Horizons Technology PowerEZ', + 'PVMM' => 'PacketVideo Corporation MPEG-4', + 'PVW2' => 'Pegasus Imaging Wavelet Compression', + 'Q1.0' => 'Q-Team\'s QPEG 1.0 (www.q-team.de)', + 'Q1.1' => 'Q-Team\'s QPEG 1.1 (www.q-team.de)', + 'QPEG' => 'Q-Team QPEG 1.0', + 'qpeq' => 'Q-Team QPEG 1.1', + 'RGB ' => 'Raw BGR32', + 'RGBA' => 'Raw RGB w/ Alpha', + 'RMP4' => 'REALmagic MPEG-4 (unauthorized XVID copy) (www.sigmadesigns.com)', + 'ROQV' => 'Id RoQ File Video Decoder', + 'RPZA' => 'Quicktime Apple Video (RPZA)', + 'RUD0' => 'Rududu video codec (http://rududu.ifrance.com/rududu/)', + 'RV10' => 'RealVideo 1.0 (aka RealVideo 5.0)', + 'RV13' => 'RealVideo 1.0 (RV13)', + 'RV20' => 'RealVideo G2', + 'RV30' => 'RealVideo 8', + 'RV40' => 'RealVideo 9', + 'RGBT' => 'Raw RGB w/ Transparency', + 'RLE ' => 'Microsoft Run Length Encoder', + 'RLE4' => 'Run Length Encoded (4bpp, 16-color)', + 'RLE8' => 'Run Length Encoded (8bpp, 256-color)', + 'RT21' => 'Intel Indeo RealTime Video 2.1', + 'rv20' => 'RealVideo G2', + 'rv30' => 'RealVideo 8', + 'RVX ' => 'Intel RDX (RVX )', + 'SMC ' => 'Apple Graphics (SMC )', + 'SP54' => 'Logitech Sunplus Sp54 Codec for Mustek GSmart Mini 2', + 'SPIG' => 'Radius Spigot', + 'SVQ3' => 'Sorenson Video 3 (Apple Quicktime 5)', + 's422' => 'Tekram VideoCap C210 YUV 4:2:2', + 'SDCC' => 'Sun Communication Digital Camera Codec', + 'SFMC' => 'CrystalNet Surface Fitting Method', + 'SMSC' => 'Radius SMSC', + 'SMSD' => 'Radius SMSD', + 'smsv' => 'WorldConnect Wavelet Video', + 'SPIG' => 'Radius Spigot', + 'SPLC' => 'Splash Studios ACM Audio Codec (www.splashstudios.net)', + 'SQZ2' => 'Microsoft VXTreme Video Codec V2', + 'STVA' => 'ST Microelectronics CMOS Imager Data (Bayer)', + 'STVB' => 'ST Microelectronics CMOS Imager Data (Nudged Bayer)', + 'STVC' => 'ST Microelectronics CMOS Imager Data (Bunched)', + 'STVX' => 'ST Microelectronics CMOS Imager Data (Extended CODEC Data Format)', + 'STVY' => 'ST Microelectronics CMOS Imager Data (Extended CODEC Data Format with Correction Data)', + 'SV10' => 'Sorenson Video R1', + 'SVQ1' => 'Sorenson Video', + 'T420' => 'Toshiba YUV 4:2:0', + 'TM2A' => 'Duck TrueMotion Archiver 2.0 (www.duck.com)', + 'TVJP' => 'Pinnacle/Truevision Targa 2000 board (TVJP)', + 'TVMJ' => 'Pinnacle/Truevision Targa 2000 board (TVMJ)', + 'TY0N' => 'Tecomac Low-Bit Rate Codec (www.tecomac.com)', + 'TY2C' => 'Trident Decompression Driver', + 'TLMS' => 'TeraLogic Motion Intraframe Codec (TLMS)', + 'TLST' => 'TeraLogic Motion Intraframe Codec (TLST)', + 'TM20' => 'Duck TrueMotion 2.0', + 'TM2X' => 'Duck TrueMotion 2X', + 'TMIC' => 'TeraLogic Motion Intraframe Codec (TMIC)', + 'TMOT' => 'Horizons Technology TrueMotion S', + 'tmot' => 'Horizons TrueMotion Video Compression', + 'TR20' => 'Duck TrueMotion RealTime 2.0', + 'TSCC' => 'TechSmith Screen Capture Codec', + 'TV10' => 'Tecomac Low-Bit Rate Codec', + 'TY2N' => 'Trident ?TY2N?', + 'U263' => 'UB Video H.263/H.263+/H.263++ Decoder', + 'UMP4' => 'UB Video MPEG 4 (www.ubvideo.com)', + 'UYNV' => 'Nvidia UYVY packed 4:2:2', + 'UYVP' => 'Evans & Sutherland YCbCr 4:2:2 extended precision', + 'UCOD' => 'eMajix.com ClearVideo', + 'ULTI' => 'IBM Ultimotion', + 'UYVY' => 'UYVY packed 4:2:2', + 'V261' => 'Lucent VX2000S', + 'VIFP' => 'VFAPI Reader Codec (www.yks.ne.jp/~hori/)', + 'VIV1' => 'FFmpeg H263+ decoder', + 'VIV2' => 'Vivo H.263', + 'VQC2' => 'Vector-quantised codec 2 (research) http://eprints.ecs.soton.ac.uk/archive/00001310/01/VTC97-js.pdf)', + 'VTLP' => 'Alaris VideoGramPiX', + 'VYU9' => 'ATI YUV (VYU9)', + 'VYUY' => 'ATI YUV (VYUY)', + 'V261' => 'Lucent VX2000S', + 'V422' => 'Vitec Multimedia 24-bit YUV 4:2:2 Format', + 'V655' => 'Vitec Multimedia 16-bit YUV 4:2:2 Format', + 'VCR1' => 'ATI Video Codec 1', + 'VCR2' => 'ATI Video Codec 2', + 'VCR3' => 'ATI VCR 3.0', + 'VCR4' => 'ATI VCR 4.0', + 'VCR5' => 'ATI VCR 5.0', + 'VCR6' => 'ATI VCR 6.0', + 'VCR7' => 'ATI VCR 7.0', + 'VCR8' => 'ATI VCR 8.0', + 'VCR9' => 'ATI VCR 9.0', + 'VDCT' => 'Vitec Multimedia Video Maker Pro DIB', + 'VDOM' => 'VDOnet VDOWave', + 'VDOW' => 'VDOnet VDOLive (H.263)', + 'VDTZ' => 'Darim Vison VideoTizer YUV', + 'VGPX' => 'Alaris VideoGramPiX', + 'VIDS' => 'Vitec Multimedia YUV 4:2:2 CCIR 601 for V422', + 'VIVO' => 'Vivo H.263 v2.00', + 'vivo' => 'Vivo H.263', + 'VIXL' => 'Miro/Pinnacle Video XL', + 'VLV1' => 'VideoLogic/PURE Digital Videologic Capture', + 'VP30' => 'On2 VP3.0', + 'VP31' => 'On2 VP3.1', + 'VX1K' => 'Lucent VX1000S Video Codec', + 'VX2K' => 'Lucent VX2000S Video Codec', + 'VXSP' => 'Lucent VX1000SP Video Codec', + 'WBVC' => 'Winbond W9960', + 'WHAM' => 'Microsoft Video 1 (WHAM)', + 'WINX' => 'Winnov Software Compression', + 'WJPG' => 'AverMedia Winbond JPEG', + 'WMV1' => 'Windows Media Video V7', + 'WMV2' => 'Windows Media Video V8', + 'WMV3' => 'Windows Media Video V9', + 'WNV1' => 'Winnov Hardware Compression', + 'XYZP' => 'Extended PAL format XYZ palette (www.riff.org)', + 'x263' => 'Xirlink H.263', + 'XLV0' => 'NetXL Video Decoder', + 'XMPG' => 'Xing MPEG (I-Frame only)', + 'XVID' => 'XviD MPEG-4 (www.xvid.org)', + 'XXAN' => '?XXAN?', + 'YU92' => 'Intel YUV (YU92)', + 'YUNV' => 'Nvidia Uncompressed YUV 4:2:2', + 'YUVP' => 'Extended PAL format YUV palette (www.riff.org)', + 'Y211' => 'YUV 2:1:1 Packed', + 'Y411' => 'YUV 4:1:1 Packed', + 'Y41B' => 'Weitek YUV 4:1:1 Planar', + 'Y41P' => 'Brooktree PC1 YUV 4:1:1 Packed', + 'Y41T' => 'Brooktree PC1 YUV 4:1:1 with transparency', + 'Y42B' => 'Weitek YUV 4:2:2 Planar', + 'Y42T' => 'Brooktree UYUV 4:2:2 with transparency', + 'Y422' => 'ADS Technologies Copy of UYVY used in Pyro WebCam firewire camera', + 'Y800' => 'Simple, single Y plane for monochrome images', + 'Y8 ' => 'Grayscale video', + 'YC12' => 'Intel YUV 12 codec', + 'YUV8' => 'Winnov Caviar YUV8', + 'YUV9' => 'Intel YUV9', + 'YUY2' => 'Uncompressed YUV 4:2:2', + 'YUYV' => 'Canopus YUV', + 'YV12' => 'YVU12 Planar', + 'YVU9' => 'Intel YVU9 Planar (8-bpp Y plane, followed by 8-bpp 4x4 U and V planes)', + 'YVYU' => 'YVYU 4:2:2 Packed', + 'ZLIB' => 'Lossless Codec Library zlib compression (www.geocities.co.jp/Playtown-Denei/2837/LRC.htm)', + 'ZPEG' => 'Metheus Video Zipper' + ); + + return @$lookup[$four_cc]; + } + + + + public static function RIFFcommentsParse(&$riff_info_aray, &$comments_target_array) { + + static $lookup = array( + 'IARL' => 'archivallocation', + 'IART' => 'artist', + 'ICDS' => 'costumedesigner', + 'ICMS' => 'commissionedby', + 'ICMT' => 'comment', + 'ICNT' => 'country', + 'ICOP' => 'copyright', + 'ICRD' => 'creationdate', + 'IDIM' => 'dimensions', + 'IDIT' => 'digitizationdate', + 'IDPI' => 'resolution', + 'IDST' => 'distributor', + 'IEDT' => 'editor', + 'IENG' => 'engineers', + 'IFRM' => 'accountofparts', + 'IGNR' => 'genre', + 'IKEY' => 'keywords', + 'ILGT' => 'lightness', + 'ILNG' => 'language', + 'IMED' => 'orignalmedium', + 'IMUS' => 'composer', + 'INAM' => 'title', + 'IPDS' => 'productiondesigner', + 'IPLT' => 'palette', + 'IPRD' => 'product', + 'IPRO' => 'producer', + 'IPRT' => 'part', + 'IRTD' => 'rating', + 'ISBJ' => 'subject', + 'ISFT' => 'software', + 'ISGN' => 'secondarygenre', + 'ISHP' => 'sharpness', + 'ISRC' => 'sourcesupplier', + 'ISRF' => 'digitizationsource', + 'ISTD' => 'productionstudio', + 'ISTR' => 'starring', + 'ITCH' => 'encoded_by', + 'IWEB' => 'url', + 'IWRI' => 'writer' + ); + + foreach ($lookup as $key => $value) { + if (isset($riff_info_aray[$key])) { + foreach ($riff_info_aray[$key] as $comment_id => $comment_data) { + if (trim($comment_data['data']) != '') { + @$comments_target_array[$value][] = trim($comment_data['data']); + } + } + } + } + return true; + } + + + + public static function array_merge_noclobber($array1, $array2) { + if (!is_array($array1) || !is_array($array2)) { + return false; + } + $new_array = $array1; + foreach ($array2 as $key => $val) { + if (is_array($val) && isset($new_array[$key]) && is_array($new_array[$key])) { + $new_array[$key] = getid3_riff::array_merge_noclobber($new_array[$key], $val); + } elseif (!isset($new_array[$key])) { + $new_array[$key] = $val; + } + } + return $new_array; + } + + + + public static function DateMac2Unix($mac_date) { + + // Macintosh timestamp: seconds since 00:00h January 1, 1904 + // UNIX timestamp: seconds since 00:00h January 1, 1970 + return (int)($mac_date - 2082844800); + } + + + + public static function FixedPoint16_16($raw_data) { + + return getid3_lib::BigEndian2Int(substr($raw_data, 0, 2)) + (float)(getid3_lib::BigEndian2Int(substr($raw_data, 2, 2)) / 65536); // pow(2, 16) = 65536 + } + + + + function BigEndian2Float($byte_word) { + + // ANSI/IEEE Standard 754-1985, Standard for Binary Floating Point Arithmetic + // http://www.psc.edu/general/software/packages/ieee/ieee.html + // http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee.html + + $bit_word = getid3_lib::BigEndian2Bin($byte_word); + $sign_bit = $bit_word{0}; + + switch (strlen($byte_word) * 8) { + case 32: + $exponent_bits = 8; + $fraction_bits = 23; + break; + + case 64: + $exponent_bits = 11; + $fraction_bits = 52; + break; + + case 80: + // 80-bit Apple SANE format + // http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/ + $exponent_string = substr($bit_word, 1, 15); + $is_normalized = intval($bit_word{16}); + $fraction_string = substr($bit_word, 17, 63); + $exponent = pow(2, bindec($exponent_string) - 16383); + $fraction = $is_normalized + bindec($fraction_string) / bindec('1'.str_repeat('0', strlen($fraction_string))); + $float_value = $exponent * $fraction; + if ($sign_bit == '1') { + $float_value *= -1; + } + return $float_value; + break; + + default: + return false; + break; + } + $exponent_string = substr($bit_word, 1, $exponent_bits); + $fraction_string = substr($bit_word, $exponent_bits + 1, $fraction_bits); + $exponent = bindec($exponent_string); + $fraction = bindec($fraction_string); + + if (($exponent == (pow(2, $exponent_bits) - 1)) && ($fraction != 0)) { + // Not a Number + $float_value = false; + } elseif (($exponent == (pow(2, $exponent_bits) - 1)) && ($fraction == 0)) { + if ($sign_bit == '1') { + $float_value = '-infinity'; + } else { + $float_value = '+infinity'; + } + } elseif (($exponent == 0) && ($fraction == 0)) { + if ($sign_bit == '1') { + $float_value = -0; + } else { + $float_value = 0; + } + $float_value = ($sign_bit ? 0 : -0); + } elseif (($exponent == 0) && ($fraction != 0)) { + // These are 'unnormalized' values + $float_value = pow(2, (-1 * (pow(2, $exponent_bits - 1) - 2))) * bindec($fraction_string) / bindec('1'.str_repeat('0', strlen($fraction_string))); + if ($sign_bit == '1') { + $float_value *= -1; + } + } elseif ($exponent != 0) { + $float_value = pow(2, ($exponent - (pow(2, $exponent_bits - 1) - 1))) * (1 + bindec($fraction_string) / bindec('1'.str_repeat('0', strlen($fraction_string)))); + if ($sign_bit == '1') { + $float_value *= -1; + } + } + return (float) $float_value; + } +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio-video.swf.php b/modules/getid3/module.audio-video.swf.php new file mode 100644 index 00000000..ac2ca6bc --- /dev/null +++ b/modules/getid3/module.audio-video.swf.php @@ -0,0 +1,154 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio-video.swf.php | +// | module for analyzing Macromedia Shockwave Flash files. | +// | dependencies: zlib support in PHP | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio-video.swf.php,v 1.2 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_swf extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'swf'; + $getid3->info['video']['dataformat'] = 'swf'; + + // http://www.openswf.org/spec/SWFfileformat.html + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + $swf_file_data = fread($getid3->fp, $getid3->info['avdataend'] - $getid3->info['avdataoffset']); // 8 + 2 + 2 + max(9) bytes NOT including Frame_Size RECT data + + $getid3->info['swf']['header']['signature'] = substr($swf_file_data, 0, 3); + switch ($getid3->info['swf']['header']['signature']) { + + case 'FWS': + $getid3->info['swf']['header']['compressed'] = false; + break; + + case 'CWS': + $getid3->info['swf']['header']['compressed'] = true; + break; + + default: + throw new getid3_exception('Expecting "FWS" or "CWS" at offset '.$getid3->info['avdataoffset'].', found "'.$getid3->info['swf']['header']['signature'].'"'); + } + $getid3->info['swf']['header']['version'] = getid3_lib::LittleEndian2Int($swf_file_data{3}); + $getid3->info['swf']['header']['length'] = getid3_lib::LittleEndian2Int(substr($swf_file_data, 4, 4)); + + if (!function_exists('gzuncompress')) { + throw new getid3_exception('getid3_swf requires --zlib support in PHP.'); + } + + if ($getid3->info['swf']['header']['compressed']) { + + if ($uncompressed_file_data = @gzuncompress(substr($swf_file_data, 8))) { + $swf_file_data = substr($swf_file_data, 0, 8).$uncompressed_file_data; + + } else { + throw new getid3_exception('Error decompressing compressed SWF data'); + } + + } + + $frame_size_bits_per_value = (ord(substr($swf_file_data, 8, 1)) & 0xF8) >> 3; + $frame_size_data_length = ceil((5 + (4 * $frame_size_bits_per_value)) / 8); + $frame_size_data_string = str_pad(decbin(ord($swf_file_data[8]) & 0x07), 3, '0', STR_PAD_LEFT); + + for ($i = 1; $i < $frame_size_data_length; $i++) { + $frame_size_data_string .= str_pad(decbin(ord(substr($swf_file_data, 8 + $i, 1))), 8, '0', STR_PAD_LEFT); + } + + list($x1, $x2, $y1, $y2) = explode("\n", wordwrap($frame_size_data_string, $frame_size_bits_per_value, "\n", 1)); + $getid3->info['swf']['header']['frame_width'] = bindec($x2); + $getid3->info['swf']['header']['frame_height'] = bindec($y2); + + // http://www-lehre.informatik.uni-osnabrueck.de/~fbstark/diplom/docs/swf/Flash_Uncovered.htm + // Next in the header is the frame rate, which is kind of weird. + // It is supposed to be stored as a 16bit integer, but the first byte + // (or last depending on how you look at it) is completely ignored. + // Example: 0x000C -> 0x0C -> 12 So the frame rate is 12 fps. + + // Byte at (8 + $frame_size_data_length) is always zero and ignored + $getid3->info['swf']['header']['frame_rate'] = getid3_lib::LittleEndian2Int($swf_file_data[9 + $frame_size_data_length]); + $getid3->info['swf']['header']['frame_count'] = getid3_lib::LittleEndian2Int(substr($swf_file_data, 10 + $frame_size_data_length, 2)); + + $getid3->info['video']['frame_rate'] = $getid3->info['swf']['header']['frame_rate']; + $getid3->info['video']['resolution_x'] = intval(round($getid3->info['swf']['header']['frame_width'] / 20)); + $getid3->info['video']['resolution_y'] = intval(round($getid3->info['swf']['header']['frame_height'] / 20)); + $getid3->info['video']['pixel_aspect_ratio'] = (float)1; + + if (($getid3->info['swf']['header']['frame_count'] > 0) && ($getid3->info['swf']['header']['frame_rate'] > 0)) { + $getid3->info['playtime_seconds'] = $getid3->info['swf']['header']['frame_count'] / $getid3->info['swf']['header']['frame_rate']; + } + + + // SWF tags + + $current_offset = 12 + $frame_size_data_length; + $swf_data_length = strlen($swf_file_data); + + while ($current_offset < $swf_data_length) { + + $tag_ID_tag_length = getid3_lib::LittleEndian2Int(substr($swf_file_data, $current_offset, 2)); + $tag_ID = ($tag_ID_tag_length & 0xFFFC) >> 6; + $tag_length = ($tag_ID_tag_length & 0x003F); + $current_offset += 2; + if ($tag_length == 0x3F) { + $tag_length = getid3_lib::LittleEndian2Int(substr($swf_file_data, $current_offset, 4)); + $current_offset += 4; + } + + unset($tag_data); + $tag_data['offset'] = $current_offset; + $tag_data['size'] = $tag_length; + $tag_data['id'] = $tag_ID; + $tag_data['data'] = substr($swf_file_data, $current_offset, $tag_length); + switch ($tag_ID) { + + case 0: // end of movie + break 2; + + case 9: // Set background color + $getid3->info['swf']['bgcolor'] = strtoupper(str_pad(dechex(getid3_lib::BigEndian2Int($tag_data['data'])), 6, '0', STR_PAD_LEFT)); + break; + + default: + /* + if ($ReturnAllTagData) { + $getid3->info['swf']['tags'][] = $tag_data; + } + */ + break; + } + + $current_offset += $tag_length; + } + + return true; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.aac_adif.php b/modules/getid3/module.audio.aac_adif.php new file mode 100644 index 00000000..0b00bb96 --- /dev/null +++ b/modules/getid3/module.audio.aac_adif.php @@ -0,0 +1,311 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.aac_adif.php | +// | Module for analyzing AAC files with ADIF header. | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.aac_adif.php,v 1.3 2006/11/02 10:48:00 ah Exp $ + + + +class getid3_aac_adif extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + // http://faac.sourceforge.net/wiki/index.php?page=ADIF + // http://libmpeg.org/mpeg4/doc/w2203tfs.pdf + // adif_header() { + // adif_id 32 + // copyright_id_present 1 + // if( copyright_id_present ) + // copyright_id 72 + // original_copy 1 + // home 1 + // bitstream_type 1 + // bitrate 23 + // num_program_config_elements 4 + // for (i = 0; i < num_program_config_elements + 1; i++ ) { + // if( bitstream_type == '0' ) + // adif_buffer_fullness 20 + // program_config_element() + // } + // } + + + $getid3->info['fileformat'] = 'aac'; + $getid3->info['audio']['dataformat'] = 'aac'; + $getid3->info['audio']['lossless'] = false; + + $getid3->info['aac']['header'] = array () ; + $info_aac = &$getid3->info['aac']; + $info_aac_header = & $info_aac['header']; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $aac_header_bitstream = getid3_lib::BigEndian2Bin(fread($getid3->fp, 1024)); + + $info_aac['header_type'] = 'ADIF'; + $info_aac_header['mpeg_version'] = 4; + $bit_offset = 32; + + $info_aac_header['copyright'] = $aac_header_bitstream{$bit_offset++} == '1'; + if ($info_aac_header['copyright']) { + $info_aac_header['copyright_id'] = getid3_aac_adif::Bin2String(substr($aac_header_bitstream, $bit_offset, 72)); + $bit_offset += 72; + } + + $info_aac_header['original_copy'] = $aac_header_bitstream{$bit_offset++} == '1'; + $info_aac_header['home'] = $aac_header_bitstream{$bit_offset++} == '1'; + $info_aac_header['is_vbr'] = $aac_header_bitstream{$bit_offset++} == '1'; + + if ($info_aac_header['is_vbr']) { + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + $info_aac_header['bitrate_max'] = bindec(substr($aac_header_bitstream, $bit_offset, 23)); + $bit_offset += 23; + } + else { + $getid3->info['audio']['bitrate_mode'] = 'cbr'; + $info_aac_header['bitrate'] = bindec(substr($aac_header_bitstream, $bit_offset, 23)); + $bit_offset += 23; + $getid3->info['audio']['bitrate'] = $info_aac_header['bitrate']; + } + + $info_aac_header['num_program_configs'] = 1 + bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + + for ($i = 0; $i < $info_aac_header['num_program_configs']; $i++) { + + // http://www.audiocoding.com/wiki/index.php?page=program_config_element + + // buffer_fullness 20 + + // element_instance_tag 4 + // object_type 2 + // sampling_frequency_index 4 + // num_front_channel_elements 4 + // num_side_channel_elements 4 + // num_back_channel_elements 4 + // num_lfe_channel_elements 2 + // num_assoc_data_elements 3 + // num_valid_cc_elements 4 + // mono_mixdown_present 1 + // mono_mixdown_element_number 4 if mono_mixdown_present == 1 + // stereo_mixdown_present 1 + // stereo_mixdown_element_number 4 if stereo_mixdown_present == 1 + // matrix_mixdown_idx_present 1 + // matrix_mixdown_idx 2 if matrix_mixdown_idx_present == 1 + // pseudo_surround_enable 1 if matrix_mixdown_idx_present == 1 + // for (i = 0; i < num_front_channel_elements; i++) { + // front_element_is_cpe[i] 1 + // front_element_tag_select[i] 4 + // } + // for (i = 0; i < num_side_channel_elements; i++) { + // side_element_is_cpe[i] 1 + // side_element_tag_select[i] 4 + // } + // for (i = 0; i < num_back_channel_elements; i++) { + // back_element_is_cpe[i] 1 + // back_element_tag_select[i] 4 + // } + // for (i = 0; i < num_lfe_channel_elements; i++) { + // lfe_element_tag_select[i] 4 + // } + // for (i = 0; i < num_assoc_data_elements; i++) { + // assoc_data_element_tag_select[i] 4 + // } + // for (i = 0; i < num_valid_cc_elements; i++) { + // cc_element_is_ind_sw[i] 1 + // valid_cc_element_tag_select[i] 4 + // } + // byte_alignment() VAR + // comment_field_bytes 8 + // for (i = 0; i < comment_field_bytes; i++) { + // comment_field_data[i] 8 + // } + + $info_aac['program_configs'][$i] = array (); + $info_aac_program_configs_i = &$info_aac['program_configs'][$i]; + + if (!$info_aac_header['is_vbr']) { + $info_aac_program_configs_i['buffer_fullness'] = bindec(substr($aac_header_bitstream, $bit_offset, 20)); + $bit_offset += 20; + } + + $info_aac_program_configs_i['element_instance_tag'] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $info_aac_program_configs_i['object_type'] = bindec(substr($aac_header_bitstream, $bit_offset + 4, 2)); + $info_aac_program_configs_i['sampling_frequency_index'] = bindec(substr($aac_header_bitstream, $bit_offset + 6, 4)); + $info_aac_program_configs_i['num_front_channel_elements'] = bindec(substr($aac_header_bitstream, $bit_offset + 10, 4)); + $info_aac_program_configs_i['num_side_channel_elements'] = bindec(substr($aac_header_bitstream, $bit_offset + 14, 4)); + $info_aac_program_configs_i['num_back_channel_elements'] = bindec(substr($aac_header_bitstream, $bit_offset + 18, 4)); + $info_aac_program_configs_i['num_lfe_channel_elements'] = bindec(substr($aac_header_bitstream, $bit_offset + 22, 2)); + $info_aac_program_configs_i['num_assoc_data_elements'] = bindec(substr($aac_header_bitstream, $bit_offset + 24, 3)); + $info_aac_program_configs_i['num_valid_cc_elements'] = bindec(substr($aac_header_bitstream, $bit_offset + 27, 4)); + $bit_offset += 31; + + $info_aac_program_configs_i['mono_mixdown_present'] = $aac_header_bitstream{$bit_offset++} == 1; + if ($info_aac_program_configs_i['mono_mixdown_present']) { + $info_aac_program_configs_i['mono_mixdown_element_number'] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + + $info_aac_program_configs_i['stereo_mixdown_present'] = $aac_header_bitstream{$bit_offset++} == 1; + if ($info_aac_program_configs_i['stereo_mixdown_present']) { + $info_aac_program_configs_i['stereo_mixdown_element_number'] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + + $info_aac_program_configs_i['matrix_mixdown_idx_present'] = $aac_header_bitstream{$bit_offset++} == 1; + if ($info_aac_program_configs_i['matrix_mixdown_idx_present']) { + $info_aac_program_configs_i['matrix_mixdown_idx'] = bindec(substr($aac_header_bitstream, $bit_offset, 2)); + $bit_offset += 2; + $info_aac_program_configs_i['pseudo_surround_enable'] = $aac_header_bitstream{$bit_offset++} == 1; + } + + for ($j = 0; $j < $info_aac_program_configs_i['num_front_channel_elements']; $j++) { + $info_aac_program_configs_i['front_element_is_cpe'][$j] = $aac_header_bitstream{$bit_offset++} == 1; + $info_aac_program_configs_i['front_element_tag_select'][$j] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + for ($j = 0; $j < $info_aac_program_configs_i['num_side_channel_elements']; $j++) { + $info_aac_program_configs_i['side_element_is_cpe'][$j] = $aac_header_bitstream{$bit_offset++} == 1; + $info_aac_program_configs_i['side_element_tag_select'][$j] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + for ($j = 0; $j < $info_aac_program_configs_i['num_back_channel_elements']; $j++) { + $info_aac_program_configs_i['back_element_is_cpe'][$j] = $aac_header_bitstream{$bit_offset++} == 1; + $info_aac_program_configs_i['back_element_tag_select'][$j] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + for ($j = 0; $j < $info_aac_program_configs_i['num_lfe_channel_elements']; $j++) { + $info_aac_program_configs_i['lfe_element_tag_select'][$j] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + for ($j = 0; $j < $info_aac_program_configs_i['num_assoc_data_elements']; $j++) { + $info_aac_program_configs_i['assoc_data_element_tag_select'][$j] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + for ($j = 0; $j < $info_aac_program_configs_i['num_valid_cc_elements']; $j++) { + $info_aac_program_configs_i['cc_element_is_ind_sw'][$j] = $aac_header_bitstream{$bit_offset++} == 1; + $info_aac_program_configs_i['valid_cc_element_tag_select'][$j] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + } + + $bit_offset = ceil($bit_offset / 8) * 8; + + $info_aac_program_configs_i['comment_field_bytes'] = bindec(substr($aac_header_bitstream, $bit_offset, 8)); + $bit_offset += 8; + + $info_aac_program_configs_i['comment_field'] = getid3_aac_adif::Bin2String(substr($aac_header_bitstream, $bit_offset, 8 * $info_aac_program_configs_i['comment_field_bytes'])); + $bit_offset += 8 * $info_aac_program_configs_i['comment_field_bytes']; + + $info_aac_header['profile_text'] = getid3_aac_adif::AACprofileLookup($info_aac_program_configs_i['object_type'], $info_aac_header['mpeg_version']); + $info_aac_program_configs_i['sampling_frequency'] = $getid3->info['audio']['sample_rate'] = getid3_aac_adif::AACsampleRateLookup($info_aac_program_configs_i['sampling_frequency_index']); + $getid3->info['audio']['channels'] = getid3_aac_adif::AACchannelCountCalculate($info_aac_program_configs_i); + + if ($info_aac_program_configs_i['comment_field']) { + $info_aac['comments'][] = $info_aac_program_configs_i['comment_field']; + } + } + + $getid3->info['playtime_seconds'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['audio']['bitrate']; + $getid3->info['audio']['encoder_options'] = $info_aac['header_type'].' '.$info_aac_header['profile_text']; + + return true; + } + + + + public static function Bin2String($bin_string) { + // return 'hi' for input of '0110100001101001' + $string = ''; + $bin_string_reversed = strrev($bin_string); + for ($i = 0; $i < strlen($bin_string_reversed); $i += 8) { + $string = chr(bindec(strrev(substr($bin_string_reversed, $i, 8)))).$string; + } + return $string; + } + + + + public static function AACsampleRateLookup($samplerate_id) { + + static $lookup = array ( + 0 => 96000, + 1 => 88200, + 2 => 64000, + 3 => 48000, + 4 => 44100, + 5 => 32000, + 6 => 24000, + 7 => 22050, + 8 => 16000, + 9 => 12000, + 10 => 11025, + 11 => 8000, + 12 => 0, + 13 => 0, + 14 => 0, + 15 => 0 + ); + return (isset($lookup[$samplerate_id]) ? $lookup[$samplerate_id] : 'invalid'); + } + + + + public static function AACprofileLookup($profile_id, $mpeg_version) { + + static $lookup = array ( + 2 => array ( + 0 => 'Main profile', + 1 => 'Low Complexity profile (LC)', + 2 => 'Scalable Sample Rate profile (SSR)', + 3 => '(reserved)' + ), + 4 => array ( + 0 => 'AAC_MAIN', + 1 => 'AAC_LC', + 2 => 'AAC_SSR', + 3 => 'AAC_LTP' + ) + ); + return (isset($lookup[$mpeg_version][$profile_id]) ? $lookup[$mpeg_version][$profile_id] : 'invalid'); + } + + + + public static function AACchannelCountCalculate($program_configs) { + + $channels = 0; + + foreach (array ('front', 'side', 'back') as $placement) { + for ($i = 0; $i < $program_configs['num_'.$placement.'_channel_elements']; $i++) { + + // Each element is channel pair (CPE = Channel Pair Element) + $channels += 1 + ($program_configs[$placement.'_element_is_cpe'][$i] ? 1 : 0); + } + } + + return $channels + $program_configs['num_lfe_channel_elements']; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.aac_adts.php b/modules/getid3/module.audio.aac_adts.php new file mode 100644 index 00000000..aa7f8f73 --- /dev/null +++ b/modules/getid3/module.audio.aac_adts.php @@ -0,0 +1,282 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.aac_adts.php | +// | Module for analyzing AAC files with ADTS header. | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.aac_adts.php,v 1.4 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_aac_adts extends getid3_handler +{ + + public $option_max_frames_to_scan = 1000000; + public $option_return_extended_info = false; + + + private $decbin_cache; + private $bitrate_cache; + + + + public function __construct(getID3 $getid3) { + + parent::__construct($getid3); + + // Populate bindec_cache + for ($i = 0; $i < 256; $i++) { + $this->decbin_cache[chr($i)] = str_pad(decbin($i), 8, '0', STR_PAD_LEFT); + } + + // Init cache + $this->bitrate_cache = array (); + + // Fast scanning? + if (!$getid3->option_accurate_results) { + $this->option_max_frames_to_scan = 200; + $getid3->warning('option_accurate_results set to false - bitrate and playing time are not accurate.'); + } + } + + + + public function Analyze() { + + $getid3 = $this->getid3; + + // based loosely on code from AACfile by Jurgen Faul + // http://jfaul.de/atl or http://j-faul.virtualave.net/atl/atl.html + + + // http://faac.sourceforge.net/wiki/index.php?page=ADTS + + // * ADTS Fixed Header: these don't change from frame to frame + // syncword 12 always: '111111111111' + // ID 1 0: MPEG-4, 1: MPEG-2 + // layer 2 always: '00' + // protection_absent 1 + // profile 2 + // sampling_frequency_index 4 + // private_bit 1 + // channel_configuration 3 + // original/copy 1 + // home 1 + // emphasis 2 only if ID == 0 (ie MPEG-4) + + // * ADTS Variable Header: these can change from frame to frame + // copyright_identification_bit 1 + // copyright_identification_start 1 + // aac_frame_length 13 length of the frame including header (in bytes) + // adts_buffer_fullness 11 0x7FF indicates VBR + // no_raw_data_blocks_in_frame 2 + + // * ADTS Error check + // crc_check 16 only if protection_absent == 0 + + $getid3->info['aac']['header'] = array () ; + $info_aac = &$getid3->info['aac']; + $info_aac_header = & $info_aac['header']; + + $byte_offset = $frame_number = 0; + + while (true) { + + // Breaks out when end-of-file encountered, or invalid data found, + // or MaxFramesToScan frames have been scanned + + fseek($getid3->fp, $byte_offset, SEEK_SET); + + // First get substring + $sub_string = fread($getid3->fp, 10); + $sub_string_length = strlen($sub_string); + if ($sub_string_length != 10) { + throw new getid3_exception('Failed to read 10 bytes at offset '.(ftell($getid3->fp) - $sub_string_length).' (only read '.$sub_string_length.' bytes)'); + } + + // Initialise $aac_header_bitstream + $aac_header_bitstream = ''; + + // Loop thru substring chars + for ($i = 0; $i < 10; $i++) { + $aac_header_bitstream .= $this->decbin_cache[$sub_string[$i]]; + } + + $sync_test = bindec(substr($aac_header_bitstream, 0, 12)); + $bit_offset = 12; + + if ($sync_test != 0x0FFF) { + throw new getid3_exception('Synch pattern (0x0FFF) not found at offset '.(ftell($getid3->fp) - 10).' (found 0x0'.strtoupper(dechex($sync_test)).' instead)'); + } + + // Only gather info once - this takes time to do 1000 times! + if ($frame_number > 0) { + + // MPEG-4: 20, // MPEG-2: 18 + $bit_offset += $aac_header_bitstream[$bit_offset] ? 18 : 20; + } + + // Gather info for first frame only - this takes time to do 1000 times! + else { + + $info_aac['header_type'] = 'ADTS'; + $info_aac_header['synch'] = $sync_test; + $getid3->info['fileformat'] = 'aac'; + $getid3->info['audio']['dataformat'] = 'aac'; + + $info_aac_header['mpeg_version'] = $aac_header_bitstream{$bit_offset++} == '0' ? 4 : 2; + $info_aac_header['layer'] = bindec(substr($aac_header_bitstream, $bit_offset, 2)); + $bit_offset += 2; + + if ($info_aac_header['layer'] != 0) { + throw new getid3_exception('Layer error - expected 0x00, found 0x'.dechex($info_aac_header['layer']).' instead'); + } + + $info_aac_header['crc_present'] = $aac_header_bitstream{$bit_offset++} == '0' ? true : false; + + $info_aac_header['profile_id'] = bindec(substr($aac_header_bitstream, $bit_offset, 2)); + $bit_offset += 2; + + $info_aac_header['profile_text'] = getid3_aac_adts::AACprofileLookup($info_aac_header['profile_id'], $info_aac_header['mpeg_version']); + + $info_aac_header['sample_frequency_index'] = bindec(substr($aac_header_bitstream, $bit_offset, 4)); + $bit_offset += 4; + + $info_aac_header['sample_frequency'] = getid3_aac_adts::AACsampleRateLookup($info_aac_header['sample_frequency_index']); + + $getid3->info['audio']['sample_rate'] = $info_aac_header['sample_frequency']; + + $info_aac_header['private'] = $aac_header_bitstream{$bit_offset++} == 1; + + $info_aac_header['channel_configuration'] = $getid3->info['audio']['channels'] = bindec(substr($aac_header_bitstream, $bit_offset, 3)); + $bit_offset += 3; + + $info_aac_header['original'] = $aac_header_bitstream{$bit_offset++} == 1; + $info_aac_header['home'] = $aac_header_bitstream{$bit_offset++} == 1; + + if ($info_aac_header['mpeg_version'] == 4) { + $info_aac_header['emphasis'] = bindec(substr($aac_header_bitstream, $bit_offset, 2)); + $bit_offset += 2; + } + + if ($this->option_return_extended_info) { + + $info_aac[$frame_number]['copyright_id_bit'] = $aac_header_bitstream{$bit_offset++} == 1; + $info_aac[$frame_number]['copyright_id_start'] = $aac_header_bitstream{$bit_offset++} == 1; + + } else { + $bit_offset += 2; + } + } + + $frame_length = bindec(substr($aac_header_bitstream, $bit_offset, 13)); + + if (!isset($this->bitrate_cache[$frame_length])) { + $this->bitrate_cache[$frame_length] = ($info_aac_header['sample_frequency'] / 1024) * $frame_length * 8; + } + @$info_aac['bitrate_distribution'][$this->bitrate_cache[$frame_length]]++; + + $info_aac[$frame_number]['aac_frame_length'] = $frame_length; + $bit_offset += 13; + + $info_aac[$frame_number]['adts_buffer_fullness'] = bindec(substr($aac_header_bitstream, $bit_offset, 11)); + $bit_offset += 11; + + $getid3->info['audio']['bitrate_mode'] = ($info_aac[$frame_number]['adts_buffer_fullness'] == 0x07FF) ? 'vbr' : 'cbr'; + + $info_aac[$frame_number]['num_raw_data_blocks'] = bindec(substr($aac_header_bitstream, $bit_offset, 2)); + $bit_offset += 2; + + if ($info_aac_header['crc_present']) { + $bit_offset += 16; + } + + if (!$this->option_return_extended_info) { + unset($info_aac[$frame_number]); + } + + $byte_offset += $frame_length; + if ((++$frame_number < $this->option_max_frames_to_scan) && (($byte_offset + 10) < $getid3->info['avdataend'])) { + + // keep scanning + + } else { + + $info_aac['frames'] = $frame_number; + $getid3->info['playtime_seconds'] = ($getid3->info['avdataend'] / $byte_offset) * (($frame_number * 1024) / $info_aac_header['sample_frequency']); // (1 / % of file scanned) * (samples / (samples/sec)) = seconds + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + ksort($info_aac['bitrate_distribution']); + + $getid3->info['audio']['encoder_options'] = $info_aac['header_type'].' '.$info_aac_header['profile_text']; + + return true; + } + } + } + + + + public static function AACsampleRateLookup($samplerate_id) { + + static $lookup = array ( + 0 => 96000, + 1 => 88200, + 2 => 64000, + 3 => 48000, + 4 => 44100, + 5 => 32000, + 6 => 24000, + 7 => 22050, + 8 => 16000, + 9 => 12000, + 10 => 11025, + 11 => 8000, + 12 => 0, + 13 => 0, + 14 => 0, + 15 => 0 + ); + return (isset($lookup[$samplerate_id]) ? $lookup[$samplerate_id] : 'invalid'); + } + + + + public static function AACprofileLookup($profile_id, $mpeg_version) { + + static $lookup = array ( + 2 => array ( + 0 => 'Main profile', + 1 => 'Low Complexity profile (LC)', + 2 => 'Scalable Sample Rate profile (SSR)', + 3 => '(reserved)' + ), + 4 => array ( + 0 => 'AAC_MAIN', + 1 => 'AAC_LC', + 2 => 'AAC_SSR', + 3 => 'AAC_LTP' + ) + ); + return (isset($lookup[$mpeg_version][$profile_id]) ? $lookup[$mpeg_version][$profile_id] : 'invalid'); + } + + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.ac3.php b/modules/getid3/module.audio.ac3.php new file mode 100644 index 00000000..7bb8f9f8 --- /dev/null +++ b/modules/getid3/module.audio.ac3.php @@ -0,0 +1,500 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.ac3.php | +// | Module for analyzing AC-3 (aka Dolby Digital) audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.ac3.php,v 1.3 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_ac3 extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + // http://www.atsc.org/standards/a_52a.pdf + + $getid3->info['fileformat'] = 'ac3'; + $getid3->info['audio']['dataformat'] = 'ac3'; + $getid3->info['audio']['bitrate_mode'] = 'cbr'; + $getid3->info['audio']['lossless'] = false; + + $getid3->info['ac3']['raw']['bsi'] = array (); + $info_ac3 = &$getid3->info['ac3']; + $info_ac3_raw = &$info_ac3['raw']; + $info_ac3_raw_bsi = &$info_ac3_raw['bsi']; + + + // An AC-3 serial coded audio bit stream is made up of a sequence of synchronization frames + // Each synchronization frame contains 6 coded audio blocks (AB), each of which represent 256 + // new audio samples per channel. A synchronization information (SI) header at the beginning + // of each frame contains information needed to acquire and maintain synchronization. A + // bit stream information (BSI) header follows SI, and contains parameters describing the coded + // audio service. The coded audio blocks may be followed by an auxiliary data (Aux) field. At the + // end of each frame is an error check field that includes a CRC word for error detection. An + // additional CRC word is located in the SI header, the use of which, by a decoder, is optional. + // + // syncinfo() | bsi() | AB0 | AB1 | AB2 | AB3 | AB4 | AB5 | Aux | CRC + + $this->fseek($getid3->info['avdataoffset'], SEEK_SET); + $ac3_header['syncinfo'] = $this->fread(5); + $info_ac3_raw['synchinfo']['synchword'] = substr($ac3_header['syncinfo'], 0, 2); + + if ($info_ac3_raw['synchinfo']['synchword'] != "\x0B\x77") { + throw new getid3_exception('Expecting "\x0B\x77" at offset '.$getid3->info['avdataoffset'].', found \x'.strtoupper(dechex($ac3_header['syncinfo']{0})).'\x'.strtoupper(dechex($ac3_header['syncinfo']{1})).' instead'); + } + + + // syncinfo() { + // syncword 16 + // crc1 16 + // fscod 2 + // frmsizecod 6 + // } /* end of syncinfo */ + + $info_ac3_raw['synchinfo']['crc1'] = getid3_lib::LittleEndian2Int(substr($ac3_header['syncinfo'], 2, 2)); + $ac3_synchinfo_fscod_frmsizecod = getid3_lib::LittleEndian2Int(substr($ac3_header['syncinfo'], 4, 1)); + $info_ac3_raw['synchinfo']['fscod'] = ($ac3_synchinfo_fscod_frmsizecod & 0xC0) >> 6; + $info_ac3_raw['synchinfo']['frmsizecod'] = ($ac3_synchinfo_fscod_frmsizecod & 0x3F); + + $info_ac3['sample_rate'] = getid3_ac3::AC3sampleRateCodeLookup($info_ac3_raw['synchinfo']['fscod']); + if ($info_ac3_raw['synchinfo']['fscod'] <= 3) { + $getid3->info['audio']['sample_rate'] = $info_ac3['sample_rate']; + } + + $info_ac3['frame_length'] = getid3_ac3::AC3frameSizeLookup($info_ac3_raw['synchinfo']['frmsizecod'], $info_ac3_raw['synchinfo']['fscod']); + $info_ac3['bitrate'] = getid3_ac3::AC3bitrateLookup($info_ac3_raw['synchinfo']['frmsizecod']); + $getid3->info['audio']['bitrate'] = $info_ac3['bitrate']; + + $ac3_header['bsi'] = getid3_lib::BigEndian2Bin($this->fread(15)); + + $info_ac3_raw_bsi['bsid'] = bindec(substr($ac3_header['bsi'], 0, 5)); + if ($info_ac3_raw_bsi['bsid'] > 8) { + // Decoders which can decode version 8 will thus be able to decode version numbers less than 8. + // If this standard is extended by the addition of additional elements or features, a value of bsid greater than 8 will be used. + // Decoders built to this version of the standard will not be able to decode versions with bsid greater than 8. + throw new getid3_exception('Bit stream identification is version '.$info_ac3_raw_bsi['bsid'].', but getID3() only understands up to version 8'); + } + + $info_ac3_raw_bsi['bsmod'] = bindec(substr($ac3_header['bsi'], 5, 3)); + $info_ac3_raw_bsi['acmod'] = bindec(substr($ac3_header['bsi'], 8, 3)); + + $info_ac3['service_type'] = getid3_ac3::AC3serviceTypeLookup($info_ac3_raw_bsi['bsmod'], $info_ac3_raw_bsi['acmod']); + $ac3_coding_mode = getid3_ac3::AC3audioCodingModeLookup($info_ac3_raw_bsi['acmod']); + foreach($ac3_coding_mode as $key => $value) { + $info_ac3[$key] = $value; + } + switch ($info_ac3_raw_bsi['acmod']) { + case 0: + case 1: + $getid3->info['audio']['channelmode'] = 'mono'; + break; + case 3: + case 4: + $getid3->info['audio']['channelmode'] = 'stereo'; + break; + default: + $getid3->info['audio']['channelmode'] = 'surround'; + break; + } + $getid3->info['audio']['channels'] = $info_ac3['num_channels']; + + $offset = 11; + + if ($info_ac3_raw_bsi['acmod'] & 0x01) { + // If the lsb of acmod is a 1, center channel is in use and cmixlev follows in the bit stream. + $info_ac3_raw_bsi['cmixlev'] = bindec(substr($ac3_header['bsi'], $offset, 2)); + $info_ac3['center_mix_level'] = getid3_ac3::AC3centerMixLevelLookup($info_ac3_raw_bsi['cmixlev']); + $offset += 2; + } + + if ($info_ac3_raw_bsi['acmod'] & 0x04) { + // If the msb of acmod is a 1, surround channels are in use and surmixlev follows in the bit stream. + $info_ac3_raw_bsi['surmixlev'] = bindec(substr($ac3_header['bsi'], $offset, 2)); + $info_ac3['surround_mix_level'] = getid3_ac3::AC3surroundMixLevelLookup($info_ac3_raw_bsi['surmixlev']); + $offset += 2; + } + + if ($info_ac3_raw_bsi['acmod'] == 0x02) { + // When operating in the two channel mode, this 2-bit code indicates whether or not the program has been encoded in Dolby Surround. + $info_ac3_raw_bsi['dsurmod'] = bindec(substr($ac3_header['bsi'], $offset, 2)); + $info_ac3['dolby_surround_mode'] = getid3_ac3::AC3dolbySurroundModeLookup($info_ac3_raw_bsi['dsurmod']); + $offset += 2; + } + + $info_ac3_raw_bsi['lfeon'] = $ac3_header['bsi']{$offset++} == '1'; + $info_ac3['lfe_enabled'] = $info_ac3_raw_bsi['lfeon']; + if ($info_ac3_raw_bsi['lfeon']) { + $getid3->info['audio']['channels'] .= '.1'; + } + + $info_ac3['channels_enabled'] = getid3_ac3::AC3channelsEnabledLookup($info_ac3_raw_bsi['acmod'], $info_ac3_raw_bsi['lfeon']); + + // This indicates how far the average dialogue level is below digital 100 percent. Valid values are 1–31. + // The value of 0 is reserved. The values of 1 to 31 are interpreted as -1 dB to -31 dB with respect to digital 100 percent. + $info_ac3_raw_bsi['dialnorm'] = bindec(substr($ac3_header['bsi'], $offset, 5)); + $offset += 5; + $info_ac3['dialogue_normalization'] = '-'.$info_ac3_raw_bsi['dialnorm'].'dB'; + + $info_ac3_raw_bsi['compre_flag'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['compre_flag']) { + $info_ac3_raw_bsi['compr'] = bindec(substr($ac3_header['bsi'], $offset, 8)); + $offset += 8; + + $info_ac3['heavy_compression'] = getid3_ac3::AC3heavyCompression($info_ac3_raw_bsi['compr']); + } + + $info_ac3_raw_bsi['langcode_flag'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['langcode_flag']) { + $info_ac3_raw_bsi['langcod'] = bindec(substr($ac3_header['bsi'], $offset, 8)); + $offset += 8; + } + + $info_ac3_raw_bsi['audprodie'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['audprodie']) { + $info_ac3_raw_bsi['mixlevel'] = bindec(substr($ac3_header['bsi'], $offset, 5)); + $offset += 5; + + $info_ac3_raw_bsi['roomtyp'] = bindec(substr($ac3_header['bsi'], $offset, 2)); + $offset += 2; + + $info_ac3['mixing_level'] = (80 + $info_ac3_raw_bsi['mixlevel']).'dB'; + $info_ac3['room_type'] = getid3_ac3::AC3roomTypeLookup($info_ac3_raw_bsi['roomtyp']); + } + + if ($info_ac3_raw_bsi['acmod'] == 0x00) { + // If acmod is 0, then two completely independent program channels (dual mono) + // are encoded into the bit stream, and are referenced as Ch1, Ch2. In this case, + // a number of additional items are present in BSI or audblk to fully describe Ch2. + + + // This indicates how far the average dialogue level is below digital 100 percent. Valid values are 1–31. + // The value of 0 is reserved. The values of 1 to 31 are interpreted as -1 dB to -31 dB with respect to digital 100 percent. + $info_ac3_raw_bsi['dialnorm2'] = bindec(substr($ac3_header['bsi'], $offset, 5)); + $offset += 5; + + $info_ac3['dialogue_normalization2'] = '-'.$info_ac3_raw_bsi['dialnorm2'].'dB'; + + $info_ac3_raw_bsi['compre_flag2'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['compre_flag2']) { + $info_ac3_raw_bsi['compr2'] = bindec(substr($ac3_header['bsi'], $offset, 8)); + $offset += 8; + + $info_ac3['heavy_compression2'] = getid3_ac3::AC3heavyCompression($info_ac3_raw_bsi['compr2']); + } + + $info_ac3_raw_bsi['langcode_flag2'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['langcode_flag2']) { + $info_ac3_raw_bsi['langcod2'] = bindec(substr($ac3_header['bsi'], $offset, 8)); + $offset += 8; + } + + $info_ac3_raw_bsi['audprodie2'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['audprodie2']) { + $info_ac3_raw_bsi['mixlevel2'] = bindec(substr($ac3_header['bsi'], $offset, 5)); + $offset += 5; + + $info_ac3_raw_bsi['roomtyp2'] = bindec(substr($ac3_header['bsi'], $offset, 2)); + $offset += 2; + + $info_ac3['mixing_level2'] = (80 + $info_ac3_raw_bsi['mixlevel2']).'dB'; + $info_ac3['room_type2'] = getid3_ac3::AC3roomTypeLookup($info_ac3_raw_bsi['roomtyp2']); + } + + } + + $info_ac3_raw_bsi['copyright'] = $ac3_header['bsi']{$offset++} == '1'; + + $info_ac3_raw_bsi['original'] = $ac3_header['bsi']{$offset++} == '1'; + + $info_ac3_raw_bsi['timecode1_flag'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['timecode1_flag']) { + $info_ac3_raw_bsi['timecode1'] = bindec(substr($ac3_header['bsi'], $offset, 14)); + $offset += 14; + } + + $info_ac3_raw_bsi['timecode2_flag'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['timecode2_flag']) { + $info_ac3_raw_bsi['timecode2'] = bindec(substr($ac3_header['bsi'], $offset, 14)); + $offset += 14; + } + + $info_ac3_raw_bsi['addbsi_flag'] = $ac3_header['bsi']{$offset++} == '1'; + if ($info_ac3_raw_bsi['addbsi_flag']) { + $info_ac3_raw_bsi['addbsi_length'] = bindec(substr($ac3_header['bsi'], $offset, 6)); + $offset += 6; + + $ac3_header['bsi'] .= getid3_lib::BigEndian2Bin($this->fread($info_ac3_raw_bsi['addbsi_length'])); + + $info_ac3_raw_bsi['addbsi_data'] = substr($ac3_header['bsi'], 119, $info_ac3_raw_bsi['addbsi_length'] * 8); + } + + return true; + } + + + + public static function AC3sampleRateCodeLookup($fscod) { + + static $lookup = array ( + 0 => 48000, + 1 => 44100, + 2 => 32000, + 3 => 'reserved' // If the reserved code is indicated, the decoder should not attempt to decode audio and should mute. + ); + return (isset($lookup[$fscod]) ? $lookup[$fscod] : false); + } + + + + public static function AC3serviceTypeLookup($bsmod, $acmod) { + + static $lookup = array ( + 0 => 'main audio service: complete main (CM)', + 1 => 'main audio service: music and effects (ME)', + 2 => 'associated service: visually impaired (VI)', + 3 => 'associated service: hearing impaired (HI)', + 4 => 'associated service: dialogue (D)', + 5 => 'associated service: commentary (C)', + 6 => 'associated service: emergency (E)', + 7 => 'main audio service: karaoke' + ); + + if ($bsmod == 7 && $acmod == 1) { + return 'associated service: voice over (VO)'; + } + + return (isset($lookup[$bsmod]) ? $lookup[$bsmod] : false); + } + + + + public static function AC3audioCodingModeLookup($acmod) { + + // array (channel configuration, # channels (not incl LFE), channel order) + static $lookup = array ( + 0 => array ('channel_config'=>'1+1', 'num_channels'=>2, 'channel_order'=>'Ch1,Ch2'), + 1 => array ('channel_config'=>'1/0', 'num_channels'=>1, 'channel_order'=>'C'), + 2 => array ('channel_config'=>'2/0', 'num_channels'=>2, 'channel_order'=>'L,R'), + 3 => array ('channel_config'=>'3/0', 'num_channels'=>3, 'channel_order'=>'L,C,R'), + 4 => array ('channel_config'=>'2/1', 'num_channels'=>3, 'channel_order'=>'L,R,S'), + 5 => array ('channel_config'=>'3/1', 'num_channels'=>4, 'channel_order'=>'L,C,R,S'), + 6 => array ('channel_config'=>'2/2', 'num_channels'=>4, 'channel_order'=>'L,R,SL,SR'), + 7 => array ('channel_config'=>'3/2', 'num_channels'=>5, 'channel_order'=>'L,C,R,SL,SR') + ); + return (isset($lookup[$acmod]) ? $lookup[$acmod] : false); + } + + + + public static function AC3centerMixLevelLookup($cmixlev) { + + static $lookup; + if (!@$lookup) { + $lookup = array ( + 0 => pow(2, -3.0 / 6), // 0.707 (–3.0 dB) + 1 => pow(2, -4.5 / 6), // 0.595 (–4.5 dB) + 2 => pow(2, -6.0 / 6), // 0.500 (–6.0 dB) + 3 => 'reserved' + ); + } + return (isset($lookup[$cmixlev]) ? $lookup[$cmixlev] : false); + } + + + + public static function AC3surroundMixLevelLookup($surmixlev) { + + static $lookup; + if (!@$lookup) { + $lookup = array ( + 0 => pow(2, -3.0 / 6), + 1 => pow(2, -6.0 / 6), + 2 => 0, + 3 => 'reserved' + ); + } + return (isset($lookup[$surmixlev]) ? $lookup[$surmixlev] : false); + } + + + + public static function AC3dolbySurroundModeLookup($dsurmod) { + + static $lookup = array ( + 0 => 'not indicated', + 1 => 'Not Dolby Surround encoded', + 2 => 'Dolby Surround encoded', + 3 => 'reserved' + ); + return (isset($lookup[$dsurmod]) ? $lookup[$dsurmod] : false); + } + + + + public static function AC3channelsEnabledLookup($acmod, $lfeon) { + + return array ( + 'ch1' => $acmod == 0, + 'ch2' => $acmod == 0, + 'left' => $acmod > 1, + 'right' => $acmod > 1, + 'center' => (bool)($acmod & 0x01), + 'surround_mono' => $acmod == 4 || $acmod == 5, + 'surround_left' => $acmod == 6 || $acmod == 7, + 'surround_right' => $acmod == 6 || $acmod == 7, + 'lfe' => $lfeon + ); + } + + + + public static function AC3heavyCompression($compre) { + + // The first four bits indicate gain changes in 6.02dB increments which can be + // implemented with an arithmetic shift operation. The following four bits + // indicate linear gain changes, and require a 5-bit multiply. + // We will represent the two 4-bit fields of compr as follows: + // X0 X1 X2 X3 . Y4 Y5 Y6 Y7 + // The meaning of the X values is most simply described by considering X to represent a 4-bit + // signed integer with values from –8 to +7. The gain indicated by X is then (X + 1) * 6.02 dB. The + // following table shows this in detail. + + // Meaning of 4 msb of compr + // 7 +48.16 dB + // 6 +42.14 dB + // 5 +36.12 dB + // 4 +30.10 dB + // 3 +24.08 dB + // 2 +18.06 dB + // 1 +12.04 dB + // 0 +6.02 dB + // -1 0 dB + // -2 –6.02 dB + // -3 –12.04 dB + // -4 –18.06 dB + // -5 –24.08 dB + // -6 –30.10 dB + // -7 –36.12 dB + // -8 –42.14 dB + + $fourbit = str_pad(decbin(($compre & 0xF0) >> 4), 4, '0', STR_PAD_LEFT); + if ($fourbit{0} == '1') { + $log_gain = -8 + bindec(substr($fourbit, 1)); + } else { + $log_gain = bindec(substr($fourbit, 1)); + } + $log_gain = ($log_gain + 1) * (20 * log10(2)); + + // The value of Y is a linear representation of a gain change of up to –6 dB. Y is considered to + // be an unsigned fractional integer, with a leading value of 1, or: 0.1 Y4 Y5 Y6 Y7 (base 2). Y can + // represent values between 0.111112 (or 31/32) and 0.100002 (or 1/2). Thus, Y can represent gain + // changes from –0.28 dB to –6.02 dB. + + $lin_gain = (16 + ($compre & 0x0F)) / 32; + + // The combination of X and Y values allows compr to indicate gain changes from + // 48.16 – 0.28 = +47.89 dB, to + // –42.14 – 6.02 = –48.16 dB. + + return $log_gain - $lin_gain; + } + + + + public static function AC3roomTypeLookup($roomtyp) { + + static $lookup = array ( + 0 => 'not indicated', + 1 => 'large room, X curve monitor', + 2 => 'small room, flat monitor', + 3 => 'reserved' + ); + return (isset($lookup[$roomtyp]) ? $lookup[$roomtyp] : false); + } + + + + public static function AC3frameSizeLookup($frmsizecod, $fscod) { + + $padding = (bool)($frmsizecod % 2); + $frame_size_id = floor($frmsizecod / 2); + + static $lookup = array ( + 0 => array (128, 138, 192), + 1 => array (40, 160, 174, 240), + 2 => array (48, 192, 208, 288), + 3 => array (56, 224, 242, 336), + 4 => array (64, 256, 278, 384), + 5 => array (80, 320, 348, 480), + 6 => array (96, 384, 416, 576), + 7 => array (112, 448, 486, 672), + 8 => array (128, 512, 556, 768), + 9 => array (160, 640, 696, 960), + 10 => array (192, 768, 834, 1152), + 11 => array (224, 896, 974, 1344), + 12 => array (256, 1024, 1114, 1536), + 13 => array (320, 1280, 1392, 1920), + 14 => array (384, 1536, 1670, 2304), + 15 => array (448, 1792, 1950, 2688), + 16 => array (512, 2048, 2228, 3072), + 17 => array (576, 2304, 2506, 3456), + 18 => array (640, 2560, 2786, 3840) + ); + if (($fscod == 1) && $padding) { + // frame lengths are padded by 1 word (16 bits) at 44100 + $lookup[$frmsizecod] += 2; + } + return (isset($lookup[$frame_size_id][$fscod]) ? $lookup[$frame_size_id][$fscod] : false); + } + + + + public static function AC3bitrateLookup($frmsizecod) { + + static $lookup = array ( + 0 => 32000, + 1 => 40000, + 2 => 48000, + 3 => 56000, + 4 => 64000, + 5 => 80000, + 6 => 96000, + 7 => 112000, + 8 => 128000, + 9 => 160000, + 10 => 192000, + 11 => 224000, + 12 => 256000, + 13 => 320000, + 14 => 384000, + 15 => 448000, + 16 => 512000, + 17 => 576000, + 18 => 640000 + ); + $frame_size_id = floor($frmsizecod / 2); + return (isset($lookup[$frame_size_id]) ? $lookup[$frame_size_id] : false); + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.au.php b/modules/getid3/module.audio.au.php new file mode 100644 index 00000000..ef0e29c2 --- /dev/null +++ b/modules/getid3/module.audio.au.php @@ -0,0 +1,184 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.au.php | +// | module for analyzing AU files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.au.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_au extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $au_header = fread($getid3->fp, 8); + + // Magic bytes: .snd + + $getid3->info['au'] = array (); + $info_au = &$getid3->info['au']; + + $getid3->info['fileformat'] = 'au'; + $getid3->info['audio']['dataformat'] = 'au'; + $getid3->info['audio']['bitrate_mode'] = 'cbr'; + $info_au['encoding'] = 'ISO-8859-1'; + + $info_au['header_length'] = getid3_lib::BigEndian2Int(substr($au_header, 4, 4)); + $au_header .= fread($getid3->fp, $info_au['header_length'] - 8); + $getid3->info['avdataoffset'] += $info_au['header_length']; + + getid3_lib::ReadSequence('BigEndian2Int', $info_au, $au_header, 8, + array ( + 'data_size' => 4, + 'data_format_id'=> 4, + 'sample_rate' => 4, + 'channels' => 4 + ) + ); + $info_au['comments']['comment'][] = trim(substr($au_header, 24)); + + $info_au['data_format'] = getid3_au::AUdataFormatNameLookup($info_au['data_format_id']); + $info_au['used_bits_per_sample'] = getid3_au::AUdataFormatUsedBitsPerSampleLookup($info_au['data_format_id']); + if ($info_au['bits_per_sample'] = getid3_au::AUdataFormatBitsPerSampleLookup($info_au['data_format_id'])) { + $getid3->info['audio']['bits_per_sample'] = $info_au['bits_per_sample']; + } else { + unset($info_au['bits_per_sample']); + } + + $getid3->info['audio']['sample_rate'] = $info_au['sample_rate']; + $getid3->info['audio']['channels'] = $info_au['channels']; + + if (($getid3->info['avdataoffset'] + $info_au['data_size']) > $getid3->info['avdataend']) { + $getid3->warning('Possible truncated file - expecting "'.$info_au['data_size'].'" bytes of audio data, only found '.($getid3->info['avdataend'] - $getid3->info['avdataoffset']).' bytes"'); + } + + $getid3->info['playtime_seconds'] = $info_au['data_size'] / ($info_au['sample_rate'] * $info_au['channels'] * ($info_au['used_bits_per_sample'] / 8)); + $getid3->info['audio']['bitrate'] = ($info_au['data_size'] * 8) / $getid3->info['playtime_seconds']; + + return true; + } + + + + public static function AUdataFormatNameLookup($id) { + + static $lookup = array ( + 0 => 'unspecified format', + 1 => '8-bit mu-law', + 2 => '8-bit linear', + 3 => '16-bit linear', + 4 => '24-bit linear', + 5 => '32-bit linear', + 6 => 'floating-point', + 7 => 'double-precision float', + 8 => 'fragmented sampled data', + 9 => 'SUN_FORMAT_NESTED', + 10 => 'DSP program', + 11 => '8-bit fixed-point', + 12 => '16-bit fixed-point', + 13 => '24-bit fixed-point', + 14 => '32-bit fixed-point', + + 16 => 'non-audio display data', + 17 => 'SND_FORMAT_MULAW_SQUELCH', + 18 => '16-bit linear with emphasis', + 19 => '16-bit linear with compression', + 20 => '16-bit linear with emphasis + compression', + 21 => 'Music Kit DSP commands', + 22 => 'SND_FORMAT_DSP_COMMANDS_SAMPLES', + 23 => 'CCITT g.721 4-bit ADPCM', + 24 => 'CCITT g.722 ADPCM', + 25 => 'CCITT g.723 3-bit ADPCM', + 26 => 'CCITT g.723 5-bit ADPCM', + 27 => 'A-Law 8-bit' + ); + + return (isset($lookup[$id]) ? $lookup[$id] : false); + } + + + + public static function AUdataFormatBitsPerSampleLookup($id) { + + static $lookup = array ( + 1 => 8, + 2 => 8, + 3 => 16, + 4 => 24, + 5 => 32, + 6 => 32, + 7 => 64, + + 11 => 8, + 12 => 16, + 13 => 24, + 14 => 32, + + 18 => 16, + 19 => 16, + 20 => 16, + + 23 => 16, + + 25 => 16, + 26 => 16, + 27 => 8 + ); + return (isset($lookup[$id]) ? $lookup[$id] : false); + } + + + + public static function AUdataFormatUsedBitsPerSampleLookup($id) { + + static $lookup = array ( + 1 => 8, + 2 => 8, + 3 => 16, + 4 => 24, + 5 => 32, + 6 => 32, + 7 => 64, + + 11 => 8, + 12 => 16, + 13 => 24, + 14 => 32, + + 18 => 16, + 19 => 16, + 20 => 16, + + 23 => 4, + + 25 => 3, + 26 => 5, + 27 => 8, + ); + return (isset($lookup[$id]) ? $lookup[$id] : false); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.avr.php b/modules/getid3/module.audio.avr.php new file mode 100644 index 00000000..c1662961 --- /dev/null +++ b/modules/getid3/module.audio.avr.php @@ -0,0 +1,135 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.avr.php | +// | Module for analyzing AVR audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.avr.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_avr extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + // http://cui.unige.ch/OSG/info/AudioFormats/ap11.html + // http://www.btinternet.com/~AnthonyJ/Atari/programming/avr_format.html + // offset type length name comments + // --------------------------------------------------------------------- + // 0 char 4 ID format ID == "2BIT" + // 4 char 8 name sample name (unused space filled with 0) + // 12 short 1 mono/stereo 0=mono, -1 (0xFFFF)=stereo + // With stereo, samples are alternated, + // the first voice is the left : + // (LRLRLRLRLRLRLRLRLR...) + // 14 short 1 resolution 8, 12 or 16 (bits) + // 16 short 1 signed or not 0=unsigned, -1 (0xFFFF)=signed + // 18 short 1 loop or not 0=no loop, -1 (0xFFFF)=loop on + // 20 short 1 MIDI note 0xFFnn, where 0 <= nn <= 127 + // 0xFFFF means "no MIDI note defined" + // 22 byte 1 Replay speed Frequence in the Replay software + // 0=5.485 Khz, 1=8.084 Khz, 2=10.971 Khz, + // 3=16.168 Khz, 4=21.942 Khz, 5=32.336 Khz + // 6=43.885 Khz, 7=47.261 Khz + // -1 (0xFF)=no defined Frequence + // 23 byte 3 sample rate in Hertz + // 26 long 1 size in bytes (2 * bytes in stereo) + // 30 long 1 loop begin 0 for no loop + // 34 long 1 loop size equal to 'size' for no loop + // 38 short 2 Reserved, MIDI keyboard split */ + // 40 short 2 Reserved, sample compression */ + // 42 short 2 Reserved */ + // 44 char 20; Additional filename space, used if (name[7] != 0) + // 64 byte 64 user data + // 128 bytes ? sample data (12 bits samples are coded on 16 bits: + // 0000 xxxx xxxx xxxx) + // --------------------------------------------------------------------- + + // Note that all values are in motorola (big-endian) format, and that long is + // assumed to be 4 bytes, and short 2 bytes. + // When reading the samples, you should handle both signed and unsigned data, + // and be prepared to convert 16->8 bit, or mono->stereo if needed. To convert + // 8-bit data between signed/unsigned just add 127 to the sample values. + // Simularly for 16-bit data you should add 32769 + + + // Magic bytes: '2BIT' + + $getid3->info['avr'] = array (); + $info_avr = &$getid3->info['avr']; + + $getid3->info['fileformat'] = 'avr'; + $info_avr['raw']['magic'] = '2BIT'; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $avr_header = fread($getid3->fp, 128); + + $getid3->info['avdataoffset'] += 128; + + $info_avr['sample_name'] = rtrim(substr($avr_header, 4, 8)); + + $info_avr['raw']['mono'] = getid3_lib::BigEndian2Int(substr($avr_header, 12, 2)); + $info_avr['bits_per_sample'] = getid3_lib::BigEndian2Int(substr($avr_header, 14, 2)); + $info_avr['raw']['signed'] = getid3_lib::BigEndian2Int(substr($avr_header, 16, 2)); + $info_avr['raw']['loop'] = getid3_lib::BigEndian2Int(substr($avr_header, 18, 2)); + $info_avr['raw']['midi'] = getid3_lib::BigEndian2Int(substr($avr_header, 20, 2)); + $info_avr['raw']['replay_freq'] = getid3_lib::BigEndian2Int(substr($avr_header, 22, 1)); + $info_avr['sample_rate'] = getid3_lib::BigEndian2Int(substr($avr_header, 23, 3)); + $info_avr['sample_length'] = getid3_lib::BigEndian2Int(substr($avr_header, 26, 4)); + $info_avr['loop_start'] = getid3_lib::BigEndian2Int(substr($avr_header, 30, 4)); + $info_avr['loop_end'] = getid3_lib::BigEndian2Int(substr($avr_header, 34, 4)); + $info_avr['midi_split'] = getid3_lib::BigEndian2Int(substr($avr_header, 38, 2)); + $info_avr['sample_compression'] = getid3_lib::BigEndian2Int(substr($avr_header, 40, 2)); + $info_avr['reserved'] = getid3_lib::BigEndian2Int(substr($avr_header, 42, 2)); + $info_avr['sample_name_extra'] = rtrim(substr($avr_header, 44, 20)); + $info_avr['comment'] = rtrim(substr($avr_header, 64, 64)); + + $info_avr['flags']['stereo'] = (($info_avr['raw']['mono'] == 0) ? false : true); + $info_avr['flags']['signed'] = (($info_avr['raw']['signed'] == 0) ? false : true); + $info_avr['flags']['loop'] = (($info_avr['raw']['loop'] == 0) ? false : true); + + $info_avr['midi_notes'] = array (); + if (($info_avr['raw']['midi'] & 0xFF00) != 0xFF00) { + $info_avr['midi_notes'][] = ($info_avr['raw']['midi'] & 0xFF00) >> 8; + } + if (($info_avr['raw']['midi'] & 0x00FF) != 0x00FF) { + $info_avr['midi_notes'][] = ($info_avr['raw']['midi'] & 0x00FF); + } + + if (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) != ($info_avr['sample_length'] * (($info_avr['bits_per_sample'] == 8) ? 1 : 2))) { + $getid3->warning('Probable truncated file: expecting '.($info_avr['sample_length'] * (($info_avr['bits_per_sample'] == 8) ? 1 : 2)).' bytes of audio data, found '.($getid3->info['avdataend'] - $getid3->info['avdataoffset'])); + } + + $getid3->info['audio']['dataformat'] = 'avr'; + $getid3->info['audio']['lossless'] = true; + $getid3->info['audio']['bitrate_mode'] = 'cbr'; + $getid3->info['audio']['bits_per_sample'] = $info_avr['bits_per_sample']; + $getid3->info['audio']['sample_rate'] = $info_avr['sample_rate']; + $getid3->info['audio']['channels'] = ($info_avr['flags']['stereo'] ? 2 : 1); + $getid3->info['playtime_seconds'] = ($info_avr['sample_length'] / $getid3->info['audio']['channels']) / $info_avr['sample_rate']; + $getid3->info['audio']['bitrate'] = ($info_avr['sample_length'] * (($info_avr['bits_per_sample'] == 8) ? 8 : 16)) / $getid3->info['playtime_seconds']; + + return true; + } +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.bonk.php b/modules/getid3/module.audio.bonk.php new file mode 100644 index 00000000..770f67ba --- /dev/null +++ b/modules/getid3/module.audio.bonk.php @@ -0,0 +1,235 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.bonk.php | +// | Module for analyzing BONK audio files | +// | dependencies: module.tag.id3v2.php (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.bonk.php,v 1.3 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_bonk extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['bonk'] = array (); + $info_bonk = &$getid3->info['bonk']; + + $info_bonk['dataoffset'] = $getid3->info['avdataoffset']; + $info_bonk['dataend'] = $getid3->info['avdataend']; + + + // Scan-from-end method, for v0.6 and higher + fseek($getid3->fp, $info_bonk['dataend'] - 8, SEEK_SET); + $possible_bonk_tag = fread($getid3->fp, 8); + while (getid3_bonk::BonkIsValidTagName(substr($possible_bonk_tag, 4, 4), true)) { + $bonk_tag_size = getid3_lib::LittleEndian2Int(substr($possible_bonk_tag, 0, 4)); + fseek($getid3->fp, 0 - $bonk_tag_size, SEEK_CUR); + $bonk_tag_offset = ftell($getid3->fp); + $tag_header_test = fread($getid3->fp, 5); + if (($tag_header_test{0} != "\x00") || (substr($possible_bonk_tag, 4, 4) != strtolower(substr($possible_bonk_tag, 4, 4)))) { + throw new getid3_exception('Expecting "Ø'.strtoupper(substr($possible_bonk_tag, 4, 4)).'" at offset '.$bonk_tag_offset.', found "'.$tag_header_test.'"'); + } + $bonk_tag_name = substr($tag_header_test, 1, 4); + + $info_bonk[$bonk_tag_name]['size'] = $bonk_tag_size; + $info_bonk[$bonk_tag_name]['offset'] = $bonk_tag_offset; + $this->HandleBonkTags($bonk_tag_name); + + $next_tag_end_offset = $bonk_tag_offset - 8; + if ($next_tag_end_offset < $info_bonk['dataoffset']) { + if (empty($getid3->info['audio']['encoder'])) { + $getid3->info['audio']['encoder'] = 'Extended BONK v0.9+'; + } + return true; + } + fseek($getid3->fp, $next_tag_end_offset, SEEK_SET); + $possible_bonk_tag = fread($getid3->fp, 8); + } + + // Seek-from-beginning method for v0.4 and v0.5 + if (empty($info_bonk['BONK'])) { + fseek($getid3->fp, $info_bonk['dataoffset'], SEEK_SET); + do { + $tag_header_test = fread($getid3->fp, 5); + switch ($tag_header_test) { + case "\x00".'BONK': + if (empty($getid3->info['audio']['encoder'])) { + $getid3->info['audio']['encoder'] = 'BONK v0.4'; + } + break; + + case "\x00".'INFO': + $getid3->info['audio']['encoder'] = 'Extended BONK v0.5'; + break; + + default: + break 2; + } + $bonk_tag_name = substr($tag_header_test, 1, 4); + $info_bonk[$bonk_tag_name]['size'] = $info_bonk['dataend'] - $info_bonk['dataoffset']; + $info_bonk[$bonk_tag_name]['offset'] = $info_bonk['dataoffset']; + $this->HandleBonkTags($bonk_tag_name); + + } while (true); + } + + + // Parse META block for v0.6 - v0.8 + if (!@$info_bonk['INFO'] && isset($info_bonk['META']['tags']['info'])) { + fseek($getid3->fp, $info_bonk['META']['tags']['info'], SEEK_SET); + $tag_header_test = fread($getid3->fp, 5); + if ($tag_header_test == "\x00".'INFO') { + $getid3->info['audio']['encoder'] = 'Extended BONK v0.6 - v0.8'; + + $bonk_tag_name = substr($tag_header_test, 1, 4); + $info_bonk[$bonk_tag_name]['size'] = $info_bonk['dataend'] - $info_bonk['dataoffset']; + $info_bonk[$bonk_tag_name]['offset'] = $info_bonk['dataoffset']; + $this->HandleBonkTags($bonk_tag_name); + } + } + + if (empty($getid3->info['audio']['encoder'])) { + $getid3->info['audio']['encoder'] = 'Extended BONK v0.9+'; + } + if (empty($info_bonk['BONK'])) { + unset($getid3->info['bonk']); + } + return true; + + } + + + + private function HandleBonkTags(&$bonk_tag_name) { + + // Shortcut to getid3 pointer + $getid3 = $this->getid3; + $info_audio = &$getid3->info['audio']; + + switch ($bonk_tag_name) { + + case 'BONK': + // shortcut + $info_bonk_BONK = &$getid3->info['bonk']['BONK']; + + $bonk_data = "\x00".'BONK'.fread($getid3->fp, 17); + + getid3_lib::ReadSequence('LittleEndian2Int', $info_bonk_BONK, $bonk_data, 5, + array ( + 'version' => 1, + 'number_samples' => 4, + 'sample_rate' => 4, + 'channels' => 1, + 'lossless' => 1, + 'joint_stereo' => 1, + 'number_taps' => 2, + 'downsampling_ratio' => 1, + 'samples_per_packet' => 2 + ) + ); + + $info_bonk_BONK['lossless'] = (bool)$info_bonk_BONK['lossless']; + $info_bonk_BONK['joint_stereo'] = (bool)$info_bonk_BONK['joint_stereo']; + + $getid3->info['avdataoffset'] = $info_bonk_BONK['offset'] + 5 + 17; + $getid3->info['avdataend'] = $info_bonk_BONK['offset'] + $info_bonk_BONK['size']; + + $getid3->info['fileformat'] = 'bonk'; + $info_audio['dataformat'] = 'bonk'; + $info_audio['bitrate_mode'] = 'vbr'; // assumed + $info_audio['channels'] = $info_bonk_BONK['channels']; + $info_audio['sample_rate'] = $info_bonk_BONK['sample_rate']; + $info_audio['channelmode'] = $info_bonk_BONK['joint_stereo'] ? 'joint stereo' : 'stereo'; + $info_audio['lossless'] = $info_bonk_BONK['lossless']; + $info_audio['codec'] = 'bonk'; + + $getid3->info['playtime_seconds'] = $info_bonk_BONK['number_samples'] / ($info_bonk_BONK['sample_rate'] * $info_bonk_BONK['channels']); + if ($getid3->info['playtime_seconds'] > 0) { + $info_audio['bitrate'] = (($getid3->info['bonk']['dataend'] - $getid3->info['bonk']['dataoffset']) * 8) / $getid3->info['playtime_seconds']; + } + break; + + case 'INFO': + // shortcut + $info_bonk_INFO = &$getid3->info['bonk']['INFO']; + + $info_bonk_INFO['version'] = getid3_lib::LittleEndian2Int(fread($getid3->fp, 1)); + $info_bonk_INFO['entries_count'] = 0; + $next_info_data_pair = fread($getid3->fp, 5); + if (!getid3_bonk::BonkIsValidTagName(substr($next_info_data_pair, 1, 4))) { + while (!feof($getid3->fp)) { + $next_info_data_pair = fread($getid3->fp, 5); + if (getid3_bonk::BonkIsValidTagName(substr($next_info_data_pair, 1, 4))) { + fseek($getid3->fp, -5, SEEK_CUR); + break; + } + $info_bonk_INFO['entries_count']++; + } + } + break; + + case 'META': + $bonk_data = "\x00".'META'.fread($getid3->fp, $getid3->info['bonk']['META']['size'] - 5); + $getid3->info['bonk']['META']['version'] = getid3_lib::LittleEndian2Int(substr($bonk_data, 5, 1)); + + $meta_tag_entries = floor(((strlen($bonk_data) - 8) - 6) / 8); // BonkData - xxxxmeta - ØMETA + $offset = 6; + for ($i = 0; $i < $meta_tag_entries; $i++) { + $meta_entry_tag_name = substr($bonk_data, $offset, 4); + $offset += 4; + $meta_entry_tag_offset = getid3_lib::LittleEndian2Int(substr($bonk_data, $offset, 4)); + $offset += 4; + $getid3->info['bonk']['META']['tags'][$meta_entry_tag_name] = $meta_entry_tag_offset; + } + break; + + case ' ID3': + $info_audio['encoder'] = 'Extended BONK v0.9+'; + + // ID3v2 checking is optional + if (class_exists('getid3_id3v2')) { + + $id3v2 = new getid3_id3v2($getid3); + $id3v2->option_starting_offset = $getid3->info['bonk'][' ID3']['offset'] + 2; + $getid3->info['bonk'][' ID3']['valid'] = $id3v2->Analyze(); + } + break; + + default: + $getid3->warning('Unexpected Bonk tag "'.$bonk_tag_name.'" at offset '.$getid3->info['bonk'][$bonk_tag_name]['offset']); + break; + + } + } + + + + public static function BonkIsValidTagName($possible_bonk_tag, $ignore_case=false) { + + $ignore_case = $ignore_case ? 'i' : ''; + return preg_match('/^(BONK|INFO| ID3|META)$/'.$ignore_case, $possible_bonk_tag); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.dts.php b/modules/getid3/module.audio.dts.php new file mode 100644 index 00000000..beb520fb --- /dev/null +++ b/modules/getid3/module.audio.dts.php @@ -0,0 +1,254 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.dts.php | +// | Module for analyzing DTS audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.dts.php,v 1.2 2006/11/16 13:14:26 ah Exp $ + + + +// Specs taken from "DTS Coherent Acoustics;Core and Extensions, ETSI TS 102 114 V1.2.1 (2002-12)" +// (http://pda.etsi.org/pda/queryform.asp) +// With thanks to Gambit http://mac.sourceforge.net/atl/ + +class getid3_dts extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['dts'] = array (); + $info_dts = &$getid3->info['dts']; + + $getid3->info['fileformat'] = 'dts'; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $header = fread($getid3->fp, 16); + + $fhBS = getid3_lib::BigEndian2Bin(substr($header, 4, 12)); + $bs_offset = 0; + $info_dts['raw']['frame_type'] = bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['raw']['deficit_samples'] = bindec(substr($fhBS, $bs_offset, 5)); $bs_offset += 5; + $info_dts['flags']['crc_present'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['raw']['pcm_sample_blocks'] = bindec(substr($fhBS, $bs_offset, 7)); $bs_offset += 7; + $info_dts['raw']['frame_byte_size'] = bindec(substr($fhBS, $bs_offset, 14)); $bs_offset += 14; + $info_dts['raw']['channel_arrangement'] = bindec(substr($fhBS, $bs_offset, 6)); $bs_offset += 6; + $info_dts['raw']['sample_frequency'] = bindec(substr($fhBS, $bs_offset, 4)); $bs_offset += 4; + $info_dts['raw']['bitrate'] = bindec(substr($fhBS, $bs_offset, 5)); $bs_offset += 5; + $info_dts['flags']['embedded_downmix'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['flags']['dynamicrange'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['flags']['timestamp'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['flags']['auxdata'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['flags']['hdcd'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['raw']['extension_audio'] = bindec(substr($fhBS, $bs_offset, 3)); $bs_offset += 3; + $info_dts['flags']['extended_coding'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['flags']['audio_sync_insertion'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['raw']['lfe_effects'] = bindec(substr($fhBS, $bs_offset, 2)); $bs_offset += 2; + $info_dts['flags']['predictor_history'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + if ($info_dts['flags']['crc_present']) { + $info_dts['raw']['crc16'] = bindec(substr($fhBS, $bs_offset, 16)); $bs_offset += 16; + } + $info_dts['flags']['mri_perfect_reconst'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['raw']['encoder_soft_version'] = bindec(substr($fhBS, $bs_offset, 4)); $bs_offset += 4; + $info_dts['raw']['copy_history'] = bindec(substr($fhBS, $bs_offset, 2)); $bs_offset += 2; + $info_dts['raw']['bits_per_sample'] = bindec(substr($fhBS, $bs_offset, 2)); $bs_offset += 2; + $info_dts['flags']['surround_es'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['flags']['front_sum_diff'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['flags']['surround_sum_diff'] = (bool) bindec(substr($fhBS, $bs_offset, 1)); $bs_offset += 1; + $info_dts['raw']['dialog_normalization'] = bindec(substr($fhBS, $bs_offset, 4)); $bs_offset += 4; + + + $info_dts['bitrate'] = $this->DTSbitrateLookup($info_dts['raw']['bitrate']); + $info_dts['bits_per_sample'] = $this->DTSbitPerSampleLookup($info_dts['raw']['bits_per_sample']); + $info_dts['sample_rate'] = $this->DTSsampleRateLookup($info_dts['raw']['sample_frequency']); + $info_dts['dialog_normalization'] = $this->DTSdialogNormalization($info_dts['raw']['dialog_normalization'], $info_dts['raw']['encoder_soft_version']); + $info_dts['flags']['lossless'] = (($info_dts['raw']['bitrate'] == 31) ? true : false); + $info_dts['bitrate_mode'] = (($info_dts['raw']['bitrate'] == 30) ? 'vbr' : 'cbr'); + $info_dts['channels'] = $this->DTSnumChannelsLookup($info_dts['raw']['channel_arrangement']); + $info_dts['channel_arrangement'] = $this->DTSchannelArrangementLookup($info_dts['raw']['channel_arrangement']); + + $getid3->info['audio']['dataformat'] = 'dts'; + $getid3->info['audio']['lossless'] = $info_dts['flags']['lossless']; + $getid3->info['audio']['bitrate_mode'] = $info_dts['bitrate_mode']; + $getid3->info['audio']['bits_per_sample'] = $info_dts['bits_per_sample']; + $getid3->info['audio']['sample_rate'] = $info_dts['sample_rate']; + $getid3->info['audio']['channels'] = $info_dts['channels']; + $getid3->info['audio']['bitrate'] = $info_dts['bitrate']; + $getid3->info['playtime_seconds'] = ($getid3->info['avdataend'] - $getid3->info['avdataoffset']) / ($info_dts['bitrate'] / 8); + + return true; + } + + + public static function DTSbitrateLookup($index) { + + static $lookup = array ( + 0 => 32000, + 1 => 56000, + 2 => 64000, + 3 => 96000, + 4 => 112000, + 5 => 128000, + 6 => 192000, + 7 => 224000, + 8 => 256000, + 9 => 320000, + 10 => 384000, + 11 => 448000, + 12 => 512000, + 13 => 576000, + 14 => 640000, + 15 => 768000, + 16 => 960000, + 17 => 1024000, + 18 => 1152000, + 19 => 1280000, + 20 => 1344000, + 21 => 1408000, + 22 => 1411200, + 23 => 1472000, + 24 => 1536000, + 25 => 1920000, + 26 => 2048000, + 27 => 3072000, + 28 => 3840000, + 29 => 'open', + 30 => 'variable', + 31 => 'lossless' + ); + return @$lookup[$index]; + } + + + public static function DTSsampleRateLookup($index) { + + static $lookup = array ( + 0 => 'invalid', + 1 => 8000, + 2 => 16000, + 3 => 32000, + 4 => 'invalid', + 5 => 'invalid', + 6 => 11025, + 7 => 22050, + 8 => 44100, + 9 => 'invalid', + 10 => 'invalid', + 11 => 12000, + 12 => 24000, + 13 => 48000, + 14 => 'invalid', + 15 => 'invalid' + ); + return @$lookup[$index]; + } + + + public static function DTSbitPerSampleLookup($index) { + + static $lookup = array ( + 0 => 16, + 1 => 20, + 2 => 24, + 3 => 24, + ); + return @$lookup[$index]; + } + + + public static function DTSnumChannelsLookup($index) { + + switch ($index) { + case 0: + return 1; + + case 1: + case 2: + case 3: + case 4: + return 2; + + case 5: + case 6: + return 3; + + case 7: + case 8: + return 4; + + case 9: + return 5; + + case 10: + case 11: + case 12: + return 6; + + case 13: + return 7; + + case 14: + case 15: + return 8; + } + return false; + } + + + public static function DTSchannelArrangementLookup($index) { + + static $lookup = array ( + 0 => 'A', + 1 => 'A + B (dual mono)', + 2 => 'L + R (stereo)', + 3 => '(L+R) + (L-R) (sum-difference)', + 4 => 'LT + RT (left and right total)', + 5 => 'C + L + R', + 6 => 'L + R + S', + 7 => 'C + L + R + S', + 8 => 'L + R + SL + SR', + 9 => 'C + L + R + SL + SR', + 10 => 'CL + CR + L + R + SL + SR', + 11 => 'C + L + R+ LR + RR + OV', + 12 => 'CF + CR + LF + RF + LR + RR', + 13 => 'CL + C + CR + L + R + SL + SR', + 14 => 'CL + CR + L + R + SL1 + SL2 + SR1 + SR2', + 15 => 'CL + C+ CR + L + R + SL + S + SR', + ); + return (@$lookup[$index] ? @$lookup[$index] : 'user-defined'); + } + + + public static function DTSdialogNormalization($index, $version) { + + switch ($version) { + case 7: + return 0 - $index; + + case 6: + return 0 - 16 - $index; + } + return false; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.la.php b/modules/getid3/module.audio.la.php new file mode 100644 index 00000000..f8174320 --- /dev/null +++ b/modules/getid3/module.audio.la.php @@ -0,0 +1,196 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.la.php | +// | Module for analyzing LA udio files | +// | dependencies: module.audio-video.riff.php | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.la.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_la extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->include_module('audio-video.riff'); + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $raw_data = fread($getid3->fp, getid3::FREAD_BUFFER_SIZE); + + $getid3->info['fileformat'] = 'la'; + $getid3->info['audio']['dataformat'] = 'la'; + $getid3->info['audio']['lossless'] = true; + + $getid3->info['la']['version_major'] = (int)$raw_data{2}; + $getid3->info['la']['version_minor'] = (int)$raw_data{3}; + $getid3->info['la']['version'] = (float)$getid3->info['la']['version_major'] + ($getid3->info['la']['version_minor'] / 10); + + $getid3->info['la']['uncompressed_size'] = getid3_lib::LittleEndian2Int(substr($raw_data, 4, 4)); + + $wave_chunk = substr($raw_data, 8, 4); + if ($wave_chunk !== 'WAVE') { + throw new getid3_exception('Expected "WAVE" ('.getid3_lib::PrintHexBytes('WAVE').') at offset 8, found "'.$wave_chunk.'" ('.getid3_lib::PrintHexBytes($wave_chunk).') instead.'); + } + + $offset = 12; + + $getid3->info['la']['fmt_size'] = 24; + if ($getid3->info['la']['version'] >= 0.3) { + + $getid3->info['la']['fmt_size'] = getid3_lib::LittleEndian2Int(substr($raw_data, $offset, 4)); + $getid3->info['la']['header_size'] = 49 + $getid3->info['la']['fmt_size'] - 24; + $offset += 4; + + } else { + + // version 0.2 didn't support additional data blocks + $getid3->info['la']['header_size'] = 41; + } + + $fmt_chunk = substr($raw_data, $offset, 4); + if ($fmt_chunk !== 'fmt ') { + throw new getid3_exception('Expected "fmt " ('.getid3_lib::PrintHexBytes('fmt ').') at offset '.$offset.', found "'.$fmt_chunk.'" ('.getid3_lib::PrintHexBytes($fmt_chunk).') instead.'); + } + $offset += 4; + + $fmt_size = getid3_lib::LittleEndian2Int(substr($raw_data, $offset, 4)); + $offset += 4; + + $getid3->info['la']['raw']['format'] = getid3_lib::LittleEndian2Int(substr($raw_data, $offset, 2)); + $offset += 2; + + getid3_lib::ReadSequence('LittleEndian2Int', $getid3->info['la'], $raw_data, $offset, + array ( + 'channels' => 2, + 'sample_rate' => 4, + 'bytes_per_second' => 4, + 'bytes_per_sample' => 2, + 'bits_per_sample' => 2, + 'samples' => 4 + ) + ); + $offset += 18; + + $getid3->info['la']['raw']['flags'] = getid3_lib::LittleEndian2Int($raw_data{$offset++}); + + $getid3->info['la']['flags']['seekable'] = (bool)($getid3->info['la']['raw']['flags'] & 0x01); + if ($getid3->info['la']['version'] >= 0.4) { + $getid3->info['la']['flags']['high_compression'] = (bool)($getid3->info['la']['raw']['flags'] & 0x02); + } + + $getid3->info['la']['original_crc'] = getid3_lib::LittleEndian2Int(substr($raw_data, $offset, 4)); + $offset += 4; + + // mikeØbevin*de + // Basically, the blocksize/seekevery are 61440/19 in La0.4 and 73728/16 + // in earlier versions. A seekpoint is added every blocksize * seekevery + // samples, so 4 * int(totalSamples / (blockSize * seekEvery)) should + // give the number of bytes used for the seekpoints. Of course, if seeking + // is disabled, there are no seekpoints stored. + + if ($getid3->info['la']['version'] >= 0.4) { + $getid3->info['la']['blocksize'] = 61440; + $getid3->info['la']['seekevery'] = 19; + } else { + $getid3->info['la']['blocksize'] = 73728; + $getid3->info['la']['seekevery'] = 16; + } + + $getid3->info['la']['seekpoint_count'] = 0; + if ($getid3->info['la']['flags']['seekable']) { + $getid3->info['la']['seekpoint_count'] = floor($getid3->info['la']['samples'] / ($getid3->info['la']['blocksize'] * $getid3->info['la']['seekevery'])); + + for ($i = 0; $i < $getid3->info['la']['seekpoint_count']; $i++) { + $getid3->info['la']['seekpoints'][] = getid3_lib::LittleEndian2Int(substr($raw_data, $offset, 4)); + $offset += 4; + } + } + + if ($getid3->info['la']['version'] >= 0.3) { + + // Following the main header information, the program outputs all of the + // seekpoints. Following these is what I called the 'footer start', + // i.e. the position immediately after the La audio data is finished. + + $getid3->info['la']['footerstart'] = getid3_lib::LittleEndian2Int(substr($raw_data, $offset, 4)); + $offset += 4; + + if ($getid3->info['la']['footerstart'] > $getid3->info['filesize']) { + $getid3->warning('FooterStart value points to offset '.$getid3->info['la']['footerstart'].' which is beyond end-of-file ('.$getid3->info['filesize'].')'); + $getid3->info['la']['footerstart'] = $getid3->info['filesize']; + } + + } else { + + // La v0.2 didn't have FooterStart value + $getid3->info['la']['footerstart'] = $getid3->info['avdataend']; + + } + + if ($getid3->info['la']['footerstart'] < $getid3->info['avdataend']) { + + // Create riff header + $riff_data = 'WAVE'; + if ($getid3->info['la']['version'] == 0.2) { + $riff_data .= substr($raw_data, 12, 24); + } else { + $riff_data .= substr($raw_data, 16, 24); + } + if ($getid3->info['la']['footerstart'] < $getid3->info['avdataend']) { + fseek($getid3->fp, $getid3->info['la']['footerstart'], SEEK_SET); + $riff_data .= fread($getid3->fp, $getid3->info['avdataend'] - $getid3->info['la']['footerstart']); + } + $riff_data = 'RIFF'.getid3_lib::LittleEndian2String(strlen($riff_data), 4, false).$riff_data; + + // Clone getid3 - messing with offsets - better safe than sorry + $clone = clone $getid3; + + // Analyze clone by string + $riff = new getid3_riff($clone); + $riff->AnalyzeString($riff_data); + + // Import from clone and destroy + $getid3->info['riff'] = $clone->info['riff']; + $getid3->warnings($clone->warnings()); + unset($clone); + } + + // $getid3->info['avdataoffset'] should be zero to begin with, but just in case it's not, include the addition anyway + $getid3->info['avdataend'] = $getid3->info['avdataoffset'] + $getid3->info['la']['footerstart']; + $getid3->info['avdataoffset'] = $getid3->info['avdataoffset'] + $offset; + + $getid3->info['la']['compression_ratio'] = (float)(($getid3->info['avdataend'] - $getid3->info['avdataoffset']) / $getid3->info['la']['uncompressed_size']); + $getid3->info['playtime_seconds'] = (float)($getid3->info['la']['samples'] / $getid3->info['la']['sample_rate']) / $getid3->info['la']['channels']; + + $getid3->info['audio']['bitrate'] = ($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8 / $getid3->info['playtime_seconds']; + $getid3->info['audio']['bits_per_sample'] = $getid3->info['la']['bits_per_sample']; + + $getid3->info['audio']['channels'] = $getid3->info['la']['channels']; + $getid3->info['audio']['sample_rate'] = (int)$getid3->info['la']['sample_rate']; + $getid3->info['audio']['encoder'] = 'LA v'.$getid3->info['la']['version']; + + return true; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.lpac.php b/modules/getid3/module.audio.lpac.php new file mode 100644 index 00000000..dde8ba5a --- /dev/null +++ b/modules/getid3/module.audio.lpac.php @@ -0,0 +1,148 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.lpac.php | +// | Module for analyzing LPAC Audio files | +// | dependencies: module.audio-video.riff.php | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.lpac.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_lpac extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->include_module('audio-video.riff'); + + // Magic bytes - 'LPAC' + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $lpac_header = fread($getid3->fp, 14); + + $getid3->info['avdataoffset'] += 14; + + $getid3->info['lpac'] = array (); + $info_lpac = &$getid3->info['lpac']; + + $getid3->info['fileformat'] = 'lpac'; + $getid3->info['audio']['dataformat'] = 'lpac'; + $getid3->info['audio']['lossless'] = true; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + + $info_lpac['file_version'] = getid3_lib::BigEndian2Int($lpac_header{4}); + $flags['audio_type'] = getid3_lib::BigEndian2Int($lpac_header{5}); + $info_lpac['total_samples'] = getid3_lib::BigEndian2Int(substr($lpac_header, 6, 4)); + $flags['parameters'] = getid3_lib::BigEndian2Int(substr($lpac_header, 10, 4)); + + $info_lpac['flags']['is_wave'] = (bool)($flags['audio_type'] & 0x40); + $info_lpac['flags']['stereo'] = (bool)($flags['audio_type'] & 0x04); + $info_lpac['flags']['24_bit'] = (bool)($flags['audio_type'] & 0x02); + $info_lpac['flags']['16_bit'] = (bool)($flags['audio_type'] & 0x01); + + if ($info_lpac['flags']['24_bit'] && $info_lpac['flags']['16_bit']) { + $getid3->warning('24-bit and 16-bit flags cannot both be set'); + } + + $info_lpac['flags']['fast_compress'] = (bool)($flags['parameters'] & 0x40000000); + $info_lpac['flags']['random_access'] = (bool)($flags['parameters'] & 0x08000000); + $info_lpac['block_length'] = pow(2, (($flags['parameters'] & 0x07000000) >> 24)) * 256; + $info_lpac['flags']['adaptive_prediction_order'] = (bool)($flags['parameters'] & 0x00800000); + $info_lpac['flags']['adaptive_quantization'] = (bool)($flags['parameters'] & 0x00400000); + $info_lpac['flags']['joint_stereo'] = (bool)($flags['parameters'] & 0x00040000); + $info_lpac['quantization'] = ($flags['parameters'] & 0x00001F00) >> 8; + $info_lpac['max_prediction_order'] = ($flags['parameters'] & 0x0000003F); + + if ($info_lpac['flags']['fast_compress'] && ($info_lpac['max_prediction_order'] != 3)) { + $getid3->warning('max_prediction_order expected to be "3" if fast_compress is true, actual value is "'.$info_lpac['max_prediction_order'].'"'); + } + + switch ($info_lpac['file_version']) { + + case 6: + if ($info_lpac['flags']['adaptive_quantization']) { + $getid3->warning('adaptive_quantization expected to be false in LPAC file stucture v6, actually true'); + } + if ($info_lpac['quantization'] != 20) { + $getid3->warning('Quantization expected to be 20 in LPAC file stucture v6, actually '.$info_lpac['flags']['Q']); + } + break; + + + default: + //$getid3->warning('This version of getID3() only supports LPAC file format version 6, this file is version '.$info_lpac['file_version'].' - please report to info@getid3.org'); + break; + } + + // Clone getid3 - messing with something - better safe than sorry + $clone = clone $getid3; + + // Analyze clone by fp + $riff = new getid3_riff($clone); + $riff->Analyze(); + + // Import from clone and destroy + $getid3->info['avdataoffset'] = $clone->info['avdataoffset']; + $getid3->info['riff'] = $clone->info['riff']; + //$info_lpac['comments']['comment'] = $clone->info['comments']; + $getid3->info['audio']['sample_rate'] = $clone->info['audio']['sample_rate']; + $getid3->warnings($clone->warnings()); + unset($clone); + + $getid3->info['audio']['channels'] = ($info_lpac['flags']['stereo'] ? 2 : 1); + + if ($info_lpac['flags']['24_bit']) { + $getid3->info['audio']['bits_per_sample'] = $getid3->info['riff']['audio'][0]['bits_per_sample']; + } elseif ($info_lpac['flags']['16_bit']) { + $getid3->info['audio']['bits_per_sample'] = 16; + } else { + $getid3->info['audio']['bits_per_sample'] = 8; + } + + if ($info_lpac['flags']['fast_compress']) { + // fast + $getid3->info['audio']['encoder_options'] = '-1'; + } else { + switch ($info_lpac['max_prediction_order']) { + case 20: // simple + $getid3->info['audio']['encoder_options'] = '-2'; + break; + case 30: // medium + $getid3->info['audio']['encoder_options'] = '-3'; + break; + case 40: // high + $getid3->info['audio']['encoder_options'] = '-4'; + break; + case 60: // extrahigh + $getid3->info['audio']['encoder_options'] = '-5'; + break; + } + } + + $getid3->info['playtime_seconds'] = $info_lpac['total_samples'] / $getid3->info['audio']['sample_rate']; + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + + return true; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.midi.php b/modules/getid3/module.audio.midi.php new file mode 100644 index 00000000..bab8132f --- /dev/null +++ b/modules/getid3/module.audio.midi.php @@ -0,0 +1,552 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.midi.php | +// | Module for analyzing midi audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.midi.php,v 1.5 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_midi extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['midi']['raw'] = array (); + $info_midi = &$getid3->info['midi']; + $info_midi_raw = &$info_midi['raw']; + + $getid3->info['fileformat'] = 'midi'; + $getid3->info['audio']['dataformat'] = 'midi'; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $midi_data = fread($getid3->fp, getid3::FREAD_BUFFER_SIZE); + + // Magic bytes: 'MThd' + + getid3_lib::ReadSequence('BigEndian2Int', $info_midi_raw, $midi_data, 4, + array ( + 'headersize' => 4, + 'fileformat' => 2, + 'tracks' => 2, + 'ticksperqnote' => 2 + ) + ); + + $offset = 14; + + for ($i = 0; $i < $info_midi_raw['tracks']; $i++) { + + if ((strlen($midi_data) - $offset) < 8) { + $midi_data .= fread($getid3->fp, getid3::FREAD_BUFFER_SIZE); + } + + $track_id = substr($midi_data, $offset, 4); + $offset += 4; + + if ($track_id != 'MTrk') { + throw new getid3_exception('Expecting "MTrk" at '.$offset.', found '.$track_id.' instead'); + } + + $track_size = getid3_lib::BigEndian2Int(substr($midi_data, $offset, 4)); + $offset += 4; + + $track_data_array[$i] = substr($midi_data, $offset, $track_size); + $offset += $track_size; + } + + if (!isset($track_data_array) || !is_array($track_data_array)) { + throw new getid3_exception('Cannot find MIDI track information'); + } + + + $info_midi['totalticks'] = 0; + $getid3->info['playtime_seconds'] = 0; + $current_ms_per_beat = 500000; // 120 beats per minute; 60,000,000 microseconds per minute -> 500,000 microseconds per beat + $current_beats_per_min = 120; // 120 beats per minute; 60,000,000 microseconds per minute -> 500,000 microseconds per beat + $ms_per_quarter_note_after = array (); + + foreach ($track_data_array as $track_number => $track_data) { + + $events_offset = $last_issued_midi_command = $last_issued_midi_channel = $cumulative_delta_time = $ticks_at_current_bpm = 0; + + while ($events_offset < strlen($track_data)) { + + $event_id = 0; + if (isset($midi_events[$track_number]) && is_array($midi_events[$track_number])) { + $event_id = count($midi_events[$track_number]); + } + $delta_time = 0; + for ($i = 0; $i < 4; $i++) { + $delta_time_byte = ord($track_data{$events_offset++}); + $delta_time = ($delta_time << 7) + ($delta_time_byte & 0x7F); + if ($delta_time_byte & 0x80) { + // another byte follows + } else { + break; + } + } + + $cumulative_delta_time += $delta_time; + $ticks_at_current_bpm += $delta_time; + + $midi_events[$track_number][$event_id]['deltatime'] = $delta_time; + + $midi_event_channel = ord($track_data{$events_offset++}); + + // OK, normal event - MIDI command has MSB set + if ($midi_event_channel & 0x80) { + $last_issued_midi_command = $midi_event_channel >> 4; + $last_issued_midi_channel = $midi_event_channel & 0x0F; + } + + // Running event - assume last command + else { + $events_offset--; + } + + $midi_events[$track_number][$event_id]['eventid'] = $last_issued_midi_command; + $midi_events[$track_number][$event_id]['channel'] = $last_issued_midi_channel; + + switch ($midi_events[$track_number][$event_id]['eventid']) { + + case 0x8: // Note off (key is released) + case 0x9: // Note on (key is pressed) + case 0xA: // Key after-touch + + //$notenumber = ord($track_data{$events_offset++}); + //$velocity = ord($track_data{$events_offset++}); + $events_offset += 2; + break; + + + case 0xB: // Control Change + + //$controllernum = ord($track_data{$events_offset++}); + //$newvalue = ord($track_data{$events_offset++}); + $events_offset += 2; + break; + + + case 0xC: // Program (patch) change + + $new_program_num = ord($track_data{$events_offset++}); + + $info_midi_raw['track'][$track_number]['instrumentid'] = $new_program_num; + $info_midi_raw['track'][$track_number]['instrument'] = $track_number == 10 ? getid3_midi::GeneralMIDIpercussionLookup($new_program_num) : getid3_midi::GeneralMIDIinstrumentLookup($new_program_num); + break; + + + case 0xD: // Channel after-touch + + //$channelnumber = ord($track_data{$events_offset++}); + break; + + + case 0xE: // Pitch wheel change (2000H is normal or no change) + + //$changeLSB = ord($track_data{$events_offset++}); + //$changeMSB = ord($track_data{$events_offset++}); + //$pitchwheelchange = (($changeMSB & 0x7F) << 7) & ($changeLSB & 0x7F); + $events_offset += 2; + break; + + + case 0xF: + + if ($midi_events[$track_number][$event_id]['channel'] == 0xF) { + + $meta_event_command = ord($track_data{$events_offset++}); + $meta_event_length = ord($track_data{$events_offset++}); + $meta_event_data = substr($track_data, $events_offset, $meta_event_length); + $events_offset += $meta_event_length; + + switch ($meta_event_command) { + + case 0x00: // Set track sequence number + + //$track_sequence_number = getid3_lib::BigEndian2Int(substr($meta_event_data, 0, $meta_event_length)); + //$info_midi_raw['events'][$track_number][$event_id]['seqno'] = $track_sequence_number; + break; + + + case 0x01: // Text: generic + + $text_generic = substr($meta_event_data, 0, $meta_event_length); + //$info_midi_raw['events'][$track_number][$event_id]['text'] = $text_generic; + $info_midi['comments']['comment'][] = $text_generic; + break; + + + case 0x02: // Text: copyright + + $text_copyright = substr($meta_event_data, 0, $meta_event_length); + //$info_midi_raw['events'][$track_number][$event_id]['copyright'] = $text_copyright; + $info_midi['comments']['copyright'][] = $text_copyright; + break; + + + case 0x03: // Text: track name + + $text_trackname = substr($meta_event_data, 0, $meta_event_length); + $info_midi_raw['track'][$track_number]['name'] = $text_trackname; + break; + + + case 0x04: // Text: track instrument name + + //$text_instrument = substr($meta_event_data, 0, $meta_event_length); + //$info_midi_raw['events'][$track_number][$event_id]['instrument'] = $text_instrument; + break; + + + case 0x05: // Text: lyrics + + $text_lyrics = substr($meta_event_data, 0, $meta_event_length); + //$info_midi_raw['events'][$track_number][$event_id]['lyrics'] = $text_lyrics; + if (!isset($info_midi['lyrics'])) { + $info_midi['lyrics'] = ''; + } + $info_midi['lyrics'] .= $text_lyrics . "\n"; + break; + + + case 0x06: // Text: marker + + //$text_marker = substr($meta_event_data, 0, $meta_event_length); + //$info_midi_raw['events'][$track_number][$event_id]['marker'] = $text_marker; + break; + + + case 0x07: // Text: cue point + + //$text_cuepoint = substr($meta_event_data, 0, $meta_event_length); + //$info_midi_raw['events'][$track_number][$event_id]['cuepoint'] = $text_cuepoint; + break; + + + case 0x2F: // End Of Track + + //$info_midi_raw['events'][$track_number][$event_id]['EOT'] = $cumulative_delta_time; + break; + + + case 0x51: // Tempo: microseconds / quarter note + + $current_ms_per_beat = getid3_lib::BigEndian2Int(substr($meta_event_data, 0, $meta_event_length)); + $info_midi_raw['events'][$track_number][$cumulative_delta_time]['us_qnote'] = $current_ms_per_beat; + $current_beats_per_min = (1000000 / $current_ms_per_beat) * 60; + $ms_per_quarter_note_after[$cumulative_delta_time] = $current_ms_per_beat; + $ticks_at_current_bpm = 0; + break; + + + case 0x58: // Time signature + $timesig_numerator = getid3_lib::BigEndian2Int($meta_event_data[0]); + $timesig_denominator = pow(2, getid3_lib::BigEndian2Int($meta_event_data[1])); // $02 -> x/4, $03 -> x/8, etc + //$timesig_32inqnote = getid3_lib::BigEndian2Int($meta_event_data[2]); // number of 32nd notes to the quarter note + //$info_midi_raw['events'][$track_number][$event_id]['timesig_32inqnote'] = $timesig_32inqnote; + //$info_midi_raw['events'][$track_number][$event_id]['timesig_numerator'] = $timesig_numerator; + //$info_midi_raw['events'][$track_number][$event_id]['timesig_denominator'] = $timesig_denominator; + //$info_midi_raw['events'][$track_number][$event_id]['timesig_text'] = $timesig_numerator.'/'.$timesig_denominator; + $info_midi['timesignature'][] = $timesig_numerator.'/'.$timesig_denominator; + break; + + + case 0x59: // Keysignature + + $keysig_sharpsflats = getid3_lib::BigEndian2Int($meta_event_data{0}); + if ($keysig_sharpsflats & 0x80) { + // (-7 -> 7 flats, 0 ->key of C, 7 -> 7 sharps) + $keysig_sharpsflats -= 256; + } + + $keysig_majorminor = getid3_lib::BigEndian2Int($meta_event_data{1}); // 0 -> major, 1 -> minor + $keysigs = array (-7=>'Cb', -6=>'Gb', -5=>'Db', -4=>'Ab', -3=>'Eb', -2=>'Bb', -1=>'F', 0=>'C', 1=>'G', 2=>'D', 3=>'A', 4=>'E', 5=>'B', 6=>'F#', 7=>'C#'); + //$info_midi_raw['events'][$track_number][$event_id]['keysig_sharps'] = (($keysig_sharpsflats > 0) ? abs($keysig_sharpsflats) : 0); + //$info_midi_raw['events'][$track_number][$event_id]['keysig_flats'] = (($keysig_sharpsflats < 0) ? abs($keysig_sharpsflats) : 0); + //$info_midi_raw['events'][$track_number][$event_id]['keysig_minor'] = (bool)$keysig_majorminor; + //$info_midi_raw['events'][$track_number][$event_id]['keysig_text'] = $keysigs[$keysig_sharpsflats].' '.($info_midi_raw['events'][$track_number][$event_id]['keysig_minor'] ? 'minor' : 'major'); + + // $keysigs[$keysig_sharpsflats] gets an int key (correct) - $keysigs["$keysig_sharpsflats"] gets a string key (incorrect) + $info_midi['keysignature'][] = $keysigs[$keysig_sharpsflats].' '.((bool)$keysig_majorminor ? 'minor' : 'major'); + break; + + + case 0x7F: // Sequencer specific information + + $custom_data = substr($meta_event_data, 0, $meta_event_length); + break; + + + default: + + $getid3->warning('Unhandled META Event Command: '.$meta_event_command); + } + } + break; + + + default: + $getid3->warning('Unhandled MIDI Event ID: '.$midi_events[$track_number][$event_id]['eventid']); + } + } + + if (($track_number > 0) || (count($track_data_array) == 1)) { + $info_midi['totalticks'] = max($info_midi['totalticks'], $cumulative_delta_time); + } + } + + $previous_tick_offset = null; + + ksort($ms_per_quarter_note_after); + foreach ($ms_per_quarter_note_after as $tick_offset => $ms_per_beat) { + + if (is_null($previous_tick_offset)) { + $prev_ms_per_beat = $ms_per_beat; + $previous_tick_offset = $tick_offset; + continue; + } + + if ($info_midi['totalticks'] > $tick_offset) { + $getid3->info['playtime_seconds'] += (($tick_offset - $previous_tick_offset) / $info_midi_raw['ticksperqnote']) * ($prev_ms_per_beat / 1000000); + + $prev_ms_per_beat = $ms_per_beat; + $previous_tick_offset = $tick_offset; + } + } + + if ($info_midi['totalticks'] > $previous_tick_offset) { + $getid3->info['playtime_seconds'] += (($info_midi['totalticks'] - $previous_tick_offset) / $info_midi_raw['ticksperqnote']) * ($ms_per_beat / 1000000); + } + + if (@$getid3->info['playtime_seconds'] > 0) { + $getid3->info['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + } + + if (!empty($info_midi['lyrics'])) { + $info_midi['comments']['lyrics'][] = $info_midi['lyrics']; + } + + return true; + } + + + + public static function GeneralMIDIinstrumentLookup($instrument_id) { + + static $lookup = array ( + + 0 => 'Acoustic Grand', + 1 => 'Bright Acoustic', + 2 => 'Electric Grand', + 3 => 'Honky-Tonk', + 4 => 'Electric Piano 1', + 5 => 'Electric Piano 2', + 6 => 'Harpsichord', + 7 => 'Clavier', + 8 => 'Celesta', + 9 => 'Glockenspiel', + 10 => 'Music Box', + 11 => 'Vibraphone', + 12 => 'Marimba', + 13 => 'Xylophone', + 14 => 'Tubular Bells', + 15 => 'Dulcimer', + 16 => 'Drawbar Organ', + 17 => 'Percussive Organ', + 18 => 'Rock Organ', + 19 => 'Church Organ', + 20 => 'Reed Organ', + 21 => 'Accordian', + 22 => 'Harmonica', + 23 => 'Tango Accordian', + 24 => 'Acoustic Guitar (nylon)', + 25 => 'Acoustic Guitar (steel)', + 26 => 'Electric Guitar (jazz)', + 27 => 'Electric Guitar (clean)', + 28 => 'Electric Guitar (muted)', + 29 => 'Overdriven Guitar', + 30 => 'Distortion Guitar', + 31 => 'Guitar Harmonics', + 32 => 'Acoustic Bass', + 33 => 'Electric Bass (finger)', + 34 => 'Electric Bass (pick)', + 35 => 'Fretless Bass', + 36 => 'Slap Bass 1', + 37 => 'Slap Bass 2', + 38 => 'Synth Bass 1', + 39 => 'Synth Bass 2', + 40 => 'Violin', + 41 => 'Viola', + 42 => 'Cello', + 43 => 'Contrabass', + 44 => 'Tremolo Strings', + 45 => 'Pizzicato Strings', + 46 => 'Orchestral Strings', + 47 => 'Timpani', + 48 => 'String Ensemble 1', + 49 => 'String Ensemble 2', + 50 => 'SynthStrings 1', + 51 => 'SynthStrings 2', + 52 => 'Choir Aahs', + 53 => 'Voice Oohs', + 54 => 'Synth Voice', + 55 => 'Orchestra Hit', + 56 => 'Trumpet', + 57 => 'Trombone', + 58 => 'Tuba', + 59 => 'Muted Trumpet', + 60 => 'French Horn', + 61 => 'Brass Section', + 62 => 'SynthBrass 1', + 63 => 'SynthBrass 2', + 64 => 'Soprano Sax', + 65 => 'Alto Sax', + 66 => 'Tenor Sax', + 67 => 'Baritone Sax', + 68 => 'Oboe', + 69 => 'English Horn', + 70 => 'Bassoon', + 71 => 'Clarinet', + 72 => 'Piccolo', + 73 => 'Flute', + 74 => 'Recorder', + 75 => 'Pan Flute', + 76 => 'Blown Bottle', + 77 => 'Shakuhachi', + 78 => 'Whistle', + 79 => 'Ocarina', + 80 => 'Lead 1 (square)', + 81 => 'Lead 2 (sawtooth)', + 82 => 'Lead 3 (calliope)', + 83 => 'Lead 4 (chiff)', + 84 => 'Lead 5 (charang)', + 85 => 'Lead 6 (voice)', + 86 => 'Lead 7 (fifths)', + 87 => 'Lead 8 (bass + lead)', + 88 => 'Pad 1 (new age)', + 89 => 'Pad 2 (warm)', + 90 => 'Pad 3 (polysynth)', + 91 => 'Pad 4 (choir)', + 92 => 'Pad 5 (bowed)', + 93 => 'Pad 6 (metallic)', + 94 => 'Pad 7 (halo)', + 95 => 'Pad 8 (sweep)', + 96 => 'FX 1 (rain)', + 97 => 'FX 2 (soundtrack)', + 98 => 'FX 3 (crystal)', + 99 => 'FX 4 (atmosphere)', + 100 => 'FX 5 (brightness)', + 101 => 'FX 6 (goblins)', + 102 => 'FX 7 (echoes)', + 103 => 'FX 8 (sci-fi)', + 104 => 'Sitar', + 105 => 'Banjo', + 106 => 'Shamisen', + 107 => 'Koto', + 108 => 'Kalimba', + 109 => 'Bagpipe', + 110 => 'Fiddle', + 111 => 'Shanai', + 112 => 'Tinkle Bell', + 113 => 'Agogo', + 114 => 'Steel Drums', + 115 => 'Woodblock', + 116 => 'Taiko Drum', + 117 => 'Melodic Tom', + 118 => 'Synth Drum', + 119 => 'Reverse Cymbal', + 120 => 'Guitar Fret Noise', + 121 => 'Breath Noise', + 122 => 'Seashore', + 123 => 'Bird Tweet', + 124 => 'Telephone Ring', + 125 => 'Helicopter', + 126 => 'Applause', + 127 => 'Gunshot' + ); + + return @$lookup[$instrument_id]; + } + + + + public static function GeneralMIDIpercussionLookup($instrument_id) { + + static $lookup = array ( + + 35 => 'Acoustic Bass Drum', + 36 => 'Bass Drum 1', + 37 => 'Side Stick', + 38 => 'Acoustic Snare', + 39 => 'Hand Clap', + 40 => 'Electric Snare', + 41 => 'Low Floor Tom', + 42 => 'Closed Hi-Hat', + 43 => 'High Floor Tom', + 44 => 'Pedal Hi-Hat', + 45 => 'Low Tom', + 46 => 'Open Hi-Hat', + 47 => 'Low-Mid Tom', + 48 => 'Hi-Mid Tom', + 49 => 'Crash Cymbal 1', + 50 => 'High Tom', + 51 => 'Ride Cymbal 1', + 52 => 'Chinese Cymbal', + 53 => 'Ride Bell', + 54 => 'Tambourine', + 55 => 'Splash Cymbal', + 56 => 'Cowbell', + 57 => 'Crash Cymbal 2', + 59 => 'Ride Cymbal 2', + 60 => 'Hi Bongo', + 61 => 'Low Bongo', + 62 => 'Mute Hi Conga', + 63 => 'Open Hi Conga', + 64 => 'Low Conga', + 65 => 'High Timbale', + 66 => 'Low Timbale', + 67 => 'High Agogo', + 68 => 'Low Agogo', + 69 => 'Cabasa', + 70 => 'Maracas', + 71 => 'Short Whistle', + 72 => 'Long Whistle', + 73 => 'Short Guiro', + 74 => 'Long Guiro', + 75 => 'Claves', + 76 => 'Hi Wood Block', + 77 => 'Low Wood Block', + 78 => 'Mute Cuica', + 79 => 'Open Cuica', + 80 => 'Mute Triangle', + 81 => 'Open Triangle' + ); + + return @$lookup[$instrument_id]; + } + + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.monkey.php b/modules/getid3/module.audio.monkey.php new file mode 100644 index 00000000..4ea1d6fe --- /dev/null +++ b/modules/getid3/module.audio.monkey.php @@ -0,0 +1,216 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.monkey.php | +// | Module for analyzing Monkey's Audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.monkey.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_monkey extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + // based loosely on code from TMonkey by Jurgen Faul + // http://jfaul.de/atl or http://j-faul.virtualave.net/atl/atl.html + + $getid3->info['fileformat'] = 'mac'; + $getid3->info['audio']['dataformat'] = 'mac'; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + $getid3->info['audio']['lossless'] = true; + + $getid3->info['monkeys_audio']['raw'] = array (); + $info_monkeys_audio = &$getid3->info['monkeys_audio']; + $info_monkeys_audio_raw = &$info_monkeys_audio['raw']; + + // Read file header + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $mac_header_data = fread($getid3->fp, 74); + + $info_monkeys_audio_raw['magic'] = 'MAC '; // Magic bytes + + // Read MAC version + $info_monkeys_audio_raw['nVersion'] = getid3_lib::LittleEndian2Int(substr($mac_header_data, 4, 2)); // appears to be uint32 in 3.98+ + + // Parse MAC Header < v3980 + if ($info_monkeys_audio_raw['nVersion'] < 3980) { + + getid3_lib::ReadSequence("LittleEndian2Int", $info_monkeys_audio_raw, $mac_header_data, 6, + array ( + 'nCompressionLevel' => 2, + 'nFormatFlags' => 2, + 'nChannels' => 2, + 'nSampleRate' => 4, + 'nHeaderDataBytes' => 4, + 'nWAVTerminatingBytes' => 4, + 'nTotalFrames' => 4, + 'nFinalFrameSamples' => 4, + 'nPeakLevel' => 4, + 'IGNORE-1' => 2, + 'nSeekElements' => 2 + ) + ); + } + + // Parse MAC Header >= v3980 + else { + + getid3_lib::ReadSequence("LittleEndian2Int", $info_monkeys_audio_raw, $mac_header_data, 8, + array ( + // APE_DESCRIPTOR + 'nDescriptorBytes' => 4, + 'nHeaderBytes' => 4, + 'nSeekTableBytes' => 4, + 'nHeaderDataBytes' => 4, + 'nAPEFrameDataBytes' => 4, + 'nAPEFrameDataBytesHigh'=> 4, + 'nTerminatingDataBytes' => 4, + + // MD5 - string + 'cFileMD5' => -16, + + // APE_HEADER + 'nCompressionLevel' => 2, + 'nFormatFlags' => 2, + 'nBlocksPerFrame' => 4, + 'nFinalFrameBlocks' => 4, + 'nTotalFrames' => 4, + 'nBitsPerSample' => 2, + 'nChannels' => 2, + 'nSampleRate' => 4 + ) + ); + } + + // Process data + $info_monkeys_audio['flags']['8-bit'] = (bool)($info_monkeys_audio_raw['nFormatFlags'] & 0x0001); + $info_monkeys_audio['flags']['crc-32'] = (bool)($info_monkeys_audio_raw['nFormatFlags'] & 0x0002); + $info_monkeys_audio['flags']['peak_level'] = (bool)($info_monkeys_audio_raw['nFormatFlags'] & 0x0004); + $info_monkeys_audio['flags']['24-bit'] = (bool)($info_monkeys_audio_raw['nFormatFlags'] & 0x0008); + $info_monkeys_audio['flags']['seek_elements'] = (bool)($info_monkeys_audio_raw['nFormatFlags'] & 0x0010); + $info_monkeys_audio['flags']['no_wav_header'] = (bool)($info_monkeys_audio_raw['nFormatFlags'] & 0x0020); + + $info_monkeys_audio['version'] = $info_monkeys_audio_raw['nVersion'] / 1000; + + $info_monkeys_audio['compression'] = getid3_monkey::MonkeyCompressionLevelNameLookup($info_monkeys_audio_raw['nCompressionLevel']); + + $info_monkeys_audio['bits_per_sample'] = ($info_monkeys_audio['flags']['24-bit'] ? 24 : ($info_monkeys_audio['flags']['8-bit'] ? 8 : 16)); + + $info_monkeys_audio['channels'] = $info_monkeys_audio_raw['nChannels']; + + $getid3->info['audio']['channels'] = $info_monkeys_audio['channels']; + + $info_monkeys_audio['sample_rate'] = $info_monkeys_audio_raw['nSampleRate']; + + $getid3->info['audio']['sample_rate'] = $info_monkeys_audio['sample_rate']; + + if ($info_monkeys_audio['flags']['peak_level']) { + $info_monkeys_audio['peak_level'] = $info_monkeys_audio_raw['nPeakLevel']; + $info_monkeys_audio['peak_ratio'] = $info_monkeys_audio['peak_level'] / pow(2, $info_monkeys_audio['bits_per_sample'] - 1); + } + + // MAC >= v3980 + if ($info_monkeys_audio_raw['nVersion'] >= 3980) { + $info_monkeys_audio['samples'] = (($info_monkeys_audio_raw['nTotalFrames'] - 1) * $info_monkeys_audio_raw['nBlocksPerFrame']) + $info_monkeys_audio_raw['nFinalFrameBlocks']; + } + + // MAC < v3980 + else { + $info_monkeys_audio['samples_per_frame'] = getid3_monkey::MonkeySamplesPerFrame($info_monkeys_audio_raw['nVersion'], $info_monkeys_audio_raw['nCompressionLevel']); + $info_monkeys_audio['samples'] = (($info_monkeys_audio_raw['nTotalFrames'] - 1) * $info_monkeys_audio['samples_per_frame']) + $info_monkeys_audio_raw['nFinalFrameSamples']; + } + + $info_monkeys_audio['playtime'] = $info_monkeys_audio['samples'] / $info_monkeys_audio['sample_rate']; + + $getid3->info['playtime_seconds'] = $info_monkeys_audio['playtime']; + + $info_monkeys_audio['compressed_size'] = $getid3->info['avdataend'] - $getid3->info['avdataoffset']; + $info_monkeys_audio['uncompressed_size'] = $info_monkeys_audio['samples'] * $info_monkeys_audio['channels'] * ($info_monkeys_audio['bits_per_sample'] / 8); + $info_monkeys_audio['compression_ratio'] = $info_monkeys_audio['compressed_size'] / ($info_monkeys_audio['uncompressed_size'] + $info_monkeys_audio_raw['nHeaderDataBytes']); + $info_monkeys_audio['bitrate'] = (($info_monkeys_audio['samples'] * $info_monkeys_audio['channels'] * $info_monkeys_audio['bits_per_sample']) / $info_monkeys_audio['playtime']) * $info_monkeys_audio['compression_ratio']; + + $getid3->info['audio']['bitrate'] = $info_monkeys_audio['bitrate']; + + $getid3->info['audio']['bits_per_sample'] = $info_monkeys_audio['bits_per_sample']; + $getid3->info['audio']['encoder'] = 'MAC v'.number_format($info_monkeys_audio['version'], 2); + $getid3->info['audio']['encoder_options'] = ucfirst($info_monkeys_audio['compression']).' compression'; + + // MAC >= v3980 - get avdataoffsets from MAC header + if ($info_monkeys_audio_raw['nVersion'] >= 3980) { + $getid3->info['avdataoffset'] += $info_monkeys_audio_raw['nDescriptorBytes'] + $info_monkeys_audio_raw['nHeaderBytes'] + $info_monkeys_audio_raw['nSeekTableBytes'] + $info_monkeys_audio_raw['nHeaderDataBytes']; + $getid3->info['avdataend'] -= $info_monkeys_audio_raw['nTerminatingDataBytes']; + } + + // MAC < v3980 Add size of MAC header to avdataoffset + else { + $getid3->info['avdataoffset'] += 8; + } + + // Convert md5sum to 32 byte string + if (@$info_monkeys_audio_raw['cFileMD5']) { + if ($info_monkeys_audio_raw['cFileMD5'] !== str_repeat("\x00", 16)) { + $getid3->info['md5_data_source'] = ''; + $md5 = $info_monkeys_audio_raw['cFileMD5']; + for ($i = 0; $i < strlen($md5); $i++) { + $getid3->info['md5_data_source'] .= str_pad(dechex(ord($md5{$i})), 2, '00', STR_PAD_LEFT); + } + if (!preg_match('/^[0-9a-f]{32}$/', $getid3->info['md5_data_source'])) { + unset($getid3->info['md5_data_source']); + } + } + } + + + return true; + } + + + + public static function MonkeyCompressionLevelNameLookup($compression_level) { + + static $lookup = array ( + 0 => 'unknown', + 1000 => 'fast', + 2000 => 'normal', + 3000 => 'high', + 4000 => 'extra-high', + 5000 => 'insane' + ); + return (isset($lookup[$compression_level]) ? $lookup[$compression_level] : 'invalid'); + } + + + + public static function MonkeySamplesPerFrame($version_id, $compression_level) { + + if ($version_id >= 3950) { + return 73728 * 4; + } + if (($version_id >= 3900) || (($version_id >= 3800) && ($compression_level == 4000))) { + return 73728; + } + return 9216; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.mp3.php b/modules/getid3/module.audio.mp3.php new file mode 100644 index 00000000..2a229399 --- /dev/null +++ b/modules/getid3/module.audio.mp3.php @@ -0,0 +1,1696 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.mp3.php | +// | Module for analyzing MPEG Audio Layer 1,2,3 files. | +// | dependencies: none | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.mp3.php,v 1.10 2006/11/16 22:57:57 ah Exp $ + + + +class getid3_mp3 extends getid3_handler +{ + // Number of frames to scan to determine if MPEG-audio sequence is valid. + // Lower this number to 5-20 for faster scanning + // Increase this number to 50+ for most accurate detection of valid VBR/CBR mpeg-audio streams + const VALID_CHECK_FRAMES = 35; + + + public function Analyze() { + + $this->getAllMPEGInfo($this->getid3->fp, $this->getid3->info); + + return true; + } + + + public function AnalyzeMPEGaudioInfo() { + + $this->getOnlyMPEGaudioInfo($this->getid3->fp, $this->getid3->info, $this->getid3->info['avdataoffset'], false); + } + + + public function getAllMPEGInfo(&$fd, &$info) { + + $this->getOnlyMPEGaudioInfo($fd, $info, 0 + $info['avdataoffset']); + + if (isset($info['mpeg']['audio']['bitrate_mode'])) { + $info['audio']['bitrate_mode'] = strtolower($info['mpeg']['audio']['bitrate_mode']); + } + + if (((isset($info['id3v2']['headerlength']) && ($info['avdataoffset'] > $info['id3v2']['headerlength'])) || (!isset($info['id3v2']) && ($info['avdataoffset'] > 0)))) { + + $synch_offset_warning = 'Unknown data before synch '; + if (isset($info['id3v2']['headerlength'])) { + $synch_offset_warning .= '(ID3v2 header ends at '.$info['id3v2']['headerlength'].', then '.($info['avdataoffset'] - $info['id3v2']['headerlength']).' bytes garbage, '; + } else { + $synch_offset_warning .= '(should be at beginning of file, '; + } + $synch_offset_warning .= 'synch detected at '.$info['avdataoffset'].')'; + if ($info['audio']['bitrate_mode'] == 'cbr') { + + if (!empty($info['id3v2']['headerlength']) && (($info['avdataoffset'] - $info['id3v2']['headerlength']) == $info['mpeg']['audio']['framelength'])) { + + $synch_offset_warning .= '. This is a known problem with some versions of LAME (3.90-3.92) DLL in CBR mode.'; + $info['audio']['codec'] = 'LAME'; + $current_data_lame_version_string = 'LAME3.'; + + } elseif (empty($info['id3v2']['headerlength']) && ($info['avdataoffset'] == $info['mpeg']['audio']['framelength'])) { + + $synch_offset_warning .= '. This is a known problem with some versions of LAME (3.90 - 3.92) DLL in CBR mode.'; + $info['audio']['codec'] = 'LAME'; + $current_data_lame_version_string = 'LAME3.'; + + } + + } + $this->getid3->warning($synch_offset_warning); + + } + + if (isset($info['mpeg']['audio']['LAME'])) { + $info['audio']['codec'] = 'LAME'; + if (!empty($info['mpeg']['audio']['LAME']['long_version'])) { + $info['audio']['encoder'] = rtrim($info['mpeg']['audio']['LAME']['long_version'], "\x00"); + } elseif (!empty($info['mpeg']['audio']['LAME']['short_version'])) { + $info['audio']['encoder'] = rtrim($info['mpeg']['audio']['LAME']['short_version'], "\x00"); + } + } + + $current_data_lame_version_string = (!empty($current_data_lame_version_string) ? $current_data_lame_version_string : @$info['audio']['encoder']); + if (!empty($current_data_lame_version_string) && (substr($current_data_lame_version_string, 0, 6) == 'LAME3.') && !preg_match('[0-9\)]', substr($current_data_lame_version_string, -1))) { + // a version number of LAME that does not end with a number like "LAME3.92" + // or with a closing parenthesis like "LAME3.88 (alpha)" + // or a version of LAME with the LAMEtag-not-filled-in-DLL-mode bug (3.90-3.92) + + // not sure what the actual last frame length will be, but will be less than or equal to 1441 + $possibly_longer_lame_version_frame_length = 1441; + + // Not sure what version of LAME this is - look in padding of last frame for longer version string + $possible_lame_version_string_offset = $info['avdataend'] - $possibly_longer_lame_version_frame_length; + fseek($fd, $possible_lame_version_string_offset); + $possibly_longer_lame_version_data = fread($fd, $possibly_longer_lame_version_frame_length); + switch (substr($current_data_lame_version_string, -1)) { + case 'a': + case 'b': + // "LAME3.94a" will have a longer version string of "LAME3.94 (alpha)" for example + // need to trim off "a" to match longer string + $current_data_lame_version_string = substr($current_data_lame_version_string, 0, -1); + break; + } + if (($possibly_longer_lame_version_string = strstr($possibly_longer_lame_version_data, $current_data_lame_version_string)) !== false) { + if (substr($possibly_longer_lame_version_string, 0, strlen($current_data_lame_version_string)) == $current_data_lame_version_string) { + $possibly_longer_lame_version_new_string = substr($possibly_longer_lame_version_string, 0, strspn($possibly_longer_lame_version_string, 'LAME0123456789., (abcdefghijklmnopqrstuvwxyzJFSOND)')); //"LAME3.90.3" "LAME3.87 (beta 1, Sep 27 2000)" "LAME3.88 (beta)" + if (strlen($possibly_longer_lame_version_new_string) > strlen(@$info['audio']['encoder'])) { + $info['audio']['encoder'] = $possibly_longer_lame_version_new_string; + } + } + } + } + if (!empty($info['audio']['encoder'])) { + $info['audio']['encoder'] = rtrim($info['audio']['encoder'], "\x00 "); + } + + switch (@$info['mpeg']['audio']['layer']) { + case 1: + case 2: + $info['audio']['dataformat'] = 'mp'.$info['mpeg']['audio']['layer']; + break; + } + if (@$info['fileformat'] == 'mp3') { + switch ($info['audio']['dataformat']) { + case 'mp1': + case 'mp2': + case 'mp3': + $info['fileformat'] = $info['audio']['dataformat']; + break; + + default: + $this->getid3->warning('Expecting [audio][dataformat] to be mp1/mp2/mp3 when fileformat == mp3, [audio][dataformat] actually "'.$info['audio']['dataformat'].'"'); + break; + } + } + + $info['mime_type'] = 'audio/mpeg'; + $info['audio']['lossless'] = false; + + // Calculate playtime + if (!isset($info['playtime_seconds']) && isset($info['audio']['bitrate']) && ($info['audio']['bitrate'] > 0)) { + $info['playtime_seconds'] = ($info['avdataend'] - $info['avdataoffset']) * 8 / $info['audio']['bitrate']; + } + + $info['audio']['encoder_options'] = getid3_mp3::GuessEncoderOptions($info); + + return true; + } + + + + public static function GuessEncoderOptions(&$info) { + // shortcuts + if (!empty($info['mpeg']['audio'])) { + $thisfile_mpeg_audio = &$info['mpeg']['audio']; + if (!empty($thisfile_mpeg_audio['LAME'])) { + $thisfile_mpeg_audio_lame = &$thisfile_mpeg_audio['LAME']; + } + } + + $encoder_options = ''; + static $named_preset_bitrates = array (16, 24, 40, 56, 112, 128, 160, 192, 256); + + if ((@$thisfile_mpeg_audio['VBR_method'] == 'Fraunhofer') && !empty($thisfile_mpeg_audio['VBR_quality'])) { + + $encoder_options = 'VBR q'.$thisfile_mpeg_audio['VBR_quality']; + + } elseif (!empty($thisfile_mpeg_audio_lame['preset_used']) && (!in_array($thisfile_mpeg_audio_lame['preset_used_id'], $named_preset_bitrates))) { + + $encoder_options = $thisfile_mpeg_audio_lame['preset_used']; + + } elseif (!empty($thisfile_mpeg_audio_lame['vbr_quality'])) { + + static $known_encoder_values = array (); + if (empty($known_encoder_values)) { + + //$known_encoder_values[abrbitrate_minbitrate][vbr_quality][raw_vbr_method][raw_noise_shaping][raw_stereo_mode][ath_type][lowpass_frequency] = 'preset name'; + $known_encoder_values[0xFF][58][1][1][3][2][20500] = '--alt-preset insane'; // 3.90, 3.90.1, 3.92 + $known_encoder_values[0xFF][58][1][1][3][2][20600] = '--alt-preset insane'; // 3.90.2, 3.90.3, 3.91 + $known_encoder_values[0xFF][57][1][1][3][4][20500] = '--alt-preset insane'; // 3.94, 3.95 + $known_encoder_values['**'][78][3][2][3][2][19500] = '--alt-preset extreme'; // 3.90, 3.90.1, 3.92 + $known_encoder_values['**'][78][3][2][3][2][19600] = '--alt-preset extreme'; // 3.90.2, 3.91 + $known_encoder_values['**'][78][3][1][3][2][19600] = '--alt-preset extreme'; // 3.90.3 + $known_encoder_values['**'][78][4][2][3][2][19500] = '--alt-preset fast extreme'; // 3.90, 3.90.1, 3.92 + $known_encoder_values['**'][78][4][2][3][2][19600] = '--alt-preset fast extreme'; // 3.90.2, 3.90.3, 3.91 + $known_encoder_values['**'][78][3][2][3][4][19000] = '--alt-preset standard'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values['**'][78][3][1][3][4][19000] = '--alt-preset standard'; // 3.90.3 + $known_encoder_values['**'][78][4][2][3][4][19000] = '--alt-preset fast standard'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values['**'][78][4][1][3][4][19000] = '--alt-preset fast standard'; // 3.90.3 + $known_encoder_values['**'][88][4][1][3][3][19500] = '--r3mix'; // 3.90, 3.90.1, 3.92 + $known_encoder_values['**'][88][4][1][3][3][19600] = '--r3mix'; // 3.90.2, 3.90.3, 3.91 + $known_encoder_values['**'][67][4][1][3][4][18000] = '--r3mix'; // 3.94, 3.95 + $known_encoder_values['**'][68][3][2][3][4][18000] = '--alt-preset medium'; // 3.90.3 + $known_encoder_values['**'][68][4][2][3][4][18000] = '--alt-preset fast medium'; // 3.90.3 + + $known_encoder_values[0xFF][99][1][1][1][2][0] = '--preset studio'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values[0xFF][58][2][1][3][2][20600] = '--preset studio'; // 3.90.3, 3.93.1 + $known_encoder_values[0xFF][58][2][1][3][2][20500] = '--preset studio'; // 3.93 + $known_encoder_values[0xFF][57][2][1][3][4][20500] = '--preset studio'; // 3.94, 3.95 + $known_encoder_values[0xC0][88][1][1][1][2][0] = '--preset cd'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values[0xC0][58][2][2][3][2][19600] = '--preset cd'; // 3.90.3, 3.93.1 + $known_encoder_values[0xC0][58][2][2][3][2][19500] = '--preset cd'; // 3.93 + $known_encoder_values[0xC0][57][2][1][3][4][19500] = '--preset cd'; // 3.94, 3.95 + $known_encoder_values[0xA0][78][1][1][3][2][18000] = '--preset hifi'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values[0xA0][58][2][2][3][2][18000] = '--preset hifi'; // 3.90.3, 3.93, 3.93.1 + $known_encoder_values[0xA0][57][2][1][3][4][18000] = '--preset hifi'; // 3.94, 3.95 + $known_encoder_values[0x80][67][1][1][3][2][18000] = '--preset tape'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values[0x80][67][1][1][3][2][15000] = '--preset radio'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values[0x70][67][1][1][3][2][15000] = '--preset fm'; // 3.90, 3.90.1, 3.90.2, 3.91, 3.92 + $known_encoder_values[0x70][58][2][2][3][2][16000] = '--preset tape/radio/fm'; // 3.90.3, 3.93, 3.93.1 + $known_encoder_values[0x70][57][2][1][3][4][16000] = '--preset tape/radio/fm'; // 3.94, 3.95 + $known_encoder_values[0x38][58][2][2][0][2][10000] = '--preset voice'; // 3.90.3, 3.93, 3.93.1 + $known_encoder_values[0x38][57][2][1][0][4][15000] = '--preset voice'; // 3.94, 3.95 + $known_encoder_values[0x38][57][2][1][0][4][16000] = '--preset voice'; // 3.94a14 + $known_encoder_values[0x28][65][1][1][0][2][7500] = '--preset mw-us'; // 3.90, 3.90.1, 3.92 + $known_encoder_values[0x28][65][1][1][0][2][7600] = '--preset mw-us'; // 3.90.2, 3.91 + $known_encoder_values[0x28][58][2][2][0][2][7000] = '--preset mw-us'; // 3.90.3, 3.93, 3.93.1 + $known_encoder_values[0x28][57][2][1][0][4][10500] = '--preset mw-us'; // 3.94, 3.95 + $known_encoder_values[0x28][57][2][1][0][4][11200] = '--preset mw-us'; // 3.94a14 + $known_encoder_values[0x28][57][2][1][0][4][8800] = '--preset mw-us'; // 3.94a15 + $known_encoder_values[0x18][58][2][2][0][2][4000] = '--preset phon+/lw/mw-eu/sw'; // 3.90.3, 3.93.1 + $known_encoder_values[0x18][58][2][2][0][2][3900] = '--preset phon+/lw/mw-eu/sw'; // 3.93 + $known_encoder_values[0x18][57][2][1][0][4][5900] = '--preset phon+/lw/mw-eu/sw'; // 3.94, 3.95 + $known_encoder_values[0x18][57][2][1][0][4][6200] = '--preset phon+/lw/mw-eu/sw'; // 3.94a14 + $known_encoder_values[0x18][57][2][1][0][4][3200] = '--preset phon+/lw/mw-eu/sw'; // 3.94a15 + $known_encoder_values[0x10][58][2][2][0][2][3800] = '--preset phone'; // 3.90.3, 3.93.1 + $known_encoder_values[0x10][58][2][2][0][2][3700] = '--preset phone'; // 3.93 + $known_encoder_values[0x10][57][2][1][0][4][5600] = '--preset phone'; // 3.94, 3.95 + } + + if (isset($known_encoder_values[$thisfile_mpeg_audio_lame['raw']['abrbitrate_minbitrate']][$thisfile_mpeg_audio_lame['vbr_quality']][$thisfile_mpeg_audio_lame['raw']['vbr_method']][$thisfile_mpeg_audio_lame['raw']['noise_shaping']][$thisfile_mpeg_audio_lame['raw']['stereo_mode']][$thisfile_mpeg_audio_lame['ath_type']][$thisfile_mpeg_audio_lame['lowpass_frequency']])) { + + $encoder_options = $known_encoder_values[$thisfile_mpeg_audio_lame['raw']['abrbitrate_minbitrate']][$thisfile_mpeg_audio_lame['vbr_quality']][$thisfile_mpeg_audio_lame['raw']['vbr_method']][$thisfile_mpeg_audio_lame['raw']['noise_shaping']][$thisfile_mpeg_audio_lame['raw']['stereo_mode']][$thisfile_mpeg_audio_lame['ath_type']][$thisfile_mpeg_audio_lame['lowpass_frequency']]; + + } elseif (isset($known_encoder_values['**'][$thisfile_mpeg_audio_lame['vbr_quality']][$thisfile_mpeg_audio_lame['raw']['vbr_method']][$thisfile_mpeg_audio_lame['raw']['noise_shaping']][$thisfile_mpeg_audio_lame['raw']['stereo_mode']][$thisfile_mpeg_audio_lame['ath_type']][$thisfile_mpeg_audio_lame['lowpass_frequency']])) { + + $encoder_options = $known_encoder_values['**'][$thisfile_mpeg_audio_lame['vbr_quality']][$thisfile_mpeg_audio_lame['raw']['vbr_method']][$thisfile_mpeg_audio_lame['raw']['noise_shaping']][$thisfile_mpeg_audio_lame['raw']['stereo_mode']][$thisfile_mpeg_audio_lame['ath_type']][$thisfile_mpeg_audio_lame['lowpass_frequency']]; + + } elseif ($info['audio']['bitrate_mode'] == 'vbr') { + + // http://gabriel.mp3-tech.org/mp3infotag.html + // int Quality = (100 - 10 * gfp->VBR_q - gfp->quality)h + + + $lame_v_value = 10 - ceil($thisfile_mpeg_audio_lame['vbr_quality'] / 10); + $lame_q_value = 100 - $thisfile_mpeg_audio_lame['vbr_quality'] - ($lame_v_value * 10); + $encoder_options = '-V'.$lame_v_value.' -q'.$lame_q_value; + + } elseif ($info['audio']['bitrate_mode'] == 'cbr') { + + $encoder_options = strtoupper($info['audio']['bitrate_mode']).ceil($info['audio']['bitrate'] / 1000); + + } else { + + $encoder_options = strtoupper($info['audio']['bitrate_mode']); + + } + + } elseif (!empty($thisfile_mpeg_audio_lame['bitrate_abr'])) { + + $encoder_options = 'ABR'.$thisfile_mpeg_audio_lame['bitrate_abr']; + + } elseif (!empty($info['audio']['bitrate'])) { + + if ($info['audio']['bitrate_mode'] == 'cbr') { + $encoder_options = strtoupper($info['audio']['bitrate_mode']).ceil($info['audio']['bitrate'] / 1000); + } else { + $encoder_options = strtoupper($info['audio']['bitrate_mode']); + } + + } + if (!empty($thisfile_mpeg_audio_lame['bitrate_min'])) { + $encoder_options .= ' -b'.$thisfile_mpeg_audio_lame['bitrate_min']; + } + + if (@$thisfile_mpeg_audio_lame['encoding_flags']['nogap_prev'] || @$thisfile_mpeg_audio_lame['encoding_flags']['nogap_next']) { + $encoder_options .= ' --nogap'; + } + + if (!empty($thisfile_mpeg_audio_lame['lowpass_frequency'])) { + $exploded_options = explode(' ', $encoder_options, 4); + if ($exploded_options[0] == '--r3mix') { + $exploded_options[1] = 'r3mix'; + } + switch ($exploded_options[0]) { + case '--preset': + case '--alt-preset': + case '--r3mix': + if ($exploded_options[1] == 'fast') { + $exploded_options[1] .= ' '.$exploded_options[2]; + } + switch ($exploded_options[1]) { + case 'portable': + case 'medium': + case 'standard': + case 'extreme': + case 'insane': + case 'fast portable': + case 'fast medium': + case 'fast standard': + case 'fast extreme': + case 'fast insane': + case 'r3mix': + static $expected_lowpass = array ( + 'insane|20500' => 20500, + 'insane|20600' => 20600, // 3.90.2, 3.90.3, 3.91 + 'medium|18000' => 18000, + 'fast medium|18000' => 18000, + 'extreme|19500' => 19500, // 3.90, 3.90.1, 3.92, 3.95 + 'extreme|19600' => 19600, // 3.90.2, 3.90.3, 3.91, 3.93.1 + 'fast extreme|19500' => 19500, // 3.90, 3.90.1, 3.92, 3.95 + 'fast extreme|19600' => 19600, // 3.90.2, 3.90.3, 3.91, 3.93.1 + 'standard|19000' => 19000, + 'fast standard|19000' => 19000, + 'r3mix|19500' => 19500, // 3.90, 3.90.1, 3.92 + 'r3mix|19600' => 19600, // 3.90.2, 3.90.3, 3.91 + 'r3mix|18000' => 18000, // 3.94, 3.95 + ); + if (!isset($expected_lowpass[$exploded_options[1].'|'.$thisfile_mpeg_audio_lame['lowpass_frequency']]) && ($thisfile_mpeg_audio_lame['lowpass_frequency'] < 22050) && (round($thisfile_mpeg_audio_lame['lowpass_frequency'] / 1000) < round($thisfile_mpeg_audio['sample_rate'] / 2000))) { + $encoder_options .= ' --lowpass '.$thisfile_mpeg_audio_lame['lowpass_frequency']; + } + break; + + default: + break; + } + break; + } + } + + if (isset($thisfile_mpeg_audio_lame['raw']['source_sample_freq'])) { + if (($thisfile_mpeg_audio['sample_rate'] == 44100) && ($thisfile_mpeg_audio_lame['raw']['source_sample_freq'] != 1)) { + $encoder_options .= ' --resample 44100'; + } elseif (($thisfile_mpeg_audio['sample_rate'] == 48000) && ($thisfile_mpeg_audio_lame['raw']['source_sample_freq'] != 2)) { + $encoder_options .= ' --resample 48000'; + } elseif ($thisfile_mpeg_audio['sample_rate'] < 44100) { + switch ($thisfile_mpeg_audio_lame['raw']['source_sample_freq']) { + case 0: // <= 32000 + // may or may not be same as source frequency - ignore + break; + case 1: // 44100 + case 2: // 48000 + case 3: // 48000+ + $exploded_options = explode(' ', $encoder_options, 4); + switch ($exploded_options[0]) { + case '--preset': + case '--alt-preset': + switch ($exploded_options[1]) { + case 'fast': + case 'portable': + case 'medium': + case 'standard': + case 'extreme': + case 'insane': + $encoder_options .= ' --resample '.$thisfile_mpeg_audio['sample_rate']; + break; + + default: + static $expected_resampled_rate = array ( + 'phon+/lw/mw-eu/sw|16000' => 16000, + 'mw-us|24000' => 24000, // 3.95 + 'mw-us|32000' => 32000, // 3.93 + 'mw-us|16000' => 16000, // 3.92 + 'phone|16000' => 16000, + 'phone|11025' => 11025, // 3.94a15 + 'radio|32000' => 32000, // 3.94a15 + 'fm/radio|32000' => 32000, // 3.92 + 'fm|32000' => 32000, // 3.90 + 'voice|32000' => 32000); + if (!isset($expected_resampled_rate[$exploded_options[1].'|'.$thisfile_mpeg_audio['sample_rate']])) { + $encoder_options .= ' --resample '.$thisfile_mpeg_audio['sample_rate']; + } + break; + } + break; + + case '--r3mix': + default: + $encoder_options .= ' --resample '.$thisfile_mpeg_audio['sample_rate']; + break; + } + break; + } + } + } + if (empty($encoder_options) && !empty($info['audio']['bitrate']) && !empty($info['audio']['bitrate_mode'])) { + //$encoder_options = strtoupper($info['audio']['bitrate_mode']).ceil($info['audio']['bitrate'] / 1000); + $encoder_options = strtoupper($info['audio']['bitrate_mode']); + } + + return $encoder_options; + } + + + + public function decodeMPEGaudioHeader($fd, $offset, &$info, $recursive_search=true, $scan_as_cbr=false, $fast_mpeg_header_scan=false) { + + static $mpeg_audio_version_lookup; + static $mpeg_audio_layer_lookup; + static $mpeg_audio_bitrate_lookup; + static $mpeg_audio_frequency_lookup; + static $mpeg_audio_channel_mode_lookup; + static $mpeg_audio_mode_extension_lookup; + static $mpeg_audio_emphasis_lookup; + if (empty($mpeg_audio_version_lookup)) { + $mpeg_audio_version_lookup = getid3_mp3::MPEGaudioVersionarray(); + $mpeg_audio_layer_lookup = getid3_mp3::MPEGaudioLayerarray(); + $mpeg_audio_bitrate_lookup = getid3_mp3::MPEGaudioBitratearray(); + $mpeg_audio_frequency_lookup = getid3_mp3::MPEGaudioFrequencyarray(); + $mpeg_audio_channel_mode_lookup = getid3_mp3::MPEGaudioChannelModearray(); + $mpeg_audio_mode_extension_lookup = getid3_mp3::MPEGaudioModeExtensionarray(); + $mpeg_audio_emphasis_lookup = getid3_mp3::MPEGaudioEmphasisarray(); + } + + if ($offset >= $info['avdataend']) { + + // non-fatal error: 'end of file encounter looking for MPEG synch' + return; + + } + fseek($fd, $offset, SEEK_SET); + $header_string = fread($fd, 226); // LAME header at offset 36 + 190 bytes of Xing/LAME data + + // MP3 audio frame structure: + // $aa $aa $aa $aa [$bb $bb] $cc... + // where $aa..$aa is the four-byte mpeg-audio header (below) + // $bb $bb is the optional 2-byte CRC + // and $cc... is the audio data + + $head4 = substr($header_string, 0, 4); + + if (isset($mpeg_audio_header_decode_cache[$head4])) { + $mpeg_header_raw_array= $mpeg_audio_header_decode_cache[$head4]; + } else { + $mpeg_header_raw_array = getid3_mp3::MPEGaudioHeaderDecode($head4); + $mpeg_audio_header_decode_cache[$head4] = $mpeg_header_raw_array; + } + + // Not in cache + if (!isset($mpeg_audio_header_valid_cache[$head4])) { + $mpeg_audio_header_valid_cache[$head4] = getid3_mp3::MPEGaudioHeaderValid($mpeg_header_raw_array, false, false); + } + + // shortcut + if (!isset($info['mpeg']['audio'])) { + $info['mpeg']['audio'] = array (); + } + $thisfile_mpeg_audio = &$info['mpeg']['audio']; + + + if ($mpeg_audio_header_valid_cache[$head4]) { + $thisfile_mpeg_audio['raw'] = $mpeg_header_raw_array; + } else { + + // non-fatal error: Invalid MPEG audio header at offset $offset + return; + } + + if (!$fast_mpeg_header_scan) { + + $thisfile_mpeg_audio['version'] = $mpeg_audio_version_lookup[$thisfile_mpeg_audio['raw']['version']]; + $thisfile_mpeg_audio['layer'] = $mpeg_audio_layer_lookup[$thisfile_mpeg_audio['raw']['layer']]; + + $thisfile_mpeg_audio['channelmode'] = $mpeg_audio_channel_mode_lookup[$thisfile_mpeg_audio['raw']['channelmode']]; + $thisfile_mpeg_audio['channels'] = (($thisfile_mpeg_audio['channelmode'] == 'mono') ? 1 : 2); + $thisfile_mpeg_audio['sample_rate'] = $mpeg_audio_frequency_lookup[$thisfile_mpeg_audio['version']][$thisfile_mpeg_audio['raw']['sample_rate']]; + $thisfile_mpeg_audio['protection'] = !$thisfile_mpeg_audio['raw']['protection']; + $thisfile_mpeg_audio['private'] = (bool) $thisfile_mpeg_audio['raw']['private']; + $thisfile_mpeg_audio['modeextension'] = $mpeg_audio_mode_extension_lookup[$thisfile_mpeg_audio['layer']][$thisfile_mpeg_audio['raw']['modeextension']]; + $thisfile_mpeg_audio['copyright'] = (bool) $thisfile_mpeg_audio['raw']['copyright']; + $thisfile_mpeg_audio['original'] = (bool) $thisfile_mpeg_audio['raw']['original']; + $thisfile_mpeg_audio['emphasis'] = $mpeg_audio_emphasis_lookup[$thisfile_mpeg_audio['raw']['emphasis']]; + + $info['audio']['channels'] = $thisfile_mpeg_audio['channels']; + $info['audio']['sample_rate'] = $thisfile_mpeg_audio['sample_rate']; + + if ($thisfile_mpeg_audio['protection']) { + $thisfile_mpeg_audio['crc'] = getid3_lib::BigEndian2Int(substr($header_string, 4, 2)); + } + + } + + if ($thisfile_mpeg_audio['raw']['bitrate'] == 15) { + // http://www.hydrogenaudio.org/?act=ST&f=16&t=9682&st=0 + $this->getid3->warning('Invalid bitrate index (15), this is a known bug in free-format MP3s encoded by LAME v3.90 - 3.93.1'); + $thisfile_mpeg_audio['raw']['bitrate'] = 0; + } + $thisfile_mpeg_audio['padding'] = (bool) $thisfile_mpeg_audio['raw']['padding']; + $thisfile_mpeg_audio['bitrate'] = $mpeg_audio_bitrate_lookup[$thisfile_mpeg_audio['version']][$thisfile_mpeg_audio['layer']][$thisfile_mpeg_audio['raw']['bitrate']]; + + if (($thisfile_mpeg_audio['bitrate'] == 'free') && ($offset == $info['avdataoffset'])) { + // only skip multiple frame check if free-format bitstream found at beginning of file + // otherwise is quite possibly simply corrupted data + $recursive_search = false; + } + + // For Layer 2 there are some combinations of bitrate and mode which are not allowed. + if (!$fast_mpeg_header_scan && ($thisfile_mpeg_audio['layer'] == '2')) { + + $info['audio']['dataformat'] = 'mp2'; + switch ($thisfile_mpeg_audio['channelmode']) { + + case 'mono': + if (($thisfile_mpeg_audio['bitrate'] == 'free') || ($thisfile_mpeg_audio['bitrate'] <= 192000)) { + // these are ok + } else { + + // non-fatal error: bitrate not allowed in Layer 2/mono + return; + } + break; + + case 'stereo': + case 'joint stereo': + case 'dual channel': + if (($thisfile_mpeg_audio['bitrate'] == 'free') || ($thisfile_mpeg_audio['bitrate'] == 64000) || ($thisfile_mpeg_audio['bitrate'] >= 96000)) { + // these are ok + } else { + + // non-fatal error: bitrate not allowed in Layer 2/stereo/joint stereo/dual channel + return; + } + break; + + } + + } + + + if ($info['audio']['sample_rate'] > 0) { + $thisfile_mpeg_audio['framelength'] = getid3_mp3::MPEGaudioFrameLength($thisfile_mpeg_audio['bitrate'], $thisfile_mpeg_audio['version'], $thisfile_mpeg_audio['layer'], (int) $thisfile_mpeg_audio['padding'], $info['audio']['sample_rate']); + } + + $next_frame_test_offset = $offset + 1; + if ($thisfile_mpeg_audio['bitrate'] != 'free') { + + $info['audio']['bitrate'] = $thisfile_mpeg_audio['bitrate']; + + if (isset($thisfile_mpeg_audio['framelength'])) { + $next_frame_test_offset = $offset + $thisfile_mpeg_audio['framelength']; + } else { + + // non-fatal error: Frame at offset('.$offset.') is has an invalid frame length. + return; + } + + } + + $expected_number_of_audio_bytes = 0; + + //////////////////////////////////////////////////////////////////////////////////// + // Variable-bitrate headers + + if (substr($header_string, 4 + 32, 4) == 'VBRI') { + // Fraunhofer VBR header is hardcoded 'VBRI' at offset 0x24 (36) + // specs taken from http://minnie.tuhs.org/pipermail/mp3encoder/2001-January/001800.html + + $thisfile_mpeg_audio['bitrate_mode'] = 'vbr'; + $thisfile_mpeg_audio['VBR_method'] = 'Fraunhofer'; + $info['audio']['codec'] = 'Fraunhofer'; + + $side_info_data = substr($header_string, 4 + 2, 32); + + $fraunhofer_vbr_offset = 36; + + $thisfile_mpeg_audio['VBR_encoder_version'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 4, 2)); // VbriVersion + $thisfile_mpeg_audio['VBR_encoder_delay'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 6, 2)); // VbriDelay + $thisfile_mpeg_audio['VBR_quality'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 8, 2)); // VbriQuality + $thisfile_mpeg_audio['VBR_bytes'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 10, 4)); // VbriStreamBytes + $thisfile_mpeg_audio['VBR_frames'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 14, 4)); // VbriStreamFrames + $thisfile_mpeg_audio['VBR_seek_offsets'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 18, 2)); // VbriTableSize + $thisfile_mpeg_audio['VBR_seek_scale'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 20, 2)); // VbriTableScale + $thisfile_mpeg_audio['VBR_entry_bytes'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 22, 2)); // VbriEntryBytes + $thisfile_mpeg_audio['VBR_entry_frames'] = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset + 24, 2)); // VbriEntryFrames + + $expected_number_of_audio_bytes = $thisfile_mpeg_audio['VBR_bytes']; + + $previous_byte_offset = $offset; + for ($i = 0; $i < $thisfile_mpeg_audio['VBR_seek_offsets']; $i++) { + $fraunhofer_offset_n = getid3_lib::BigEndian2Int(substr($header_string, $fraunhofer_vbr_offset, $thisfile_mpeg_audio['VBR_entry_bytes'])); + $fraunhofer_vbr_offset += $thisfile_mpeg_audio['VBR_entry_bytes']; + $thisfile_mpeg_audio['VBR_offsets_relative'][$i] = ($fraunhofer_offset_n * $thisfile_mpeg_audio['VBR_seek_scale']); + $thisfile_mpeg_audio['VBR_offsets_absolute'][$i] = ($fraunhofer_offset_n * $thisfile_mpeg_audio['VBR_seek_scale']) + $previous_byte_offset; + $previous_byte_offset += $fraunhofer_offset_n; + } + + + } else { + + // Xing VBR header is hardcoded 'Xing' at a offset 0x0D (13), 0x15 (21) or 0x24 (36) + // depending on MPEG layer and number of channels + + $vbr_id_offset = getid3_mp3::XingVBRidOffset($thisfile_mpeg_audio['version'], $thisfile_mpeg_audio['channelmode']); + $side_info_data = substr($header_string, 4 + 2, $vbr_id_offset - 4); + + if ((substr($header_string, $vbr_id_offset, strlen('Xing')) == 'Xing') || (substr($header_string, $vbr_id_offset, strlen('Info')) == 'Info')) { + // 'Xing' is traditional Xing VBR frame + // 'Info' is LAME-encoded CBR (This was done to avoid CBR files to be recognized as traditional Xing VBR files by some decoders.) + // 'Info' *can* legally be used to specify a VBR file as well, however. + + // http://www.multiweb.cz/twoinches/MP3inside.htm + //00..03 = "Xing" or "Info" + //04..07 = Flags: + // 0x01 Frames Flag set if value for number of frames in file is stored + // 0x02 Bytes Flag set if value for filesize in bytes is stored + // 0x04 TOC Flag set if values for TOC are stored + // 0x08 VBR Scale Flag set if values for VBR scale is stored + //08..11 Frames: Number of frames in file (including the first Xing/Info one) + //12..15 Bytes: File length in Bytes + //16..115 TOC (Table of Contents): + // Contains of 100 indexes (one Byte length) for easier lookup in file. Approximately solves problem with moving inside file. + // Each Byte has a value according this formula: + // (TOC[i] / 256) * fileLenInBytes + // So if song lasts eg. 240 sec. and you want to jump to 60. sec. (and file is 5 000 000 Bytes length) you can use: + // TOC[(60/240)*100] = TOC[25] + // and corresponding Byte in file is then approximately at: + // (TOC[25]/256) * 5000000 + //116..119 VBR Scale + + + // should be safe to leave this at 'vbr' and let it be overriden to 'cbr' if a CBR preset/mode is used by LAME + $thisfile_mpeg_audio['bitrate_mode'] = 'vbr'; + $thisfile_mpeg_audio['VBR_method'] = 'Xing'; + + $thisfile_mpeg_audio['xing_flags_raw'] = getid3_lib::BigEndian2Int(substr($header_string, $vbr_id_offset + 4, 4)); + + $thisfile_mpeg_audio['xing_flags']['frames'] = (bool) ($thisfile_mpeg_audio['xing_flags_raw'] & 0x00000001); + $thisfile_mpeg_audio['xing_flags']['bytes'] = (bool) ($thisfile_mpeg_audio['xing_flags_raw'] & 0x00000002); + $thisfile_mpeg_audio['xing_flags']['toc'] = (bool) ($thisfile_mpeg_audio['xing_flags_raw'] & 0x00000004); + $thisfile_mpeg_audio['xing_flags']['vbr_scale'] = (bool) ($thisfile_mpeg_audio['xing_flags_raw'] & 0x00000008); + + if ($thisfile_mpeg_audio['xing_flags']['frames']) { + $thisfile_mpeg_audio['VBR_frames'] = getid3_lib::BigEndian2Int(substr($header_string, $vbr_id_offset + 8, 4)); + } + if ($thisfile_mpeg_audio['xing_flags']['bytes']) { + $thisfile_mpeg_audio['VBR_bytes'] = getid3_lib::BigEndian2Int(substr($header_string, $vbr_id_offset + 12, 4)); + } + + if (!empty($thisfile_mpeg_audio['VBR_frames']) && !empty($thisfile_mpeg_audio['VBR_bytes'])) { + + $frame_lengthfloat = $thisfile_mpeg_audio['VBR_bytes'] / $thisfile_mpeg_audio['VBR_frames']; + + if ($thisfile_mpeg_audio['layer'] == '1') { + // BitRate = (((FrameLengthInBytes / 4) - Padding) * SampleRate) / 12 + $info['audio']['bitrate'] = ($frame_lengthfloat / 4) * $thisfile_mpeg_audio['sample_rate'] * (2 / $info['audio']['channels']) / 12; + } else { + // Bitrate = ((FrameLengthInBytes - Padding) * SampleRate) / 144 + $info['audio']['bitrate'] = $frame_lengthfloat * $thisfile_mpeg_audio['sample_rate'] * (2 / $info['audio']['channels']) / 144; + } + $thisfile_mpeg_audio['framelength'] = floor($frame_lengthfloat); + } + + if ($thisfile_mpeg_audio['xing_flags']['toc']) { + $lame_toc_data = substr($header_string, $vbr_id_offset + 16, 100); + for ($i = 0; $i < 100; $i++) { + $thisfile_mpeg_audio['toc'][$i] = ord($lame_toc_data{$i}); + } + } + if ($thisfile_mpeg_audio['xing_flags']['vbr_scale']) { + $thisfile_mpeg_audio['VBR_scale'] = getid3_lib::BigEndian2Int(substr($header_string, $vbr_id_offset + 116, 4)); + } + + + // http://gabriel.mp3-tech.org/mp3infotag.html + if (substr($header_string, $vbr_id_offset + 120, 4) == 'LAME') { + + // shortcut + $thisfile_mpeg_audio['LAME'] = array (); + $thisfile_mpeg_audio_lame = &$thisfile_mpeg_audio['LAME']; + + + $thisfile_mpeg_audio_lame['long_version'] = substr($header_string, $vbr_id_offset + 120, 20); + $thisfile_mpeg_audio_lame['short_version'] = substr($thisfile_mpeg_audio_lame['long_version'], 0, 9); + + if ($thisfile_mpeg_audio_lame['short_version'] >= 'LAME3.90') { + + // extra 11 chars are not part of version string when LAMEtag present + unset($thisfile_mpeg_audio_lame['long_version']); + + // It the LAME tag was only introduced in LAME v3.90 + // http://www.hydrogenaudio.org/?act=ST&f=15&t=9933 + + // Offsets of various bytes in http://gabriel.mp3-tech.org/mp3infotag.html + // are assuming a 'Xing' identifier offset of 0x24, which is the case for + // MPEG-1 non-mono, but not for other combinations + $lame_tag_offset_contant = $vbr_id_offset - 0x24; + + // shortcuts + $thisfile_mpeg_audio_lame['RGAD'] = array ('track'=>array(), 'album'=>array()); + $thisfile_mpeg_audio_lame_rgad = &$thisfile_mpeg_audio_lame['RGAD']; + $thisfile_mpeg_audio_lame_rgad_track = &$thisfile_mpeg_audio_lame_rgad['track']; + $thisfile_mpeg_audio_lame_rgad_album = &$thisfile_mpeg_audio_lame_rgad['album']; + $thisfile_mpeg_audio_lame['raw'] = array (); + $thisfile_mpeg_audio_lame_raw = &$thisfile_mpeg_audio_lame['raw']; + + // byte $9B VBR Quality + // This field is there to indicate a quality level, although the scale was not precised in the original Xing specifications. + // Actually overwrites original Xing bytes + unset($thisfile_mpeg_audio['VBR_scale']); + $thisfile_mpeg_audio_lame['vbr_quality'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0x9B, 1)); + + // bytes $9C-$A4 Encoder short VersionString + $thisfile_mpeg_audio_lame['short_version'] = substr($header_string, $lame_tag_offset_contant + 0x9C, 9); + + // byte $A5 Info Tag revision + VBR method + $lame_tagRevisionVBRmethod = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xA5, 1)); + + $thisfile_mpeg_audio_lame['tag_revision'] = ($lame_tagRevisionVBRmethod & 0xF0) >> 4; + $thisfile_mpeg_audio_lame_raw['vbr_method'] = $lame_tagRevisionVBRmethod & 0x0F; + $thisfile_mpeg_audio_lame['vbr_method'] = getid3_mp3::LAMEvbrMethodLookup($thisfile_mpeg_audio_lame_raw['vbr_method']); + $thisfile_mpeg_audio['bitrate_mode'] = substr($thisfile_mpeg_audio_lame['vbr_method'], 0, 3); // usually either 'cbr' or 'vbr', but truncates 'vbr-old / vbr-rh' to 'vbr' + + // byte $A6 Lowpass filter value + $thisfile_mpeg_audio_lame['lowpass_frequency'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xA6, 1)) * 100; + + // bytes $A7-$AE Replay Gain + // http://privatewww.essex.ac.uk/~djmrob/replaygain/rg_data_format.html + // bytes $A7-$AA : 32 bit floating point "Peak signal amplitude" + if ($thisfile_mpeg_audio_lame['short_version'] >= 'LAME3.94b') { + // LAME 3.94a16 and later - 9.23 fixed point + // ie 0x0059E2EE / (2^23) = 5890798 / 8388608 = 0.7022378444671630859375 + $thisfile_mpeg_audio_lame_rgad['peak_amplitude'] = (float) ((getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xA7, 4))) / 8388608); + } else { + // LAME 3.94a15 and earlier - 32-bit floating point + // Actually 3.94a16 will fall in here too and be WRONG, but is hard to detect 3.94a16 vs 3.94a15 + $thisfile_mpeg_audio_lame_rgad['peak_amplitude'] = getid3_lib::LittleEndian2Float(substr($header_string, $lame_tag_offset_contant + 0xA7, 4)); + } + if ($thisfile_mpeg_audio_lame_rgad['peak_amplitude'] == 0) { + unset($thisfile_mpeg_audio_lame_rgad['peak_amplitude']); + } else { + $thisfile_mpeg_audio_lame_rgad['peak_db'] = 20 * log10($thisfile_mpeg_audio_lame_rgad['peak_amplitude']); + } + + $thisfile_mpeg_audio_lame_raw['RGAD_track'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xAB, 2)); + $thisfile_mpeg_audio_lame_raw['RGAD_album'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xAD, 2)); + + + if ($thisfile_mpeg_audio_lame_raw['RGAD_track'] != 0) { + + $thisfile_mpeg_audio_lame_rgad_track['raw']['name'] = ($thisfile_mpeg_audio_lame_raw['RGAD_track'] & 0xE000) >> 13; + $thisfile_mpeg_audio_lame_rgad_track['raw']['originator'] = ($thisfile_mpeg_audio_lame_raw['RGAD_track'] & 0x1C00) >> 10; + $thisfile_mpeg_audio_lame_rgad_track['raw']['sign_bit'] = ($thisfile_mpeg_audio_lame_raw['RGAD_track'] & 0x0200) >> 9; + $thisfile_mpeg_audio_lame_rgad_track['raw']['gain_adjust'] = $thisfile_mpeg_audio_lame_raw['RGAD_track'] & 0x01FF; + $thisfile_mpeg_audio_lame_rgad_track['name'] = getid3_lib_replaygain::NameLookup($thisfile_mpeg_audio_lame_rgad_track['raw']['name']); + $thisfile_mpeg_audio_lame_rgad_track['originator'] = getid3_lib_replaygain::OriginatorLookup($thisfile_mpeg_audio_lame_rgad_track['raw']['originator']); + $thisfile_mpeg_audio_lame_rgad_track['gain_db'] = getid3_lib_replaygain::AdjustmentLookup($thisfile_mpeg_audio_lame_rgad_track['raw']['gain_adjust'], $thisfile_mpeg_audio_lame_rgad_track['raw']['sign_bit']); + + if (!empty($thisfile_mpeg_audio_lame_rgad['peak_amplitude'])) { + $info['replay_gain']['track']['peak'] = $thisfile_mpeg_audio_lame_rgad['peak_amplitude']; + } + $info['replay_gain']['track']['originator'] = $thisfile_mpeg_audio_lame_rgad_track['originator']; + $info['replay_gain']['track']['adjustment'] = $thisfile_mpeg_audio_lame_rgad_track['gain_db']; + } else { + unset($thisfile_mpeg_audio_lame_rgad['track']); + } + if ($thisfile_mpeg_audio_lame_raw['RGAD_album'] != 0) { + + $thisfile_mpeg_audio_lame_rgad_album['raw']['name'] = ($thisfile_mpeg_audio_lame_raw['RGAD_album'] & 0xE000) >> 13; + $thisfile_mpeg_audio_lame_rgad_album['raw']['originator'] = ($thisfile_mpeg_audio_lame_raw['RGAD_album'] & 0x1C00) >> 10; + $thisfile_mpeg_audio_lame_rgad_album['raw']['sign_bit'] = ($thisfile_mpeg_audio_lame_raw['RGAD_album'] & 0x0200) >> 9; + $thisfile_mpeg_audio_lame_rgad_album['raw']['gain_adjust'] = $thisfile_mpeg_audio_lame_raw['RGAD_album'] & 0x01FF; + $thisfile_mpeg_audio_lame_rgad_album['name'] = getid3_lib_replaygain::NameLookup($thisfile_mpeg_audio_lame_rgad_album['raw']['name']); + $thisfile_mpeg_audio_lame_rgad_album['originator'] = getid3_lib_replaygain::OriginatorLookup($thisfile_mpeg_audio_lame_rgad_album['raw']['originator']); + $thisfile_mpeg_audio_lame_rgad_album['gain_db'] = getid3_lib_replaygain::AdjustmentLookup($thisfile_mpeg_audio_lame_rgad_album['raw']['gain_adjust'], $thisfile_mpeg_audio_lame_rgad_album['raw']['sign_bit']); + + if (!empty($thisfile_mpeg_audio_lame_rgad['peak_amplitude'])) { + $info['replay_gain']['album']['peak'] = $thisfile_mpeg_audio_lame_rgad['peak_amplitude']; + } + $info['replay_gain']['album']['originator'] = $thisfile_mpeg_audio_lame_rgad_album['originator']; + $info['replay_gain']['album']['adjustment'] = $thisfile_mpeg_audio_lame_rgad_album['gain_db']; + } else { + unset($thisfile_mpeg_audio_lame_rgad['album']); + } + if (empty($thisfile_mpeg_audio_lame_rgad)) { + unset($thisfile_mpeg_audio_lame['RGAD']); + } + + + // byte $AF Encoding flags + ATH Type + $encoding_flags_ath_type = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xAF, 1)); + $thisfile_mpeg_audio_lame['encoding_flags']['nspsytune'] = (bool) ($encoding_flags_ath_type & 0x10); + $thisfile_mpeg_audio_lame['encoding_flags']['nssafejoint'] = (bool) ($encoding_flags_ath_type & 0x20); + $thisfile_mpeg_audio_lame['encoding_flags']['nogap_next'] = (bool) ($encoding_flags_ath_type & 0x40); + $thisfile_mpeg_audio_lame['encoding_flags']['nogap_prev'] = (bool) ($encoding_flags_ath_type & 0x80); + $thisfile_mpeg_audio_lame['ath_type'] = $encoding_flags_ath_type & 0x0F; + + // byte $B0 if ABR {specified bitrate} else {minimal bitrate} + $thisfile_mpeg_audio_lame['raw']['abrbitrate_minbitrate'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xB0, 1)); + if ($thisfile_mpeg_audio_lame_raw['vbr_method'] == 2) { // Average BitRate (ABR) + $thisfile_mpeg_audio_lame['bitrate_abr'] = $thisfile_mpeg_audio_lame['raw']['abrbitrate_minbitrate']; + } elseif ($thisfile_mpeg_audio_lame_raw['vbr_method'] == 1) { // Constant BitRate (CBR) + // ignore + } elseif ($thisfile_mpeg_audio_lame['raw']['abrbitrate_minbitrate'] > 0) { // Variable BitRate (VBR) - minimum bitrate + $thisfile_mpeg_audio_lame['bitrate_min'] = $thisfile_mpeg_audio_lame['raw']['abrbitrate_minbitrate']; + } + + // bytes $B1-$B3 Encoder delays + $encoder_delays = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xB1, 3)); + $thisfile_mpeg_audio_lame['encoder_delay'] = ($encoder_delays & 0xFFF000) >> 12; + $thisfile_mpeg_audio_lame['end_padding'] = $encoder_delays & 0x000FFF; + + // byte $B4 Misc + $misc_byte = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xB4, 1)); + $thisfile_mpeg_audio_lame_raw['noise_shaping'] = ($misc_byte & 0x03); + $thisfile_mpeg_audio_lame_raw['stereo_mode'] = ($misc_byte & 0x1C) >> 2; + $thisfile_mpeg_audio_lame_raw['not_optimal_quality'] = ($misc_byte & 0x20) >> 5; + $thisfile_mpeg_audio_lame_raw['source_sample_freq'] = ($misc_byte & 0xC0) >> 6; + $thisfile_mpeg_audio_lame['noise_shaping'] = $thisfile_mpeg_audio_lame_raw['noise_shaping']; + $thisfile_mpeg_audio_lame['stereo_mode'] = getid3_mp3::LAMEmiscStereoModeLookup($thisfile_mpeg_audio_lame_raw['stereo_mode']); + $thisfile_mpeg_audio_lame['not_optimal_quality'] = (bool) $thisfile_mpeg_audio_lame_raw['not_optimal_quality']; + $thisfile_mpeg_audio_lame['source_sample_freq'] = getid3_mp3::LAMEmiscSourceSampleFrequencyLookup($thisfile_mpeg_audio_lame_raw['source_sample_freq']); + + // byte $B5 MP3 Gain + $thisfile_mpeg_audio_lame_raw['mp3_gain'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xB5, 1), false, true); + $thisfile_mpeg_audio_lame['mp3_gain_db'] = (20 * log10(2) / 4) * $thisfile_mpeg_audio_lame_raw['mp3_gain']; + $thisfile_mpeg_audio_lame['mp3_gain_factor'] = pow(2, ($thisfile_mpeg_audio_lame['mp3_gain_db'] / 6)); + + // bytes $B6-$B7 Preset and surround info + $PresetSurroundBytes = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xB6, 2)); + // Reserved = ($PresetSurroundBytes & 0xC000); + $thisfile_mpeg_audio_lame_raw['surround_info'] = ($PresetSurroundBytes & 0x3800); + $thisfile_mpeg_audio_lame['surround_info'] = getid3_mp3::LAMEsurroundInfoLookup($thisfile_mpeg_audio_lame_raw['surround_info']); + $thisfile_mpeg_audio_lame['preset_used_id'] = ($PresetSurroundBytes & 0x07FF); + $thisfile_mpeg_audio_lame['preset_used'] = getid3_mp3::LAMEpresetUsedLookup($thisfile_mpeg_audio_lame); + if (!empty($thisfile_mpeg_audio_lame['preset_used_id']) && empty($thisfile_mpeg_audio_lame['preset_used'])) { + $this->getid3->warning('Unknown LAME preset used ('.$thisfile_mpeg_audio_lame['preset_used_id'].') - please report to info@getid3.org'); + } + if (($thisfile_mpeg_audio_lame['short_version'] == 'LAME3.90.') && !empty($thisfile_mpeg_audio_lame['preset_used_id'])) { + // this may change if 3.90.4 ever comes out + $thisfile_mpeg_audio_lame['short_version'] = 'LAME3.90.3'; + } + + // bytes $B8-$BB MusicLength + $thisfile_mpeg_audio_lame['audio_bytes'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xB8, 4)); + $expected_number_of_audio_bytes = (($thisfile_mpeg_audio_lame['audio_bytes'] > 0) ? $thisfile_mpeg_audio_lame['audio_bytes'] : $thisfile_mpeg_audio['VBR_bytes']); + + // bytes $BC-$BD MusicCRC + $thisfile_mpeg_audio_lame['music_crc'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xBC, 2)); + + // bytes $BE-$BF CRC-16 of Info Tag + $thisfile_mpeg_audio_lame['lame_tag_crc'] = getid3_lib::BigEndian2Int(substr($header_string, $lame_tag_offset_contant + 0xBE, 2)); + + + // LAME CBR + if ($thisfile_mpeg_audio_lame_raw['vbr_method'] == 1) { + + $thisfile_mpeg_audio['bitrate_mode'] = 'cbr'; + $thisfile_mpeg_audio['bitrate'] = getid3_mp3::ClosestStandardMP3Bitrate($thisfile_mpeg_audio['bitrate']); + $info['audio']['bitrate'] = $thisfile_mpeg_audio['bitrate']; + + } + + } + } + + } else { + + // not Fraunhofer or Xing VBR methods, most likely CBR (but could be VBR with no header) + $thisfile_mpeg_audio['bitrate_mode'] = 'cbr'; + if ($recursive_search) { + $thisfile_mpeg_audio['bitrate_mode'] = 'vbr'; + if (getid3_mp3::RecursiveFrameScanning($fd, $info, $offset, $next_frame_test_offset, true)) { + $recursive_search = false; + $thisfile_mpeg_audio['bitrate_mode'] = 'cbr'; + } + if ($thisfile_mpeg_audio['bitrate_mode'] == 'vbr') { + $this->getid3->warning('VBR file with no VBR header. Bitrate values calculated from actual frame bitrates.'); + } + } + + } + + } + + if (($expected_number_of_audio_bytes > 0) && ($expected_number_of_audio_bytes != ($info['avdataend'] - $info['avdataoffset']))) { + if ($expected_number_of_audio_bytes > ($info['avdataend'] - $info['avdataoffset'])) { + if (($expected_number_of_audio_bytes - ($info['avdataend'] - $info['avdataoffset'])) == 1) { + $this->getid3->warning('Last byte of data truncated (this is a known bug in Meracl ID3 Tag Writer before v1.3.5)'); + } else { + $this->getid3->warning('Probable truncated file: expecting '.$expected_number_of_audio_bytes.' bytes of audio data, only found '.($info['avdataend'] - $info['avdataoffset']).' (short by '.($expected_number_of_audio_bytes - ($info['avdataend'] - $info['avdataoffset'])).' bytes)'); + } + } else { + if ((($info['avdataend'] - $info['avdataoffset']) - $expected_number_of_audio_bytes) == 1) { + $info['avdataend']--; + } else { + $this->getid3->warning('Too much data in file: expecting '.$expected_number_of_audio_bytes.' bytes of audio data, found '.($info['avdataend'] - $info['avdataoffset']).' ('.(($info['avdataend'] - $info['avdataoffset']) - $expected_number_of_audio_bytes).' bytes too many)'); + } + } + } + + if (($thisfile_mpeg_audio['bitrate'] == 'free') && empty($info['audio']['bitrate'])) { + if (($offset == $info['avdataoffset']) && empty($thisfile_mpeg_audio['VBR_frames'])) { + $frame_byte_length = getid3_mp3::FreeFormatFrameLength($fd, $offset, $info, true); + if ($frame_byte_length > 0) { + $thisfile_mpeg_audio['framelength'] = $frame_byte_length; + if ($thisfile_mpeg_audio['layer'] == '1') { + // BitRate = (((FrameLengthInBytes / 4) - Padding) * SampleRate) / 12 + $info['audio']['bitrate'] = ((($frame_byte_length / 4) - intval($thisfile_mpeg_audio['padding'])) * $thisfile_mpeg_audio['sample_rate']) / 12; + } else { + // Bitrate = ((FrameLengthInBytes - Padding) * SampleRate) / 144 + $info['audio']['bitrate'] = (($frame_byte_length - intval($thisfile_mpeg_audio['padding'])) * $thisfile_mpeg_audio['sample_rate']) / 144; + } + } else { + + // non-fatal error: Error calculating frame length of free-format MP3 without Xing/LAME header. + return; + } + } + } + + if (@$thisfile_mpeg_audio['VBR_frames']) { + switch ($thisfile_mpeg_audio['bitrate_mode']) { + case 'vbr': + case 'abr': + if (($thisfile_mpeg_audio['version'] == '1') && ($thisfile_mpeg_audio['layer'] == 1)) { + $thisfile_mpeg_audio['VBR_bitrate'] = ((@$thisfile_mpeg_audio['VBR_bytes'] / $thisfile_mpeg_audio['VBR_frames']) * 8) * ($info['audio']['sample_rate'] / 384); + } elseif ((($thisfile_mpeg_audio['version'] == '2') || ($thisfile_mpeg_audio['version'] == '2.5')) && ($thisfile_mpeg_audio['layer'] == 3)) { + $thisfile_mpeg_audio['VBR_bitrate'] = ((@$thisfile_mpeg_audio['VBR_bytes'] / $thisfile_mpeg_audio['VBR_frames']) * 8) * ($info['audio']['sample_rate'] / 576); + } else { + $thisfile_mpeg_audio['VBR_bitrate'] = ((@$thisfile_mpeg_audio['VBR_bytes'] / $thisfile_mpeg_audio['VBR_frames']) * 8) * ($info['audio']['sample_rate'] / 1152); + } + if ($thisfile_mpeg_audio['VBR_bitrate'] > 0) { + $info['audio']['bitrate'] = $thisfile_mpeg_audio['VBR_bitrate']; + $thisfile_mpeg_audio['bitrate'] = $thisfile_mpeg_audio['VBR_bitrate']; // to avoid confusion + } + break; + } + } + + // End variable-bitrate headers + //////////////////////////////////////////////////////////////////////////////////// + + if ($recursive_search) { + + if (!getid3_mp3::RecursiveFrameScanning($fd, $info, $offset, $next_frame_test_offset, $scan_as_cbr)) { + return false; + } + + } + + return true; + } + + + + public function RecursiveFrameScanning(&$fd, &$info, &$offset, &$next_frame_test_offset, $scan_as_cbr) { + for ($i = 0; $i < getid3_mp3::VALID_CHECK_FRAMES; $i++) { + // check next getid3_mp3::VALID_CHECK_FRAMES frames for validity, to make sure we haven't run across a false synch + if (($next_frame_test_offset + 4) >= $info['avdataend']) { + // end of file + return true; + } + + $next_frame_test_array = array ('avdataend' => $info['avdataend'], 'avdataoffset' => $info['avdataoffset']); + if ($this->decodeMPEGaudioHeader($fd, $next_frame_test_offset, $next_frame_test_array, false)) { + if ($scan_as_cbr) { + // force CBR mode, used for trying to pick out invalid audio streams with + // valid(?) VBR headers, or VBR streams with no VBR header + if (!isset($next_frame_test_array['mpeg']['audio']['bitrate']) || !isset($info['mpeg']['audio']['bitrate']) || ($next_frame_test_array['mpeg']['audio']['bitrate'] != $info['mpeg']['audio']['bitrate'])) { + return false; + } + } + + + // next frame is OK, get ready to check the one after that + if (isset($next_frame_test_array['mpeg']['audio']['framelength']) && ($next_frame_test_array['mpeg']['audio']['framelength'] > 0)) { + $next_frame_test_offset += $next_frame_test_array['mpeg']['audio']['framelength']; + } else { + + // non-fatal error: Frame at offset $offset has an invalid frame length. + return; + } + + } else { + + // non-fatal error: Next frame is not valid. + return; + } + } + return true; + } + + + + public function FreeFormatFrameLength($fd, $offset, &$info, $deep_scan=false) { + fseek($fd, $offset, SEEK_SET); + $mpeg_audio_data = fread($fd, 32768); + + $sync_pattern1 = substr($mpeg_audio_data, 0, 4); + // may be different pattern due to padding + $sync_pattern2 = $sync_pattern1{0}.$sync_pattern1{1}.chr(ord($sync_pattern1{2}) | 0x02).$sync_pattern1{3}; + if ($sync_pattern2 === $sync_pattern1) { + $sync_pattern2 = $sync_pattern1{0}.$sync_pattern1{1}.chr(ord($sync_pattern1{2}) & 0xFD).$sync_pattern1{3}; + } + + $frame_length = false; + $frame_length1 = strpos($mpeg_audio_data, $sync_pattern1, 4); + $frame_length2 = strpos($mpeg_audio_data, $sync_pattern2, 4); + if ($frame_length1 > 4) { + $frame_length = $frame_length1; + } + if (($frame_length2 > 4) && ($frame_length2 < $frame_length1)) { + $frame_length = $frame_length2; + } + if (!$frame_length) { + + // LAME 3.88 has a different value for modeextension on the first frame vs the rest + $frame_length1 = strpos($mpeg_audio_data, substr($sync_pattern1, 0, 3), 4); + $frame_length2 = strpos($mpeg_audio_data, substr($sync_pattern2, 0, 3), 4); + + if ($frame_length1 > 4) { + $frame_length = $frame_length1; + } + if (($frame_length2 > 4) && ($frame_length2 < $frame_length1)) { + $frame_length = $frame_length2; + } + if (!$frame_length) { + throw new getid3_exception('Cannot find next free-format synch pattern ('.getid3_lib::PrintHexBytes($sync_pattern1).' or '.getid3_lib::PrintHexBytes($sync_pattern2).') after offset '.$offset); + } else { + $this->getid3->warning('ModeExtension varies between first frame and other frames (known free-format issue in LAME 3.88)'); + $info['audio']['codec'] = 'LAME'; + $info['audio']['encoder'] = 'LAME3.88'; + $sync_pattern1 = substr($sync_pattern1, 0, 3); + $sync_pattern2 = substr($sync_pattern2, 0, 3); + } + } + + if ($deep_scan) { + + $actual_frame_length_values = array (); + $next_offset = $offset + $frame_length; + while ($next_offset < ($info['avdataend'] - 6)) { + fseek($fd, $next_offset - 1, SEEK_SET); + $NextSyncPattern = fread($fd, 6); + if ((substr($NextSyncPattern, 1, strlen($sync_pattern1)) == $sync_pattern1) || (substr($NextSyncPattern, 1, strlen($sync_pattern2)) == $sync_pattern2)) { + // good - found where expected + $actual_frame_length_values[] = $frame_length; + } elseif ((substr($NextSyncPattern, 0, strlen($sync_pattern1)) == $sync_pattern1) || (substr($NextSyncPattern, 0, strlen($sync_pattern2)) == $sync_pattern2)) { + // ok - found one byte earlier than expected (last frame wasn't padded, first frame was) + $actual_frame_length_values[] = ($frame_length - 1); + $next_offset--; + } elseif ((substr($NextSyncPattern, 2, strlen($sync_pattern1)) == $sync_pattern1) || (substr($NextSyncPattern, 2, strlen($sync_pattern2)) == $sync_pattern2)) { + // ok - found one byte later than expected (last frame was padded, first frame wasn't) + $actual_frame_length_values[] = ($frame_length + 1); + $next_offset++; + } else { + throw new getid3_exception('Did not find expected free-format sync pattern at offset '.$next_offset); + } + $next_offset += $frame_length; + } + if (count($actual_frame_length_values) > 0) { + $frame_length = intval(round(array_sum($actual_frame_length_values) / count($actual_frame_length_values))); + } + } + return $frame_length; + } + + + + public function getOnlyMPEGaudioInfo($fd, &$info, $avdata_offset, $bit_rate_histogram=false) { + + // looks for synch, decodes MPEG audio header + + fseek($fd, $avdata_offset, SEEK_SET); + + $sync_seek_buffer_size = min(128 * 1024, $info['avdataend'] - $avdata_offset); + $header = fread($fd, $sync_seek_buffer_size); + $sync_seek_buffer_size = strlen($header); + $synch_seek_offset = 0; + + static $mpeg_audio_version_lookup; + static $mpeg_audio_layer_lookup; + static $mpeg_audio_bitrate_lookup; + if (empty($mpeg_audio_version_lookup)) { + $mpeg_audio_version_lookup = getid3_mp3::MPEGaudioVersionarray(); + $mpeg_audio_layer_lookup = getid3_mp3::MPEGaudioLayerarray(); + $mpeg_audio_bitrate_lookup = getid3_mp3::MPEGaudioBitratearray(); + + } + + while ($synch_seek_offset < $sync_seek_buffer_size) { + + if ((($avdata_offset + $synch_seek_offset) < $info['avdataend']) && !feof($fd)) { + + // if a synch's not found within the first 128k bytes, then give up + if ($synch_seek_offset > $sync_seek_buffer_size) { + throw new getid3_exception('Could not find valid MPEG audio synch within the first '.round($sync_seek_buffer_size / 1024).'kB'); + } + + if (feof($fd)) { + throw new getid3_exception('Could not find valid MPEG audio synch before end of file'); + } + } + + if (($synch_seek_offset + 1) >= strlen($header)) { + throw new getid3_exception('Could not find valid MPEG synch before end of file'); + } + + if (($header{$synch_seek_offset} == "\xFF") && ($header{($synch_seek_offset + 1)} > "\xE0")) { // synch detected + + if (!isset($first_frame_info) && !isset($info['mpeg']['audio'])) { + $first_frame_info = $info; + $first_frame_avdata_offset = $avdata_offset + $synch_seek_offset; + if (!getid3_mp3::decodeMPEGaudioHeader($fd, $avdata_offset + $synch_seek_offset, $first_frame_info, false)) { + // if this is the first valid MPEG-audio frame, save it in case it's a VBR header frame and there's + // garbage between this frame and a valid sequence of MPEG-audio frames, to be restored below + unset($first_frame_info); + } + } + + $dummy = $info; // only overwrite real data if valid header found + if (getid3_mp3::decodeMPEGaudioHeader($fd, $avdata_offset + $synch_seek_offset, $dummy, true)) { + $info = $dummy; + $info['avdataoffset'] = $avdata_offset + $synch_seek_offset; + + switch (@$info['fileformat']) { + case '': + case 'mp3': + $info['fileformat'] = 'mp3'; + $info['audio']['dataformat'] = 'mp3'; + break; + } + if (isset($first_frame_info['mpeg']['audio']['bitrate_mode']) && ($first_frame_info['mpeg']['audio']['bitrate_mode'] == 'vbr')) { + if (!(abs($info['audio']['bitrate'] - $first_frame_info['audio']['bitrate']) <= 1)) { + // If there is garbage data between a valid VBR header frame and a sequence + // of valid MPEG-audio frames the VBR data is no longer discarded. + $info = $first_frame_info; + $info['avdataoffset'] = $first_frame_avdata_offset; + $info['fileformat'] = 'mp3'; + $info['audio']['dataformat'] = 'mp3'; + $dummy = $info; + unset($dummy['mpeg']['audio']); + $GarbageOffsetStart = $first_frame_avdata_offset + $first_frame_info['mpeg']['audio']['framelength']; + $GarbageOffsetEnd = $avdata_offset + $synch_seek_offset; + if (getid3_mp3::decodeMPEGaudioHeader($fd, $GarbageOffsetEnd, $dummy, true, true)) { + + $info = $dummy; + $info['avdataoffset'] = $GarbageOffsetEnd; + $this->getid3->warning('apparently-valid VBR header not used because could not find '.getid3_mp3::VALID_CHECK_FRAMES.' consecutive MPEG-audio frames immediately after VBR header (garbage data for '.($GarbageOffsetEnd - $GarbageOffsetStart).' bytes between '.$GarbageOffsetStart.' and '.$GarbageOffsetEnd.'), but did find valid CBR stream starting at '.$GarbageOffsetEnd); + + } else { + + $this->getid3->warning('using data from VBR header even though could not find '.getid3_mp3::VALID_CHECK_FRAMES.' consecutive MPEG-audio frames immediately after VBR header (garbage data for '.($GarbageOffsetEnd - $GarbageOffsetStart).' bytes between '.$GarbageOffsetStart.' and '.$GarbageOffsetEnd.')'); + + } + } + } + if (isset($info['mpeg']['audio']['bitrate_mode']) && ($info['mpeg']['audio']['bitrate_mode'] == 'vbr') && !isset($info['mpeg']['audio']['VBR_method'])) { + // VBR file with no VBR header + $bit_rate_histogram = true; + } + + if ($bit_rate_histogram) { + + $info['mpeg']['audio']['stereo_distribution'] = array ('stereo'=>0, 'joint stereo'=>0, 'dual channel'=>0, 'mono'=>0); + $info['mpeg']['audio']['version_distribution'] = array ('1'=>0, '2'=>0, '2.5'=>0); + + if ($info['mpeg']['audio']['version'] == '1') { + if ($info['mpeg']['audio']['layer'] == 3) { + $info['mpeg']['audio']['bitrate_distribution'] = array ('free'=>0, 32000=>0, 40000=>0, 48000=>0, 56000=>0, 64000=>0, 80000=>0, 96000=>0, 112000=>0, 128000=>0, 160000=>0, 192000=>0, 224000=>0, 256000=>0, 320000=>0); + } elseif ($info['mpeg']['audio']['layer'] == 2) { + $info['mpeg']['audio']['bitrate_distribution'] = array ('free'=>0, 32000=>0, 48000=>0, 56000=>0, 64000=>0, 80000=>0, 96000=>0, 112000=>0, 128000=>0, 160000=>0, 192000=>0, 224000=>0, 256000=>0, 320000=>0, 384000=>0); + } elseif ($info['mpeg']['audio']['layer'] == 1) { + $info['mpeg']['audio']['bitrate_distribution'] = array ('free'=>0, 32000=>0, 64000=>0, 96000=>0, 128000=>0, 160000=>0, 192000=>0, 224000=>0, 256000=>0, 288000=>0, 320000=>0, 352000=>0, 384000=>0, 416000=>0, 448000=>0); + } + } elseif ($info['mpeg']['audio']['layer'] == 1) { + $info['mpeg']['audio']['bitrate_distribution'] = array ('free'=>0, 32000=>0, 48000=>0, 56000=>0, 64000=>0, 80000=>0, 96000=>0, 112000=>0, 128000=>0, 144000=>0, 160000=>0, 176000=>0, 192000=>0, 224000=>0, 256000=>0); + } else { + $info['mpeg']['audio']['bitrate_distribution'] = array ('free'=>0, 8000=>0, 16000=>0, 24000=>0, 32000=>0, 40000=>0, 48000=>0, 56000=>0, 64000=>0, 80000=>0, 96000=>0, 112000=>0, 128000=>0, 144000=>0, 160000=>0); + } + + $dummy = array ('avdataend' => $info['avdataend'], 'avdataoffset' => $info['avdataoffset']); + $synch_start_offset = $info['avdataoffset']; + + $fast_mode = false; + $synch_errors_found = 0; + while ($this->decodeMPEGaudioHeader($fd, $synch_start_offset, $dummy, false, false, $fast_mode)) { + $fast_mode = true; + $thisframebitrate = $mpeg_audio_bitrate_lookup[$mpeg_audio_version_lookup[$dummy['mpeg']['audio']['raw']['version']]][$mpeg_audio_layer_lookup[$dummy['mpeg']['audio']['raw']['layer']]][$dummy['mpeg']['audio']['raw']['bitrate']]; + + if (empty($dummy['mpeg']['audio']['framelength'])) { + $synch_errors_found++; + } + else { + @$info['mpeg']['audio']['bitrate_distribution'][$thisframebitrate]++; + @$info['mpeg']['audio']['stereo_distribution'][$dummy['mpeg']['audio']['channelmode']]++; + @$info['mpeg']['audio']['version_distribution'][$dummy['mpeg']['audio']['version']]++; + + $synch_start_offset += $dummy['mpeg']['audio']['framelength']; + } + } + if ($synch_errors_found > 0) { + $this->getid3->warning('Found '.$synch_errors_found.' synch errors in histogram analysis'); + } + + $bit_total = 0; + $frame_counter = 0; + foreach ($info['mpeg']['audio']['bitrate_distribution'] as $bit_rate_value => $bit_rate_count) { + $frame_counter += $bit_rate_count; + if ($bit_rate_value != 'free') { + $bit_total += ($bit_rate_value * $bit_rate_count); + } + } + if ($frame_counter == 0) { + throw new getid3_exception('Corrupt MP3 file: framecounter == zero'); + } + $info['mpeg']['audio']['frame_count'] = $frame_counter; + $info['mpeg']['audio']['bitrate'] = ($bit_total / $frame_counter); + + $info['audio']['bitrate'] = $info['mpeg']['audio']['bitrate']; + + + // Definitively set VBR vs CBR, even if the Xing/LAME/VBRI header says differently + $distinct_bit_rates = 0; + foreach ($info['mpeg']['audio']['bitrate_distribution'] as $bit_rate_value => $bit_rate_count) { + if ($bit_rate_count > 0) { + $distinct_bit_rates++; + } + } + if ($distinct_bit_rates > 1) { + $info['mpeg']['audio']['bitrate_mode'] = 'vbr'; + } else { + $info['mpeg']['audio']['bitrate_mode'] = 'cbr'; + } + $info['audio']['bitrate_mode'] = $info['mpeg']['audio']['bitrate_mode']; + + } + + break; // exit while() + } + } + + $synch_seek_offset++; + if (($avdata_offset + $synch_seek_offset) >= $info['avdataend']) { + // end of file/data + + if (empty($info['mpeg']['audio'])) { + + throw new getid3_exception('could not find valid MPEG synch before end of file'); + } + break; + } + + } + + $info['audio']['channels'] = $info['mpeg']['audio']['channels']; + $info['audio']['channelmode'] = $info['mpeg']['audio']['channelmode']; + $info['audio']['sample_rate'] = $info['mpeg']['audio']['sample_rate']; + return true; + } + + + + public static function MPEGaudioVersionarray() { + + static $array = array ('2.5', false, '2', '1'); + return $array; + } + + + + public static function MPEGaudioLayerarray() { + + static $array = array (false, 3, 2, 1); + return $array; + } + + + + public static function MPEGaudioBitratearray() { + + static $array; + if (empty($array)) { + $array = array ( + '1' => array (1 => array ('free', 32000, 64000, 96000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 352000, 384000, 416000, 448000), + 2 => array ('free', 32000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000), + 3 => array ('free', 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000) + ), + + '2' => array (1 => array ('free', 32000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 144000, 160000, 176000, 192000, 224000, 256000), + 2 => array ('free', 8000, 16000, 24000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 144000, 160000), + ) + ); + $array['2'][3] = $array['2'][2]; + $array['2.5'] = $array['2']; + } + return $array; + } + + + + public static function MPEGaudioFrequencyarray() { + + static $array = array ( + '1' => array (44100, 48000, 32000), + '2' => array (22050, 24000, 16000), + '2.5' => array (11025, 12000, 8000) + ); + return $array; + } + + + + public static function MPEGaudioChannelModearray() { + + static $array = array ('stereo', 'joint stereo', 'dual channel', 'mono'); + return $array; + } + + + + public static function MPEGaudioModeExtensionarray() { + + static $array = array ( + 1 => array ('4-31', '8-31', '12-31', '16-31'), + 2 => array ('4-31', '8-31', '12-31', '16-31'), + 3 => array ('', 'IS', 'MS', 'IS+MS') + ); + return $array; + } + + + + public static function MPEGaudioEmphasisarray() { + + static $array = array ('none', '50/15ms', false, 'CCIT J.17'); + return $array; + } + + + + public static function MPEGaudioHeaderBytesValid($head4, $allow_bitrate_15=false) { + + return getid3_mp3::MPEGaudioHeaderValid(getid3_mp3::MPEGaudioHeaderDecode($head4), false, $allow_bitrate_15); + } + + + + public static function MPEGaudioHeaderValid($raw_array, $echo_errors=false, $allow_bitrate_15=false) { + + if (($raw_array['synch'] & 0x0FFE) != 0x0FFE) { + return false; + } + + static $mpeg_audio_version_lookup; + static $mpeg_audio_layer_lookup; + static $mpeg_audio_bitrate_lookup; + static $mpeg_audio_frequency_lookup; + static $mpeg_audio_channel_mode_lookup; + static $mpeg_audio_mode_extension_lookup; + static $mpeg_audio_emphasis_lookup; + if (empty($mpeg_audio_version_lookup)) { + $mpeg_audio_version_lookup = getid3_mp3::MPEGaudioVersionarray(); + $mpeg_audio_layer_lookup = getid3_mp3::MPEGaudioLayerarray(); + $mpeg_audio_bitrate_lookup = getid3_mp3::MPEGaudioBitratearray(); + $mpeg_audio_frequency_lookup = getid3_mp3::MPEGaudioFrequencyarray(); + $mpeg_audio_channel_mode_lookup = getid3_mp3::MPEGaudioChannelModearray(); + $mpeg_audio_mode_extension_lookup = getid3_mp3::MPEGaudioModeExtensionarray(); + $mpeg_audio_emphasis_lookup = getid3_mp3::MPEGaudioEmphasisarray(); + } + + if (isset($mpeg_audio_version_lookup[$raw_array['version']])) { + $decodedVersion = $mpeg_audio_version_lookup[$raw_array['version']]; + } else { + echo ($echo_errors ? "\n".'invalid Version ('.$raw_array['version'].')' : ''); + return false; + } + if (isset($mpeg_audio_layer_lookup[$raw_array['layer']])) { + $decodedLayer = $mpeg_audio_layer_lookup[$raw_array['layer']]; + } else { + echo ($echo_errors ? "\n".'invalid Layer ('.$raw_array['layer'].')' : ''); + return false; + } + if (!isset($mpeg_audio_bitrate_lookup[$decodedVersion][$decodedLayer][$raw_array['bitrate']])) { + echo ($echo_errors ? "\n".'invalid Bitrate ('.$raw_array['bitrate'].')' : ''); + if ($raw_array['bitrate'] == 15) { + // known issue in LAME 3.90 - 3.93.1 where free-format has bitrate ID of 15 instead of 0 + // let it go through here otherwise file will not be identified + if (!$allow_bitrate_15) { + return false; + } + } else { + return false; + } + } + if (!isset($mpeg_audio_frequency_lookup[$decodedVersion][$raw_array['sample_rate']])) { + echo ($echo_errors ? "\n".'invalid Frequency ('.$raw_array['sample_rate'].')' : ''); + return false; + } + if (!isset($mpeg_audio_channel_mode_lookup[$raw_array['channelmode']])) { + echo ($echo_errors ? "\n".'invalid ChannelMode ('.$raw_array['channelmode'].')' : ''); + return false; + } + if (!isset($mpeg_audio_mode_extension_lookup[$decodedLayer][$raw_array['modeextension']])) { + echo ($echo_errors ? "\n".'invalid Mode Extension ('.$raw_array['modeextension'].')' : ''); + return false; + } + if (!isset($mpeg_audio_emphasis_lookup[$raw_array['emphasis']])) { + echo ($echo_errors ? "\n".'invalid Emphasis ('.$raw_array['emphasis'].')' : ''); + return false; + } + // These are just either set or not set, you can't mess that up :) + // $raw_array['protection']; + // $raw_array['padding']; + // $raw_array['private']; + // $raw_array['copyright']; + // $raw_array['original']; + + return true; + } + + + + public static function MPEGaudioHeaderDecode($header_four_bytes) { + // AAAA AAAA AAAB BCCD EEEE FFGH IIJJ KLMM + // A - Frame sync (all bits set) + // B - MPEG Audio version ID + // C - Layer description + // D - Protection bit + // E - Bitrate index + // F - Sampling rate frequency index + // G - Padding bit + // H - Private bit + // I - Channel Mode + // J - Mode extension (Only if Joint stereo) + // K - Copyright + // L - Original + // M - Emphasis + + if (strlen($header_four_bytes) != 4) { + return false; + } + + $mpeg_raw_header['synch'] = (getid3_lib::BigEndian2Int(substr($header_four_bytes, 0, 2)) & 0xFFE0) >> 4; + $mpeg_raw_header['version'] = (ord($header_four_bytes{1}) & 0x18) >> 3; // BB + $mpeg_raw_header['layer'] = (ord($header_four_bytes{1}) & 0x06) >> 1; // CC + $mpeg_raw_header['protection'] = (ord($header_four_bytes{1}) & 0x01); // D + $mpeg_raw_header['bitrate'] = (ord($header_four_bytes{2}) & 0xF0) >> 4; // EEEE + $mpeg_raw_header['sample_rate'] = (ord($header_four_bytes{2}) & 0x0C) >> 2; // FF + $mpeg_raw_header['padding'] = (ord($header_four_bytes{2}) & 0x02) >> 1; // G + $mpeg_raw_header['private'] = (ord($header_four_bytes{2}) & 0x01); // H + $mpeg_raw_header['channelmode'] = (ord($header_four_bytes{3}) & 0xC0) >> 6; // II + $mpeg_raw_header['modeextension'] = (ord($header_four_bytes{3}) & 0x30) >> 4; // JJ + $mpeg_raw_header['copyright'] = (ord($header_four_bytes{3}) & 0x08) >> 3; // K + $mpeg_raw_header['original'] = (ord($header_four_bytes{3}) & 0x04) >> 2; // L + $mpeg_raw_header['emphasis'] = (ord($header_four_bytes{3}) & 0x03); // MM + + return $mpeg_raw_header; + } + + + + public static function MPEGaudioFrameLength(&$bit_rate, &$version, &$layer, $padding, &$sample_rate) { + + if (!isset($cache[$bit_rate][$version][$layer][$padding][$sample_rate])) { + $cache[$bit_rate][$version][$layer][$padding][$sample_rate] = false; + if ($bit_rate != 'free') { + + if ($version == '1') { + + if ($layer == '1') { + + // For Layer I slot is 32 bits long + $frame_length_coefficient = 48; + $slot_length = 4; + + } else { // Layer 2 / 3 + + // for Layer 2 and Layer 3 slot is 8 bits long. + $frame_length_coefficient = 144; + $slot_length = 1; + + } + + } else { // MPEG-2 / MPEG-2.5 + + if ($layer == '1') { + + // For Layer I slot is 32 bits long + $frame_length_coefficient = 24; + $slot_length = 4; + + } elseif ($layer == '2') { + + // for Layer 2 and Layer 3 slot is 8 bits long. + $frame_length_coefficient = 144; + $slot_length = 1; + + } else { // layer 3 + + // for Layer 2 and Layer 3 slot is 8 bits long. + $frame_length_coefficient = 72; + $slot_length = 1; + + } + + } + + // FrameLengthInBytes = ((Coefficient * BitRate) / SampleRate) + Padding + if ($sample_rate > 0) { + $new_frame_length = ($frame_length_coefficient * $bit_rate) / $sample_rate; + $new_frame_length = floor($new_frame_length / $slot_length) * $slot_length; // round to next-lower multiple of SlotLength (1 byte for Layer 2/3, 4 bytes for Layer I) + if ($padding) { + $new_frame_length += $slot_length; + } + $cache[$bit_rate][$version][$layer][$padding][$sample_rate] = (int) $new_frame_length; + } + } + } + return $cache[$bit_rate][$version][$layer][$padding][$sample_rate]; + } + + + + public static function ClosestStandardMP3Bitrate($bit_rate) { + + static $standard_bit_rates = array (320000, 256000, 224000, 192000, 160000, 128000, 112000, 96000, 80000, 64000, 56000, 48000, 40000, 32000, 24000, 16000, 8000); + static $bit_rate_table = array (0=>'-'); + $round_bit_rate = intval(round($bit_rate, -3)); + if (!isset($bit_rate_table[$round_bit_rate])) { + if ($round_bit_rate > 320000) { + $bit_rate_table[$round_bit_rate] = round($bit_rate, -4); + } else { + $last_bit_rate = 320000; + foreach ($standard_bit_rates as $standard_bit_rate) { + $bit_rate_table[$round_bit_rate] = $standard_bit_rate; + if ($round_bit_rate >= $standard_bit_rate - (($last_bit_rate - $standard_bit_rate) / 2)) { + break; + } + $last_bit_rate = $standard_bit_rate; + } + } + } + return $bit_rate_table[$round_bit_rate]; + } + + + + public static function XingVBRidOffset($version, $channel_mode) { + + static $lookup = array ( + '1' => array ('mono' => 0x15, // 4 + 17 = 21 + 'stereo' => 0x24, // 4 + 32 = 36 + 'joint stereo' => 0x24, + 'dual channel' => 0x24 + ), + + '2' => array ('mono' => 0x0D, // 4 + 9 = 13 + 'stereo' => 0x15, // 4 + 17 = 21 + 'joint stereo' => 0x15, + 'dual channel' => 0x15 + ), + + '2.5' => array ('mono' => 0x15, + 'stereo' => 0x15, + 'joint stereo' => 0x15, + 'dual channel' => 0x15 + ) + ); + + return $lookup[$version][$channel_mode]; + } + + + + public static function LAMEvbrMethodLookup($vbr_method_id) { + + static $lookup = array ( + 0x00 => 'unknown', + 0x01 => 'cbr', + 0x02 => 'abr', + 0x03 => 'vbr-old / vbr-rh', + 0x04 => 'vbr-new / vbr-mtrh', + 0x05 => 'vbr-mt', + 0x06 => 'Full VBR Method 4', + 0x08 => 'constant bitrate 2 pass', + 0x09 => 'abr 2 pass', + 0x0F => 'reserved' + ); + return (isset($lookup[$vbr_method_id]) ? $lookup[$vbr_method_id] : ''); + } + + + + public static function LAMEmiscStereoModeLookup($stereo_mode_id) { + + static $lookup = array ( + 0 => 'mono', + 1 => 'stereo', + 2 => 'dual mono', + 3 => 'joint stereo', + 4 => 'forced stereo', + 5 => 'auto', + 6 => 'intensity stereo', + 7 => 'other' + ); + return (isset($lookup[$stereo_mode_id]) ? $lookup[$stereo_mode_id] : ''); + } + + + + public static function LAMEmiscSourceSampleFrequencyLookup($source_sample_frequency_id) { + + static $lookup = array ( + 0 => '<= 32 kHz', + 1 => '44.1 kHz', + 2 => '48 kHz', + 3 => '> 48kHz' + ); + return (isset($lookup[$source_sample_frequency_id]) ? $lookup[$source_sample_frequency_id] : ''); + } + + + + public static function LAMEsurroundInfoLookup($surround_info_id) { + + static $lookup = array ( + 0 => 'no surround info', + 1 => 'DPL encoding', + 2 => 'DPL2 encoding', + 3 => 'Ambisonic encoding' + ); + return (isset($lookup[$surround_info_id]) ? $lookup[$surround_info_id] : 'reserved'); + } + + + + public static function LAMEpresetUsedLookup($lame_tag) { + + if ($lame_tag['preset_used_id'] == 0) { + // no preset used (LAME >=3.93) + // no preset recorded (LAME <3.93) + return ''; + } + + $lame_preset_used_lookup = array (); + + for ($i = 8; $i <= 320; $i++) { + switch ($lame_tag['vbr_method']) { + case 'cbr': + $lame_preset_used_lookup[$i] = '--alt-preset '.$lame_tag['vbr_method'].' '.$i; + break; + case 'abr': + default: // other VBR modes shouldn't be here(?) + $lame_preset_used_lookup[$i] = '--alt-preset '.$i; + break; + } + } + + // named old-style presets (studio, phone, voice, etc) are handled in GuessEncoderOptions() + + // named alt-presets + $lame_preset_used_lookup[1000] = '--r3mix'; + $lame_preset_used_lookup[1001] = '--alt-preset standard'; + $lame_preset_used_lookup[1002] = '--alt-preset extreme'; + $lame_preset_used_lookup[1003] = '--alt-preset insane'; + $lame_preset_used_lookup[1004] = '--alt-preset fast standard'; + $lame_preset_used_lookup[1005] = '--alt-preset fast extreme'; + $lame_preset_used_lookup[1006] = '--alt-preset medium'; + $lame_preset_used_lookup[1007] = '--alt-preset fast medium'; + + // LAME 3.94 additions/changes + $lame_preset_used_lookup[1010] = '--preset portable'; // 3.94a15 Oct 21 2003 + $lame_preset_used_lookup[1015] = '--preset radio'; // 3.94a15 Oct 21 2003 + + $lame_preset_used_lookup[320] = '--preset insane'; // 3.94a15 Nov 12 2003 + $lame_preset_used_lookup[410] = '-V9'; + $lame_preset_used_lookup[420] = '-V8'; + $lame_preset_used_lookup[430] = '--preset radio'; // 3.94a15 Nov 12 2003 + $lame_preset_used_lookup[440] = '-V6'; + $lame_preset_used_lookup[450] = '--preset '.(($lame_tag['raw']['vbr_method'] == 4) ? 'fast ' : '').'portable'; // 3.94a15 Nov 12 2003 + $lame_preset_used_lookup[460] = '--preset '.(($lame_tag['raw']['vbr_method'] == 4) ? 'fast ' : '').'medium'; // 3.94a15 Nov 12 2003 + $lame_preset_used_lookup[470] = '--r3mix'; // 3.94b1 Dec 18 2003 + $lame_preset_used_lookup[480] = '--preset '.(($lame_tag['raw']['vbr_method'] == 4) ? 'fast ' : '').'standard'; // 3.94a15 Nov 12 2003 + $lame_preset_used_lookup[490] = '-V1'; + $lame_preset_used_lookup[500] = '--preset '.(($lame_tag['raw']['vbr_method'] == 4) ? 'fast ' : '').'extreme'; // 3.94a15 Nov 12 2003 + + return (isset($lame_preset_used_lookup[$lame_tag['preset_used_id']]) ? $lame_preset_used_lookup[$lame_tag['preset_used_id']] : 'new/unknown preset: '.$lame_tag['preset_used_id'].' - report to info@getid3.org'); + } + + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.mpc.php b/modules/getid3/module.audio.mpc.php new file mode 100644 index 00000000..59d2802e --- /dev/null +++ b/modules/getid3/module.audio.mpc.php @@ -0,0 +1,211 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.mpc.php | +// | Module for analyzing Musepack/MPEG+ Audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.mpc.php,v 1.3 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_mpc extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + // http://www.uni-jena.de/~pfk/mpp/sv8/header.html + + $getid3->info['fileformat'] = 'mpc'; + $getid3->info['audio']['dataformat'] = 'mpc'; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + $getid3->info['audio']['channels'] = 2; // the format appears to be hardcoded for stereo only + $getid3->info['audio']['lossless'] = false; + + $getid3->info['mpc']['header'] = array (); + $info_mpc_header = &$getid3->info['mpc']['header']; + $info_mpc_header['size'] = 28; + $info_mpc_header['raw']['preamble'] = 'MP+'; // Magic bytes + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $mpc_header_data = fread($getid3->fp, 28); + + $stream_version_byte = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 3, 1)); + $info_mpc_header['stream_major_version'] = ($stream_version_byte & 0x0F); + $info_mpc_header['stream_minor_version'] = ($stream_version_byte & 0xF0) >> 4; + if ($info_mpc_header['stream_major_version'] != 7) { + throw new getid3_exception('Only Musepack SV7 supported'); + } + + $info_mpc_header['frame_count'] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 4, 4)); + + $info_mpc_header['raw']['title_peak'] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 12, 2)); + $info_mpc_header['raw']['title_gain'] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 14, 2), true); + $info_mpc_header['raw']['album_peak'] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 16, 2)); + $info_mpc_header['raw']['album_gain'] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 18, 2), true); + + $info_mpc_header['raw']['not_sure_what'] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 24, 3)); + $info_mpc_header['raw']['encoder_version'] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 27, 1)); + + $flags_dword1 = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 8, 4)); + $flags_dword2 = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 20, 4)); + + $info_mpc_header['intensity_stereo'] = (bool)(($flags_dword1 & 0x80000000) >> 31); + $info_mpc_header['mid_side_stereo'] = (bool)(($flags_dword1 & 0x40000000) >> 30); + $info_mpc_header['max_subband'] = ($flags_dword1 & 0x3F000000) >> 24; + $info_mpc_header['raw']['profile'] = ($flags_dword1 & 0x00F00000) >> 20; + $info_mpc_header['begin_loud'] = (bool)(($flags_dword1 & 0x00080000) >> 19); + $info_mpc_header['end_loud'] = (bool)(($flags_dword1 & 0x00040000) >> 18); + $info_mpc_header['raw']['sample_rate'] = ($flags_dword1 & 0x00030000) >> 16; + $info_mpc_header['max_level'] = ($flags_dword1 & 0x0000FFFF); + + $info_mpc_header['true_gapless'] = (bool)(($flags_dword2 & 0x80000000) >> 31); + $info_mpc_header['last_frame_length'] = ($flags_dword2 & 0x7FF00000) >> 20; + + $info_mpc_header['profile'] = getid3_mpc::MPCprofileNameLookup($info_mpc_header['raw']['profile']); + $info_mpc_header['sample_rate'] = getid3_mpc::MPCfrequencyLookup($info_mpc_header['raw']['sample_rate']); + $getid3->info['audio']['sample_rate'] = $info_mpc_header['sample_rate']; + $info_mpc_header['samples'] = ((($info_mpc_header['frame_count'] - 1) * 1152) + $info_mpc_header['last_frame_length']) * $getid3->info['audio']['channels']; + + $getid3->info['playtime_seconds'] = ($info_mpc_header['samples'] / $getid3->info['audio']['channels']) / $getid3->info['audio']['sample_rate']; + + $getid3->info['avdataoffset'] += $info_mpc_header['size']; + + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + + $info_mpc_header['title_peak'] = $info_mpc_header['raw']['title_peak']; + $info_mpc_header['title_peak_db'] = getid3_mpc::MPCpeakDBLookup($info_mpc_header['title_peak']); + if ($info_mpc_header['raw']['title_gain'] < 0) { + $info_mpc_header['title_gain_db'] = (float)(32768 + $info_mpc_header['raw']['title_gain']) / -100; + } + else { + $info_mpc_header['title_gain_db'] = (float)$info_mpc_header['raw']['title_gain'] / 100; + } + + $info_mpc_header['album_peak'] = $info_mpc_header['raw']['album_peak']; + $info_mpc_header['album_peak_db'] = getid3_mpc::MPCpeakDBLookup($info_mpc_header['album_peak']); + if ($info_mpc_header['raw']['album_gain'] < 0) { + $info_mpc_header['album_gain_db'] = (float)(32768 + $info_mpc_header['raw']['album_gain']) / -100; + } + else { + $info_mpc_header['album_gain_db'] = (float)$info_mpc_header['raw']['album_gain'] / 100;; + } + $info_mpc_header['encoder_version'] = getid3_mpc::MPCencoderVersionLookup($info_mpc_header['raw']['encoder_version']); + + $getid3->info['replay_gain']['track']['adjustment'] = $info_mpc_header['title_gain_db']; + $getid3->info['replay_gain']['album']['adjustment'] = $info_mpc_header['album_gain_db']; + + if ($info_mpc_header['title_peak'] > 0) { + $getid3->info['replay_gain']['track']['peak'] = $info_mpc_header['title_peak']; + } + elseif (round($info_mpc_header['max_level'] * 1.18) > 0) { + $getid3->info['replay_gain']['track']['peak'] = (int)(round($info_mpc_header['max_level'] * 1.18)); // why? I don't know - see mppdec.c + } + if ($info_mpc_header['album_peak'] > 0) { + $getid3->info['replay_gain']['album']['peak'] = $info_mpc_header['album_peak']; + } + + $getid3->info['audio']['encoder'] = $info_mpc_header['encoder_version']; + $getid3->info['audio']['encoder_options'] = $info_mpc_header['profile']; + + return true; + } + + + + public static function MPCprofileNameLookup($profileid) { + + static $lookup = array ( + 0 => 'no profile', + 1 => 'Experimental', + 2 => 'unused', + 3 => 'unused', + 4 => 'unused', + 5 => 'below Telephone (q = 0.0)', + 6 => 'below Telephone (q = 1.0)', + 7 => 'Telephone (q = 2.0)', + 8 => 'Thumb (q = 3.0)', + 9 => 'Radio (q = 4.0)', + 10 => 'Standard (q = 5.0)', + 11 => 'Extreme (q = 6.0)', + 12 => 'Insane (q = 7.0)', + 13 => 'BrainDead (q = 8.0)', + 14 => 'above BrainDead (q = 9.0)', + 15 => 'above BrainDead (q = 10.0)' + ); + return (isset($lookup[$profileid]) ? $lookup[$profileid] : 'invalid'); + } + + + + public static function MPCfrequencyLookup($frequencyid) { + + static $lookup = array ( + 0 => 44100, + 1 => 48000, + 2 => 37800, + 3 => 32000 + ); + return (isset($lookup[$frequencyid]) ? $lookup[$frequencyid] : 'invalid'); + } + + + + public static function MPCpeakDBLookup($int_value) { + + if ($int_value > 0) { + return ((log10($int_value) / log10(2)) - 15) * 6; + } + return false; + } + + + + public static function MPCencoderVersionLookup($encoder_version) { + + //Encoder version * 100 (106 = 1.06) + //EncoderVersion % 10 == 0 Release (1.0) + //EncoderVersion % 2 == 0 Beta (1.06) + //EncoderVersion % 2 == 1 Alpha (1.05a...z) + + if ($encoder_version == 0) { + // very old version, not known exactly which + return 'Buschmann v1.7.0-v1.7.9 or Klemm v0.90-v1.05'; + } + + if (($encoder_version % 10) == 0) { + + // release version + return number_format($encoder_version / 100, 2); + + } elseif (($encoder_version % 2) == 0) { + + // beta version + return number_format($encoder_version / 100, 2).' beta'; + + } + + // alpha version + return number_format($encoder_version / 100, 2).' alpha'; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.mpc_old.php b/modules/getid3/module.audio.mpc_old.php new file mode 100644 index 00000000..15971789 --- /dev/null +++ b/modules/getid3/module.audio.mpc_old.php @@ -0,0 +1,107 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.mpc_old.php | +// | Module for analyzing Musepack/MPEG+ Audio files - SV4-SV6 | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.mpc_old.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_mpc_old extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + // http://www.uni-jena.de/~pfk/mpp/sv8/header.html + + $getid3->info['mpc']['header'] = array (); + $info_mpc_header = &$getid3->info['mpc']['header']; + + $getid3->info['fileformat'] = 'mpc'; + $getid3->info['audio']['dataformat'] = 'mpc'; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + $getid3->info['audio']['channels'] = 2; // the format appears to be hardcoded for stereo only + $getid3->info['audio']['lossless'] = false; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + $info_mpc_header['size'] = 8; + $getid3->info['avdataoffset'] += $info_mpc_header['size']; + + $mpc_header_data = fread($getid3->fp, $info_mpc_header['size']); + + + // Most of this code adapted from Jurgen Faul's MPEGplus source code - thanks Jurgen! :) + $header_dword[0] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 0, 4)); + $header_dword[1] = getid3_lib::LittleEndian2Int(substr($mpc_header_data, 4, 4)); + + + // DDDD DDDD CCCC CCCC BBBB BBBB AAAA AAAA + // aaaa aaaa abcd dddd dddd deee eeff ffff + // + // a = bitrate = anything + // b = IS = anything + // c = MS = anything + // d = streamversion = 0000000004 or 0000000005 or 0000000006 + // e = maxband = anything + // f = blocksize = 000001 for SV5+, anything(?) for SV4 + + $info_mpc_header['target_bitrate'] = (($header_dword[0] & 0xFF800000) >> 23); + $info_mpc_header['intensity_stereo'] = (bool)(($header_dword[0] & 0x00400000) >> 22); + $info_mpc_header['mid-side_stereo'] = (bool)(($header_dword[0] & 0x00200000) >> 21); + $info_mpc_header['stream_major_version'] = ($header_dword[0] & 0x001FF800) >> 11; + $info_mpc_header['stream_minor_version'] = 0; + $info_mpc_header['max_band'] = ($header_dword[0] & 0x000007C0) >> 6; // related to lowpass frequency, not sure how it translates exactly + $info_mpc_header['block_size'] = ($header_dword[0] & 0x0000003F); + + switch ($info_mpc_header['stream_major_version']) { + case 4: + $info_mpc_header['frame_count'] = ($header_dword[1] >> 16); + break; + case 5: + case 6: + $info_mpc_header['frame_count'] = $header_dword[1]; + break; + + default: + throw new getid3_exception('Expecting 4, 5 or 6 in version field, found '.$info_mpc_header['stream_major_version'].' instead'); + } + + if (($info_mpc_header['stream_major_version'] > 4) && ($info_mpc_header['block_size'] != 1)) { + $getid3->warning('Block size expected to be 1, actual value found: '.$info_mpc_header['block_size']); + } + + $info_mpc_header['sample_rate'] = $getid3->info['audio']['sample_rate'] = 44100; // AB: used by all files up to SV7 + $info_mpc_header['samples'] = $info_mpc_header['frame_count'] * 1152 * $getid3->info['audio']['channels']; + + $getid3->info['audio']['bitrate_mode'] = $info_mpc_header['target_bitrate'] == 0 ? 'vbr' : 'cbr'; + + $getid3->info['mpc']['bitrate'] = ($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8 * 44100 / $info_mpc_header['frame_count'] / 1152; + $getid3->info['audio']['bitrate'] = $getid3->info['mpc']['bitrate']; + $getid3->info['audio']['encoder'] = 'SV'.$info_mpc_header['stream_major_version']; + + return true; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.optimfrog.php b/modules/getid3/module.audio.optimfrog.php new file mode 100644 index 00000000..ff80a2fe --- /dev/null +++ b/modules/getid3/module.audio.optimfrog.php @@ -0,0 +1,468 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.optimfrog.php | +// | Module for analyzing OptimFROG Audio files | +// | dependencies: module.audio-video.riff.php | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.optimfrog.php,v 1.3 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_optimfrog extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->include_module('audio-video.riff'); + + $getid3->info['audio']['dataformat'] = 'ofr'; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + $getid3->info['audio']['lossless'] = true; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $ofr_header = fread($getid3->fp, 8); + + if (substr($ofr_header, 0, 5) == '*RIFF') { + return $this->ParseOptimFROGheader42($getid3->fp, $getid3->info); + + } elseif (substr($ofr_header, 0, 3) == 'OFR') { + return $this->ParseOptimFROGheader45($getid3->fp, $getid3->info); + } + + throw new getid3_exception('Expecting "*RIFF" or "OFR " at offset '.$getid3->info['avdataoffset'].', found "'.$ofr_header.'"'); + } + + + + private function ParseOptimFROGheader42() { + + $getid3 = $this->getid3; + + // for fileformat of v4.21 and older + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + $ofr_header_data = fread($getid3->fp, 45); + $getid3->info['avdataoffset'] = 45; + + $ofr_encoder_version_raw = getid3_lib::LittleEndian2Int(substr($ofr_header_data, 0, 1)); + $ofr_encoder_version_major = floor($ofr_encoder_version_raw / 10); + $ofr_encoder_version_minor = $ofr_encoder_version_raw - ($ofr_encoder_version_major * 10); + $riff_data = substr($ofr_header_data, 1, 44); + $origna_riff_header_size = getid3_lib::LittleEndian2Int(substr($riff_data, 4, 4)) + 8; + $origna_riff_data_size = getid3_lib::LittleEndian2Int(substr($riff_data, 40, 4)) + 44; + + if ($origna_riff_header_size > $origna_riff_data_size) { + $getid3->info['avdataend'] -= ($origna_riff_header_size - $origna_riff_data_size); + fseek($getid3->fp, $getid3->info['avdataend'], SEEK_SET); + $riff_data .= fread($getid3->fp, $origna_riff_header_size - $origna_riff_data_size); + } + + // move the data chunk after all other chunks (if any) + // so that the RIFF parser doesn't see EOF when trying + // to skip over the data chunk + + $riff_data = substr($riff_data, 0, 36).substr($riff_data, 44).substr($riff_data, 36, 8); + + // Save audio info key + $saved_info_audio = $getid3->info['audio']; + + // Instantiate riff module and analyze string + $riff = new getid3_riff($getid3); + $riff->AnalyzeString($riff_data); + + // Restore info key + $getid3->info['audio'] = $saved_info_audio; + + $getid3->info['audio']['encoder'] = 'OptimFROG '.$ofr_encoder_version_major.'.'.$ofr_encoder_version_minor; + $getid3->info['audio']['channels'] = $getid3->info['riff']['audio'][0]['channels']; + $getid3->info['audio']['sample_rate'] = $getid3->info['riff']['audio'][0]['sample_rate']; + $getid3->info['audio']['bits_per_sample'] = $getid3->info['riff']['audio'][0]['bits_per_sample']; + $getid3->info['playtime_seconds'] = $origna_riff_data_size / ($getid3->info['audio']['channels'] * $getid3->info['audio']['sample_rate'] * ($getid3->info['audio']['bits_per_sample'] / 8)); + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + + $getid3->info['fileformat'] = 'ofr'; + + return true; + } + + + + private function ParseOptimFROGheader45() { + + $getid3 = $this->getid3; + + // for fileformat of v4.50a and higher + + $riff_data = ''; + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + while (!feof($getid3->fp) && (ftell($getid3->fp) < $getid3->info['avdataend'])) { + + $block_offset = ftell($getid3->fp); + $block_data = fread($getid3->fp, 8); + $offset = 8; + $block_name = substr($block_data, 0, 4); + $block_size = getid3_lib::LittleEndian2Int(substr($block_data, 4, 4)); + + if ($block_name == 'OFRX') { + $block_name = 'OFR '; + } + if (!isset($getid3->info['ofr'][$block_name])) { + $getid3->info['ofr'][$block_name] = array (); + } + $info_ofr_this_block = &$getid3->info['ofr'][$block_name]; + + switch ($block_name) { + case 'OFR ': + + // shortcut + $info_ofr_this_block['offset'] = $block_offset; + $info_ofr_this_block['size'] = $block_size; + + $getid3->info['audio']['encoder'] = 'OptimFROG 4.50 alpha'; + switch ($block_size) { + case 12: + case 15: + // good + break; + + default: + $getid3->warning('"'.$block_name.'" contains more data than expected (expected 12 or 15 bytes, found '.$block_size.' bytes)'); + break; + } + $block_data .= fread($getid3->fp, $block_size); + + $info_ofr_this_block['total_samples'] = getid3_lib::LittleEndian2Int(substr($block_data, $offset, 6)); + $offset += 6; + + $info_ofr_this_block['raw']['sample_type'] = getid3_lib::LittleEndian2Int($block_data{$offset++}); + $info_ofr_this_block['sample_type'] = $this->OptimFROGsampleTypeLookup($info_ofr_this_block['raw']['sample_type']); + + $info_ofr_this_block['channel_config'] = getid3_lib::LittleEndian2Int($block_data{$offset++}); + $info_ofr_this_block['channels'] = $info_ofr_this_block['channel_config']; + + $info_ofr_this_block['sample_rate'] = getid3_lib::LittleEndian2Int(substr($block_data, $offset, 4)); + $offset += 4; + + if ($block_size > 12) { + + // OFR 4.504b or higher + $info_ofr_this_block['channels'] = $this->OptimFROGchannelConfigNumChannelsLookup($info_ofr_this_block['channel_config']); + $info_ofr_this_block['raw']['encoder_id'] = getid3_lib::LittleEndian2Int(substr($block_data, $offset, 2)); + $info_ofr_this_block['encoder'] = $this->OptimFROGencoderNameLookup($info_ofr_this_block['raw']['encoder_id']); + $offset += 2; + + $info_ofr_this_block['raw']['compression'] = getid3_lib::LittleEndian2Int($block_data{$offset++}); + $info_ofr_this_block['compression'] = $this->OptimFROGcompressionLookup($info_ofr_this_block['raw']['compression']); + $info_ofr_this_block['speedup'] = $this->OptimFROGspeedupLookup($info_ofr_this_block['raw']['compression']); + + $getid3->info['audio']['encoder'] = 'OptimFROG '.$info_ofr_this_block['encoder']; + $getid3->info['audio']['encoder_options'] = '--mode '.$info_ofr_this_block['compression']; + + if ((($info_ofr_this_block['raw']['encoder_id'] & 0xF0) >> 4) == 7) { // v4.507 + if (preg_match('/\.ofs$/i', $getid3->filename)) { + // OptimFROG DualStream format is lossy, but as of v4.507 there is no way to tell the difference + // between lossless and lossy other than the file extension. + $getid3->info['audio']['dataformat'] = 'ofs'; + $getid3->info['audio']['lossless'] = true; + } + } + } + + $getid3->info['audio']['channels'] = $info_ofr_this_block['channels']; + $getid3->info['audio']['sample_rate'] = $info_ofr_this_block['sample_rate']; + $getid3->info['audio']['bits_per_sample'] = $this->OptimFROGbitsPerSampleTypeLookup($info_ofr_this_block['raw']['sample_type']); + break; + + + case 'COMP': + // unlike other block types, there CAN be multiple COMP blocks + + $comp_data['offset'] = $block_offset; + $comp_data['size'] = $block_size; + + if ($getid3->info['avdataoffset'] == 0) { + $getid3->info['avdataoffset'] = $block_offset; + } + + // Only interested in first 14 bytes (only first 12 needed for v4.50 alpha), not actual audio data + $block_data .= fread($getid3->fp, 14); + fseek($getid3->fp, $block_size - 14, SEEK_CUR); + + $comp_data['crc_32'] = getid3_lib::LittleEndian2Int(substr($block_data, $offset, 4)); + $offset += 4; + + $comp_data['sample_count'] = getid3_lib::LittleEndian2Int(substr($block_data, $offset, 4)); + $offset += 4; + + $comp_data['raw']['sample_type'] = getid3_lib::LittleEndian2Int($block_data{$offset++}); + $comp_data['sample_type'] = $this->OptimFROGsampleTypeLookup($comp_data['raw']['sample_type']); + + $comp_data['raw']['channel_configuration'] = getid3_lib::LittleEndian2Int($block_data{$offset++}); + $comp_data['channel_configuration'] = $this->OptimFROGchannelConfigurationLookup($comp_data['raw']['channel_configuration']); + + $comp_data['raw']['algorithm_id'] = getid3_lib::LittleEndian2Int(substr($block_data, $offset, 2)); + $offset += 2; + + if ($getid3->info['ofr']['OFR ']['size'] > 12) { + + // OFR 4.504b or higher + $comp_data['raw']['encoder_id'] = getid3_lib::LittleEndian2Int(substr($block_data, $offset, 2)); + $comp_data['encoder'] = $this->OptimFROGencoderNameLookup($comp_data['raw']['encoder_id']); + $offset += 2; + } + + if ($comp_data['crc_32'] == 0x454E4F4E) { + // ASCII value of 'NONE' - placeholder value in v4.50a + $comp_data['crc_32'] = false; + } + + $info_ofr_this_block[] = $comp_data; + break; + + case 'HEAD': + $info_ofr_this_block['offset'] = $block_offset; + $info_ofr_this_block['size'] = $block_size; + + $riff_data .= fread($getid3->fp, $block_size); + break; + + case 'TAIL': + $info_ofr_this_block['offset'] = $block_offset; + $info_ofr_this_block['size'] = $block_size; + + if ($block_size > 0) { + $riff_data .= fread($getid3->fp, $block_size); + } + break; + + case 'RECV': + // block contains no useful meta data - simply note and skip + + $info_ofr_this_block['offset'] = $block_offset; + $info_ofr_this_block['size'] = $block_size; + + fseek($getid3->fp, $block_size, SEEK_CUR); + break; + + + case 'APET': + // APEtag v2 + + $info_ofr_this_block['offset'] = $block_offset; + $info_ofr_this_block['size'] = $block_size; + $getid3->warning('APEtag processing inside OptimFROG not supported in this version ('.GETID3_VERSION.') of getID3()'); + + fseek($getid3->fp, $block_size, SEEK_CUR); + break; + + + case 'MD5 ': + // APEtag v2 + + $info_ofr_this_block['offset'] = $block_offset; + $info_ofr_this_block['size'] = $block_size; + + if ($block_size == 16) { + + $info_ofr_this_block['md5_binary'] = fread($getid3->fp, $block_size); + $info_ofr_this_block['md5_string'] = getid3_lib::PrintHexBytes($info_ofr_this_block['md5_binary'], true, false, false); + $getid3->info['md5_data_source'] = $info_ofr_this_block['md5_string']; + + } else { + + $getid3->warning('Expecting block size of 16 in "MD5 " chunk, found '.$block_size.' instead'); + fseek($getid3->fp, $block_size, SEEK_CUR); + + } + break; + + + default: + $info_ofr_this_block['offset'] = $block_offset; + $info_ofr_this_block['size'] = $block_size; + + $getid3->warning('Unhandled OptimFROG block type "'.$block_name.'" at offset '.$info_ofr_this_block['offset']); + fseek($getid3->fp, $block_size, SEEK_CUR); + break; + } + } + + if (isset($getid3->info['ofr']['TAIL']['offset'])) { + $getid3->info['avdataend'] = $getid3->info['ofr']['TAIL']['offset']; + } + + $getid3->info['playtime_seconds'] = (float)$getid3->info['ofr']['OFR ']['total_samples'] / ($getid3->info['audio']['channels'] * $getid3->info['audio']['sample_rate']); + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + + // move the data chunk after all other chunks (if any) + // so that the RIFF parser doesn't see EOF when trying + // to skip over the data chunk + + $riff_data = substr($riff_data, 0, 36).substr($riff_data, 44).substr($riff_data, 36, 8); + + // Save audio info key + $saved_info_audio = $getid3->info['audio']; + + // Instantiate riff module and analyze string + $riff = new getid3_riff($getid3); + $riff->AnalyzeString($riff_data); + + // Restore info key + $getid3->info['audio'] = $saved_info_audio; + + $getid3->info['fileformat'] = 'ofr'; + + return true; + } + + + + public static function OptimFROGsampleTypeLookup($sample_type) { + + static $lookup = array ( + 0 => 'unsigned int (8-bit)', + 1 => 'signed int (8-bit)', + 2 => 'unsigned int (16-bit)', + 3 => 'signed int (16-bit)', + 4 => 'unsigned int (24-bit)', + 5 => 'signed int (24-bit)', + 6 => 'unsigned int (32-bit)', + 7 => 'signed int (32-bit)', + 8 => 'float 0.24 (32-bit)', + 9 => 'float 16.8 (32-bit)', + 10 => 'float 24.0 (32-bit)' + ); + + return @$lookup[$sample_type]; + } + + + + public static function OptimFROGbitsPerSampleTypeLookup($sample_type) { + + static $lookup = array ( + 0 => 8, + 1 => 8, + 2 => 16, + 3 => 16, + 4 => 24, + 5 => 24, + 6 => 32, + 7 => 32, + 8 => 32, + 9 => 32, + 10 => 32 + ); + + return @$lookup[$sample_type]; + } + + + + public static function OptimFROGchannelConfigurationLookup($channel_configuration) { + + static $lookup = array ( + 0 => 'mono', + 1 => 'stereo' + ); + + return @$lookup[$channel_configuration]; + } + + + + public static function OptimFROGchannelConfigNumChannelsLookup($channel_configuration) { + + static $lookup = array ( + 0 => 1, + 1 => 2 + ); + + return @$lookup[$channel_configuration]; + } + + + + public static function OptimFROGencoderNameLookup($encoder_id) { + + // version = (encoderID >> 4) + 4500 + // system = encoderID & 0xF + + $encoder_version = number_format(((($encoder_id & 0xF0) >> 4) + 4500) / 1000, 3); + $encoder_system_id = ($encoder_id & 0x0F); + + static $lookup = array ( + 0x00 => 'Windows console', + 0x01 => 'Linux console', + 0x0F => 'unknown' + ); + return $encoder_version.' ('.(isset($lookup[$encoder_system_id]) ? $lookup[$encoder_system_id] : 'undefined encoder type (0x'.dechex($encoder_system_id).')').')'; + } + + + + public static function OptimFROGcompressionLookup($compression_id) { + + // mode = compression >> 3 + // speedup = compression & 0x07 + + $compression_mode_id = ($compression_id & 0xF8) >> 3; + //$compression_speed_up_id = ($compression_id & 0x07); + + static $lookup = array ( + 0x00 => 'fast', + 0x01 => 'normal', + 0x02 => 'high', + 0x03 => 'extra', // extranew (some versions) + 0x04 => 'best', // bestnew (some versions) + 0x05 => 'ultra', + 0x06 => 'insane', + 0x07 => 'highnew', + 0x08 => 'extranew', + 0x09 => 'bestnew' + ); + return (isset($lookup[$compression_mode_id]) ? $lookup[$compression_mode_id] : 'undefined mode (0x'.str_pad(dechex($compression_mode_id), 2, '0', STR_PAD_LEFT).')'); + } + + + + public static function OptimFROGspeedupLookup($compression_id) { + + // mode = compression >> 3 + // speedup = compression & 0x07 + + //$compression_mode_id = ($compression_id & 0xF8) >> 3; + $compression_speed_up_id = ($compression_id & 0x07); + + static $lookup = array ( + 0x00 => '1x', + 0x01 => '2x', + 0x02 => '4x' + ); + + return (isset($lookup[$compression_speed_up_id]) ? $lookup[$compression_speed_up_id] : 'undefined mode (0x'.dechex($compression_speed_up_id)); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.rkau.php b/modules/getid3/module.audio.rkau.php new file mode 100644 index 00000000..15363f50 --- /dev/null +++ b/modules/getid3/module.audio.rkau.php @@ -0,0 +1,101 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.rkau.php | +// | Module for analyzing RKAU Audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.rkau.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_rkau extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $rkau_header = fread($getid3->fp, 20); + + // Magic bytes 'RKA' + + $getid3->info['fileformat'] = 'rkau'; + $getid3->info['audio']['dataformat'] = 'rkau'; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + + // Shortcut + $getid3->info['rkau'] = array (); + $info_rkau = &$getid3->info['rkau']; + + $info_rkau['raw']['version'] = getid3_lib::LittleEndian2Int(substr($rkau_header, 3, 1)); + $info_rkau['version'] = '1.'.str_pad($info_rkau['raw']['version'] & 0x0F, 2, '0', STR_PAD_LEFT); + if (($info_rkau['version'] > 1.07) || ($info_rkau['version'] < 1.06)) { + throw new getid3_exception('This version of getID3() can only parse RKAU files v1.06 and 1.07 (this file is v'.$info_rkau['version'].')'); + } + + getid3_lib::ReadSequence('LittleEndian2Int', $info_rkau, $rkau_header, 4, + array ( + 'source_bytes' => 4, + 'sample_rate' => 4, + 'channels' => 1, + 'bits_per_sample' => 1 + ) + ); + + $info_rkau['raw']['quality'] = getid3_lib::LittleEndian2Int(substr($rkau_header, 14, 1)); + + $quality = $info_rkau['raw']['quality'] & 0x0F; + + $info_rkau['lossless'] = (($quality == 0) ? true : false); + $info_rkau['compression_level'] = (($info_rkau['raw']['quality'] & 0xF0) >> 4) + 1; + if (!$info_rkau['lossless']) { + $info_rkau['quality_setting'] = $quality; + } + + $info_rkau['raw']['flags'] = getid3_lib::LittleEndian2Int(substr($rkau_header, 15, 1)); + $info_rkau['flags']['joint_stereo'] = (bool)(!($info_rkau['raw']['flags'] & 0x01)); + $info_rkau['flags']['streaming'] = (bool) ($info_rkau['raw']['flags'] & 0x02); + $info_rkau['flags']['vrq_lossy_mode'] = (bool) ($info_rkau['raw']['flags'] & 0x04); + + if ($info_rkau['flags']['streaming']) { + $getid3->info['avdataoffset'] += 20; + $info_rkau['compressed_bytes'] = getid3_lib::LittleEndian2Int(substr($rkau_header, 16, 4)); + } + else { + $getid3->info['avdataoffset'] += 16; + $info_rkau['compressed_bytes'] = $getid3->info['avdataend'] - $getid3->info['avdataoffset'] - 1; + } + // Note: compressed_bytes does not always equal what appears to be the actual number of compressed bytes, + // sometimes it's more, sometimes less. No idea why(?) + + $getid3->info['audio']['lossless'] = $info_rkau['lossless']; + $getid3->info['audio']['channels'] = $info_rkau['channels']; + $getid3->info['audio']['bits_per_sample'] = $info_rkau['bits_per_sample']; + $getid3->info['audio']['sample_rate'] = $info_rkau['sample_rate']; + + $getid3->info['playtime_seconds'] = $info_rkau['source_bytes'] / ($info_rkau['sample_rate'] * $info_rkau['channels'] * ($info_rkau['bits_per_sample'] / 8)); + $getid3->info['audio']['bitrate'] = ($info_rkau['compressed_bytes'] * 8) / $getid3->info['playtime_seconds']; + + return true; + + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.shorten.php b/modules/getid3/module.audio.shorten.php new file mode 100644 index 00000000..2d2c04fa --- /dev/null +++ b/modules/getid3/module.audio.shorten.php @@ -0,0 +1,121 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.shorten.php | +// | Module for analyzing Shorten Audio files | +// | dependencies: module.audio-video.riff.php | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.shorten.php,v 1.5 2006/12/03 19:28:18 ah Exp $ + + + +class getid3_shorten extends getid3_handler +{ + + public function __construct(getID3 $getid3) { + + parent::__construct($getid3); + + if ((bool)ini_get('safe_mode')) { + throw new getid3_exception('PHP running in Safe Mode - backtick operator not available, cannot analyze Shorten files.'); + } + + if (!`head --version`) { + throw new getid3_exception('head[.exe] binary not found in path. UNIX: typically /usr/bin. Windows: typically c:\windows\system32.'); + } + + if (!`shorten -l`) { + throw new getid3_exception('shorten[.exe] binary not found in path. UNIX: typically /usr/bin. Windows: typically c:\windows\system32.'); + } + } + + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->include_module('audio-video.riff'); + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + $shn_header = fread($getid3->fp, 8); + + // Magic bytes: "ajkg" + + $getid3->info['fileformat'] = 'shn'; + $getid3->info['audio']['dataformat'] = 'shn'; + $getid3->info['audio']['lossless'] = true; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + + $getid3->info['shn']['version'] = getid3_lib::LittleEndian2Int($shn_header{4}); + + fseek($getid3->fp, $getid3->info['avdataend'] - 12, SEEK_SET); + + $seek_table_signature_test = fread($getid3->fp, 12); + + $getid3->info['shn']['seektable']['present'] = (bool)(substr($seek_table_signature_test, 4, 8) == 'SHNAMPSK'); + if ($getid3->info['shn']['seektable']['present']) { + + $getid3->info['shn']['seektable']['length'] = getid3_lib::LittleEndian2Int(substr($seek_table_signature_test, 0, 4)); + $getid3->info['shn']['seektable']['offset'] = $getid3->info['avdataend'] - $getid3->info['shn']['seektable']['length']; + fseek($getid3->fp, $getid3->info['shn']['seektable']['offset'], SEEK_SET); + $seek_table_magic = fread($getid3->fp, 4); + + if ($seek_table_magic != 'SEEK') { + + throw new getid3_exception('Expecting "SEEK" at offset '.$getid3->info['shn']['seektable']['offset'].', found "'.$seek_table_magic.'"'); + } + + $seek_table_data = fread($getid3->fp, $getid3->info['shn']['seektable']['length'] - 16); + $getid3->info['shn']['seektable']['entry_count'] = floor(strlen($seek_table_data) / 80); + } + + $commandline = 'shorten -x '.escapeshellarg(realpath($getid3->filename)).' - | head -c 64'; + $output = `$commandline`; + + if (@$output && substr($output, 12, 4) == 'fmt ') { + + $fmt_size = getid3_lib::LittleEndian2Int(substr($output, 16, 4)); + $decoded_wav_format_ex = getid3_riff::RIFFparseWAVEFORMATex(substr($output, 20, $fmt_size)); + + $getid3->info['audio']['channels'] = $decoded_wav_format_ex['channels']; + $getid3->info['audio']['bits_per_sample'] = $decoded_wav_format_ex['bits_per_sample']; + $getid3->info['audio']['sample_rate'] = $decoded_wav_format_ex['sample_rate']; + + if (substr($output, 20 + $fmt_size, 4) == 'data') { + + $getid3->info['playtime_seconds'] = getid3_lib::LittleEndian2Int(substr($output, 20 + 4 + $fmt_size, 4)) / $decoded_wav_format_ex['raw']['nAvgBytesPerSec']; + + } else { + + throw new getid3_exception('shorten failed to decode DATA chunk to expected location, cannot determine playtime'); + } + + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) / $getid3->info['playtime_seconds']) * 8; + + } else { + + throw new getid3_exception('shorten failed to decode file to WAV for parsing'); + return false; + } + + return true; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.tta.php b/modules/getid3/module.audio.tta.php new file mode 100644 index 00000000..80b2be82 --- /dev/null +++ b/modules/getid3/module.audio.tta.php @@ -0,0 +1,125 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.tta.php | +// | Module for analyzing TTA Audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.tta.php,v 1.2 2006/11/02 10:48:01 ah Exp $ + + + +class getid3_tta extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'tta'; + $getid3->info['audio']['dataformat'] = 'tta'; + $getid3->info['audio']['lossless'] = true; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $tta_header = fread($getid3->fp, 26); + + $getid3->info['tta']['magic'] = 'TTA'; // Magic bytes + + switch ($tta_header{3}) { + + case "\x01": // TTA v1.x + case "\x02": // TTA v1.x + case "\x03": // TTA v1.x + + // "It was the demo-version of the TTA encoder. There is no released format with such header. TTA encoder v1 is not supported about a year." + $getid3->info['tta']['major_version'] = 1; + $getid3->info['avdataoffset'] += 16; + + getid3_lib::ReadSequence('LittleEndian2Int', $getid3->info['tta'], $tta_header, 4, + array ( + 'channels' => 2, + 'bits_per_sample' => 2, + 'sample_rate' => 4, + 'samples_per_channel' => 4 + ) + ); + $getid3->info['tta']['compression_level'] = ord($tta_header{3}); + + $getid3->info['audio']['encoder_options'] = '-e'.$getid3->info['tta']['compression_level']; + $getid3->info['playtime_seconds'] = $getid3->info['tta']['samples_per_channel'] / $getid3->info['tta']['sample_rate']; + break; + + case '2': // TTA v2.x + // "I have hurried to release the TTA 2.0 encoder. Format documentation is removed from our site. This format still in development. Please wait the TTA2 format, encoder v4." + $getid3->info['tta']['major_version'] = 2; + $getid3->info['avdataoffset'] += 20; + + getid3_lib::ReadSequence('LittleEndian2Int', $getid3->info['tta'], $tta_header, 4, + array ( + 'compression_level' => 2, + 'audio_format' => 2, + 'channels' => 2, + 'bits_per_sample' => 2, + 'sample_rate' => 4, + 'data_length' => 4 + ) + ); + + $getid3->info['audio']['encoder_options'] = '-e'.$getid3->info['tta']['compression_level']; + $getid3->info['playtime_seconds'] = $getid3->info['tta']['data_length'] / $getid3->info['tta']['sample_rate']; + break; + + case '1': // TTA v3.x + // "This is a first stable release of the TTA format. It will be supported by the encoders v3 or higher." + $getid3->info['tta']['major_version'] = 3; + $getid3->info['avdataoffset'] += 26; + + getid3_lib::ReadSequence('LittleEndian2Int', $getid3->info['tta'], $tta_header, 4, + array ( + 'audio_format' => 2, + 'channels' => 2, + 'bits_per_sample'=> 2, + 'sample_rate' => 4, + 'data_length' => 4, + 'crc32_footer' => -4, // string + 'seek_point' => 4 + ) + ); + + $getid3->info['playtime_seconds'] = $getid3->info['tta']['data_length'] / $getid3->info['tta']['sample_rate']; + break; + + default: + throw new getid3_exception('This version of getID3() only knows how to handle TTA v1, v2 and v3 - it may not work correctly with this file which appears to be TTA v'.$tta_header{3}); + return false; + break; + } + + $getid3->info['audio']['encoder'] = 'TTA v'.$getid3->info['tta']['major_version']; + $getid3->info['audio']['bits_per_sample'] = $getid3->info['tta']['bits_per_sample']; + $getid3->info['audio']['sample_rate'] = $getid3->info['tta']['sample_rate']; + $getid3->info['audio']['channels'] = $getid3->info['tta']['channels']; + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + + return true; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.voc.php b/modules/getid3/module.audio.voc.php new file mode 100644 index 00000000..3103dffc --- /dev/null +++ b/modules/getid3/module.audio.voc.php @@ -0,0 +1,240 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.voc.php | +// | Module for analyzing Creative VOC Audio files. | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.voc.php,v 1.3 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_voc extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $original_av_data_offset = $getid3->info['avdataoffset']; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $voc_header= fread($getid3->fp, 26); + + // Magic bytes: 'Creative Voice File' + + $info_audio = &$getid3->info['audio']; + $getid3->info['voc'] = array (); + $info_voc = &$getid3->info['voc']; + + $getid3->info['fileformat'] = 'voc'; + $info_audio['dataformat'] = 'voc'; + $info_audio['bitrate_mode'] = 'cbr'; + $info_audio['lossless'] = true; + $info_audio['channels'] = 1; // might be overriden below + $info_audio['bits_per_sample'] = 8; // might be overriden below + + // byte # Description + // ------ ------------------------------------------ + // 00-12 'Creative Voice File' + // 13 1A (eof to abort printing of file) + // 14-15 Offset of first datablock in .voc file (std 1A 00 in Intel Notation) + // 16-17 Version number (minor,major) (VOC-HDR puts 0A 01) + // 18-19 2's Comp of Ver. # + 1234h (VOC-HDR puts 29 11) + + getid3_lib::ReadSequence('LittleEndian2Int', $info_voc['header'], $voc_header, 20, + array ( + 'datablock_offset' => 2, + 'minor_version' => 1, + 'major_version' => 1 + ) + ); + + do { + $block_offset = ftell($getid3->fp); + $block_data = fread($getid3->fp, 4); + $block_type = ord($block_data{0}); + $block_size = getid3_lib::LittleEndian2Int(substr($block_data, 1, 3)); + $this_block = array (); + + @$info_voc['blocktypes'][$block_type]++; + + switch ($block_type) { + + case 0: // Terminator + // do nothing, we'll break out of the loop down below + break; + + case 1: // Sound data + $block_data .= fread($getid3->fp, 2); + if ($getid3->info['avdataoffset'] <= $original_av_data_offset) { + $getid3->info['avdataoffset'] = ftell($getid3->fp); + } + fseek($getid3->fp, $block_size - 2, SEEK_CUR); + + getid3_lib::ReadSequence('LittleEndian2Int', $this_block, $block_data, 4, + array ( + 'sample_rate_id' => 1, + 'compression_type' => 1 + ) + ); + + $this_block['compression_name'] = getid3_voc::VOCcompressionTypeLookup($this_block['compression_type']); + if ($this_block['compression_type'] <= 3) { + $info_voc['compressed_bits_per_sample'] = (int)(str_replace('-bit', '', $this_block['compression_name'])); + } + + // Less accurate sample_rate calculation than the Extended block (#8) data (but better than nothing if Extended Block is not available) + if (empty($info_audio['sample_rate'])) { + // SR byte = 256 - (1000000 / sample_rate) + $info_audio['sample_rate'] = (int)floor((1000000 / (256 - $this_block['sample_rate_id'])) / $info_audio['channels']); + } + break; + + case 2: // Sound continue + case 3: // Silence + case 4: // Marker + case 6: // Repeat + case 7: // End repeat + // nothing useful, just skip + fseek($getid3->fp, $block_size, SEEK_CUR); + break; + + case 8: // Extended + $block_data .= fread($getid3->fp, 4); + + //00-01 Time Constant: + // Mono: 65536 - (256000000 / sample_rate) + // Stereo: 65536 - (256000000 / (sample_rate * 2)) + getid3_lib::ReadSequence('LittleEndian2Int', $this_block, $block_data, 4, + array ( + 'time_constant' => 2, + 'pack_method' => 1, + 'stereo' => 1 + ) + ); + $this_block['stereo'] = (bool)$this_block['stereo']; + + $info_audio['channels'] = ($this_block['stereo'] ? 2 : 1); + $info_audio['sample_rate'] = (int)floor((256000000 / (65536 - $this_block['time_constant'])) / $info_audio['channels']); + break; + + case 9: // data block that supersedes blocks 1 and 8. Used for stereo, 16 bit + $block_data .= fread($getid3->fp, 12); + if ($getid3->info['avdataoffset'] <= $original_av_data_offset) { + $getid3->info['avdataoffset'] = ftell($getid3->fp); + } + fseek($getid3->fp, $block_size - 12, SEEK_CUR); + + getid3_lib::ReadSequence('LittleEndian2Int', $this_block, $block_data, 4, + array ( + 'sample_rate' => 4, + 'bits_per_sample' => 1, + 'channels' => 1, + 'wFormat' => 2 + ) + ); + + $this_block['compression_name'] = getid3_voc::VOCwFormatLookup($this_block['wFormat']); + if (getid3_voc::VOCwFormatActualBitsPerSampleLookup($this_block['wFormat'])) { + $info_voc['compressed_bits_per_sample'] = getid3_voc::VOCwFormatActualBitsPerSampleLookup($this_block['wFormat']); + } + + $info_audio['sample_rate'] = $this_block['sample_rate']; + $info_audio['bits_per_sample'] = $this_block['bits_per_sample']; + $info_audio['channels'] = $this_block['channels']; + break; + + default: + $getid3->warning('Unhandled block type "'.$block_type.'" at offset '.$block_offset); + fseek($getid3->fp, $block_size, SEEK_CUR); + break; + } + + if (!empty($this_block)) { + $this_block['block_offset'] = $block_offset; + $this_block['block_size'] = $block_size; + $this_block['block_type_id'] = $block_type; + $info_voc['blocks'][] = $this_block; + } + + } while (!feof($getid3->fp) && ($block_type != 0)); + + // Terminator block doesn't have size field, so seek back 3 spaces + fseek($getid3->fp, -3, SEEK_CUR); + + ksort($info_voc['blocktypes']); + + if (!empty($info_voc['compressed_bits_per_sample'])) { + $getid3->info['playtime_seconds'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / ($info_voc['compressed_bits_per_sample'] * $info_audio['channels'] * $info_audio['sample_rate']); + $info_audio['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + } + + return true; + } + + + + public static function VOCcompressionTypeLookup($index) { + + static $lookup = array ( + 0 => '8-bit', + 1 => '4-bit', + 2 => '2.6-bit', + 3 => '2-bit' + ); + return (isset($lookup[$index]) ? $lookup[$index] : 'Multi DAC ('.($index - 3).') channels'); + } + + + + public static function VOCwFormatLookup($index) { + + static $lookup = array ( + 0x0000 => '8-bit unsigned PCM', + 0x0001 => 'Creative 8-bit to 4-bit ADPCM', + 0x0002 => 'Creative 8-bit to 3-bit ADPCM', + 0x0003 => 'Creative 8-bit to 2-bit ADPCM', + 0x0004 => '16-bit signed PCM', + 0x0006 => 'CCITT a-Law', + 0x0007 => 'CCITT u-Law', + 0x2000 => 'Creative 16-bit to 4-bit ADPCM' + ); + return (isset($lookup[$index]) ? $lookup[$index] : false); + } + + + + public static function VOCwFormatActualBitsPerSampleLookup($index) { + + static $lookup = array ( + 0x0000 => 8, + 0x0001 => 4, + 0x0002 => 3, + 0x0003 => 2, + 0x0004 => 16, + 0x0006 => 8, + 0x0007 => 8, + 0x2000 => 4 + ); + return (isset($lookup[$index]) ? $lookup[$index] : false); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.vqf.php b/modules/getid3/module.audio.vqf.php new file mode 100644 index 00000000..fe7861d4 --- /dev/null +++ b/modules/getid3/module.audio.vqf.php @@ -0,0 +1,164 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.vqf.php | +// | Module for analyzing VQF Audio files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.vqf.php,v 1.3 2006/11/16 23:16:31 ah Exp $ + + + +class getid3_vqf extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + // based loosely on code from TTwinVQ by Jurgen Faul + // http://jfaul.de/atl or http://j-faul.virtualave.net/atl/atl.html + + $getid3->info['fileformat'] = 'vqf'; + $getid3->info['audio']['dataformat'] = 'vqf'; + $getid3->info['audio']['bitrate_mode'] = 'cbr'; + $getid3->info['audio']['lossless'] = false; + + // Shortcuts + $getid3->info['vqf']['raw'] = array (); + $info_vqf = &$getid3->info['vqf']; + $info_vqf_raw = &$info_vqf['raw']; + + // Get header + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $vqf_header_data = fread($getid3->fp, 16); + + $info_vqf_raw['header_tag'] = 'TWIN'; // Magic bytes + $info_vqf_raw['version'] = substr($vqf_header_data, 4, 8); + $info_vqf_raw['size'] = getid3_lib::BigEndian2Int(substr($vqf_header_data, 12, 4)); + + while (ftell($getid3->fp) < $getid3->info['avdataend']) { + + $chunk_base_offset = ftell($getid3->fp); + $chunk_data = fread($getid3->fp, 8); + $chunk_name = substr($chunk_data, 0, 4); + + if ($chunk_name == 'DATA') { + $getid3->info['avdataoffset'] = $chunk_base_offset; + break; + } + + $chunk_size = getid3_lib::BigEndian2Int(substr($chunk_data, 4, 4)); + if ($chunk_size > ($getid3->info['avdataend'] - ftell($getid3->fp))) { + throw new getid3_exception('Invalid chunk size ('.$chunk_size.') for chunk "'.$chunk_name.'" at offset 8.'); + } + if ($chunk_size > 0) { + $chunk_data .= fread($getid3->fp, $chunk_size); + } + + switch ($chunk_name) { + + case 'COMM': + $info_vqf['COMM'] = array (); + getid3_lib::ReadSequence('BigEndian2Int', $info_vqf['COMM'], $chunk_data, 8, + array ( + 'channel_mode' => 4, + 'bitrate' => 4, + 'sample_rate' => 4, + 'security_level' => 4 + ) + ); + + $getid3->info['audio']['channels'] = $info_vqf['COMM']['channel_mode'] + 1; + $getid3->info['audio']['sample_rate'] = getid3_vqf::VQFchannelFrequencyLookup($info_vqf['COMM']['sample_rate']); + $getid3->info['audio']['bitrate'] = $info_vqf['COMM']['bitrate'] * 1000; + $getid3->info['audio']['encoder_options'] = 'CBR' . ceil($getid3->info['audio']['bitrate']/1000); + + if ($getid3->info['audio']['bitrate'] == 0) { + throw new getid3_exception('Corrupt VQF file: bitrate_audio == zero'); + } + break; + + case 'NAME': + case 'AUTH': + case '(c) ': + case 'FILE': + case 'COMT': + case 'ALBM': + $info_vqf['comments'][getid3_vqf::VQFcommentNiceNameLookup($chunk_name)][] = trim(substr($chunk_data, 8)); + break; + + case 'DSIZ': + $info_vqf['DSIZ'] = getid3_lib::BigEndian2Int(substr($chunk_data, 8, 4)); + break; + + default: + $getid3->warning('Unhandled chunk type "'.$chunk_name.'" at offset 8'); + break; + } + } + + $getid3->info['playtime_seconds'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['audio']['bitrate']; + + if (isset($info_vqf['DSIZ']) && (($info_vqf['DSIZ'] != ($getid3->info['avdataend'] - $getid3->info['avdataoffset'] - strlen('DATA'))))) { + switch ($info_vqf['DSIZ']) { + case 0: + case 1: + $getid3->warning('Invalid DSIZ value "'.$info_vqf['DSIZ'].'". This is known to happen with VQF files encoded by Ahead Nero, and seems to be its way of saying this is TwinVQF v'.($info_vqf['DSIZ'] + 1).'.0'); + $getid3->info['audio']['encoder'] = 'Ahead Nero'; + break; + + default: + $getid3->warning('Probable corrupted file - should be '.$info_vqf['DSIZ'].' bytes, actually '.($getid3->info['avdataend'] - $getid3->info['avdataoffset'] - strlen('DATA'))); + break; + } + } + + return true; + } + + + + public static function VQFchannelFrequencyLookup($frequencyid) { + + static $lookup = array ( + 11 => 11025, + 22 => 22050, + 44 => 44100 + ); + return (isset($lookup[$frequencyid]) ? $lookup[$frequencyid] : $frequencyid * 1000); + } + + + + public static function VQFcommentNiceNameLookup($shortname) { + + static $lookup = array ( + 'NAME' => 'title', + 'AUTH' => 'artist', + '(c) ' => 'copyright', + 'FILE' => 'filename', + 'COMT' => 'comment', + 'ALBM' => 'album' + ); + return (isset($lookup[$shortname]) ? $lookup[$shortname] : $shortname); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.wavpack.php b/modules/getid3/module.audio.wavpack.php new file mode 100644 index 00000000..862e7483 --- /dev/null +++ b/modules/getid3/module.audio.wavpack.php @@ -0,0 +1,399 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.wavpack.php | +// | module for analyzing WavPack v4.0+ Audio files | +// | dependencies: audio-video.riff | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.wavpack.php,v 1.2 2006/11/02 10:48:02 ah Exp $ + + +class getid3_wavpack extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->include_module('audio-video.riff'); + + $getid3->info['wavpack'] = array (); + $info_wavpack = &$getid3->info['wavpack']; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + while (true) { + + $wavpack_header = fread($getid3->fp, 32); + + if (ftell($getid3->fp) >= $getid3->info['avdataend']) { + break; + } elseif (feof($getid3->fp)) { + break; + } elseif ( + (@$info_wavpack_blockheader['total_samples'] > 0) && + (@$info_wavpack_blockheader['block_samples'] > 0) && + (!isset($info_wavpack['riff_trailer_size']) || ($info_wavpack['riff_trailer_size'] <= 0)) && + ((@$info_wavpack['config_flags']['md5_checksum'] === false) || !empty($getid3->info['md5_data_source']))) { + break; + } + + $block_header_offset = ftell($getid3->fp) - 32; + $block_header_magic = substr($wavpack_header, 0, 4); + $block_header_size = getid3_lib::LittleEndian2Int(substr($wavpack_header, 4, 4)); + + if ($block_header_magic != 'wvpk') { + throw new getid3_exception('Expecting "wvpk" at offset '.$block_header_offset.', found "'.$block_header_magic.'"'); + } + + if ((@$info_wavpack_blockheader['block_samples'] <= 0) || (@$info_wavpack_blockheader['total_samples'] <= 0)) { + + // Also, it is possible that the first block might not have + // any samples (block_samples == 0) and in this case you should skip blocks + // until you find one with samples because the other information (like + // total_samples) are not guaranteed to be correct until (block_samples > 0) + + // Finally, I have defined a format for files in which the length is not known + // (for example when raw files are created using pipes). In these cases + // total_samples will be -1 and you must seek to the final block to determine + // the total number of samples. + + + $getid3->info['audio']['dataformat'] = 'wavpack'; + $getid3->info['fileformat'] = 'wavpack'; + $getid3->info['audio']['lossless'] = true; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + + $info_wavpack['blockheader']['offset'] = $block_header_offset; + $info_wavpack['blockheader']['magic'] = $block_header_magic; + $info_wavpack['blockheader']['size'] = $block_header_size; + $info_wavpack_blockheader = &$info_wavpack['blockheader']; + + if ($info_wavpack_blockheader['size'] >= 0x100000) { + throw new getid3_exception('Expecting WavPack block size less than "0x100000", found "'.$info_wavpack_blockheader['size'].'" at offset '.$info_wavpack_blockheader['offset']); + } + + $info_wavpack_blockheader['minor_version'] = ord($wavpack_header{8}); + $info_wavpack_blockheader['major_version'] = ord($wavpack_header{9}); + + if (($info_wavpack_blockheader['major_version'] != 4) || + (($info_wavpack_blockheader['minor_version'] < 4) && + ($info_wavpack_blockheader['minor_version'] > 16))) { + throw new getid3_exception('Expecting WavPack version between "4.2" and "4.16", found version "'.$info_wavpack_blockheader['major_version'].'.'.$info_wavpack_blockheader['minor_version'].'" at offset '.$info_wavpack_blockheader['offset']); + } + + $info_wavpack_blockheader['track_number'] = ord($wavpack_header{10}); // unused + $info_wavpack_blockheader['index_number'] = ord($wavpack_header{11}); // unused + + getid3_lib::ReadSequence('LittleEndian2Int', $info_wavpack_blockheader, $wavpack_header, 12, + array ( + 'total_samples' => 4, + 'block_index' => 4, + 'block_samples' => 4, + 'flags_raw' => 4, + 'crc' => 4 + ) + ); + + + $info_wavpack_blockheader['flags']['bytes_per_sample'] = 1 + ($info_wavpack_blockheader['flags_raw'] & 0x00000003); + $info_wavpack_blockheader['flags']['mono'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000004); + $info_wavpack_blockheader['flags']['hybrid'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000008); + $info_wavpack_blockheader['flags']['joint_stereo'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000010); + $info_wavpack_blockheader['flags']['cross_decorrelation'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000020); + $info_wavpack_blockheader['flags']['hybrid_noiseshape'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000040); + $info_wavpack_blockheader['flags']['ieee_32bit_float'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000080); + $info_wavpack_blockheader['flags']['int_32bit'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000100); + $info_wavpack_blockheader['flags']['hybrid_bitrate_noise'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000200); + $info_wavpack_blockheader['flags']['hybrid_balance_noise'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000400); + $info_wavpack_blockheader['flags']['multichannel_initial'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00000800); + $info_wavpack_blockheader['flags']['multichannel_final'] = (bool) ($info_wavpack_blockheader['flags_raw'] & 0x00001000); + + $getid3->info['audio']['lossless'] = !$info_wavpack_blockheader['flags']['hybrid']; + } + + + while (!feof($getid3->fp) && (ftell($getid3->fp) < ($block_header_offset + $block_header_size + 8))) { + + $metablock = array('offset'=>ftell($getid3->fp)); + $metablockheader = fread($getid3->fp, 2); + if (feof($getid3->fp)) { + break; + } + $metablock['id'] = ord($metablockheader{0}); + $metablock['function_id'] = ($metablock['id'] & 0x3F); + $metablock['function_name'] = $this->WavPackMetablockNameLookup($metablock['function_id']); + + // The 0x20 bit in the id of the meta subblocks (which is defined as + // ID_OPTIONAL_DATA) is a permanent part of the id. The idea is that + // if a decoder encounters an id that it does not know about, it uses + // that "ID_OPTIONAL_DATA" flag to determine what to do. If it is set + // then the decoder simply ignores the metadata, but if it is zero + // then the decoder should quit because it means that an understanding + // of the metadata is required to correctly decode the audio. + + $metablock['non_decoder'] = (bool) ($metablock['id'] & 0x20); + $metablock['padded_data'] = (bool) ($metablock['id'] & 0x40); + $metablock['large_block'] = (bool) ($metablock['id'] & 0x80); + if ($metablock['large_block']) { + $metablockheader .= fread($getid3->fp, 2); + } + $metablock['size'] = getid3_lib::LittleEndian2Int(substr($metablockheader, 1)) * 2; // size is stored in words + $metablock['data'] = null; + + if ($metablock['size'] > 0) { + + switch ($metablock['function_id']) { + + case 0x21: // ID_RIFF_HEADER + case 0x22: // ID_RIFF_TRAILER + case 0x23: // ID_REPLAY_GAIN + case 0x24: // ID_CUESHEET + case 0x25: // ID_CONFIG_BLOCK + case 0x26: // ID_MD5_CHECKSUM + $metablock['data'] = fread($getid3->fp, $metablock['size']); + + if ($metablock['padded_data']) { + // padded to the nearest even byte + $metablock['size']--; + $metablock['data'] = substr($metablock['data'], 0, -1); + } + break; + + + case 0x00: // ID_DUMMY + case 0x01: // ID_ENCODER_INFO + case 0x02: // ID_DECORR_TERMS + case 0x03: // ID_DECORR_WEIGHTS + case 0x04: // ID_DECORR_SAMPLES + case 0x05: // ID_ENTROPY_VARS + case 0x06: // ID_HYBRID_PROFILE + case 0x07: // ID_SHAPING_WEIGHTS + case 0x08: // ID_FLOAT_INFO + case 0x09: // ID_INT32_INFO + case 0x0A: // ID_WV_BITSTREAM + case 0x0B: // ID_WVC_BITSTREAM + case 0x0C: // ID_WVX_BITSTREAM + case 0x0D: // ID_CHANNEL_INFO + fseek($getid3->fp, $metablock['offset'] + ($metablock['large_block'] ? 4 : 2) + $metablock['size'], SEEK_SET); + break; + + + default: + $getid3->warning('Unexpected metablock type "0x'.str_pad(dechex($metablock['function_id']), 2, '0', STR_PAD_LEFT).'" at offset '.$metablock['offset']); + fseek($getid3->fp, $metablock['offset'] + ($metablock['large_block'] ? 4 : 2) + $metablock['size'], SEEK_SET); + break; + } + + + switch ($metablock['function_id']) { + + case 0x21: // ID_RIFF_HEADER + + $original_wav_filesize = getid3_lib::LittleEndian2Int(substr($metablock['data'], 4, 4)); + + // Clone getid3 + $clone = clone $getid3; + + // Analyze clone by string + $riff = new getid3_riff($clone); + $riff->AnalyzeString($metablock['data']); + + // Import from clone and destroy + $metablock['riff'] = $clone->info['riff']; + $getid3->warnings($clone->warnings()); + unset($clone); + + // Save RIFF header - we may need it later for RIFF footer parsing + $this->riff_header = $metablock['data']; + + $metablock['riff']['original_filesize'] = $original_wav_filesize; + $info_wavpack['riff_trailer_size'] = $original_wav_filesize - $metablock['riff']['WAVE']['data'][0]['size'] - $metablock['riff']['header_size']; + + $getid3->info['audio']['sample_rate'] = $metablock['riff']['raw']['fmt ']['nSamplesPerSec']; + $getid3->info['playtime_seconds'] = $info_wavpack_blockheader['total_samples'] / $getid3->info['audio']['sample_rate']; + + // Safe RIFF header in case there's a RIFF footer later + $metablock_riff_header = $metablock['data']; + break; + + + case 0x22: // ID_RIFF_TRAILER + + $metablock_riff_footer = $metablock_riff_header.$metablock['data']; + + $start_offset = $metablock['offset'] + ($metablock['large_block'] ? 4 : 2); + + $ftell_old = ftell($getid3->fp); + + // Clone getid3 + $clone = clone $getid3; + + // Call public method that really should be private + $riff = new getid3_riff($clone); + $metablock['riff'] = $riff->ParseRIFF($start_offset, $start_offset + $metablock['size']); + unset($clone); + + fseek($getid3->fp, $ftell_old, SEEK_SET); + + if (!empty($metablock['riff']['INFO'])) { + getid3_riff::RIFFCommentsParse($metablock['riff']['INFO'], $metablock['comments']); + $getid3->info['tags']['riff'] = $metablock['comments']; + } + break; + + + case 0x23: // ID_REPLAY_GAIN + $getid3->warning('WavPack "Replay Gain" contents not yet handled by getID3() in metablock at offset '.$metablock['offset']); + break; + + + case 0x24: // ID_CUESHEET + $getid3->warning('WavPack "Cuesheet" contents not yet handled by getID3() in metablock at offset '.$metablock['offset']); + break; + + + case 0x25: // ID_CONFIG_BLOCK + $metablock['flags_raw'] = getid3_lib::LittleEndian2Int(substr($metablock['data'], 0, 3)); + + $metablock['flags']['adobe_mode'] = (bool) ($metablock['flags_raw'] & 0x000001); // "adobe" mode for 32-bit floats + $metablock['flags']['fast_flag'] = (bool) ($metablock['flags_raw'] & 0x000002); // fast mode + $metablock['flags']['very_fast_flag'] = (bool) ($metablock['flags_raw'] & 0x000004); // double fast + $metablock['flags']['high_flag'] = (bool) ($metablock['flags_raw'] & 0x000008); // high quality mode + $metablock['flags']['very_high_flag'] = (bool) ($metablock['flags_raw'] & 0x000010); // double high (not used yet) + $metablock['flags']['bitrate_kbps'] = (bool) ($metablock['flags_raw'] & 0x000020); // bitrate is kbps, not bits / sample + $metablock['flags']['auto_shaping'] = (bool) ($metablock['flags_raw'] & 0x000040); // automatic noise shaping + $metablock['flags']['shape_override'] = (bool) ($metablock['flags_raw'] & 0x000080); // shaping mode specified + $metablock['flags']['joint_override'] = (bool) ($metablock['flags_raw'] & 0x000100); // joint-stereo mode specified + $metablock['flags']['copy_time'] = (bool) ($metablock['flags_raw'] & 0x000200); // copy file-time from source + $metablock['flags']['create_exe'] = (bool) ($metablock['flags_raw'] & 0x000400); // create executable + $metablock['flags']['create_wvc'] = (bool) ($metablock['flags_raw'] & 0x000800); // create correction file + $metablock['flags']['optimize_wvc'] = (bool) ($metablock['flags_raw'] & 0x001000); // maximize bybrid compression + $metablock['flags']['quality_mode'] = (bool) ($metablock['flags_raw'] & 0x002000); // psychoacoustic quality mode + $metablock['flags']['raw_flag'] = (bool) ($metablock['flags_raw'] & 0x004000); // raw mode (not implemented yet) + $metablock['flags']['calc_noise'] = (bool) ($metablock['flags_raw'] & 0x008000); // calc noise in hybrid mode + $metablock['flags']['lossy_mode'] = (bool) ($metablock['flags_raw'] & 0x010000); // obsolete (for information) + $metablock['flags']['extra_mode'] = (bool) ($metablock['flags_raw'] & 0x020000); // extra processing mode + $metablock['flags']['skip_wvx'] = (bool) ($metablock['flags_raw'] & 0x040000); // no wvx stream w/ floats & big ints + $metablock['flags']['md5_checksum'] = (bool) ($metablock['flags_raw'] & 0x080000); // compute & store MD5 signature + $metablock['flags']['quiet_mode'] = (bool) ($metablock['flags_raw'] & 0x100000); // don't report progress % + + $info_wavpack['config_flags'] = $metablock['flags']; + + $getid3->info['audio']['encoder_options'] = trim( + ($info_wavpack_blockheader['flags']['hybrid'] ? ' -b???' : '') . + ($metablock['flags']['adobe_mode'] ? ' -a' : '') . + ($metablock['flags']['optimize_wvc'] ? ' -cc' : '') . + ($metablock['flags']['create_exe'] ? ' -e' : '') . + ($metablock['flags']['fast_flag'] ? ' -f' : '') . + ($metablock['flags']['joint_override'] ? ' -j?' : '') . + ($metablock['flags']['high_flag'] ? ' -h' : '') . + ($metablock['flags']['md5_checksum'] ? ' -m' : '') . + ($metablock['flags']['calc_noise'] ? ' -n' : '') . + ($metablock['flags']['shape_override'] ? ' -s?' : '') . + ($metablock['flags']['extra_mode'] ? ' -x?' : '') + ); + if (!$getid3->info['audio']['encoder_options']) { + unset($getid3->info['audio']['encoder_options']); + } + break; + + + case 0x26: // ID_MD5_CHECKSUM + if (strlen($metablock['data']) == 16) { + $getid3->info['md5_data_source'] = strtolower(getid3_lib::PrintHexBytes($metablock['data'], true, false, false)); + } else { + $getid3->warning('Expecting 16 bytes of WavPack "MD5 Checksum" in metablock at offset '.$metablock['offset'].', but found '.strlen($metablock['data']).' bytes'); + } + break; + + + case 0x00: // ID_DUMMY + case 0x01: // ID_ENCODER_INFO + case 0x02: // ID_DECORR_TERMS + case 0x03: // ID_DECORR_WEIGHTS + case 0x04: // ID_DECORR_SAMPLES + case 0x05: // ID_ENTROPY_VARS + case 0x06: // ID_HYBRID_PROFILE + case 0x07: // ID_SHAPING_WEIGHTS + case 0x08: // ID_FLOAT_INFO + case 0x09: // ID_INT32_INFO + case 0x0A: // ID_WV_BITSTREAM + case 0x0B: // ID_WVC_BITSTREAM + case 0x0C: // ID_WVX_BITSTREAM + case 0x0D: // ID_CHANNEL_INFO + unset($metablock); + break; + } + + } + + if (!empty($metablock)) { + $info_wavpack['metablocks'][] = $metablock; + } + + } + + } + + $getid3->info['audio']['encoder'] = 'WavPack v'.$info_wavpack_blockheader['major_version'].'.'.str_pad($info_wavpack_blockheader['minor_version'], 2, '0', STR_PAD_LEFT); + $getid3->info['audio']['bits_per_sample'] = $info_wavpack_blockheader['flags']['bytes_per_sample'] * 8; + $getid3->info['audio']['channels'] = ($info_wavpack_blockheader['flags']['mono'] ? 1 : 2); + + if (@$getid3->info['playtime_seconds']) { + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + } else { + $getid3->info['audio']['dataformat'] = 'wvc'; + } + + return true; + } + + + + public static function WavPackMetablockNameLookup($id) { + + static $lookup = array( + 0x00 => 'Dummy', + 0x01 => 'Encoder Info', + 0x02 => 'Decorrelation Terms', + 0x03 => 'Decorrelation Weights', + 0x04 => 'Decorrelation Samples', + 0x05 => 'Entropy Variables', + 0x06 => 'Hybrid Profile', + 0x07 => 'Shaping Weights', + 0x08 => 'Float Info', + 0x09 => 'Int32 Info', + 0x0A => 'WV Bitstream', + 0x0B => 'WVC Bitstream', + 0x0C => 'WVX Bitstream', + 0x0D => 'Channel Info', + 0x21 => 'RIFF header', + 0x22 => 'RIFF trailer', + 0x23 => 'Replay Gain', + 0x24 => 'Cuesheet', + 0x25 => 'Config Block', + 0x26 => 'MD5 Checksum', + ); + + return (@$lookup[$id]); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.audio.xiph.php b/modules/getid3/module.audio.xiph.php new file mode 100644 index 00000000..f526c325 --- /dev/null +++ b/modules/getid3/module.audio.xiph.php @@ -0,0 +1,952 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.audio.xiph.php | +// | Module for analyzing Xiph.org audio file formats: | +// | Ogg Vorbis, FLAC, OggFLAC and Speex - not Ogg Theora | +// | dependencies: module.lib.image_size.php (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.audio.xiph.php,v 1.5 2006/12/03 21:12:43 ah Exp $ + + + +class getid3_xiph extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + if ($getid3->option_tags_images) { + $getid3->include_module('lib.image_size'); + } + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + $magic = fread($getid3->fp, 4); + + if ($magic == 'OggS') { + return $this->ParseOgg(); + } + + if ($magic == 'fLaC') { + return $this->ParseFLAC(); + } + + } + + + + private function ParseOgg() { + + $getid3 = $this->getid3; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + $getid3->info['audio'] = $getid3->info['ogg'] = array (); + $info_ogg = &$getid3->info['ogg']; + $info_audio = &$getid3->info['audio']; + + $getid3->info['fileformat'] = 'ogg'; + + + //// Page 1 - Stream Header + + $ogg_page_info = $this->ParseOggPageHeader(); + $info_ogg['pageheader'][$ogg_page_info['page_seqno']] = $ogg_page_info; + + if (ftell($getid3->fp) >= getid3::FREAD_BUFFER_SIZE) { + throw new getid3_exception('Could not find start of Ogg page in the first '.getid3::FREAD_BUFFER_SIZE.' bytes (this might not be an Ogg file?)'); + } + + $file_data = fread($getid3->fp, $ogg_page_info['page_length']); + $file_data_offset = 0; + + + // OggFLAC + if (substr($file_data, 0, 4) == 'fLaC') { + + $info_audio['dataformat'] = 'flac'; + $info_audio['bitrate_mode'] = 'vbr'; + $info_audio['lossless'] = true; + + } + + + // Ogg Vorbis + elseif (substr($file_data, 1, 6) == 'vorbis') { + + $info_audio['dataformat'] = 'vorbis'; + $info_audio['lossless'] = false; + + $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['packet_type'] = getid3_lib::LittleEndian2Int($file_data[0]); + $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['stream_type'] = substr($file_data, 1, 6); // hard-coded to 'vorbis' + + getid3_lib::ReadSequence('LittleEndian2Int', $info_ogg, $file_data, 7, + array ( + 'bitstreamversion' => 4, + 'numberofchannels' => 1, + 'samplerate' => 4, + 'bitrate_max' => 4, + 'bitrate_nominal' => 4, + 'bitrate_min' => 4 + ) + ); + + $n28 = getid3_lib::LittleEndian2Int($file_data{28}); + $info_ogg['blocksize_small'] = pow(2, $n28 & 0x0F); + $info_ogg['blocksize_large'] = pow(2, ($n28 & 0xF0) >> 4); + $info_ogg['stop_bit'] = $n28; + + $info_audio['channels'] = $info_ogg['numberofchannels']; + $info_audio['sample_rate'] = $info_ogg['samplerate']; + + $info_audio['bitrate_mode'] = 'vbr'; // overridden if actually abr + + if ($info_ogg['bitrate_max'] == 0xFFFFFFFF) { + unset($info_ogg['bitrate_max']); + $info_audio['bitrate_mode'] = 'abr'; + } + + if ($info_ogg['bitrate_nominal'] == 0xFFFFFFFF) { + unset($info_ogg['bitrate_nominal']); + } + + if ($info_ogg['bitrate_min'] == 0xFFFFFFFF) { + unset($info_ogg['bitrate_min']); + $info_audio['bitrate_mode'] = 'abr'; + } + } + + + // Speex + elseif (substr($file_data, 0, 8) == 'Speex ') { + + // http://www.speex.org/manual/node10.html + + $info_audio['dataformat'] = 'speex'; + $getid3->info['mime_type'] = 'audio/speex'; + $info_audio['bitrate_mode'] = 'abr'; + $info_audio['lossless'] = false; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_ogg['pageheader'][$ogg_page_info['page_seqno']], $file_data, 0, + array ( + 'speex_string' => -8, // hard-coded to 'Speex ' + 'speex_version' => -20, // string + 'speex_version_id' => 4, + 'header_size' => 4, + 'rate' => 4, + 'mode' => 4, + 'mode_bitstream_version' => 4, + 'nb_channels' => 4, + 'bitrate' => 4, + 'framesize' => 4, + 'vbr' => 4, + 'frames_per_packet' => 4, + 'extra_headers' => 4, + 'reserved1' => 4, + 'reserved2' => 4 + ) + ); + + $getid3->info['speex']['speex_version'] = trim($info_ogg['pageheader'][$ogg_page_info['page_seqno']]['speex_version']); + $getid3->info['speex']['sample_rate'] = $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['rate']; + $getid3->info['speex']['channels'] = $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['nb_channels']; + $getid3->info['speex']['vbr'] = (bool)$info_ogg['pageheader'][$ogg_page_info['page_seqno']]['vbr']; + $getid3->info['speex']['band_type'] = getid3_xiph::SpeexBandModeLookup($info_ogg['pageheader'][$ogg_page_info['page_seqno']]['mode']); + + $info_audio['sample_rate'] = $getid3->info['speex']['sample_rate']; + $info_audio['channels'] = $getid3->info['speex']['channels']; + + if ($getid3->info['speex']['vbr']) { + $info_audio['bitrate_mode'] = 'vbr'; + } + } + + // Unsupported Ogg file + else { + + throw new getid3_exception('Expecting either "Speex " or "vorbis" identifier strings, found neither'); + } + + + //// Page 2 - Comment Header + + $ogg_page_info = $this->ParseOggPageHeader(); + $info_ogg['pageheader'][$ogg_page_info['page_seqno']] = $ogg_page_info; + + switch ($info_audio['dataformat']) { + + case 'vorbis': + $file_data = fread($getid3->fp, $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['page_length']); + $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['packet_type'] = getid3_lib::LittleEndian2Int(substr($file_data, 0, 1)); + $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['stream_type'] = substr($file_data, 1, 6); // hard-coded to 'vorbis' + $this->ParseVorbisCommentsFilepointer(); + break; + + case 'flac': + if (!$this->FLACparseMETAdata()) { + throw new getid3_exception('Failed to parse FLAC headers'); + } + break; + + case 'speex': + fseek($getid3->fp, $info_ogg['pageheader'][$ogg_page_info['page_seqno']]['page_length'], SEEK_CUR); + $this->ParseVorbisCommentsFilepointer(); + break; + } + + + //// Last Page - Number of Samples + + fseek($getid3->fp, max($getid3->info['avdataend'] - getid3::FREAD_BUFFER_SIZE, 0), SEEK_SET); + $last_chunk_of_ogg = strrev(fread($getid3->fp, getid3::FREAD_BUFFER_SIZE)); + + if ($last_OggS_postion = strpos($last_chunk_of_ogg, 'SggO')) { + fseek($getid3->fp, $getid3->info['avdataend'] - ($last_OggS_postion + strlen('SggO')), SEEK_SET); + $getid3->info['avdataend'] = ftell($getid3->fp); + $info_ogg['pageheader']['eos'] = $this->ParseOggPageHeader(); + $info_ogg['samples'] = $info_ogg['pageheader']['eos']['pcm_abs_position']; + $info_ogg['bitrate_average'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / ($info_ogg['samples'] / $info_audio['sample_rate']); + } + + if (!empty($info_ogg['bitrate_average'])) { + $info_audio['bitrate'] = $info_ogg['bitrate_average']; + } elseif (!empty($info_ogg['bitrate_nominal'])) { + $info_audio['bitrate'] = $info_ogg['bitrate_nominal']; + } elseif (!empty($info_ogg['bitrate_min']) && !empty($info_ogg['bitrate_max'])) { + $info_audio['bitrate'] = ($info_ogg['bitrate_min'] + $info_ogg['bitrate_max']) / 2; + } + if (isset($info_audio['bitrate']) && !isset($getid3->info['playtime_seconds'])) { + $getid3->info['playtime_seconds'] = (float)((($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $info_audio['bitrate']); + } + + if (isset($info_ogg['vendor'])) { + $info_audio['encoder'] = preg_replace('/^Encoded with /', '', $info_ogg['vendor']); + + // Vorbis only + if ($info_audio['dataformat'] == 'vorbis') { + + // Vorbis 1.0 starts with Xiph.Org + if (preg_match('/^Xiph.Org/', $info_audio['encoder'])) { + + if ($info_audio['bitrate_mode'] == 'abr') { + + // Set -b 128 on abr files + $info_audio['encoder_options'] = '-b '.round($info_ogg['bitrate_nominal'] / 1000); + + } elseif (($info_audio['bitrate_mode'] == 'vbr') && ($info_audio['channels'] == 2) && ($info_audio['sample_rate'] >= 44100) && ($info_audio['sample_rate'] <= 48000)) { + // Set -q N on vbr files + $info_audio['encoder_options'] = '-q '.getid3_xiph::GetQualityFromNominalBitrate($info_ogg['bitrate_nominal']); + } + } + + if (empty($info_audio['encoder_options']) && !empty($info_ogg['bitrate_nominal'])) { + $info_audio['encoder_options'] = 'Nominal bitrate: '.intval(round($info_ogg['bitrate_nominal'] / 1000)).'kbps'; + } + } + } + + return true; + } + + + + private function ParseOggPageHeader() { + + $getid3 = $this->getid3; + + // http://xiph.org/ogg/vorbis/doc/framing.html + $ogg_header['page_start_offset'] = ftell($getid3->fp); // where we started from in the file + + $file_data = fread($getid3->fp, getid3::FREAD_BUFFER_SIZE); + $file_data_offset = 0; + + while ((substr($file_data, $file_data_offset++, 4) != 'OggS')) { + if ((ftell($getid3->fp) - $ogg_header['page_start_offset']) >= getid3::FREAD_BUFFER_SIZE) { + // should be found before here + return false; + } + if ((($file_data_offset + 28) > strlen($file_data)) || (strlen($file_data) < 28)) { + if (feof($getid3->fp) || (($file_data .= fread($getid3->fp, getid3::FREAD_BUFFER_SIZE)) === false)) { + // get some more data, unless eof, in which case fail + return false; + } + } + } + + $file_data_offset += 3; // page, delimited by 'OggS' + + getid3_lib::ReadSequence('LittleEndian2Int', $ogg_header, $file_data, $file_data_offset, + array ( + 'stream_structver' => 1, + 'flags_raw' => 1, + 'pcm_abs_position' => 8, + 'stream_serialno' => 4, + 'page_seqno' => 4, + 'page_checksum' => 4, + 'page_segments' => 1 + ) + ); + + $file_data_offset += 23; + + $ogg_header['flags']['fresh'] = (bool)($ogg_header['flags_raw'] & 0x01); // fresh packet + $ogg_header['flags']['bos'] = (bool)($ogg_header['flags_raw'] & 0x02); // first page of logical bitstream (bos) + $ogg_header['flags']['eos'] = (bool)($ogg_header['flags_raw'] & 0x04); // last page of logical bitstream (eos) + + $ogg_header['page_length'] = 0; + for ($i = 0; $i < $ogg_header['page_segments']; $i++) { + $ogg_header['segment_table'][$i] = getid3_lib::LittleEndian2Int($file_data{$file_data_offset++}); + $ogg_header['page_length'] += $ogg_header['segment_table'][$i]; + } + $ogg_header['header_end_offset'] = $ogg_header['page_start_offset'] + $file_data_offset; + $ogg_header['page_end_offset'] = $ogg_header['header_end_offset'] + $ogg_header['page_length']; + fseek($getid3->fp, $ogg_header['header_end_offset'], SEEK_SET); + + return $ogg_header; + } + + + + private function ParseVorbisCommentsFilepointer() { + + $getid3 = $this->getid3; + + $original_offset = ftell($getid3->fp); + $comment_start_offset = $original_offset; + $comment_data_offset = 0; + $vorbis_comment_page = 1; + + switch ($getid3->info['audio']['dataformat']) { + + case 'vorbis': + $comment_start_offset = $getid3->info['ogg']['pageheader'][$vorbis_comment_page]['page_start_offset']; // Second Ogg page, after header block + fseek($getid3->fp, $comment_start_offset, SEEK_SET); + $comment_data_offset = 27 + $getid3->info['ogg']['pageheader'][$vorbis_comment_page]['page_segments']; + $comment_data = fread($getid3->fp, getid3_xiph::OggPageSegmentLength($getid3->info['ogg']['pageheader'][$vorbis_comment_page], 1) + $comment_data_offset); + $comment_data_offset += (strlen('vorbis') + 1); + break; + + + case 'flac': + fseek($getid3->fp, $getid3->info['flac']['VORBIS_COMMENT']['raw']['offset'] + 4, SEEK_SET); + $comment_data = fread($getid3->fp, $getid3->info['flac']['VORBIS_COMMENT']['raw']['block_length']); + break; + + + case 'speex': + $comment_start_offset = $getid3->info['ogg']['pageheader'][$vorbis_comment_page]['page_start_offset']; // Second Ogg page, after header block + fseek($getid3->fp, $comment_start_offset, SEEK_SET); + $comment_data_offset = 27 + $getid3->info['ogg']['pageheader'][$vorbis_comment_page]['page_segments']; + $comment_data = fread($getid3->fp, getid3_xiph::OggPageSegmentLength($getid3->info['ogg']['pageheader'][$vorbis_comment_page], 1) + $comment_data_offset); + break; + + + default: + return false; + } + + $vendor_size = getid3_lib::LittleEndian2Int(substr($comment_data, $comment_data_offset, 4)); + $comment_data_offset += 4; + + $getid3->info['ogg']['vendor'] = substr($comment_data, $comment_data_offset, $vendor_size); + $comment_data_offset += $vendor_size; + + $comments_count = getid3_lib::LittleEndian2Int(substr($comment_data, $comment_data_offset, 4)); + $comment_data_offset += 4; + + $getid3->info['avdataoffset'] = $comment_start_offset + $comment_data_offset; + + for ($i = 0; $i < $comments_count; $i++) { + + $getid3->info['ogg']['comments_raw'][$i]['dataoffset'] = $comment_start_offset + $comment_data_offset; + + if (ftell($getid3->fp) < ($getid3->info['ogg']['comments_raw'][$i]['dataoffset'] + 4)) { + $vorbis_comment_page++; + + $ogg_page_info = $this->ParseOggPageHeader(); + $getid3->info['ogg']['pageheader'][$ogg_page_info['page_seqno']] = $ogg_page_info; + + // First, save what we haven't read yet + $as_yet_unused_data = substr($comment_data, $comment_data_offset); + + // Then take that data off the end + $comment_data = substr($comment_data, 0, $comment_data_offset); + + // Add [headerlength] bytes of dummy data for the Ogg Page Header, just to keep absolute offsets correct + $comment_data .= str_repeat("\x00", 27 + $getid3->info['ogg']['pageheader'][$ogg_page_info['page_seqno']]['page_segments']); + $comment_data_offset += (27 + $getid3->info['ogg']['pageheader'][$ogg_page_info['page_seqno']]['page_segments']); + + // Finally, stick the unused data back on the end + $comment_data .= $as_yet_unused_data; + + $comment_data .= fread($getid3->fp, getid3_xiph::OggPageSegmentLength($getid3->info['ogg']['pageheader'][$vorbis_comment_page], 1)); + } + $getid3->info['ogg']['comments_raw'][$i]['size'] = getid3_lib::LittleEndian2Int(substr($comment_data, $comment_data_offset, 4)); + + // replace avdataoffset with position just after the last vorbiscomment + $getid3->info['avdataoffset'] = $getid3->info['ogg']['comments_raw'][$i]['dataoffset'] + $getid3->info['ogg']['comments_raw'][$i]['size'] + 4; + + $comment_data_offset += 4; + while ((strlen($comment_data) - $comment_data_offset) < $getid3->info['ogg']['comments_raw'][$i]['size']) { + + if (($getid3->info['ogg']['comments_raw'][$i]['size'] > $getid3->info['avdataend']) || ($getid3->info['ogg']['comments_raw'][$i]['size'] < 0)) { + throw new getid3_exception('Invalid Ogg comment size (comment #'.$i.', claims to be '.number_format($getid3->info['ogg']['comments_raw'][$i]['size']).' bytes) - aborting reading comments'); + } + + $vorbis_comment_page++; + + $ogg_page_info = $this->ParseOggPageHeader(); + $getid3->info['ogg']['pageheader'][$ogg_page_info['page_seqno']] = $ogg_page_info; + + // First, save what we haven't read yet + $as_yet_unused_data = substr($comment_data, $comment_data_offset); + + // Then take that data off the end + $comment_data = substr($comment_data, 0, $comment_data_offset); + + // Add [headerlength] bytes of dummy data for the Ogg Page Header, just to keep absolute offsets correct + $comment_data .= str_repeat("\x00", 27 + $getid3->info['ogg']['pageheader'][$ogg_page_info['page_seqno']]['page_segments']); + $comment_data_offset += (27 + $getid3->info['ogg']['pageheader'][$ogg_page_info['page_seqno']]['page_segments']); + + // Finally, stick the unused data back on the end + $comment_data .= $as_yet_unused_data; + + //$comment_data .= fread($getid3->fp, $getid3->info['ogg']['pageheader'][$ogg_page_info['page_seqno']]['page_length']); + $comment_data .= fread($getid3->fp, getid3_xiph::OggPageSegmentLength($getid3->info['ogg']['pageheader'][$vorbis_comment_page], 1)); + + //$filebaseoffset += $ogg_page_info['header_end_offset'] - $ogg_page_info['page_start_offset']; + } + $comment_string = substr($comment_data, $comment_data_offset, $getid3->info['ogg']['comments_raw'][$i]['size']); + $comment_data_offset += $getid3->info['ogg']['comments_raw'][$i]['size']; + + if (!$comment_string) { + + // no comment? + $getid3->warning('Blank Ogg comment ['.$i.']'); + + } elseif (strstr($comment_string, '=')) { + + $comment_exploded = explode('=', $comment_string, 2); + $getid3->info['ogg']['comments_raw'][$i]['key'] = strtoupper($comment_exploded[0]); + $getid3->info['ogg']['comments_raw'][$i]['value'] = @$comment_exploded[1]; + $getid3->info['ogg']['comments_raw'][$i]['data'] = base64_decode($getid3->info['ogg']['comments_raw'][$i]['value']); + + $getid3->info['ogg']['comments'][strtolower($getid3->info['ogg']['comments_raw'][$i]['key'])][] = $getid3->info['ogg']['comments_raw'][$i]['value']; + + if ($getid3->option_tags_images) { + $image_chunk_check = getid3_lib_image_size::get($getid3->info['ogg']['comments_raw'][$i]['data']); + $getid3->info['ogg']['comments_raw'][$i]['image_mime'] = image_type_to_mime_type($image_chunk_check[2]); + } + + if (!@$getid3->info['ogg']['comments_raw'][$i]['image_mime'] || ($getid3->info['ogg']['comments_raw'][$i]['image_mime'] == 'application/octet-stream')) { + unset($getid3->info['ogg']['comments_raw'][$i]['image_mime']); + unset($getid3->info['ogg']['comments_raw'][$i]['data']); + } + + + } else { + + $getid3->warning('[known problem with CDex >= v1.40, < v1.50b7] Invalid Ogg comment name/value pair ['.$i.']: '.$comment_string); + } + } + + + // Replay Gain Adjustment + // http://privatewww.essex.ac.uk/~djmrob/replaygain/ + if (isset($getid3->info['ogg']['comments']) && is_array($getid3->info['ogg']['comments'])) { + foreach ($getid3->info['ogg']['comments'] as $index => $commentvalue) { + switch ($index) { + case 'rg_audiophile': + case 'replaygain_album_gain': + $getid3->info['replay_gain']['album']['adjustment'] = (float)$commentvalue[0]; + unset($getid3->info['ogg']['comments'][$index]); + break; + + case 'rg_radio': + case 'replaygain_track_gain': + $getid3->info['replay_gain']['track']['adjustment'] = (float)$commentvalue[0]; + unset($getid3->info['ogg']['comments'][$index]); + break; + + case 'replaygain_album_peak': + $getid3->info['replay_gain']['album']['peak'] = (float)$commentvalue[0]; + unset($getid3->info['ogg']['comments'][$index]); + break; + + case 'rg_peak': + case 'replaygain_track_peak': + $getid3->info['replay_gain']['track']['peak'] = (float)$commentvalue[0]; + unset($getid3->info['ogg']['comments'][$index]); + break; + + case 'replaygain_reference_loudness': + $getid3->info['replay_gain']['reference_volume'] = (float)$commentvalue[0]; + unset($getid3->info['ogg']['comments'][$index]); + break; + } + } + } + + fseek($getid3->fp, $original_offset, SEEK_SET); + + return true; + } + + + + private function ParseFLAC() { + + $getid3 = $this->getid3; + + // http://flac.sourceforge.net/format.html + + $getid3->info['fileformat'] = 'flac'; + $getid3->info['audio']['dataformat'] = 'flac'; + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + $getid3->info['audio']['lossless'] = true; + + return $this->FLACparseMETAdata(); + } + + + + private function FLACparseMETAdata() { + + $getid3 = $this->getid3; + + do { + + $meta_data_block_offset = ftell($getid3->fp); + $meta_data_block_header = fread($getid3->fp, 4); + $meta_data_last_block_flag = (bool)(getid3_lib::BigEndian2Int($meta_data_block_header[0]) & 0x80); + $meta_data_block_type = getid3_lib::BigEndian2Int($meta_data_block_header[0]) & 0x7F; + $meta_data_block_length = getid3_lib::BigEndian2Int(substr($meta_data_block_header, 1, 3)); + $meta_data_block_type_text = getid3_xiph::FLACmetaBlockTypeLookup($meta_data_block_type); + + if ($meta_data_block_length < 0) { + throw new getid3_exception('corrupt or invalid METADATA_BLOCK_HEADER.BLOCK_TYPE ('.$meta_data_block_type.') at offset '.$meta_data_block_offset); + } + + $getid3->info['flac'][$meta_data_block_type_text]['raw'] = array ( + 'offset' => $meta_data_block_offset, + 'last_meta_block' => $meta_data_last_block_flag, + 'block_type' => $meta_data_block_type, + 'block_type_text' => $meta_data_block_type_text, + 'block_length' => $meta_data_block_length, + 'block_data' => @fread($getid3->fp, $meta_data_block_length) + ); + $getid3->info['avdataoffset'] = ftell($getid3->fp); + + switch ($meta_data_block_type_text) { + + case 'STREAMINFO': + if (!$this->FLACparseSTREAMINFO($getid3->info['flac'][$meta_data_block_type_text]['raw']['block_data'])) { + return false; + } + break; + + case 'PADDING': + // ignore + break; + + case 'APPLICATION': + if (!$this->FLACparseAPPLICATION($getid3->info['flac'][$meta_data_block_type_text]['raw']['block_data'])) { + return false; + } + break; + + case 'SEEKTABLE': + if (!$this->FLACparseSEEKTABLE($getid3->info['flac'][$meta_data_block_type_text]['raw']['block_data'])) { + return false; + } + break; + + case 'VORBIS_COMMENT': + $old_offset = ftell($getid3->fp); + fseek($getid3->fp, 0 - $meta_data_block_length, SEEK_CUR); + $this->ParseVorbisCommentsFilepointer($getid3->fp, $getid3->info); + fseek($getid3->fp, $old_offset, SEEK_SET); + break; + + case 'CUESHEET': + if (!$this->FLACparseCUESHEET($getid3->info['flac'][$meta_data_block_type_text]['raw']['block_data'])) { + return false; + } + break; + + case 'PICTURE': + if (!$this->FLACparsePICTURE($getid3->info['flac'][$meta_data_block_type_text]['raw']['block_data'])) { + return false; + } + break; + + default: + $getid3->warning('Unhandled METADATA_BLOCK_HEADER.BLOCK_TYPE ('.$meta_data_block_type.') at offset '.$meta_data_block_offset); + } + + } while ($meta_data_last_block_flag === false); + + + if (isset($getid3->info['flac']['STREAMINFO'])) { + $getid3->info['flac']['compressed_audio_bytes'] = $getid3->info['avdataend'] - $getid3->info['avdataoffset']; + $getid3->info['flac']['uncompressed_audio_bytes'] = $getid3->info['flac']['STREAMINFO']['samples_stream'] * $getid3->info['flac']['STREAMINFO']['channels'] * ($getid3->info['flac']['STREAMINFO']['bits_per_sample'] / 8); + $getid3->info['flac']['compression_ratio'] = $getid3->info['flac']['compressed_audio_bytes'] / $getid3->info['flac']['uncompressed_audio_bytes']; + } + + // set md5_data_source - built into flac 0.5+ + if (isset($getid3->info['flac']['STREAMINFO']['audio_signature'])) { + + if ($getid3->info['flac']['STREAMINFO']['audio_signature'] === str_repeat("\x00", 16)) { + $getid3->warning('FLAC STREAMINFO.audio_signature is null (known issue with libOggFLAC)'); + + } else { + + $getid3->info['md5_data_source'] = ''; + $md5 = $getid3->info['flac']['STREAMINFO']['audio_signature']; + for ($i = 0; $i < strlen($md5); $i++) { + $getid3->info['md5_data_source'] .= str_pad(dechex(ord($md5{$i})), 2, '00', STR_PAD_LEFT); + } + if (!preg_match('/^[0-9a-f]{32}$/', $getid3->info['md5_data_source'])) { + unset($getid3->info['md5_data_source']); + } + + } + + } + + $getid3->info['audio']['bits_per_sample'] = $getid3->info['flac']['STREAMINFO']['bits_per_sample']; + if ($getid3->info['audio']['bits_per_sample'] == 8) { + // special case + // must invert sign bit on all data bytes before MD5'ing to match FLAC's calculated value + // MD5sum calculates on unsigned bytes, but FLAC calculated MD5 on 8-bit audio data as signed + $getid3->warning('FLAC calculates MD5 data strangely on 8-bit audio, so the stored md5_data_source value will not match the decoded WAV file'); + } + if (!empty($getid3->info['ogg']['vendor'])) { + $getid3->info['audio']['encoder'] = $getid3->info['ogg']['vendor']; + } + + return true; + } + + + + private function FLACparseSTREAMINFO($meta_data_block_data) { + + $getid3 = $this->getid3; + + getid3_lib::ReadSequence('BigEndian2Int', $getid3->info['flac']['STREAMINFO'], $meta_data_block_data, 0, + array ( + 'min_block_size' => 2, + 'max_block_size' => 2, + 'min_frame_size' => 3, + 'max_frame_size' => 3 + ) + ); + + $sample_rate_channels_sample_bits_stream_samples = getid3_lib::BigEndian2Bin(substr($meta_data_block_data, 10, 8)); + + $getid3->info['flac']['STREAMINFO']['sample_rate'] = bindec(substr($sample_rate_channels_sample_bits_stream_samples, 0, 20)); + $getid3->info['flac']['STREAMINFO']['channels'] = bindec(substr($sample_rate_channels_sample_bits_stream_samples, 20, 3)) + 1; + $getid3->info['flac']['STREAMINFO']['bits_per_sample'] = bindec(substr($sample_rate_channels_sample_bits_stream_samples, 23, 5)) + 1; + $getid3->info['flac']['STREAMINFO']['samples_stream'] = bindec(substr($sample_rate_channels_sample_bits_stream_samples, 28, 36)); // bindec() returns float in case of int overrun + $getid3->info['flac']['STREAMINFO']['audio_signature'] = substr($meta_data_block_data, 18, 16); + + if (!empty($getid3->info['flac']['STREAMINFO']['sample_rate'])) { + + $getid3->info['audio']['bitrate_mode'] = 'vbr'; + $getid3->info['audio']['sample_rate'] = $getid3->info['flac']['STREAMINFO']['sample_rate']; + $getid3->info['audio']['channels'] = $getid3->info['flac']['STREAMINFO']['channels']; + $getid3->info['audio']['bits_per_sample'] = $getid3->info['flac']['STREAMINFO']['bits_per_sample']; + $getid3->info['playtime_seconds'] = $getid3->info['flac']['STREAMINFO']['samples_stream'] / $getid3->info['flac']['STREAMINFO']['sample_rate']; + $getid3->info['audio']['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds']; + + } else { + + throw new getid3_exception('Corrupt METAdata block: STREAMINFO'); + } + + unset($getid3->info['flac']['STREAMINFO']['raw']); + + return true; + } + + + + private function FLACparseAPPLICATION($meta_data_block_data) { + + $getid3 = $this->getid3; + + $application_id = getid3_lib::BigEndian2Int(substr($meta_data_block_data, 0, 4)); + + $getid3->info['flac']['APPLICATION'][$application_id]['name'] = getid3_xiph::FLACapplicationIDLookup($application_id); + $getid3->info['flac']['APPLICATION'][$application_id]['data'] = substr($meta_data_block_data, 4); + + unset($getid3->info['flac']['APPLICATION']['raw']); + + return true; + } + + + + private function FLACparseSEEKTABLE($meta_data_block_data) { + + $getid3 = $this->getid3; + + $offset = 0; + $meta_data_block_length = strlen($meta_data_block_data); + while ($offset < $meta_data_block_length) { + $sample_number_string = substr($meta_data_block_data, $offset, 8); + $offset += 8; + if ($sample_number_string == "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF") { + + // placeholder point + @$getid3->info['flac']['SEEKTABLE']['placeholders']++; + $offset += 10; + + } else { + + $sample_number = getid3_lib::BigEndian2Int($sample_number_string); + + $getid3->info['flac']['SEEKTABLE'][$sample_number]['offset'] = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 8)); + $offset += 8; + + $getid3->info['flac']['SEEKTABLE'][$sample_number]['samples'] = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 2)); + $offset += 2; + + } + } + + unset($getid3->info['flac']['SEEKTABLE']['raw']); + + return true; + } + + + + private function FLACparseCUESHEET($meta_data_block_data) { + + $getid3 = $this->getid3; + + $getid3->info['flac']['CUESHEET']['media_catalog_number'] = trim(substr($meta_data_block_data, 0, 128), "\0"); + $getid3->info['flac']['CUESHEET']['lead_in_samples'] = getid3_lib::BigEndian2Int(substr($meta_data_block_data, 128, 8)); + $getid3->info['flac']['CUESHEET']['flags']['is_cd'] = (bool)(getid3_lib::BigEndian2Int($meta_data_block_data[136]) & 0x80); + $getid3->info['flac']['CUESHEET']['number_tracks'] = getid3_lib::BigEndian2Int($meta_data_block_data[395]); + + $offset = 396; + + for ($track = 0; $track < $getid3->info['flac']['CUESHEET']['number_tracks']; $track++) { + + $track_sample_offset = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 8)); + $offset += 8; + + $track_number = getid3_lib::BigEndian2Int($meta_data_block_data{$offset++}); + + $getid3->info['flac']['CUESHEET']['tracks'][$track_number]['sample_offset'] = $track_sample_offset; + $getid3->info['flac']['CUESHEET']['tracks'][$track_number]['isrc'] = substr($meta_data_block_data, $offset, 12); + $offset += 12; + + $track_flags_raw = getid3_lib::BigEndian2Int($meta_data_block_data{$offset++}); + $getid3->info['flac']['CUESHEET']['tracks'][$track_number]['flags']['is_audio'] = (bool)($track_flags_raw & 0x80); + $getid3->info['flac']['CUESHEET']['tracks'][$track_number]['flags']['pre_emphasis'] = (bool)($track_flags_raw & 0x40); + + $offset += 13; // reserved + + $getid3->info['flac']['CUESHEET']['tracks'][$track_number]['index_points'] = getid3_lib::BigEndian2Int($meta_data_block_data{$offset++}); + + for ($index = 0; $index < $getid3->info['flac']['CUESHEET']['tracks'][$track_number]['index_points']; $index++) { + + $index_sample_offset = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 8)); + $offset += 8; + + $index_number = getid3_lib::BigEndian2Int($meta_data_block_data{$offset++}); + $getid3->info['flac']['CUESHEET']['tracks'][$track_number]['indexes'][$index_number] = $index_sample_offset; + + $offset += 3; // reserved + } + } + + unset($getid3->info['flac']['CUESHEET']['raw']); + + return true; + } + + + + private function FLACparsePICTURE($meta_data_block_data) { + + $getid3 = $this->getid3; + + $picture = &$getid3->info['flac']['PICTURE'][sizeof($getid3->info['flac']['PICTURE']) - 1]; + + $offset = 0; + + $picture['type'] = $this->FLACpictureTypeLookup(getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4))); + $offset += 4; + + $length = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4)); + $offset += 4; + + $picture['mime_type'] = substr($meta_data_block_data, $offset, $length); + $offset += $length; + + $length = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4)); + $offset += 4; + + $picture['description'] = substr($meta_data_block_data, $offset, $length); + $offset += $length; + + $picture['width'] = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4)); + $offset += 4; + + $picture['height'] = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4)); + $offset += 4; + + $picture['color_depth'] = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4)); + $offset += 4; + + $picture['colors_indexed'] = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4)); + $offset += 4; + + $length = getid3_lib::BigEndian2Int(substr($meta_data_block_data, $offset, 4)); + $offset += 4; + + $picture['image_data'] = substr($meta_data_block_data, $offset, $length); + $offset += $length; + + unset($getid3->info['flac']['PICTURE']['raw']); + + return true; + } + + + + public static function SpeexBandModeLookup($mode) { + + static $lookup = array ( + 0 => 'narrow', + 1 => 'wide', + 2 => 'ultra-wide' + ); + return (isset($lookup[$mode]) ? $lookup[$mode] : null); + } + + + + public static function OggPageSegmentLength($ogg_info_array, $segment_number=1) { + + for ($i = 0; $i < $segment_number; $i++) { + $segment_length = 0; + foreach ($ogg_info_array['segment_table'] as $key => $value) { + $segment_length += $value; + if ($value < 255) { + break; + } + } + } + return $segment_length; + } + + + + public static function GetQualityFromNominalBitrate($nominal_bitrate) { + + // decrease precision + $nominal_bitrate = $nominal_bitrate / 1000; + + if ($nominal_bitrate < 128) { + // q-1 to q4 + $qval = ($nominal_bitrate - 64) / 16; + } elseif ($nominal_bitrate < 256) { + // q4 to q8 + $qval = $nominal_bitrate / 32; + } elseif ($nominal_bitrate < 320) { + // q8 to q9 + $qval = ($nominal_bitrate + 256) / 64; + } else { + // q9 to q10 + $qval = ($nominal_bitrate + 1300) / 180; + } + return round($qval, 1); // 5 or 4.9 + } + + + + public static function FLACmetaBlockTypeLookup($block_type) { + + static $lookup = array ( + 0 => 'STREAMINFO', + 1 => 'PADDING', + 2 => 'APPLICATION', + 3 => 'SEEKTABLE', + 4 => 'VORBIS_COMMENT', + 5 => 'CUESHEET', + 6 => 'PICTURE' + ); + return (isset($lookup[$block_type]) ? $lookup[$block_type] : 'reserved'); + } + + + + public static function FLACapplicationIDLookup($application_id) { + + // http://flac.sourceforge.net/id.html + + static $lookup = array ( + 0x46746F6C => 'flac-tools', // 'Ftol' + 0x46746F6C => 'Sound Font FLAC', // 'SFFL' + 0x7065656D => 'Parseable Embedded Extensible Metadata (specification)', // 'peem' + 0x786D6364 => 'xmcd' + + ); + return (isset($lookup[$application_id]) ? $lookup[$application_id] : 'reserved'); + } + + + public static function FLACpictureTypeLookup($type_id) { + + static $lookup = array ( + + 0 => 'Other', + 1 => "32x32 pixels 'file icon' (PNG only)", + 2 => 'Other file icon', + 3 => 'Cover (front)', + 4 => 'Cover (back)', + 5 => 'Leaflet page', + 6 => 'Media (e.g. label side of CD)', + 7 => 'Lead artist/lead performer/soloist', + 8 => 'Artist/performer', + 9 => 'Conductor', + 10 => 'Band/Orchestra', + 11 => 'Composer', + 12 => 'Lyricist/text writer', + 13 => 'Recording Location', + 14 => 'During recording', + 15 => 'During performance', + 16 => 'Movie/video screen capture', + 17 => 'A bright coloured fish', + 18 => 'Illustration', + 19 => 'Band/artist logotype', + 20 => 'Publisher/Studio logotype' + ); + return (isset($lookup[$type_id]) ? $lookup[$type_id] : 'reserved'); + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.graphic.bmp.php b/modules/getid3/module.graphic.bmp.php new file mode 100644 index 00000000..ca1ce87f --- /dev/null +++ b/modules/getid3/module.graphic.bmp.php @@ -0,0 +1,319 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.graphic.bmp.php | +// | Module for analyzing BMP graphic files. | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.graphic.bmp.php,v 1.4 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_bmp extends getid3_handler +{ + + + public function Analyze() { + + $getid3 = $this->getid3; + + // BITMAPFILEHEADER [14 bytes] - http://msdn.microsoft.com/library/en-us/gdi/bitmaps_62uq.asp + // all versions + // WORD bfType; + // DWORD bfSize; + // WORD bfReserved1; + // WORD bfReserved2; + // DWORD bfOffBits; + + // shortcuts + $getid3->info['bmp']['header']['raw'] = array (); + $info_bmp = &$getid3->info['bmp']; + $info_bmp_header = &$info_bmp['header']; + $info_bmp_header_raw = &$info_bmp_header['raw']; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $bmp_header = fread($getid3->fp, 14 + 40); + + // Magic bytes + $info_bmp_header_raw['identifier'] = 'BM'; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_bmp_header_raw, $bmp_header, 2, + array ( + 'filesize' => 4, + 'reserved1' => 2, + 'reserved2' => 2, + 'data_offset' => 4, + 'header_size' => 4 + ) + ); + + // Check if the hardcoded-to-1 "planes" is at offset 22 or 26 + $planes22 = getid3_lib::LittleEndian2Int(substr($bmp_header, 22, 2)); + $planes26 = getid3_lib::LittleEndian2Int(substr($bmp_header, 26, 2)); + if (($planes22 == 1) && ($planes26 != 1)) { + $info_bmp['type_os'] = 'OS/2'; + $info_bmp['type_version'] = 1; + } + elseif (($planes26 == 1) && ($planes22 != 1)) { + $info_bmp['type_os'] = 'Windows'; + $info_bmp['type_version'] = 1; + } + elseif ($info_bmp_header_raw['header_size'] == 12) { + $info_bmp['type_os'] = 'OS/2'; + $info_bmp['type_version'] = 1; + } + elseif ($info_bmp_header_raw['header_size'] == 40) { + $info_bmp['type_os'] = 'Windows'; + $info_bmp['type_version'] = 1; + } + elseif ($info_bmp_header_raw['header_size'] == 84) { + $info_bmp['type_os'] = 'Windows'; + $info_bmp['type_version'] = 4; + } + elseif ($info_bmp_header_raw['header_size'] == 100) { + $info_bmp['type_os'] = 'Windows'; + $info_bmp['type_version'] = 5; + } + else { + throw new getid3_exception('Unknown BMP subtype (or not a BMP file)'); + } + + $getid3->info['fileformat'] = 'bmp'; + $getid3->info['video']['dataformat'] = 'bmp'; + $getid3->info['video']['lossless'] = true; + $getid3->info['video']['pixel_aspect_ratio'] = (float)1; + + if ($info_bmp['type_os'] == 'OS/2') { + + // OS/2-format BMP + // http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm + + // DWORD Size; /* Size of this structure in bytes */ + // DWORD Width; /* Bitmap width in pixels */ + // DWORD Height; /* Bitmap height in pixel */ + // WORD NumPlanes; /* Number of bit planes (color depth) */ + // WORD BitsPerPixel; /* Number of bits per pixel per plane */ + + getid3_lib::ReadSequence('LittleEndian2Int', $info_bmp_header_raw, $bmp_header, 18, + array ( + 'width' => 2, + 'height' => 2, + 'planes' => 2, + 'bits_per_pixel' => 2 + ) + ); + + $getid3->info['video']['resolution_x'] = $info_bmp_header_raw['width']; + $getid3->info['video']['resolution_y'] = $info_bmp_header_raw['height']; + $getid3->info['video']['codec'] = 'BI_RGB '.$info_bmp_header_raw['bits_per_pixel'].'-bit'; + $getid3->info['video']['bits_per_sample'] = $info_bmp_header_raw['bits_per_pixel']; + + if ($info_bmp['type_version'] >= 2) { + // DWORD Compression; /* Bitmap compression scheme */ + // DWORD ImageDataSize; /* Size of bitmap data in bytes */ + // DWORD XResolution; /* X resolution of display device */ + // DWORD YResolution; /* Y resolution of display device */ + // DWORD ColorsUsed; /* Number of color table indices used */ + // DWORD ColorsImportant; /* Number of important color indices */ + // WORD Units; /* Type of units used to measure resolution */ + // WORD Reserved; /* Pad structure to 4-byte boundary */ + // WORD Recording; /* Recording algorithm */ + // WORD Rendering; /* Halftoning algorithm used */ + // DWORD Size1; /* Reserved for halftoning algorithm use */ + // DWORD Size2; /* Reserved for halftoning algorithm use */ + // DWORD ColorEncoding; /* Color model used in bitmap */ + // DWORD Identifier; /* Reserved for application use */ + + getid3_lib::ReadSequence('LittleEndian2Int', $info_bmp_header_raw, $bmp_header, 26, + array ( + 'compression' => 4, + 'bmp_data_size' => 4, + 'resolution_h' => 4, + 'resolution_v' => 4, + 'colors_used' => 4, + 'colors_important' => 4, + 'resolution_units' => 2, + 'reserved1' => 2, + 'recording' => 2, + 'rendering' => 2, + 'size1' => 4, + 'size2' => 4, + 'color_encoding' => 4, + 'identifier' => 4 + ) + ); + + $info_bmp_header['compression'] = getid3_bmp::BMPcompressionOS2Lookup($info_bmp_header_raw['compression']); + $getid3->info['video']['codec'] = $info_bmp_header['compression'].' '.$info_bmp_header_raw['bits_per_pixel'].'-bit'; + } + + return true; + } + + + if ($info_bmp['type_os'] == 'Windows') { + + // Windows-format BMP + + // BITMAPINFOHEADER - [40 bytes] http://msdn.microsoft.com/library/en-us/gdi/bitmaps_1rw2.asp + // all versions + // DWORD biSize; + // LONG biWidth; + // LONG biHeight; + // WORD biPlanes; + // WORD biBitCount; + // DWORD biCompression; + // DWORD biSizeImage; + // LONG biXPelsPerMeter; + // LONG biYPelsPerMeter; + // DWORD biClrUsed; + // DWORD biClrImportant; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_bmp_header_raw, $bmp_header, 18, + array ( + 'width' => -4, //signed + 'height' => -4, //signed + 'planes' => 2, + 'bits_per_pixel' => 2, + 'compression' => 4, + 'bmp_data_size' => 4, + 'resolution_h' => -4, //signed + 'resolution_v' => -4, //signed + 'colors_used' => 4, + 'colors_important' => 4 + ) + ); + foreach (array ('width', 'height', 'resolution_h', 'resolution_v') as $key) { + $info_bmp_header_raw[$key] = getid3_lib::LittleEndian2Int($info_bmp_header_raw[$key], true); + } + + $info_bmp_header['compression'] = getid3_bmp::BMPcompressionWindowsLookup($info_bmp_header_raw['compression']); + $getid3->info['video']['resolution_x'] = $info_bmp_header_raw['width']; + $getid3->info['video']['resolution_y'] = $info_bmp_header_raw['height']; + $getid3->info['video']['codec'] = $info_bmp_header['compression'].' '.$info_bmp_header_raw['bits_per_pixel'].'-bit'; + $getid3->info['video']['bits_per_sample'] = $info_bmp_header_raw['bits_per_pixel']; + + // should only be v4+, but BMPs with type_version==1 and BI_BITFIELDS compression have been seen + if (($info_bmp['type_version'] >= 4) || ($info_bmp_header_raw['compression'] == 3)) { + + + $bmp_header .= fread($getid3->fp, 44); + + // BITMAPV4HEADER - [44 bytes] - http://msdn.microsoft.com/library/en-us/gdi/bitmaps_2k1e.asp + // Win95+, WinNT4.0+ + // DWORD bV4RedMask; + // DWORD bV4GreenMask; + // DWORD bV4BlueMask; + // DWORD bV4AlphaMask; + // DWORD bV4CSType; + // CIEXYZTRIPLE bV4Endpoints; + // DWORD bV4GammaRed; + // DWORD bV4GammaGreen; + // DWORD bV4GammaBlue; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_bmp_header_raw, $bmp_header, 54, + array ( + 'red_mask' => 4, + 'green_mask' => 4, + 'blue_mask' => 4, + 'alpha_mask' => 4, + 'cs_type' => 4, + 'ciexyz_red' => -4, //string + 'ciexyz_green' => -4, //string + 'ciexyz_blue' => -4, //string + 'gamma_red' => 4, + 'gamma_green' => 4, + 'gamma_blue' => 4 + ) + ); + + $info_bmp_header['ciexyz_red'] = getid3_bmp::FixedPoint2_30(strrev($info_bmp_header_raw['ciexyz_red'])); + $info_bmp_header['ciexyz_green'] = getid3_bmp::FixedPoint2_30(strrev($info_bmp_header_raw['ciexyz_green'])); + $info_bmp_header['ciexyz_blue'] = getid3_bmp::FixedPoint2_30(strrev($info_bmp_header_raw['ciexyz_blue'])); + + + if ($info_bmp['type_version'] >= 5) { + $bmp_header .= fread($getid3->fp, 16); + + // BITMAPV5HEADER - [16 bytes] - http://msdn.microsoft.com/library/en-us/gdi/bitmaps_7c36.asp + // Win98+, Win2000+ + // DWORD bV5Intent; + // DWORD bV5ProfileData; + // DWORD bV5ProfileSize; + // DWORD bV5Reserved; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_bmp_header_raw, $bmp_header, 98, + array ( + 'intent' => 4, + 'profile_data_offset' => 4, + 'profile_data_size' => 4, + 'reserved3' => 4 + ) + ); + + } + } + + return true; + } + + + throw new getid3_exception('Unknown BMP format in header.'); + + } + + + + public static function BMPcompressionWindowsLookup($compression_id) { + + static $lookup = array ( + 0 => 'BI_RGB', + 1 => 'BI_RLE8', + 2 => 'BI_RLE4', + 3 => 'BI_BITFIELDS', + 4 => 'BI_JPEG', + 5 => 'BI_PNG' + ); + return (isset($lookup[$compression_id]) ? $lookup[$compression_id] : 'invalid'); + } + + + + public static function BMPcompressionOS2Lookup($compression_id) { + + static $lookup = array ( + 0 => 'BI_RGB', + 1 => 'BI_RLE8', + 2 => 'BI_RLE4', + 3 => 'Huffman 1D', + 4 => 'BI_RLE24', + ); + return (isset($lookup[$compression_id]) ? $lookup[$compression_id] : 'invalid'); + } + + + public static function FixedPoint2_30($raw_data) { + + $binary_string = getid3_lib::BigEndian2Bin($raw_data); + return bindec(substr($binary_string, 0, 2)) + (float)(bindec(substr($binary_string, 2, 30)) / 1073741824); // pow(2, 30) = 1073741824 + } + + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.graphic.gif.php b/modules/getid3/module.graphic.gif.php new file mode 100644 index 00000000..b3b11398 --- /dev/null +++ b/modules/getid3/module.graphic.gif.php @@ -0,0 +1,92 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.graphic.gif.php | +// | Module for analyzing CompuServe GIF graphic files. | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.graphic.gif.php,v 1.2 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_gif extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'gif'; + $getid3->info['video']['dataformat'] = 'gif'; + $getid3->info['video']['lossless'] = true; + $getid3->info['video']['pixel_aspect_ratio'] = (float)1; + + $getid3->info['gif']['header'] = array (); + $info_gif_header = &$getid3->info['gif']['header']; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $gif_header = fread($getid3->fp, 13); + + // Magic bytes + $info_gif_header['raw']['identifier'] = 'GIF'; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_gif_header['raw'], $gif_header, 3, + array ( + 'version' => -3, // string + 'width' => 2, + 'height' => 2, + 'flags' => 1, + 'bg_color_index' => 1, + 'aspect_ratio' => 1 + ) + ); + + $getid3->info['video']['resolution_x'] = $info_gif_header['raw']['width']; + $getid3->info['video']['resolution_y'] = $info_gif_header['raw']['height']; + $getid3->info['gif']['version'] = $info_gif_header['raw']['version']; + + $info_gif_header['flags']['global_color_table'] = (bool)($info_gif_header['raw']['flags'] & 0x80); + + if ($info_gif_header['raw']['flags'] & 0x80) { + // Number of bits per primary color available to the original image, minus 1 + $info_gif_header['bits_per_pixel'] = 3 * ((($info_gif_header['raw']['flags'] & 0x70) >> 4) + 1); + } else { + $info_gif_header['bits_per_pixel'] = 0; + } + + $info_gif_header['flags']['global_color_sorted'] = (bool)($info_gif_header['raw']['flags'] & 0x40); + if ($info_gif_header['flags']['global_color_table']) { + // the number of bytes contained in the Global Color Table. To determine that + // actual size of the color table, raise 2 to [the value of the field + 1] + $info_gif_header['global_color_size'] = pow(2, ($info_gif_header['raw']['flags'] & 0x07) + 1); + $getid3->info['video']['bits_per_sample'] = ($info_gif_header['raw']['flags'] & 0x07) + 1; + } else { + $info_gif_header['global_color_size'] = 0; + } + + if ($info_gif_header['raw']['aspect_ratio'] != 0) { + // Aspect Ratio = (Pixel Aspect Ratio + 15) / 64 + $info_gif_header['aspect_ratio'] = ($info_gif_header['raw']['aspect_ratio'] + 15) / 64; + } + + return true; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.graphic.jpeg.php b/modules/getid3/module.graphic.jpeg.php new file mode 100644 index 00000000..886e9d7b --- /dev/null +++ b/modules/getid3/module.graphic.jpeg.php @@ -0,0 +1,62 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.graphic.jpeg.php | +// | Module for analyzing JPEG graphic files. | +// | dependencies: exif support in PHP (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.graphic.jpeg.php,v 1.4 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_jpeg extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'jpg'; + $getid3->info['video']['dataformat'] = 'jpg'; + $getid3->info['video']['lossless'] = false; + $getid3->info['video']['bits_per_sample'] = 24; + $getid3->info['video']['pixel_aspect_ratio'] = (float)1; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + + list($getid3->info['video']['resolution_x'], $getid3->info['video']['resolution_y'], $type) = getimagesize($getid3->filename); + + if ($type != 2) { + throw new getid3_exception('File detected as JPEG, but is currupt.'); + } + + if (function_exists('exif_read_data')) { + + $getid3->info['jpg']['exif'] = exif_read_data($getid3->filename, '', true, false); + + } else { + + $getid3->warning('EXIF parsing only available when compiled with --enable-exif (or php_exif.dll enabled for Windows).'); + } + + return true; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.graphic.pcd.php b/modules/getid3/module.graphic.pcd.php new file mode 100644 index 00000000..dacb6c8a --- /dev/null +++ b/modules/getid3/module.graphic.pcd.php @@ -0,0 +1,56 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.graphic.pcd.php | +// | Module for analyzing PhotoCD (PCD) Image files. | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.graphic.pcd.php,v 1.2 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_pcd extends getid3_handler +{ + + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'pcd'; + $getid3->info['video']['dataformat'] = 'pcd'; + $getid3->info['video']['lossless'] = false; + + fseek($getid3->fp, $getid3->info['avdataoffset'] + 72, SEEK_SET); + + $pcd_flags = fread($getid3->fp, 1); + $pcd_is_vertical = ((ord($pcd_flags) & 0x01) ? true : false); + + if ($pcd_is_vertical) { + $getid3->info['video']['resolution_x'] = 3072; + $getid3->info['video']['resolution_y'] = 2048; + } else { + $getid3->info['video']['resolution_x'] = 2048; + $getid3->info['video']['resolution_y'] = 3072; + } + + } + + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.graphic.png.php b/modules/getid3/module.graphic.png.php new file mode 100644 index 00000000..daa39221 --- /dev/null +++ b/modules/getid3/module.graphic.png.php @@ -0,0 +1,556 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.graphic.png.php | +// | Module for analyzing PNG graphic files. | +// | dependencies: zlib support in PHP (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.graphic.png.php,v 1.4 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_png extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['png'] = array (); + $info_png = &$getid3->info['png']; + + $getid3->info['fileformat'] = 'png'; + $getid3->info['video']['dataformat'] = 'png'; + $getid3->info['video']['lossless'] = false; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $png_filedata = fread($getid3->fp, getid3::FREAD_BUFFER_SIZE); + + // Magic bytes "\x89\x50\x4E\x47\x0D\x0A\x1A\x0A" + + $offset = 8; + + while (((ftell($getid3->fp) - (strlen($png_filedata) - $offset)) < $getid3->info['filesize'])) { + + $chunk['data_length'] = getid3_lib::BigEndian2Int(substr($png_filedata, $offset, 4)); + $offset += 4; + while (((strlen($png_filedata) - $offset) < ($chunk['data_length'] + 4)) && (ftell($getid3->fp) < $getid3->info['filesize'])) { + $png_filedata .= fread($getid3->fp, getid3::FREAD_BUFFER_SIZE); + } + + $chunk['type_text'] = substr($png_filedata, $offset, 4); + $chunk['type_raw'] = getid3_lib::BigEndian2Int($chunk['type_text']); + $offset += 4; + + $chunk['data'] = substr($png_filedata, $offset, $chunk['data_length']); + $offset += $chunk['data_length']; + + $chunk['crc'] = getid3_lib::BigEndian2Int(substr($png_filedata, $offset, 4)); + $offset += 4; + + $chunk['flags']['ancilliary'] = (bool)($chunk['type_raw'] & 0x20000000); + $chunk['flags']['private'] = (bool)($chunk['type_raw'] & 0x00200000); + $chunk['flags']['reserved'] = (bool)($chunk['type_raw'] & 0x00002000); + $chunk['flags']['safe_to_copy'] = (bool)($chunk['type_raw'] & 0x00000020); + + // shortcut + $info_png[$chunk['type_text']] = array (); + $info_png_chunk_type_text = &$info_png[$chunk['type_text']]; + + switch ($chunk['type_text']) { + + case 'IHDR': // Image Header + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['width'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 4)); + $info_png_chunk_type_text['height'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 4, 4)); + + getid3_lib::ReadSequence('BigEndian2Int', $info_png_chunk_type_text['raw'], $chunk['data'], 8, + array ( + 'bit_depth' => 1, + 'color_type' => 1, + 'compression_method' => 1, + 'filter_method' => 1, + 'interlace_method' => 1 + ) + ); + + $info_png_chunk_type_text['compression_method_text'] = getid3_png::PNGcompressionMethodLookup($info_png_chunk_type_text['raw']['compression_method']); + $info_png_chunk_type_text['color_type']['palette'] = (bool)($info_png_chunk_type_text['raw']['color_type'] & 0x01); + $info_png_chunk_type_text['color_type']['true_color'] = (bool)($info_png_chunk_type_text['raw']['color_type'] & 0x02); + $info_png_chunk_type_text['color_type']['alpha'] = (bool)($info_png_chunk_type_text['raw']['color_type'] & 0x04); + + $getid3->info['video']['resolution_x'] = $info_png_chunk_type_text['width']; + $getid3->info['video']['resolution_y'] = $info_png_chunk_type_text['height']; + + $getid3->info['video']['bits_per_sample'] = getid3_png::IHDRcalculateBitsPerSample($info_png_chunk_type_text['raw']['color_type'], $info_png_chunk_type_text['raw']['bit_depth']); + break; + + + case 'PLTE': // Palette + $info_png_chunk_type_text['header'] = $chunk; + $palette_offset = 0; + for ($i = 0; $i <= 255; $i++) { + $red = @getid3_lib::BigEndian2Int($chunk['data']{$palette_offset++}); + $green = @getid3_lib::BigEndian2Int($chunk['data']{$palette_offset++}); + $blue = @getid3_lib::BigEndian2Int($chunk['data']{$palette_offset++}); + $info_png_chunk_type_text[$i] = (($red << 16) | ($green << 8) | ($blue)); + } + break; + + + case 'tRNS': // Transparency + $info_png_chunk_type_text['header'] = $chunk; + switch ($info_png['IHDR']['raw']['color_type']) { + case 0: + $info_png_chunk_type_text['transparent_color_gray'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 2)); + break; + + case 2: + $info_png_chunk_type_text['transparent_color_red'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 2)); + $info_png_chunk_type_text['transparent_color_green'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 2, 2)); + $info_png_chunk_type_text['transparent_color_blue'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 4, 2)); + break; + + case 3: + for ($i = 0; $i < strlen($chunk['data']); $i++) { + $info_png_chunk_type_text['palette_opacity'][$i] = getid3_lib::BigEndian2Int($chunk['data'][$i]); + } + break; + + case 4: + case 6: + throw new getid3_exception('Invalid color_type in tRNS chunk: '.$info_png['IHDR']['raw']['color_type']); + + default: + $getid3->warning('Unhandled color_type in tRNS chunk: '.$info_png['IHDR']['raw']['color_type']); + break; + } + break; + + + case 'gAMA': // Image Gamma + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['gamma'] = getid3_lib::BigEndian2Int($chunk['data']) / 100000; + break; + + + case 'cHRM': // Primary Chromaticities + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['white_x'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 4)) / 100000; + $info_png_chunk_type_text['white_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 4, 4)) / 100000; + $info_png_chunk_type_text['red_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 8, 4)) / 100000; + $info_png_chunk_type_text['red_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 12, 4)) / 100000; + $info_png_chunk_type_text['green_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 16, 4)) / 100000; + $info_png_chunk_type_text['green_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 20, 4)) / 100000; + $info_png_chunk_type_text['blue_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 24, 4)) / 100000; + $info_png_chunk_type_text['blue_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 28, 4)) / 100000; + break; + + + case 'sRGB': // Standard RGB Color Space + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['reindering_intent'] = getid3_lib::BigEndian2Int($chunk['data']); + $info_png_chunk_type_text['reindering_intent_text'] = getid3_png::PNGsRGBintentLookup($info_png_chunk_type_text['reindering_intent']); + break; + + + case 'iCCP': // Embedded ICC Profile + $info_png_chunk_type_text['header'] = $chunk; + list($profilename, $compressiondata) = explode("\x00", $chunk['data'], 2); + $info_png_chunk_type_text['profile_name'] = $profilename; + $info_png_chunk_type_text['compression_method'] = getid3_lib::BigEndian2Int($compressiondata[0]); + $info_png_chunk_type_text['compression_profile'] = substr($compressiondata, 1); + $info_png_chunk_type_text['compression_method_text'] = getid3_png::PNGcompressionMethodLookup($info_png_chunk_type_text['compression_method']); + break; + + + case 'tEXt': // Textual Data + $info_png_chunk_type_text['header'] = $chunk; + list($keyword, $text) = explode("\x00", $chunk['data'], 2); + $info_png_chunk_type_text['keyword'] = $keyword; + $info_png_chunk_type_text['text'] = $text; + + $info_png['comments'][$info_png_chunk_type_text['keyword']][] = $info_png_chunk_type_text['text']; + break; + + + case 'zTXt': // Compressed Textual Data + $info_png_chunk_type_text['header'] = $chunk; + list($keyword, $otherdata) = explode("\x00", $chunk['data'], 2); + $info_png_chunk_type_text['keyword'] = $keyword; + $info_png_chunk_type_text['compression_method'] = getid3_lib::BigEndian2Int(substr($otherdata, 0, 1)); + $info_png_chunk_type_text['compressed_text'] = substr($otherdata, 1); + $info_png_chunk_type_text['compression_method_text'] = getid3_png::PNGcompressionMethodLookup($info_png_chunk_type_text['compression_method']); + + if ($info_png_chunk_type_text['compression_method'] != 0) { + // unknown compression method + break; + } + + if (function_exists('gzuncompress')) { + $info_png_chunk_type_text['text'] = gzuncompress($info_png_chunk_type_text['compressed_text']); + } + else { + if (!@$this->zlib_warning) { + $getid3->warning('PHP does not have --with-zlib support - cannot gzuncompress()'); + } + $this->zlib_warning = true; + } + + + if (isset($info_png_chunk_type_text['text'])) { + $info_png['comments'][$info_png_chunk_type_text['keyword']][] = $info_png_chunk_type_text['text']; + } + break; + + + case 'iTXt': // International Textual Data + $info_png_chunk_type_text['header'] = $chunk; + list($keyword, $otherdata) = explode("\x00", $chunk['data'], 2); + $info_png_chunk_type_text['keyword'] = $keyword; + $info_png_chunk_type_text['compression'] = (bool)getid3_lib::BigEndian2Int(substr($otherdata, 0, 1)); + $info_png_chunk_type_text['compression_method'] = getid3_lib::BigEndian2Int($otherdata[1]); + $info_png_chunk_type_text['compression_method_text'] = getid3_png::PNGcompressionMethodLookup($info_png_chunk_type_text['compression_method']); + list($languagetag, $translatedkeyword, $text) = explode("\x00", substr($otherdata, 2), 3); + $info_png_chunk_type_text['language_tag'] = $languagetag; + $info_png_chunk_type_text['translated_keyword'] = $translatedkeyword; + + if ($info_png_chunk_type_text['compression']) { + + switch ($info_png_chunk_type_text['compression_method']) { + case 0: + if (function_exists('gzuncompress')) { + $info_png_chunk_type_text['text'] = gzuncompress($text); + } + else { + if (!@$this->zlib_warning) { + $getid3->warning('PHP does not have --with-zlib support - cannot gzuncompress()'); + } + $this->zlib_warning = true; + } + break; + + default: + // unknown compression method + break; + } + + } else { + + $info_png_chunk_type_text['text'] = $text; + + } + + if (isset($info_png_chunk_type_text['text'])) { + $info_png['comments'][$info_png_chunk_type_text['keyword']][] = $info_png_chunk_type_text['text']; + } + break; + + + case 'bKGD': // Background Color + $info_png_chunk_type_text['header'] = $chunk; + switch ($info_png['IHDR']['raw']['color_type']) { + case 0: + case 4: + $info_png_chunk_type_text['background_gray'] = getid3_lib::BigEndian2Int($chunk['data']); + break; + + case 2: + case 6: + $info_png_chunk_type_text['background_red'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0 * $info_png['IHDR']['raw']['bit_depth'], $info_png['IHDR']['raw']['bit_depth'])); + $info_png_chunk_type_text['background_green'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 1 * $info_png['IHDR']['raw']['bit_depth'], $info_png['IHDR']['raw']['bit_depth'])); + $info_png_chunk_type_text['background_blue'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 2 * $info_png['IHDR']['raw']['bit_depth'], $info_png['IHDR']['raw']['bit_depth'])); + break; + + case 3: + $info_png_chunk_type_text['background_index'] = getid3_lib::BigEndian2Int($chunk['data']); + break; + + default: + break; + } + break; + + + case 'pHYs': // Physical Pixel Dimensions + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['pixels_per_unit_x'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 4)); + $info_png_chunk_type_text['pixels_per_unit_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 4, 4)); + $info_png_chunk_type_text['unit_specifier'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 8, 1)); + $info_png_chunk_type_text['unit'] = getid3_png::PNGpHYsUnitLookup($info_png_chunk_type_text['unit_specifier']); + break; + + + case 'sBIT': // Significant Bits + $info_png_chunk_type_text['header'] = $chunk; + switch ($info_png['IHDR']['raw']['color_type']) { + case 0: + $info_png_chunk_type_text['significant_bits_gray'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 1)); + break; + + case 2: + case 3: + $info_png_chunk_type_text['significant_bits_red'] = getid3_lib::BigEndian2Int($chunk['data'][0]); + $info_png_chunk_type_text['significant_bits_green'] = getid3_lib::BigEndian2Int($chunk['data'][1]); + $info_png_chunk_type_text['significant_bits_blue'] = getid3_lib::BigEndian2Int($chunk['data'][2]); + break; + + case 4: + $info_png_chunk_type_text['significant_bits_gray'] = getid3_lib::BigEndian2Int($chunk['data'][0]); + $info_png_chunk_type_text['significant_bits_alpha'] = getid3_lib::BigEndian2Int($chunk['data'][1]); + break; + + case 6: + $info_png_chunk_type_text['significant_bits_red'] = getid3_lib::BigEndian2Int($chunk['data'][0]); + $info_png_chunk_type_text['significant_bits_green'] = getid3_lib::BigEndian2Int($chunk['data'][1]); + $info_png_chunk_type_text['significant_bits_blue'] = getid3_lib::BigEndian2Int($chunk['data'][2]); + $info_png_chunk_type_text['significant_bits_alpha'] = getid3_lib::BigEndian2Int($chunk['data'][3]); + break; + + default: + break; + } + break; + + + case 'sPLT': // Suggested Palette + $info_png_chunk_type_text['header'] = $chunk; + + list($palettename, $otherdata) = explode("\x00", $chunk['data'], 2); + $info_png_chunk_type_text['palette_name'] = $palettename; + + $info_png_chunk_type_text['sample_depth_bits'] = getid3_lib::BigEndian2Int($otherdata[0]); + $info_png_chunk_type_text['sample_depth_bytes'] = $info_png_chunk_type_text['sample_depth_bits'] / 8; + + $s_plt_offset = 1; + $paletteCounter = 0; + while ($s_plt_offset < strlen($otherdata)) { + + $info_png_chunk_type_text['red'][$paletteCounter] = getid3_lib::BigEndian2Int(substr($otherdata, $s_plt_offset, $info_png_chunk_type_text['sample_depth_bytes'])); + $s_plt_offset += $info_png_chunk_type_text['sample_depth_bytes']; + + $info_png_chunk_type_text['green'][$paletteCounter] = getid3_lib::BigEndian2Int(substr($otherdata, $s_plt_offset, $info_png_chunk_type_text['sample_depth_bytes'])); + $s_plt_offset += $info_png_chunk_type_text['sample_depth_bytes']; + + $info_png_chunk_type_text['blue'][$paletteCounter] = getid3_lib::BigEndian2Int(substr($otherdata, $s_plt_offset, $info_png_chunk_type_text['sample_depth_bytes'])); + $s_plt_offset += $info_png_chunk_type_text['sample_depth_bytes']; + + $info_png_chunk_type_text['alpha'][$paletteCounter] = getid3_lib::BigEndian2Int(substr($otherdata, $s_plt_offset, $info_png_chunk_type_text['sample_depth_bytes'])); + $s_plt_offset += $info_png_chunk_type_text['sample_depth_bytes']; + + $info_png_chunk_type_text['frequency'][$paletteCounter] = getid3_lib::BigEndian2Int(substr($otherdata, $s_plt_offset, 2)); + $s_plt_offset += 2; + + $paletteCounter++; + } + break; + + + case 'hIST': // Palette Histogram + $info_png_chunk_type_text['header'] = $chunk; + $h_ist_counter = 0; + while ($h_ist_counter < strlen($chunk['data'])) { + $info_png_chunk_type_text[$h_ist_counter] = getid3_lib::BigEndian2Int(substr($chunk['data'], $h_ist_counter / 2, 2)); + $h_ist_counter += 2; + } + break; + + + case 'tIME': // Image Last-Modification Time + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['year'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 2)); + $info_png_chunk_type_text['month'] = getid3_lib::BigEndian2Int($chunk['data']{2}); + $info_png_chunk_type_text['day'] = getid3_lib::BigEndian2Int($chunk['data']{3}); + $info_png_chunk_type_text['hour'] = getid3_lib::BigEndian2Int($chunk['data']{4}); + $info_png_chunk_type_text['minute'] = getid3_lib::BigEndian2Int($chunk['data']{5}); + $info_png_chunk_type_text['second'] = getid3_lib::BigEndian2Int($chunk['data']{6}); + $info_png_chunk_type_text['unix'] = gmmktime($info_png_chunk_type_text['hour'], $info_png_chunk_type_text['minute'], $info_png_chunk_type_text['second'], $info_png_chunk_type_text['month'], $info_png_chunk_type_text['day'], $info_png_chunk_type_text['year']); + break; + + + case 'oFFs': // Image Offset + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['position_x'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 4), false, true); + $info_png_chunk_type_text['position_y'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 4, 4), false, true); + $info_png_chunk_type_text['unit_specifier'] = getid3_lib::BigEndian2Int($chunk['data'][8]); + $info_png_chunk_type_text['unit'] = getid3_png::PNGoFFsUnitLookup($info_png_chunk_type_text['unit_specifier']); + break; + + + case 'pCAL': // Calibration Of Pixel Values + $info_png_chunk_type_text['header'] = $chunk; + list($calibrationname, $otherdata) = explode("\x00", $chunk['data'], 2); + $info_png_chunk_type_text['calibration_name'] = $calibrationname; + $info_png_chunk_type_text['original_zero'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 4), false, true); + $info_png_chunk_type_text['original_max'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 4, 4), false, true); + $info_png_chunk_type_text['equation_type'] = getid3_lib::BigEndian2Int($chunk['data'][8]); + $info_png_chunk_type_text['equation_type_text'] = getid3_png::PNGpCALequationTypeLookup($info_png_chunk_type_text['equation_type']); + $info_png_chunk_type_text['parameter_count'] = getid3_lib::BigEndian2Int($chunk['data'][9]); + $info_png_chunk_type_text['parameters'] = explode("\x00", substr($chunk['data'], 10)); + break; + + + case 'sCAL': // Physical Scale Of Image Subject + $info_png_chunk_type_text['header'] = $chunk; + $info_png_chunk_type_text['unit_specifier'] = getid3_lib::BigEndian2Int(substr($chunk['data'], 0, 1)); + $info_png_chunk_type_text['unit'] = getid3_png::PNGsCALUnitLookup($info_png_chunk_type_text['unit_specifier']); + list($info_png_chunk_type_text['pixel_width'], $info_png_chunk_type_text['pixel_height']) = explode("\x00", substr($chunk['data'], 1)); + break; + + + case 'gIFg': // GIF Graphic Control Extension + $gIFg_counter = 0; + if (isset($info_png_chunk_type_text) && is_array($info_png_chunk_type_text)) { + $gIFg_counter = count($info_png_chunk_type_text); + } + $info_png_chunk_type_text[$gIFg_counter]['header'] = $chunk; + $info_png_chunk_type_text[$gIFg_counter]['disposal_method'] = getid3_lib::BigEndian2Int($chunk['data'][0]); + $info_png_chunk_type_text[$gIFg_counter]['user_input_flag'] = getid3_lib::BigEndian2Int($chunk['data'][1]); + $info_png_chunk_type_text[$gIFg_counter]['delay_time'] = getid3_lib::BigEndian2Int($chunk['data'][2]); + break; + + + case 'gIFx': // GIF Application Extension + $gIFx_counter = 0; + if (isset($info_png_chunk_type_text) && is_array($info_png_chunk_type_text)) { + $gIFx_counter = count($info_png_chunk_type_text); + } + $info_png_chunk_type_text[$gIFx_counter]['header'] = $chunk; + $info_png_chunk_type_text[$gIFx_counter]['application_identifier'] = substr($chunk['data'], 0, 8); + $info_png_chunk_type_text[$gIFx_counter]['authentication_code'] = substr($chunk['data'], 8, 3); + $info_png_chunk_type_text[$gIFx_counter]['application_data'] = substr($chunk['data'], 11); + break; + + + case 'IDAT': // Image Data + $idat_information_field_index = 0; + if (isset($info_png['IDAT']) && is_array($info_png['IDAT'])) { + $idat_information_field_index = count($info_png['IDAT']); + } + unset($chunk['data']); + $info_png_chunk_type_text[$idat_information_field_index]['header'] = $chunk; + break; + + + case 'IEND': // Image Trailer + $info_png_chunk_type_text['header'] = $chunk; + break; + + + default: + $info_png_chunk_type_text['header'] = $chunk; + $getid3->warning('Unhandled chunk type: '.$chunk['type_text']); + break; + } + } + + return true; + } + + + + public static function PNGsRGBintentLookup($sRGB) { + + static $lookup = array ( + 0 => 'Perceptual', + 1 => 'Relative colorimetric', + 2 => 'Saturation', + 3 => 'Absolute colorimetric' + ); + return (isset($lookup[$sRGB]) ? $lookup[$sRGB] : 'invalid'); + } + + + + public static function PNGcompressionMethodLookup($compression_method) { + + return ($compression_method == 0 ? 'deflate/inflate' : 'invalid'); + } + + + + public static function PNGpHYsUnitLookup($unit_id) { + + static $lookup = array ( + 0 => 'unknown', + 1 => 'meter' + ); + return (isset($lookup[$unit_id]) ? $lookup[$unit_id] : 'invalid'); + } + + + + public static function PNGoFFsUnitLookup($unit_id) { + + static $lookup = array ( + 0 => 'pixel', + 1 => 'micrometer' + ); + return (isset($lookup[$unit_id]) ? $lookup[$unit_id] : 'invalid'); + } + + + + public static function PNGpCALequationTypeLookup($equation_type) { + + static $lookup = array ( + 0 => 'Linear mapping', + 1 => 'Base-e exponential mapping', + 2 => 'Arbitrary-base exponential mapping', + 3 => 'Hyperbolic mapping' + ); + return (isset($lookup[$equation_type]) ? $lookup[$equation_type] : 'invalid'); + } + + + + public static function PNGsCALUnitLookup($unit_id) { + + static $lookup = array ( + 0 => 'meter', + 1 => 'radian' + ); + return (isset($lookup[$unit_id]) ? $lookup[$unit_id] : 'invalid'); + } + + + + public static function IHDRcalculateBitsPerSample($color_type, $bit_depth) { + + switch ($color_type) { + case 0: // Each pixel is a grayscale sample. + return $bit_depth; + + case 2: // Each pixel is an R,G,B triple + return 3 * $bit_depth; + + case 3: // Each pixel is a palette index; a PLTE chunk must appear. + return $bit_depth; + + case 4: // Each pixel is a grayscale sample, followed by an alpha sample. + return 2 * $bit_depth; + + case 6: // Each pixel is an R,G,B triple, followed by an alpha sample. + return 4 * $bit_depth; + } + return false; + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.graphic.tiff.php b/modules/getid3/module.graphic.tiff.php new file mode 100644 index 00000000..f0f5a2e8 --- /dev/null +++ b/modules/getid3/module.graphic.tiff.php @@ -0,0 +1,215 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.graphic.tiff.php | +// | Module for analyzing TIFF graphic files. | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.graphic.tiff.php,v 1.2 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_tiff extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET); + $tiff_header = fread($getid3->fp, 4); + + $getid3->info['tiff']['byte_order'] = substr($tiff_header, 0, 2) == 'II' ? 'Intel' : 'Motorola'; + $endian2int = substr($tiff_header, 0, 2) == 'II' ? 'LittleEndian2Int' : 'BigEndian2Int'; + + $getid3->info['fileformat'] = 'tiff'; + $getid3->info['video']['dataformat'] = 'tiff'; + $getid3->info['video']['lossless'] = true; + $getid3->info['tiff']['ifd'] = array (); + $current_ifd = array (); + + $field_type_byte_length = array (1=>1, 2=>1, 3=>2, 4=>4, 5=>8); + + $next_ifd_offset = getid3_lib::$endian2int(fread($getid3->fp, 4)); + + while ($next_ifd_offset > 0) { + + $current_ifd['offset'] = $next_ifd_offset; + + fseek($getid3->fp, $getid3->info['avdataoffset'] + $next_ifd_offset, SEEK_SET); + $current_ifd['fieldcount'] = getid3_lib::$endian2int(fread($getid3->fp, 2)); + + for ($i = 0; $i < $current_ifd['fieldcount']; $i++) { + + // shortcut + $current_ifd['fields'][$i] = array (); + $current_ifd_fields_i = &$current_ifd['fields'][$i]; + + $current_ifd_fields_i['raw']['tag'] = getid3_lib::$endian2int(fread($getid3->fp, 2)); + $current_ifd_fields_i['raw']['type'] = getid3_lib::$endian2int(fread($getid3->fp, 2)); + $current_ifd_fields_i['raw']['length'] = getid3_lib::$endian2int(fread($getid3->fp, 4)); + $current_ifd_fields_i['raw']['offset'] = fread($getid3->fp, 4); + + switch ($current_ifd_fields_i['raw']['type']) { + case 1: // BYTE An 8-bit unsigned integer. + if ($current_ifd_fields_i['raw']['length'] <= 4) { + $current_ifd_fields_i['value'] = getid3_lib::$endian2int(substr($current_ifd_fields_i['raw']['offset'], 0, 1)); + } else { + $current_ifd_fields_i['offset'] = getid3_lib::$endian2int($current_ifd_fields_i['raw']['offset']); + } + break; + + case 2: // ASCII 8-bit bytes that store ASCII codes; the last byte must be null. + if ($current_ifd_fields_i['raw']['length'] <= 4) { + $current_ifd_fields_i['value'] = substr($current_ifd_fields_i['raw']['offset'], 3); + } else { + $current_ifd_fields_i['offset'] = getid3_lib::$endian2int($current_ifd_fields_i['raw']['offset']); + } + break; + + case 3: // SHORT A 16-bit (2-byte) unsigned integer. + if ($current_ifd_fields_i['raw']['length'] <= 2) { + $current_ifd_fields_i['value'] = getid3_lib::$endian2int(substr($current_ifd_fields_i['raw']['offset'], 0, 2)); + } else { + $current_ifd_fields_i['offset'] = getid3_lib::$endian2int($current_ifd_fields_i['raw']['offset']); + } + break; + + case 4: // LONG A 32-bit (4-byte) unsigned integer. + if ($current_ifd_fields_i['raw']['length'] <= 1) { + $current_ifd_fields_i['value'] = getid3_lib::$endian2int($current_ifd_fields_i['raw']['offset']); + } else { + $current_ifd_fields_i['offset'] = getid3_lib::$endian2int($current_ifd_fields_i['raw']['offset']); + } + break; + + case 5: // RATIONAL Two LONG_s: the first represents the numerator of a fraction, the second the denominator. + break; + } + } + + $getid3->info['tiff']['ifd'][] = $current_ifd; + $current_ifd = array (); + $next_ifd_offset = getid3_lib::$endian2int(fread($getid3->fp, 4)); + + } + + foreach ($getid3->info['tiff']['ifd'] as $ifd_id => $ifd_array) { + foreach ($ifd_array['fields'] as $key => $field_array) { + switch ($field_array['raw']['tag']) { + case 256: // ImageWidth + case 257: // ImageLength + case 258: // BitsPerSample + case 259: // Compression + if (!isset($field_array['value'])) { + fseek($getid3->fp, $field_array['offset'], SEEK_SET); + $getid3->info['tiff']['ifd'][$ifd_id]['fields'][$key]['raw']['data'] = fread($getid3->fp, $field_array['raw']['length'] * $field_type_byte_length[$field_array['raw']['type']]); + } + break; + + case 270: // ImageDescription + case 271: // Make + case 272: // Model + case 305: // Software + case 306: // DateTime + case 315: // Artist + case 316: // HostComputer + if (isset($field_array['value'])) { + $getid3->info['tiff']['ifd'][$ifd_id]['fields'][$key]['raw']['data'] = $field_array['value']; + } else { + fseek($getid3->fp, $field_array['offset'], SEEK_SET); + $getid3->info['tiff']['ifd'][$ifd_id]['fields'][$key]['raw']['data'] = fread($getid3->fp, $field_array['raw']['length'] * $field_type_byte_length[$field_array['raw']['type']]); + } + break; + } + switch ($field_array['raw']['tag']) { + case 256: // ImageWidth + $getid3->info['video']['resolution_x'] = $field_array['value']; + break; + + case 257: // ImageLength + $getid3->info['video']['resolution_y'] = $field_array['value']; + break; + + case 258: // BitsPerSample + if (isset($field_array['value'])) { + $getid3->info['video']['bits_per_sample'] = $field_array['value']; + } else { + $getid3->info['video']['bits_per_sample'] = 0; + for ($i = 0; $i < $field_array['raw']['length']; $i++) { + $getid3->info['video']['bits_per_sample'] += getid3_lib::$endian2int(substr($getid3->info['tiff']['ifd'][$ifd_id]['fields'][$key]['raw']['data'], $i * $field_type_byte_length[$field_array['raw']['type']], $field_type_byte_length[$field_array['raw']['type']])); + } + } + break; + + case 259: // Compression + $getid3->info['video']['codec'] = getid3_tiff::TIFFcompressionMethod($field_array['value']); + break; + + case 270: // ImageDescription + case 271: // Make + case 272: // Model + case 305: // Software + case 306: // DateTime + case 315: // Artist + case 316: // HostComputer + @$getid3->info['tiff']['comments'][getid3_tiff::TIFFcommentName($field_array['raw']['tag'])][] = $getid3->info['tiff']['ifd'][$ifd_id]['fields'][$key]['raw']['data']; + break; + + default: + break; + } + } + } + + return true; + } + + + + public static function TIFFcompressionMethod($id) { + + static $lookup = array ( + 1 => 'Uncompressed', + 2 => 'Huffman', + 3 => 'Fax - CCITT 3', + 5 => 'LZW', + 32773 => 'PackBits', + ); + return (isset($lookup[$id]) ? $lookup[$id] : 'unknown/invalid ('.$id.')'); + } + + + + public static function TIFFcommentName($id) { + + static $lookup = array ( + 270 => 'imagedescription', + 271 => 'make', + 272 => 'model', + 305 => 'software', + 306 => 'datetime', + 315 => 'artist', + 316 => 'hostcomputer', + ); + return (isset($lookup[$id]) ? $lookup[$id] : 'unknown/invalid ('.$id.')'); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.lib.data_hash.php b/modules/getid3/module.lib.data_hash.php new file mode 100644 index 00000000..1ede53fa --- /dev/null +++ b/modules/getid3/module.lib.data_hash.php @@ -0,0 +1,196 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.lib.data-hash.php | +// | getID3() library file. | +// | dependencies: NONE. | +// +----------------------------------------------------------------------+ +// +// $Id: module.lib.data_hash.php,v 1.5 2006/12/03 19:28:18 ah Exp $ + + + +class getid3_lib_data_hash +{ + + private $getid3; + + + // constructer - calculate md5/sha1 data + public function __construct(getID3 $getid3, $algorithm) { + + $this->getid3 = $getid3; + + // Check algorithm + if (!preg_match('/^(md5|sha1)$/', $algorithm)) { + throw new getid3_exception('Unsupported algorithm, "'.$algorithm.'", in GetHashdata()'); + } + + + //// Handle ogg vorbis files + + if ((@$getid3->info['fileformat'] == 'ogg') && (@$getid3->info['audio']['dataformat'] == 'vorbis')) { + + // We cannot get an identical md5_data value for Ogg files where the comments + // span more than 1 Ogg page (compared to the same audio data with smaller + // comments) using the normal getID3() method of MD5'ing the data between the + // end of the comments and the end of the file (minus any trailing tags), + // because the page sequence numbers of the pages that the audio data is on + // do not match. Under normal circumstances, where comments are smaller than + // the nominal 4-8kB page size, then this is not a problem, but if there are + // very large comments, the only way around it is to strip off the comment + // tags with vorbiscomment and MD5 that file. + // This procedure must be applied to ALL Ogg files, not just the ones with + // comments larger than 1 page, because the below method simply MD5's the + // whole file with the comments stripped, not just the portion after the + // comments block (which is the standard getID3() method. + + // The above-mentioned problem of comments spanning multiple pages and changing + // page sequence numbers likely happens for OggSpeex and OggFLAC as well, but + // currently vorbiscomment only works on OggVorbis files. + + if ((bool)ini_get('safe_mode')) { + throw new getid3_exception('PHP running in Safe Mode - cannot make system call to vorbiscomment[.exe] needed for '.$algorithm.'_data.'); + } + + if (!preg_match('/^Vorbiscomment /', `vorbiscomment --version 2>&1`)) { + throw new getid3_exception('vorbiscomment[.exe] binary not found in path. UNIX: typically /usr/bin. Windows: typically c:\windows\system32.'); + } + + // Prevent user from aborting script + $old_abort = ignore_user_abort(true); + + // Create empty file + $empty = tempnam('*', 'getID3'); + touch($empty); + + // Use vorbiscomment to make temp file without comments + $temp = tempnam('*', 'getID3'); + + $command_line = 'vorbiscomment -w -c '.escapeshellarg($empty).' '.escapeshellarg(realpath($getid3->filename)).' '.escapeshellarg($temp).' 2>&1'; + + // Error from vorbiscomment + if ($vorbis_comment_error = `$command_line`) { + throw new getid3_exception('System call to vorbiscomment[.exe] failed.'); + } + + // Get hash of newly created file + $hash_function = $algorithm . '_file'; + $getid3->info[$algorithm.'_data'] = $hash_function($temp); + + // Clean up + unlink($empty); + unlink($temp); + + // Reset abort setting + ignore_user_abort($old_abort); + + // Return success + return true; + } + + //// Handle other file formats + + // Get hash from part of file + if (@$getid3->info['avdataoffset'] || (@$getid3->info['avdataend'] && @$getid3->info['avdataend'] < $getid3->info['filesize'])) { + + if ((bool)ini_get('safe_mode')) { + $getid3->warning('PHP running in Safe Mode - backtick operator not available, using slower non-system-call '.$algorithm.' algorithm.'); + $hash_function = 'hash_file_partial_safe_mode'; + } + else { + $hash_function = 'hash_file_partial'; + } + + $getid3->info[$algorithm.'_data'] = $this->$hash_function($getid3->filename, $getid3->info['avdataoffset'], $getid3->info['avdataend'], $algorithm); + } + + // Get hash from whole file - use built-in md5_file() and sha1_file() + else { + $hash_function = $algorithm . '_file'; + $getid3->info[$algorithm.'_data'] = $hash_function($getid3->filename); + } + } + + + + // Return md5/sha1sum for a file from starting position to absolute end position + // Using windows system call + private function hash_file_partial($file, $offset, $end, $algorithm) { + + // It seems that sha1sum.exe for Windows only works on physical files, does not accept piped data + // Fall back to create-temp-file method: + if ($algorithm == 'sha1' && strtoupper(substr(PHP_OS, 0, 3)) == 'WIN') { + return $this->hash_file_partial_safe_mode($file, $offset, $end, $algorithm); + } + + // Check for presence of binaries and revert to safe mode if not found + if (!`head --version`) { + return $this->hash_file_partial_safe_mode($file, $offset, $end, $algorithm); + } + + if (!`tail --version`) { + return $this->hash_file_partial_safe_mode($file, $offset, $end, $algorithm); + } + + if (!`${algorithm}sum --version`) { + return $this->hash_file_partial_safe_mode($file, $offset, $end, $algorithm); + } + + $size = $end - $offset; + $command_line = 'head -c'.$end.' '.escapeshellarg(realpath($file)).' | tail -c'.$size.' | '.$algorithm.'sum'; + return substr(`$command_line`, 0, $algorithm == 'md5' ? 32 : 40); + } + + + + // Return md5/sha1sum for a file from starting position to absolute end position + // Using slow safe_mode temp file + private function hash_file_partial_safe_mode($file, $offset, $end, $algorithm) { + + // Attempt to create a temporary file in the system temp directory - invalid dirname should force to system temp dir + if (($data_filename = tempnam('*', 'getID3')) === false) { + throw new getid3_exception('Unable to create temporary file.'); + } + + // Init + $result = false; + + // Copy parts of file + if ($fp = @fopen($file, 'rb')) { + + if ($fp_data = @fopen($data_filename, 'wb')) { + + fseek($fp, $offset, SEEK_SET); + $bytes_left_to_write = $end - $offset; + while (($bytes_left_to_write > 0) && ($buffer = fread($fp, getid3::FREAD_BUFFER_SIZE))) { + $bytes_written = fwrite($fp_data, $buffer, $bytes_left_to_write); + $bytes_left_to_write -= $bytes_written; + } + fclose($fp_data); + $hash_function = $algorithm . '_file'; + $result = $hash_function($data_filename); + + } + fclose($fp); + } + unlink($data_filename); + return $result; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.lib.iconv_replacement.php b/modules/getid3/module.lib.iconv_replacement.php new file mode 100644 index 00000000..d6f935e8 --- /dev/null +++ b/modules/getid3/module.lib.iconv_replacement.php @@ -0,0 +1,415 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.lib.iconv_replacement.php | +// | getID3() library file. | +// | dependencies: NONE, required by getid3.php if no iconv() present. | +// +----------------------------------------------------------------------+ +// +// $Id: module.lib.iconv_replacement.php,v 1.4 2006/11/02 10:48:02 ah Exp $ + + +class getid3_iconv_replacement +{ + + public static function iconv($in_charset, $out_charset, $string) { + + if ($in_charset == $out_charset) { + return $string; + } + + static $supported_charsets = array ( + 'ISO-8859-1' => 'iso88591', + 'UTF-8' => 'utf8', + 'UTF-16BE' => 'utf16be', + 'UTF-16LE' => 'utf16le', + 'UTF-16' => 'utf16' + ); + + // Convert + $function_name = 'iconv_' . @$supported_charsets[$in_charset] . '_' . @$supported_charsets[$out_charset]; + + if (is_callable(array('getid3_iconv_replacement', $function_name))) { + return getid3_iconv_replacement::$function_name($string); + } + + // Invalid charset used + if (!@$supported_charsets[$in_charset]) { + throw new getid3_exception('PHP does not have iconv() support - cannot use ' . $in_charset . ' charset.'); + } + + if (!@$supported_charsets[$out_charset]) { + throw new getid3_exception('PHP does not have iconv() support - cannot use ' . $out_charset . ' charset.'); + } + } + + + + public static function iconv_int_utf8($charval) { + if ($charval < 128) { + // 0bbbbbbb + $newcharstring = chr($charval); + } elseif ($charval < 2048) { + // 110bbbbb 10bbbbbb + $newcharstring = chr(($charval >> 6) | 0xC0); + $newcharstring .= chr(($charval & 0x3F) | 0x80); + } elseif ($charval < 65536) { + // 1110bbbb 10bbbbbb 10bbbbbb + $newcharstring = chr(($charval >> 12) | 0xE0); + $newcharstring .= chr(($charval >> 6) | 0xC0); + $newcharstring .= chr(($charval & 0x3F) | 0x80); + } else { + // 11110bbb 10bbbbbb 10bbbbbb 10bbbbbb + $newcharstring = chr(($charval >> 18) | 0xF0); + $newcharstring .= chr(($charval >> 12) | 0xC0); + $newcharstring .= chr(($charval >> 6) | 0xC0); + $newcharstring .= chr(($charval & 0x3F) | 0x80); + } + return $newcharstring; + } + + + + // ISO-8859-1 => UTF-8 + public static function iconv_iso88591_utf8($string, $bom=false) { + if (function_exists('utf8_encode')) { + return utf8_encode($string); + } + // utf8_encode() unavailable, use getID3()'s iconv() conversions (possibly PHP is compiled without XML support) + $newcharstring = ''; + if ($bom) { + $newcharstring .= "\xEF\xBB\xBF"; + } + for ($i = 0; $i < strlen($string); $i++) { + $charval = ord($string{$i}); + $newcharstring .= getid3_iconv_replacement::iconv_int_utf8($charval); + } + return $newcharstring; + } + + + + // ISO-8859-1 => UTF-16BE + public static function iconv_iso88591_utf16be($string, $bom=false) { + $newcharstring = ''; + if ($bom) { + $newcharstring .= "\xFE\xFF"; + } + for ($i = 0; $i < strlen($string); $i++) { + $newcharstring .= "\x00".$string{$i}; + } + return $newcharstring; + } + + + + // ISO-8859-1 => UTF-16LE + public static function iconv_iso88591_utf16le($string, $bom=false) { + $newcharstring = ''; + if ($bom) { + $newcharstring .= "\xFF\xFE"; + } + for ($i = 0; $i < strlen($string); $i++) { + $newcharstring .= $string{$i}."\x00"; + } + return $newcharstring; + } + + + + // ISO-8859-1 => UTF-16 + public static function iconv_iso88591_utf16($string) { + return getid3_lib::iconv_iso88591_utf16le($string, true); + } + + + + // UTF-8 => ISO-8859-1 + public static function iconv_utf8_iso88591($string) { + if (function_exists('utf8_decode')) { + return utf8_decode($string); + } + // utf8_decode() unavailable, use getID3()'s iconv() conversions (possibly PHP is compiled without XML support) + $newcharstring = ''; + $offset = 0; + $stringlength = strlen($string); + while ($offset < $stringlength) { + if ((ord($string{$offset}) | 0x07) == 0xF7) { + // 11110bbb 10bbbbbb 10bbbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x07) << 18) & + ((ord($string{($offset + 1)}) & 0x3F) << 12) & + ((ord($string{($offset + 2)}) & 0x3F) << 6) & + (ord($string{($offset + 3)}) & 0x3F); + $offset += 4; + } elseif ((ord($string{$offset}) | 0x0F) == 0xEF) { + // 1110bbbb 10bbbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x0F) << 12) & + ((ord($string{($offset + 1)}) & 0x3F) << 6) & + (ord($string{($offset + 2)}) & 0x3F); + $offset += 3; + } elseif ((ord($string{$offset}) | 0x1F) == 0xDF) { + // 110bbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x1F) << 6) & + (ord($string{($offset + 1)}) & 0x3F); + $offset += 2; + } elseif ((ord($string{$offset}) | 0x7F) == 0x7F) { + // 0bbbbbbb + $charval = ord($string{$offset}); + $offset += 1; + } else { + // error? throw some kind of warning here? + $charval = false; + $offset += 1; + } + if ($charval !== false) { + $newcharstring .= (($charval < 256) ? chr($charval) : '?'); + } + } + return $newcharstring; + } + + + + // UTF-8 => UTF-16BE + public static function iconv_utf8_utf16be($string, $bom=false) { + $newcharstring = ''; + if ($bom) { + $newcharstring .= "\xFE\xFF"; + } + $offset = 0; + $stringlength = strlen($string); + while ($offset < $stringlength) { + if ((ord($string{$offset}) | 0x07) == 0xF7) { + // 11110bbb 10bbbbbb 10bbbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x07) << 18) & + ((ord($string{($offset + 1)}) & 0x3F) << 12) & + ((ord($string{($offset + 2)}) & 0x3F) << 6) & + (ord($string{($offset + 3)}) & 0x3F); + $offset += 4; + } elseif ((ord($string{$offset}) | 0x0F) == 0xEF) { + // 1110bbbb 10bbbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x0F) << 12) & + ((ord($string{($offset + 1)}) & 0x3F) << 6) & + (ord($string{($offset + 2)}) & 0x3F); + $offset += 3; + } elseif ((ord($string{$offset}) | 0x1F) == 0xDF) { + // 110bbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x1F) << 6) & + (ord($string{($offset + 1)}) & 0x3F); + $offset += 2; + } elseif ((ord($string{$offset}) | 0x7F) == 0x7F) { + // 0bbbbbbb + $charval = ord($string{$offset}); + $offset += 1; + } else { + // error? throw some kind of warning here? + $charval = false; + $offset += 1; + } + if ($charval !== false) { + $newcharstring .= (($charval < 65536) ? getid3_lib::BigEndian2String($charval, 2) : "\x00".'?'); + } + } + return $newcharstring; + } + + + + // UTF-8 => UTF-16LE + public static function iconv_utf8_utf16le($string, $bom=false) { + $newcharstring = ''; + if ($bom) { + $newcharstring .= "\xFF\xFE"; + } + $offset = 0; + $stringlength = strlen($string); + while ($offset < $stringlength) { + if ((ord($string{$offset}) | 0x07) == 0xF7) { + // 11110bbb 10bbbbbb 10bbbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x07) << 18) & + ((ord($string{($offset + 1)}) & 0x3F) << 12) & + ((ord($string{($offset + 2)}) & 0x3F) << 6) & + (ord($string{($offset + 3)}) & 0x3F); + $offset += 4; + } elseif ((ord($string{$offset}) | 0x0F) == 0xEF) { + // 1110bbbb 10bbbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x0F) << 12) & + ((ord($string{($offset + 1)}) & 0x3F) << 6) & + (ord($string{($offset + 2)}) & 0x3F); + $offset += 3; + } elseif ((ord($string{$offset}) | 0x1F) == 0xDF) { + // 110bbbbb 10bbbbbb + $charval = ((ord($string{($offset + 0)}) & 0x1F) << 6) & + (ord($string{($offset + 1)}) & 0x3F); + $offset += 2; + } elseif ((ord($string{$offset}) | 0x7F) == 0x7F) { + // 0bbbbbbb + $charval = ord($string{$offset}); + $offset += 1; + } else { + // error? maybe throw some warning here? + $charval = false; + $offset += 1; + } + if ($charval !== false) { + $newcharstring .= (($charval < 65536) ? getid3_lib::LittleEndian2String($charval, 2) : '?'."\x00"); + } + } + return $newcharstring; + } + + + + // UTF-8 => UTF-16 + public static function iconv_utf8_utf16($string) { + return getid3_lib::iconv_utf8_utf16le($string, true); + } + + + + // UTF-16BE => ISO-8859-1 + public static function iconv_utf16be_iso88591($string) { + if (substr($string, 0, 2) == "\xFE\xFF") { + // strip BOM + $string = substr($string, 2); + } + $newcharstring = ''; + for ($i = 0; $i < strlen($string); $i += 2) { + $charval = getid3_lib::BigEndian2Int(substr($string, $i, 2)); + $newcharstring .= (($charval < 256) ? chr($charval) : '?'); + } + return $newcharstring; + } + + + + // UTF-16BE => UTF-8 + public static function iconv_utf16be_utf8($string) { + if (substr($string, 0, 2) == "\xFE\xFF") { + // strip BOM + $string = substr($string, 2); + } + $newcharstring = ''; + for ($i = 0; $i < strlen($string); $i += 2) { + $charval = getid3_lib::BigEndian2Int(substr($string, $i, 2)); + $newcharstring .= getid3_iconv_replacement::iconv_int_utf8($charval); + } + return $newcharstring; + } + + + + // UTF-16BE => UTF-16LE + public static function iconv_utf16be_utf16le($string) { + return getid3_iconv_replacement::iconv_utf8_utf16le(getid3_iconv_replacement::iconv_utf16be_utf8($string)); + } + + + + // UTF-16BE => UTF-16 + public static function iconv_utf16be_utf16($string) { + return getid3_iconv_replacement::iconv_utf8_utf16(getid3_iconv_replacement::iconv_utf16be_utf8($string)); + } + + + + // UTF-16LE => ISO-8859-1 + public static function iconv_utf16le_iso88591($string) { + if (substr($string, 0, 2) == "\xFF\xFE") { + // strip BOM + $string = substr($string, 2); + } + $newcharstring = ''; + for ($i = 0; $i < strlen($string); $i += 2) { + $charval = getid3_lib::LittleEndian2Int(substr($string, $i, 2)); + $newcharstring .= (($charval < 256) ? chr($charval) : '?'); + } + return $newcharstring; + } + + + + // UTF-16LE => UTF-8 + public static function iconv_utf16le_utf8($string) { + if (substr($string, 0, 2) == "\xFF\xFE") { + // strip BOM + $string = substr($string, 2); + } + $newcharstring = ''; + for ($i = 0; $i < strlen($string); $i += 2) { + $charval = getid3_lib::LittleEndian2Int(substr($string, $i, 2)); + $newcharstring .= getid3_iconv_replacement::iconv_int_utf8($charval); + } + return $newcharstring; + } + + + + // UTF-16LE => UTF-16BE + public static function iconv_utf16le_utf16be($string) { + return getid3_iconv_replacement::iconv_utf8_utf16be(getid3_iconv_replacement::iconv_utf16le_utf8($string)); + } + + + + // UTF-16LE => UTF-16 + public static function iconv_utf16le_utf16($string) { + return getid3_iconv_replacement::iconv_utf8_utf16(getid3_iconv_replacement::iconv_utf16le_utf8($string)); + } + + + + // UTF-16 => ISO-8859-1 + public static function iconv_utf16_iso88591($string) { + $bom = substr($string, 0, 2); + if ($bom == "\xFE\xFF") { + return getid3_lib::iconv_utf16be_iso88591(substr($string, 2)); + } elseif ($bom == "\xFF\xFE") { + return getid3_lib::iconv_utf16le_iso88591(substr($string, 2)); + } + return $string; + } + + + + // UTF-16 => UTF-8 + public static function iconv_utf16_utf8($string) { + $bom = substr($string, 0, 2); + if ($bom == "\xFE\xFF") { + return getid3_iconv_replacement::iconv_utf16be_utf8(substr($string, 2)); + } elseif ($bom == "\xFF\xFE") { + return getid3_iconv_replacement::iconv_utf16le_utf8(substr($string, 2)); + } + return $string; + } + + + + // UTF-16 => UTF-16BE + public static function iconv_utf16_utf16be($string) { + return getid3_iconv_replacement::iconv_utf8_utf16be(getid3_iconv_replacement::iconv_utf16_utf8($string)); + } + + + + // UTF-16 => UTF-16LE + public static function iconv_utf16_utf16le($string) { + return getid3_iconv_replacement::iconv_utf8_utf16le(getid3_iconv_replacement::iconv_utf16_utf8($string)); + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.lib.image_size.php b/modules/getid3/module.lib.image_size.php new file mode 100644 index 00000000..cde72234 --- /dev/null +++ b/modules/getid3/module.lib.image_size.php @@ -0,0 +1,126 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.lib.data-hash.php | +// | getID3() library file. | +// | dependencies: NONE. | +// +----------------------------------------------------------------------+ +// +// $Id: module.lib.image_size.php,v 1.2 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_lib_image_size +{ + + const GIF_SIG = "\x47\x49\x46"; // 'GIF' + const PNG_SIG = "\x89\x50\x4E\x47\x0D\x0A\x1A\x0A"; + const JPG_SIG = "\xFF\xD8\xFF"; + const JPG_SOS = "\xDA"; // Start Of Scan - image data start + const JPG_SOF0 = "\xC0"; // Start Of Frame N + const JPG_SOF1 = "\xC1"; // N indicates which compression process + const JPG_SOF2 = "\xC2"; // Only SOF0-SOF2 are now in common use + const JPG_SOF3 = "\xC3"; // NB: codes C4 and CC are *not* SOF markers + const JPG_SOF5 = "\xC5"; + const JPG_SOF6 = "\xC6"; + const JPG_SOF7 = "\xC7"; + const JPG_SOF9 = "\xC9"; + const JPG_SOF10 = "\xCA"; + const JPG_SOF11 = "\xCB"; // NB: codes C4 and CC are *not* SOF markers + const JPG_SOF13 = "\xCD"; + const JPG_SOF14 = "\xCE"; + const JPG_SOF15 = "\xCF"; + const JPG_EOI = "\xD9"; // End Of Image (end of datastream) + + + static public function get($img_data) { + + $height = $width = $type = ''; + + if ((substr($img_data, 0, 3) == getid3_lib_image_size::GIF_SIG) && (strlen($img_data) > 10)) { + + $dim = unpack('v2dim', substr($img_data, 6, 4)); + $width = $dim['dim1']; + $height = $dim['dim2']; + $type = 1; + + } elseif ((substr($img_data, 0, 8) == getid3_lib_image_size::PNG_SIG) && (strlen($img_data) > 24)) { + + $dim = unpack('N2dim', substr($img_data, 16, 8)); + $width = $dim['dim1']; + $height = $dim['dim2']; + $type = 3; + + } elseif ((substr($img_data, 0, 3) == getid3_lib_image_size::JPG_SIG) && (strlen($img_data) > 4)) { + + ///////////////// JPG CHUNK SCAN //////////////////// + $img_pos = $type = 2; + $buffer = strlen($img_data) - 2; + while ($img_pos < strlen($img_data)) { + + // synchronize to the marker 0xFF + $img_pos = strpos($img_data, 0xFF, $img_pos) + 1; + $marker = $img_data[$img_pos]; + do { + $marker = ord($img_data[$img_pos++]); + } while ($marker == 255); + + // find dimensions of block + switch (chr($marker)) { + + // Grab width/height from SOF segment (these are acceptable chunk types) + case getid3_lib_image_size::JPG_SOF0: + case getid3_lib_image_size::JPG_SOF1: + case getid3_lib_image_size::JPG_SOF2: + case getid3_lib_image_size::JPG_SOF3: + case getid3_lib_image_size::JPG_SOF5: + case getid3_lib_image_size::JPG_SOF6: + case getid3_lib_image_size::JPG_SOF7: + case getid3_lib_image_size::JPG_SOF9: + case getid3_lib_image_size::JPG_SOF10: + case getid3_lib_image_size::JPG_SOF11: + case getid3_lib_image_size::JPG_SOF13: + case getid3_lib_image_size::JPG_SOF14: + case getid3_lib_image_size::JPG_SOF15: + $dim = unpack('n2dim', substr($img_data, $img_pos + 3, 4)); + $height = $dim['dim1']; + $width = $dim['dim2']; + break 2; // found it so exit + + case getid3_lib_image_size::JPG_EOI: + case getid3_lib_image_size::JPG_SOS: + return false; + + default: // We're not interested in other markers + $skiplen = (ord($img_data[$img_pos++]) << 8) + ord($img_data[$img_pos++]) - 2; + // if the skip is more than what we've read in, read more + $buffer -= $skiplen; + if ($buffer < 512) { // if the buffer of data is too low, read more file. + return false; + } + $img_pos += $skiplen; + break; + } + } + } + + return array ($width, $height, $type); + } // end function + + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.misc.iso.php b/modules/getid3/module.misc.iso.php new file mode 100644 index 00000000..100cf0a8 --- /dev/null +++ b/modules/getid3/module.misc.iso.php @@ -0,0 +1,450 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.misc.iso.php | +// | Module for analyzing ISO files | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.misc.iso.php,v 1.3 2006/11/02 10:48:02 ah Exp $ + + + +class getid3_iso extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + $getid3->info['fileformat'] = 'iso'; + + for ($i = 16; $i <= 19; $i++) { + fseek($getid3->fp, 2048 * $i, SEEK_SET); + $iso_header = fread($getid3->fp, 2048); + if (substr($iso_header, 1, 5) == 'CD001') { + switch (ord($iso_header{0})) { + case 1: + $getid3->info['iso']['primary_volume_descriptor']['offset'] = 2048 * $i; + $this->ParsePrimaryVolumeDescriptor($iso_header); + break; + + case 2: + $getid3->info['iso']['supplementary_volume_descriptor']['offset'] = 2048 * $i; + $this->ParseSupplementaryVolumeDescriptor($iso_header); + break; + + default: + // skip + break; + } + } + } + + $this->ParsePathTable(); + + $getid3->info['iso']['files'] = array (); + foreach ($getid3->info['iso']['path_table']['directories'] as $directory_num => $directory_data) { + $getid3->info['iso']['directories'][$directory_num] = $this->ParseDirectoryRecord($directory_data); + } + + return true; + } + + + + private function ParsePrimaryVolumeDescriptor(&$iso_header) { + + $getid3 = $this->getid3; + + // ISO integer values are stored *BOTH* Little-Endian AND Big-Endian format!! + // ie 12345 == 0x3039 is stored as $39 $30 $30 $39 in a 4-byte field + + $getid3->info['iso']['primary_volume_descriptor']['raw'] = array (); + $info_iso_primaryVD = &$getid3->info['iso']['primary_volume_descriptor']; + $info_iso_primaryVD_raw = &$info_iso_primaryVD['raw']; + + $info_iso_primaryVD_raw['volume_descriptor_type'] = getid3_lib::LittleEndian2Int(substr($iso_header, 0, 1)); + $info_iso_primaryVD_raw['standard_identifier'] = substr($iso_header, 1, 5); + if ($info_iso_primaryVD_raw['standard_identifier'] != 'CD001') { + throw new getid3_exception('Expected "CD001" at offset ('.($info_iso_primaryVD['offset'] + 1).'), found "'.$info_iso_primaryVD_raw['standard_identifier'].'" instead'); + } + + getid3_lib::ReadSequence('LittleEndian2Int', $info_iso_primaryVD_raw, $iso_header, 6, + array ( + 'volume_descriptor_version' => 1, + 'IGNORE-unused_1' => 1, + 'system_identifier' => -32, // string + 'volume_identifier' => -32, // string + 'IGNORE-unused_2' => 8, + 'volume_space_size' => 4, + 'IGNORE-1' => 4, + 'IGNORE-unused_3' => 32, + 'volume_set_size' => 2, + 'IGNORE-2' => 2, + 'volume_sequence_number' => 2, + 'IGNORE-3' => 2, + 'logical_block_size' => 2, + 'IGNORE-4' => 2, + 'path_table_size' => 4, + 'IGNORE-5' => 4, + 'path_table_l_location' => 2, + 'IGNORE-6' => 2, + 'path_table_l_opt_location' => 2, + 'IGNORE-7' => 2, + 'path_table_m_location' => 2, + 'IGNORE-8' => 2, + 'path_table_m_opt_location' => 2, + 'IGNORE-9' => 2, + 'root_directory_record' => -34, // string + 'volume_set_identifier' => -128, // string + 'publisher_identifier' => -128, // string + 'data_preparer_identifier' => -128, // string + 'application_identifier' => -128, // string + 'copyright_file_identifier' => -37, // string + 'abstract_file_identifier' => -37, // string + 'bibliographic_file_identifier' => -37, // string + 'volume_creation_date_time' => -17, // string + 'volume_modification_date_time' => -17, // string + 'volume_expiration_date_time' => -17, // string + 'volume_effective_date_time' => -17, // string + 'file_structure_version' => 1, + 'IGNORE-unused_4' => 1, + 'application_data' => -512 // string + ) + ); + + $info_iso_primaryVD['system_identifier'] = trim($info_iso_primaryVD_raw['system_identifier']); + $info_iso_primaryVD['volume_identifier'] = trim($info_iso_primaryVD_raw['volume_identifier']); + $info_iso_primaryVD['volume_set_identifier'] = trim($info_iso_primaryVD_raw['volume_set_identifier']); + $info_iso_primaryVD['publisher_identifier'] = trim($info_iso_primaryVD_raw['publisher_identifier']); + $info_iso_primaryVD['data_preparer_identifier'] = trim($info_iso_primaryVD_raw['data_preparer_identifier']); + $info_iso_primaryVD['application_identifier'] = trim($info_iso_primaryVD_raw['application_identifier']); + $info_iso_primaryVD['copyright_file_identifier'] = trim($info_iso_primaryVD_raw['copyright_file_identifier']); + $info_iso_primaryVD['abstract_file_identifier'] = trim($info_iso_primaryVD_raw['abstract_file_identifier']); + $info_iso_primaryVD['bibliographic_file_identifier'] = trim($info_iso_primaryVD_raw['bibliographic_file_identifier']); + + $info_iso_primaryVD['volume_creation_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_primaryVD_raw['volume_creation_date_time']); + $info_iso_primaryVD['volume_modification_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_primaryVD_raw['volume_modification_date_time']); + $info_iso_primaryVD['volume_expiration_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_primaryVD_raw['volume_expiration_date_time']); + $info_iso_primaryVD['volume_effective_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_primaryVD_raw['volume_effective_date_time']); + + if (($info_iso_primaryVD_raw['volume_space_size'] * 2048) > $getid3->info['filesize']) { + throw new getid3_exception('Volume Space Size ('.($info_iso_primaryVD_raw['volume_space_size'] * 2048).' bytes) is larger than the file size ('.$getid3->info['filesize'].' bytes) (truncated file?)'); + } + + return true; + } + + + + private function ParseSupplementaryVolumeDescriptor(&$iso_header) { + + $getid3 = $this->getid3; + + // ISO integer values are stored Both-Endian format!! + // ie 12345 == 0x3039 is stored as $39 $30 $30 $39 in a 4-byte field + + $getid3->info['iso']['supplementary_volume_descriptor']['raw'] = array (); + $info_iso_supplementaryVD = &$getid3->info['iso']['supplementary_volume_descriptor']; + $info_iso_supplementaryVD_raw = &$info_iso_supplementaryVD['raw']; + + $info_iso_supplementaryVD_raw['volume_descriptor_type'] = getid3_lib::LittleEndian2Int(substr($iso_header, 0, 1)); + $info_iso_supplementaryVD_raw['standard_identifier'] = substr($iso_header, 1, 5); + if ($info_iso_supplementaryVD_raw['standard_identifier'] != 'CD001') { + throw new getid3_exception('Expected "CD001" at offset ('.($info_iso_supplementaryVD['offset'] + 1).'), found "'.$info_iso_supplementaryVD_raw['standard_identifier'].'" instead'); + } + + getid3_lib::ReadSequence('LittleEndian2Int', $info_iso_supplementaryVD_raw, $iso_header, 6, + array ( + 'volume_descriptor_version' => 1, + 'IGNORE-unused_1' => -1, + 'system_identifier' => -32, + 'volume_identifier' => -32, + 'IGNORE-unused_2' => -8, + 'volume_space_size' => 4, + 'IGNORE-1' => 4, + 'IGNORE-unused_3' => -32, + 'volume_set_size' => 2, + 'IGNORE-2' => 2, + 'volume_sequence_number' => 2, + 'IGNORE-3' => 2, + 'logical_block_size' => 2, + 'IGNORE-4' => 2, + 'path_table_size' => 4, + 'IGNORE-5' => 4, + 'path_table_l_location' => 2, + 'IGNORE-6' => 2, + 'path_table_l_opt_location' => 2, + 'IGNORE-7' => 2, + 'path_table_m_location' => 2, + 'IGNORE-8' => 2, + 'path_table_m_opt_location' => 2, + 'IGNORE-9' => 2, + 'root_directory_record' => -34, + 'volume_set_identifier' => -128, + 'publisher_identifier' => -128, + 'data_preparer_identifier' => -128, + 'application_identifier' => -128, + 'copyright_file_identifier' => -37, + 'abstract_file_identifier' => -37, + 'bibliographic_file_identifier' => -37, + 'volume_creation_date_time' => -17, + 'volume_modification_date_time' => -17, + 'volume_expiration_date_time' => -17, + 'volume_effective_date_time' => -17, + 'file_structure_version' => 1, + 'IGNORE-unused_4' => 1, + 'application_data' => -512 + ) + ); + + $info_iso_supplementaryVD['system_identifier'] = trim($info_iso_supplementaryVD_raw['system_identifier']); + $info_iso_supplementaryVD['volume_identifier'] = trim($info_iso_supplementaryVD_raw['volume_identifier']); + $info_iso_supplementaryVD['volume_set_identifier'] = trim($info_iso_supplementaryVD_raw['volume_set_identifier']); + $info_iso_supplementaryVD['publisher_identifier'] = trim($info_iso_supplementaryVD_raw['publisher_identifier']); + $info_iso_supplementaryVD['data_preparer_identifier'] = trim($info_iso_supplementaryVD_raw['data_preparer_identifier']); + $info_iso_supplementaryVD['application_identifier'] = trim($info_iso_supplementaryVD_raw['application_identifier']); + $info_iso_supplementaryVD['copyright_file_identifier'] = trim($info_iso_supplementaryVD_raw['copyright_file_identifier']); + $info_iso_supplementaryVD['abstract_file_identifier'] = trim($info_iso_supplementaryVD_raw['abstract_file_identifier']); + $info_iso_supplementaryVD['bibliographic_file_identifier'] = trim($info_iso_supplementaryVD_raw['bibliographic_file_identifier']); + + $info_iso_supplementaryVD['volume_creation_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_supplementaryVD_raw['volume_creation_date_time']); + $info_iso_supplementaryVD['volume_modification_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_supplementaryVD_raw['volume_modification_date_time']); + $info_iso_supplementaryVD['volume_expiration_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_supplementaryVD_raw['volume_expiration_date_time']); + $info_iso_supplementaryVD['volume_effective_date_time'] = getid3_iso::ISOtimeText2UNIXtime($info_iso_supplementaryVD_raw['volume_effective_date_time']); + + if (($info_iso_supplementaryVD_raw['volume_space_size'] * $info_iso_supplementaryVD_raw['logical_block_size']) > $getid3->info['filesize']) { + throw new getid3_exception('Volume Space Size ('.($info_iso_supplementaryVD_raw['volume_space_size'] * $info_iso_supplementaryVD_raw['logical_block_size']).' bytes) is larger than the file size ('.$getid3->info['filesize'].' bytes) (truncated file?)'); + } + + return true; + } + + + + private function ParsePathTable() { + + $getid3 = $this->getid3; + + if (!isset($getid3->info['iso']['supplementary_volume_descriptor']['raw']['path_table_l_location']) && !isset($getid3->info['iso']['primary_volume_descriptor']['raw']['path_table_l_location'])) { + return false; + } + if (isset($getid3->info['iso']['supplementary_volume_descriptor']['raw']['path_table_l_location'])) { + $path_table_location = $getid3->info['iso']['supplementary_volume_descriptor']['raw']['path_table_l_location']; + $path_table_size = $getid3->info['iso']['supplementary_volume_descriptor']['raw']['path_table_size']; + $text_encoding = 'UTF-16BE'; // Big-Endian Unicode + } + else { + $path_table_location = $getid3->info['iso']['primary_volume_descriptor']['raw']['path_table_l_location']; + $path_table_size = $getid3->info['iso']['primary_volume_descriptor']['raw']['path_table_size']; + $text_encoding = 'ISO-8859-1'; // Latin-1 + } + + if (($path_table_location * 2048) > $getid3->info['filesize']) { + throw new getid3_exception('Path Table Location specifies an offset ('.($path_table_location * 2048).') beyond the end-of-file ('.$getid3->info['filesize'].')'); + } + + $getid3->info['iso']['path_table']['offset'] = $path_table_location * 2048; + fseek($getid3->fp, $getid3->info['iso']['path_table']['offset'], SEEK_SET); + $getid3->info['iso']['path_table']['raw'] = fread($getid3->fp, $path_table_size); + + $offset = 0; + $pathcounter = 1; + while ($offset < $path_table_size) { + + $getid3->info['iso']['path_table']['directories'][$pathcounter] = array (); + $info_iso_pathtable_directories_current = &$getid3->info['iso']['path_table']['directories'][$pathcounter]; + + getid3_lib::ReadSequence('LittleEndian2Int', $info_iso_pathtable_directories_current, $getid3->info['iso']['path_table']['raw'], $offset, + array ( + 'length' => 1, + 'extended_length' => 1, + 'location_logical' => 4, + 'parent_directory' => 2, + ) + ); + + $info_iso_pathtable_directories_current['name'] = substr($getid3->info['iso']['path_table']['raw'], $offset+8, $info_iso_pathtable_directories_current['length']); + + $offset += 8 + $info_iso_pathtable_directories_current['length'] + ($info_iso_pathtable_directories_current['length'] % 2); + + $info_iso_pathtable_directories_current['name_ascii'] = $getid3->iconv($text_encoding, $getid3->encoding, $info_iso_pathtable_directories_current['name'], true); + + $info_iso_pathtable_directories_current['location_bytes'] = $info_iso_pathtable_directories_current['location_logical'] * 2048; + if ($pathcounter == 1) { + $info_iso_pathtable_directories_current['full_path'] = '/'; + } + else { + $info_iso_pathtable_directories_current['full_path'] = $getid3->info['iso']['path_table']['directories'][$info_iso_pathtable_directories_current['parent_directory']]['full_path'].$info_iso_pathtable_directories_current['name_ascii'].'/'; + } + $full_path_array[] = $info_iso_pathtable_directories_current['full_path']; + + $pathcounter++; + } + + return true; + } + + + + private function ParseDirectoryRecord($directory_data) { + + $getid3 = $this->getid3; + + $text_encoding = isset($getid3->info['iso']['supplementary_volume_descriptor']) ? 'UTF-16BE' : 'ISO-8859-1'; + + fseek($getid3->fp, $directory_data['location_bytes'], SEEK_SET); + $directory_record_data = fread($getid3->fp, 1); + + while (ord($directory_record_data{0}) > 33) { + + $directory_record_data .= fread($getid3->fp, ord($directory_record_data{0}) - 1); + + $this_directory_record = array (); + $this_directory_record['raw'] = array (); + $this_directory_record_raw = &$this_directory_record['raw']; + + getid3_lib::ReadSequence('LittleEndian2Int', $this_directory_record_raw, $directory_record_data, 0, + array ( + 'length' => 1, + 'extended_attribute_length' => 1, + 'offset_logical' => 4, + 'IGNORE-1' => 4, + 'filesize' => 4, + 'IGNORE-2' => 4, + 'recording_date_time' => -7, + 'file_flags' => 1, + 'file_unit_size' => 1, + 'interleave_gap_size' => 1, + 'volume_sequence_number' => 2, + 'IGNORE-3' => 2, + 'file_identifier_length' => 1, + ) + ); + + $this_directory_record_raw['file_identifier'] = substr($directory_record_data, 33, $this_directory_record_raw['file_identifier_length']); + + $this_directory_record['file_identifier_ascii'] = $getid3->iconv($text_encoding, $getid3->encoding, $this_directory_record_raw['file_identifier'], true); + $this_directory_record['filesize'] = $this_directory_record_raw['filesize']; + $this_directory_record['offset_bytes'] = $this_directory_record_raw['offset_logical'] * 2048; + $this_directory_record['file_flags']['hidden'] = (bool)($this_directory_record_raw['file_flags'] & 0x01); + $this_directory_record['file_flags']['directory'] = (bool)($this_directory_record_raw['file_flags'] & 0x02); + $this_directory_record['file_flags']['associated'] = (bool)($this_directory_record_raw['file_flags'] & 0x04); + $this_directory_record['file_flags']['extended'] = (bool)($this_directory_record_raw['file_flags'] & 0x08); + $this_directory_record['file_flags']['permissions'] = (bool)($this_directory_record_raw['file_flags'] & 0x10); + $this_directory_record['file_flags']['multiple'] = (bool)($this_directory_record_raw['file_flags'] & 0x80); + $this_directory_record['recording_timestamp'] = getid3_iso::ISOtime2UNIXtime($this_directory_record_raw['recording_date_time']); + + if ($this_directory_record['file_flags']['directory']) { + $this_directory_record['filename'] = $directory_data['full_path']; + } + else { + $this_directory_record['filename'] = $directory_data['full_path'].getid3_iso::ISOstripFilenameVersion($this_directory_record['file_identifier_ascii']); + $getid3->info['iso']['files'] = getid3_iso::array_merge_clobber($getid3->info['iso']['files'], getid3_iso::CreateDeepArray($this_directory_record['filename'], '/', $this_directory_record['filesize'])); + } + + $directory_record[] = $this_directory_record; + $directory_record_data = fread($getid3->fp, 1); + } + + return $directory_record; + } + + + + public static function ISOstripFilenameVersion($iso_filename) { + + // convert 'filename.ext;1' to 'filename.ext' + if (!strstr($iso_filename, ';')) { + return $iso_filename; + } + return substr($iso_filename, 0, strpos($iso_filename, ';')); + } + + + + public static function ISOtimeText2UNIXtime($iso_time) { + + if (!(int)substr($iso_time, 0, 4)) { + return false; + } + + return gmmktime((int)substr($iso_time, 8, 2), (int)substr($iso_time, 10, 2), (int)substr($iso_time, 12, 2), (int)substr($iso_time, 4, 2), (int)substr($iso_time, 6, 2), (int)substr($iso_time, 0, 4)); + } + + + + public static function ISOtime2UNIXtime($iso_time) { + + // Represented by seven bytes: + // 1: Number of years since 1900 + // 2: Month of the year from 1 to 12 + // 3: Day of the Month from 1 to 31 + // 4: Hour of the day from 0 to 23 + // 5: Minute of the hour from 0 to 59 + // 6: second of the minute from 0 to 59 + // 7: Offset from Greenwich Mean Time in number of 15 minute intervals from -48 (West) to +52 (East) + + return gmmktime(ord($iso_time[3]), ord($iso_time[4]), ord($iso_time[5]), ord($iso_time[1]), ord($iso_time[2]), ord($iso_time[0]) + 1900); + } + + + + public static function array_merge_clobber($array1, $array2) { + + // written by kcØhireability*com + // taken from http://www.php.net/manual/en/function.array-merge-recursive.php + + if (!is_array($array1) || !is_array($array2)) { + return false; + } + + $newarray = $array1; + foreach ($array2 as $key => $val) { + if (is_array($val) && isset($newarray[$key]) && is_array($newarray[$key])) { + $newarray[$key] = getid3_iso::array_merge_clobber($newarray[$key], $val); + } else { + $newarray[$key] = $val; + } + } + return $newarray; + } + + + + public static function CreateDeepArray($array_path, $separator, $value) { + + // assigns $value to a nested array path: + // $foo = getid3_lib::CreateDeepArray('/path/to/my', '/', 'file.txt') + // is the same as: + // $foo = array ('path'=>array('to'=>'array('my'=>array('file.txt')))); + // or + // $foo['path']['to']['my'] = 'file.txt'; + + while ($array_path{0} == $separator) { + $array_path = substr($array_path, 1); + } + if (($pos = strpos($array_path, $separator)) !== false) { + return array (substr($array_path, 0, $pos) => getid3_iso::CreateDeepArray(substr($array_path, $pos + 1), $separator, $value)); + } + + return array ($array_path => $value); + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.tag.apetag.php b/modules/getid3/module.tag.apetag.php new file mode 100644 index 00000000..df49c8d6 --- /dev/null +++ b/modules/getid3/module.tag.apetag.php @@ -0,0 +1,312 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.tag.apetag.php | +// | module for analyzing APE tags | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.tag.apetag.php,v 1.5 2006/11/16 14:05:21 ah Exp $ + + + +class getid3_apetag extends getid3_handler +{ + /* + ID3v1_TAG_SIZE = 128; + APETAG_HEADER_SIZE = 32; + LYRICS3_TAG_SIZE = 10; + */ + + public $option_override_end_offset = 0; + + + + public function Analyze() { + + $getid3 = $this->getid3; + + if ($this->option_override_end_offset == 0) { + + fseek($getid3->fp, 0 - 170, SEEK_END); // 170 = ID3v1_TAG_SIZE + APETAG_HEADER_SIZE + LYRICS3_TAG_SIZE + $apetag_footer_id3v1 = fread($getid3->fp, 170); // 170 = ID3v1_TAG_SIZE + APETAG_HEADER_SIZE + LYRICS3_TAG_SIZE + + // APE tag found before ID3v1 + if (substr($apetag_footer_id3v1, strlen($apetag_footer_id3v1) - 160, 8) == 'APETAGEX') { // 160 = ID3v1_TAG_SIZE + APETAG_HEADER_SIZE + $getid3->info['ape']['tag_offset_end'] = filesize($getid3->filename) - 128; // 128 = ID3v1_TAG_SIZE + } + + // APE tag found, no ID3v1 + elseif (substr($apetag_footer_id3v1, strlen($apetag_footer_id3v1) - 32, 8) == 'APETAGEX') { // 32 = APETAG_HEADER_SIZE + $getid3->info['ape']['tag_offset_end'] = filesize($getid3->filename); + } + + } + else { + + fseek($getid3->fp, $this->option_override_end_offset - 32, SEEK_SET); // 32 = APETAG_HEADER_SIZE + if (fread($getid3->fp, 8) == 'APETAGEX') { + $getid3->info['ape']['tag_offset_end'] = $this->option_override_end_offset; + } + + } + + // APE tag not found + if (!@$getid3->info['ape']['tag_offset_end']) { + return false; + } + + // Shortcut + $info_ape = &$getid3->info['ape']; + + // Read and parse footer + fseek($getid3->fp, $info_ape['tag_offset_end'] - 32, SEEK_SET); // 32 = APETAG_HEADER_SIZE + $apetag_footer_data = fread($getid3->fp, 32); + if (!($this->ParseAPEHeaderFooter($apetag_footer_data, $info_ape['footer']))) { + throw new getid3_exception('Error parsing APE footer at offset '.$info_ape['tag_offset_end']); + } + + if (isset($info_ape['footer']['flags']['header']) && $info_ape['footer']['flags']['header']) { + fseek($getid3->fp, $info_ape['tag_offset_end'] - $info_ape['footer']['raw']['tagsize'] - 32, SEEK_SET); + $info_ape['tag_offset_start'] = ftell($getid3->fp); + $apetag_data = fread($getid3->fp, $info_ape['footer']['raw']['tagsize'] + 32); + } + else { + $info_ape['tag_offset_start'] = $info_ape['tag_offset_end'] - $info_ape['footer']['raw']['tagsize']; + fseek($getid3->fp, $info_ape['tag_offset_start'], SEEK_SET); + $apetag_data = fread($getid3->fp, $info_ape['footer']['raw']['tagsize']); + } + $getid3->info['avdataend'] = $info_ape['tag_offset_start']; + + if (isset($getid3->info['id3v1']['tag_offset_start']) && ($getid3->info['id3v1']['tag_offset_start'] < $info_ape['tag_offset_end'])) { + $getid3->warning('ID3v1 tag information ignored since it appears to be a false synch in APEtag data'); + unset($getid3->info['id3v1']); + } + + $offset = 0; + if (isset($info_ape['footer']['flags']['header']) && $info_ape['footer']['flags']['header']) { + if (!$this->ParseAPEHeaderFooter(substr($apetag_data, 0, 32), $info_ape['header'])) { + throw new getid3_exception('Error parsing APE header at offset '.$info_ape['tag_offset_start']); + } + $offset = 32; + } + + // Shortcut + $getid3->info['replay_gain'] = array (); + $info_replaygain = &$getid3->info['replay_gain']; + + for ($i = 0; $i < $info_ape['footer']['raw']['tag_items']; $i++) { + $value_size = getid3_lib::LittleEndian2Int(substr($apetag_data, $offset, 4)); + $item_flags = getid3_lib::LittleEndian2Int(substr($apetag_data, $offset + 4, 4)); + $offset += 8; + + if (strstr(substr($apetag_data, $offset), "\x00") === false) { + throw new getid3_exception('Cannot find null-byte (0x00) seperator between ItemKey #'.$i.' and value. ItemKey starts ' . $offset . ' bytes into the APE tag, at file offset '.($info_ape['tag_offset_start'] + $offset)); + } + + $item_key_length = strpos($apetag_data, "\x00", $offset) - $offset; + $item_key = strtolower(substr($apetag_data, $offset, $item_key_length)); + + // Shortcut + $info_ape['items'][$item_key] = array (); + $info_ape_items_current = &$info_ape['items'][$item_key]; + + $offset += $item_key_length + 1; // skip 0x00 terminator + $info_ape_items_current['data'] = substr($apetag_data, $offset, $value_size); + $offset += $value_size; + + + $info_ape_items_current['flags'] = $this->ParseAPEtagFlags($item_flags); + + switch ($info_ape_items_current['flags']['item_contents_raw']) { + case 0: // UTF-8 + case 3: // Locator (URL, filename, etc), UTF-8 encoded + $info_ape_items_current['data'] = explode("\x00", trim($info_ape_items_current['data'])); + break; + + default: // binary data + break; + } + + switch (strtolower($item_key)) { + case 'replaygain_track_gain': + $info_replaygain['track']['adjustment'] = (float)str_replace(',', '.', $info_ape_items_current['data'][0]); // float casting will see "0,95" as zero! + $info_replaygain['track']['originator'] = 'unspecified'; + break; + + case 'replaygain_track_peak': + $info_replaygain['track']['peak'] = (float)str_replace(',', '.', $info_ape_items_current['data'][0]); // float casting will see "0,95" as zero! + $info_replaygain['track']['originator'] = 'unspecified'; + if ($info_replaygain['track']['peak'] <= 0) { + $getid3->warning('ReplayGain Track peak from APEtag appears invalid: '.$info_replaygain['track']['peak'].' (original value = "'.$info_ape_items_current['data'][0].'")'); + } + break; + + case 'replaygain_album_gain': + $info_replaygain['album']['adjustment'] = (float)str_replace(',', '.', $info_ape_items_current['data'][0]); // float casting will see "0,95" as zero! + $info_replaygain['album']['originator'] = 'unspecified'; + break; + + case 'replaygain_album_peak': + $info_replaygain['album']['peak'] = (float)str_replace(',', '.', $info_ape_items_current['data'][0]); // float casting will see "0,95" as zero! + $info_replaygain['album']['originator'] = 'unspecified'; + if ($info_replaygain['album']['peak'] <= 0) { + $getid3->warning('ReplayGain Album peak from APEtag appears invalid: '.$info_replaygain['album']['peak'].' (original value = "'.$info_ape_items_current['data'][0].'")'); + } + break; + + case 'mp3gain_undo': + list($mp3gain_undo_left, $mp3gain_undo_right, $mp3gain_undo_wrap) = explode(',', $info_ape_items_current['data'][0]); + $info_replaygain['mp3gain']['undo_left'] = intval($mp3gain_undo_left); + $info_replaygain['mp3gain']['undo_right'] = intval($mp3gain_undo_right); + $info_replaygain['mp3gain']['undo_wrap'] = (($mp3gain_undo_wrap == 'Y') ? true : false); + break; + + case 'mp3gain_minmax': + list($mp3gain_globalgain_min, $mp3gain_globalgain_max) = explode(',', $info_ape_items_current['data'][0]); + $info_replaygain['mp3gain']['globalgain_track_min'] = intval($mp3gain_globalgain_min); + $info_replaygain['mp3gain']['globalgain_track_max'] = intval($mp3gain_globalgain_max); + break; + + case 'mp3gain_album_minmax': + list($mp3gain_globalgain_album_min, $mp3gain_globalgain_album_max) = explode(',', $info_ape_items_current['data'][0]); + $info_replaygain['mp3gain']['globalgain_album_min'] = intval($mp3gain_globalgain_album_min); + $info_replaygain['mp3gain']['globalgain_album_max'] = intval($mp3gain_globalgain_album_max); + break; + + case 'tracknumber': + foreach ($info_ape_items_current['data'] as $comment) { + $info_ape['comments']['track'][] = $comment; + } + break; + + default: + foreach ($info_ape_items_current['data'] as $comment) { + $info_ape['comments'][strtolower($item_key)][] = $comment; + } + break; + } + + } + if (empty($info_replaygain)) { + unset($getid3->info['replay_gain']); + } + + return true; + } + + + + protected function ParseAPEheaderFooter($data, &$target) { + + // http://www.uni-jena.de/~pfk/mpp/sv8/apeheader.html + + if (substr($data, 0, 8) != 'APETAGEX') { + return false; + } + + // shortcut + $target['raw'] = array (); + $target_raw = &$target['raw']; + + $target_raw['footer_tag'] = 'APETAGEX'; + + getid3_lib::ReadSequence("LittleEndian2Int", $target_raw, $data, 8, + array ( + 'version' => 4, + 'tagsize' => 4, + 'tag_items' => 4, + 'global_flags' => 4 + ) + ); + $target_raw['reserved'] = substr($data, 24, 8); + + $target['tag_version'] = $target_raw['version'] / 1000; + if ($target['tag_version'] >= 2) { + + $target['flags'] = $this->ParseAPEtagFlags($target_raw['global_flags']); + } + + return true; + } + + + + protected function ParseAPEtagFlags($raw_flag_int) { + + // "Note: APE Tags 1.0 do not use any of the APE Tag flags. + // All are set to zero on creation and ignored on reading." + // http://www.uni-jena.de/~pfk/mpp/sv8/apetagflags.html + + $target['header'] = (bool) ($raw_flag_int & 0x80000000); + $target['footer'] = (bool) ($raw_flag_int & 0x40000000); + $target['this_is_header'] = (bool) ($raw_flag_int & 0x20000000); + $target['item_contents_raw'] = ($raw_flag_int & 0x00000006) >> 1; + $target['read_only'] = (bool) ($raw_flag_int & 0x00000001); + + $target['item_contents'] = getid3_apetag::APEcontentTypeFlagLookup($target['item_contents_raw']); + + return $target; + } + + + + public static function APEcontentTypeFlagLookup($content_type_id) { + + static $lookup = array ( + 0 => 'utf-8', + 1 => 'binary', + 2 => 'external', + 3 => 'reserved' + ); + return (isset($lookup[$content_type_id]) ? $lookup[$content_type_id] : 'invalid'); + } + + + + public static function APEtagItemIsUTF8Lookup($item_key) { + + static $lookup = array ( + 'title', + 'subtitle', + 'artist', + 'album', + 'debut album', + 'publisher', + 'conductor', + 'track', + 'composer', + 'comment', + 'copyright', + 'publicationright', + 'file', + 'year', + 'record date', + 'record location', + 'genre', + 'media', + 'related', + 'isrc', + 'abstract', + 'language', + 'bibliography' + ); + return in_array(strtolower($item_key), $lookup); + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.tag.id3v1.php b/modules/getid3/module.tag.id3v1.php new file mode 100644 index 00000000..1f1ae91c --- /dev/null +++ b/modules/getid3/module.tag.id3v1.php @@ -0,0 +1,324 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.tag.id3v1.php | +// | module for analyzing ID3v1 tags | +// | dependencies: NONE | +// +----------------------------------------------------------------------+ +// +// $Id: module.tag.id3v1.php,v 1.6 2006/11/16 16:19:52 ah Exp $ + + + +class getid3_id3v1 extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + fseek($getid3->fp, -256, SEEK_END); + $pre_id3v1 = fread($getid3->fp, 128); + $id3v1_tag = fread($getid3->fp, 128); + + if (substr($id3v1_tag, 0, 3) == 'TAG') { + + $getid3->info['avdataend'] -= 128; + + // Shortcut + $getid3->info['id3v1'] = array (); + $info_id3v1 = &$getid3->info['id3v1']; + + $info_id3v1['title'] = getid3_id3v1::cutfield(substr($id3v1_tag, 3, 30)); + $info_id3v1['artist'] = getid3_id3v1::cutfield(substr($id3v1_tag, 33, 30)); + $info_id3v1['album'] = getid3_id3v1::cutfield(substr($id3v1_tag, 63, 30)); + $info_id3v1['year'] = getid3_id3v1::cutfield(substr($id3v1_tag, 93, 4)); + $info_id3v1['comment'] = substr($id3v1_tag, 97, 30); // can't remove nulls yet, track detection depends on them + $info_id3v1['genreid'] = ord(substr($id3v1_tag, 127, 1)); + + // If second-last byte of comment field is null and last byte of comment field is non-null then this is ID3v1.1 and the comment field is 28 bytes long and the 30th byte is the track number + if (($id3v1_tag{125} === "\x00") && ($id3v1_tag{126} !== "\x00")) { + $info_id3v1['track'] = ord(substr($info_id3v1['comment'], 29, 1)); + $info_id3v1['comment'] = substr($info_id3v1['comment'], 0, 28); + } + $info_id3v1['comment'] = getid3_id3v1::cutfield($info_id3v1['comment']); + + $info_id3v1['genre'] = getid3_id3v1::LookupGenreName($info_id3v1['genreid']); + if (!empty($info_id3v1['genre'])) { + unset($info_id3v1['genreid']); + } + if (empty($info_id3v1['genre']) || (@$info_id3v1['genre'] == 'Unknown')) { + unset($info_id3v1['genre']); + } + + foreach ($info_id3v1 as $key => $value) { + $key != 'comments' and $info_id3v1['comments'][$key][0] = $value; + } + + $info_id3v1['tag_offset_end'] = filesize($getid3->filename); + $info_id3v1['tag_offset_start'] = $info_id3v1['tag_offset_end'] - 128; + } + + if (substr($pre_id3v1, 0, 3) == 'TAG') { + // The way iTunes handles tags is, well, brain-damaged. + // It completely ignores v1 if ID3v2 is present. + // This goes as far as adding a new v1 tag *even if there already is one* + + // A suspected double-ID3v1 tag has been detected, but it could be that the "TAG" identifier is a legitimate part of an APE or Lyrics3 tag + if (substr($pre_id3v1, 96, 8) == 'APETAGEX') { + // an APE tag footer was found before the last ID3v1, assume false "TAG" synch + } elseif (substr($pre_id3v1, 119, 6) == 'LYRICS') { + // a Lyrics3 tag footer was found before the last ID3v1, assume false "TAG" synch + } else { + // APE and Lyrics3 footers not found - assume double ID3v1 + $getid3->warning('Duplicate ID3v1 tag detected - this has been known to happen with iTunes.'); + $getid3->info['avdataend'] -= 128; + } + } + + return true; + } + + + + public static function cutfield($str) { + + return trim(substr($str, 0, strcspn($str, "\x00"))); + } + + + + public static function ArrayOfGenres($allow_SCMPX_extended=false) { + + static $lookup = array ( + 0 => 'Blues', + 1 => 'Classic Rock', + 2 => 'Country', + 3 => 'Dance', + 4 => 'Disco', + 5 => 'Funk', + 6 => 'Grunge', + 7 => 'Hip-Hop', + 8 => 'Jazz', + 9 => 'Metal', + 10 => 'New Age', + 11 => 'Oldies', + 12 => 'Other', + 13 => 'Pop', + 14 => 'R&B', + 15 => 'Rap', + 16 => 'Reggae', + 17 => 'Rock', + 18 => 'Techno', + 19 => 'Industrial', + 20 => 'Alternative', + 21 => 'Ska', + 22 => 'Death Metal', + 23 => 'Pranks', + 24 => 'Soundtrack', + 25 => 'Euro-Techno', + 26 => 'Ambient', + 27 => 'Trip-Hop', + 28 => 'Vocal', + 29 => 'Jazz+Funk', + 30 => 'Fusion', + 31 => 'Trance', + 32 => 'Classical', + 33 => 'Instrumental', + 34 => 'Acid', + 35 => 'House', + 36 => 'Game', + 37 => 'Sound Clip', + 38 => 'Gospel', + 39 => 'Noise', + 40 => 'Alt. Rock', + 41 => 'Bass', + 42 => 'Soul', + 43 => 'Punk', + 44 => 'Space', + 45 => 'Meditative', + 46 => 'Instrumental Pop', + 47 => 'Instrumental Rock', + 48 => 'Ethnic', + 49 => 'Gothic', + 50 => 'Darkwave', + 51 => 'Techno-Industrial', + 52 => 'Electronic', + 53 => 'Pop-Folk', + 54 => 'Eurodance', + 55 => 'Dream', + 56 => 'Southern Rock', + 57 => 'Comedy', + 58 => 'Cult', + 59 => 'Gangsta Rap', + 60 => 'Top 40', + 61 => 'Christian Rap', + 62 => 'Pop/Funk', + 63 => 'Jungle', + 64 => 'Native American', + 65 => 'Cabaret', + 66 => 'New Wave', + 67 => 'Psychedelic', + 68 => 'Rave', + 69 => 'Showtunes', + 70 => 'Trailer', + 71 => 'Lo-Fi', + 72 => 'Tribal', + 73 => 'Acid Punk', + 74 => 'Acid Jazz', + 75 => 'Polka', + 76 => 'Retro', + 77 => 'Musical', + 78 => 'Rock & Roll', + 79 => 'Hard Rock', + 80 => 'Folk', + 81 => 'Folk/Rock', + 82 => 'National Folk', + 83 => 'Swing', + 84 => 'Fast-Fusion', + 85 => 'Bebob', + 86 => 'Latin', + 87 => 'Revival', + 88 => 'Celtic', + 89 => 'Bluegrass', + 90 => 'Avantgarde', + 91 => 'Gothic Rock', + 92 => 'Progressive Rock', + 93 => 'Psychedelic Rock', + 94 => 'Symphonic Rock', + 95 => 'Slow Rock', + 96 => 'Big Band', + 97 => 'Chorus', + 98 => 'Easy Listening', + 99 => 'Acoustic', + 100 => 'Humour', + 101 => 'Speech', + 102 => 'Chanson', + 103 => 'Opera', + 104 => 'Chamber Music', + 105 => 'Sonata', + 106 => 'Symphony', + 107 => 'Booty Bass', + 108 => 'Primus', + 109 => 'Porn Groove', + 110 => 'Satire', + 111 => 'Slow Jam', + 112 => 'Club', + 113 => 'Tango', + 114 => 'Samba', + 115 => 'Folklore', + 116 => 'Ballad', + 117 => 'Power Ballad', + 118 => 'Rhythmic Soul', + 119 => 'Freestyle', + 120 => 'Duet', + 121 => 'Punk Rock', + 122 => 'Drum Solo', + 123 => 'A Cappella', + 124 => 'Euro-House', + 125 => 'Dance Hall', + 126 => 'Goa', + 127 => 'Drum & Bass', + 128 => 'Club-House', + 129 => 'Hardcore', + 130 => 'Terror', + 131 => 'Indie', + 132 => 'BritPop', + 133 => 'Negerpunk', + 134 => 'Polsk Punk', + 135 => 'Beat', + 136 => 'Christian Gangsta Rap', + 137 => 'Heavy Metal', + 138 => 'Black Metal', + 139 => 'Crossover', + 140 => 'Contemporary Christian', + 141 => 'Christian Rock', + 142 => 'Merengue', + 143 => 'Salsa', + 144 => 'Trash Metal', + 145 => 'Anime', + 146 => 'JPop', + 147 => 'Synthpop', + + 255 => 'Unknown', + + 'CR' => 'Cover', + 'RX' => 'Remix' + ); + + static $lookupSCMPX = array (); + if ($allow_SCMPX_extended && empty($lookupSCMPX)) { + $lookupSCMPX = $lookup; + // http://www.geocities.co.jp/SiliconValley-Oakland/3664/alittle.html#GenreExtended + // Extended ID3v1 genres invented by SCMPX + // Note that 255 "Japanese Anime" conflicts with standard "Unknown" + $lookupSCMPX[240] = 'Sacred'; + $lookupSCMPX[241] = 'Northern Europe'; + $lookupSCMPX[242] = 'Irish & Scottish'; + $lookupSCMPX[243] = 'Scotland'; + $lookupSCMPX[244] = 'Ethnic Europe'; + $lookupSCMPX[245] = 'Enka'; + $lookupSCMPX[246] = 'Children\'s Song'; + $lookupSCMPX[247] = 'Japanese Sky'; + $lookupSCMPX[248] = 'Japanese Heavy Rock'; + $lookupSCMPX[249] = 'Japanese Doom Rock'; + $lookupSCMPX[250] = 'Japanese J-POP'; + $lookupSCMPX[251] = 'Japanese Seiyu'; + $lookupSCMPX[252] = 'Japanese Ambient Techno'; + $lookupSCMPX[253] = 'Japanese Moemoe'; + $lookupSCMPX[254] = 'Japanese Tokusatsu'; + //$lookupSCMPX[255] = 'Japanese Anime'; + } + + return ($allow_SCMPX_extended ? $lookupSCMPX : $lookup); + } + + + + public static function LookupGenreName($genre_id, $allow_SCMPX_extended=true) { + + switch ($genre_id) { + case 'RX': + case 'CR': + break; + default: + $genre_id = intval($genre_id); // to handle 3 or '3' or '03' + break; + } + $lookup = getid3_id3v1::ArrayOfGenres($allow_SCMPX_extended); + return (isset($lookup[$genre_id]) ? $lookup[$genre_id] : false); + } + + + public static function LookupGenreID($genre, $allow_SCMPX_extended=false) { + + $lookup = getid3_id3v1::ArrayOfGenres($allow_SCMPX_extended); + $lower_case_no_space_search_term = strtolower(str_replace(' ', '', $genre)); + foreach ($lookup as $key => $value) { + foreach ($lookup as $key => $value) { + if (strtolower(str_replace(' ', '', $value)) == $lower_case_no_space_search_term) { + return $key; + } + } + return false; + } + return (isset($lookup[$genre_id]) ? $lookup[$genre_id] : false); + } + +} + + +?> \ No newline at end of file diff --git a/modules/getid3/module.tag.id3v2.php b/modules/getid3/module.tag.id3v2.php new file mode 100644 index 00000000..ee2735c9 --- /dev/null +++ b/modules/getid3/module.tag.id3v2.php @@ -0,0 +1,3280 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.tag.id3v2.php | +// | module for analyzing ID3v2 tags | +// | dependencies: module.tag.id3v1.php | +// | module.lib.image_size.php (optional) | +// | zlib support in PHP (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.tag.id3v2.php,v 1.15 2006/12/03 23:47:29 ah Exp $ + + + + +class getid3_id3v2 extends getid3_handler +{ + + public $option_starting_offset = 0; + + + public function Analyze() { + + $getid3 = $this->getid3; + + // dependency + $getid3->include_module('tag.id3v1'); + + if ($getid3->option_tags_images) { + $getid3->include_module('lib.image_size'); + } + + + // Overall tag structure: + // +-----------------------------+ + // | Header (10 bytes) | + // +-----------------------------+ + // | Extended Header | + // | (variable length, OPTIONAL) | + // +-----------------------------+ + // | Frames (variable length) | + // +-----------------------------+ + // | Padding | + // | (variable length, OPTIONAL) | + // +-----------------------------+ + // | Footer (10 bytes, OPTIONAL) | + // +-----------------------------+ + // + // Header + // ID3v2/file identifier "ID3" + // ID3v2 version $04 00 + // ID3v2 flags (%ab000000 in v2.2, %abc00000 in v2.3, %abcd0000 in v2.4.x) + // ID3v2 size 4 * %0xxxxxxx + + + // shortcuts + $getid3->info['id3v2']['header'] = true; + $info_id3v2 = &$getid3->info['id3v2']; + $info_id3v2['flags'] = array (); + $info_id3v2_flags = &$info_id3v2['flags']; + + + $this->fseek($this->option_starting_offset, SEEK_SET); + $header = $this->fread(10); + if (substr($header, 0, 3) == 'ID3' && strlen($header) == 10) { + + $info_id3v2['majorversion'] = ord($header{3}); + $info_id3v2['minorversion'] = ord($header{4}); + + // shortcut + $id3v2_major_version = &$info_id3v2['majorversion']; + + } else { + unset($getid3->info['id3v2']); + return false; + + } + + if ($id3v2_major_version > 4) { // this script probably won't correctly parse ID3v2.5.x and above (if it ever exists) + throw new getid3_exception('this script only parses up to ID3v2.4.x - this tag is ID3v2.'.$id3v2_major_version.'.'.$info_id3v2['minorversion']); + } + + $id3_flags = ord($header{5}); + switch ($id3v2_major_version) { + case 2: + // %ab000000 in v2.2 + $info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation + $info_id3v2_flags['compression'] = (bool)($id3_flags & 0x40); // b - Compression + break; + + case 3: + // %abc00000 in v2.3 + $info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation + $info_id3v2_flags['exthead'] = (bool)($id3_flags & 0x40); // b - Extended header + $info_id3v2_flags['experim'] = (bool)($id3_flags & 0x20); // c - Experimental indicator + break; + + case 4: + // %abcd0000 in v2.4 + $info_id3v2_flags['unsynch'] = (bool)($id3_flags & 0x80); // a - Unsynchronisation + $info_id3v2_flags['exthead'] = (bool)($id3_flags & 0x40); // b - Extended header + $info_id3v2_flags['experim'] = (bool)($id3_flags & 0x20); // c - Experimental indicator + $info_id3v2_flags['isfooter'] = (bool)($id3_flags & 0x10); // d - Footer present + break; + } + + $info_id3v2['headerlength'] = getid3_lib::BigEndianSyncSafe2Int(substr($header, 6, 4)) + 10; // length of ID3v2 tag in 10-byte header doesn't include 10-byte header length + + $info_id3v2['tag_offset_start'] = $this->option_starting_offset; + $info_id3v2['tag_offset_end'] = $info_id3v2['tag_offset_start'] + $info_id3v2['headerlength']; + + + // Frames + + // All ID3v2 frames consists of one frame header followed by one or more + // fields containing the actual information. The header is always 10 + // bytes and laid out as follows: + // + // Frame ID $xx xx xx xx (four characters) + // Size 4 * %0xxxxxxx + // Flags $xx xx + + $size_of_frames = $info_id3v2['headerlength'] - 10; // not including 10-byte initial header + if (@$info_id3v2['exthead']['length']) { + $size_of_frames -= ($info_id3v2['exthead']['length'] + 4); + } + + if (@$info_id3v2_flags['isfooter']) { + $size_of_frames -= 10; // footer takes last 10 bytes of ID3v2 header, after frame data, before audio + } + + if ($size_of_frames > 0) { + $frame_data = $this->fread($size_of_frames); // read all frames from file into $frame_data variable + + // if entire frame data is unsynched, de-unsynch it now (ID3v2.3.x) + if (@$info_id3v2_flags['unsynch'] && ($id3v2_major_version <= 3)) { + $frame_data = str_replace("\xFF\x00", "\xFF", $frame_data); + } + + // [in ID3v2.4.0] Unsynchronisation [S:6.1] is done on frame level, instead + // of on tag level, making it easier to skip frames, increasing the streamability + // of the tag. The unsynchronisation flag in the header [S:3.1] indicates that + // there exists an unsynchronised frame, while the new unsynchronisation flag in + // the frame header [S:4.1.2] indicates unsynchronisation. + + //$frame_data_offset = 10 + (@$info_id3v2['exthead']['length'] ? $info_id3v2['exthead']['length'] + 4 : 0); // how many bytes into the stream - start from after the 10-byte header (and extended header length+4, if present) + $frame_data_offset = 10; // how many bytes into the stream - start from after the 10-byte header + + // Extended Header + if (@$info_id3v2_flags['exthead']) { + $extended_header_offset = 0; + + if ($id3v2_major_version == 3) { + + // v2.3 definition: + //Extended header size $xx xx xx xx // 32-bit integer + //Extended Flags $xx xx + // %x0000000 %00000000 // v2.3 + // x - CRC data present + //Size of padding $xx xx xx xx + + $info_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 0); + $extended_header_offset += 4; + + $info_id3v2['exthead']['flag_bytes'] = 2; + $info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes'])); + $extended_header_offset += $info_id3v2['exthead']['flag_bytes']; + + $info_id3v2['exthead']['flags']['crc'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x8000); + + $info_id3v2['exthead']['padding_size'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4)); + $extended_header_offset += 4; + + if ($info_id3v2['exthead']['flags']['crc']) { + $info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4)); + $extended_header_offset += 4; + } + $extended_header_offset += $info_id3v2['exthead']['padding_size']; + + } + + elseif ($id3v2_major_version == 4) { + + // v2.4 definition: + //Extended header size 4 * %0xxxxxxx // 28-bit synchsafe integer + //Number of flag bytes $01 + //Extended Flags $xx + // %0bcd0000 // v2.4 + // b - Tag is an update + // Flag data length $00 + // c - CRC data present + // Flag data length $05 + // Total frame CRC 5 * %0xxxxxxx + // d - Tag restrictions + // Flag data length $01 + + $info_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 1); + $extended_header_offset += 4; + + $info_id3v2['exthead']['flag_bytes'] = 1; + $info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes'])); + $extended_header_offset += $info_id3v2['exthead']['flag_bytes']; + + $info_id3v2['exthead']['flags']['update'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x4000); + $info_id3v2['exthead']['flags']['crc'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x2000); + $info_id3v2['exthead']['flags']['restrictions'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x1000); + + if ($info_id3v2['exthead']['flags']['crc']) { + $info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 5), 1); + $extended_header_offset += 5; + } + if ($info_id3v2['exthead']['flags']['restrictions']) { + // %ppqrrstt + $restrictions_raw = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 1)); + $extended_header_offset += 1; + $info_id3v2['exthead']['flags']['restrictions']['tagsize'] = ($restrictions_raw && 0xC0) >> 6; // p - Tag size restrictions + $info_id3v2['exthead']['flags']['restrictions']['textenc'] = ($restrictions_raw && 0x20) >> 5; // q - Text encoding restrictions + $info_id3v2['exthead']['flags']['restrictions']['textsize'] = ($restrictions_raw && 0x18) >> 3; // r - Text fields size restrictions + $info_id3v2['exthead']['flags']['restrictions']['imgenc'] = ($restrictions_raw && 0x04) >> 2; // s - Image encoding restrictions + $info_id3v2['exthead']['flags']['restrictions']['imgsize'] = ($restrictions_raw && 0x03) >> 0; // t - Image size restrictions + } + + } + $frame_data_offset += $extended_header_offset; + $frame_data = substr($frame_data, $extended_header_offset); + } // end extended header + + + + + + + while (isset($frame_data) && (strlen($frame_data) > 0)) { // cycle through until no more frame data is left to parse + if (strlen($frame_data) <= ($id3v2_major_version == 2 ? 6 : 10)) { + // insufficient room left in ID3v2 header for actual data - must be padding + $info_id3v2['padding']['start'] = $frame_data_offset; + $info_id3v2['padding']['length'] = strlen($frame_data); + $info_id3v2['padding']['valid'] = true; + for ($i = 0; $i < $info_id3v2['padding']['length']; $i++) { + if ($frame_data{$i} != "\x00") { + $info_id3v2['padding']['valid'] = false; + $info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i; + $getid3->warning('Invalid ID3v2 padding found at offset '.$info_id3v2['padding']['errorpos'].' (the remaining '.($info_id3v2['padding']['length'] - $i).' bytes are considered invalid)'); + break; + } + } + break; // skip rest of ID3v2 header + } + + if ($id3v2_major_version == 2) { + // Frame ID $xx xx xx (three characters) + // Size $xx xx xx (24-bit integer) + // Flags $xx xx + + $frame_header = substr($frame_data, 0, 6); // take next 6 bytes for header + $frame_data = substr($frame_data, 6); // and leave the rest in $frame_data + $frame_name = substr($frame_header, 0, 3); + $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 3, 3)); + $frame_flags = 0; // not used for anything in ID3v2.2, just set to avoid E_NOTICEs + + + } elseif ($id3v2_major_version > 2) { + + // Frame ID $xx xx xx xx (four characters) + // Size $xx xx xx xx (32-bit integer in v2.3, 28-bit synchsafe in v2.4+) + // Flags $xx xx + + $frame_header = substr($frame_data, 0, 10); // take next 10 bytes for header + $frame_data = substr($frame_data, 10); // and leave the rest in $frame_data + + $frame_name = substr($frame_header, 0, 4); + + if ($id3v2_major_version == 3) { + $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer + + } else { // ID3v2.4+ + $frame_size = getid3_lib::BigEndianSyncSafe2Int(substr($frame_header, 4, 4)); // 32-bit synchsafe integer (28-bit value) + } + + if ($frame_size < (strlen($frame_data) + 4)) { + $nextFrameID = substr($frame_data, $frame_size, 4); + if (getid3_id3v2::IsValidID3v2FrameName($nextFrameID, $id3v2_major_version)) { + // next frame is OK + } elseif (($frame_name == "\x00".'MP3') || ($frame_name == "\x00\x00".'MP') || ($frame_name == ' MP3') || ($frame_name == 'MP3e')) { + // MP3ext known broken frames - "ok" for the purposes of this test + } elseif (($id3v2_major_version == 4) && (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)), 4), 3))) { + $getid3->warning('ID3v2 tag written as ID3v2.4, but with non-synchsafe integers (ID3v2.3 style). Older versions of (Helium2; iTunes) are known culprits of this. Tag has been parsed as ID3v2.3'); + $id3v2_major_version = 3; + $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer + } + } + + + $frame_flags = getid3_lib::BigEndian2Int(substr($frame_header, 8, 2)); + } + + if ((($id3v2_major_version == 2) && ($frame_name == "\x00\x00\x00")) || ($frame_name == "\x00\x00\x00\x00")) { + // padding encountered + + $info_id3v2['padding']['start'] = $frame_data_offset; + $info_id3v2['padding']['length'] = strlen($frame_header) + strlen($frame_data); + $info_id3v2['padding']['valid'] = true; + + $len = strlen($frame_data); + for ($i = 0; $i < $len; $i++) { + if ($frame_data{$i} != "\x00") { + $info_id3v2['padding']['valid'] = false; + $info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i; + $getid3->warning('Invalid ID3v2 padding found at offset '.$info_id3v2['padding']['errorpos'].' (the remaining '.($info_id3v2['padding']['length'] - $i).' bytes are considered invalid)'); + break; + } + } + break; // skip rest of ID3v2 header + } + + if ($frame_name == 'COM ') { + $getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))). [Note: this particular error has been known to happen with tags edited by iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably others too)]'); + $frame_name = 'COMM'; + } + if (($frame_size <= strlen($frame_data)) && (getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version))) { + + unset($parsed_frame); + $parsed_frame['frame_name'] = $frame_name; + $parsed_frame['frame_flags_raw'] = $frame_flags; + $parsed_frame['data'] = substr($frame_data, 0, $frame_size); + $parsed_frame['datalength'] = (int)($frame_size); + $parsed_frame['dataoffset'] = $frame_data_offset; + + $this->ParseID3v2Frame($parsed_frame); + $info_id3v2[$frame_name][] = $parsed_frame; + + $frame_data = substr($frame_data, $frame_size); + + } else { // invalid frame length or FrameID + + if ($frame_size <= strlen($frame_data)) { + + if (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, $frame_size, 4), $id3v2_major_version)) { + + // next frame is valid, just skip the current frame + $frame_data = substr($frame_data, $frame_size); + $getid3->warning('Next ID3v2 frame is valid, skipping current frame.'); + + } else { + + // next frame is invalid too, abort processing + throw new getid3_exception('Next ID3v2 frame is also invalid, aborting processing.'); + + } + + } elseif ($frame_size == strlen($frame_data)) { + + // this is the last frame, just skip + $getid3->warning('This was the last ID3v2 frame.'); + + } else { + + // next frame is invalid too, abort processing + $frame_data = null; + $getid3->warning('Invalid ID3v2 frame size, aborting.'); + + } + if (!getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version)) { + + switch ($frame_name) { + + case "\x00\x00".'MP': + case "\x00".'MP3': + case ' MP3': + case 'MP3e': + case "\x00".'MP': + case ' MP': + case 'MP3': + $getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))). [Note: this particular error has been known to happen with tags edited by "MP3ext (www.mutschler.de/mp3ext/)"]'); + break; + + default: + $getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))).'); + break; + } + + } elseif ($frame_size > strlen(@$frame_data)){ + + throw new getid3_exception('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: $frame_size ('.$frame_size.') > strlen($frame_data) ('.strlen($frame_data).')).'); + + } else { + + throw new getid3_exception('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag).'); + + } + + } + $frame_data_offset += ($frame_size + ($id3v2_major_version == 2 ? 6 : 10)); + + } + + } + + + // Footer + + // The footer is a copy of the header, but with a different identifier. + // ID3v2 identifier "3DI" + // ID3v2 version $04 00 + // ID3v2 flags %abcd0000 + // ID3v2 size 4 * %0xxxxxxx + + if (isset($info_id3v2_flags['isfooter']) && $info_id3v2_flags['isfooter']) { + $footer = fread ($getid3->fp, 10); + if (substr($footer, 0, 3) == '3DI') { + $info_id3v2['footer'] = true; + $info_id3v2['majorversion_footer'] = ord($footer{3}); + $info_id3v2['minorversion_footer'] = ord($footer{4}); + } + if ($info_id3v2['majorversion_footer'] <= 4) { + $id3_flags = ord($footer{5}); + $info_id3v2_flags['unsynch_footer'] = (bool)($id3_flags & 0x80); + $info_id3v2_flags['extfoot_footer'] = (bool)($id3_flags & 0x40); + $info_id3v2_flags['experim_footer'] = (bool)($id3_flags & 0x20); + $info_id3v2_flags['isfooter_footer'] = (bool)($id3_flags & 0x10); + + $info_id3v2['footerlength'] = getid3_lib::BigEndianSyncSafe2Int(substr($footer, 6, 4)); + } + } // end footer + + if (isset($info_id3v2['comments']['genre'])) { + foreach ($info_id3v2['comments']['genre'] as $key => $value) { + unset($info_id3v2['comments']['genre'][$key]); + $info_id3v2['comments'] = getid3_id3v2::array_merge_noclobber($info_id3v2['comments'], getid3_id3v2::ParseID3v2GenreString($value)); + } + } + + if (isset($info_id3v2['comments']['track'])) { + foreach ($info_id3v2['comments']['track'] as $key => $value) { + if (strstr($value, '/')) { + list($info_id3v2['comments']['track'][$key], $info_id3v2['comments']['totaltracks'][$key]) = explode('/', $info_id3v2['comments']['track'][$key]); + } + } + } + + // Use year from recording time if year not set + if (!isset($info_id3v2['comments']['year']) && ereg('^([0-9]{4})', @$info_id3v2['comments']['recording_time'][0], $matches)) { + $info_id3v2['comments']['year'] = array ($matches[1]); + } + + // Set avdataoffset + $getid3->info['avdataoffset'] = $info_id3v2['headerlength']; + if (isset($info_id3v2['footer'])) { + $getid3->info['avdataoffset'] += 10; + } + + return true; + } + + + + private function ParseID3v2Frame(&$parsed_frame) { + + $getid3 = $this->getid3; + + $id3v2_major_version = $getid3->info['id3v2']['majorversion']; + + $frame_name_long = getid3_id3v2::FrameNameLongLookup($parsed_frame['frame_name']); + if ($frame_name_long) { + $parsed_frame['framenamelong'] = $frame_name_long; + } + + $frame_name_short = getid3_id3v2::FrameNameShortLookup($parsed_frame['frame_name']); + if ($frame_name_short) { + $parsed_frame['framenameshort'] = $frame_name_short; + } + + if ($id3v2_major_version >= 3) { // frame flags are not part of the ID3v2.2 standard + + if ($id3v2_major_version == 3) { + + // Frame Header Flags + // %abc00000 %ijk00000 + + $parsed_frame['flags']['TagAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x8000); // a - Tag alter preservation + $parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // b - File alter preservation + $parsed_frame['flags']['ReadOnly'] = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // c - Read only + $parsed_frame['flags']['compression'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0080); // i - Compression + $parsed_frame['flags']['Encryption'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // j - Encryption + $parsed_frame['flags']['GroupingIdentity'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0020); // k - Grouping identity + + + } elseif ($id3v2_major_version == 4) { + + // Frame Header Flags + // %0abc0000 %0h00kmnp + + $parsed_frame['flags']['TagAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // a - Tag alter preservation + $parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // b - File alter preservation + $parsed_frame['flags']['ReadOnly'] = (bool)($parsed_frame['frame_flags_raw'] & 0x1000); // c - Read only + $parsed_frame['flags']['GroupingIdentity'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // h - Grouping identity + $parsed_frame['flags']['compression'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0008); // k - Compression + $parsed_frame['flags']['Encryption'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0004); // m - Encryption + $parsed_frame['flags']['Unsynchronisation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0002); // n - Unsynchronisation + $parsed_frame['flags']['DataLengthIndicator'] = (bool)($parsed_frame['frame_flags_raw'] & 0x0001); // p - Data length indicator + + // Frame-level de-unsynchronisation - ID3v2.4 + if ($parsed_frame['flags']['Unsynchronisation']) { + $parsed_frame['data'] = str_replace("\xFF\x00", "\xFF", $parsed_frame['data']); + } + } + + // Frame-level de-compression + if ($parsed_frame['flags']['compression']) { + $parsed_frame['decompressed_size'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 4)); + + if (!function_exists('gzuncompress')) { + $getid3->warning('gzuncompress() support required to decompress ID3v2 frame "'.$parsed_frame['frame_name'].'"'); + } elseif ($decompressed_data = @gzuncompress(substr($parsed_frame['data'], 4))) { + $parsed_frame['data'] = $decompressed_data; + } else { + $getid3->warning('gzuncompress() failed on compressed contents of ID3v2 frame "'.$parsed_frame['frame_name'].'"'); + } + } + } + + + if (isset($parsed_frame['datalength']) && ($parsed_frame['datalength'] == 0)) { + + $warning = 'Frame "'.$parsed_frame['frame_name'].'" at offset '.$parsed_frame['dataoffset'].' has no data portion'; + switch ($parsed_frame['frame_name']) { + case 'WCOM': + $warning .= ' (this is known to happen with files tagged by RioPort)'; + break; + + default: + break; + } + $getid3->warning($warning); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'UFID')) || // 4.1 UFID Unique file identifier + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'UFI'))) { // 4.1 UFI Unique file identifier + + // There may be more than one 'UFID' frame in a tag, + // but only one with the same 'Owner identifier'. + //
+ // Owner identifier $00 + // Identifier + + $frame_terminator_pos = strpos($parsed_frame['data'], "\x00"); + $frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos); + $parsed_frame['ownerid'] = $frame_id_string; + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00")); + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'TXXX')) || // 4.2.2 TXXX User defined text information frame + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'TXX'))) { // 4.2.2 TXX User defined text information frame + + // There may be more than one 'TXXX' frame in each tag, + // but only one with the same description. + //
+ // Text encoding $xx + // Description $00 (00) + // Value + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_description) === 0) { + $frame_description = ''; + } + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['description'] = $frame_description; + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding))); + if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = trim($getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data'])); + } + unset($parsed_frame['data']); + return true; + } + + + if ($parsed_frame['frame_name']{0} == 'T') { // 4.2. T??[?] Text information frame + + // There may only be one text information frame of its kind in an tag. + //
+ // Text encoding $xx + // Information + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) { + + // remove possible terminating \x00 (put by encoding id or software bug) + $string = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']); + if ($string[strlen($string)-1] = "\x00") { + $string = substr($string, 0, strlen($string)-1); + } + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $string; + unset($string); + } + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'WXXX')) || // 4.3.2 WXXX User defined URL link frame + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'WXX'))) { // 4.3.2 WXX User defined URL link frame + + // There may be more than one 'WXXX' frame in each tag, + // but only one with the same description + //
+ // Text encoding $xx + // Description $00 (00) + // URL + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + + if (ord($frame_description) === 0) { + $frame_description = ''; + } + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding))); + + $frame_terminator_pos = strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + if ($frame_terminator_pos) { + // there are null bytes after the data - this is not according to spec + // only use data up to first null byte + $frame_urldata = (string)substr($parsed_frame['data'], 0, $frame_terminator_pos); + } else { + // no null bytes following data, just use all data + $frame_urldata = (string)$parsed_frame['data']; + } + + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['url'] = $frame_urldata; + $parsed_frame['description'] = $frame_description; + if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['url']); + } + unset($parsed_frame['data']); + return true; + } + + + if ($parsed_frame['frame_name']{0} == 'W') { // 4.3. W??? URL link frames + + // There may only be one URL link frame of its kind in a tag, + // except when stated otherwise in the frame description + //
+ // URL + + $parsed_frame['url'] = trim($parsed_frame['data']); + if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['url']; + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'IPLS')) || // 4.4 IPLS Involved people list (ID3v2.3 only) + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'IPL'))) { // 4.4 IPL Involved people list (ID3v2.2 only) + + // There may only be one 'IPL' frame in each tag + //
+ // Text encoding $xx + // People list strings + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($parsed_frame['encodingid']); + + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']); + } + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MCDI')) || // 4.4 MCDI Music CD identifier + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MCI'))) { // 4.5 MCI Music CD identifier + + // There may only be one 'MCDI' frame in each tag + //
+ // CD TOC + + if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['data']; + } + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ETCO')) || // 4.5 ETCO Event timing codes + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ETC'))) { // 4.6 ETC Event timing codes + + // There may only be one 'ETCO' frame in each tag + //
+ // Time stamp format $xx + // Where time stamp format is: + // $01 (32-bit value) MPEG frames from beginning of file + // $02 (32-bit value) milliseconds from beginning of file + // Followed by a list of key events in the following format: + // Type of event $xx + // Time stamp $xx (xx ...) + // The 'Time stamp' is set to zero if directly at the beginning of the sound + // or after the previous event. All events MUST be sorted in chronological order. + + $frame_offset = 0; + $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++}); + + while ($frame_offset < strlen($parsed_frame['data'])) { + $parsed_frame['typeid'] = $parsed_frame['data']{$frame_offset++}; + $parsed_frame['type'] = getid3_id3v2::ETCOEventLookup($parsed_frame['typeid']); + $parsed_frame['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4)); + $frame_offset += 4; + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MLLT')) || // 4.6 MLLT MPEG location lookup table + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MLL'))) { // 4.7 MLL MPEG location lookup table + + // There may only be one 'MLLT' frame in each tag + //
+ // MPEG frames between reference $xx xx + // Bytes between reference $xx xx xx + // Milliseconds between reference $xx xx xx + // Bits for bytes deviation $xx + // Bits for milliseconds dev. $xx + // Then for every reference the following data is included; + // Deviation in bytes %xxx.... + // Deviation in milliseconds %xxx.... + + $frame_offset = 0; + $parsed_frame['framesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 2)); + $parsed_frame['bytesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 2, 3)); + $parsed_frame['msbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 5, 3)); + $parsed_frame['bitsforbytesdeviation'] = getid3_lib::BigEndian2Int($parsed_frame['data'][8]); + $parsed_frame['bitsformsdeviation'] = getid3_lib::BigEndian2Int($parsed_frame['data'][9]); + $parsed_frame['data'] = substr($parsed_frame['data'], 10); + + while ($frame_offset < strlen($parsed_frame['data'])) { + $deviation_bitstream .= getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++}); + } + $reference_counter = 0; + while (strlen($deviation_bitstream) > 0) { + $parsed_frame[$reference_counter]['bytedeviation'] = bindec(substr($deviation_bitstream, 0, $parsed_frame['bitsforbytesdeviation'])); + $parsed_frame[$reference_counter]['msdeviation'] = bindec(substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'], $parsed_frame['bitsformsdeviation'])); + $deviation_bitstream = substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'] + $parsed_frame['bitsformsdeviation']); + $reference_counter++; + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYTC')) || // 4.7 SYTC Synchronised tempo codes + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'STC'))) { // 4.8 STC Synchronised tempo codes + + // There may only be one 'SYTC' frame in each tag + //
+ // Time stamp format $xx + // Tempo data + // Where time stamp format is: + // $01 (32-bit value) MPEG frames from beginning of file + // $02 (32-bit value) milliseconds from beginning of file + + $frame_offset = 0; + $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++}); + $timestamp_counter = 0; + while ($frame_offset < strlen($parsed_frame['data'])) { + $parsed_frame[$timestamp_counter]['tempo'] = ord($parsed_frame['data']{$frame_offset++}); + if ($parsed_frame[$timestamp_counter]['tempo'] == 255) { + $parsed_frame[$timestamp_counter]['tempo'] += ord($parsed_frame['data']{$frame_offset++}); + } + $parsed_frame[$timestamp_counter]['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4)); + $frame_offset += 4; + $timestamp_counter++; + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USLT')) || // 4.8 USLT Unsynchronised lyric/text transcription + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ULT'))) { // 4.9 ULT Unsynchronised lyric/text transcription + + // There may be more than one 'Unsynchronised lyrics/text transcription' frame + // in each tag, but only one with the same language and content descriptor. + //
+ // Text encoding $xx + // Language $xx xx xx + // Content descriptor $00 (00) + // Lyrics/text + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $frame_language = substr($parsed_frame['data'], $frame_offset, 3); + $frame_offset += 3; + if ($frame_offset > strlen($parsed_frame['data'])) { + $frame_offset = strlen($parsed_frame['data']) - 1; + } + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_description) === 0) { + $frame_description = ''; + } + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding))); + + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['data'] = $parsed_frame['data']; + $parsed_frame['language'] = $frame_language; + $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false); + $parsed_frame['description'] = $frame_description; + if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']); + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYLT')) || // 4.9 SYLT Synchronised lyric/text + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'SLT'))) { // 4.10 SLT Synchronised lyric/text + + // There may be more than one 'SYLT' frame in each tag, + // but only one with the same language and content descriptor. + //
+ // Text encoding $xx + // Language $xx xx xx + // Time stamp format $xx + // $01 (32-bit value) MPEG frames from beginning of file + // $02 (32-bit value) milliseconds from beginning of file + // Content type $xx + // Content descriptor $00 (00) + // Terminated text to be synced (typically a syllable) + // Sync identifier (terminator to above string) $00 (00) + // Time stamp $xx (xx ...) + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $frame_language = substr($parsed_frame['data'], $frame_offset, 3); + $frame_offset += 3; + $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['contenttypeid'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['contenttype'] = getid3_id3v2::SYTLContentTypeLookup($parsed_frame['contenttypeid']); + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['language'] = $frame_language; + $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false); + + $timestamp_index = 0; + $frame_remaining_data = substr($parsed_frame['data'], $frame_offset); + while (strlen($frame_remaining_data)) { + $frame_offset = 0; + $frame_terminator_pos = strpos($frame_remaining_data, getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)); + if ($frame_terminator_pos === false) { + $frame_remaining_data = ''; + } else { + if (ord(substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $parsed_frame['lyrics'][$timestamp_index]['data'] = substr($frame_remaining_data, $frame_offset, $frame_terminator_pos - $frame_offset); + + $frame_remaining_data = substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding))); + if (($timestamp_index == 0) && (ord($frame_remaining_data{0}) != 0)) { + // timestamp probably omitted for first data item + } else { + $parsed_frame['lyrics'][$timestamp_index]['timestamp'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 4)); + $frame_remaining_data = substr($frame_remaining_data, 4); + } + $timestamp_index++; + } + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMM')) || // 4.10 COMM Comments + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'COM'))) { // 4.11 COM Comments + + // There may be more than one comment frame in each tag, + // but only one with the same language and content descriptor. + //
+ // Text encoding $xx + // Language $xx xx xx + // Short content descrip. $00 (00) + // The actual text + + if (strlen($parsed_frame['data']) < 5) { + + $getid3->warning('Invalid data (too short) for "'.$parsed_frame['frame_name'].'" frame at offset '.$parsed_frame['dataoffset']); + return true; + } + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $frame_language = substr($parsed_frame['data'], $frame_offset, 3); + $frame_offset += 3; + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_description) === 0) { + $frame_description = ''; + } + $frame_text = (string)substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding))); + + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['language'] = $frame_language; + $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false); + $parsed_frame['description'] = $frame_description; + $parsed_frame['data'] = $frame_text; + if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']); + } + return true; + } + + + if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'RVA2')) { // 4.11 RVA2 Relative volume adjustment (2) (ID3v2.4+ only) + + // There may be more than one 'RVA2' frame in each tag, + // but only one with the same identification string + //
+ // Identification $00 + // The 'identification' string is used to identify the situation and/or + // device where this adjustment should apply. The following is then + // repeated for every channel: + // Type of channel $xx + // Volume adjustment $xx xx + // Bits representing peak $xx + // Peak volume $xx (xx ...) + + $frame_terminator_pos = strpos($parsed_frame['data'], "\x00"); + $frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos); + if (ord($frame_id_string) === 0) { + $frame_id_string = ''; + } + $frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00")); + $parsed_frame['description'] = $frame_id_string; + + while (strlen($frame_remaining_data)) { + $frame_offset = 0; + $frame_channeltypeid = ord(substr($frame_remaining_data, $frame_offset++, 1)); + $parsed_frame[$frame_channeltypeid]['channeltypeid'] = $frame_channeltypeid; + $parsed_frame[$frame_channeltypeid]['channeltype'] = getid3_id3v2::RVA2ChannelTypeLookup($frame_channeltypeid); + $parsed_frame[$frame_channeltypeid]['volumeadjust'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, 2), true); // 16-bit signed + $frame_offset += 2; + $parsed_frame[$frame_channeltypeid]['bitspeakvolume'] = ord(substr($frame_remaining_data, $frame_offset++, 1)); + $frame_bytespeakvolume = ceil($parsed_frame[$frame_channeltypeid]['bitspeakvolume'] / 8); + $parsed_frame[$frame_channeltypeid]['peakvolume'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, $frame_bytespeakvolume)); + $frame_remaining_data = substr($frame_remaining_data, $frame_offset + $frame_bytespeakvolume); + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'RVAD')) || // 4.12 RVAD Relative volume adjustment (ID3v2.3 only) + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'RVA'))) { // 4.12 RVA Relative volume adjustment (ID3v2.2 only) + + // There may only be one 'RVA' frame in each tag + //
+ // ID3v2.2 => Increment/decrement %000000ba + // ID3v2.3 => Increment/decrement %00fedcba + // Bits used for volume descr. $xx + // Relative volume change, right $xx xx (xx ...) // a + // Relative volume change, left $xx xx (xx ...) // b + // Peak volume right $xx xx (xx ...) + // Peak volume left $xx xx (xx ...) + // ID3v2.3 only, optional (not present in ID3v2.2): + // Relative volume change, right back $xx xx (xx ...) // c + // Relative volume change, left back $xx xx (xx ...) // d + // Peak volume right back $xx xx (xx ...) + // Peak volume left back $xx xx (xx ...) + // ID3v2.3 only, optional (not present in ID3v2.2): + // Relative volume change, center $xx xx (xx ...) // e + // Peak volume center $xx xx (xx ...) + // ID3v2.3 only, optional (not present in ID3v2.2): + // Relative volume change, bass $xx xx (xx ...) // f + // Peak volume bass $xx xx (xx ...) + + $frame_offset = 0; + $frame_incrdecrflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++}); + $parsed_frame['incdec']['right'] = (bool)substr($frame_incrdecrflags, 6, 1); + $parsed_frame['incdec']['left'] = (bool)substr($frame_incrdecrflags, 7, 1); + $parsed_frame['bitsvolume'] = ord($parsed_frame['data']{$frame_offset++}); + $frame_bytesvolume = ceil($parsed_frame['bitsvolume'] / 8); + $parsed_frame['volumechange']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + if ($parsed_frame['incdec']['right'] === false) { + $parsed_frame['volumechange']['right'] *= -1; + } + $frame_offset += $frame_bytesvolume; + $parsed_frame['volumechange']['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + if ($parsed_frame['incdec']['left'] === false) { + $parsed_frame['volumechange']['left'] *= -1; + } + $frame_offset += $frame_bytesvolume; + $parsed_frame['peakvolume']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + $frame_offset += $frame_bytesvolume; + $parsed_frame['peakvolume']['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + $frame_offset += $frame_bytesvolume; + if ($id3v2_major_version == 3) { + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset); + if (strlen($parsed_frame['data']) > 0) { + $parsed_frame['incdec']['rightrear'] = (bool)substr($frame_incrdecrflags, 4, 1); + $parsed_frame['incdec']['leftrear'] = (bool)substr($frame_incrdecrflags, 5, 1); + $parsed_frame['volumechange']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + if ($parsed_frame['incdec']['rightrear'] === false) { + $parsed_frame['volumechange']['rightrear'] *= -1; + } + $frame_offset += $frame_bytesvolume; + $parsed_frame['volumechange']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + if ($parsed_frame['incdec']['leftrear'] === false) { + $parsed_frame['volumechange']['leftrear'] *= -1; + } + $frame_offset += $frame_bytesvolume; + $parsed_frame['peakvolume']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + $frame_offset += $frame_bytesvolume; + $parsed_frame['peakvolume']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + $frame_offset += $frame_bytesvolume; + } + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset); + if (strlen($parsed_frame['data']) > 0) { + $parsed_frame['incdec']['center'] = (bool)substr($frame_incrdecrflags, 3, 1); + $parsed_frame['volumechange']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + if ($parsed_frame['incdec']['center'] === false) { + $parsed_frame['volumechange']['center'] *= -1; + } + $frame_offset += $frame_bytesvolume; + $parsed_frame['peakvolume']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + $frame_offset += $frame_bytesvolume; + } + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset); + if (strlen($parsed_frame['data']) > 0) { + $parsed_frame['incdec']['bass'] = (bool)substr($frame_incrdecrflags, 2, 1); + $parsed_frame['volumechange']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + if ($parsed_frame['incdec']['bass'] === false) { + $parsed_frame['volumechange']['bass'] *= -1; + } + $frame_offset += $frame_bytesvolume; + $parsed_frame['peakvolume']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume)); + $frame_offset += $frame_bytesvolume; + } + } + unset($parsed_frame['data']); + return true; + } + + + if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'EQU2')) { // 4.12 EQU2 Equalisation (2) (ID3v2.4+ only) + + // There may be more than one 'EQU2' frame in each tag, + // but only one with the same identification string + //
+ // Interpolation method $xx + // $00 Band + // $01 Linear + // Identification $00 + // The following is then repeated for every adjustment point + // Frequency $xx xx + // Volume adjustment $xx xx + + $frame_offset = 0; + $frame_interpolationmethod = ord($parsed_frame['data']{$frame_offset++}); + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_id_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_id_string) === 0) { + $frame_id_string = ''; + } + $parsed_frame['description'] = $frame_id_string; + $frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00")); + while (strlen($frame_remaining_data)) { + $frame_frequency = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 2)) / 2; + $parsed_frame['data'][$frame_frequency] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, 2), true); + $frame_remaining_data = substr($frame_remaining_data, 4); + } + $parsed_frame['interpolationmethod'] = $frame_interpolationmethod; + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'EQUA')) || // 4.12 EQUA Equalisation (ID3v2.3 only) + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'EQU'))) { // 4.13 EQU Equalisation (ID3v2.2 only) + + // There may only be one 'EQUA' frame in each tag + //
+ // Adjustment bits $xx + // This is followed by 2 bytes + ('adjustment bits' rounded up to the + // nearest byte) for every equalisation band in the following format, + // giving a frequency range of 0 - 32767Hz: + // Increment/decrement %x (MSB of the Frequency) + // Frequency (lower 15 bits) + // Adjustment $xx (xx ...) + + $frame_offset = 0; + $parsed_frame['adjustmentbits'] = $parsed_frame['data']{$frame_offset++}; + $frame_adjustment_bytes = ceil($parsed_frame['adjustmentbits'] / 8); + + $frame_remaining_data = (string)substr($parsed_frame['data'], $frame_offset); + while (strlen($frame_remaining_data) > 0) { + $frame_frequencystr = getid3_lib::BigEndian2Bin(substr($frame_remaining_data, 0, 2)); + $frame_incdec = (bool)substr($frame_frequencystr, 0, 1); + $frame_frequency = bindec(substr($frame_frequencystr, 1, 15)); + $parsed_frame[$frame_frequency]['incdec'] = $frame_incdec; + $parsed_frame[$frame_frequency]['adjustment'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, $frame_adjustment_bytes)); + if ($parsed_frame[$frame_frequency]['incdec'] === false) { + $parsed_frame[$frame_frequency]['adjustment'] *= -1; + } + $frame_remaining_data = substr($frame_remaining_data, 2 + $frame_adjustment_bytes); + } + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RVRB')) || // 4.13 RVRB Reverb + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'REV'))) { // 4.14 REV Reverb + + // There may only be one 'RVRB' frame in each tag. + //
+ // Reverb left (ms) $xx xx + // Reverb right (ms) $xx xx + // Reverb bounces, left $xx + // Reverb bounces, right $xx + // Reverb feedback, left to left $xx + // Reverb feedback, left to right $xx + // Reverb feedback, right to right $xx + // Reverb feedback, right to left $xx + // Premix left to right $xx + // Premix right to left $xx + + $frame_offset = 0; + $parsed_frame['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2)); + $frame_offset += 2; + $parsed_frame['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2)); + $frame_offset += 2; + $parsed_frame['bouncesL'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['bouncesR'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['feedbackLL'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['feedbackLR'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['feedbackRR'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['feedbackRL'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['premixLR'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['premixRL'] = ord($parsed_frame['data']{$frame_offset++}); + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'APIC')) || // 4.14 APIC Attached picture + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'PIC'))) { // 4.15 PIC Attached picture + + // There may be several pictures attached to one file, + // each in their individual 'APIC' frame, but only one + // with the same content descriptor + //
+ // Text encoding $xx + // ID3v2.3+ => MIME type $00 + // ID3v2.2 => Image format $xx xx xx + // Picture type $xx + // Description $00 (00) + // Picture data + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + + if ($id3v2_major_version == 2 && strlen($parsed_frame['data']) > $frame_offset) { + $frame_imagetype = substr($parsed_frame['data'], $frame_offset, 3); + if (strtolower($frame_imagetype) == 'ima') { + // complete hack for mp3Rage (www.chaoticsoftware.com) that puts ID3v2.3-formatted + // MIME type instead of 3-char ID3v2.2-format image type (thanks xbhoffØpacbell*net) + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_mimetype) === 0) { + $frame_mimetype = ''; + } + $frame_imagetype = strtoupper(str_replace('image/', '', strtolower($frame_mimetype))); + if ($frame_imagetype == 'JPEG') { + $frame_imagetype = 'JPG'; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + } else { + $frame_offset += 3; + } + } + + if ($id3v2_major_version > 2 && strlen($parsed_frame['data']) > $frame_offset) { + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_mimetype) === 0) { + $frame_mimetype = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + } + + $frame_picturetype = ord($parsed_frame['data']{$frame_offset++}); + + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_description) === 0) { + $frame_description = ''; + } + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + if ($id3v2_major_version == 2) { + $parsed_frame['imagetype'] = $frame_imagetype; + } else { + $parsed_frame['mime'] = $frame_mimetype; + } + $parsed_frame['picturetypeid'] = $frame_picturetype; + $parsed_frame['picturetype'] = getid3_id3v2::APICPictureTypeLookup($frame_picturetype); + $parsed_frame['description'] = $frame_description; + $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding))); + + if ($getid3->option_tags_images) { + + $image_chunk_check = getid3_lib_image_size::get($parsed_frame['data']); + if (($image_chunk_check[2] >= 1) && ($image_chunk_check[2] <= 3)) { + $parsed_frame['image_mime'] = image_type_to_mime_type($image_chunk_check[2]); + + if ($image_chunk_check[0]) { + $parsed_frame['image_width'] = $image_chunk_check[0]; + } + + if ($image_chunk_check[1]) { + $parsed_frame['image_height'] = $image_chunk_check[1]; + } + + $parsed_frame['image_bytes'] = strlen($parsed_frame['data']); + } + } + + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GEOB')) || // 4.15 GEOB General encapsulated object + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'GEO'))) { // 4.16 GEO General encapsulated object + + // There may be more than one 'GEOB' frame in each tag, + // but only one with the same content descriptor + //
+ // Text encoding $xx + // MIME type $00 + // Filename $00 (00) + // Content description $00 (00) + // Encapsulated object + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_mimetype) === 0) { + $frame_mimetype = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $frame_filename = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_filename) === 0) { + $frame_filename = ''; + } + $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)); + + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_description) === 0) { + $frame_description = ''; + } + $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)); + + $parsed_frame['objectdata'] = (string)substr($parsed_frame['data'], $frame_offset); + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['mime'] = $frame_mimetype; + $parsed_frame['filename'] = $frame_filename; + $parsed_frame['description'] = $frame_description; + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PCNT')) || // 4.16 PCNT Play counter + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CNT'))) { // 4.17 CNT Play counter + + // There may only be one 'PCNT' frame in each tag. + // When the counter reaches all one's, one byte is inserted in + // front of the counter thus making the counter eight bits bigger + //
+ // Counter $xx xx xx xx (xx ...) + + $parsed_frame['data'] = getid3_lib::BigEndian2Int($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POPM')) || // 4.17 POPM Popularimeter + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'POP'))) { // 4.18 POP Popularimeter + + // There may be more than one 'POPM' frame in each tag, + // but only one with the same email address + //
+ // Email to user $00 + // Rating $xx + // Counter $xx xx xx xx (xx ...) + + $frame_offset = 0; + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_email_address = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_email_address) === 0) { + $frame_email_address = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + $frame_rating = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset)); + $parsed_frame['email'] = $frame_email_address; + $parsed_frame['rating'] = $frame_rating; + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RBUF')) || // 4.18 RBUF Recommended buffer size + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'BUF'))) { // 4.19 BUF Recommended buffer size + + // There may only be one 'RBUF' frame in each tag + //
+ // Buffer size $xx xx xx + // Embedded info flag %0000000x + // Offset to next tag $xx xx xx xx + + $frame_offset = 0; + $parsed_frame['buffersize'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 3)); + $frame_offset += 3; + + $frame_embeddedinfoflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++}); + $parsed_frame['flags']['embededinfo'] = (bool)substr($frame_embeddedinfoflags, 7, 1); + $parsed_frame['nexttagoffset'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4)); + unset($parsed_frame['data']); + return true; + } + + + if (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRM')) { // 4.20 Encrypted meta frame (ID3v2.2 only) + + // There may be more than one 'CRM' frame in a tag, + // but only one with the same 'owner identifier' + //
+ // Owner identifier $00 (00) + // Content/explanation $00 (00) + // Encrypted datablock + + $frame_offset = 0; + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_description) === 0) { + $frame_description = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $parsed_frame['ownerid'] = $frame_owner_id; + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + $parsed_frame['description'] = $frame_description; + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'AENC')) || // 4.19 AENC Audio encryption + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRA'))) { // 4.21 CRA Audio encryption + + // There may be more than one 'AENC' frames in a tag, + // but only one with the same 'Owner identifier' + //
+ // Owner identifier $00 + // Preview start $xx xx + // Preview length $xx xx + // Encryption info + + $frame_offset = 0; + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_owner_id) === 0) { + $frame_owner_id == ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + $parsed_frame['ownerid'] = $frame_owner_id; + $parsed_frame['previewstart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2)); + $frame_offset += 2; + $parsed_frame['previewlength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2)); + $frame_offset += 2; + $parsed_frame['encryptioninfo'] = (string)substr($parsed_frame['data'], $frame_offset); + unset($parsed_frame['data']); + return true; + } + + + if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'LINK')) || // 4.20 LINK Linked information + (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'LNK'))) { // 4.22 LNK Linked information + + // There may be more than one 'LINK' frame in a tag, + // but only one with the same contents + //
+ // ID3v2.3+ => Frame identifier $xx xx xx xx + // ID3v2.2 => Frame identifier $xx xx xx + // URL $00 + // ID and additional data + + $frame_offset = 0; + if ($id3v2_major_version == 2) { + $parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 3); + $frame_offset += 3; + } else { + $parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 4); + $frame_offset += 4; + } + + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_url = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_url) === 0) { + $frame_url = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + $parsed_frame['url'] = $frame_url; + + $parsed_frame['additionaldata'] = (string)substr($parsed_frame['data'], $frame_offset); + if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = utf8_encode($parsed_frame['url']); + } + unset($parsed_frame['data']); + return true; + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POSS')) { // 4.21 POSS Position synchronisation frame (ID3v2.3+ only) + + // There may only be one 'POSS' frame in each tag + // + // Time stamp format $xx + // Position $xx (xx ...) + + $frame_offset = 0; + $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['position'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset)); + unset($parsed_frame['data']); + return true; + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USER')) { // 4.22 USER Terms of use (ID3v2.3+ only) + + // There may be more than one 'Terms of use' frame in a tag, + // but only one with the same 'Language' + //
+ // Text encoding $xx + // Language $xx xx xx + // The actual text + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $frame_language = substr($parsed_frame['data'], $frame_offset, 3); + $frame_offset += 3; + $parsed_frame['language'] = $frame_language; + $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false); + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) { + $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']); + } + unset($parsed_frame['data']); + return true; + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'OWNE')) { // 4.23 OWNE Ownership frame (ID3v2.3+ only) + + // There may only be one 'OWNE' frame in a tag + //
+ // Text encoding $xx + // Price paid $00 + // Date of purch. + // Seller + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_pricepaid = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $parsed_frame['pricepaid']['currencyid'] = substr($frame_pricepaid, 0, 3); + $parsed_frame['pricepaid']['currency'] = getid3_id3v2::LookupCurrencyUnits($parsed_frame['pricepaid']['currencyid']); + $parsed_frame['pricepaid']['value'] = substr($frame_pricepaid, 3); + + $parsed_frame['purchasedate'] = substr($parsed_frame['data'], $frame_offset, 8); + if (!getid3_id3v2::IsValidDateStampString($parsed_frame['purchasedate'])) { + $parsed_frame['purchasedateunix'] = gmmktime (0, 0, 0, substr($parsed_frame['purchasedate'], 4, 2), substr($parsed_frame['purchasedate'], 6, 2), substr($parsed_frame['purchasedate'], 0, 4)); + } + $frame_offset += 8; + + $parsed_frame['seller'] = (string)substr($parsed_frame['data'], $frame_offset); + unset($parsed_frame['data']); + return true; + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMR')) { // 4.24 COMR Commercial frame (ID3v2.3+ only) + + // There may be more than one 'commercial frame' in a tag, + // but no two may be identical + //
+ // Text encoding $xx + // Price string $00 + // Valid until + // Contact URL $00 + // Received as $xx + // Name of seller $00 (00) + // Description $00 (00) + // Picture MIME type $00 + // Seller logo + + $frame_offset = 0; + $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++}); + if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) { + $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding'); + } + + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_price_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + $frame_offset = $frame_terminator_pos + strlen("\x00"); + $frame_rawpricearray = explode('/', $frame_price_string); + foreach ($frame_rawpricearray as $key => $val) { + $frame_currencyid = substr($val, 0, 3); + $parsed_frame['price'][$frame_currencyid]['currency'] = getid3_id3v2::LookupCurrencyUnits($frame_currencyid); + $parsed_frame['price'][$frame_currencyid]['value'] = substr($val, 3); + } + + $frame_date_string = substr($parsed_frame['data'], $frame_offset, 8); + $frame_offset += 8; + + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_contacturl = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $frame_received_as_id = ord($parsed_frame['data']{$frame_offset++}); + + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + + $frame_sellername = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_sellername) === 0) { + $frame_sellername = ''; + } + + $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)); + + $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset); + if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) { + $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00 + } + + $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_description) === 0) { + $frame_description = ''; + } + + $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)); + + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $frame_sellerlogo = substr($parsed_frame['data'], $frame_offset); + + $parsed_frame['encodingid'] = $frame_text_encoding; + $parsed_frame['encoding'] = $this->TextEncodingNameLookup($frame_text_encoding); + + $parsed_frame['pricevaliduntil'] = $frame_date_string; + $parsed_frame['contacturl'] = $frame_contacturl; + $parsed_frame['receivedasid'] = $frame_received_as_id; + $parsed_frame['receivedas'] = getid3_id3v2::COMRReceivedAsLookup($frame_received_as_id); + $parsed_frame['sellername'] = $frame_sellername; + $parsed_frame['description'] = $frame_description; + $parsed_frame['mime'] = $frame_mimetype; + $parsed_frame['logo'] = $frame_sellerlogo; + unset($parsed_frame['data']); + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ENCR')) { // 4.25 ENCR Encryption method registration (ID3v2.3+ only) + + // There may be several 'ENCR' frames in a tag, + // but only one containing the same symbol + // and only one containing the same owner identifier + //
+ // Owner identifier $00 + // Method symbol $xx + // Encryption data + + $frame_offset = 0; + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_owner_id) === 0) { + $frame_owner_id = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $parsed_frame['ownerid'] = $frame_owner_id; + $parsed_frame['methodsymbol'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + return true; + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GRID')) { // 4.26 GRID Group identification registration (ID3v2.3+ only) + + // There may be several 'GRID' frames in a tag, + // but only one containing the same symbol + // and only one containing the same owner identifier + //
+ // Owner identifier $00 + // Group symbol $xx + // Group dependent data + + $frame_offset = 0; + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_owner_id) === 0) { + $frame_owner_id = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $parsed_frame['ownerid'] = $frame_owner_id; + $parsed_frame['groupsymbol'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + return true; + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PRIV')) { // 4.27 PRIV Private frame (ID3v2.3+ only) + + // The tag may contain more than one 'PRIV' frame + // but only with different contents + //
+ // Owner identifier $00 + // The private data + + $frame_offset = 0; + $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset); + $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset); + if (ord($frame_owner_id) === 0) { + $frame_owner_id = ''; + } + $frame_offset = $frame_terminator_pos + strlen("\x00"); + + $parsed_frame['ownerid'] = $frame_owner_id; + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + return true; + } + + + if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SIGN')) { // 4.28 SIGN Signature frame (ID3v2.4+ only) + + // There may be more than one 'signature frame' in a tag, + // but no two may be identical + //
+ // Group symbol $xx + // Signature + + $frame_offset = 0; + $parsed_frame['groupsymbol'] = ord($parsed_frame['data']{$frame_offset++}); + $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset); + return true; + } + + + if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SEEK')) { // 4.29 SEEK Seek frame (ID3v2.4+ only) + + // There may only be one 'seek frame' in a tag + //
+ // Minimum offset to next tag $xx xx xx xx + + $frame_offset = 0; + $parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4)); + return true; + } + + + if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'ASPI')) { // 4.30 ASPI Audio seek point index (ID3v2.4+ only) + + // There may only be one 'audio seek point index' frame in a tag + //
+ // Indexed data start (S) $xx xx xx xx + // Indexed data length (L) $xx xx xx xx + // Number of index points (N) $xx xx + // Bits per index point (b) $xx + // Then for every index point the following data is included: + // Fraction at index (Fi) $xx (xx) + + $frame_offset = 0; + $parsed_frame['datastart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4)); + $frame_offset += 4; + $parsed_frame['indexeddatalength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4)); + $frame_offset += 4; + $parsed_frame['indexpoints'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2)); + $frame_offset += 2; + $parsed_frame['bitsperpoint'] = ord($parsed_frame['data']{$frame_offset++}); + $frame_bytesperpoint = ceil($parsed_frame['bitsperpoint'] / 8); + for ($i = 0; $i < $frame_indexpoints; $i++) { + $parsed_frame['indexes'][$i] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesperpoint)); + $frame_offset += $frame_bytesperpoint; + } + unset($parsed_frame['data']); + return true; + } + + + if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RGAD')) { // Replay Gain Adjustment + + // http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html + // There may only be one 'RGAD' frame in a tag + //
+ // Peak Amplitude $xx $xx $xx $xx + // Radio Replay Gain Adjustment %aaabbbcd %dddddddd + // Audiophile Replay Gain Adjustment %aaabbbcd %dddddddd + // a - name code + // b - originator code + // c - sign bit + // d - replay gain adjustment + + $frame_offset = 0; + + $parsed_frame['peakamplitude'] = (float)getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4)); + $frame_offset += 4; + + $rg_track_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2)); + $frame_offset += 2; + + $rg_album_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2)); + $frame_offset += 2; + + $parsed_frame['raw']['track']['name'] = bindec(substr($rg_track_adjustment, 0, 3)); + $parsed_frame['raw']['track']['originator'] = bindec(substr($rg_track_adjustment, 3, 3)); + $parsed_frame['raw']['track']['signbit'] = bindec($rg_track_adjustment[6]); + $parsed_frame['raw']['track']['adjustment'] = bindec(substr($rg_track_adjustment, 7, 9)); + $parsed_frame['raw']['album']['name'] = bindec(substr($rg_album_adjustment, 0, 3)); + $parsed_frame['raw']['album']['originator'] = bindec(substr($rg_album_adjustment, 3, 3)); + $parsed_frame['raw']['album']['signbit'] = bindec($rg_album_adjustment[6]); + $parsed_frame['raw']['album']['adjustment'] = bindec(substr($rg_album_adjustment, 7, 9)); + $parsed_frame['track']['name'] = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['track']['name']); + $parsed_frame['track']['originator'] = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['track']['originator']); + $parsed_frame['track']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['track']['adjustment'], $parsed_frame['raw']['track']['signbit']); + $parsed_frame['album']['name'] = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['album']['name']); + $parsed_frame['album']['originator'] = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['album']['originator']); + $parsed_frame['album']['adjustment'] = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['album']['adjustment'], $parsed_frame['raw']['album']['signbit']); + + $getid3->info['replay_gain']['track']['peak'] = $parsed_frame['peakamplitude']; + $getid3->info['replay_gain']['track']['originator'] = $parsed_frame['track']['originator']; + $getid3->info['replay_gain']['track']['adjustment'] = $parsed_frame['track']['adjustment']; + $getid3->info['replay_gain']['album']['originator'] = $parsed_frame['album']['originator']; + $getid3->info['replay_gain']['album']['adjustment'] = $parsed_frame['album']['adjustment']; + + unset($parsed_frame['data']); + return true; + } + + return true; + } + + + + private function TextEncodingNameLookup($encoding) { + + // Override specification - BRAINDEAD taggers + if (!$encoding) { + return $this->getid3->encoding_id3v2; + } + + // http://www.id3.org/id3v2.4.0-structure.txt + static $lookup = array ( + 0 => 'ISO-8859-1', + 1 => 'UTF-16', + 2 => 'UTF-16BE', + 3 => 'UTF-8', + 255 => 'UTF-16BE' + ); + + return (isset($lookup[$encoding]) ? $lookup[$encoding] : 'ISO-8859-1'); + } + + + + public static function ParseID3v2GenreString($genre_string) { + + // Parse genres into arrays of genreName and genreID + // ID3v2.2.x, ID3v2.3.x: '(21)' or '(4)Eurodisco' or '(51)(39)' or '(55)((I think...)' + // ID3v2.4.x: '21' $00 'Eurodisco' $00 + + $genre_string = trim($genre_string); + $return_array = array (); + if (strpos($genre_string, "\x00") !== false) { + $unprocessed = trim($genre_string); // trailing nulls will cause an infinite loop. + $genre_string = ''; + while (strpos($unprocessed, "\x00") !== false) { + // convert null-seperated v2.4-format into v2.3 ()-seperated format + $end_pos = strpos($unprocessed, "\x00"); + $genre_string .= '('.substr($unprocessed, 0, $end_pos).')'; + $unprocessed = substr($unprocessed, $end_pos + 1); + } + unset($unprocessed); + } + if (getid3_id3v1::LookupGenreID($genre_string)) { + + $return_array['genre'][] = $genre_string; + + } else { + + while (strpos($genre_string, '(') !== false) { + + $start_pos = strpos($genre_string, '('); + $end_pos = strpos($genre_string, ')'); + if (substr($genre_string, $start_pos + 1, 1) == '(') { + $genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $start_pos + 1); + $end_pos--; + } + $element = substr($genre_string, $start_pos + 1, $end_pos - ($start_pos + 1)); + $genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $end_pos + 1); + + if (getid3_id3v1::LookupGenreName($element)) { // $element is a valid genre id/abbreviation + + if (empty($return_array['genre']) || !in_array(getid3_id3v1::LookupGenreName($element), $return_array['genre'])) { // avoid duplicate entires + $return_array['genre'][] = getid3_id3v1::LookupGenreName($element); + } + } else { + + if (empty($return_array['genre']) || !in_array($element, $return_array['genre'])) { // avoid duplicate entires + $return_array['genre'][] = $element; + } + } + } + } + if ($genre_string) { + if (empty($return_array['genre']) || !in_array($genre_string, $return_array['genre'])) { // avoid duplicate entires + $return_array['genre'][] = $genre_string; + } + } + + return $return_array; + } + + + + public static function LookupCurrencyUnits($currency_id) { + + static $lookup = array ( + 'AED' => 'Dirhams', + 'AFA' => 'Afghanis', + 'ALL' => 'Leke', + 'AMD' => 'Drams', + 'ANG' => 'Guilders', + 'AOA' => 'Kwanza', + 'ARS' => 'Pesos', + 'ATS' => 'Schillings', + 'AUD' => 'Dollars', + 'AWG' => 'Guilders', + 'AZM' => 'Manats', + 'BAM' => 'Convertible Marka', + 'BBD' => 'Dollars', + 'BDT' => 'Taka', + 'BEF' => 'Francs', + 'BGL' => 'Leva', + 'BHD' => 'Dinars', + 'BIF' => 'Francs', + 'BMD' => 'Dollars', + 'BND' => 'Dollars', + 'BOB' => 'Bolivianos', + 'BRL' => 'Brazil Real', + 'BSD' => 'Dollars', + 'BTN' => 'Ngultrum', + 'BWP' => 'Pulas', + 'BYR' => 'Rubles', + 'BZD' => 'Dollars', + 'CAD' => 'Dollars', + 'CDF' => 'Congolese Francs', + 'CHF' => 'Francs', + 'CLP' => 'Pesos', + 'CNY' => 'Yuan Renminbi', + 'COP' => 'Pesos', + 'CRC' => 'Colones', + 'CUP' => 'Pesos', + 'CVE' => 'Escudos', + 'CYP' => 'Pounds', + 'CZK' => 'Koruny', + 'DEM' => 'Deutsche Marks', + 'DJF' => 'Francs', + 'DKK' => 'Kroner', + 'DOP' => 'Pesos', + 'DZD' => 'Algeria Dinars', + 'EEK' => 'Krooni', + 'EGP' => 'Pounds', + 'ERN' => 'Nakfa', + 'ESP' => 'Pesetas', + 'ETB' => 'Birr', + 'EUR' => 'Euro', + 'FIM' => 'Markkaa', + 'FJD' => 'Dollars', + 'FKP' => 'Pounds', + 'FRF' => 'Francs', + 'GBP' => 'Pounds', + 'GEL' => 'Lari', + 'GGP' => 'Pounds', + 'GHC' => 'Cedis', + 'GIP' => 'Pounds', + 'GMD' => 'Dalasi', + 'GNF' => 'Francs', + 'GRD' => 'Drachmae', + 'GTQ' => 'Quetzales', + 'GYD' => 'Dollars', + 'HKD' => 'Dollars', + 'HNL' => 'Lempiras', + 'HRK' => 'Kuna', + 'HTG' => 'Gourdes', + 'HUF' => 'Forints', + 'IDR' => 'Rupiahs', + 'IEP' => 'Pounds', + 'ILS' => 'New Shekels', + 'IMP' => 'Pounds', + 'INR' => 'Rupees', + 'IQD' => 'Dinars', + 'IRR' => 'Rials', + 'ISK' => 'Kronur', + 'ITL' => 'Lire', + 'JEP' => 'Pounds', + 'JMD' => 'Dollars', + 'JOD' => 'Dinars', + 'JPY' => 'Yen', + 'KES' => 'Shillings', + 'KGS' => 'Soms', + 'KHR' => 'Riels', + 'KMF' => 'Francs', + 'KPW' => 'Won', + 'KWD' => 'Dinars', + 'KYD' => 'Dollars', + 'KZT' => 'Tenge', + 'LAK' => 'Kips', + 'LBP' => 'Pounds', + 'LKR' => 'Rupees', + 'LRD' => 'Dollars', + 'LSL' => 'Maloti', + 'LTL' => 'Litai', + 'LUF' => 'Francs', + 'LVL' => 'Lati', + 'LYD' => 'Dinars', + 'MAD' => 'Dirhams', + 'MDL' => 'Lei', + 'MGF' => 'Malagasy Francs', + 'MKD' => 'Denars', + 'MMK' => 'Kyats', + 'MNT' => 'Tugriks', + 'MOP' => 'Patacas', + 'MRO' => 'Ouguiyas', + 'MTL' => 'Liri', + 'MUR' => 'Rupees', + 'MVR' => 'Rufiyaa', + 'MWK' => 'Kwachas', + 'MXN' => 'Pesos', + 'MYR' => 'Ringgits', + 'MZM' => 'Meticais', + 'NAD' => 'Dollars', + 'NGN' => 'Nairas', + 'NIO' => 'Gold Cordobas', + 'NLG' => 'Guilders', + 'NOK' => 'Krone', + 'NPR' => 'Nepal Rupees', + 'NZD' => 'Dollars', + 'OMR' => 'Rials', + 'PAB' => 'Balboa', + 'PEN' => 'Nuevos Soles', + 'PGK' => 'Kina', + 'PHP' => 'Pesos', + 'PKR' => 'Rupees', + 'PLN' => 'Zlotych', + 'PTE' => 'Escudos', + 'PYG' => 'Guarani', + 'QAR' => 'Rials', + 'ROL' => 'Lei', + 'RUR' => 'Rubles', + 'RWF' => 'Rwanda Francs', + 'SAR' => 'Riyals', + 'SBD' => 'Dollars', + 'SCR' => 'Rupees', + 'SDD' => 'Dinars', + 'SEK' => 'Kronor', + 'SGD' => 'Dollars', + 'SHP' => 'Pounds', + 'SIT' => 'Tolars', + 'SKK' => 'Koruny', + 'SLL' => 'Leones', + 'SOS' => 'Shillings', + 'SPL' => 'Luigini', + 'SRG' => 'Guilders', + 'STD' => 'Dobras', + 'SVC' => 'Colones', + 'SYP' => 'Pounds', + 'SZL' => 'Emalangeni', + 'THB' => 'Baht', + 'TJR' => 'Rubles', + 'TMM' => 'Manats', + 'TND' => 'Dinars', + 'TOP' => 'Pa\'anga', + 'TRL' => 'Liras', + 'TTD' => 'Dollars', + 'TVD' => 'Tuvalu Dollars', + 'TWD' => 'New Dollars', + 'TZS' => 'Shillings', + 'UAH' => 'Hryvnia', + 'UGX' => 'Shillings', + 'USD' => 'Dollars', + 'UYU' => 'Pesos', + 'UZS' => 'Sums', + 'VAL' => 'Lire', + 'VEB' => 'Bolivares', + 'VND' => 'Dong', + 'VUV' => 'Vatu', + 'WST' => 'Tala', + 'XAF' => 'Francs', + 'XAG' => 'Ounces', + 'XAU' => 'Ounces', + 'XCD' => 'Dollars', + 'XDR' => 'Special Drawing Rights', + 'XPD' => 'Ounces', + 'XPF' => 'Francs', + 'XPT' => 'Ounces', + 'YER' => 'Rials', + 'YUM' => 'New Dinars', + 'ZAR' => 'Rand', + 'ZMK' => 'Kwacha', + 'ZWD' => 'Zimbabwe Dollars' + ); + + return @$lookup[$currency_id]; + } + + + + public static function LookupCurrencyCountry($currency_id) { + + static $lookup = array ( + 'AED' => 'United Arab Emirates', + 'AFA' => 'Afghanistan', + 'ALL' => 'Albania', + 'AMD' => 'Armenia', + 'ANG' => 'Netherlands Antilles', + 'AOA' => 'Angola', + 'ARS' => 'Argentina', + 'ATS' => 'Austria', + 'AUD' => 'Australia', + 'AWG' => 'Aruba', + 'AZM' => 'Azerbaijan', + 'BAM' => 'Bosnia and Herzegovina', + 'BBD' => 'Barbados', + 'BDT' => 'Bangladesh', + 'BEF' => 'Belgium', + 'BGL' => 'Bulgaria', + 'BHD' => 'Bahrain', + 'BIF' => 'Burundi', + 'BMD' => 'Bermuda', + 'BND' => 'Brunei Darussalam', + 'BOB' => 'Bolivia', + 'BRL' => 'Brazil', + 'BSD' => 'Bahamas', + 'BTN' => 'Bhutan', + 'BWP' => 'Botswana', + 'BYR' => 'Belarus', + 'BZD' => 'Belize', + 'CAD' => 'Canada', + 'CDF' => 'Congo/Kinshasa', + 'CHF' => 'Switzerland', + 'CLP' => 'Chile', + 'CNY' => 'China', + 'COP' => 'Colombia', + 'CRC' => 'Costa Rica', + 'CUP' => 'Cuba', + 'CVE' => 'Cape Verde', + 'CYP' => 'Cyprus', + 'CZK' => 'Czech Republic', + 'DEM' => 'Germany', + 'DJF' => 'Djibouti', + 'DKK' => 'Denmark', + 'DOP' => 'Dominican Republic', + 'DZD' => 'Algeria', + 'EEK' => 'Estonia', + 'EGP' => 'Egypt', + 'ERN' => 'Eritrea', + 'ESP' => 'Spain', + 'ETB' => 'Ethiopia', + 'EUR' => 'Euro Member Countries', + 'FIM' => 'Finland', + 'FJD' => 'Fiji', + 'FKP' => 'Falkland Islands (Malvinas)', + 'FRF' => 'France', + 'GBP' => 'United Kingdom', + 'GEL' => 'Georgia', + 'GGP' => 'Guernsey', + 'GHC' => 'Ghana', + 'GIP' => 'Gibraltar', + 'GMD' => 'Gambia', + 'GNF' => 'Guinea', + 'GRD' => 'Greece', + 'GTQ' => 'Guatemala', + 'GYD' => 'Guyana', + 'HKD' => 'Hong Kong', + 'HNL' => 'Honduras', + 'HRK' => 'Croatia', + 'HTG' => 'Haiti', + 'HUF' => 'Hungary', + 'IDR' => 'Indonesia', + 'IEP' => 'Ireland (Eire)', + 'ILS' => 'Israel', + 'IMP' => 'Isle of Man', + 'INR' => 'India', + 'IQD' => 'Iraq', + 'IRR' => 'Iran', + 'ISK' => 'Iceland', + 'ITL' => 'Italy', + 'JEP' => 'Jersey', + 'JMD' => 'Jamaica', + 'JOD' => 'Jordan', + 'JPY' => 'Japan', + 'KES' => 'Kenya', + 'KGS' => 'Kyrgyzstan', + 'KHR' => 'Cambodia', + 'KMF' => 'Comoros', + 'KPW' => 'Korea', + 'KWD' => 'Kuwait', + 'KYD' => 'Cayman Islands', + 'KZT' => 'Kazakstan', + 'LAK' => 'Laos', + 'LBP' => 'Lebanon', + 'LKR' => 'Sri Lanka', + 'LRD' => 'Liberia', + 'LSL' => 'Lesotho', + 'LTL' => 'Lithuania', + 'LUF' => 'Luxembourg', + 'LVL' => 'Latvia', + 'LYD' => 'Libya', + 'MAD' => 'Morocco', + 'MDL' => 'Moldova', + 'MGF' => 'Madagascar', + 'MKD' => 'Macedonia', + 'MMK' => 'Myanmar (Burma)', + 'MNT' => 'Mongolia', + 'MOP' => 'Macau', + 'MRO' => 'Mauritania', + 'MTL' => 'Malta', + 'MUR' => 'Mauritius', + 'MVR' => 'Maldives (Maldive Islands)', + 'MWK' => 'Malawi', + 'MXN' => 'Mexico', + 'MYR' => 'Malaysia', + 'MZM' => 'Mozambique', + 'NAD' => 'Namibia', + 'NGN' => 'Nigeria', + 'NIO' => 'Nicaragua', + 'NLG' => 'Netherlands (Holland)', + 'NOK' => 'Norway', + 'NPR' => 'Nepal', + 'NZD' => 'New Zealand', + 'OMR' => 'Oman', + 'PAB' => 'Panama', + 'PEN' => 'Peru', + 'PGK' => 'Papua New Guinea', + 'PHP' => 'Philippines', + 'PKR' => 'Pakistan', + 'PLN' => 'Poland', + 'PTE' => 'Portugal', + 'PYG' => 'Paraguay', + 'QAR' => 'Qatar', + 'ROL' => 'Romania', + 'RUR' => 'Russia', + 'RWF' => 'Rwanda', + 'SAR' => 'Saudi Arabia', + 'SBD' => 'Solomon Islands', + 'SCR' => 'Seychelles', + 'SDD' => 'Sudan', + 'SEK' => 'Sweden', + 'SGD' => 'Singapore', + 'SHP' => 'Saint Helena', + 'SIT' => 'Slovenia', + 'SKK' => 'Slovakia', + 'SLL' => 'Sierra Leone', + 'SOS' => 'Somalia', + 'SPL' => 'Seborga', + 'SRG' => 'Suriname', + 'STD' => 'São Tome and Principe', + 'SVC' => 'El Salvador', + 'SYP' => 'Syria', + 'SZL' => 'Swaziland', + 'THB' => 'Thailand', + 'TJR' => 'Tajikistan', + 'TMM' => 'Turkmenistan', + 'TND' => 'Tunisia', + 'TOP' => 'Tonga', + 'TRL' => 'Turkey', + 'TTD' => 'Trinidad and Tobago', + 'TVD' => 'Tuvalu', + 'TWD' => 'Taiwan', + 'TZS' => 'Tanzania', + 'UAH' => 'Ukraine', + 'UGX' => 'Uganda', + 'USD' => 'United States of America', + 'UYU' => 'Uruguay', + 'UZS' => 'Uzbekistan', + 'VAL' => 'Vatican City', + 'VEB' => 'Venezuela', + 'VND' => 'Viet Nam', + 'VUV' => 'Vanuatu', + 'WST' => 'Samoa', + 'XAF' => 'Communauté Financière Africaine', + 'XAG' => 'Silver', + 'XAU' => 'Gold', + 'XCD' => 'East Caribbean', + 'XDR' => 'International Monetary Fund', + 'XPD' => 'Palladium', + 'XPF' => 'Comptoirs Français du Pacifique', + 'XPT' => 'Platinum', + 'YER' => 'Yemen', + 'YUM' => 'Yugoslavia', + 'ZAR' => 'South Africa', + 'ZMK' => 'Zambia', + 'ZWD' => 'Zimbabwe' + ); + + return @$lookup[$currency_id]; + } + + + + public static function LanguageLookup($language_code, $case_sensitive=false) { + + if (!$case_sensitive) { + $language_code = strtolower($language_code); + } + + // http://www.id3.org/id3v2.4.0-structure.txt + // [4. ID3v2 frame overview] + // The three byte language field, present in several frames, is used to + // describe the language of the frame's content, according to ISO-639-2 + // [ISO-639-2]. The language should be represented in lower case. If the + // language is not known the string "XXX" should be used. + + + // ISO 639-2 - http://www.id3.org/iso639-2.html + + static $lookup = array ( + 'XXX' => 'unknown', + 'xxx' => 'unknown', + 'aar' => 'Afar', + 'abk' => 'Abkhazian', + 'ace' => 'Achinese', + 'ach' => 'Acoli', + 'ada' => 'Adangme', + 'afa' => 'Afro-Asiatic (Other)', + 'afh' => 'Afrihili', + 'afr' => 'Afrikaans', + 'aka' => 'Akan', + 'akk' => 'Akkadian', + 'alb' => 'Albanian', + 'ale' => 'Aleut', + 'alg' => 'Algonquian Languages', + 'amh' => 'Amharic', + 'ang' => 'English, Old (ca. 450-1100)', + 'apa' => 'Apache Languages', + 'ara' => 'Arabic', + 'arc' => 'Aramaic', + 'arm' => 'Armenian', + 'arn' => 'Araucanian', + 'arp' => 'Arapaho', + 'art' => 'Artificial (Other)', + 'arw' => 'Arawak', + 'asm' => 'Assamese', + 'ath' => 'Athapascan Languages', + 'ava' => 'Avaric', + 'ave' => 'Avestan', + 'awa' => 'Awadhi', + 'aym' => 'Aymara', + 'aze' => 'Azerbaijani', + 'bad' => 'Banda', + 'bai' => 'Bamileke Languages', + 'bak' => 'Bashkir', + 'bal' => 'Baluchi', + 'bam' => 'Bambara', + 'ban' => 'Balinese', + 'baq' => 'Basque', + 'bas' => 'Basa', + 'bat' => 'Baltic (Other)', + 'bej' => 'Beja', + 'bel' => 'Byelorussian', + 'bem' => 'Bemba', + 'ben' => 'Bengali', + 'ber' => 'Berber (Other)', + 'bho' => 'Bhojpuri', + 'bih' => 'Bihari', + 'bik' => 'Bikol', + 'bin' => 'Bini', + 'bis' => 'Bislama', + 'bla' => 'Siksika', + 'bnt' => 'Bantu (Other)', + 'bod' => 'Tibetan', + 'bra' => 'Braj', + 'bre' => 'Breton', + 'bua' => 'Buriat', + 'bug' => 'Buginese', + 'bul' => 'Bulgarian', + 'bur' => 'Burmese', + 'cad' => 'Caddo', + 'cai' => 'Central American Indian (Other)', + 'car' => 'Carib', + 'cat' => 'Catalan', + 'cau' => 'Caucasian (Other)', + 'ceb' => 'Cebuano', + 'cel' => 'Celtic (Other)', + 'ces' => 'Czech', + 'cha' => 'Chamorro', + 'chb' => 'Chibcha', + 'che' => 'Chechen', + 'chg' => 'Chagatai', + 'chi' => 'Chinese', + 'chm' => 'Mari', + 'chn' => 'Chinook jargon', + 'cho' => 'Choctaw', + 'chr' => 'Cherokee', + 'chu' => 'Church Slavic', + 'chv' => 'Chuvash', + 'chy' => 'Cheyenne', + 'cop' => 'Coptic', + 'cor' => 'Cornish', + 'cos' => 'Corsican', + 'cpe' => 'Creoles and Pidgins, English-based (Other)', + 'cpf' => 'Creoles and Pidgins, French-based (Other)', + 'cpp' => 'Creoles and Pidgins, Portuguese-based (Other)', + 'cre' => 'Cree', + 'crp' => 'Creoles and Pidgins (Other)', + 'cus' => 'Cushitic (Other)', + 'cym' => 'Welsh', + 'cze' => 'Czech', + 'dak' => 'Dakota', + 'dan' => 'Danish', + 'del' => 'Delaware', + 'deu' => 'German', + 'din' => 'Dinka', + 'div' => 'Divehi', + 'doi' => 'Dogri', + 'dra' => 'Dravidian (Other)', + 'dua' => 'Duala', + 'dum' => 'Dutch, Middle (ca. 1050-1350)', + 'dut' => 'Dutch', + 'dyu' => 'Dyula', + 'dzo' => 'Dzongkha', + 'efi' => 'Efik', + 'egy' => 'Egyptian (Ancient)', + 'eka' => 'Ekajuk', + 'ell' => 'Greek, Modern (1453-)', + 'elx' => 'Elamite', + 'eng' => 'English', + 'enm' => 'English, Middle (ca. 1100-1500)', + 'epo' => 'Esperanto', + 'esk' => 'Eskimo (Other)', + 'esl' => 'Spanish', + 'est' => 'Estonian', + 'eus' => 'Basque', + 'ewe' => 'Ewe', + 'ewo' => 'Ewondo', + 'fan' => 'Fang', + 'fao' => 'Faroese', + 'fas' => 'Persian', + 'fat' => 'Fanti', + 'fij' => 'Fijian', + 'fin' => 'Finnish', + 'fiu' => 'Finno-Ugrian (Other)', + 'fon' => 'Fon', + 'fra' => 'French', + 'fre' => 'French', + 'frm' => 'French, Middle (ca. 1400-1600)', + 'fro' => 'French, Old (842- ca. 1400)', + 'fry' => 'Frisian', + 'ful' => 'Fulah', + 'gaa' => 'Ga', + 'gae' => 'Gaelic (Scots)', + 'gai' => 'Irish', + 'gay' => 'Gayo', + 'gdh' => 'Gaelic (Scots)', + 'gem' => 'Germanic (Other)', + 'geo' => 'Georgian', + 'ger' => 'German', + 'gez' => 'Geez', + 'gil' => 'Gilbertese', + 'glg' => 'Gallegan', + 'gmh' => 'German, Middle High (ca. 1050-1500)', + 'goh' => 'German, Old High (ca. 750-1050)', + 'gon' => 'Gondi', + 'got' => 'Gothic', + 'grb' => 'Grebo', + 'grc' => 'Greek, Ancient (to 1453)', + 'gre' => 'Greek, Modern (1453-)', + 'grn' => 'Guarani', + 'guj' => 'Gujarati', + 'hai' => 'Haida', + 'hau' => 'Hausa', + 'haw' => 'Hawaiian', + 'heb' => 'Hebrew', + 'her' => 'Herero', + 'hil' => 'Hiligaynon', + 'him' => 'Himachali', + 'hin' => 'Hindi', + 'hmo' => 'Hiri Motu', + 'hun' => 'Hungarian', + 'hup' => 'Hupa', + 'hye' => 'Armenian', + 'iba' => 'Iban', + 'ibo' => 'Igbo', + 'ice' => 'Icelandic', + 'ijo' => 'Ijo', + 'iku' => 'Inuktitut', + 'ilo' => 'Iloko', + 'ina' => 'Interlingua (International Auxiliary language Association)', + 'inc' => 'Indic (Other)', + 'ind' => 'Indonesian', + 'ine' => 'Indo-European (Other)', + 'ine' => 'Interlingue', + 'ipk' => 'Inupiak', + 'ira' => 'Iranian (Other)', + 'iri' => 'Irish', + 'iro' => 'Iroquoian uages', + 'isl' => 'Icelandic', + 'ita' => 'Italian', + 'jav' => 'Javanese', + 'jaw' => 'Javanese', + 'jpn' => 'Japanese', + 'jpr' => 'Judeo-Persian', + 'jrb' => 'Judeo-Arabic', + 'kaa' => 'Kara-Kalpak', + 'kab' => 'Kabyle', + 'kac' => 'Kachin', + 'kal' => 'Greenlandic', + 'kam' => 'Kamba', + 'kan' => 'Kannada', + 'kar' => 'Karen', + 'kas' => 'Kashmiri', + 'kat' => 'Georgian', + 'kau' => 'Kanuri', + 'kaw' => 'Kawi', + 'kaz' => 'Kazakh', + 'kha' => 'Khasi', + 'khi' => 'Khoisan (Other)', + 'khm' => 'Khmer', + 'kho' => 'Khotanese', + 'kik' => 'Kikuyu', + 'kin' => 'Kinyarwanda', + 'kir' => 'Kirghiz', + 'kok' => 'Konkani', + 'kom' => 'Komi', + 'kon' => 'Kongo', + 'kor' => 'Korean', + 'kpe' => 'Kpelle', + 'kro' => 'Kru', + 'kru' => 'Kurukh', + 'kua' => 'Kuanyama', + 'kum' => 'Kumyk', + 'kur' => 'Kurdish', + 'kus' => 'Kusaie', + 'kut' => 'Kutenai', + 'lad' => 'Ladino', + 'lah' => 'Lahnda', + 'lam' => 'Lamba', + 'lao' => 'Lao', + 'lat' => 'Latin', + 'lav' => 'Latvian', + 'lez' => 'Lezghian', + 'lin' => 'Lingala', + 'lit' => 'Lithuanian', + 'lol' => 'Mongo', + 'loz' => 'Lozi', + 'ltz' => 'Letzeburgesch', + 'lub' => 'Luba-Katanga', + 'lug' => 'Ganda', + 'lui' => 'Luiseno', + 'lun' => 'Lunda', + 'luo' => 'Luo (Kenya and Tanzania)', + 'mac' => 'Macedonian', + 'mad' => 'Madurese', + 'mag' => 'Magahi', + 'mah' => 'Marshall', + 'mai' => 'Maithili', + 'mak' => 'Macedonian', + 'mak' => 'Makasar', + 'mal' => 'Malayalam', + 'man' => 'Mandingo', + 'mao' => 'Maori', + 'map' => 'Austronesian (Other)', + 'mar' => 'Marathi', + 'mas' => 'Masai', + 'max' => 'Manx', + 'may' => 'Malay', + 'men' => 'Mende', + 'mga' => 'Irish, Middle (900 - 1200)', + 'mic' => 'Micmac', + 'min' => 'Minangkabau', + 'mis' => 'Miscellaneous (Other)', + 'mkh' => 'Mon-Kmer (Other)', + 'mlg' => 'Malagasy', + 'mlt' => 'Maltese', + 'mni' => 'Manipuri', + 'mno' => 'Manobo Languages', + 'moh' => 'Mohawk', + 'mol' => 'Moldavian', + 'mon' => 'Mongolian', + 'mos' => 'Mossi', + 'mri' => 'Maori', + 'msa' => 'Malay', + 'mul' => 'Multiple Languages', + 'mun' => 'Munda Languages', + 'mus' => 'Creek', + 'mwr' => 'Marwari', + 'mya' => 'Burmese', + 'myn' => 'Mayan Languages', + 'nah' => 'Aztec', + 'nai' => 'North American Indian (Other)', + 'nau' => 'Nauru', + 'nav' => 'Navajo', + 'nbl' => 'Ndebele, South', + 'nde' => 'Ndebele, North', + 'ndo' => 'Ndongo', + 'nep' => 'Nepali', + 'new' => 'Newari', + 'nic' => 'Niger-Kordofanian (Other)', + 'niu' => 'Niuean', + 'nla' => 'Dutch', + 'nno' => 'Norwegian (Nynorsk)', + 'non' => 'Norse, Old', + 'nor' => 'Norwegian', + 'nso' => 'Sotho, Northern', + 'nub' => 'Nubian Languages', + 'nya' => 'Nyanja', + 'nym' => 'Nyamwezi', + 'nyn' => 'Nyankole', + 'nyo' => 'Nyoro', + 'nzi' => 'Nzima', + 'oci' => 'Langue d\'Oc (post 1500)', + 'oji' => 'Ojibwa', + 'ori' => 'Oriya', + 'orm' => 'Oromo', + 'osa' => 'Osage', + 'oss' => 'Ossetic', + 'ota' => 'Turkish, Ottoman (1500 - 1928)', + 'oto' => 'Otomian Languages', + 'paa' => 'Papuan-Australian (Other)', + 'pag' => 'Pangasinan', + 'pal' => 'Pahlavi', + 'pam' => 'Pampanga', + 'pan' => 'Panjabi', + 'pap' => 'Papiamento', + 'pau' => 'Palauan', + 'peo' => 'Persian, Old (ca 600 - 400 B.C.)', + 'per' => 'Persian', + 'phn' => 'Phoenician', + 'pli' => 'Pali', + 'pol' => 'Polish', + 'pon' => 'Ponape', + 'por' => 'Portuguese', + 'pra' => 'Prakrit uages', + 'pro' => 'Provencal, Old (to 1500)', + 'pus' => 'Pushto', + 'que' => 'Quechua', + 'raj' => 'Rajasthani', + 'rar' => 'Rarotongan', + 'roa' => 'Romance (Other)', + 'roh' => 'Rhaeto-Romance', + 'rom' => 'Romany', + 'ron' => 'Romanian', + 'rum' => 'Romanian', + 'run' => 'Rundi', + 'rus' => 'Russian', + 'sad' => 'Sandawe', + 'sag' => 'Sango', + 'sah' => 'Yakut', + 'sai' => 'South American Indian (Other)', + 'sal' => 'Salishan Languages', + 'sam' => 'Samaritan Aramaic', + 'san' => 'Sanskrit', + 'sco' => 'Scots', + 'scr' => 'Serbo-Croatian', + 'sel' => 'Selkup', + 'sem' => 'Semitic (Other)', + 'sga' => 'Irish, Old (to 900)', + 'shn' => 'Shan', + 'sid' => 'Sidamo', + 'sin' => 'Singhalese', + 'sio' => 'Siouan Languages', + 'sit' => 'Sino-Tibetan (Other)', + 'sla' => 'Slavic (Other)', + 'slk' => 'Slovak', + 'slo' => 'Slovak', + 'slv' => 'Slovenian', + 'smi' => 'Sami Languages', + 'smo' => 'Samoan', + 'sna' => 'Shona', + 'snd' => 'Sindhi', + 'sog' => 'Sogdian', + 'som' => 'Somali', + 'son' => 'Songhai', + 'sot' => 'Sotho, Southern', + 'spa' => 'Spanish', + 'sqi' => 'Albanian', + 'srd' => 'Sardinian', + 'srr' => 'Serer', + 'ssa' => 'Nilo-Saharan (Other)', + 'ssw' => 'Siswant', + 'ssw' => 'Swazi', + 'suk' => 'Sukuma', + 'sun' => 'Sudanese', + 'sus' => 'Susu', + 'sux' => 'Sumerian', + 'sve' => 'Swedish', + 'swa' => 'Swahili', + 'swe' => 'Swedish', + 'syr' => 'Syriac', + 'tah' => 'Tahitian', + 'tam' => 'Tamil', + 'tat' => 'Tatar', + 'tel' => 'Telugu', + 'tem' => 'Timne', + 'ter' => 'Tereno', + 'tgk' => 'Tajik', + 'tgl' => 'Tagalog', + 'tha' => 'Thai', + 'tib' => 'Tibetan', + 'tig' => 'Tigre', + 'tir' => 'Tigrinya', + 'tiv' => 'Tivi', + 'tli' => 'Tlingit', + 'tmh' => 'Tamashek', + 'tog' => 'Tonga (Nyasa)', + 'ton' => 'Tonga (Tonga Islands)', + 'tru' => 'Truk', + 'tsi' => 'Tsimshian', + 'tsn' => 'Tswana', + 'tso' => 'Tsonga', + 'tuk' => 'Turkmen', + 'tum' => 'Tumbuka', + 'tur' => 'Turkish', + 'tut' => 'Altaic (Other)', + 'twi' => 'Twi', + 'tyv' => 'Tuvinian', + 'uga' => 'Ugaritic', + 'uig' => 'Uighur', + 'ukr' => 'Ukrainian', + 'umb' => 'Umbundu', + 'und' => 'Undetermined', + 'urd' => 'Urdu', + 'uzb' => 'Uzbek', + 'vai' => 'Vai', + 'ven' => 'Venda', + 'vie' => 'Vietnamese', + 'vol' => 'Volapük', + 'vot' => 'Votic', + 'wak' => 'Wakashan Languages', + 'wal' => 'Walamo', + 'war' => 'Waray', + 'was' => 'Washo', + 'wel' => 'Welsh', + 'wen' => 'Sorbian Languages', + 'wol' => 'Wolof', + 'xho' => 'Xhosa', + 'yao' => 'Yao', + 'yap' => 'Yap', + 'yid' => 'Yiddish', + 'yor' => 'Yoruba', + 'zap' => 'Zapotec', + 'zen' => 'Zenaga', + 'zha' => 'Zhuang', + 'zho' => 'Chinese', + 'zul' => 'Zulu', + 'zun' => 'Zuni' + ); + + return @$lookup[$language_code]; + } + + + + public static function ETCOEventLookup($index) { + + if (($index >= 0x17) && ($index <= 0xDF)) { + return 'reserved for future use'; + } + if (($index >= 0xE0) && ($index <= 0xEF)) { + return 'not predefined synch 0-F'; + } + if (($index >= 0xF0) && ($index <= 0xFC)) { + return 'reserved for future use'; + } + + static $lookup = array ( + 0x00 => 'padding (has no meaning)', + 0x01 => 'end of initial silence', + 0x02 => 'intro start', + 0x03 => 'main part start', + 0x04 => 'outro start', + 0x05 => 'outro end', + 0x06 => 'verse start', + 0x07 => 'refrain start', + 0x08 => 'interlude start', + 0x09 => 'theme start', + 0x0A => 'variation start', + 0x0B => 'key change', + 0x0C => 'time change', + 0x0D => 'momentary unwanted noise (Snap, Crackle & Pop)', + 0x0E => 'sustained noise', + 0x0F => 'sustained noise end', + 0x10 => 'intro end', + 0x11 => 'main part end', + 0x12 => 'verse end', + 0x13 => 'refrain end', + 0x14 => 'theme end', + 0x15 => 'profanity', + 0x16 => 'profanity end', + 0xFD => 'audio end (start of silence)', + 0xFE => 'audio file ends', + 0xFF => 'one more byte of events follows' + ); + + return @$lookup[$index]; + } + + + + public static function SYTLContentTypeLookup($index) { + + static $lookup = array ( + 0x00 => 'other', + 0x01 => 'lyrics', + 0x02 => 'text transcription', + 0x03 => 'movement/part name', // (e.g. 'Adagio') + 0x04 => 'events', // (e.g. 'Don Quijote enters the stage') + 0x05 => 'chord', // (e.g. 'Bb F Fsus') + 0x06 => 'trivia/\'pop up\' information', + 0x07 => 'URLs to webpages', + 0x08 => 'URLs to images' + ); + + return @$lookup[$index]; + } + + + + public static function APICPictureTypeLookup($index, $return_array=false) { + + static $lookup = array ( + 0x00 => 'Other', + 0x01 => '32x32 pixels \'file icon\' (PNG only)', + 0x02 => 'Other file icon', + 0x03 => 'Cover (front)', + 0x04 => 'Cover (back)', + 0x05 => 'Leaflet page', + 0x06 => 'Media (e.g. label side of CD)', + 0x07 => 'Lead artist/lead performer/soloist', + 0x08 => 'Artist/performer', + 0x09 => 'Conductor', + 0x0A => 'Band/Orchestra', + 0x0B => 'Composer', + 0x0C => 'Lyricist/text writer', + 0x0D => 'Recording Location', + 0x0E => 'During recording', + 0x0F => 'During performance', + 0x10 => 'Movie/video screen capture', + 0x11 => 'A bright coloured fish', + 0x12 => 'Illustration', + 0x13 => 'Band/artist logotype', + 0x14 => 'Publisher/Studio logotype' + ); + + if ($return_array) { + return $lookup; + } + return @$lookup[$index]; + } + + + + public static function COMRReceivedAsLookup($index) { + + static $lookup = array ( + 0x00 => 'Other', + 0x01 => 'Standard CD album with other songs', + 0x02 => 'Compressed audio on CD', + 0x03 => 'File over the Internet', + 0x04 => 'Stream over the Internet', + 0x05 => 'As note sheets', + 0x06 => 'As note sheets in a book with other sheets', + 0x07 => 'Music on other media', + 0x08 => 'Non-musical merchandise' + ); + + return (isset($lookup[$index]) ? $lookup[$index] : ''); + } + + + + public static function RVA2ChannelTypeLookup($index) { + + static $lookup = array ( + 0x00 => 'Other', + 0x01 => 'Master volume', + 0x02 => 'Front right', + 0x03 => 'Front left', + 0x04 => 'Back right', + 0x05 => 'Back left', + 0x06 => 'Front centre', + 0x07 => 'Back centre', + 0x08 => 'Subwoofer' + ); + + return @$lookup[$index]; + } + + + + public static function FrameNameLongLookup($frame_name) { + + static $lookup = array ( + 'AENC' => 'Audio encryption', + 'APIC' => 'Attached picture', + 'ASPI' => 'Audio seek point index', + 'BUF' => 'Recommended buffer size', + 'CNT' => 'Play counter', + 'COM' => 'Comments', + 'COMM' => 'Comments', + 'COMR' => 'Commercial frame', + 'CRA' => 'Audio encryption', + 'CRM' => 'Encrypted meta frame', + 'ENCR' => 'Encryption method registration', + 'EQU' => 'Equalisation', + 'EQU2' => 'Equalisation (2)', + 'EQUA' => 'Equalisation', + 'ETC' => 'Event timing codes', + 'ETCO' => 'Event timing codes', + 'GEO' => 'General encapsulated object', + 'GEOB' => 'General encapsulated object', + 'GRID' => 'Group identification registration', + 'IPL' => 'Involved people list', + 'IPLS' => 'Involved people list', + 'LINK' => 'Linked information', + 'LNK' => 'Linked information', + 'MCDI' => 'Music CD identifier', + 'MCI' => 'Music CD Identifier', + 'MLL' => 'MPEG location lookup table', + 'MLLT' => 'MPEG location lookup table', + 'OWNE' => 'Ownership frame', + 'PCNT' => 'Play counter', + 'PIC' => 'Attached picture', + 'POP' => 'Popularimeter', + 'POPM' => 'Popularimeter', + 'POSS' => 'Position synchronisation frame', + 'PRIV' => 'Private frame', + 'RBUF' => 'Recommended buffer size', + 'REV' => 'Reverb', + 'RVA' => 'Relative volume adjustment', + 'RVA2' => 'Relative volume adjustment (2)', + 'RVAD' => 'Relative volume adjustment', + 'RVRB' => 'Reverb', + 'SEEK' => 'Seek frame', + 'SIGN' => 'Signature frame', + 'SLT' => 'Synchronised lyric/text', + 'STC' => 'Synced tempo codes', + 'SYLT' => 'Synchronised lyric/text', + 'SYTC' => 'Synchronised tempo codes', + 'TAL' => 'Album/Movie/Show title', + 'TALB' => 'Album/Movie/Show title', + 'TBP' => 'BPM (Beats Per Minute)', + 'TBPM' => 'BPM (beats per minute)', + 'TCM' => 'Composer', + 'TCO' => 'Content type', + 'TCOM' => 'Composer', + 'TCON' => 'Content type', + 'TCOP' => 'Copyright message', + 'TCR' => 'Copyright message', + 'TDA' => 'Date', + 'TDAT' => 'Date', + 'TDEN' => 'Encoding time', + 'TDLY' => 'Playlist delay', + 'TDOR' => 'Original release time', + 'TDRC' => 'Recording time', + 'TDRL' => 'Release time', + 'TDTG' => 'Tagging time', + 'TDY' => 'Playlist delay', + 'TEN' => 'Encoded by', + 'TENC' => 'Encoded by', + 'TEXT' => 'Lyricist/Text writer', + 'TFLT' => 'File type', + 'TFT' => 'File type', + 'TIM' => 'Time', + 'TIME' => 'Time', + 'TIPL' => 'Involved people list', + 'TIT1' => 'Content group description', + 'TIT2' => 'Title/songname/content description', + 'TIT3' => 'Subtitle/Description refinement', + 'TKE' => 'Initial key', + 'TKEY' => 'Initial key', + 'TLA' => 'Language(s)', + 'TLAN' => 'Language(s)', + 'TLE' => 'Length', + 'TLEN' => 'Length', + 'TMCL' => 'Musician credits list', + 'TMED' => 'Media type', + 'TMOO' => 'Mood', + 'TMT' => 'Media type', + 'TOA' => 'Original artist(s)/performer(s)', + 'TOAL' => 'Original album/movie/show title', + 'TOF' => 'Original filename', + 'TOFN' => 'Original filename', + 'TOL' => 'Original Lyricist(s)/text writer(s)', + 'TOLY' => 'Original lyricist(s)/text writer(s)', + 'TOPE' => 'Original artist(s)/performer(s)', + 'TOR' => 'Original release year', + 'TORY' => 'Original release year', + 'TOT' => 'Original album/Movie/Show title', + 'TOWN' => 'File owner/licensee', + 'TP1' => 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group', + 'TP2' => 'Band/Orchestra/Accompaniment', + 'TP3' => 'Conductor/Performer refinement', + 'TP4' => 'Interpreted, remixed, or otherwise modified by', + 'TPA' => 'Part of a set', + 'TPB' => 'Publisher', + 'TPE1' => 'Lead performer(s)/Soloist(s)', + 'TPE2' => 'Band/orchestra/accompaniment', + 'TPE3' => 'Conductor/performer refinement', + 'TPE4' => 'Interpreted, remixed, or otherwise modified by', + 'TPOS' => 'Part of a set', + 'TPRO' => 'Produced notice', + 'TPUB' => 'Publisher', + 'TRC' => 'ISRC (International Standard Recording Code)', + 'TRCK' => 'Track number/Position in set', + 'TRD' => 'Recording dates', + 'TRDA' => 'Recording dates', + 'TRK' => 'Track number/Position in set', + 'TRSN' => 'Internet radio station name', + 'TRSO' => 'Internet radio station owner', + 'TSI' => 'Size', + 'TSIZ' => 'Size', + 'TSOA' => 'Album sort order', + 'TSOP' => 'Performer sort order', + 'TSOT' => 'Title sort order', + 'TSRC' => 'ISRC (international standard recording code)', + 'TSS' => 'Software/hardware and settings used for encoding', + 'TSSE' => 'Software/Hardware and settings used for encoding', + 'TSST' => 'Set subtitle', + 'TT1' => 'Content group description', + 'TT2' => 'Title/Songname/Content description', + 'TT3' => 'Subtitle/Description refinement', + 'TXT' => 'Lyricist/text writer', + 'TXX' => 'User defined text information frame', + 'TXXX' => 'User defined text information frame', + 'TYE' => 'Year', + 'TYER' => 'Year', + 'UFI' => 'Unique file identifier', + 'UFID' => 'Unique file identifier', + 'ULT' => 'Unsychronised lyric/text transcription', + 'USER' => 'Terms of use', + 'USLT' => 'Unsynchronised lyric/text transcription', + 'WAF' => 'Official audio file webpage', + 'WAR' => 'Official artist/performer webpage', + 'WAS' => 'Official audio source webpage', + 'WCM' => 'Commercial information', + 'WCOM' => 'Commercial information', + 'WCOP' => 'Copyright/Legal information', + 'WCP' => 'Copyright/Legal information', + 'WOAF' => 'Official audio file webpage', + 'WOAR' => 'Official artist/performer webpage', + 'WOAS' => 'Official audio source webpage', + 'WORS' => 'Official Internet radio station homepage', + 'WPAY' => 'Payment', + 'WPB' => 'Publishers official webpage', + 'WPUB' => 'Publishers official webpage', + 'WXX' => 'User defined URL link frame', + 'WXXX' => 'User defined URL link frame', + 'TFEA' => 'Featured Artist', + 'TSTU' => 'Recording Studio', + 'rgad' => 'Replay Gain Adjustment' + ); + + return @$lookup[$frame_name]; + + // Last three: + // from Helium2 [www.helium2.com] + // from http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html + } + + + public static function FrameNameShortLookup($frame_name) { + + static $lookup = array ( + 'COM' => 'comment', + 'COMM' => 'comment', + 'TAL' => 'album', + 'TALB' => 'album', + 'TBP' => 'bpm', + 'TBPM' => 'bpm', + 'TCM' => 'composer', + 'TCO' => 'genre', + 'TCOM' => 'composer', + 'TCON' => 'genre', + 'TCOP' => 'copyright', + 'TCR' => 'copyright', + 'TEN' => 'encoded_by', + 'TENC' => 'encoded_by', + 'TEXT' => 'lyricist', + 'TIT1' => 'description', + 'TIT2' => 'title', + 'TIT3' => 'subtitle', + 'TLA' => 'language', + 'TLAN' => 'language', + 'TLE' => 'length', + 'TLEN' => 'length', + 'TMOO' => 'mood', + 'TOA' => 'original_artist', + 'TOAL' => 'original_album', + 'TOF' => 'original_filename', + 'TOFN' => 'original_filename', + 'TOL' => 'original_lyricist', + 'TOLY' => 'original_lyricist', + 'TOPE' => 'original_artist', + 'TOT' => 'original_album', + 'TP1' => 'artist', + 'TP2' => 'band', + 'TP3' => 'conductor', + 'TP4' => 'remixer', + 'TPB' => 'publisher', + 'TPE1' => 'artist', + 'TPE2' => 'band', + 'TPE3' => 'conductor', + 'TPE4' => 'remixer', + 'TPUB' => 'publisher', + 'TRC' => 'isrc', + 'TRCK' => 'track', + 'TRK' => 'track', + 'TSI' => 'size', + 'TSIZ' => 'size', + 'TSRC' => 'isrc', + 'TSS' => 'encoder_settings', + 'TSSE' => 'encoder_settings', + 'TSST' => 'subtitle', + 'TT1' => 'description', + 'TT2' => 'title', + 'TT3' => 'subtitle', + 'TXT' => 'lyricist', + 'TXX' => 'text', + 'TXXX' => 'text', + 'TYE' => 'year', + 'TYER' => 'year', + 'UFI' => 'unique_file_identifier', + 'UFID' => 'unique_file_identifier', + 'ULT' => 'unsychronised_lyric', + 'USER' => 'terms_of_use', + 'USLT' => 'unsynchronised lyric', + 'WAF' => 'url_file', + 'WAR' => 'url_artist', + 'WAS' => 'url_source', + 'WCOP' => 'copyright', + 'WCP' => 'copyright', + 'WOAF' => 'url_file', + 'WOAR' => 'url_artist', + 'WOAS' => 'url_source', + 'WORS' => 'url_station', + 'WPB' => 'url_publisher', + 'WPUB' => 'url_publisher', + 'WXX' => 'url_user', + 'WXXX' => 'url_user', + 'TFEA' => 'featured_artist', + 'TSTU' => 'studio' + ); + + return @$lookup[$frame_name]; + } + + + + public static function TextEncodingTerminatorLookup($encoding) { + + // http://www.id3.org/id3v2.4.0-structure.txt + // Frames that allow different types of text encoding contains a text encoding description byte. Possible encodings: + // $00 ISO-8859-1. Terminated with $00. + // $01 UTF-16 encoded Unicode with BOM. All strings in the same frame SHALL have the same byteorder. Terminated with $00 00. + // $02 UTF-16BE encoded Unicode without BOM. Terminated with $00 00. + // $03 UTF-8 encoded Unicode. Terminated with $00. + + static $lookup = array ( + 0 => "\x00", + 1 => "\x00\x00", + 2 => "\x00\x00", + 3 => "\x00", + 255 => "\x00\x00" + ); + + return @$lookup[$encoding]; + } + + + + public static function IsValidID3v2FrameName($frame_name, $id3v2_major_version) { + + switch ($id3v2_major_version) { + case 2: + return preg_match('/[A-Z][A-Z0-9]{2}/', $frame_name); + + case 3: + case 4: + return preg_match('/[A-Z][A-Z0-9]{3}/', $frame_name); + } + return false; + } + + + + public static function IsValidDateStampString($date_stamp) { + + if (strlen($date_stamp) != 8) { + return false; + } + if ((int)$date_stamp) { + return false; + } + + $year = substr($date_stamp, 0, 4); + $month = substr($date_stamp, 4, 2); + $day = substr($date_stamp, 6, 2); + if (!$year || !$month || !$day || $month > 12 || $day > 31 ) { + return false; + } + if (($day > 30) && (($month == 4) || ($month == 6) || ($month == 9) || ($month == 11))) { + return false; + } + if (($day > 29) && ($month == 2)) { + return false; + } + return true; + } + + + + public static function array_merge_noclobber($array1, $array2) { + if (!is_array($array1) || !is_array($array2)) { + return false; + } + $newarray = $array1; + foreach ($array2 as $key => $val) { + if (is_array($val) && isset($newarray[$key]) && is_array($newarray[$key])) { + $newarray[$key] = getid3_id3v2::array_merge_noclobber($newarray[$key], $val); + } elseif (!isset($newarray[$key])) { + $newarray[$key] = $val; + } + } + return $newarray; + } + + +} + +?> \ No newline at end of file diff --git a/modules/getid3/module.tag.lyrics3.php b/modules/getid3/module.tag.lyrics3.php new file mode 100644 index 00000000..b67f36d8 --- /dev/null +++ b/modules/getid3/module.tag.lyrics3.php @@ -0,0 +1,270 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | module.tag.lyrics3.php | +// | module for analyzing Lyrics3 tags | +// | dependencies: module.tag.apetag.php (optional) | +// +----------------------------------------------------------------------+ +// +// $Id: module.tag.lyrics3.php,v 1.5 2006/11/16 22:04:23 ah Exp $ + + +class getid3_lyrics3 extends getid3_handler +{ + + public function Analyze() { + + $getid3 = $this->getid3; + + fseek($getid3->fp, (0 - 128 - 9 - 6), SEEK_END); // end - ID3v1 - LYRICSEND - [Lyrics3size] + $lyrics3_id3v1 = fread($getid3->fp, 128 + 9 + 6); + $lyrics3_lsz = substr($lyrics3_id3v1, 0, 6); // Lyrics3size + $lyrics3_end = substr($lyrics3_id3v1, 6, 9); // LYRICSEND or LYRICS200 + $id3v1_tag = substr($lyrics3_id3v1, 15, 128); // ID3v1 + + // Lyrics3v1, ID3v1, no APE + if ($lyrics3_end == 'LYRICSEND') { + + $lyrics3_size = 5100; + $lyrics3_offset = filesize($getid3->filename) - 128 - $lyrics3_size; + $lyrics3_version = 1; + } + + // Lyrics3v2, ID3v1, no APE + elseif ($lyrics3_end == 'LYRICS200') { + + // LSZ = lyrics + 'LYRICSBEGIN'; add 6-byte size field; add 'LYRICS200' + $lyrics3_size = $lyrics3_lsz + 6 + strlen('LYRICS200'); + $lyrics3_offset = filesize($getid3->filename) - 128 - $lyrics3_size; + $lyrics3_version = 2; + } + + // Lyrics3v1, no ID3v1, no APE + elseif (substr(strrev($lyrics3_id3v1), 0, 9) == 'DNESCIRYL') { // strrev('LYRICSEND') = 'DNESCIRYL' + + $lyrics3_size = 5100; + $lyrics3_offset = filesize($getid3->filename) - $lyrics3_size; + $lyrics3_version = 1; + $lyrics3_offset = filesize($getid3->filename) - $lyrics3_size; + } + + // Lyrics3v2, no ID3v1, no APE + elseif (substr(strrev($lyrics3_id3v1), 0, 9) == '002SCIRYL') { // strrev('LYRICS200') = '002SCIRYL' + + $lyrics3_size = strrev(substr(strrev($lyrics3_id3v1), 9, 6)) + 15; // LSZ = lyrics + 'LYRICSBEGIN'; add 6-byte size field; add 'LYRICS200' // 15 = 6 + strlen('LYRICS200') + $lyrics3_offset = filesize($getid3->filename) - $lyrics3_size; + $lyrics3_version = 2; + } + + elseif (isset($getid3->info['ape']['tag_offset_start']) && ($getid3->info['ape']['tag_offset_start'] > 15)) { + + fseek($getid3->fp, $getid3->info['ape']['tag_offset_start'] - 15, SEEK_SET); + $lyrics3_lsz = fread($getid3->fp, 6); + $lyrics3_end = fread($getid3->fp, 9); + + + // Lyrics3v1, APE, maybe ID3v1 + if ($lyrics3_end == 'LYRICSEND') { + + $lyrics3_size = 5100; + $lyrics3_offset = $getid3->info['ape']['tag_offset_start'] - $lyrics3_size; + $getid3->info['avdataend'] = $lyrics3_offset; + $lyrics3_version = 1; + $getid3->warning('APE tag located after Lyrics3, will probably break Lyrics3 compatability'); + } + + + // Lyrics3v2, APE, maybe ID3v1 + elseif ($lyrics3_end == 'LYRICS200') { + + $lyrics3_size = $lyrics3_lsz + 15; // LSZ = lyrics + 'LYRICSBEGIN'; add 6-byte size field; add 'LYRICS200' + $lyrics3_offset = $getid3->info['ape']['tag_offset_start'] - $lyrics3_size; + $lyrics3_version = 2; + $getid3->warning('APE tag located after Lyrics3, will probably break Lyrics3 compatability'); + + } + } + + + //// GetLyrics3Data() + + + if (isset($lyrics3_offset)) { + + $getid3->info['avdataend'] = $lyrics3_offset; + + if ($lyrics3_size <= 0) { + return false; + } + + fseek($getid3->fp, $lyrics3_offset, SEEK_SET); + $raw_data = fread($getid3->fp, $lyrics3_size); + + if (substr($raw_data, 0, 11) != 'LYRICSBEGIN') { + if (strpos($raw_data, 'LYRICSBEGIN') !== false) { + + $getid3->warning('"LYRICSBEGIN" expected at '.$lyrics3_offset.' but actually found at '.($lyrics3_offset + strpos($raw_data, 'LYRICSBEGIN')).' - this is invalid for Lyrics3 v'.$lyrics3_version); + $getid3->info['avdataend'] = $lyrics3_offset + strpos($raw_data, 'LYRICSBEGIN'); + $parsed_lyrics3['tag_offset_start'] = $getid3->info['avdataend']; + $raw_data = substr($raw_data, strpos($raw_data, 'LYRICSBEGIN')); + $lyrics3_size = strlen($raw_data); + } + else { + throw new getid3_exception('"LYRICSBEGIN" expected at '.$lyrics3_offset.' but found "'.substr($raw_data, 0, 11).'" instead.'); + } + + } + + $parsed_lyrics3['raw']['lyrics3version'] = $lyrics3_version; + $parsed_lyrics3['raw']['lyrics3tagsize'] = $lyrics3_size; + $parsed_lyrics3['tag_offset_start'] = $lyrics3_offset; + $parsed_lyrics3['tag_offset_end'] = $lyrics3_offset + $lyrics3_size; + + switch ($lyrics3_version) { + + case 1: + if (substr($raw_data, strlen($raw_data) - 9, 9) == 'LYRICSEND') { + $parsed_lyrics3['raw']['LYR'] = trim(substr($raw_data, 11, strlen($raw_data) - 11 - 9)); + getid3_lyrics3::Lyrics3LyricsTimestampParse($parsed_lyrics3); + } + else { + throw new getid3_exception('"LYRICSEND" expected at '.(ftell($getid3->fp) - 11 + $lyrics3_size - 9).' but found "'.substr($raw_data, strlen($raw_data) - 9, 9).'" instead.'); + } + break; + + case 2: + if (substr($raw_data, strlen($raw_data) - 9, 9) == 'LYRICS200') { + $parsed_lyrics3['raw']['unparsed'] = substr($raw_data, 11, strlen($raw_data) - 11 - 9 - 6); // LYRICSBEGIN + LYRICS200 + LSZ + $raw_data = $parsed_lyrics3['raw']['unparsed']; + while (strlen($raw_data) > 0) { + $fieldname = substr($raw_data, 0, 3); + $fieldsize = (int)substr($raw_data, 3, 5); + $parsed_lyrics3['raw'][$fieldname] = substr($raw_data, 8, $fieldsize); + $raw_data = substr($raw_data, 3 + 5 + $fieldsize); + } + + if (isset($parsed_lyrics3['raw']['IND'])) { + $i = 0; + foreach (array ('lyrics', 'timestamps', 'inhibitrandom') as $flagname) { + if (strlen($parsed_lyrics3['raw']['IND']) > ++$i) { + $parsed_lyrics3['flags'][$flagname] = getid3_lyrics3::IntString2Bool(substr($parsed_lyrics3['raw']['IND'], $i, 1)); + } + } + } + + foreach (array ('ETT'=>'title', 'EAR'=>'artist', 'EAL'=>'album', 'INF'=>'comment', 'AUT'=>'author') as $key => $value) { + if (isset($parsed_lyrics3['raw'][$key])) { + $parsed_lyrics3['comments'][$value][] = trim($parsed_lyrics3['raw'][$key]); + } + } + + if (isset($parsed_lyrics3['raw']['IMG'])) { + foreach (explode("\r\n", $parsed_lyrics3['raw']['IMG']) as $key => $image_string) { + if (strpos($image_string, '||') !== false) { + $imagearray = explode('||', $image_string); + $parsed_lyrics3['images'][$key]['filename'] = @$imagearray[0]; + $parsed_lyrics3['images'][$key]['description'] = @$imagearray[1]; + $parsed_lyrics3['images'][$key]['timestamp'] = getid3_lyrics3::Lyrics3Timestamp2Seconds(@$imagearray[2]); + } + } + } + + if (isset($parsed_lyrics3['raw']['LYR'])) { + getid3_lyrics3::Lyrics3LyricsTimestampParse($parsed_lyrics3); + } + } + else { + throw new getid3_exception('"LYRICS200" expected at '.(ftell($getid3->fp) - 11 + $lyrics3_size - 9).' but found "'.substr($raw_data, strlen($raw_data) - 9, 9).'" instead.'); + } + break; + + default: + throw new getid3_exception('Cannot process Lyrics3 version '.$lyrics3_version.' (only v1 and v2)'); + } + + if (isset($getid3->info['id3v1']['tag_offset_start']) && ($getid3->info['id3v1']['tag_offset_start'] < $parsed_lyrics3['tag_offset_end'])) { + $getid3->warning('ID3v1 tag information ignored since it appears to be a false synch in Lyrics3 tag data'); + unset($getid3->info['id3v1']); + } + + $getid3->info['lyrics3'] = $parsed_lyrics3; + + + // Check for APE tag after lyrics3 + if (!@$getid3->info['ape'] && $getid3->option_tag_apetag && class_exists('getid3_apetag')) { + $apetag = new getid3_apetag($getid3); + $apetag->option_override_end_offset = $getid3->info['lyrics3']['tag_offset_start']; + $apetag->Analyze(); + } + } + + return true; + } + + + + + public static function Lyrics3Timestamp2Seconds($rawtimestamp) { + if (ereg('^\\[([0-9]{2}):([0-9]{2})\\]$', $rawtimestamp, $regs)) { + return (int)(($regs[1] * 60) + $regs[2]); + } + return false; + } + + + + public static function Lyrics3LyricsTimestampParse(&$lyrics3_data) { + + $lyrics_array = explode("\r\n", $lyrics3_data['raw']['LYR']); + foreach ($lyrics_array as $key => $lyric_line) { + + while (ereg('^(\\[[0-9]{2}:[0-9]{2}\\])', $lyric_line, $regs)) { + $this_line_timestamps[] = getid3_lyrics3::Lyrics3Timestamp2Seconds($regs[0]); + $lyric_line = str_replace($regs[0], '', $lyric_line); + } + $no_timestamp_lyrics_array[$key] = $lyric_line; + if (@is_array($this_line_timestamps)) { + sort($this_line_timestamps); + foreach ($this_line_timestamps as $timestampkey => $timestamp) { + if (isset($lyrics3_data['synchedlyrics'][$timestamp])) { + // timestamps only have a 1-second resolution, it's possible that multiple lines + // could have the same timestamp, if so, append + $lyrics3_data['synchedlyrics'][$timestamp] .= "\r\n".$lyric_line; + } else { + $lyrics3_data['synchedlyrics'][$timestamp] = $lyric_line; + } + } + } + unset($this_line_timestamps); + $regs = array (); + } + $lyrics3_data['unsynchedlyrics'] = implode("\r\n", $no_timestamp_lyrics_array); + if (isset($lyrics3_data['synchedlyrics']) && is_array($lyrics3_data['synchedlyrics'])) { + ksort($lyrics3_data['synchedlyrics']); + } + return true; + } + + + + public static function IntString2Bool($char) { + + return $char == '1' ? true : ($char == '0' ? false : null); + } +} + + +?> \ No newline at end of file diff --git a/modules/getid3/write.apetag.php b/modules/getid3/write.apetag.php new file mode 100644 index 00000000..07b0485f --- /dev/null +++ b/modules/getid3/write.apetag.php @@ -0,0 +1,264 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | write.apetag.php | +// | writing module for ape tags | +// | dependencies: module.tag.apetag.php | +// | dependencies: module.tag.id3v1.php | +// | dependencies: module.tag.lyrics3.php | +// +----------------------------------------------------------------------+ +// +// $Id: write.apetag.php,v 1.9 2006/11/20 16:13:31 ah Exp $ + + +class getid3_write_apetag extends getid3_handler_write +{ + + public $comments; + + + public function read() { + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.apetag'); + + $tag = new getid3_apetag($engine); + $tag->Analyze(); + + if (!isset($engine->info['ape']['comments'])) { + return; + } + + $this->comments = $engine->info['ape']['comments']; + + // convert single element arrays to string + foreach ($this->comments as $key => $value) { + if (sizeof($value) == 1) { + $this->comments[$key] = $value[0]; + } + } + + return true; + } + + + public function write() { + + // remove existing apetag + $this->remove(); + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.id3v1'); + $engine->include_module('tag.lyrics3'); + + $tag = new getid3_id3v1($engine); + $tag->Analyze(); + + $tag = new getid3_lyrics3($engine); + $tag->Analyze(); + + $apetag = $this->generate_tag(); + + if (!$fp = @fopen($this->filename, 'a+b')) { + throw new getid3_exception('Could not open a+b: ' . $this->filename); + } + + // init: audio ends at eof + $post_audio_offset = filesize($this->filename); + + // lyrics3 tag present + if (@$engine->info['lyrics3']['tag_offset_start']) { + + // audio ends before lyrics3 tag + $post_audio_offset = @$engine->info['lyrics3']['tag_offset_start']; + } + + // id3v1 tag present + elseif (@$engine->info['id3v1']['tag_offset_start']) { + + // audio ends before id3v1 tag + $post_audio_offset = $engine->info['id3v1']['tag_offset_start']; + } + + // seek to end of audio data + fseek($fp, $post_audio_offset, SEEK_SET); + + // save data after audio data + $post_audio_data = ''; + if (filesize($this->filename) > $post_audio_offset) { + $post_audio_data = fread($fp, filesize($this->filename) - $post_audio_offset); + } + + // truncate file before start of new apetag + fseek($fp, $post_audio_offset, SEEK_SET); + ftruncate($fp, ftell($fp)); + + // write new apetag + fwrite($fp, $apetag, strlen($apetag)); + + // rewrite data after audio + if (!empty($post_audio_data)) { + fwrite($fp, $post_audio_data, strlen($post_audio_data)); + } + + fclose($fp); + clearstatcache(); + + return true; + } + + + public function remove() { + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.apetag'); + + $tag = new getid3_apetag($engine); + $tag->Analyze(); + + if (isset($engine->info['ape']['tag_offset_start']) && isset($engine->info['ape']['tag_offset_end'])) { + + if (!$fp = @fopen($this->filename, 'a+b')) { + throw new getid3_exception('Could not open a+b: ' . $this->filename); + } + + // get data after apetag + if (filesize($this->filename) > $engine->info['ape']['tag_offset_end']) { + fseek($fp, $engine->info['ape']['tag_offset_end'], SEEK_SET); + $data_after_ape = fread($fp, filesize($this->filename) - $engine->info['ape']['tag_offset_end']); + } + + // truncate file before start of apetag + ftruncate($fp, $engine->info['ape']['tag_offset_start']); + + // rewrite data after apetag + if (isset($data_after_ape)) { + fseek($fp, $engine->info['ape']['tag_offset_start'], SEEK_SET); + fwrite($fp, $data_after_ape, strlen($data_after_ape)); + } + + fclose($fp); + clearstatcache(); + } + + // success when removing non-existant tag + return true; + } + + + protected function generate_tag() { + + // NOTE: All data passed to this function must be UTF-8 format + + $items = array(); + if (!is_array($this->comments)) { + throw new getid3_exception('Cannot write empty tag, use remove() instead.'); + } + + foreach ($this->comments as $key => $values) { + + // http://www.personal.uni-jena.de/~pfk/mpp/sv8/apekey.html + // A case-insensitive vobiscomment field name that may consist of ASCII 0x20 through 0x7E. + // ASCII 0x41 through 0x5A inclusive (A-Z) is to be considered equivalent to ASCII 0x61 through 0x7A inclusive (a-z). + if (preg_match("/[^\x20-\x7E]/", $key)) { + throw new getid3_exception('Field name "' . $key . '" contains invalid character(s).'); + } + + $key = strtolower($key); + + // convert single value comment to array + if (!is_array($values)) { + $values = array ($values); + } + + $value_array = array (); + foreach ($values as $value) { + $value_array[] = str_replace("\x00", '', $value); + } + $value_string = implode("\x00", $value_array); + + // length of the assigned value in bytes + $tag_item = getid3_lib::LittleEndian2String(strlen($value_string), 4); + + $tag_item .= "\x00\x00\x00\x00" . $key . "\x00" . $value_string; + + $items[] = $tag_item; + } + + return $this->generate_header_footer($items, true) . implode('', $items) . $this->generate_header_footer($items, false); + } + + + protected function generate_header_footer(&$items, $is_header=false) { + + $comments_length = 0; + foreach ($items as $item_data) { + $comments_length += strlen($item_data); + } + + $header = 'APETAGEX'; + $header .= getid3_lib::LittleEndian2String(2000, 4); + $header .= getid3_lib::LittleEndian2String(32 + $comments_length, 4); + $header .= getid3_lib::LittleEndian2String(count($items), 4); + $header .= $this->generate_flags(true, true, $is_header, 0, false); + $header .= str_repeat("\x00", 8); + + return $header; + } + + + protected function generate_flags($header=true, $footer=true, $is_header=false, $encoding_id=0, $read_only=false) { + + $flags = array_fill(0, 4, 0); + + // Tag contains a header + if ($header) { + $flags[0] |= 0x80; + } + + // Tag contains no footer + if (!$footer) { + $flags[0] |= 0x40; + } + + // This is the header, not the footer + if ($is_header) { + $flags[0] |= 0x20; + } + + // 0: Item contains text information coded in UTF-8 + // 1: Item contains binary information °) + // 2: Item is a locator of external stored information °°) + // 3: reserved + $flags[3] |= ($encoding_id << 1); + + // Tag or Item is Read Only + if ($read_only) { + $flags[3] |= 0x01; + } + + return chr($flags[3]).chr($flags[2]).chr($flags[1]).chr($flags[0]); + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/write.flac.php b/modules/getid3/write.flac.php new file mode 100644 index 00000000..f874c983 --- /dev/null +++ b/modules/getid3/write.flac.php @@ -0,0 +1,155 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | write.flac.php | +// | writing module for flac tags | +// | dependencies: metaflac binary. | +// +----------------------------------------------------------------------+ +// +// $Id: write.flac.php,v 1.9 2006/12/03 20:02:25 ah Exp $ + + +class getid3_write_flac extends getid3_handler_write +{ + + public $comments = array (); + + + public function __construct($filename) { + + if (ini_get('safe_mode')) { + throw new getid3_exception('PHP running in Safe Mode (backtick operator not available). Cannot call metaflac binary.'); + } + + static $initialized; + if (!$initialized) { + + // check existance and version of metaflac + if (!ereg('^metaflac ([0-9]+\.[0-9]+\.[0-9]+)', `metaflac --version`, $r)) { + throw new getid3_exception('Fatal: metaflac binary not available.'); + } + if (strnatcmp($r[1], '1.1.1') == -1) { + throw new getid3_exception('Fatal: metaflac version 1.1.1 or newer is required, available version: ' . $r[1] . '.'); + } + + $initialized = true; + } + + parent::__construct($filename); + } + + + public function read() { + + // read info with metaflac + if (!$info = trim(`metaflac --no-utf8-convert --export-tags-to=- "$this->filename"`)) { + return; + } + + // process info + foreach (explode("\n", $info) as $line) { + + $pos = strpos($line, '='); + + $key = strtolower(substr($line, 0, $pos)); + $value = substr($line, $pos+1); + + $this->comments[$key][] = $value; + } + + // convert single element arrays to string + foreach ($this->comments as $key => $value) { + if (sizeof($value) == 1) { + $this->comments[$key] = $value[0]; + } + } + + return true; + } + + + public function write() { + + // create temp file with new comments + $temp_filename = tempnam('*', 'getID3'); + if (!$fp = @fopen($temp_filename, 'wb')) { + throw new getid3_exception('Could not write temporary file.'); + } + fwrite($fp, $this->generate_tag()); + fclose($fp); + + // write comments + $this->save_permissions(); + if ($error = `metaflac --no-utf8-convert --remove-all-tags --import-tags-from="$temp_filename" "$this->filename" 2>&1`) { + throw new getid3_exception('Fatal: metaflac returned error: ' . $error); + } + $this->restore_permissions(); + + // success + @unlink($temp_filename); + return true; + } + + + protected function generate_tag() { + + if (!$this->comments) { + throw new getid3_exception('Cannot write empty tag, use remove() instead.'); + } + + $result = ''; + + foreach ($this->comments as $key => $values) { + + // A case-insensitive FLAC field name that may consist of ASCII 0x20 through 0x7D, 0x3D ('=') excluded. + // ASCII 0x41 through 0x5A inclusive (A-Z) is to be considered equivalent to ASCII 0x61 through 0x7A inclusive (a-z). + if (preg_match("/[^\x20-\x7D]|\x3D/", $key)) { + throw new getid3_exception('Field name "' . $key . '" contains invalid character(s).'); + } + + $key = strtolower($key); + + if (!is_array($values)) { + $values = array ($values); + } + + foreach ($values as $value) { + if (strstr($value, "\n") || strstr($value, "\r")) { + throw new getid3_exception('Multi-line comments not supported (value contains \n or \r)'); + } + $result .= $key . '=' . $value . "\n"; + } + } + + return $result; + } + + + public function remove() { + + $this->save_permissions(); + if ($error = `metaflac --remove-all-tags "$this->filename" 2>&1`) { + throw new getid3_exception('Fatal: metaflac returned error: ' . $error); + } + $this->restore_permissions(); + + // success when removing non-existant tag + return true; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/write.id3v1.php b/modules/getid3/write.id3v1.php new file mode 100644 index 00000000..50f084ab --- /dev/null +++ b/modules/getid3/write.id3v1.php @@ -0,0 +1,156 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | write.id3v1.php | +// | writing module for id3v1 tags | +// | dependencies: module.tag.id3v1.php. | +// +----------------------------------------------------------------------+ +// +// $Id: write.id3v1.php,v 1.15 2006/11/20 16:09:33 ah Exp $ + + + +class getid3_write_id3v1 extends getid3_handler_write +{ + public $title; + public $artist; + public $album; + public $year; + public $genre_id; + public $genre; + public $comment; + public $track; + + + public function read() { + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.id3v1'); + + $tag = new getid3_id3v1($engine); + $tag->Analyze(); + + if (!isset($engine->info['id3v1'])) { + return; + } + + $this->title = $engine->info['id3v1']['title']; + $this->artist = $engine->info['id3v1']['artist']; + $this->album = $engine->info['id3v1']['album']; + $this->year = $engine->info['id3v1']['year']; + $this->genre_id = $engine->info['id3v1']['genre_id']; + $this->genre = $engine->info['id3v1']['genre']; + $this->comment = $engine->info['id3v1']['comment']; + $this->track = $engine->info['id3v1']['track']; + + return true; + } + + + public function write() { + + if (!$fp = @fopen($this->filename, 'r+b')) { + throw new getid3_exception('Could not open r+b: ' . $this->filename); + } + + // seek to end minus 128 bytes + fseek($fp, -128, SEEK_END); + + // overwrite existing ID3v1 tag + if (fread($fp, 3) == 'TAG') { + fseek($fp, -128, SEEK_END); + } + + // append new ID3v1 tag + else { + fseek($fp, 0, SEEK_END); + } + + fwrite($fp, $this->generate_tag(), 128); + + fclose($fp); + clearstatcache(); + + return true; + } + + + protected function generate_tag() { + + $result = 'TAG'; + $result .= str_pad(trim(substr($this->title, 0, 30)), 30, "\x00", STR_PAD_RIGHT); + $result .= str_pad(trim(substr($this->artist, 0, 30)), 30, "\x00", STR_PAD_RIGHT); + $result .= str_pad(trim(substr($this->album, 0, 30)), 30, "\x00", STR_PAD_RIGHT); + $result .= str_pad(trim(substr($this->year, 0, 4)), 4, "\x00", STR_PAD_LEFT); + + if (!empty($this->track) && ($this->track > 0) && ($this->track <= 255)) { + + $result .= str_pad(trim(substr($this->comment, 0, 28)), 28, "\x00", STR_PAD_RIGHT); + $result .= "\x00"; + $result .= chr($this->track); + } + else { + $result .= str_pad(trim(substr($comment, 0, 30)), 30, "\x00", STR_PAD_RIGHT); + } + + // both genre and genre_id set + if ($this->genre && $this->genre_id) { + if ($this->genre != getid3_id3v1::LookupGenreName($this->genre_id)) { + throw new getid3_exception('Genre and genre_id does not match. Unset one and the other will be determined automatically.'); + } + } + + // only genre set + elseif ($this->genre) { + $this->genre_id = getid3_id3v1::LookupGenreID($this->genre); + } + + // only genre_id set + else { + if ($this->genre_id < 0 || $this->genre_id > 147) { + $this->genre_id = 255; // 'unknown' genre + } + $this->genre = getid3_id3v1::LookupGenreName($this->genre_id); + } + + $result .= chr(intval($this->genre_id)); + + return $result; + } + + + public function remove() { + + if (!$fp = @fopen($this->filename, 'r+b')) { + throw new getid3_exception('Could not open r+b: ' . $filename); + } + + fseek($fp, -128, SEEK_END); + if (fread($fp, 3) == 'TAG') { + ftruncate($fp, filesize($this->filename) - 128); + fclose($fp); + clearstatcache(); + } + + // success when removing non-existant tag + return true; + } + +} + +?> \ No newline at end of file diff --git a/modules/getid3/write.id3v2.php b/modules/getid3/write.id3v2.php new file mode 100644 index 00000000..f122b6b0 --- /dev/null +++ b/modules/getid3/write.id3v2.php @@ -0,0 +1,1886 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | write.id3v1.php | +// | writing module for id3v1 tags | +// | dependencies: module.tag.id3v1.php. | +// +----------------------------------------------------------------------+ +// +// $Id: write.id3v2.php,v 1.9 2006/12/25 23:44:23 ah Exp $ + + + +class getid3_write_id3v2 extends getid3_handler_write +{ + // NOTE: This module ONLY writes tags in UTF-8. All strings must be UTF-8 encoded. + + // For multiple values, specify "array of type" instead of type for all T??? and IPLS params except TXXX. + /**2.4 + // For multiple values, specify "array of type" instead of type for all T??? params except TXXX. + */ + + + // Identification frames + public $content_group_description; // TIT1 string + public $title; // TIT2 string + public $subtitle; // TIT3 string + public $album; // TALB string + public $original_album_title; // TOAL string + public $track; // TRCK integer or "integer/integer" e.g. "10/12" + public $part_of_set; // TPOS integer or "integer/integer" e.g. "10/12" + public $isrc; // TSRC string + + // Involved persons frames + public $artist; // TPE1 string + public $band; // TPE2 string + public $conductor; // TPE3 string + public $remixer; // TPE4 string + public $original_artist; // TOPE string + public $lyricist; // TEXT string + public $original_lyricist; // TOLY string + public $composer; // TCOM string + public $encoded_by; // TENC string + + // Derived and subjective properties frames + public $beats_per_minute; // TBPM integer + public $length; // TLEN integer + public $initial_key; // TKEY string + public $language; // TLAN string - ISO-639-2 + public $genre; // TCON string or integer + public $file_type; // TFLT string + public $media_type; // TMED string + + // Rights and license frames + public $copyright; // TCOP string - must begin with YEAR and a space + public $date; // TDAT string - DDMM + public $year; // TYER string - YYYY + public $original_release_year; // TORY string - YYYY + public $recording_dates; // TRDA string + public $time; // TIME string - HHMM + public $publisher; // TPUB string + public $file_owner; // TOWN string + public $internet_radio_station_name; // TRSN string + public $internet_radio_station_owner; // TRSO string + public $involved_people_list; // IPLS string + + // Other text frames + public $original_filename; // TOFN string + public $playlist_delay; // TDLY integer + public $encoder_settings; // TSSE string + + // User defined text information frame + public $user_text; // TXXX array of ( unique_description(string) => value(string) ) + + // Comments + public $comment; // COMM + + // URL link frames - details + public $commercial_information; // WCOM url(string) + public $copyright_information; // WCOP url(string) + public $url_file; // WOAF url(string) + public $url_artist; // WOAR url(string) + public $url_source; // WOAS url(string) + public $url_station; // WORS url(string) + public $payment; // WPAY url(string) + public $url_publisher; // WPUB url(string) + + // User defined URL link frame + public $url_user; // WXXX array of ( unique_description(string) => url(string) ) + + + // Unique file identifier + public $unique_file_identifier; // UFID + + // Music CD identifier + public $music_cd_identifier; // MCDI + + // Event timing codes + public $event_timing_codes; // ETCO + + // MPEG location lookup table + public $mpeg_location_lookup_table; // MLLT + + // Synchronised tempo codes + public $synchronised_tempo_codes; // SYTC + + // Unsynchronised lyrics/text transcription + public $unsynchronised_lyrics; // USLT + + // Synchronised lyrics/text + public $synchronised_lyrics; // SYLT + + // Relative volume adjustment (1) + public $relative_volume_adjustment; // RVAD + + // Equalisation (1) + public $equalisation; // EQUA + + // Reverb + public $reverb; // RVRB + + // Attached picture + public $attached_picture; // APIC + + // General encapsulated object + public $general_encapsulated_object; // GEOB + + // Play counter + public $play_counter; // PCNT + + // Popularimeter + public $popularimeter; // POPM + + // Recommended buffer size + public $recommended_buffer_size; // RBUF + + // Audio encryption + public $audio_encryption; // AENC + + // Linked information + public $linked_information; // LINK + + // Position synchronisation frame + public $position_synchronisation; // POSS + + // Terms of use frame + public $terms_of_use; // USER + + // Ownership frame + public $ownership; // OWNE + + // Commercial frame + public $commercial; // COMR + + // Encryption method registration + public $encryption_method_registration; // ENCR + + // Group identification registration + public $group_identification_registration; // GRID + + // Private frame + public $private; // PRIV + + + /**2.4 + // Identification frames + public $content_group_description; // TIT1 string + public $title; // TIT2 string + public $subtitle; // TIT3 string + public $album; // TALB string + public $original_album_title; // TOAL string + public $track; // TRCK integer or "integer/integer" e.g. "10/12" + public $part_of_set; // TPOS integer or "integer/integer" e.g. "10/12" + public $set_subtitle; // TSST string + public $isrc; // TSRC string + + // Involved persons frames + public $artist; // TPE1 string + public $band; // TPE2 string + public $conductor; // TPE3 string + public $remixer; // TPE4 string + public $original_artist; // TOPE string + public $lyricist; // TEXT string + public $original_lyricist; // TOLY string + public $composer; // TCOM string + public $musician_credits_list; // TMCL string + public $involved_people_list; // TIPL string + public $encoded_by; // TENC string + + // Derived and subjective properties frames + public $beats_per_minute; // TBPM integer + public $length; // TLEN integer + public $initial_key; // TKEY string + public $language; // TLAN string - ISO-639-2 + public $genre; // TCON string or integer + public $file_type; // TFLT string + public $media_type; // TMED string + public $mood; // TMOO string + + // Rights and license frames + public $copyright; // TCOP string - must begin with YEAR and a space + // TPRO strign - must begin with YEAR and a space + public $publisher; // TPUB string + public $file_owner; // TOWN string + public $internet_radio_station_name; // TRSN string + public $internet_radio_station_owner; // TRSO string + + // Other text frames + public $original_filename; // TOFN string + public $playlist_delay; // TDLY integer + public $encoding_time; // TDEN timestamp(string) - yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddTHH, yyyy-MM-ddTHH:mm, yyyy-MM-ddTHH:mm:ss. All time stamps are UTC. + public $original_release_time; // TDOR timestamp(string) - yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddTHH, yyyy-MM-ddTHH:mm, yyyy-MM-ddTHH:mm:ss. All time stamps are UTC. + public $recording_time; // TDRC timestamp(string) - yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddTHH, yyyy-MM-ddTHH:mm, yyyy-MM-ddTHH:mm:ss. All time stamps are UTC. + public $release_time; // TDRL timestamp(string) - yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddTHH, yyyy-MM-ddTHH:mm, yyyy-MM-ddTHH:mm:ss. All time stamps are UTC. + public $tagging_time; // TDTG timestamp(string) - yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddTHH, yyyy-MM-ddTHH:mm, yyyy-MM-ddTHH:mm:ss. All time stamps are UTC. + public $encoder_settings; // TSSE string + public $album_sort_order; // TSOA string + public $performer_sort_order; // TSOP string + public $title_sort_order; // TSOT string + + // User defined text information frame + public $user_text; // TXXX array of ( unique_description(string) => value(string) ) + + // Comments + public $comment; // COMM + + // URL link frames - details + public $commercial_information; // WCOM url(string) + public $copyright_information; // WCOP url(string) + public $url_file; // WOAF url(string) + public $url_artist; // WOAR url(string) + public $url_source; // WOAS url(string) + public $url_station; // WORS url(string) + public $payment; // WPAY url(string) + public $url_publisher; // WPUB url(string) + + // User defined URL link frame + public $url_user; // WXXX array of ( unique_description(string) => url(string) ) + + + // Unique file identifier + public $unique_file_identifier; // UFID + + // Music CD identifier + public $music_cd_identifier; // MCDI + + // Event timing codes + public $event_timing_codes; // ETCO + + // MPEG location lookup table + public $mpeg_location_lookup_table; // MLLT + + // Synchronised tempo codes + public $synchronised_tempo_codes; // SYTC + + // Unsynchronised lyrics/text transcription + public $unsynchronised_lyrics; // USLT + + // Synchronised lyrics/text + public $synchronised_lyrics; // SYLT + + // Relative volume adjustment (2) + public $relative_volume_adjustment; // RVA2 + + // Equalisation (2) + public $equalisation; // EQU2 + + // Reverb + public $reverb; // RVRB + + // Attached picture + public $attached_picture; // APIC + + // General encapsulated object + public $general_encapsulated_object; // GEOB + + // Play counter + public $play_counter; // PCNT + + // Popularimeter + public $popularimeter; // POPM + + // Recommended buffer size + public $recommended_buffer_size; // RBUF + + // Audio encryption + public $audio_encryption; // AENC + + // Linked information + public $linked_information; // LINK + + // Position synchronisation frame + public $position_synchronisation; // POSS + + // Terms of use frame + public $terms_of_use; // USER + + // Ownership frame + public $ownership; // OWNE + + // Commercial frame + public $commercial; // COMR + + // Encryption method registration + public $encryption_method_registration; // ENCR + + // Group identification registration + public $group_identification_registration; // GRID + + // Private frame + public $private; // PRIV + + // Signature frame + public $signature; // SIGN + + // Seek frame + public $seek; // SEEK + + // Audio seek point index + public $audio_seek_point_index; // ASPI + */ + + + // internal logic + protected $padded_length = 4096; // minimum length of ID3v2 tag in bytes + protected $previous_frames = array (); + + const major_version = 3; + + + public function read() { + + } + + + public function write() { + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.id3v2'); + + $tag = new getid3_id3v2($engine); + $tag->Analyze(); + + if (!(int)@$engine->info['avdataoffset']) { + throw new getid3_exception('No audio data found.'); + } + + $this->padded_length = max(@$engine->info['id3v2']['headerlength'], $this->padded_length); + + $tag = $this->generate_tag(); + + // insert-overwrite existing tag (padded to length of old tag if neccesary) + if (@$engine->info['id3v2']['headerlength'] && ($engine->info['id3v2']['headerlength'] == strlen($tag))) { + + if (!$fp = fopen($this->filename, 'r+b')) { + throw new getid3_exception('Could not open '.$this->filename.' mode "r+b"'); + } + fwrite($fp, $tag, strlen($tag)); + fclose($fp); + } + + // rewrite file - no tag present or new tag longer than old tag + else + + if (!$fp_source = @fopen($this->filename, 'rb')) { + throw new getid3_exception('Could not open '.$this->filename.' mode "rb"'); + } + fseek($fp_source, $engine->info['avdataoffset'], SEEK_SET); + + if (!$fp_temp = @fopen($this->filename.'getid3tmp', 'w+b')) { + throw new getid3_exception('Could not open '.$this->filename.'getid3tmp mode "w+b"'); + } + + fwrite($fp, $tag, strlen($tag)); + + while ($buffer = fread($fp_source, 16384)) { + fwrite($fp_temp, $buffer, strlen($buffer)); + } + + fclose($fp_temp); + fclose($fp_source); + + $this->save_permissions(); + unlink($this->filename); + rename($this->filename.'getid3tmp', $this->filename); + $this->restore_permissions(); + } + + clearstatcache(); + + return true; + } + + + public function remove() { + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.id3v2'); + + $tag = new getid3_id3v2($engine); + $tag->Analyze(); + + if ((int)@$engine->info['avdataoffset']) { + + if (!$fp_source = @fopen($this->filename, 'rb')) { + throw new getid3_exception('Could not open '.$this->filename.' mode "rb"'); + } + fseek($fp_source, $engine->info['avdataoffset'], SEEK_SET); + + if (!$fp_temp = @fopen($this->filename.'getid3tmp', 'w+b')) { + throw new getid3_exception('Could not open '.$this->filename.'getid3tmp mode "w+b"'); + } + + while ($buffer = fread($fp_source, 16384)) { + fwrite($fp_temp, $buffer, strlen($buffer)); + } + + fclose($fp_temp); + fclose($fp_source); + + $this->save_permissions(); + unlink($this->filename); + rename($this->filename.'getid3tmp', $this->filename); + $this->restore_permissions(); + + clearstatcache(); + } + + // success when removing non-existant tag + return true; + } + + + protected function generate_tag() { + + $result = ''; + + $some_array = array ( + 'content_group_description' => 'TIT1', + 'title' => 'TIT2', + 'subtitle' => 'TIT3', + ); + + foreach ($some_array as $key => $frame_name) { + + + if ($frame_data = $this->generate_frame_data($frame_name, $this->$key)) { + + $frame_length = $this->BigEndian2String(strlen($frame_data), 4, false); + $frame_flags = $this->generate_frame_flags(); + } + + $result .= $frame_name.$frame_length.$frame_flags.$frame_data; + } + + + // calc padded length of tag + while ($this->padded_length < (strlen($result) + 10)) { + $this->padded_length += 1024; + } + + // pad up to $padded_length bytes if unpadded tag is shorter than $padded_length + if ($this->padded_length > (strlen($result) + 10)) { + $result .= @str_repeat("\x00", $this->padded_length - strlen($result) - 10); + } + + $header = 'ID3'; + $header .= chr(getid3_id3v2_write::major_version); + $header .= chr(0); + $header .= $this->generate_tag_flags(); + $header .= getid3_lib::BigEndian2String(strlen($result), 4, true); + + return $header.$result; + } + + + protected function generate_tag_flags($flags) { + + // %abc00000 + $flag = (@$flags['unsynchronisation'] ? '1' : '0'); // a - Unsynchronisation + $flag .= (@$flags['extendedheader'] ? '1' : '0'); // b - Extended header + $flag .= (@$flags['experimental'] ? '1' : '0'); // c - Experimental indicator + $flag .= '00000'; + + /**2.4 + // %abcd0000 + $flag = (@$flags['unsynchronisation'] ? '1' : '0'); // a - Unsynchronisation + $flag .= (@$flags['extendedheader'] ? '1' : '0'); // b - Extended header + $flag .= (@$flags['experimental'] ? '1' : '0'); // c - Experimental indicator + $flag .= (@$flags['footer'] ? '1' : '0'); // d - Footer present + $flag .= '0000'; + */ + + return chr(bindec($flag)); + } + + + protected function generate_frame_flags($flags) { + + // %abc00000 %ijk00000 + $flag1 = (@$flags['tag_alter'] ? '1' : '0'); // a - Tag alter preservation (true == discard) + $flag1 .= (@$flags['file_alter'] ? '1' : '0'); // b - File alter preservation (true == discard) + $flag1 .= (@$flags['read_only'] ? '1' : '0'); // c - Read only (true == read only) + $flag1 .= '00000'; + + $flag2 = (@$flags['compression'] ? '1' : '0'); // i - Compression (true == compressed) + $flag2 .= (@$flags['encryption'] ? '1' : '0'); // j - Encryption (true == encrypted) + $flag2 .= (@$flags['grouping_identity'] ? '1' : '0'); // k - Grouping identity (true == contains group information) + $flag2 .= '00000'; + + /**2.4 + // %0abc0000 %0h00kmnp + $flag1 = '0'; + $flag1 = (@$flags['tag_alter'] ? '1' : '0'); // a - Tag alter preservation (true == discard) + $flag1 .= (@$flags['file_alter'] ? '1' : '0'); // b - File alter preservation (true == discard) + $flag1 .= (@$flags['read_only'] ? '1' : '0'); // c - Read only (true == read only) + $flag1 .= '0000'; + + $flag2 = '0'; + $flag2 .= (@$flags['grouping_identity'] ? '1' : '0'); // h - Grouping identity (true == contains group information) + $flag2 .= '00'; + $flag2 = (@$flags['compression'] ? '1' : '0'); // k - Compression (true == compressed) + $flag2 .= (@$flags['encryption'] ? '1' : '0'); // m - Encryption (true == encrypted) + $flag2 .= (@$flags['unsynchronisation'] ? '1' : '0'); // n - Unsynchronisation (true == unsynchronised) + $flag2 .= (@$flags['data_length_indicator'] ? '1' : '0'); // p - Data length indicator (true == data length indicator added) + */ + + return chr(bindec($flag1)).chr(bindec($flag2)); + } + + + protected function generate_frame_data($frame_name, $source_data_array) { + + $frame_data = ''; + + switch ($frame_name) { + + case 'UFID': + // 4.1 UFID Unique file identifier + // Owner identifier $00 + // Identifier + if (strlen($source_data_array['data']) > 64) { + throw new getid3_exception('Identifier not allowed to be longer than 64 bytes in '.$frame_name.' (supplied data was '.strlen($source_data_array['data']).' bytes long)'); + } + $frame_data .= str_replace("\x00", '', $source_data_array['ownerid'])."\x00"; + $frame_data .= substr($source_data_array['data'], 0, 64); // max 64 bytes - truncate anything longer + break; + + case 'TXXX': + // 4.2.2 TXXX User defined text information frame + // Text encoding $xx + // Description $00 (00) + // Value + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= $source_data_array['description']."\x00"; + $frame_data .= $source_data_array['data']; + break; + + case 'WXXX': + // 4.3.2 WXXX User defined URL link frame + // Text encoding $xx + // Description $00 (00) + // URL + if (!isset($source_data_array['data']) || !$this->valid_url($source_data_array['data'], false, false)) { + throw new getid3_exception('Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')'); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= $source_data_array['description']."\x00"; + $frame_data .= $source_data_array['data']; + break; + + case 'IPLS': + // 4.4 IPLS Involved people list (ID3v2.3 only) + // Text encoding $xx + // People list strings + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= $source_data_array['data']; + break; + + case 'MCDI': + // 4.4 MCDI Music CD identifier + // CD TOC + $frame_data .= $source_data_array['data']; + break; + + case 'ETCO': + // 4.5 ETCO Event timing codes + // Time stamp format $xx + // Where time stamp format is: + // $01 (32-bit value) MPEG frames from beginning of file + // $02 (32-bit value) milliseconds from beginning of file + // Followed by a list of key events in the following format: + // Type of event $xx + // Time stamp $xx (xx ...) + // The 'Time stamp' is set to zero if directly at the beginning of the sound + // or after the previous event. All events MUST be sorted in chronological order. + if (($source_data_array['timestampformat'] > 2) || ($source_data_array['timestampformat'] < 1)) { + throw new getid3_exception('Invalid Time Stamp Format byte in '.$frame_name.' ('.$source_data_array['timestampformat'].')'); + } + $frame_data .= chr($source_data_array['timestampformat']); + foreach ($source_data_array as $key => $val) { + if (!$this->ID3v2IsValidETCOevent($val['typeid'])) { + throw new getid3_exception('Invalid Event Type byte in '.$frame_name.' ('.$val['typeid'].')'); + } + if (($key != 'timestampformat') && ($key != 'flags')) { + if (($val['timestamp'] > 0) && ($previousETCOtimestamp >= $val['timestamp'])) { + // The 'Time stamp' is set to zero if directly at the beginning of the sound + // or after the previous event. All events MUST be sorted in chronological order. + throw new getid3_exception('Out-of-order timestamp in '.$frame_name.' ('.$val['timestamp'].') for Event Type ('.$val['typeid'].')'); + } + $frame_data .= chr($val['typeid']); + $frame_data .= getid3_lib::BigEndian2String($val['timestamp'], 4, false); + } + } + break; + + case 'MLLT': + // 4.6 MLLT MPEG location lookup table + // MPEG frames between reference $xx xx + // Bytes between reference $xx xx xx + // Milliseconds between reference $xx xx xx + // Bits for bytes deviation $xx + // Bits for milliseconds dev. $xx + // Then for every reference the following data is included; + // Deviation in bytes %xxx.... + // Deviation in milliseconds %xxx.... + if (($source_data_array['framesbetweenreferences'] > 0) && ($source_data_array['framesbetweenreferences'] <= 65535)) { + $frame_data .= getid3_lib::BigEndian2String($source_data_array['framesbetweenreferences'], 2, false); + } + else { + throw new getid3_exception('Invalid MPEG Frames Between References in '.$frame_name.' ('.$source_data_array['framesbetweenreferences'].')'); + } + if (($source_data_array['bytesbetweenreferences'] > 0) && ($source_data_array['bytesbetweenreferences'] <= 16777215)) { + $frame_data .= getid3_lib::BigEndian2String($source_data_array['bytesbetweenreferences'], 3, false); + } + else { + throw new getid3_exception('Invalid bytes Between References in '.$frame_name.' ('.$source_data_array['bytesbetweenreferences'].')'); + } + if (($source_data_array['msbetweenreferences'] > 0) && ($source_data_array['msbetweenreferences'] <= 16777215)) { + $frame_data .= getid3_lib::BigEndian2String($source_data_array['msbetweenreferences'], 3, false); + } + else { + throw new getid3_exception('Invalid Milliseconds Between References in '.$frame_name.' ('.$source_data_array['msbetweenreferences'].')'); + } + if (!$this->IsWithinBitRange($source_data_array['bitsforbytesdeviation'], 8, false)) { + if (($source_data_array['bitsforbytesdeviation'] % 4) == 0) { + $frame_data .= chr($source_data_array['bitsforbytesdeviation']); + } + else { + throw new getid3_exception('Bits For Bytes Deviation in '.$frame_name.' ('.$source_data_array['bitsforbytesdeviation'].') must be a multiple of 4.'); + } + } + else { + throw new getid3_exception('Invalid Bits For Bytes Deviation in '.$frame_name.' ('.$source_data_array['bitsforbytesdeviation'].')'); + } + if (!$this->IsWithinBitRange($source_data_array['bitsformsdeviation'], 8, false)) { + if (($source_data_array['bitsformsdeviation'] % 4) == 0) { + $frame_data .= chr($source_data_array['bitsformsdeviation']); + } + else { + throw new getid3_exception('Bits For Milliseconds Deviation in '.$frame_name.' ('.$source_data_array['bitsforbytesdeviation'].') must be a multiple of 4.'); + } + } + else { + throw new getid3_exception('Invalid Bits For Milliseconds Deviation in '.$frame_name.' ('.$source_data_array['bitsformsdeviation'].')'); + } + foreach ($source_data_array as $key => $val) { + if (($key != 'framesbetweenreferences') && ($key != 'bytesbetweenreferences') && ($key != 'msbetweenreferences') && ($key != 'bitsforbytesdeviation') && ($key != 'bitsformsdeviation') && ($key != 'flags')) { + $unwritten_bit_stream .= str_pad(getid3_lib::Dec2Bin($val['bytedeviation']), $source_data_array['bitsforbytesdeviation'], '0', STR_PAD_LEFT); + $unwritten_bit_stream .= str_pad(getid3_lib::Dec2Bin($val['msdeviation']), $source_data_array['bitsformsdeviation'], '0', STR_PAD_LEFT); + } + } + for ($i = 0; $i < strlen($unwritten_bit_stream); $i += 8) { + $high_nibble = bindec(substr($unwritten_bit_stream, $i, 4)) << 4; + $low_nibble = bindec(substr($unwritten_bit_stream, $i + 4, 4)); + $frame_data .= chr($high_nibble & $low_nibble); + } + break; + + case 'SYTC': + // 4.7 SYTC Synchronised tempo codes + // Time stamp format $xx + // Tempo data + // Where time stamp format is: + // $01 (32-bit value) MPEG frames from beginning of file + // $02 (32-bit value) milliseconds from beginning of file + if (($source_data_array['timestampformat'] > 2) || ($source_data_array['timestampformat'] < 1)) { + throw new getid3_exception('Invalid Time Stamp Format byte in '.$frame_name.' ('.$source_data_array['timestampformat'].')'); + } + $frame_data .= chr($source_data_array['timestampformat']); + foreach ($source_data_array as $key => $val) { + if (!$this->ID3v2IsValidETCOevent($val['typeid'])) { + throw new getid3_exception('Invalid Event Type byte in '.$frame_name.' ('.$val['typeid'].')'); + } + if (($key != 'timestampformat') && ($key != 'flags')) { + if (($val['tempo'] < 0) || ($val['tempo'] > 510)) { + throw new getid3_exception('Invalid Tempo (max = 510) in '.$frame_name.' ('.$val['tempo'].') at timestamp ('.$val['timestamp'].')'); + } + if ($val['tempo'] > 255) { + $frame_data .= chr(255); + $val['tempo'] -= 255; + } + $frame_data .= chr($val['tempo']); + $frame_data .= getid3_lib::BigEndian2String($val['timestamp'], 4, false); + } + } + break; + + case 'USLT': + // 4.8 USLT Unsynchronised lyric/text transcription + // Text encoding $xx + // Language $xx xx xx + // Content descriptor $00 (00) + // Lyrics/text + if (getid3_id3v2::LanguageLookup($source_data_array['language'], true) == '') { + throw new getid3_exception('Invalid Language in '.$frame_name.' ('.$source_data_array['language'].')'); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= strtolower($source_data_array['language']); + $frame_data .= $source_data_array['description']."\x00"; + $frame_data .= $source_data_array['data']; + break; + + case 'SYLT': + // 4.9 SYLT Synchronised lyric/text + // Text encoding $xx + // Language $xx xx xx + // Time stamp format $xx + // $01 (32-bit value) MPEG frames from beginning of file + // $02 (32-bit value) milliseconds from beginning of file + // Content type $xx + // Content descriptor $00 (00) + // Terminated text to be synced (typically a syllable) + // Sync identifier (terminator to above string) $00 (00) + // Time stamp $xx (xx ...) + if (getid3_id3v2::LanguageLookup($source_data_array['language'], true) == '') { + throw new getid3_exception('Invalid Language in '.$frame_name.' ('.$source_data_array['language'].')'); + } + if (($source_data_array['timestampformat'] > 2) || ($source_data_array['timestampformat'] < 1)) { + throw new getid3_exception('Invalid Time Stamp Format byte in '.$frame_name.' ('.$source_data_array['timestampformat'].')'); + } + if (!$this->ID3v2IsValidSYLTtype($source_data_array['contenttypeid'])) { + throw new getid3_exception('Invalid Content Type byte in '.$frame_name.' ('.$source_data_array['contenttypeid'].')'); + } + if (!is_array($source_data_array['data'])) { + throw new getid3_exception('Invalid Lyric/Timestamp data in '.$frame_name.' (must be an array)'); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= strtolower($source_data_array['language']); + $frame_data .= chr($source_data_array['timestampformat']); + $frame_data .= chr($source_data_array['contenttypeid']); + $frame_data .= $source_data_array['description']."\x00"; + ksort($source_data_array['data']); + foreach ($source_data_array['data'] as $key => $val) { + $frame_data .= $val['data']."\x00"; + $frame_data .= getid3_lib::BigEndian2String($val['timestamp'], 4, false); + } + break; + + case 'COMM': + // 4.10 COMM Comments + // Text encoding $xx + // Language $xx xx xx + // Short content descrip. $00 (00) + // The actual text + if (getid3_id3v2::LanguageLookup($source_data_array['language'], true) == '') { + throw new getid3_exception('Invalid Language in '.$frame_name.' ('.$source_data_array['language'].')'); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= strtolower($source_data_array['language']); + $frame_data .= $source_data_array['description']."\x00"; + $frame_data .= $source_data_array['data']; + break; + + case 'RVA2': + // 4.11 RVA2 Relative volume adjustment (2) (ID3v2.4+ only) + // Identification $00 + // The 'identification' string is used to identify the situation and/or + // device where this adjustment should apply. The following is then + // repeated for every channel: + // Type of channel $xx + // Volume adjustment $xx xx + // Bits representing peak $xx + // Peak volume $xx (xx ...) + $frame_data .= str_replace("\x00", '', $source_data_array['description'])."\x00"; + foreach ($source_data_array as $key => $val) { + if ($key != 'description') { + $frame_data .= chr($val['channeltypeid']); + $frame_data .= getid3_lib::BigEndian2String($val['volumeadjust'], 2, false, true); // signed 16-bit + if (!$this->IsWithinBitRange($source_data_array['bitspeakvolume'], 8, false)) { + $frame_data .= chr($val['bitspeakvolume']); + if ($val['bitspeakvolume'] > 0) { + $frame_data .= getid3_lib::BigEndian2String($val['peakvolume'], ceil($val['bitspeakvolume'] / 8), false, false); + } + } else { + throw new getid3_exception('Invalid Bits Representing Peak Volume in '.$frame_name.' ('.$val['bitspeakvolume'].') (range = 0 to 255)'); + } + } + } + break; + + case 'RVAD': + // 4.12 RVAD Relative volume adjustment (ID3v2.3 only) + // Increment/decrement %00fedcba + // Bits used for volume descr. $xx + // Relative volume change, right $xx xx (xx ...) // a + // Relative volume change, left $xx xx (xx ...) // b + // Peak volume right $xx xx (xx ...) + // Peak volume left $xx xx (xx ...) + // Relative volume change, right back $xx xx (xx ...) // c + // Relative volume change, left back $xx xx (xx ...) // d + // Peak volume right back $xx xx (xx ...) + // Peak volume left back $xx xx (xx ...) + // Relative volume change, center $xx xx (xx ...) // e + // Peak volume center $xx xx (xx ...) + // Relative volume change, bass $xx xx (xx ...) // f + // Peak volume bass $xx xx (xx ...) + if (!$this->IsWithinBitRange($source_data_array['bitsvolume'], 8, false)) { + throw new getid3_exception('Invalid Bits For Volume Description byte in '.$frame_name.' ('.$source_data_array['bitsvolume'].') (range = 1 to 255)'); + } else { + $inc_dec_flag .= '00'; + $inc_dec_flag .= $source_data_array['incdec']['right'] ? '1' : '0'; // a - Relative volume change, right + $inc_dec_flag .= $source_data_array['incdec']['left'] ? '1' : '0'; // b - Relative volume change, left + $inc_dec_flag .= $source_data_array['incdec']['rightrear'] ? '1' : '0'; // c - Relative volume change, right back + $inc_dec_flag .= $source_data_array['incdec']['leftrear'] ? '1' : '0'; // d - Relative volume change, left back + $inc_dec_flag .= $source_data_array['incdec']['center'] ? '1' : '0'; // e - Relative volume change, center + $inc_dec_flag .= $source_data_array['incdec']['bass'] ? '1' : '0'; // f - Relative volume change, bass + $frame_data .= chr(bindec($inc_dec_flag)); + $frame_data .= chr($source_data_array['bitsvolume']); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['volumechange']['right'], ceil($source_data_array['bitsvolume'] / 8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['volumechange']['left'], ceil($source_data_array['bitsvolume'] / 8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['peakvolume']['right'], ceil($source_data_array['bitsvolume'] / 8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['peakvolume']['left'], ceil($source_data_array['bitsvolume'] / 8), false); + if ($source_data_array['volumechange']['rightrear'] || $source_data_array['volumechange']['leftrear'] || + $source_data_array['peakvolume']['rightrear'] || $source_data_array['peakvolume']['leftrear'] || + $source_data_array['volumechange']['center'] || $source_data_array['peakvolume']['center'] || + $source_data_array['volumechange']['bass'] || $source_data_array['peakvolume']['bass']) { + $frame_data .= getid3_lib::BigEndian2String($source_data_array['volumechange']['rightrear'], ceil($source_data_array['bitsvolume']/8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['volumechange']['leftrear'], ceil($source_data_array['bitsvolume']/8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['peakvolume']['rightrear'], ceil($source_data_array['bitsvolume']/8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['peakvolume']['leftrear'], ceil($source_data_array['bitsvolume']/8), false); + } + if ($source_data_array['volumechange']['center'] || $source_data_array['peakvolume']['center'] || + $source_data_array['volumechange']['bass'] || $source_data_array['peakvolume']['bass']) { + $frame_data .= getid3_lib::BigEndian2String($source_data_array['volumechange']['center'], ceil($source_data_array['bitsvolume']/8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['peakvolume']['center'], ceil($source_data_array['bitsvolume']/8), false); + } + if ($source_data_array['volumechange']['bass'] || $source_data_array['peakvolume']['bass']) { + $frame_data .= getid3_lib::BigEndian2String($source_data_array['volumechange']['bass'], ceil($source_data_array['bitsvolume']/8), false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['peakvolume']['bass'], ceil($source_data_array['bitsvolume']/8), false); + } + } + break; + + case 'EQU2': + // 4.12 EQU2 Equalisation (2) (ID3v2.4+ only) + // Interpolation method $xx + // $00 Band + // $01 Linear + // Identification $00 + // The following is then repeated for every adjustment point + // Frequency $xx xx + // Volume adjustment $xx xx + if (($source_data_array['interpolationmethod'] < 0) || ($source_data_array['interpolationmethod'] > 1)) { + throw new getid3_exception('Invalid Interpolation Method byte in '.$frame_name.' ('.$source_data_array['interpolationmethod'].') (valid = 0 or 1)'); + } + $frame_data .= chr($source_data_array['interpolationmethod']); + $frame_data .= str_replace("\x00", '', $source_data_array['description'])."\x00"; + foreach ($source_data_array['data'] as $key => $val) { + $frame_data .= getid3_lib::BigEndian2String(intval(round($key * 2)), 2, false); + $frame_data .= getid3_lib::BigEndian2String($val, 2, false, true); // signed 16-bit + } + break; + + case 'EQUA': + // 4.12 EQUA Equalisation (ID3v2.3 only) + // Adjustment bits $xx + // This is followed by 2 bytes + ('adjustment bits' rounded up to the + // nearest byte) for every equalisation band in the following format, + // giving a frequency range of 0 - 32767Hz: + // Increment/decrement %x (MSB of the Frequency) + // Frequency (lower 15 bits) + // Adjustment $xx (xx ...) + if (!$this->IsWithinBitRange($source_data_array['bitsvolume'], 8, false)) { + throw new getid3_exception('Invalid Adjustment Bits byte in '.$frame_name.' ('.$source_data_array['bitsvolume'].') (range = 1 to 255)'); + } + $frame_data .= chr($source_data_array['adjustmentbits']); + foreach ($source_data_array as $key => $val) { + if ($key != 'bitsvolume') { + if (($key > 32767) || ($key < 0)) { + throw new getid3_exception('Invalid Frequency in '.$frame_name.' ('.$key.') (range = 0 to 32767)'); + } else { + if ($val >= 0) { + // put MSB of frequency to 1 if increment, 0 if decrement + $key |= 0x8000; + } + $frame_data .= getid3_lib::BigEndian2String($key, 2, false); + $frame_data .= getid3_lib::BigEndian2String($val, ceil($source_data_array['adjustmentbits'] / 8), false); + } + } + } + break; + + case 'RVRB': + // 4.13 RVRB Reverb + // Reverb left (ms) $xx xx + // Reverb right (ms) $xx xx + // Reverb bounces, left $xx + // Reverb bounces, right $xx + // Reverb feedback, left to left $xx + // Reverb feedback, left to right $xx + // Reverb feedback, right to right $xx + // Reverb feedback, right to left $xx + // Premix left to right $xx + // Premix right to left $xx + if (!$this->IsWithinBitRange($source_data_array['left'], 16, false)) { + throw new getid3_exception('Invalid Reverb Left in '.$frame_name.' ('.$source_data_array['left'].') (range = 0 to 65535)'); + } + if (!$this->IsWithinBitRange($source_data_array['right'], 16, false)) { + throw new getid3_exception('Invalid Reverb Left in '.$frame_name.' ('.$source_data_array['right'].') (range = 0 to 65535)'); + } + if (!$this->IsWithinBitRange($source_data_array['bouncesL'], 8, false)) { + throw new getid3_exception('Invalid Reverb Bounces, Left in '.$frame_name.' ('.$source_data_array['bouncesL'].') (range = 0 to 255)'); + } + if (!$this->IsWithinBitRange($source_data_array['bouncesR'], 8, false)) { + throw new getid3_exception('Invalid Reverb Bounces, Right in '.$frame_name.' ('.$source_data_array['bouncesR'].') (range = 0 to 255)'); + } + if (!$this->IsWithinBitRange($source_data_array['feedbackLL'], 8, false)) { + throw new getid3_exception('Invalid Reverb Feedback, Left-To-Left in '.$frame_name.' ('.$source_data_array['feedbackLL'].') (range = 0 to 255)'); + } + if (!$this->IsWithinBitRange($source_data_array['feedbackLR'], 8, false)) { + throw new getid3_exception('Invalid Reverb Feedback, Left-To-Right in '.$frame_name.' ('.$source_data_array['feedbackLR'].') (range = 0 to 255)'); + } + if (!$this->IsWithinBitRange($source_data_array['feedbackRR'], 8, false)) { + throw new getid3_exception('Invalid Reverb Feedback, Right-To-Right in '.$frame_name.' ('.$source_data_array['feedbackRR'].') (range = 0 to 255)'); + } + if (!$this->IsWithinBitRange($source_data_array['feedbackRL'], 8, false)) { + throw new getid3_exception('Invalid Reverb Feedback, Right-To-Left in '.$frame_name.' ('.$source_data_array['feedbackRL'].') (range = 0 to 255)'); + } + if (!$this->IsWithinBitRange($source_data_array['premixLR'], 8, false)) { + throw new getid3_exception('Invalid Premix, Left-To-Right in '.$frame_name.' ('.$source_data_array['premixLR'].') (range = 0 to 255)'); + } + if (!$this->IsWithinBitRange($source_data_array['premixRL'], 8, false)) { + throw new getid3_exception('Invalid Premix, Right-To-Left in '.$frame_name.' ('.$source_data_array['premixRL'].') (range = 0 to 255)'); + } + $frame_data .= getid3_lib::BigEndian2String($source_data_array['left'], 2, false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['right'], 2, false); + $frame_data .= chr($source_data_array['bouncesL']); + $frame_data .= chr($source_data_array['bouncesR']); + $frame_data .= chr($source_data_array['feedbackLL']); + $frame_data .= chr($source_data_array['feedbackLR']); + $frame_data .= chr($source_data_array['feedbackRR']); + $frame_data .= chr($source_data_array['feedbackRL']); + $frame_data .= chr($source_data_array['premixLR']); + $frame_data .= chr($source_data_array['premixRL']); + break; + + case 'APIC': + // 4.14 APIC Attached picture + // Text encoding $xx + // MIME type $00 + // Picture type $xx + // Description $00 (00) + // Picture data + if (!$this->ID3v2IsValidAPICpicturetype($source_data_array['picturetypeid'])) { + throw new getid3_exception('Invalid Picture Type byte in '.$frame_name.' ('.$source_data_array['picturetypeid'].') for ID3v2.'.getid3_id3v2_write::major_version); + } + if ((getid3_id3v2_write::major_version >= 3) && (!$this->ID3v2IsValidAPICimageformat($source_data_array['mime']))) { + throw new getid3_exception('Invalid MIME Type in '.$frame_name.' ('.$source_data_array['mime'].') for ID3v2.'.getid3_id3v2_write::major_version); + } + if (($source_data_array['mime'] == '-->') && (!$this->valid_url($source_data_array['data'], false, false))) { + throw new getid3_exception('Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')'); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= str_replace("\x00", '', $source_data_array['mime'])."\x00"; + $frame_data .= chr($source_data_array['picturetypeid']); + $frame_data .= @$source_data_array['description']."\x00"; + $frame_data .= $source_data_array['data']; + break; + + case 'GEOB': + // 4.15 GEOB General encapsulated object + // Text encoding $xx + // MIME type $00 + // Filename $00 (00) + // Content description $00 (00) + // Encapsulated object + if (!$this->IsValidMIMEstring($source_data_array['mime'])) { + throw new getid3_exception('Invalid MIME Type in '.$frame_name.' ('.$source_data_array['mime'].')'); + } + if (!$source_data_array['description']) { + throw new getid3_exception('Missing Description in '.$frame_name); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= str_replace("\x00", '', $source_data_array['mime'])."\x00"; + $frame_data .= $source_data_array['filename']."\x00"; + $frame_data .= $source_data_array['description']."\x00"; + $frame_data .= $source_data_array['data']; + break; + + case 'PCNT': + // 4.16 PCNT Play counter + // When the counter reaches all one's, one byte is inserted in + // front of the counter thus making the counter eight bits bigger + // Counter $xx xx xx xx (xx ...) + $frame_data .= getid3_lib::BigEndian2String($source_data_array['data'], 4, false); + break; + + case 'POPM': + // 4.17 POPM Popularimeter + // When the counter reaches all one's, one byte is inserted in + // front of the counter thus making the counter eight bits bigger + // Email to user $00 + // Rating $xx + // Counter $xx xx xx xx (xx ...) + if (!$this->IsWithinBitRange($source_data_array['rating'], 8, false)) { + throw new getid3_exception('Invalid Rating byte in '.$frame_name.' ('.$source_data_array['rating'].') (range = 0 to 255)'); + } + if (!IsValidEmail($source_data_array['email'])) { + throw new getid3_exception('Invalid Email in '.$frame_name.' ('.$source_data_array['email'].')'); + } + $frame_data .= str_replace("\x00", '', $source_data_array['email'])."\x00"; + $frame_data .= chr($source_data_array['rating']); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['data'], 4, false); + break; + + case 'RBUF': + // 4.18 RBUF Recommended buffer size + // Buffer size $xx xx xx + // Embedded info flag %0000000x + // Offset to next tag $xx xx xx xx + if (!$this->IsWithinBitRange($source_data_array['buffersize'], 24, false)) { + throw new getid3_exception('Invalid Buffer Size in '.$frame_name); + } + if (!$this->IsWithinBitRange($source_data_array['nexttagoffset'], 32, false)) { + throw new getid3_exception('Invalid Offset To Next Tag in '.$frame_name); + } + $frame_data .= getid3_lib::BigEndian2String($source_data_array['buffersize'], 3, false); + $flag .= '0000000'; + $flag .= $source_data_array['flags']['embededinfo'] ? '1' : '0'; + $frame_data .= chr(bindec($flag)); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['nexttagoffset'], 4, false); + break; + + case 'AENC': + // 4.19 AENC Audio encryption + // Owner identifier $00 + // Preview start $xx xx + // Preview length $xx xx + // Encryption info + if (!$this->IsWithinBitRange($source_data_array['previewstart'], 16, false)) { + throw new getid3_exception('Invalid Preview Start in '.$frame_name.' ('.$source_data_array['previewstart'].')'); + } + if (!$this->IsWithinBitRange($source_data_array['previewlength'], 16, false)) { + throw new getid3_exception('Invalid Preview Length in '.$frame_name.' ('.$source_data_array['previewlength'].')'); + } + $frame_data .= str_replace("\x00", '', $source_data_array['ownerid'])."\x00"; + $frame_data .= getid3_lib::BigEndian2String($source_data_array['previewstart'], 2, false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['previewlength'], 2, false); + $frame_data .= $source_data_array['encryptioninfo']; + break; + + case 'LINK': + // 4.20 LINK Linked information + // Frame identifier $xx xx xx xx + // URL $00 + // ID and additional data + if (!getid3_id3v2::valid_frame_name($source_data_array['frameid'], getid3_id3v2_write::major_version)) { + throw new getid3_exception('Invalid Frame Identifier in '.$frame_name.' ('.$source_data_array['frameid'].')'); + } + if (!$this->valid_url($source_data_array['data'], true, false)) { + throw new getid3_exception('Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')'); + } + if ((($source_data_array['frameid'] == 'AENC') || ($source_data_array['frameid'] == 'APIC') || ($source_data_array['frameid'] == 'GEOB') || ($source_data_array['frameid'] == 'TXXX')) && ($source_data_array['additionaldata'] == '')) { + throw new getid3_exception('Content Descriptor must be specified as additional data for Frame Identifier of '.$source_data_array['frameid'].' in '.$frame_name); + } + if (($source_data_array['frameid'] == 'USER') && (getid3_id3v2::LanguageLookup($source_data_array['additionaldata'], true) == '')) { + throw new getid3_exception('Language must be specified as additional data for Frame Identifier of '.$source_data_array['frameid'].' in '.$frame_name); + } + if (($source_data_array['frameid'] == 'PRIV') && ($source_data_array['additionaldata'] == '')) { + throw new getid3_exception('Owner Identifier must be specified as additional data for Frame Identifier of '.$source_data_array['frameid'].' in '.$frame_name); + } + if ((($source_data_array['frameid'] == 'COMM') || ($source_data_array['frameid'] == 'SYLT') || ($source_data_array['frameid'] == 'USLT')) && ((getid3_id3v2::LanguageLookup(substr($source_data_array['additionaldata'], 0, 3), true) == '') || (substr($source_data_array['additionaldata'], 3) == ''))) { + throw new getid3_exception('Language followed by Content Descriptor must be specified as additional data for Frame Identifier of '.$source_data_array['frameid'].' in '.$frame_name); + } + $frame_data .= $source_data_array['frameid']; + $frame_data .= str_replace("\x00", '', $source_data_array['data'])."\x00"; + switch ($source_data_array['frameid']) { + case 'COMM': + case 'SYLT': + case 'USLT': + case 'PRIV': + case 'USER': + case 'AENC': + case 'APIC': + case 'GEOB': + case 'TXXX': + $frame_data .= $source_data_array['additionaldata']; + break; + + case 'ASPI': + case 'ETCO': + case 'EQU2': + case 'MCID': + case 'MLLT': + case 'OWNE': + case 'RVA2': + case 'RVRB': + case 'SYTC': + case 'IPLS': + case 'RVAD': + case 'EQUA': + // no additional data required + break; + + case 'RBUF': + if (getid3_id3v2_write::major_version == 3) { + // no additional data required + } else { + throw new getid3_exception($source_data_array['frameid'].' is not a valid Frame Identifier in '.$frame_name.' (in ID3v2.'.getid3_id3v2_write::major_version.')'); + } + + default: + if ((substr($source_data_array['frameid'], 0, 1) == 'T') || (substr($source_data_array['frameid'], 0, 1) == 'W')) { + // no additional data required + } else { + throw new getid3_exception($source_data_array['frameid'].' is not a valid Frame Identifier in '.$frame_name.' (in ID3v2.'.getid3_id3v2_write::major_version.')'); + } + } + break; + + case 'POSS': + // 4.21 POSS Position synchronisation frame (ID3v2.3+ only) + // Time stamp format $xx + // Position $xx (xx ...) + if (($source_data_array['timestampformat'] < 1) || ($source_data_array['timestampformat'] > 2)) { + throw new getid3_exception('Invalid Time Stamp Format in '.$frame_name.' ('.$source_data_array['timestampformat'].') (valid = 1 or 2)'); + } + if (!$this->IsWithinBitRange($source_data_array['position'], 32, false)) { + throw new getid3_exception('Invalid Position in '.$frame_name.' ('.$source_data_array['position'].') (range = 0 to 4294967295)'); + } + $frame_data .= chr($source_data_array['timestampformat']); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['position'], 4, false); + break; + + case 'USER': + // 4.22 USER Terms of use (ID3v2.3+ only) + // Text encoding $xx + // Language $xx xx xx + // The actual text + if (getid3_id3v2::LanguageLookup($source_data_array['language'], true) == '') { + throw new getid3_exception('Invalid Language in '.$frame_name.' ('.$source_data_array['language'].')'); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= strtolower($source_data_array['language']); + $frame_data .= $source_data_array['data']; + break; + + case 'OWNE': + // 4.23 OWNE Ownership frame (ID3v2.3+ only) + // Text encoding $xx + // Price paid $00 + // Date of purch. + // Seller + if (!$this->IsANumber($source_data_array['pricepaid']['value'], false)) { + throw new getid3_exception('Invalid Price Paid in '.$frame_name.' ('.$source_data_array['pricepaid']['value'].')'); + } + if (!$this->IsValidDateStampString($source_data_array['purchasedate'])) { + throw new getid3_exception('Invalid Date Of Purchase in '.$frame_name.' ('.$source_data_array['purchasedate'].') (format = YYYYMMDD)'); + } + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= str_replace("\x00", '', $source_data_array['pricepaid']['value'])."\x00"; + $frame_data .= $source_data_array['purchasedate']; + $frame_data .= $source_data_array['seller']; + break; + + case 'COMR': + // 4.24 COMR Commercial frame (ID3v2.3+ only) + // Text encoding $xx + // Price string $00 + // Valid until + // Contact URL $00 + // Received as $xx + // Name of seller $00 (00) + // Description $00 (00) + // Picture MIME type $00 + // Seller logo + if (!$this->IsValidDateStampString($source_data_array['pricevaliduntil'])) { + throw new getid3_exception('Invalid Valid Until date in '.$frame_name.' ('.$source_data_array['pricevaliduntil'].') (format = YYYYMMDD)'); + } + if (!$this->valid_url($source_data_array['contacturl'], false, true)) { + throw new getid3_exception('Invalid Contact URL in '.$frame_name.' ('.$source_data_array['contacturl'].') (allowed schemes: http, https, ftp, mailto)'); + } + if (!$this->ID3v2IsValidCOMRreceivedAs($source_data_array['receivedasid'])) { + throw new getid3_exception('Invalid Received As byte in '.$frame_name.' ('.$source_data_array['contacturl'].') (range = 0 to 8)'); + }if (!$this->IsValidMIMEstring($source_data_array['mime'])) { + throw new getid3_exception('Invalid MIME Type in '.$frame_name.' ('.$source_data_array['mime'].')'); + } + $frame_data .= chr(3); // UTF-8 encoding + unset($price_string); + foreach ($source_data_array['price'] as $key => $val) { + if ($this->ID3v2IsValidPriceString($key.$val['value'])) { + $price_strings[] = $key.$val['value']; + } else { + throw new getid3_exception('Invalid Price String in '.$frame_name.' ('.$key.$val['value'].')'); + } + } + $frame_data .= implode('/', $price_strings); + $frame_data .= $source_data_array['pricevaliduntil']; + $frame_data .= str_replace("\x00", '', $source_data_array['contacturl'])."\x00"; + $frame_data .= chr($source_data_array['receivedasid']); + $frame_data .= $source_data_array['sellername']."\x00"; + $frame_data .= $source_data_array['description']."\x00"; + $frame_data .= $source_data_array['mime']."\x00"; + $frame_data .= $source_data_array['logo']; + break; + + case 'ENCR': + // 4.25 ENCR Encryption method registration (ID3v2.3+ only) + // Owner identifier $00 + // Method symbol $xx + // Encryption data + if (!$this->IsWithinBitRange($source_data_array['methodsymbol'], 8, false)) { + throw new getid3_exception('Invalid Group Symbol in '.$frame_name.' ('.$source_data_array['methodsymbol'].') (range = 0 to 255)'); + } + $frame_data .= str_replace("\x00", '', $source_data_array['ownerid'])."\x00"; + $frame_data .= ord($source_data_array['methodsymbol']); + $frame_data .= $source_data_array['data']; + break; + + case 'GRID': + // 4.26 GRID Group identification registration (ID3v2.3+ only) + // Owner identifier $00 + // Group symbol $xx + // Group dependent data + if (!$this->IsWithinBitRange($source_data_array['groupsymbol'], 8, false)) { + throw new getid3_exception('Invalid Group Symbol in '.$frame_name.' ('.$source_data_array['groupsymbol'].') (range = 0 to 255)'); + } + $frame_data .= str_replace("\x00", '', $source_data_array['ownerid'])."\x00"; + $frame_data .= ord($source_data_array['groupsymbol']); + $frame_data .= $source_data_array['data']; + break; + + case 'PRIV': + // 4.27 PRIV Private frame (ID3v2.3+ only) + // Owner identifier $00 + // The private data + $frame_data .= str_replace("\x00", '', $source_data_array['ownerid'])."\x00"; + $frame_data .= $source_data_array['data']; + break; + + case 'SIGN': + // 4.28 SIGN Signature frame (ID3v2.4+ only) + // Group symbol $xx + // Signature + if (!$this->IsWithinBitRange($source_data_array['groupsymbol'], 8, false)) { + throw new getid3_exception('Invalid Group Symbol in '.$frame_name.' ('.$source_data_array['groupsymbol'].') (range = 0 to 255)'); + } + $frame_data .= ord($source_data_array['groupsymbol']); + $frame_data .= $source_data_array['data']; + break; + + case 'SEEK': + // 4.29 SEEK Seek frame (ID3v2.4+ only) + // Minimum offset to next tag $xx xx xx xx + if (!$this->IsWithinBitRange($source_data_array['data'], 32, false)) { + throw new getid3_exception('Invalid Minimum Offset in '.$frame_name.' ('.$source_data_array['data'].') (range = 0 to 4294967295)'); + } + $frame_data .= getid3_lib::BigEndian2String($source_data_array['data'], 4, false); + break; + + case 'ASPI': + // 4.30 ASPI Audio seek point index (ID3v2.4+ only) + // Indexed data start (S) $xx xx xx xx + // Indexed data length (L) $xx xx xx xx + // Number of index points (N) $xx xx + // Bits per index point (b) $xx + // Then for every index point the following data is included: + // Fraction at index (Fi) $xx (xx) + if (!$this->IsWithinBitRange($source_data_array['datastart'], 32, false)) { + throw new getid3_exception('Invalid Indexed Data Start in '.$frame_name.' ('.$source_data_array['datastart'].') (range = 0 to 4294967295)'); + } + if (!$this->IsWithinBitRange($source_data_array['datalength'], 32, false)) { + throw new getid3_exception('Invalid Indexed Data Length in '.$frame_name.' ('.$source_data_array['datalength'].') (range = 0 to 4294967295)'); + } + if (!$this->IsWithinBitRange($source_data_array['indexpoints'], 16, false)) { + throw new getid3_exception('Invalid Number Of Index Points in '.$frame_name.' ('.$source_data_array['indexpoints'].') (range = 0 to 65535)'); + } + if (!$this->IsWithinBitRange($source_data_array['bitsperpoint'], 8, false)) { + throw new getid3_exception('Invalid Bits Per Index Point in '.$frame_name.' ('.$source_data_array['bitsperpoint'].') (range = 0 to 255)'); + } + if ($source_data_array['indexpoints'] != count($source_data_array['indexes'])) { + throw new getid3_exception('Number Of Index Points does not match actual supplied data in '.$frame_name); + } + $frame_data .= getid3_lib::BigEndian2String($source_data_array['datastart'], 4, false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['datalength'], 4, false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['indexpoints'], 2, false); + $frame_data .= getid3_lib::BigEndian2String($source_data_array['bitsperpoint'], 1, false); + foreach ($source_data_array['indexes'] as $key => $val) { + $frame_data .= getid3_lib::BigEndian2String($val, ceil($source_data_array['bitsperpoint'] / 8), false); + } + break; + + case 'RGAD': + // RGAD Replay Gain Adjustment + // http://privatewww.essex.ac.uk/~djmrob/replaygain/ + // Peak Amplitude $xx $xx $xx $xx + // Radio Replay Gain Adjustment %aaabbbcd %dddddddd + // Audiophile Replay Gain Adjustment %aaabbbcd %dddddddd + // a - name code + // b - originator code + // c - sign bit + // d - replay gain adjustment + + if (($source_data_array['track_adjustment'] > 51) || ($source_data_array['track_adjustment'] < -51)) { + throw new getid3_exception('Invalid Track Adjustment in '.$frame_name.' ('.$source_data_array['track_adjustment'].') (range = -51.0 to +51.0)'); + } + if (($source_data_array['album_adjustment'] > 51) || ($source_data_array['album_adjustment'] < -51)) { + throw new getid3_exception('Invalid Album Adjustment in '.$frame_name.' ('.$source_data_array['album_adjustment'].') (range = -51.0 to +51.0)'); + } + if (!$this->ID3v2IsValidRGADname($source_data_array['raw']['track_name'])) { + throw new getid3_exception('Invalid Track Name Code in '.$frame_name.' ('.$source_data_array['raw']['track_name'].') (range = 0 to 2)'); + } + if (!$this->ID3v2IsValidRGADname($source_data_array['raw']['album_name'])) { + throw new getid3_exception('Invalid Album Name Code in '.$frame_name.' ('.$source_data_array['raw']['album_name'].') (range = 0 to 2)'); + } + if (!$this->ID3v2IsValidRGADoriginator($source_data_array['raw']['track_originator'])) { + throw new getid3_exception('Invalid Track Originator Code in '.$frame_name.' ('.$source_data_array['raw']['track_originator'].') (range = 0 to 3)'); + } + if (!$this->ID3v2IsValidRGADoriginator($source_data_array['raw']['album_originator'])) { + throw new getid3_exception('Invalid Album Originator Code in '.$frame_name.' ('.$source_data_array['raw']['album_originator'].') (range = 0 to 3)'); + } + $frame_data .= getid3_lib::Float2String($source_data_array['peakamplitude'], 32); + $frame_data .= getid3_lib::RGADgainString($source_data_array['raw']['track_name'], $source_data_array['raw']['track_originator'], $source_data_array['track_adjustment']); + $frame_data .= getid3_lib::RGADgainString($source_data_array['raw']['album_name'], $source_data_array['raw']['album_originator'], $source_data_array['album_adjustment']); + break; + + default: + + if ($frame_name{0} == 'T') { + // 4.2. T??? Text information frames + // Text encoding $xx + // Information + $frame_data .= chr(3); // UTF-8 encoding + $frame_data .= $source_data_array['data']; + } + + elseif ($frame_name{0} == 'W') { + // 4.3. W??? URL link frames + // URL + if (!$this->valid_url($source_data_array['data'], false, false)) { + throw new getid3_exception('Invalid URL in '.$frame_name.' ('.$source_data_array['data'].')'); + } else { + $frame_data .= $source_data_array['data']; + } + } else { + throw new getid3_exception($frame_name.' not supported by generate_frame_data()'); + } + break; + } + + return $frame_data; + } + + + protected function frame_allowed($frame_name, $source_data_array) { + + if (getid3_id3v2_write::major_version == 4) { + switch ($frame_name) { + case 'UFID': + case 'AENC': + case 'ENCR': + case 'GRID': + if (!isset($source_data_array['ownerid'])) { + throw new getid3_exception('[ownerid] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['ownerid'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same OwnerID ('.$source_data_array['ownerid'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['ownerid']; + break; + + case 'TXXX': + case 'WXXX': + case 'RVA2': + case 'EQU2': + case 'APIC': + case 'GEOB': + if (!isset($source_data_array['description'])) { + throw new getid3_exception('[description] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['description'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Description ('.$source_data_array['description'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['description']; + break; + + case 'USER': + if (!isset($source_data_array['language'])) { + throw new getid3_exception('[language] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['language'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Language ('.$source_data_array['language'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['language']; + break; + + case 'USLT': + case 'SYLT': + case 'COMM': + if (!isset($source_data_array['language'])) { + throw new getid3_exception('[language] not specified for '.$frame_name); + } + if (!isset($source_data_array['description'])) { + throw new getid3_exception('[description] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['language'].$source_data_array['description'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Language + Description ('.$source_data_array['language'].' + '.$source_data_array['description'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['language'].$source_data_array['description']; + break; + + case 'POPM': + if (!isset($source_data_array['email'])) { + throw new getid3_exception('[email] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['email'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Email ('.$source_data_array['email'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['email']; + break; + + case 'IPLS': + case 'MCDI': + case 'ETCO': + case 'MLLT': + case 'SYTC': + case 'RVRB': + case 'PCNT': + case 'RBUF': + case 'POSS': + case 'OWNE': + case 'SEEK': + case 'ASPI': + case 'RGAD': + if (in_array($frame_name, $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed'); + } + $this->previous_frames[] = $frame_name; + break; + + case 'LINK': + // this isn't implemented quite right (yet) - it should check the target frame data for compliance + // but right now it just allows one linked frame of each type, to be safe. + if (!isset($source_data_array['frameid'])) { + throw new getid3_exception('[frameid] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['frameid'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same FrameID ('.$source_data_array['frameid'].')'); + } + if (in_array($source_data_array['frameid'], $this->previous_frames)) { + // no links to singleton tags + throw new getid3_exception('Cannot specify a '.$frame_name.' tag to a singleton tag that already exists ('.$source_data_array['frameid'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['frameid']; // only one linked tag of this type + $this->previous_frames[] = $source_data_array['frameid']; // no non-linked singleton tags of this type + break; + + case 'COMR': + // There may be more than one 'commercial frame' in a tag, but no two may be identical + // Checking isn't implemented at all (yet) - just assumes that it's OK. + break; + + case 'PRIV': + case 'SIGN': + if (!isset($source_data_array['ownerid'])) { + throw new getid3_exception('[ownerid] not specified for '.$frame_name); + } + if (!isset($source_data_array['data'])) { + throw new getid3_exception('[data] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['ownerid'].$source_data_array['data'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same OwnerID + Data ('.$source_data_array['ownerid'].' + '.$source_data_array['data'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['ownerid'].$source_data_array['data']; + break; + + default: + if (($frame_name{0} != 'T') && ($frame_name{0} != 'W')) { + throw new getid3_exception('Frame not allowed in ID3v2.'.getid3_id3v2_write::major_version.': '.$frame_name); + } + break; + } + + } elseif (getid3_id3v2_write::major_version == 3) { + + switch ($frame_name) { + case 'UFID': + case 'AENC': + case 'ENCR': + case 'GRID': + if (!isset($source_data_array['ownerid'])) { + throw new getid3_exception('[ownerid] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['ownerid'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same OwnerID ('.$source_data_array['ownerid'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['ownerid']; + break; + + case 'TXXX': + case 'WXXX': + case 'APIC': + case 'GEOB': + if (!isset($source_data_array['description'])) { + throw new getid3_exception('[description] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['description'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Description ('.$source_data_array['description'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['description']; + break; + + case 'USER': + if (!isset($source_data_array['language'])) { + throw new getid3_exception('[language] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['language'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Language ('.$source_data_array['language'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['language']; + break; + + case 'USLT': + case 'SYLT': + case 'COMM': + if (!isset($source_data_array['language'])) { + throw new getid3_exception('[language] not specified for '.$frame_name); + } + if (!isset($source_data_array['description'])) { + throw new getid3_exception('[description] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['language'].$source_data_array['description'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Language + Description ('.$source_data_array['language'].' + '.$source_data_array['description'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['language'].$source_data_array['description']; + break; + + case 'POPM': + if (!isset($source_data_array['email'])) { + throw new getid3_exception('[email] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['email'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same Email ('.$source_data_array['email'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['email']; + break; + + case 'IPLS': + case 'MCDI': + case 'ETCO': + case 'MLLT': + case 'SYTC': + case 'RVAD': + case 'EQUA': + case 'RVRB': + case 'PCNT': + case 'RBUF': + case 'POSS': + case 'OWNE': + case 'RGAD': + if (in_array($frame_name, $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed'); + } + $this->previous_frames[] = $frame_name; + break; + + case 'LINK': + // this isn't implemented quite right (yet) - it should check the target frame data for compliance + // but right now it just allows one linked frame of each type, to be safe. + if (!isset($source_data_array['frameid'])) { + throw new getid3_exception('[frameid] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['frameid'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same FrameID ('.$source_data_array['frameid'].')'); + } + if (in_array($source_data_array['frameid'], $this->previous_frames)) { + // no links to singleton tags + throw new getid3_exception('Cannot specify a '.$frame_name.' tag to a singleton tag that already exists ('.$source_data_array['frameid'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['frameid']; // only one linked tag of this type + $this->previous_frames[] = $source_data_array['frameid']; // no non-linked singleton tags of this type + break; + + case 'COMR': + // There may be more than one 'commercial frame' in a tag, but no two may be identical + // Checking isn't implemented at all (yet) - just assumes that it's OK. + break; + + case 'PRIV': + if (!isset($source_data_array['ownerid'])) { + throw new getid3_exception('[ownerid] not specified for '.$frame_name); + } + if (!isset($source_data_array['data'])) { + throw new getid3_exception('[data] not specified for '.$frame_name); + } + if (in_array($frame_name.$source_data_array['ownerid'].$source_data_array['data'], $this->previous_frames)) { + throw new getid3_exception('Only one '.$frame_name.' tag allowed with the same OwnerID + Data ('.$source_data_array['ownerid'].' + '.$source_data_array['data'].')'); + } + $this->previous_frames[] = $frame_name.$source_data_array['ownerid'].$source_data_array['data']; + break; + + default: + if (($frame_name{0} != 'T') && ($frame_name{0} != 'W')) { + throw new getid3_exception('Frame not allowed in ID3v2.'.getid3_id3v2_write::major_version.': '.$frame_name); + } + break; + } + } + + return true; + } + + + static public function ID3v2IsValidPriceString($price_string) { + + if (getid3_id3v2::LanguageLookup(substr($price_string, 0, 3), true) == '') { + return false; + } elseif (!$this->IsANumber(substr($price_string, 3), true)) { + return false; + } + return true; + } + + + static public function ID3v2IsValidETCOevent($event_id) { + + if (($event_id < 0) || ($event_id > 0xFF)) { + // outside range of 1 byte + return false; + } elseif (($event_id >= 0xF0) && ($event_id <= 0xFC)) { + // reserved for future use + return false; + } elseif (($event_id >= 0x17) && ($event_id <= 0xDF)) { + // reserved for future use + return false; + } elseif (($event_id >= 0x0E) && ($event_id <= 0x16) && (getid3_id3v2_write::major_version == 2)) { + // not defined in ID3v2.2 + return false; + } elseif (($event_id >= 0x15) && ($event_id <= 0x16) && (getid3_id3v2_write::major_version == 3)) { + // not defined in ID3v2.3 + return false; + } + return true; + } + + + static public function ID3v2IsValidSYLTtype($content_type) { + if (($content_type >= 0) && ($content_type <= 8) && (getid3_id3v2_write::major_version == 4)) { + return true; + } elseif (($content_type >= 0) && ($content_type <= 6) && (getid3_id3v2_write::major_version == 3)) { + return true; + } + return false; + } + + + static public function ID3v2IsValidRVA2channeltype($channel_type) { + + if (($channel_type >= 0) && ($channel_type <= 8) && (getid3_id3v2_write::major_version == 4)) { + return true; + } + return false; + } + + + static public function ID3v2IsValidAPICpicturetype($picture_type) { + + if (($picture_type >= 0) && ($picture_type <= 0x14) && (getid3_id3v2_write::major_version >= 2) && (getid3_id3v2_write::major_version <= 4)) { + return true; + } + return false; + } + + + static public function ID3v2IsValidAPICimageformat($image_format) { + + if ($image_format == '-->') { + return true; + } elseif (getid3_id3v2_write::major_version == 2) { + if ((strlen($image_format) == 3) && ($image_format == strtoupper($image_format))) { + return true; + } + } elseif ((getid3_id3v2_write::major_version == 3) || (getid3_id3v2_write::major_version == 4)) { + if ($this->IsValidMIMEstring($image_format)) { + return true; + } + } + return false; + } + + + static public function ID3v2IsValidCOMRreceivedAs($received_as) { + + if ((getid3_id3v2_write::major_version >= 3) && ($received_as >= 0) && ($received_as <= 8)) { + return true; + } + return false; + } + + + static public function ID3v2IsValidRGADname($rgad_name) { + + if (($rgad_name >= 0) && ($rgad_name <= 2)) { + return true; + } + return false; + } + + + static public function ID3v2IsValidRGADoriginator($rgad_originator) { + + if (($rgad_originator >= 0) && ($rgad_originator <= 3)) { + return true; + } + return false; + } + + + static public function is_hash($var) { + + // written by dev-nullØchristophe*vg + // taken from http://www.php.net/manual/en/function.array-merge-recursive.php + if (is_array($var)) { + $keys = array_keys($var); + $all_num = true; + for ($i = 0; $i < count($keys); $i++) { + if (is_string($keys[$i])) { + return true; + } + } + } + return false; + } + + + static public function IsValidMIMEstring($mime_string) { + + if ((strlen($mime_string) >= 3) && (strpos($mime_string, '/') > 0) && (strpos($mime_string, '/') < (strlen($mime_string) - 1))) { + return true; + } + return false; + } + + + static public function IsWithinBitRange($number, $max_bits, $signed=false) { + + if ($signed) { + if (($number > (0 - pow(2, $max_bits - 1))) && ($number <= pow(2, $max_bits - 1))) { + return true; + } + } else { + if (($number >= 0) && ($number <= pow(2, $max_bits))) { + return true; + } + } + return false; + } + + + static public function safe_parse_url($url) { + + $parts = @parse_url($url); + $parts['scheme'] = (isset($parts['scheme']) ? $parts['scheme'] : ''); + $parts['host'] = (isset($parts['host']) ? $parts['host'] : ''); + $parts['user'] = (isset($parts['user']) ? $parts['user'] : ''); + $parts['pass'] = (isset($parts['pass']) ? $parts['pass'] : ''); + $parts['path'] = (isset($parts['path']) ? $parts['path'] : ''); + $parts['query'] = (isset($parts['query']) ? $parts['query'] : ''); + return $parts; + } + + +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// +/////////////////////// + /////////////////////// + //// // probably should be an error, need to rewrite valid_url() to handle other encodings + /////////////////////// + /////////////////////// + /////////////////////// + /////////////////////// + /////////////////////// + + static public function valid_url($url, $allow_user_pass=false) { + + if ($url == '') { + return false; + } + if ($allow_user_pass !== true) { + if (strstr($url, '@')) { + // in the format http://user:pass@example.com or http://user@example.com + // but could easily be somebody incorrectly entering an email address in place of a URL + return false; + } + } + if ($parts = $this->safe_parse_url($url)) { + if (($parts['scheme'] != 'http') && ($parts['scheme'] != 'https') && ($parts['scheme'] != 'ftp') && ($parts['scheme'] != 'gopher')) { + return false; + } elseif (!eregi("^[[:alnum:]]([-.]?[0-9a-z])*\.[a-z]{2,3}$", $parts['host'], $regs) && !IsValidDottedIP($parts['host'])) { + return false; + } elseif (!eregi("^([[:alnum:]-]|[\_])*$", $parts['user'], $regs)) { + return false; + } elseif (!eregi("^([[:alnum:]-]|[\_])*$", $parts['pass'], $regs)) { + return false; + } elseif (!eregi("^[[:alnum:]/_\.@~-]*$", $parts['path'], $regs)) { + return false; + } elseif (!eregi("^[[:alnum:]?&=+:;_()%#/,\.-]*$", $parts['query'], $regs)) { + return false; + } else { + return true; + } + } + return false; + } + + + + + + + + public static function BigEndian2String($number, $min_bytes=1, $synch_safe=false, $signed=false) { + + if ($number < 0) { + return false; + } + + $maskbyte = (($synch_safe || $signed) ? 0x7F : 0xFF); + + $intstring = ''; + + if ($signed) { + if ($min_bytes > 4) { + die('INTERNAL ERROR: Cannot have signed integers larger than 32-bits in BigEndian2String()'); + } + $number = $number & (0x80 << (8 * ($min_bytes - 1))); + } + + while ($number != 0) { + $quotient = ($number / ($maskbyte + 1)); + $intstring = chr(ceil(($quotient - floor($quotient)) * $maskbyte)).$intstring; + $number = floor($quotient); + } + return str_pad($intstring, $min_bytes, "\x00", STR_PAD_LEFT); + } +} + + +?> \ No newline at end of file diff --git a/modules/getid3/write.lyrics3.php b/modules/getid3/write.lyrics3.php new file mode 100644 index 00000000..1b5be946 --- /dev/null +++ b/modules/getid3/write.lyrics3.php @@ -0,0 +1,209 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | write.lyrics3.php | +// | writing module for lyrics3 2.00 tags | +// | dependencies: module.tag.lyrics3.php. | +// | dependencies: module.tag.id3v1.php | +// +----------------------------------------------------------------------+ +// +// $Id: write.lyrics3.php,v 1.5 2006/11/20 16:13:39 ah Exp $ + + + +class getid3_write_lyrics3 extends getid3_handler_write +{ + public $synched; + public $random_inhibited; + + public $lyrics; + public $comment; + public $author; + public $title; + public $artist; + public $album; + public $images; + + + public function read() { + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.lyrics3'); + + $tag = new getid3_lyrics3($engine); + $tag->Analyze(); + + if (!isset($engine->info['lyrics3']['tag_offset_start'])) { + return; + } + + $this->lyrics = @$engine->info['lyrics3']['raw']['LYR']; + $this->comment = @$engine->info['lyrics3']['raw']['INF']; + $this->author = @$engine->info['lyrics3']['raw']['AUT']; + $this->title = @$engine->info['lyrics3']['raw']['ETT']; + $this->artist = @$engine->info['lyrics3']['raw']['EAR']; + $this->album = @$engine->info['lyrics3']['raw']['EAL']; + $this->images = @$engine->info['lyrics3']['raw']['IMG']; + + return true; + } + + + public function write() { + + // remove existing apetag + $this->remove(); + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.id3v1'); + + $tag = new getid3_id3v1($engine); + $tag->Analyze(); + + $apetag = $this->generate_tag(); + + if (!$fp = @fopen($this->filename, 'a+b')) { + throw new getid3_exception('Could not open a+b: ' . $this->filename); + } + + // init: audio ends at eof + $post_audio_offset = filesize($this->filename); + + // id3v1 tag present + if (@$engine->info['id3v1']['tag_offset_start']) { + + // audio ends before id3v1 tag + $post_audio_offset = $engine->info['id3v1']['tag_offset_start']; + } + + // seek to end of audio data + fseek($fp, $post_audio_offset, SEEK_SET); + + // save data after audio data + $post_audio_data = ''; + if (filesize($this->filename) > $post_audio_offset) { + $post_audio_data = fread($fp, filesize($this->filename) - $post_audio_offset); + } + + // truncate file before start of new apetag + fseek($fp, $post_audio_offset, SEEK_SET); + ftruncate($fp, ftell($fp)); + + // write new apetag + fwrite($fp, $apetag, strlen($apetag)); + + // rewrite data after audio + if (!empty($post_audio_data)) { + fwrite($fp, $post_audio_data, strlen($post_audio_data)); + } + + fclose($fp); + clearstatcache(); + + return true; + } + + + protected function generate_tag() { + + // define fields + static $fields = array ( + 'lyrics' => 'LYR', + 'comment' => 'INF', + 'author' => 'AUT', + 'title' => 'ETT', + 'artist' => 'EAR', + 'album' => 'EAL', + 'images' => 'IMG' + ); + + // loop thru fields and add to frames + $frames = ''; + foreach ($fields as $field => $frame_name) { + + // field set? + if ($this->$field) { + $frames .= $frame_name . str_pad(strlen($this->$field), 5, '0', STR_PAD_LEFT) . $this->$field; + } + } + + if (!$frames) { + throw new getid3_exception('Cannot write empty tag, use remove() instead.'); + } + + // header + $result = 'LYRICSBEGIN'; + + // indicator frame + $result .= 'IND00003' . ($this->lyrics ? '1' : '0') . ($this->synched ? '1' : '0') . ($this->random_inibited ? '1' : '0'); + + // other frames + $result .= $frames; + + // footer + $result .= str_pad(strlen($result), 6, '0', STR_PAD_LEFT); + $result .= 'LYRICS200'; + + return $result; + } + + + public function remove() { + + $engine = new getid3; + $engine->filename = $this->filename; + $engine->fp = fopen($this->filename, 'rb'); + $engine->include_module('tag.lyrics3'); + + $tag = new getid3_lyrics3($engine); + $tag->Analyze(); + + if (isset($engine->info['lyrics3']['tag_offset_start']) && isset($engine->info['lyrics3']['tag_offset_end'])) { + + if (!$fp = @fopen($this->filename, 'a+b')) { + throw new getid3_exception('Could not open a+b: ' . $this->filename); + } + + // get data after tag + fseek($fp, $engine->info['lyrics3']['tag_offset_end'], SEEK_SET); + $data_after_lyrics3 = ''; + if (filesize($this->filename) > $engine->info['lyrics3']['tag_offset_end']) { + $data_after_lyrics3 = fread($fp, filesize($this->filename) - $engine->info['lyrics3']['tag_offset_end']); + } + + // truncate file before start of tag and seek to end + ftruncate($fp, $engine->info['lyrics3']['tag_offset_start']); + + // rewrite data after tag + if (!empty($data_after_lyrics3)) { + fseek($fp, $engine->info['lyrics3']['tag_offset_start'], SEEK_SET); + fwrite($fp, $data_after_lyrics3, strlen($data_after_lyrics3)); + } + + fclose($fp); + clearstatcache(); + } + + // success when removing non-existant tag + return true; + } +} + +?> \ No newline at end of file diff --git a/modules/getid3/write.vorbis.php b/modules/getid3/write.vorbis.php new file mode 100644 index 00000000..3f17958c --- /dev/null +++ b/modules/getid3/write.vorbis.php @@ -0,0 +1,166 @@ + | +// | Allan Hansen | +// +----------------------------------------------------------------------+ +// | write.vorbis.php | +// | writing module for vorbis tags | +// | dependencies: vorbiscomment binary. | +// +----------------------------------------------------------------------+ +// +// $Id: write.vorbis.php,v 1.6 2006/12/03 20:02:25 ah Exp $ + + +class getid3_write_vorbis extends getid3_handler_write +{ + + public $comments = array (); + + + public function __construct($filename) { + + if (ini_get('safe_mode')) { + throw new getid3_exception('PHP running in Safe Mode (backtick operator not available). Cannot call vorbiscomment binary.'); + } + + static $initialized; + if (!$initialized) { + + // check existance and version of vorbiscomment + if (!ereg('^Vorbiscomment ([0-9]+\.[0-9]+\.[0-9]+)', `vorbiscomment --version 2>&1`, $r)) { + throw new getid3_exception('Fatal: vorbiscomment binary not available.'); + } + if (strnatcmp($r[1], '1.0.0') == -1) { + throw new getid3_exception('Fatal: vorbiscomment version 1.0.0 or newer is required, available version: ' . $r[1] . '.'); + } + + $initialized = true; + } + + parent::__construct($filename); + } + + + public function read() { + + // read info with vorbiscomment + if (!$info = trim(`vorbiscomment -l "$this->filename"`)) { + return; + } + + // process info + foreach (explode("\n", $info) as $line) { + + $pos = strpos($line, '='); + + $key = strtolower(substr($line, 0, $pos)); + $value = substr($line, $pos+1); + + $this->comments[$key][] = $value; + } + + // convert single element arrays to string + foreach ($this->comments as $key => $value) { + if (sizeof($value) == 1) { + $this->comments[$key] = $value[0]; + } + } + + return true; + } + + + public function write() { + + // create temp file with new comments + $temp_filename = tempnam('*', 'getID3'); + if (!$fp = @fopen($temp_filename, 'wb')) { + throw new getid3_exception('Could not write temporary file.'); + } + fwrite($fp, $this->generate_tag()); + fclose($fp); + + // write comments + $this->save_permissions(); + if ($error = `vorbiscomment -w --raw -c "$temp_filename" "$this->filename" 2>&1`) { + throw new getid3_exception('Fatal: vorbiscomment returned error: ' . $error); + } + $this->restore_permissions(); + + // success + @unlink($temp_filename); + return true; + } + + + protected function generate_tag() { + + if (!$this->comments) { + throw new getid3_exception('Cannot write empty tag, use remove() instead.'); + } + + $result = ''; + + foreach ($this->comments as $key => $values) { + + // A case-insensitive vobiscomment field name that may consist of ASCII 0x20 through 0x7D, 0x3D ('=') excluded. + // ASCII 0x41 through 0x5A inclusive (A-Z) is to be considered equivalent to ASCII 0x61 through 0x7A inclusive (a-z). + if (preg_match("/[^\x20-\x7D]|\x3D/", $key)) { + throw new getid3_exception('Field name "' . $key . '" contains invalid character(s).'); + } + + $key = strtolower($key); + + if (!is_array($values)) { + $values = array ($values); + } + + foreach ($values as $value) { + if (strstr($value, "\n") || strstr($value, "\r")) { + throw new getid3_exception('Multi-line comments not supported (value contains \n or \r)'); + } + $result .= $key . '=' . $value . "\n"; + } + + } + + return $result; + } + + + public function remove() { + + // create temp file with new comments + $temp_filename = tempnam('*', 'getID3'); + if (!$fp = @fopen($temp_filename, 'wb')) { + throw new getid3_exception('Could not write temporary file.'); + } + fwrite($fp, ''); + fclose($fp); + + // write comments + $this->save_permissions(); + if ($error = `vorbiscomment -w --raw -c "$temp_filename" "$this->filename" 2>&1`) { + throw new getid3_exception('Fatal: vorbiscomment returned error: ' . $error); + } + $this->restore_permissions(); + + // success when removing non-existant tag + @unlink($temp_filename); + return true; + } + +} + +?> diff --git a/modules/id3/changelog.txt b/modules/id3/changelog.txt deleted file mode 100644 index 253f43b2..00000000 --- a/modules/id3/changelog.txt +++ /dev/null @@ -1,2375 +0,0 @@ -///////////////////////////////////////////////////////////////// -/// getID3() by James Heinrich // -// available at http://getid3.sourceforge.net // -// or http://www.getid3.org // -///////////////////////////////////////////////////////////////// -// // -// changelog.txt - part of getID3() // -// See readme.txt for more details // -// /// -///////////////////////////////////////////////////////////////// - - » denotes a major feature addition/change - ¤ denotes a change in the returned structure -* Bugfix: denotes a fixed bug - -Version History -=============== - -1.7.2: [2004-10-18] Allan Hansen - * Bugfix: Large ID3v2 tags inside ASF not parsed properly under PHP5. - * Bugfix: Certain Wavpack3 files failed under PHP5 due to new - undocumented tmpfile() limit (same problem as above). - * Bugfix: New iTunes crashes PHP - temp fix - no tags on those - files. - ¤ Trim/unset wavpack encoder_options to match 2.0.0b2 output. - » Added support for WavPack v4.0+ (thanks ahØartemis*dk) - » Removed code for parsing EXE files (thanks ahØartemis*dk) - Removed file: module.misc.exe.php - * Bugfix: ['nsv']['NSVs']['framerate_index'] might be wrong - (thanks ahØartemis*dk) - * Bugfix: transparent color was wrong from truecolor PNG - (thanks ahØartemis*dk) - * Bugfix: Changed MPC SV7 header size from 30 to 28, this will - change hash values for MPC files (thanks ahØartemis*dk) - * Bugfix: Changed MPC SV4-6 header size from 28 to 8, this will - change hash values for MPC files (thanks ahØartemis*dk) - ¤ Commented-out unknown/unused values in NSV and ISO modules - (thanks ahØartemis*dk) - - -1.7.1b1: [July-26-2004] James Heinrich - » Added support for Apple Lossless Audio Codec - » Added support for RealAudio Lossless - » Added support for TTA v3 - » Added support for TIFF - New file: /getid3/module.graphic.tiff.php - » Modified iconv_fallback to work with UTF-8, UTF-16, UTF-16LE, - UTF-16BE and ISO-8859-1 even if iconv() and/or XML support is - not available. This means that iconv() is no longer required - for most users of getID3() - (thanks Jeremia, khleeØbitpass*com) - » Added support for Monkey's Audio v3.98+ (thanks ahØartemis*dk) - » Included new demo showing most-basic getID3() usage - New file: /demos/demo.basic.php - * Bugfix: LAME3.94+ presets cached incorrectly if multiple files - are scanned in one batch and first file is LAME3.93 or earlier - (thanks enoyandØyahoo*com) - * Bugfix: Added warning if compressed ID3v2 frame decompression - fails. (thanks Mike Billings) - * Bugfix: Assorted small fixes to ensure compatability with PHP5 - * Bugfix: ID3v1 genre "Blues" could not be written - (thanks Jeremia) - * Bugfix: ['bitrate_mode'] typo in module.audio-video.real.php - (thanks asukakenjiØusers*sourceforge*net) - * Bugfix: ['zip']['files'] is now populated with filenames even - if End Of Central Directory couldn't be parsed - * Bugfix: ['audio']['lossless'] was incorrect for FLAC - (thanks WaldoMonster) - * Bugfix: MD5 File was incorrect in directory browse mode for - /demo/getid3.browse.php - * Bugfix: PHP v5 compatability changes (float array keys, fread() - calls with zero data length) - (thanks getid3Øjsc*pp*ru) - * Bugfix: was dying if on compressed ID3v2 frames if - gzuncompress() function was unavailable - * Bugfix: ['vqf']['COMM'] was always empty - * Bugfix: MIDI playtime was missing for single-track MIDI files - * Bugfix: removed � characters from ['comments_html'] - (thanks p*quaedackersØplanet*nl) - * Bugfix: improved MIDI playtime accuracy - (thanks joelØoneporpoise*com) - * Bugfix: BMP subtypes 4 and 5 were not being identified - * Bugfix: frame_rate in AVI was incorrectly truncated to integer - * Bugfix: FLAC cuesheet track index was incorrect - (thanks tetsuo*yokozukaØoperamail*com) - ¤ ['quicktime']['display_scale'] now contains the playback scale - multiplier for QuickTime movies - a movie set to playback at - double-size will have "2" here. Other values are "1" and "0.5" - ¤ Added LAME preset guessing for --preset medium with v3.90.3 - (thanks phwipØfish*co*uk) - ¤ Added $encoding_id3v1 to allow for ID3v1 encodings other than - the standard ISO-8859-1 - ¤ Default AVI video bitrate_mode is now 'vbr' - (thanks eltoderØpisem*net) - Force getID3() to abort if Shorten files have ID3 or APE tags - (thanks ahØartemis*dk) - Editable textbox for parent directory in demo.browse.php - (thanks eltoderØpisem*net) - - -1.7.0-hotfix [2004-03-17] Allan Hansen - (hotfix version released by Allan Hansen) - * Bugfix: PHP 4.1.x compatiblity - fgets($fp) => fgets($fp, 1024) - * Bugfix: Added default charset to TextEncodingNameLookup() in - module.tag.id3v2.php - Ø Removed option_no_iconv - iconv() support is only a requirement for WMA/WMW/ASF, and for - destination encodings other than ISO-8859-1 and UTF-8, iconv is - not needed otherwise. New 'iconv_req' in GetFileFormatArray() - only set for WMA/WMV/ASF. analyze() now refuses to analyse - WMA/ASF file if iconv is not present. - iconv_fallback() only dies on internal errors not missing iconv() - - -1.7.0: [January-19-2004] James Heinrich - » Added support for RIFF/CDXA files (MPEG video in RIFF container - format (thanks chrisØdigitekdesign*com) - » Added support for TTA v2 (thanks ahØartemis*dk) - ¤ ID3v2 unsynchronisation scheme disabled by default because most - tag-reading programs cannot read unsynchronised tags. Can be - overridden by setting id3v2_use_unsynchronisation to true. - (thanks mikeØdelusion*org) - ¤ extention.*.php renamed to extension.*.php - (thanks tp62Øcornell*edu) - ¤ /demo/demo.check.php renamed to /demo/demo.browse.php - ¤ Added id3v2_paddedlength configuration parameter to WriteTags() - and renamed tag_language to id3v2_tag_language - ¤ MPEG audio layers are now represented as 1, 2 or 3 instead of - 'I', 'II', or 'III' - ¤ Added [audio][wformattag] and [video][fourcc] for WAV and AVI - ¤ Added [audio][streams] which contains one entry for each audio - stream present in the file (usually only one). The data is a - copy of what is usually found in [audio]. If there are multiple - audio streams then [audio] will contain a sum of the bitrates - of all audio streams, and the data format of the first stream - (if streams are of different data types) - ¤ Added BruteForce mode to mp3 scanning. Disabled by default as - it is extremely slow and only files that are broken enough to - not really play will gain any benefit from this. - ¤ Suppress '--resample xxxxx' appended to encoder options for mp3 - with low-quality presets for default sampling frequencies - ¤ Enhanced LAME preset guessing for pre-3.93 with a better lookup - table, --resample/--lowpass guessing (thanks phwipØfish*co*uk) - ¤ RIFF files with non-MP3 contents no longer have - [audio][encoder_options] set - ¤ Added [audio][encoder_options] to audio formats where possible - (including LiteWave, LPAC, OptimFROG, TTA) - ¤ Moved [quantization] and [max_prediction_order] from - [lpac][flags] to just [lpac] - ¤ WavPack flags are now parsed into [wavpack][flags] - * Bugfix: APEtags with ReplayGain information stored with comma- - seperated decimal values (ie "0,95" instead of "0.95") were - giving wrong peak and gain values - * Bugfix: Filesize > 2GB not always detected correctly - * Bugfix: Some ID3v2 frames had data key unset incorrectly - (thanks chrisØdigitekdesign*com) - * Bugfix: Warnings on empty-strings-only comments - * Bugfix: ID3v2 tag writing may have had incorrect padding length - if padded length less than current ID3v2 tag length and - merge_existing_data is false (thanks mikeØdelusion*org) - * Bugfix: hash_data() for SHA1 was broken under Windows - * Bugfix: BigEndian2Float()/LittleEndian2Float() were broken - * Bugfix: LAME header calculated track peaks were incorrect for - LAME3.94a15 and earlier - * Bugfix: AVIs with VBR MP3 audio data reported incorrect bitrate - and bitrate_mode - * Bugfix: AVIs sometimes had incorrect or missing video and total - bitrates - * Bugifx: AVIs sometimes had incorrect ['avdataend'] and - therefore also incorrect data hashes (md5_data, sha1_data) - * Bugfix: ID3v1 genreid no longer returned for Unknown genre - * Bugfix: ID3v1 SCMPX genres were broken - Modified LAME header parsing to correctly process peak track - value for LAME3.94a16+ (thanks Gabriel) - md5_file() and sha1_file() now work under Windows in PHP < 4.2.0 - and 4.3.0 respectively with helper apps - Default md5_data() tempfile location is now system temp directory - instead of same directory as file (thanks towbØtiscali*de) - Improved list of RIFF ['INFO'] comment key translations - More helpful error message when GETID3_HELPERAPPSDIR has spaces - /demo/demo.browse.php now autogets both MD5 and SHA1 hashes for - files < 50MB - Replaced PHP_OS comparisons with GETID3_OS_ISWINDOWS define - (thanks necroticØusers*sourceforge*net) - - -1.7.0b5: [December-29-2003] James Heinrich - » Windows only: Various binary files are now required for some - file formats, especially for tag writing, as well as md5sum - (and other) calculations. These binaries are now stored in the - directory defined as GETID3_HELPERAPPSDIR in getid3.php - (default is /helperapps/ parallel to /getid3/). - Note: This directory must not have any spaces in the pathname. - All neccesary files are available as a seperate download. - See /helperapps/readme.txt for more information - New file: /helperapps/readme.txt - » Unified tag-writing interface for all tag formats - New file: /getid3/write.php - /getid3/write.apetag.php - /getid3/write.id3v1.php - /getid3/write.id3v2.php - /getid3/write.lyrics3.php - /getid3/write.metaflac.php - /getid3/write.vorbiscomment.php - » Added support for Shorten - requires shorten binary (head.exe - is also required under Windows). - New file: /getid3/module.audio.shorten.php - » Added support for RKAU - New file: /getid3/module.audio.rkau.php - » Added (minimal) support for SZIP - New file: /getid3/module.archive.szip.php - » Added MySQL caching extention (thanks ahØartemis*dk) - New file: /getid3/extention.cache.mysql.php - » Added DBM caching extention (thanks ahØartemis*dk) - New file: /getid3/extention.cache.dbm.php - » Added sha1_data hash option (thanks ahØartemis*dk) - » Added option to allow getID3() to skip ID3v2 without parsing it - for faster scanning when ID3v2 data is not required. If you - want to enable this feature delete /getid3/module.tag.id3v2.php - (thanks ahØartemis*dk) - ¤ 8-bit WAV data now calculates MD5 checksums as normal, not - converting to signed data as before, so stored md5_data_source - in FLAC files will no longer match md5_data for the equivalent - decoded 8-bit WAV. A warning will be generated for 8-bit FLAC - files - ¤ Added option_no_iconv option to allow getID3() to work - partially without iconv() support enabled in PHP - (thanks ahØartemis*dk) - ¤ All '*_ascii' keys removed for ASF/WMA/WMV files - ¤ All 'ascii*' keys removed for ID3v2 tags - ¤ Ogg filetypes now return MIME of "application/ogg" instead of - the previous "application/x-ogg" - (thanks blakewattersØusers*sourceforge*net) - ¤ Force contents of ['id3v2']['comments'] to UTF-8 format from - whatever encoding each frame may have (text encoding can vary - from frame to frame in ID3v2) - ¤ MP3Gain information from APE tags suppressed from ['tags'] and - parsed into ['replay_gain'] - ¤ ReplayGain information (all formats) changed from "Radio" and - "Audiophile" to "Track" and "Album" respectively - ¤ ['volume'] and ['max_noclip_gain'] are now available in both - ['replay_gain']['track'] and ['replay_gain']['album'] for all - formats that calculate ReplayGain. - ¤ ['video']['total_frames'] is available for AVIs - ¤ All parsed ID3v2 frame data is now in ['id3v2'][XXXX][#] - (previously some frame types would have numeric array keys if - multiple instances of that frame type were allowed and other - frame types would not) - ¤ ASF/WMA "WM/Picture" images are now parsed in the same manner - as ID3v2 with the image (ex JPEG) data returned in [data] - rather than [value] - * Bugfix: Optional tag processing options were being ignored (ie - ID3v1 still processed even if option_tag_id3v1 == false) - (thanks ahØartemis*dk) - * Bugfix: fixed MultiByteCharString2HTML() for UTF-8 - * Bugfix: Quicktime files not always reporting video frame_rate - * Bugfix: False ID3v1 synch patterns in APE or Lyrics3 tags are - now detected and incorrect ID3v1 data not returned - (thanks sebastian_maresØusers*sourceforge*net for the idea) - * Bugfix: WMA9 Lossless now reported as lossless - * Bugfix: two typos in ID3v1 genre list - * Bugfix: MPEG-2/2.5 ABR/VBR MP3 files had doubled playtime - * Bugfix: MPEG-2/2.5 LayerII (ie MP2: 24/22.05/16kHz) files were - not detected due to incorrect frame length calculation - * Bugfix: MPEG LayerI files were not detected due to incorrect - frame length calculation (must be multiple of slot length) - Added alternative md5_data via system call - twice as fast. Needs - "getID3()-WindowsSupport" to work under Windows. - (thanks ahØartemis*dk) - ID3v2.4 compressed frames are now supported - php_uname() calls changed to use PHP_OS constant - Added SCMPX extensions to ID3v1 genres (0xF0-0xFE) - Obfuscated contributor email address in changelog and sourcecode - Added memory-saving EmbeddedLookup() function for lookup tables - in RIFF and ID3v2 modules (thanks ahØartemis*dk) - Major memory patches to many modules by using - $var = &$INFO_ARRAY_AT_SOME_INDEX - in place of large multi-dimensional array declarations. - Memory saved: RIFF: ~200kB; ID3v2: ~475kB; ASF: ~50kB etc. - (thanks ahØartemis*dk) - - -1.7.0b4: [November-19-2003] James Heinrich - » Support added for MPC files with old SV4-SV6 structure - » RealVideo now properly supported with resolution, framerate, etc - (thanks jcsston) - » RealAudio files with old-style file format (v2-v4) are now - fully supported - » Support added for DolbyDigital WAV files (thanks ahØartemis*dk) - ¤ ['RIFF'] is now ['riff'] to conform to make all root key names - lowercase - ¤ ['OFR'] is now ['ofr'] to conform to make all root key names - lowercase - ¤ ['tags_html'] is now available as a copy of ['tags'] but - with all text replaced with an HTML version of all characters - above chr(127), translated according to whatever the encoding - of the source tag is, in the HTML form Ӓ - ¤ CopyTagsToComments() is now available in getid3_lib - ¤ QuicktimeVR files now return a ['video']['dataformat'] of - 'quicktimevr' instead of 'quicktime' (thanks gtsØtsu*biz) - ¤ Quicktime video files with DivX, Xvid, 3ivx or MPEG4 video - streams now return those names as ['video']['dataformat'] - ¤ MPEG video files are now identified with ['video']['codec'] set - to either 'MPEG-1' or 'MPEG-2' (rather than just 'MPEG'). If you - see a file wrongly identified, please report it! - (thanks fccHandler) - ¤ All bitrate values in ['mpeg']['audio'] is now reported in bps - rather than kbps (ie 128000 instead of 128) for consistancy - ¤ AVIs with MP2 audio now report ['audio']['dataformat'] as 'mp2' - rather than 'wav' (thanks metalbrainØnetian*com) - ¤ Added ['md5_data_source'] for OptimFROG - ¤ AC3 in RIFF-WAV now identified with ['audio']['dataformat'] - returning 'ac3' - ¤ WavPack ['extra_bc'] now returned as integer - ¤ WavPack ['extras'] now returned as 3-element array of integers - ¤ MP3 ['audio']['encoder options'] now returns 'VBR' or 'CBR' only - (no bitrate) if no LAME preset is used, or 'VBR q??' where ?? is - a number 0-100 for Fraunhofer-encoded VBR MP3s - * Bugfix: VBR MP3s could have incorrect bitrate reported - * Bugfix: Quicktime files with MP4 audio were not returning - ['video']['dataformat'] (thanks robØmassive-interactive*nl) - * Bugfix: strpad vs str_pad typo in module.riff.php - (thanks nicojunØusers*sourceforge*net) - * Bugfix: ReplayGain information was often wrong for MPC files - * Bugfix: MD5 and other post-TAIL chunks were not being processed - in module.audio.optimfrog.php - * Bugfix: Undefined variable in table_var_dump() in demo/check.php - * Bugfix: QuickTime files now only return information in [audio] - or [video] if those exist in the file - * Bugfix: WavPack no longer tries to read entire compressed data - chunk - * Bugfix: Properly handle VBR MP3s with "Info" (rather than - "Xing") header frame. foobar2000 adds this to MP3 files when - "Fix MP3 Header" function is used (thanks ahØartemis*dk) - * Bugfix: Fraunhofer VBRI headers for MP3s were assuming 2-byte - entries for TOC rather than using stride, and were ignoring the - scaling value. (thanks sebastianØmaresweb*net) - Several QuickTime atoms have been added to an exclusion list - because they have been observed, but I have no idea what they - are supposed to do so I can't add real support for them, but - they should not generate warnings (robØmassive-interactive*nl) - Old MPC encoder (before v1.06) was return as v0.00, now returned - as 'Buschmann v1.7.0-v1.7.9 or Klemm v0.90-v1.05' - (thanks ahØartemis*dk) - Added check for magic_quotes_runtime and code to disable it if - neccesary (thanks stefan*kischkelØt-online*de) - Added 3ivx fourCCs to module.audio-video.quicktime.php - MP3 and AC3 streams are now parsed when contained inside RIFF-WAV - or RIFF-AVI container formats - Better detection of named presets in LAME 3.93/3.94 - - -1.7.0b3: [October-17-2003] James Heinrich - » AC-3 (aka Dolby Digital) is now supported. - New file: /getid3/module.audio.ac3.php - * Bugfix: ID3v2-writing function Unsynchronise() was broken, which - made ID3v2 tag containing binary data (typically pictures) get - corrupted. (thanks t*coombesØbendigo*vic*gov*au, - i*kuehlbornØndh*net, mikeØdelusion*org, mikeØftl*com) - * Bugfix: Zip comments now returned as array instead of string, - as they're supposed to be. - * Bugfix: Quicktime/MP4 files may have reported extremely low - bitrates (thanks spunkØdasspunk*com) - Improved double-ID3v1 check to prevent false detection when string - "TAG" is present in APE or Lyrics3 - Fixed /demo/simple.php - Fixed /demo/joinmp3.php - Fixed /demo/mimeonly.php - Fixed /demo/write.php - - -1.7.0b2: [October-15-2003] James Heinrich - » TTA Lossless Audio Compressor format now supported. - (http://tta.iszf.irk.ru) - New file: /getid3/module.graphic.tta.php - » PhotoCD (PCD) format now supported. Image data for the three - lowest resolutions (192x128, 384x256, 768x512) can be optionally - extracted. - New file: /getid3/module.graphic.pcd.php - ¤ RIFF-MP3 files now should return the same ['md5_data'] as the - identical MP3 file outside the RIFF container - ¤ Name of LAME preset used (if available, needs LAME v3.90+) - returned in ['mpeg']['audio']['LAME']['preset_used'] and also as - part of ['audio']['encoder_options'] - ¤ VQF module now sets ['audio']['encoder_options'] to i.e. CBR96 - ¤ MP3 module now sets ['audio']['encoder_options'] on CBR files - and all LAME-encoded files - ¤ MPC module now sets ['audio']['encoder_options'] - ¤ Monkey module now sets ['audio']['encoder_options'] - ¤ AAC module now sets ['audio']['encoder_options'] to profile name - ¤ ASF module now sets ['audio']['encoder_options'] - ¤ Ogg module adds ['audio']['encoder_options'] -b 128 on - Ogg Vorbis 1.0+ ABR files - ¤ Ogg module adds ['audio']['encoder_options'] -q N on - Ogg Vorbis 1.0+ VBR files 44k/48k sample rate/stereo files only. - ¤ Ogg module ['audio']['encoder_options'] "Nominal birate: 80k" to - other Ogg Vorbis files. - ¤ ID3v2 track number now returned as string (with leading zeros, - if present in data) rather than integer (thanks Plamen) - ¤ ASF module returns ['asf']['comments']['encoding_time_unix'] if - available (from WM/EncodingTime) - ¤ Fixed /demo/mysql.php and added some new features: - - encoder options - - ID3v2 "Encoded By" - - non-empty comments - - total entries in database summary (totals & averages) - - database version update - * Bugfix: 'UNICODE' iconv() charset changed to 'UTF-16LE' or - 'UTF-16BE' as appropriate - * Bugfix: iconv_fallback() function created in case iconv() fails - * Bugfix: fixed MD5 calls in demo/check.php - * Bugfix: reenabled detection of APE + Lyrics3 tags in same file - * Bugfix: ASF module now returns ID3v1 genre as string instead of - number - patch from Eugene Toder. - * Bugfix: ASF module now reads non-standard field names, - i.e. "date" as well as WM/Year - patch from Eugene Toder. - * Bugfix: ASF module now returns genre as-is if it is not a - standard ID3v1 genre (thanks wonderboy) - * Bugfix: Eliminated false-synch problem in MP3 module - * Bugfix: Fixed missing root ['bitrate'] for most formats - * Bugfix: ['audio']['compression_ration'] missing for MPC - (thanks WaldoMonster) - * Bugfix: NSV module died in 1.7.0b1 - * Bugfix: ASF module died in 1.7.0b1 when WM/Picture preset - * Bugfix: ASF tracknumber incorrect when specified by WM/Track - rather than WM/TrackNumber (thanks jgriffiniiiØhotmail*com) - * Bugfix: MPEG audio+video playtime should now be pretty accurate - (ie within 0.1% variation at most) - (thanks mgrimmØhealthtvchannel*org) - * Bugfix: ID3v2 not being copied to ['tags'] in some cases - * Bugfix: LAME CBR files with Info tag were being incorrectly - flagged as VBR (thanks Jojo) - * Bugfix: LAME tag not being detected for LAME 3.90 (original) - Changed regex pattern match for MP3 to include 3rd byte for more - reliable/accurate pattern matching - Added duplicate-ID3v1 tag checking (two ID3v1 tags, one after the - other) that has been known to occur with iTunes - (thanks towbØtiscali*de) - Added instructions for enabling iconv() support under Windows - Removed some unneccesary debugging code - Suppressed duplicate PHP warnings for missing include files - Included some missing dependencies in various files - /demo/audioinfo.class.php now copies ['audio']['encoder_options'] - - -1.7.0b1: [2003-09-28] Allan Hansen - This beta version was not made by James Heinrich. It was made by - Allan Hansen - please send bug reports on this - beta directly to me. - - James Heinrich will release 1.7.0 final, but it may take some time - to work out the bugs from the major rewrite. - - This version could be called getID3lite. It makes a lot of checks - optional and makes it easy to remove support for undesired formats - - It also is more library-like. Older versions of getID3() declared - an incredible amount of global scope functions and defined several - constants. 1.7.0beta1 still declares constants, but they are all - prepended by GETID3_. It declares no global scope functions - they - are all wrapped into classes. - - » Made getID3() depend on iconv library: compile PHP --with-iconv - » Created new directory structure - Moved all demos to demos/ - Moved all getID3() files to getid3/ - Renamed most files to module.something - Changed header in all module.something to explain what they do - Simply remove all modules you don't need - Wrapped all modules into classes - * Bugfix: Implemented misc patches from Eugene Toder - * Bugfix: Implemented misc patches from "six" - ¤ Added root key 'encoding' - ¤ Added prefix GETID3_ to all defined constants. - ¤ Wrapped getid3.php into getid3 class - ¤ Wrapped getid3.functions.php into getid3_lib class - Removed unused functions - Moved several functions away from getid3.functions.php and - into the files where they are actually used. - Renamed getid3.functions.php to getid3.lib.php - Moved getid3.rgad.php functions into getid3_lib - Moved getid3.getimagesize.php funcitons ingo getid3_lib - ¤ Moved getid3.ogginfo.php into ogg module - ¤ Combined GetTagOnly() and GetAllFileInfo() in method analyze - ¤ Removed redundant and unuseful root keys - 'file_modified_time' == filemtime($filename) - 'md5_file' == md5_file($filename) - 'exist' == file_exists($filename) - ¤ Changed root key ['tags'] from array of string to array of array - of comments. - Simplified code for detecting base path. - Removed ob_ from InitializeFilepointerArray(). That was really a - ugly HACK to get output from fopen. If user want the reason, - he should open the file himself! - Checking for APE tags before lyrics3 - makes Lyrics3 not depend - on APE tag. It seems to work on my test file. - Changed ['error'] and ['warning'] in multiple files to append to - array instead of appending to string. That simplified code in - getid3.php too. - Simplified clean-up procedure: simply remove all empty root keys - Setting tags in individual modules instead of main getid3.php - Made Bonk and ASF modules non-dependent on id3 modules - id3 - optional. - Rewrote HandleAllTags() - simplified and convert comments to - desired encoding. - Replaced all calls to RoughTranslateUnicodeToASCII() in ASF module - with a TrimConvert() method. This uses iconv() for conversion. - It also converts from UNICODE instead of UTF-16BE, as the spec - says it should. - Replaced all calls to RoughTranslateUnicodeToASCII() in id3v2 - module with iconv(). id3v2 module also reads - $ThisFileInfo['encoding'] and converts all comments to this - format. All other formats just add their comments in their - native charset, but every comment field in id3v2 can have a - different encoding, so this is needed. - Did same thing as above with ISO module. However - it does not - work. I need to find out how to specify big-endian unicode != - UNICODING encoding name given to iconv(). - Built-in assume mp3 format in getid3.php - Temporarily nuked root key ['comments'] and CopyCommentsToRoot() - Updated demo/audioinfo.class.php - Updated demo/check.php - some thing don't work! - Other demos are out of order! - - -1.6.5: [October-06-2003] James Heinrich - » Added support for LiteWave (thanks supportØclearjump*com) - Ø Split out speedup info from ['OFR']['OFR']['compression'] into - ['OFR']['OFR']['speedup'] - Ø If EXIF functions for JPEG not available, now warning not error - Ø ID3v2 track number now returned as string (with leading zeros, - if present in data) rather than integer (thanks Plamen) - * Bugfix: now correctly parses cbSize element of WAVEFORMATEX - structure (thanks supportØclearjump*com) - * Bugfix: ASF module now reads non-standard field names, - i.e. "date" as well as WM/Year - patch from Eugene Toder. - * Bugfix: ASF module now returns genre as-is if it is not a - standard ID3v1 genre (thanks wonderboy) - * Bugfix: ['audio']['compression_ration'] missing for MPC - (thanks WaldoMonster) - Prevent infinite loop in MP3 histogram if framelength == 0 - Added wFormatTag values 0x00FF and 0x2001 - 0x2005 - (thanks steveØheadbands*com) - Added "twos" and "sowt" FourCCs for Mac AIFC - - -1.6.4: [June-30-2003] James Heinrich - » Added support for free-format MP3s - (thanks Sebastian Mares for the idea) - » Compressed (Flash 6+) SWF files are now handled properly - (thanks alan*cheungØalumni*ust*hk) - » Added DeleteLyrics3() to getid3.lyrics3.php - » Added FixID3v1Padding() to getid3.putid3.php - » Added new simple MP3-splicing sample file - (thanks tommybobØmailandnews*com for the idea) - New file: getid3.demo.joinmp3.php - » Moved all contents of getid3.putid3.php into either - getid3.id3v1.php or getid3.id3v2.php or getid3.functions.php as - appropriate - Removed file: getid3.putid3.php - ¤ ['error'] and ['warning'] keys now return as arrays, not strings - ¤ New root key for all files: ['file_modified_time'] (UNIX time) - ¤ getid3.demo.scandir.php renamed to getid3.demo.mysql.php - ¤ New demo file returns the MIME type only for a single file - (thanks adminØe-tones*co*uk for the idea) - New file: getid3.demo.mimeonly.php - ¤ Added check for valid ID3v1 padding (strings should be padded - with null characters but some taggers incorrectly use spaces). - A warning will be generated if padding is invalid. New boolean - key ['id3v1']['padding_valid'] indicates padding validity. - ¤ CleanUpGetAllMP3info() removes more useless root keys for - unknown-format files - ¤ Extended LAME information in ['mpeg']['audio']['LAME'] is now - only returned for LAME v3.90+ - ¤ LAME-encoded MP3s now return - ['mpeg']['audio']['LAME']['long_version'] as well as - ['mpeg']['audio']['LAME']['short_version'] - these are identical - in LAME v3.90+ but older versions will report longer more - detailed version information if available - ¤ New Lyrics3 values: ['lyrics3']['raw']['offset_start'] and - ['lyrics3']['raw']['offset_end'] - ¤ New optional parameter on getAPEtagFilepointer() to scan from a - defined offset rather than end-of-file to allow scanning of APE - tags before Lyrics3 tags - ¤ ['tag_offset_start'] and ['tag_offset_end'] are now present in - ['ape'], ['lyrics3'], ['id3v1'] and ['id3v2'] - ¤ Numerous changes to the returned structure and content for La - files, including parsing the seektable (if applicable) and - parsing RIFF data occuring after the end of the compressed audio - data (notably RIFF comments) - (thanks mikeØbevin*de) - ¤ getSWFHeaderFilepointer() now has optional 3rd parameter - $ReturnAllTagData (default == false) which if set to true will - return data on all tags in ['swf']['tags'] - ¤ ['swf']['bgcolor'] now returns the 6-character string - representing the background color in HTML hex color format - (thanks ubergeekØubergeek*tv) - ¤ ['swf']['header']['frame_delay'] is no longer returned - ¤ getQuicktimeHeaderFilepointer() now has two additional optional - parameters: $ReturnAtomData (default == true) and - $ParseAllPossibleAtoms (default == false). Setting - $ReturnAtomData to false will reduce the size of the returned - data array by unsetting ['quicktime']['moov'] before returning. - Leaving $ParseAllPossibleAtoms as false now suppresses parsing - of several atom types that contain very large tables of data - that are not typically useful. Atom type suppressed are: - stts, stss, stsc, stsz, and stco - (thanks ubergeekØubergeek*tv) - ¤ ['fileformat'] no longer set to 'id3' if ID3v1 or ID3v2 tag - detected but no other data format recognized - * Bugfix: La files now return the correct values for - ['avdataoffset'] and ['avdataend'] and therefore the correct - values for ['md5_data'] - note that ['md5_data'] values will not - match values from previous versions of getID3() - the previous - versions were incorrect - (thanks mikeØbevin*de) - * Bugfix: A temporary file was being created in the web server's - root directory (not DocumentRoot) each time ['md5_data'] was - calculated, and not removed due to lack of permissions. Temp - file is now created (as it was supposed to be) in the directory - of the file being examined, or the system temp directory, and - properly removed when done. - * Bugfix: Several incorrect values were being returned inside - ['mpeg']['audio']['LAME'] (thanks bouvigneØmp3-tech*org) - * Bugfix: SWF frame rates values were usually incorrect. - (thanks alan.cheungØalumni*ust*hk and ubergeekØubergeek*tv) - * Bugfix: ID3v2.2 files always flagged 4 bytes of invalid padding - (thanks marcaØmac*com) - * Bugfix: Lyrics3 without ID3v1 was not working properly - * Bugfix: Lyrics3, APE & ID3v1 can all now exist in the same file. - A warning is issued if APE comes after Lyrics3 (because Lyrics3- - aware taggers probably are not APE-aware and therefore won't be - able to find the Lyrics3 tag) (thanks mp3gainØhotmail*com) - * Bugfix: WriteAPEtag() now writes the APE tag before any Lyrics3 - tags (if present) and removes any incorrect ones that are after - existing Lyrics3 tags (thanks mp3gainØhotmail*com) - * Bugfix: RIFF-WAVE file with incorrect NumberOfSamples values in - the 'fact' chunk no longer cause incorrect playtime calculation - (thanks stprasadØindusnetworks*com) - * Bugfix: getid3.demo.simple.php had undefined variables if the - file needed to be deep-scanned with assumeFormat - * Bugfix: fixed previously-incorrect ['avdataend'] values for APE - and Lyrics3 tags in some cases, which in some cases means that - ['md5_data'] is different than previously (now correct) - Much-improved detection of AAC-ADTS, which also means MP3 - format detection should now be nearly twice as fast - Truncated AVIs and WAVs are now reported - Number of new features and bugfixes in getid3.demo.mysql.php - Quicktime 'meta' atoms now parsed, so Quicktime MP4 files can now - return artist, title, album, etc (thanks spunkØdasspunk*com) - Consolidated all comments processing functions (processing the - ['comments'] and ['tags'] keys) into HandleAllTags() which now - also checks to ensure that APE tags are really better than ID3v2 - before using them in ['comments'] - Known issue with Meracl ID3 Tag Writer v1.3.4 truncating last byte - of MP3 file when appending new ID3v1 tag now specifically noted - (rather than generic Probably Truncated File message) - getid3.demo.mysql.php now stores last-modified time for each file - getid3.demo.mysql.php is now case-sensitive for filenames - getid3.demo.mysql.php can generate M3U playlists of any of the - groups of files it can select (duplicate filenames, tag types, - etc.) - getid3.demo.mysql.php can now find mismatched tag contents and - filenames - getid3.demo.check.php now shows total number of errors & warnings - GetFileFormatArray() now matches actual patterns for MP3 files - based on the first two bytes of the file, rather than just the - first one - Simplified DeleteAPEtag() and made it work properly with Lyrics3 - - -1.6.3: [May-17-2003] James Heinrich - » Added support for Bonk (thanks ahØartemis*dk) - New file: getid3.bonk.php - » Added support for AVR (thanks ahØartemis*dk) - New file: getid3.avr.php - ¤ Contents of getid3.id3.php moved to getid3.id3v1.php - Removed file: getid3.id3.php - ¤ Contents of getid3.frames.php moved to getid3.id3v2.php - Removed file: getid3.frames.php - ¤ Returned data structure documentation improved and updated and - now stored in getid3.structure.txt rather than getid3.readme.txt - New file: getid3.structure.txt - ¤ Now including the GNU General Public License in the distribution - as getid3.license.txt - New file: getid3.license.txt - ¤ Added new, optional, parameter to WriteAPEtag() (and also - GenerateAPEtag()) which must be set to TRUE if the values you - are passing are already UTF8-encoded, otherwise all data is - encoded to UTF8 by default. For all ASCII/ANSI data this value - should be left at the defaul value of FALSE. - ¤ Added third, optional, parameter to getID3v2Filepointer() - - $StartingOffset (default == 0) which can parse an ID3v2 tag - in a file at a position other than the start-of-file. - ¤ ['video']['pixel_aspect_ratio'] now returned when known - ¤ AVI files with WMA audio now return ['audio']['dataformat'] - of 'wma' rather than 'wav' - ¤ ASF-WMA files now return the artist value from WM/AlbumArtist - in ['comments']['artist'] (thanks msibbaldØsaebauld*com) - ¤ ASF-WMA files now return the 'author' value from - ['asf']['content_description'] in ['comments']['artist'] - instead of ['comments']['author'] - ¤ ASF-WMA files now return the 'description' value from - ['asf']['content_description'] in ['comments']['comment'] - instead of ['comments']['description'] - * Bugfix: APE tag writing with multiple values for a tag (more - than one ARTIST for example) was not being correctly written - (thanks ahØartemis*dk) - * Bugfix: CreateDeepArray() was returning an empty-string key as - the top-level returned value - ['iso']['files'] now directly - contains the file listing without an empty array in between. - * Bugfix: ID3v2 genreid was not being returned in some cases. - * Bugfix: APEv1 tags would generate error messages - * Bugfix: APE tags would sometimes show phantom second entry for - each item (title, artist, etc) with no data - * Bugfix: APE tag writing was not UTF8-encoding the data - - non-ASCII characters (above chr(127)) were being incorrectly - stored (thanks ahØartemis*dk) - * Bugfix: getid3.demo.scandir.php had undefined function error - * Bugfix: getid3.demo.scandir.php would not display list of files - with no tags - Added link to getid3.demo.check.php from list of specific-tags - files in getid3.demo.scandir.php - - -1.6.2: [May-04-2003] James Heinrich - » New official mirror site for getID3() - http://www.getid3.org - » Added basic support for SWF (Flash) (thanks n8n8Øyahoo*com) - New file: getid3.swf.php - » Added experimental support for parsing the audio portion of - MPEG-video files. I don't have any actual documentation for - this, so this part is experimental and not guaranteed accurate, - but it seems to be working OK as far as I have been able to test - it. Bug reports (or even better - documentation!) are welcome at - info@getid3.org - » Added new simple directory-scanning sample file - New file: getid3.demo.simple.php - » getid3.demo.write.php now writes APE tags as well. - ¤ Renamed getid3.write.php to getid3.demo.write.php - ¤ Renamed audioinfo.class.php to getid3.demo.audioinfo.class.php - ¤ getid3.php now automatically includes the getid3.functions.php - function library file, no need to include it seperately. - ¤ getLyrics3Filepointer() has been changed to be consistant with - all the other similar function structures - the parameters have - changed. The old function has been renamed to getLyrics3Data() - ¤ Added DeleteAPEtag() function to getid3.ape.php - ¤ HandleID3v1Tag() now only handles ID3v1. Lyrics3 processing is - now done by HandleLyrics3Tag() - ¤ If BitrateHistogram is enabled in getOnlyMPEGaudioInfo() it now - also returns ['mpeg']['audio']['version_distribution'] showing - the number of frames of each MPEG version (1, 2 or 2.5) - all - frames *should* be of the same MPEG version - ¤ getID3v1Filepointer() always returns TRUE now, even if it didn't - find a valid ID3v1 tag - ¤ getOnlyMPEGaudioInfo() now looks for MPEG sync in the first 128k - bytes rather than the first 64k bytes - ¤ Added dummy function GetAllMP3info() to generate warning not to - use that deprecated function. - ¤ ['video']['codec'] is now 'MPEG' for all MPEG video files (this - will change to 'MPEG-1' or 'MPEG-2' as soon as I figure out how - to determine that) (thanks jigalØspill*nl) - ¤ ['mpeg']['audio']['LAME']['mp3_gain'] renamed to - ['mpeg']['audio']['LAME']['mp3_gain_db'] (gain in dB) - ¤ Added ['mpeg']['audio']['LAME']['mp3_gain_factor'] (gain as a - multiplication factor) - ¤ Added support for Preset and Surround Info bytes from LAME VBR - tag (http://gabriel.mp3-tech.org/mp3infotag.html) - * Bugfix: APE tag writing would put the string 'Array' for all - values rather than the actual data (thanks ahØartemis*dk) - * Bugfix: Warning now generated for VBR MPEG-video files because - getID3() cannot determine average bitrate. If you know of - documentation that would tell me how to do this, please email - info@getid3.org - * Bugfix: Replay Gain values from Vorbis comments are now - returned in ['replay_gain'] (and not in ['comments']) - (thanks ahØartemis*dk) - * Bugfix: Replay Gain values from APE comments are now correctly - returned in ['replay_gain'] (thanks ahØartemis*dk) - * Bugfix: getid3.demo.check.php is now case-insensitive when - assuming a format for a corrupted file if standard detection - does not identify the file type. - * Bugfix: RIFF comments were overwriting/suppressing ID3 comments - for RIFF-MP3 files (thanks wmØwofuer*com) - * Bugfix: RIFF-MP3 files with 'RMP3' chunks instead of 'WAVE' were - not being correctly identified. - * Bugfix: ID3v2 padding shorter than the length of an ID3v2 frame - header was not correctly detected - * Bugfix: getid3.demo.check.php now does in-depth scanning for MP2 - and MP1 files the same as for MP3 files based on file extension - if a MPEG-audio structure isn't found immediately at the start - of the file - * Bugfix: removed condition where RIFF-WAV was being scanned for - MPEG-audio signature when it shouldn't be present (non-MP3 WAV) - * Bugfix: ASF files were not always showing correct audio datatype - * Bugfix: array_merge_clobber() and array_merge_noclobber() were - not being conditionally defined in getid3.functions.php - (thanks rich.martinØreden-anders*com) - * Bugfix: stream_numbers was not being correctly returned in - bitrate_mutual_exclusion_object chunks of ASF files - * Bugfix: Added support for 24kHz and 12kHz audio in ASF files - * Bugfix: Removed possible undefined offset error in MP3s where - cannot find synch before end of file - * Bugfix: Removed potential out-of-memory crash situation when - parsing Real files with chunks larger than the available memory - (thanks jigalØspill*nl) - * Bugfix: ID3v1 was incorrectly taking precedence over ID3v2 in - the ['comments'] array (thanks lionelflØwanadoo*fr) - * Bugfix: No longer calculates overall bitrate and playtime for - VBR MPEG video files based on the audio bitrate. - * Bugfix: AssumeFormat was not working properly - Added summary footer line to getid3.demo.check.php - Added '.mpeg' to the list of assume-format-from-filenames list in - getid3.demo.check.php - MPEG-video files now more reliably detected - A number of additional features have been added to - getid3.demo.scandir.php - Added many RIFF-AVI audio types and fourcc video types to the - lookup functions in getid3.riff.php - Now identifes files with Lyrics3 v1 tags that are of incorrect - length (v1 Lyrics3 is supposed to be 5100 bytes long, but - [unknown program] writes variable-length tags (which is illegal - for Lyrics3 v1)). getID3() now correctly parses these tags and - issues a warning. - Split GetFileFormat() to GetFileFormat() and GetFileFormatArray() - HTML colors in getid3.demo.check.php are now defined as constant - variables at the top of the file (if you want to change them) - Added support for OptimFROG v4.50x (non-alpha) (new header fields) - (thanks floringhidoØyahoo*com) - Added support for Lossless Audio v0.4 (thanks mikeØbevin*de) - - -1.6.1: [March-03-2003] James Heinrich - » Added support for writing APE v2. - WriteAPEtag() in getid3.ape.php - NOTE: APE v1 writing support will *not* be added to future - versions of getID3() - (thanks ahØartemis*dk and adamØphysco*com for the idea) - » Added support for AIFF (Audio Interchange File Format) including - AIFF, AIFC and 8SVX (thanks ahØartemis*dk for the idea) - Removed file: getid3.aiff.php - » Added support for OptimFROG (v4.50a and v4.2x) - (thanks ahØartemis*dk for the idea) - New file: getid3.optimfrog.php - » Added support for WavPack (thanks ahØartemis*dk for the idea) - » Added support for LPAC (thanks ahØartemis*dk for the idea) - » Added support for NeXT/Sun .au format - New file: getid3.au.php - » Added support for Creative SoundBlaster VOC format - New file: getid3.voc.php - » Added support for the BWF (Broadcast Wave File) RIFF chunks - "bext" and "MEXT" (thanks Ryan and njhØsurgeradio*co*uk) - » Added support for the CART (Broadcast Wave File) RIFF chunks - (thanks Ryan) - » Added getid3.demo.scandir.php - a sample recursive scanning demo - that scans every file in a given directory, and all sub- - directories, and stores the resulting data in MySQL database, - and then displays a list of duplicate files based on md5_data - ¤ ['md5_data_source'] now contains the MD5 value for the original - uncompressed data for formats that store that information - (currently only FLAC v0.5+). ['md5_data'] (if chosen to be - calculated) will contain the calculated MD5 value for the - compressed file. To check if 2 files are identical in every way, - including all comments: compare ['md5_file']. To check if two - files were compressed from the same source file: compare - ['md5_data_source']. To check if the compressed audio/video data - of two files is identical, even if comments or even the - container file format is different (MP3 in RIFF container, - FLAC in Ogg container, etc): compare ['md5_data']. - ¤ ['md5_data'] for 8-bit WAV files is now calculated based on a - converted version of the data from unsigned to signed (MSB - inverted) to match the MD5 value calculated by FLAC - ¤ New optional parameter added to GetAllFileInfo() - - $MD5dataIfMD5SourceKnown (default: false). If false the md5_data - value will NOT be calculated for files (such as FLAC) that have - ['md5_data_source'] set, even if $MD5data == true. - (thanks ahØartemis*dk) - ¤ getid3.check.php renamed to getid3.demo.check.php - ¤ Added GetTagOnly() function to getid3.php - similar to - GetAllFileInfo() except only takes a filename as a parameter and - only returns ID3v2, APE, Lyrics3 and ID3v1 tag information - no - attempt is made to parse the data contents of the file at all. - (thanks Phil for the idea) - ¤ Added ['audio']['lossless'] and ['video']['lossless'] for all - formats (when known). Both are boolean values - true means the - data is lossless-compressed, false means the data is lossy- - compressed. - ¤ Added ['audio']['compression_ratio'] and/or - ['video']['compression_ratio'] for all formats. Returns a number - (usually) less than 1, where 1 represents no compression and 0.5 - represents a compressed file half the size of the original file - ¤ Added ['video']['bits_per_sample'] to all video formats (when - known) - ¤ Added ['video']['frame_rate'] to all video formats (when known) - ¤ ['fileformat'] set to 'mp1' or 'mp2' instead of 'mp3' when - ['audio']['dataformat'] is one of those (thanks ahØartemis*dk) - ¤ Added 4th parameter to md5_data(), $invertsign, which will invert - the MSB of each byte before MD5'ing. This is needed for 8-bit - WAV files because FLAC calculates the stored MD5 value on - signed data rather than the original byte values. ['md5_data'] - of an 8-bit WAV will now match the ['md5_data_source'] value - (thanks lichvarmØphoenix*inf*upol*cz) - ¤ ['ape']['items']['data'] and ['ape']['items']['data_ascii'] now - contains an array of values, if the tag contains UTF-8 text (as - opposed to binary data) - ¤ ['mpeg']['audio']['bitratemode'] renamed to - ['mpeg']['audio']['bitrate_mode'] - * Bugfix: Removed potential bug that could replace all MP3 file - contents with only the new ID3v2 tag in getid3.putid3.php - * Bugfix: md5_data values calculated for RIFF (WAV, AVI) files - were incorrect (thanks ahØartemis*dk) - * Bugfix: MP3 data in an MP4 wrapper fileformat could not identify - bitrate (thanks ahØartemis*dk) - * Bugfix: ['audio'] and/or ['video'] keys would sometimes get - removed even if not empty - * Bugfix: Prevented creation of null entries in - ['RIFF']['WAVE']['INFO'] if a comment entry was not present - * Bugfix: Potential infinite-loop condition in getid3.ogg.php - (thanks afshin.behniaØsbcglobal*net) - * Bugfix: Ogg files with illegal ID3v1 (and/or APE or Lyrics3) - tags were not finding the last Ogg page - (thanks afshin.behniaØsbcglobal*net) - * Bugfix: replay-gain values not properly set from LAME tag - * Bugfix: RIFF-MP3 had incorrect md5_data - * Bugfix: the LAME DLL CBR problem of not re-writing the LAME - frame at the beginning of the data is now detected for MP3s - with ID3v2 tags as well - * Bugfix: APE tags with multiple values (ie multiple entries in - the "artist" tag) are now shown properly in ['ape']['items'] - * Bugfix: fixed condition where APE tag with no ID3v1 tag could be - mistaken for APE tag with ID3v1 (and incorrectly parsed) - * Bugfix: added warning if ID3v2 frame has zero-length data - (thanks cmassetØclubinternet*fr) - * Bugfix: getid3.frames.php looking for non-existant key in USER - frames - Improved detection of RIFF-MP3 data. [unknown program] encodes - RIFF-WAV data with a chunk name of 'RMP3' instead of the - standard 'RIFF' - Encoder now returned in both ['comments'] and ['audio']['encoder'] - for RIFF-WAV files with an INFO.ISFT chunk - Generate a warning for FLAC files encoded with v0.3 or v0.4 - because audio_signature is not calculated during encoding - (thanks ahØartemis*dk) - Modified getid3.check.php to display md5_data_source as well as - md5_file and md5_data if display-MD5 mode is selected - Modified getid3.check.php to assume-format based on file extension - in browse mode if fileformat is found to be 'id3' (formerly only - if the fileformat was null) - Changed scaling of BitrateColor() from representing 1-256kbps to - representing 1-768kbps for better display of high-bitrate files, - specifically lossless-compressed CD-audio (FLAC, LA, etc) - - -1.6.0: [January-30-2003] James Heinrich - » Added support for OggFLAC (FLAC data stored in an Ogg container) - (thanks ahØartemis*dk for the idea) - » Added support for Speex (the data stored in an Ogg container) - » Comments are now available in the root 2-dimensional array - ['comments'] - each entry in this array will contain one or more - strings. For example, if there are two artists then - ['comments']['artist'][0] will contain the first one and - ['comments']['artist'][1] the other. All keys are forced - lowercase. Comments will be stored in the ['comments'] array in - this order of precedence: - 1) Native format tags (ASF, VQF, NSV, RIFF, Quicktime, Vorbis) - 2) APE tags - 3) ID3v2 - 4) Lyrics3 - 5) ID3v1 - Lower-priority tags will not overwrite or append existing values - of higher-priority tags (for example, 'artist' in ID3v1 will be - ignored if already specified in APE), but missing values will be - filled in (for example, if 'album' is specified in ID3v2 but not - in APE, it will be included in the ['comments'] array). - Note: Root keys (['title'], ['artist'], etc) are NOT available - in this or future versions of getID3(). - (thanks ahØartemis*dk) - » MD5 hashes are now available for all formats for both the entire - file (['md5_file']) and the portion of the file containing only - the audio/video data, stripped of all prepended/appended tags - like ID3v2, ID3v1, APE, etc - ['md5_data'] - (thanks ahØartemis*dk for alternate md5_file() function that - runs on UNIX system running PHP < 4.2.0) - NOTE: Ogg files require the use of vorbiscomment to obtain the - md5_data value. vorbiscomment must be downloaded from - http://www.vorbis.com/download.psp and placed in the getID3() - directory. All Ogg formats (Vorbis, OggFLAC, Speex) are affected - by this problem, but only OggVorbis files can be processed with - vorbiscomment. OggFLAC and Speex files will be processed by - getID3(), but this may result in an incorrect value for md5_data - in the event that VorbisComments are larger than 1 page (4-8kB). - NOTE: md5_data for Ogg will not work if PHP is running in Safe - Mode - » There is now a wrapper class available, written by Allan Hansen, - which should simplify extracting most common basic information - (such as format, bitrate, comments). - New file: audioinfo.class.php - » OggWrite() in getid3.ogginfo.php has been replaced with a new - version that uses vorbiscomment to write the comments, because - of a reported bug that can corrupt OggVorbis files such they - cannot be played. - NOTE: Ogg comment writing now requires the use of vorbiscomment - which must be downloaded from http://www.vorbis.com/download.psp - and placed in the getID3() directory. - NOTE: Ogg comment writing will not work if PHP is running in - Safe Mode - ¤ New root key ['tags'] is now always returned for all formats. - It is an array that may contain any of: - * Native format tags: 'vqf', 'riff', 'vorbiscomment', 'asf', - 'nsv', 'real', 'midi', 'zip', 'quicktime' - * Appended data tags: 'ape', 'lyrics3', 'id3v2', 'id3v1' - ¤ New root key ['audio'] is an array containing any or all of: - codec, channels, channelmode, bitrate, bits_per_sample, - dataformat, bitrate_mode, sample_rate, encoder - Note: This replaces several root keys, including: - bitrate_audio, bits_per_sample, frequency, channels - ¤ New root key ['video'] is an array containing any or all of: - bitrate_mode, bitrate, codec, resolution_x, resolution_y, - resolution_y, frame_rate, encoder - Note: This replaces several root keys, including: - bitrate_video, resolution_x, resolution_y, frame_rate - ¤ ['id3']['id3v1'] has moved to ['id3v1'] - ¤ ['id3']['id3v2'] has moved to ['id3v2'] - ¤ ['audiodataoffset'] and ['audiodataend'] have been renamed to - ['avdataoffset'] and ['avdataend'] respectively - ¤ GetAllMP3info() has been changed to GetAllFileInfo() with a - different parameter list ($allowedFormats is no longer a - parameter). Check your code where you're calling - GetAllMP3Info() - you will need to change both the function - name and the parameter list if you pass more than 2 parameters - ¤ All formats now return ['audio']['dataformat'] and/or - ['video']['dataformat'] where appropriate - this goes along with - ['fileformat'] - ['fileformat'] will return the actual structure - of the file, whereas ['dataformat'] will return the format of - the data inside that structure. For example, an Ogg file can - contain Vobis data (normal), or it can contain FLAC data in the - Ogg container format. In that case, ['fileformat'] would be - 'ogg', but ['dataformat'] would be 'flac'. - Note: this means that WAV and AVI files now return a - ['fileformat'] of 'riff' rather than 'wav' or 'avi'. - ¤ ['filesize'] is no longer returned for files larger than 2GB - because PHP does not support large file access. Attempting to - parse a file larger than 2GB will result in a message stored in - ['error'] and ['filesize'] not set. - ¤ APEtag, ID3v1, and ID3v2 are now supported on ALL multimedia - files - even if illegal by format. Ogg will return warning if - ID3/APE tags are present. (thanks ahØartemis*dk) - ¤ All files: non-critical errors are now returned in the root key - ['warning'] rather than ['error'] (only critical errors that - prevent getID3() from correctly parsing the file are returned in - ['error'] (thanks ahØartemis*dk) - ¤ Renamed all references to $MP3fileInfo to $ThisFileInfo - ¤ Joliet now supported for ISO-9660. - ['iso']['supplementary_volume_descriptor'] is now returned, if - available, and ['iso']['files'] will contain ASCII equivalents - of the Unicode directory structure & filenames stored. - ¤ Moved Monkey's Audio code from getid3.ape.php to seperate file. - New file: getid3.monkey.php - ¤ Added new keys for ISO-9660: ['name_ascii'] for directories, - ['file_identifier_ascii'] for files - ¤ Added root key ['track'] for CD-audio files - ¤ Ogg/Vorbis-comment files now have comments returned inside - ['ogg']['comments_common'] as an array of strings, rather than - simple strings in ['ogg'] - ¤ Quicktime files now have comments returned inside - ['quicktime']['comments'] as an array of strings, rather than - simple strings in ['quicktime'] - ¤ ['mime_type'] is a new root key returned for all supported - formats (thanks ahØartemis*dk) - ¤ ['fileformat'] now returns 'mp1' instead of 'mp3' for MPEG-1 - layer-I audio files (thanks ahØartemis*dk) - ¤ ['mpeg']['audio']['bitratemode'] now returns lowercase - ¤ MPEG-4 audio files which consist of MP3 data wrapped in a - Quicktime fileformat will now return the usual data in - ['mpeg']['audio'] - ¤ Type-1 DV AVIs are now supported - ¤ DV AVIs will return 1 or 2 in ['RIFF']['video'][x]['dv_type'] - ¤ Changed ['fileformat'] from 'mpg' to 'mpeg' for MPEG video files - ¤ ASF comments are now stored in ['asf']['comments'] instead of - ['asf'] - ¤ RealMedia chunk data is now returned inside ['real']['chunks'] - instead of ['real'] - ¤ ['replay_gain'] now properly populated from APE tags - ¤ Added support for ASF_Old_ASF_Index_Object in ASF files - (thanks ahØartemis*dk) - ¤ AAC-ADTS files now return ['aac']['bitrate_distribution'] - ¤ ParseVorbisComments() has been replaced with - ParseVorbisCommentsFilepointer() (with different parameters) - ¤ All references to any key ['frequency'] are now ['sample_rate'] - ¤ Moved ID3v2 comments from ['id3v2'] into common root - ['comments'] structure, and now returns more values than before - * Bugfix: ['iso']['files'] and ['zip']['files'] could potentially - contain duplicate entries (in a numeric-indexed array) for files - if the directory structure specifies files multiple times. - Entries are now guaranteed unique, with the last entry for the - file overwriting any former ones. - * Bugfix: RIFF parsing had numerous issues, including: - - large AVIs would take a very very long time to parse - - chunks with odd (not even) sizes would cause the parser fail - - video and/or audio codecs not always identified - The ParseRIFF() function has been completely rewritten and fixes - all known issues with RIFF parsing. Users are, however, - encouraged to double-check output of any parsed (AVI/WAV/CDDA) - files. - * Bugfix: Modified getid3.riff.php to return correct total - bitrates for AVIs with multiple audio streams - * Bugfix: GetFileFormat() was not creating array structure - correctly (thanks ahØartemis*dk) - * Bugfix: LAME tag for MP3s can only specify up to 255kbps, so any - files with actual CBR bitrate of >=256 were reported incorrectly - * Bugfix: Lyrics3 synched lyrics were not being correctly returned - * Bugfix: CreateDeepArray() was broken for non-nested cases, which - meant ZIP and ISO ['files'] structures were broken - * Bugfix: Incorrect pattern matching for ZIP files meant no zip - files were being detected as such - * Bugfix: AAC-ADIF was returning an incorrect number of channels - (too few) in some cases (thanks ahØartemis*dk) - * Bugfix: Vorbis comments were returning an incorrect value for - ['dataoffset'] in some cases - * Bugfix: MPEG video ['marker_bit'] and ['vbv_buffer_size'] were - incorrect - * Bugfix: ['playtime_string'] could potentially have a value of - x minutes and 60 seconds (ie 3:60 instead of 4:00) - Added support for FLAC cuesheets (FLAC 1.1.0+) - (thanks ahØartemis*dk) - Improved parsing speed in MP3, MP2 and AAC (thanks ahØartemis*dk) - Extra error-checking added to try and identify corrupt files for - most audio formats (thanks ahØartemis*dk) - More accurate playtime calculation for RealMedia - (thanks ahØartemis*dk) - Changed all relevant files to use ['audiodataoffset'] and - ['audiodataend'] rather than ['filesize'] where appropriate - (thanks ahØartemis*dk) - Added text encoding type 255 as a duplicate of UTF-16BE but with - Big-Endian rather than Little-Endian byte order - Added many RIFF-AVI audio types and fourcc video types to the - lookup functions in getid3.riff.php - Added numerous new known GUIDs to getid3.asf.php - Added PoweredBygetID3() function to easily get a "powered by" - string with the current getID3() version. - Added "Morgan Multimedia Motion JPEG2000" (MJ2C), "DivX v5" (DX50) - and "XviD" (XVID) codecs to list of known codecs in - getid3.riff.php - Changed GETID3_INCLUDEPATH path seperators to forced / - (from \ for Windows) - Modified getid3.check.php to only change \ directory seperators to - / on Windows operating systems - Modified getid3.check.php to handle larger-than-2GB files (which - now do not return a filesize) - Modified getid3.check.php to handle ['dataformat_audio'] and - ['dataformat_video'] - Modified getid3.check.php to show a list of present tags in one - column rather than one column for each of ID3v1, ID3v2, etc - Modified getid3.check.php to show MD5 values. Initially disabled - but can be enabled for a directory with a click. md5_file is - always calculated when displaying detailed info about a single - file; md5_data is calculated if the file is < 50MB - Modified getid3.check.php to show errors and warnings. Details are - visible with a mouseover or a click. - Changed getid3.check.php to use SafeStripSlashes instead of a - manual conditional directory name replacement for special - characters - Added sample recursive scanning sample code to getid3.readme.txt - (thanks lipisinØmail*ru for the idea) - - -1.5.7: [January-10-2003] James Heinrich - » Added support for ISO 9660 (CD-ROM image) format. Most-useful - data is directory structure returned under ['iso']['files'] - Note: Only ISO-9660 supported, not (yet) Joliet extension - (thanks nebula_djØsofthome*net for the idea) - New file: getid3.iso.php - ¤ ZIP files are now parsed by getID3() itself without relying on - built-in PHP functions and/or ZZipLib support. - (thanks Vince for the idea) - ¤ ZIP files now return a simple directory listing with filename - and filesize info only under ['zip']['files']. - Note: empty subdirectories will note appear in here, only files - and non-empty subdirectories. Information for all entries, - including empty subdirectories, is available under - ['zip']['central_directory'] (or under ['zip']['entries'] if the - Central Directory cannot be located (usually due to a trucated - file). - ¤ RIFF-WAV files with MP3 data (or MP3s with RIFF headers, if you - want to think of it that way) now have the MPEG audio portion - scanned and the usual data returned in ['mpeg']['audio'] if the - RIFF audio codec has wFormatTag of "85" (identified by getID3() - as "MPEG Layer 3") - (thanks ahØartemis*dk for the idea) - ¤ EXIF data (if present) is returned for JPEG files under - ['jpg']['exif'] (thanks nebula_djØsofthome*net) - ¤ ['filepath'] now returned for all files with the directory part - of the full filename. - ¤ ['filenamepath'] is now returned for all files (equivalent to - ['filepath'].'/'.['filename']) - * Bugfix: ['id3']['id3v2'][]['dataoffset'] was wrong - * Bugfix: MP3s tagged with iTunes have an invalid comment field - frame name ('COM ' - should be 'COMM') but the data is valid - otherwise; the frame is now renamed to 'COMM' and parsed - normally (with the error noted in ['error']) - (thanks kheller2Ømac*com for the sample file) - * Bugfix: Some ASF/WMA audio files were not being identified as - any format (thanks ahØartemis*dk) - * Bugfix: Warning now generated and ASCII format assumed for - invalid text encoding values in ID3v2 - * Bugfix: Changed ZIP detection pattern from 'PK' to 'PK\x04\x03' - * Bugfix: Ogg/FLAC files with large Vorbis comments were dying in - an infinite loop with lots of error messages due to missing $fd - parameter on ParseVorbisComments() (thanks ahØartemis*dk) - * Bugfix: ['data'] and ['image_mime'] were being returned for all - Ogg comments even if they were not images for versions of PHP - that have image_type_to_mime_type() built in (ie PHP 4.3.0+) - - -1.5.6: [December-31-2002] James Heinrich - » Added support for NSV (Nullsoft Streaming Video) - (www.nullsoft.com/nsv/) - (thanks demonØsoundplanet*com for the idea) - New file: getid3.nsv.php - » Added support for CD-audio track files (track01.cda etc) - ¤ Added standard ['frame_rate'] root value when known (AVI, NSV, - MPEG-video) - ¤ ASF files now report ['fileformat'] of: - 'wmv' when Windows Media Video codec v7/v8/v9 is used; - 'wma' when any 'Windows Media Audio' named audio codec is used - and no video stream is present; - 'asf' in all other cases (audio-only, video-only, or both) - ¤ Removed support for ZIP functions (will be rewritten to not - require ZZIPlib support in future versions) - ¤ Added function SafeStripSlashes() as a drop-in replacement for - stripslashes(), but that only strips slashes if magic_quotes_gpc - is set - ¤ Removed support for remote file scanning (HTTP / FTP) - ¤ Added ['aac']['frames'] (number of AAC frames in file) - ¤ Added ['mpeg']['audio']['frame_count'] when a bitrate histogram - is created - ¤ Average bitrate for VBR MP3/MP2 is calculated from actual counts - of frames of various bitrates (rather than relying on the header - values or filesize) when a bitrate histogram is created - ¤ RecursiveFrameScanning() split out into seperate function - (getid3.mp3.php) - ¤ Removed old function getMP3header() from getid3.mp3.php - ¤ Changed default MPEG_VALID_CHECK_FRAMES (number of mp3 frames - scanned to ensure a valid audio sequence has been located) from - 10 to 25. This means scanning will be slightly slower, but more - reliable/accurate - * Bugfix: ID3v2.2 - valid frame names not correctly detected - (thanks maeckerØweb*de for the sample file) - * Bugfix: ID3v2.2 - valid padding not correctly detected - (thanks maeckerØweb*de for the sample file) - * Bugfix: MIDI files with flat key signatures were not being - correctly reported (thanks alexleeisØshaw*ca for sample file) - * Bugfix: now returns message in ['error'] if file does not exist - * Bugfix: ['RIFF']['video'][x]['codec'] wasn't always being - correctly populated - * Bugfix: ['bitrate'] was incorrect for multi-stream RealMedia - * Bugfix: ['playtime_seconds'] was sometimes null or incorrect - for multi-stream RealMedia - * Bugfix: ChannelTypeID was incorrect in RVA2 ID3v2.4 frames - * Bugfix: Fixed potential divide-by-zero error for corrupt FLAC - files (thanks ahØartemis*dk) - * Bugfix: AAC-ADTS was not returning ['bitrate_mode'] unless - $ReturnExtendedInfo was TRUE (thanks ahØartemis*dk) - * Bugfix: LAME-encoded CBR MP3s now properly identified as CBR - with correct bitrate (thanks ahØartemis*dk) - * Bugfix: VBR MP2 (or headerless MP3) is now identified as VBR - rather than CBR. Note: to obtain VBR bitrate for headerless - files, the entire file is scanned and a histogram distribution - of bitrates is created, and the average bitrate calculated from - that. (thanks ahØartemis*dk for sample file) - Added support for DSIZ chunks in VQF, and checks to make sure size - of audio data matches DSIZ value, if present - (thanks ahØartemis*dk for sample file) - Rewrote GetAllMP3info() - removed some unneccesary code, changed - format-detection routine from ParseAsThisFormat() to - GetFileFormat() to allow for more flexible format parsing - (needed for ISO CD-ROM images, helpful for Quicktime and others) - Changed references in all files from string-cast indexes: ["$i"] - to non-cast indexes: [$i] where appropriate - Put a sans-serif 9pt style on all text in getid3.check.php - getAACADTSheaderFilepointer() now return TRUE if synch is lost - after the first frame has been successfully parsed (previously - it would return FALSE if synch was lost at any time, meaning the - file is most likely MP3, which was incorrect) - (thanks ahØartemis*dk for sample file) - Speed improvement code changes to getid3.mp3.php (up to 24% faster - in some cases) (thanks ahØartemis*dk for the code) - Changed all include_once() to require_once() - - -1.5.5: [November-25-2002] James Heinrich - » Added support for La (Lossless Audio - www.lossless-audio.com) - (thanks ahØartemis*dk for the idea) - New file: getid3.la.php - ¤ Moved lookup functions from getid3.lookup.php to the files where - they are used. - New file: getid3.id3.php - New file: getid3.rgad.php - Removed file: getid3.lookup.php - ¤ getID3v1Filepointer() returns FALSE if ID3v1 tag not found - ¤ Added new paramter "ReturnExtendedInfo" to the function - getAACADTSheaderFilepointer() in getid3.aac.php which now - defaults to FALSE - if TRUE then the data for every frame is - returned (containing aac_frame_length, adts_buffer_fullness and - num_raw_data_blocks, which aren't usually very useful). Speed - improvement with FALSE is about 35%. - ¤ Now returns fopen() errors in ['error'], for example if a remote - file is not accessible. - ¤ Changed default number of MP3 audio frames to scan to determine - if a valid stream has been found from 5 to 10, now also defined - as a constant at the top of getid3.mp3.php This will result in - slightly slower MP3 parsing, but greater reliability in - detecting false/invalid/corrupted VBR headers. - ¤ fopen() errors now displayed in getid3.putid3.php - (thanks miguel.dieckmannØhamburg*de) - ¤ Added 4th parameter to decodeMPEGaudioHeader() $ScanAsCBR which - will force an MP3 audio frame sequence to be force-scanned in - CBR mode. You should never need to call this directly, it's only - used internally to scan for MP3 files that have an illegal VBR - header with CBR data. (thanks fletchØpobox*com) - * Bugfix: ASF_Marker_Object in getid3.asf.php was always returning - an error in non-existant "reserved_1" and failing - * Bugfix: VBR bitrate calculations in getid3.mp3.php only occur if - ['mpeg']['audio']['VBR_frames'] is defined. - (thanks fletchØpobox*com) - * Bugfix: getid3.putid3.php no longer deletes original MP3 if - ID3v2 tag writing fails (thanks miguel*dieckmannØhamburg*de) - * Bugfix: incorrect order of if-statement error messages in - getid3.putid3.php (thanks miguel*dieckmannØhamburg*de) - getid3.asf.php now notes the error and continues parsing rather - than failing when it encounters an error parsing a chunk - Now actually scan 1000 frames for AAC ADTS as reported in the - v1.5.4 changelog, rather than 100. (thanks ahØartemis*dk) - Improved scanning speed in getAACADTSheaderFilepointer() by ~30% - (thanks ahØartemis*dk for the fix) - Added FileSizeNiceDisplay() function to getid3.functions.php for - formatting filesize output in kB, MB, GB, etc. - - -1.5.4: [October-07-2002] James Heinrich - » Added support for Quicktime. - New file: getid3.quicktime.php - » Added support for AAC files, both ADTS and ADIF header formats. - ADIF format is a pain because it's very similar to standard MP3 - header format, and it's hard to distinguish between the two. I - have tried to make the detection accurate, but I have a limited - number of AAC test files to play with so if you have an AAC file - that gets detected as MP3/MP2 (or vice-versa), please send me - the details via email at getid3Øsilisoftware*com - ADTS format is very slow to parse because to get the bitrate of - VBR files the whole file has to be stepped through frame by - frame (getID3() scans up to the first 1000 frames and assumes - that to be close enough). - Note: I would suggest commenting out support for AAC (see top of - GetAllMP3info() function in getid3.php) unless you need it. - (thanks jfaulØgmx*de for the idea and sample Delphi source code) - New file: getid3.aac.php - » Added bitrate distribution analysis option for MP3 VBR files. A - new boolean parameter for getOnlyMPEGaudioInfo() enabled this - feature which steps through the MP3 file frame by frame and - counts how many frames of each bitrate exist. This information - is returned in ['mpeg']['audio']['bitrate_distribution'] - Caution: this feature is very inefficient for large files and - takes a very long time and does lots of disk I/O. Use with care. - ¤ Changed layout of allowedFormats in GetAllMP3info() function in - getid3.php to allow easy removal of support for any of the - supported format. As stated above, I recommend commenting out - AAC unless needed. - ¤ Added ['flac']['compressed_audio_bytes'], - ['flac']['uncompressed_audio_bytes'], and - ['flac']['compression_ratio'] - ¤ Replaced FXPT2DOT30toFloat() function with FixedPoint2_30() - * Bugfix: getid3.mpc.php was slightly miscalculating the number of - samples, therefore also bitrate and playtime - (thanks ahØartemis*dk for the fix) - * Bugfix: MonkeyCompressionLevelNameLookup() didn't know about - 'insane' compression (thanks ahØartemis*dk for the fix) - * Bugfix: MonkeySamplesPerFrame() was incorrect for MAC v3.95+ - (thanks ahØartemis*dk for the fix) - * Bugfix: getid3.check.php wasn't processing the assumeFormat - directive when (register_globals == off) - * Bugfix: detecting of synch pattern for MP3 files with invalid - data at the beginning wasn't always correct, also meant possible - incorrect bitrate/duration/etc info for such corrupt files. - getid3.functions.php now includes a replacement utf8_decode() - function for those PHP installations that are not configured - with the --with-xml option. (thanks stephaneØtekartists*com) - - -1.5.3: [September-30-2002] James Heinrich - » Added support for VQF. (thanks mtØmansonthomas*com for the idea) - New file: getid3.vqf.php - » Added support for FLAC. Comments, if present, are returned under - ['ogg'] because they follow the Ogg Vorbis structure standard. - New file: getid3.flac.php - ¤ OS/2-format bitmaps are now correctly interpreted. The format of - the bitmap is now returned in ['bmp']['type_os'] and - ['bmp']['type_version']. OS/2 bitmaps can be v1 or v2, Windows - can be v1, v4 or v5 - - -1.5.2: [September-25-2002] James Heinrich - » Support for RealMedia (audio & video) added - Note: only tested on G2 and v5 audio and video files - if anyone - has older and/or newer sample files, please test it and/or send - me the sample files. - (thanks stephaneØtekartists*com for idea) - New file: getid3.real.php - » Support for BMP added. Palette and pixel data can optionally be - extracted as well - this is slow and generally unneccesary, but - the option is there if you need it. Also includes PlotBMP() - which will take the extracted pixel data and output it as a true - color PNG. This function requires GD v2.0+ - Note: Untested on 16-bit and 32-bit BMPs because I couldn't find - any sample files - if you know of a program that can create such - files, please email getid3Øsilisoftware*com - Note: Support for RGB (uncompressed), RLE8 and RLE4 is included - and tested. BITFIELDS support is also included for 16- & 32-bit - formats, but it's untested, so if anybody has any test files - please send them to getid3Øsilisoftware*com - Note: Support currently only for Windows-format BMPs, and trying - to parse an OS/2-format bitmap leads to unpredictable/invalid - results. - New file: getid3.bmp.php - » PNG now fully parsed, including all information chunks - New file: getid3.png.php - ¤ Support for GIF/JPG/PNG moved to seperate files and expanded, - including standard ['resolution_x'] and ['resolution_y'] as well - as more thorough parsing of header information - New file: getid3.gif.php - New file: getid3.jpg.php - table_var_dump() simplified and now outputs {-style character - entities for characters outside the normal alphanumeric range - CleanOggCommentName() changed to a regular expression - (thanks chris-getid3Øbolt*cx for rewriting the function) - - -1.5.1: [September-20-2002] James Heinrich - » Added support for MPEGplus/Musepack SV7. ['fileformat'] is 'SV7' - for version 7 files (versions 4, 5 ,6 and 8 are not supported - yet, but will be of ['fileformat'] SV4, SV5, SV6 and SV8) when - they are supported (thanks Christian Fritz for the idea) - New file: getid3.mpc.php - ¤ ['bitrate_audio'], ['bitrate_video'], ['bitrate_mode'], - ['channels'], ['resolution_x'], and ['resolution_y'] keys added - for all appropriate formats - ¤ Ogg files with a COVERART comment now save and display the - attached image the same way as is done with ID3v2 APICs - ¤ ['ogg']['comments'][n]['data'] and - ['ogg']['comments'][n]['dataoffset'] is now returned for all - comments. ['ogg']['comments'][n]['data'] is only useful if - the field is supposed to contain binary data. It is a - base64_decode()'d version of ['value']. - ['ogg']['comments'][n]['dataoffset'] is the byte offset in the - file at which the 'COMMENTNAME=value string' starts, not the - start of just 'value' - ¤ ['ogg']['comments'][n]['image_mime'] is now returned if - ['ogg']['comments'][n]['data'] contains valid image data. - ¤ More than 3 Ogg pages may now be read in, if the comment data - is longer than 1 page (usually about 4kB) - ¤ ['fileformat'] is now 'mp2' rather than 'mp3' if it's MPEG-1, - Layer-II audio - ¤ ASF bitrates now calculated even if stream_bitrate_properties - object not present - ¤ ['asf']['stream_properties_object'] is now a numeric-key array - with one entry for each stream - the key being the stream number - ¤ ['replay_gain'] is returned for all audio formats that support - it (MP3-LAME, ID3v2, Ogg) (thanks Christian Fritz for the idea) - ¤ ['mpeg']['audio']['LAME']['RGAD']['radio_replay_gain'] is now - ['mpeg']['audio']['LAME']['RGAD']['radio'] (same for audiophile) - ¤ ASF/WMA files now use WM/Track to get track number from if - WM/TrackNumber is not available (thanks stephaneØtekartists*com) - ¤ ASF/WMV files now returns ['year'] and ['asf']['year'] - ¤ ASV/WMV files now use ['content_description']['description'] for - the ['comment'] field (thanks stephaneØtekartists*com) - ¤ ['track'] is now always returned as an integer - * Bugfix: Ogg comments that are larger than one data page (usually - about 4kB) are now correctly parsed (thanks Christian Fritz) - * Bugfix: Ogg comment data is now UTF8-decoded - * Bugfix: Ogg comment writing now UTF8-encodes the data - * Bugfix: playtime for ASF files was off by (usually - between 3 and 12 seconds) - * Bugfix: ['asf']['stream_properties_objects']['flags'] data was - possibly incorrect - * Bugfix: ASF Padding Object was overwriting - Stream Bitrate Properties Object data (now returned correctly in - ['asf']['padding_object'] - * Bugfix: ASF Marker Object Reserved_2 field was incorrect - * Bugfix: ASF Bitrate Mutual Exclusion Object had incorrect stream - numbers - Warning displayed if incorrectly-formatted Ogg comment is present - (known to be an issue with CDex v1.40, but fixed by v1.50b7) - (thanks Christian Fritz) - Ogg comment writing now checks for valid comment names - Added bitrate column in getid3.check.php, and added some formatting - (font, colour) - Performance tweaks using bitwise math instead of binary string - operations - - -1.5.0: [September-18-2002] James Heinrich - » Ogg comment writing support added. getid3.write.php has been - updated to allow for writing comment tags to both MP3 and Ogg. - Big thanks to Chris Bolt for writing the - OggWrite() function and offering it for inclusion in getID3() - New file: getid3.ogginfo.php - » Support for Monkey's Audio and APE tag added. - (thanks Christian Fritz for the idea) - New file: getid3.ape.php - ['fileformat'] now returns 'mac' for Monkey's Audio files, or - 'ape' for files with an APE tag (Monkey's Audio or other format) - » getid3.thumbnail.php has been removed from the distribution and - the table_var_dump() function now outputs APICs as seperate - files in the same directory as the analyzed file. This should - make the image-displaying more reliable as well as reduce - complexity. The naming convention for the images is - filename.ext.[byte offset of APIC data].[jpg|gif|png] - If anybody still has any problems with corrupted images please - let me know at getid3Øsilisoftware*com - » Support for extended Xing/LAME tag - (see http://users.belgacom.net/gc247244/extra/tag.html) - Data is returned in ['mpeg']['audio']['LAME'] - ¤ ['ogg']['tracknumber'] has been renamed to ['ogg']['track'] and - ['track'] is now returned in the root of the array - ¤ ['ogg']['pageheader'][n]['flag'] has been renamed to - ['ogg']['pageheader'][n]['flags'] and the unprocessed flag byte - is available in ['ogg']['pageheader'][n]['flags_raw'] - ¤ ['frequency'] is now returned for WAVE files in the root of the - array (thanks danielØelectroteque*org) - ¤ ASF files now return codec, bitrate, resolution, etc information - under ['asf']['video_media'] or ['asf']['audio_media'] - * Bugfix: RVA2 and EQU2 writing in getid3.putid3.php were - incorrectly writing Volume Adjustment field - * Bugfix: EQU2 in getid3.frames.php was reading Volume Adjustment - as unsigned integer instead of signed integer - * Bugfix: handling of remote files over HTTP & FTP was broken - (thanks Vince) - * Bugfix: incorrect handling of some ASF packets - ASF/Windows Media format now more fully parsed, including Index - Objects - Added several new fourCC video codecs - - -1.4.3: [September-15-2002] James Heinrich - » Now parses ASF / WMV / WMA files - ¤ New file: getid3.asf.php - * Bugfix: RoughTranslateUnicodeToASCII() would return nothing - if didn't find a terminator it was expecting - Added FILETIMEtoUNIXtime() function (for converting 64-bit - Microsoft FILETIME timestamps, used in ASF files and elsewhere, - to UNIX Epoch timestamps) - Added GUIDtoBytestring() and BytestringToGUID() functions - - -1.4.2: [September-12-2002] James Heinrich - » getID3() now requires PHP v4.1.0 or higher because it now is - designed to work with register_globals = off and the new auto- - globals ($_GET, $_SERVER, etc). - * Bugfix: VBR MP3 files with Fraunhofer-style VBR header were not - being correctly detected in most cases - (thanks dkushnerØoddcast*com and mikeØftl*com for sample files) - * Bugfix: IsValidTextEncoding() was broken - * Bugfix: Add stripslashes($EditorFilename) to getid3.write.php - (writing was broken for files with ' or " in the filename) - (thanks mikeØftl*com and kthejoker) - * Bugfix: If there is garbage data between a valid VBR header - frame and a sequence of valid MPEG-audio frames the VBR data is - no longer discarded. (thanks to mikeØftl*com for sample - Fraunhofer-style VBR file produced with MusicMatch v7.2) - ¤ Changed variable system to work with (register_globals = off) - ¤ Moved relevant code into seperate PlaytimeString() function - ¤ Added nl2br() to table_var_dump() for cleaner output - ¤ Now returns the following keys from Fraunhofer-VBR files: - ['VBR_seek_offsets'], ['VBR_seek_offsets_stride'], - ['VBR_offsets_relative'] and ['VBR_offsets_absolute'] - ¤ Added ID3v1matchesID3v2() function and implemented in - getid3.check.php (thanks to "Guest" in the forums for the idea) - Changed amount of data read in getid3.getimagesize.php from 10kB - to entire file. (thanks mikeØftl*com) - Wrapped function_exists() checks around function definitions in - getid3.functions.php - Fixed a lot of E_WARNING and E_NOTICE situations, especially in - ID3-writing code (getid3.putid3.php, etc) - Added checks to make sure all needed data is available for writing - ID3v2 tags - - -1.4.1b5: [May-30-2002] James Heinrich - * Bugfix: Unsynchronise() was broken, now fixed - (thanks mikeØftl*com) - * Bugfix: GenerateID3v2Tag() now correctly uses non-synchsafe - integers for frame size descriptors in ID3v2.3 and ID3v2.2 - (thanks mikeØftl*com) - ¤ Added ['artist'], ['title'], etc keys to root of returned - array to provide a common place to access any returned info - from any file type. Currently gets info from ID3v1, ID3v2, - Ogg, and RIFF/WAVE. Possible returned keys are: - title, artist, album, year, genre, comment, track - ¤ Modified LookupGenre() function to search for either genre based - on numeric ID, or now reverse lookup as well - ¤ Added ['artist'], ['title'], etc keys to ['RIFF'] information - if info tags are present - Added functionality to attach a picture to the ID3v2 tag in - getid3.write.php - Sorted genres into alphabetical order (special 3 at end of list) - in getid3.write.php - Changed the comment-edit field in getid3.write.php to a multi-line -