Ticket #23673: 23673.diff

wp-admin/includes/image.php

@@ -116 +116 @@
                 if ( $image_meta )
                         $metadata['image_meta'] = $image_meta;
 
+        } elseif ( preg_match( '#^video/#', get_post_mime_type( $attachment ) ) ) {
+                $metadata = wp_read_video_metadata( $file );
+        } elseif ( preg_match( '#^audio/#', get_post_mime_type( $attachment ) ) ) {
+                $metadata = wp_read_audio_metadata( $file );
         }
 
         return apply_filters( 'wp_generate_attachment_metadata', $metadata, $attachment_id );

new file wp-includes/ID3/class-getid3.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// Please see readme.txt for more information                  //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+// define a constant rather than looking up every time it is needed
+if (!defined('GETID3_OS_ISWINDOWS')) {
+        define('GETID3_OS_ISWINDOWS', (stripos(PHP_OS, 'WIN') === 0));
+}
+// Get base path of getID3() - ONCE
+if (!defined('GETID3_INCLUDEPATH')) {
+        define('GETID3_INCLUDEPATH', dirname(__FILE__).DIRECTORY_SEPARATOR);
+}
+
+// attempt to define temp dir as something flexible but reliable
+$temp_dir = ini_get('upload_tmp_dir');
+if ($temp_dir && (!is_dir($temp_dir) || !is_readable($temp_dir))) {
+        $temp_dir = '';
+}
+if (!$temp_dir && function_exists('sys_get_temp_dir')) {
+        // PHP v5.2.1+
+        // sys_get_temp_dir() may give inaccessible temp dir, e.g. with open_basedir on virtual hosts
+        $temp_dir = sys_get_temp_dir();
+}
+$temp_dir = realpath($temp_dir);
+$open_basedir = ini_get('open_basedir');
+if ($open_basedir) {
+        // e.g. "/var/www/vhosts/getid3.org/httpdocs/:/tmp/"
+        $temp_dir     = str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $temp_dir);
+        $open_basedir = str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $open_basedir);
+        if (substr($temp_dir, -1, 1) != DIRECTORY_SEPARATOR) {
+                $temp_dir .= DIRECTORY_SEPARATOR;
+        }
+        $found_valid_tempdir = false;
+        $open_basedirs = explode(PATH_SEPARATOR, $open_basedir);
+        foreach ($open_basedirs as $basedir) {
+                if (substr($basedir, -1, 1) != DIRECTORY_SEPARATOR) {
+                        $basedir .= DIRECTORY_SEPARATOR;
+                }
+                if (preg_match('#^'.preg_quote($basedir).'#', $temp_dir)) {
+                        $found_valid_tempdir = true;
+                        break;
+                }
+        }
+        if (!$found_valid_tempdir) {
+                $temp_dir = '';
+        }
+        unset($open_basedirs, $found_valid_tempdir, $basedir);
+}
+if (!$temp_dir) {
+        $temp_dir = '*'; // invalid directory name should force tempnam() to use system default temp dir
+}
+// $temp_dir = '/something/else/';  // feel free to override temp dir here if it works better for your system
+define('GETID3_TEMP_DIR', $temp_dir);
+unset($open_basedir, $temp_dir);
+
+// End: Defines
+
+
+class getID3
+{
+        // public: Settings
+        public $encoding        = 'UTF-8';        // CASE SENSITIVE! - i.e. (must be supported by iconv()). Examples:  ISO-8859-1  UTF-8  UTF-16  UTF-16BE
+        public $encoding_id3v1  = 'ISO-8859-1';   // Should always be 'ISO-8859-1', but some tags may be written in other encodings such as 'EUC-CN' or 'CP1252'
+
+        // public: Optional tag checks - 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
+        public $option_tags_process      = true;  // Copy tags to root key 'tags' and encode to $this->encoding
+        public $option_tags_html         = true;  // Copy tags to root key 'tags_html' properly translated from various encodings to HTML entities
+
+        // public: Optional tag/comment calucations
+        public $option_extra_info        = true;  // Calculate additional info such as bitrate, channelmode etc
+
+        // public: Optional handling of embedded attachments (e.g. images)
+        public $option_save_attachments  = true; // defaults to true (ATTACHMENTS_INLINE) for backward compatibility
+
+        // public: Optional calculations
+        public $option_md5_data          = false; // Get MD5 sum of data part - slow
+        public $option_md5_data_source   = false; // Use MD5 of source file if availble - only FLAC and OptimFROG
+        public $option_sha1_data         = false; // Get SHA1 sum of data part - slow
+        public $option_max_2gb_check     = null;  // Check whether file is larger than 2GB and thus not supported by 32-bit PHP (null: auto-detect based on PHP_INT_MAX)
+
+        // public: Read buffer size in bytes
+        public $option_fread_buffer_size = 32768;
+
+        // Public variables
+        public $filename;                         // Filename of file being analysed.
+        public $fp;                               // Filepointer to file being analysed.
+        public $info;                             // Result array.
+        public $tempdir = GETID3_TEMP_DIR;
+
+        // Protected variables
+        protected $startup_error   = '';
+        protected $startup_warning = '';
+        protected $memory_limit    = 0;
+
+        const VERSION           = '1.9.5-20130220';
+        const FREAD_BUFFER_SIZE = 32768;
+
+        const ATTACHMENTS_NONE   = false;
+        const ATTACHMENTS_INLINE = true;
+
+        // public: constructor
+        public function __construct() {
+
+                // Check for PHP version
+                $required_php_version = '5.0.5';
+                if (version_compare(PHP_VERSION, $required_php_version, '<')) {
+                        $this->startup_error .= 'getID3() requires PHP v'.$required_php_version.' or higher - you are running v'.PHP_VERSION;
+                        return false;
+                }
+
+                // Check memory
+                $this->memory_limit = ini_get('memory_limit');
+                if (preg_match('#([0-9]+)M#i', $this->memory_limit, $matches)) {
+                        // could be stored as "16M" rather than 16777216 for example
+                        $this->memory_limit = $matches[1] * 1048576;
+                } elseif (preg_match('#([0-9]+)G#i', $this->memory_limit, $matches)) { // The 'G' modifier is available since PHP 5.1.0
+                        // could be stored as "2G" rather than 2147483648 for example
+                        $this->memory_limit = $matches[1] * 1073741824;
+                }
+                if ($this->memory_limit <= 0) {
+                        // memory limits probably disabled
+                } elseif ($this->memory_limit <= 4194304) {
+                        $this->startup_error .= 'PHP has less than 4MB available memory and will very likely run out. Increase memory_limit in php.ini';
+                } elseif ($this->memory_limit <= 12582912) {
+                        $this->startup_warning .= 'PHP has less than 12MB available memory and might run out if all modules are loaded. Increase memory_limit in php.ini';
+                }
+
+                // Check safe_mode off
+                if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
+                        $this->warning('WARNING: Safe mode is on, shorten support disabled, md5data/sha1data for ogg vorbis disabled, ogg vorbos/flac tag writing disabled.');
+                }
+
+                if (intval(ini_get('mbstring.func_overload')) > 0) {
+                        $this->warning('WARNING: php.ini contains "mbstring.func_overload = '.ini_get('mbstring.func_overload').'", this may break things.');
+                }
+
+                // Check for magic_quotes_runtime
+                if (function_exists('get_magic_quotes_runtime')) {
+                        if (get_magic_quotes_runtime()) {
+                                return $this->startup_error('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 for magic_quotes_gpc
+                if (function_exists('magic_quotes_gpc')) {
+                        if (get_magic_quotes_gpc()) {
+                                return $this->startup_error('magic_quotes_gpc must be disabled before running getID3(). Surround getid3 block by set_magic_quotes_gpc(0) and set_magic_quotes_gpc(1).');
+                        }
+                }
+
+                // Load support library
+                if (!include_once(GETID3_INCLUDEPATH.'getid3.lib.php')) {
+                        $this->startup_error .= 'getid3.lib.php is missing or corrupt';
+                }
+
+                if ($this->option_max_2gb_check === null) {
+                        $this->option_max_2gb_check = (PHP_INT_MAX <= 2147483647);
+                }
+
+
+                // Needed for Windows only:
+                // Define locations of helper applications for Shorten, VorbisComment, MetaFLAC
+                //   as well as other helper functions such as head, tail, md5sum, etc
+                // This path cannot contain spaces, but the below code will attempt to get the
+                //   8.3-equivalent path automatically
+                // IMPORTANT: This path must include the trailing slash
+                if (GETID3_OS_ISWINDOWS && !defined('GETID3_HELPERAPPSDIR')) {
+
+                        $helperappsdir = GETID3_INCLUDEPATH.'..'.DIRECTORY_SEPARATOR.'helperapps'; // must not have any space in this path
+
+                        if (!is_dir($helperappsdir)) {
+                                $this->startup_warning .= '"'.$helperappsdir.'" cannot be defined as GETID3_HELPERAPPSDIR because it does not exist';
+                        } elseif (strpos(realpath($helperappsdir), ' ') !== false) {
+                                $DirPieces = explode(DIRECTORY_SEPARATOR, realpath($helperappsdir));
+                                $path_so_far = array();
+                                foreach ($DirPieces as $key => $value) {
+                                        if (strpos($value, ' ') !== false) {
+                                                if (!empty($path_so_far)) {
+                                                        $commandline = 'dir /x '.escapeshellarg(implode(DIRECTORY_SEPARATOR, $path_so_far));
+                                                        $dir_listing = `$commandline`;
+                                                        $lines = explode("\n", $dir_listing);
+                                                        foreach ($lines as $line) {
+                                                                $line = trim($line);
+                                                                if (preg_match('#^([0-9/]{10}) +([0-9:]{4,5}( [AP]M)?) +(<DIR>|[0-9,]+) +([^ ]{0,11}) +(.+)$#', $line, $matches)) {
+                                                                        list($dummy, $date, $time, $ampm, $filesize, $shortname, $filename) = $matches;
+                                                                        if ((strtoupper($filesize) == '<DIR>') && (strtolower($filename) == strtolower($value))) {
+                                                                                $value = $shortname;
+                                                                        }
+                                                                }
+                                                        }
+                                                } else {
+                                                        $this->startup_warning .= 'GETID3_HELPERAPPSDIR must not have any spaces in it - use 8dot3 naming convention if neccesary. You can run "dir /x" from the commandline to see the correct 8.3-style names.';
+                                                }
+                                        }
+                                        $path_so_far[] = $value;
+                                }
+                                $helperappsdir = implode(DIRECTORY_SEPARATOR, $path_so_far);
+                        }
+                        define('GETID3_HELPERAPPSDIR', $helperappsdir.DIRECTORY_SEPARATOR);
+                }
+
+                return true;
+        }
+
+        public function version() {
+                return self::VERSION;
+        }
+
+        public function fread_buffer_size() {
+                return $this->option_fread_buffer_size;
+        }
+
+        // public: setOption
+        public function setOption($optArray) {
+                if (!is_array($optArray) || empty($optArray)) {
+                        return false;
+                }
+                foreach ($optArray as $opt => $val) {
+                        if (isset($this->$opt) === false) {
+                                continue;
+                        }
+                        $this->$opt = $val;
+                }
+                return true;
+        }
+
+        public function openfile($filename) {
+                try {
+                        if (!empty($this->startup_error)) {
+                                throw new getid3_exception($this->startup_error);
+                        }
+                        if (!empty($this->startup_warning)) {
+                                $this->warning($this->startup_warning);
+                        }
+
+                        // init result array and set parameters
+                        $this->filename = $filename;
+                        $this->info = array();
+                        $this->info['GETID3_VERSION']   = $this->version();
+                        $this->info['php_memory_limit'] = $this->memory_limit;
+
+                        // 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');
+                        }
+
+                        $filename = str_replace('/', DIRECTORY_SEPARATOR, $filename);
+                        $filename = preg_replace('#(.+)'.preg_quote(DIRECTORY_SEPARATOR).'{2,}#U', '\1'.DIRECTORY_SEPARATOR, $filename);
+
+                        // open local file
+                        if (is_readable($filename) && is_file($filename) && ($this->fp = fopen($filename, 'rb'))) {
+                                // great
+                        } else {
+                                throw new getid3_exception('Could not open "'.$filename.'" (does not exist, or is not a file)');
+                        }
+
+                        $this->info['filesize'] = filesize($filename);
+                        // set redundant parameters - might be needed in some include file
+                        $this->info['filename']     = basename($filename);
+                        $this->info['filepath']     = str_replace('\\', '/', realpath(dirname($filename)));
+                        $this->info['filenamepath'] = $this->info['filepath'].'/'.$this->info['filename'];
+
+
+                        // option_max_2gb_check
+                        if ($this->option_max_2gb_check) {
+                                // PHP (32-bit all, and 64-bit Windows) doesn't support integers larger than 2^31 (~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 = fseek($this->fp, 0, SEEK_END);
+                                if (($fseek < 0) || (($this->info['filesize'] != 0) && (ftell($this->fp) == 0)) ||
+                                        ($this->info['filesize'] < 0) ||
+                                        (ftell($this->fp) < 0)) {
+                                                $real_filesize = getid3_lib::getFileSizeSyscall($this->info['filenamepath']);
+
+                                                if ($real_filesize === false) {
+                                                        unset($this->info['filesize']);
+                                                        fclose($this->fp);
+                                                        throw new getid3_exception('Unable to determine actual filesize. File is most likely larger than '.round(PHP_INT_MAX / 1073741824).'GB and is not supported by PHP.');
+                                                } elseif (getid3_lib::intValueSupported($real_filesize)) {
+                                                        unset($this->info['filesize']);
+                                                        fclose($this->fp);
+                                                        throw new getid3_exception('PHP seems to think the file is larger than '.round(PHP_INT_MAX / 1073741824).'GB, but filesystem reports it as '.number_format($real_filesize, 3).'GB, please report to info@getid3.org');
+                                                }
+                                                $this->info['filesize'] = $real_filesize;
+                                                $this->error('File is larger than '.round(PHP_INT_MAX / 1073741824).'GB (filesystem reports it as '.number_format($real_filesize, 3).'GB) and is not properly supported by PHP.');
+                                }
+                        }
+
+                        // set more parameters
+                        $this->info['avdataoffset']        = 0;
+                        $this->info['avdataend']           = $this->info['filesize'];
+                        $this->info['fileformat']          = '';                // filled in later
+                        $this->info['audio']['dataformat'] = '';                // filled in later, unset if not used
+                        $this->info['video']['dataformat'] = '';                // filled in later, unset if not used
+                        $this->info['tags']                = array();           // filled in later, unset if not used
+                        $this->info['error']               = array();           // filled in later, unset if not used
+                        $this->info['warning']             = array();           // filled in later, unset if not used
+                        $this->info['comments']            = array();           // filled in later, unset if not used
+                        $this->info['encoding']            = $this->encoding;   // required by id3v2 and iso modules - can be unset at the end if desired
+
+                        return true;
+
+                } catch (Exception $e) {
+                        $this->error($e->getMessage());
+                }
+                return false;
+        }
+
+        // public: analyze file
+        public function analyze($filename) {
+                try {
+                        if (!$this->openfile($filename)) {
+                                return $this->info;
+                        }
+
+                        // Handle tags
+                        foreach (array('id3v2'=>'id3v2', 'id3v1'=>'id3v1', 'apetag'=>'ape', 'lyrics3'=>'lyrics3') as $tag_name => $tag_key) {
+                                $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;
+                                        }
+                                }
+                        }
+                        if (isset($this->info['id3v2']['tag_offset_start'])) {
+                                $this->info['avdataoffset'] = max($this->info['avdataoffset'], $this->info['id3v2']['tag_offset_end']);
+                        }
+                        foreach (array('id3v1'=>'id3v1', 'apetag'=>'ape', 'lyrics3'=>'lyrics3') as $tag_name => $tag_key) {
+                                if (isset($this->info[$tag_key]['tag_offset_start'])) {
+                                        $this->info['avdataend'] = min($this->info['avdataend'], $this->info[$tag_key]['tag_offset_start']);
+                                }
+                        }
+
+                        // ID3v2 detection (NOT parsing), even if ($this->option_tag_id3v2 == false) 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
+                                }
+                        }
+
+                        // read 32 kb file data
+                        fseek($this->fp, $this->info['avdataoffset'], SEEK_SET);
+                        $formattest = fread($this->fp, 32774);
+
+                        // determine format
+                        $determined_format = $this->GetFileFormat($formattest, $filename);
+
+                        // unable to determine file format
+                        if (!$determined_format) {
+                                fclose($this->fp);
+                                return $this->error('unable to determine file format');
+                        }
+
+                        // check for illegal ID3 tags
+                        if (isset($determined_format['fail_id3']) && (in_array('id3v1', $this->info['tags']) || in_array('id3v2', $this->info['tags']))) {
+                                if ($determined_format['fail_id3'] === 'ERROR') {
+                                        fclose($this->fp);
+                                        return $this->error('ID3 tags not allowed on this file type.');
+                                } elseif ($determined_format['fail_id3'] === 'WARNING') {
+                                        $this->warning('ID3 tags not allowed on this file type.');
+                                }
+                        }
+
+                        // check for illegal APE tags
+                        if (isset($determined_format['fail_ape']) && in_array('ape', $this->info['tags'])) {
+                                if ($determined_format['fail_ape'] === 'ERROR') {
+                                        fclose($this->fp);
+                                        return $this->error('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'];
+
+                        // supported format signature pattern detected, but module deleted
+                        if (!file_exists(GETID3_INCLUDEPATH.$determined_format['include'])) {
+                                fclose($this->fp);
+                                return $this->error('Format not supported, module "'.$determined_format['include'].'" was removed.');
+                        }
+
+                        // module requires iconv support
+                        // Check encoding/iconv support
+                        if (!empty($determined_format['iconv_req']) && !function_exists('iconv') && !in_array($this->encoding, array('ISO-8859-1', 'UTF-8', 'UTF-16LE', 'UTF-16BE', 'UTF-16'))) {
+                                $errormessage = 'iconv() support is required for this module ('.$determined_format['include'].') for encodings other than ISO-8859-1, UTF-8, UTF-16LE, UTF16-BE, UTF-16. ';
+                                if (GETID3_OS_ISWINDOWS) {
+                                        $errormessage .= 'PHP does not have iconv() support. Please enable php_iconv.dll in php.ini, and copy iconv.dll from c:/php/dlls to c:/windows/system32';
+                                } else {
+                                        $errormessage .= 'PHP is not compiled with iconv() support. Please recompile with the --with-iconv switch';
+                                }
+                                return $this->error($errormessage);
+                        }
+
+                        // include module
+                        include_once(GETID3_INCLUDEPATH.$determined_format['include']);
+
+                        // instantiate module class
+                        $class_name = 'getid3_'.$determined_format['module'];
+                        if (!class_exists($class_name)) {
+                                return $this->error('Format not supported, module "'.$determined_format['include'].'" is corrupt.');
+                        }
+                        $class = new $class_name($this);
+                        $class->Analyze();
+                        unset($class);
+
+                        // close file
+                        fclose($this->fp);
+
+                        // process all tags - copy to 'tags' and convert charsets
+                        if ($this->option_tags_process) {
+                                $this->HandleAllTags();
+                        }
+
+                        // perform more calculations
+                        if ($this->option_extra_info) {
+                                $this->ChannelsBitratePlaytimeCalculations();
+                                $this->CalculateCompressionRatioVideo();
+                                $this->CalculateCompressionRatioAudio();
+                                $this->CalculateReplayGain();
+                                $this->ProcessAudioStreams();
+                        }
+
+                        // get the MD5 sum of the audio/video portion of the file - without ID3/APE/Lyrics3/etc header/footer tags
+                        if ($this->option_md5_data) {
+                                // do not calc md5_data if md5_data_source is present - set by flac only - future MPC/SV8 too
+                                if (!$this->option_md5_data_source || empty($this->info['md5_data_source'])) {
+                                        $this->getHashdata('md5');
+                                }
+                        }
+
+                        // get the SHA1 sum of the audio/video portion of the file - without ID3/APE/Lyrics3/etc header/footer tags
+                        if ($this->option_sha1_data) {
+                                $this->getHashdata('sha1');
+                        }
+
+                        // remove undesired keys
+                        $this->CleanUp();
+
+                } catch (Exception $e) {
+                        $this->error('Caught exception: '.$e->getMessage());
+                }
+
+                // return info array
+                return $this->info;
+        }
+
+
+        // private: error handling
+        public function error($message) {
+                $this->CleanUp();
+                if (!isset($this->info['error'])) {
+                        $this->info['error'] = array();
+                }
+                $this->info['error'][] = $message;
+                return $this->info;
+        }
+
+
+        // private: warning handling
+        public function warning($message) {
+                $this->info['warning'][] = $message;
+                return true;
+        }
+
+
+        // private: CleanUp
+        private function CleanUp() {
+
+                // remove possible empty keys
+                $AVpossibleEmptyKeys = array('dataformat', 'bits_per_sample', 'encoder_options', 'streams', 'bitrate');
+                foreach ($AVpossibleEmptyKeys as $dummy => $key) {
+                        if (empty($this->info['audio'][$key]) && isset($this->info['audio'][$key])) {
+                                unset($this->info['audio'][$key]);
+                        }
+                        if (empty($this->info['video'][$key]) && isset($this->info['video'][$key])) {
+                                unset($this->info['video'][$key]);
+                        }
+                }
+
+                // remove empty root keys
+                if (!empty($this->info)) {
+                        foreach ($this->info as $key => $value) {
+                                if (empty($this->info[$key]) && ($this->info[$key] !== 0) && ($this->info[$key] !== '0')) {
+                                        unset($this->info[$key]);
+                                }
+                        }
+                }
+
+                // remove meaningless entries from unknown-format files
+                if (empty($this->info['fileformat'])) {
+                        if (isset($this->info['avdataoffset'])) {
+                                unset($this->info['avdataoffset']);
+                        }
+                        if (isset($this->info['avdataend'])) {
+                                unset($this->info['avdataend']);
+                        }
+                }
+
+                // remove possible duplicated identical entries
+                if (!empty($this->info['error'])) {
+                        $this->info['error'] = array_values(array_unique($this->info['error']));
+                }
+                if (!empty($this->info['warning'])) {
+                        $this->info['warning'] = array_values(array_unique($this->info['warning']));
+                }
+
+                // remove "global variable" type keys
+                unset($this->info['php_memory_limit']);
+
+                return true;
+        }
+
+
+        // return array containing information about all supported formats
+        public function GetFileFormatArray() {
+                static $format_info = array();
+                if (empty($format_info)) {
+                        $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',
+                                                        'mime_type' => 'application/octet-stream',
+                                                        'fail_ape'  => 'WARNING',
+                                                ),
+
+/*
+                                // AA   - audio       - Audible Audiobook
+                                'aa'   => array(
+                                                        'pattern'   => '^.{4}\x57\x90\x75\x36',
+                                                        'group'     => 'audio',
+                                                        'module'    => 'aa',
+                                                        'mime_type' => 'audio/audible',
+                                                ),
+*/
+                                // AAC  - audio       - Advanced Audio Coding (AAC) - ADTS format (very similar to MP3)
+                                'adts' => array(
+                                                        'pattern'   => '^\xFF[\xF0-\xF1\xF8-\xF9]',
+                                                        'group'     => 'audio',
+                                                        'module'    => 'aac',
+                                                        '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',
+                                                ),
+
+                                // DSS  - audio       - Digital Speech Standard
+                                'dss'  => array(
+                                                        'pattern'   => '^[\x02-\x03]ds[s2]',
+                                                        'group'     => 'audio',
+                                                        'module'    => 'dss',
+                                                        'mime_type' => 'application/octet-stream',
+                                                ),
+
+                                // 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'    => 'flac',
+                                                        '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',
+                                                ),
+
+// has been known to produce false matches in random files (e.g. JPEGs), leave out until more precise matching available
+//                              // MOD  - audio       - MODule (assorted sub-formats)
+//                              'mod'  => array(
+//                                                      'pattern'   => '^.{1080}(M\\.K\\.|M!K!|FLT4|FLT8|[5-9]CHN|[1-3][0-9]CH)',
+//                                                      'group'     => 'audio',
+//                                                      'module'    => 'mod',
+//                                                      'option'    => 'mod',
+//                                                      'mime_type' => 'audio/mod',
+//                                              ),
+
+                                // MOD  - audio       - MODule (Impulse Tracker)
+                                'it'   => array(
+                                                        'pattern'   => '^IMPM',
+                                                        'group'     => 'audio',
+                                                        'module'    => 'mod',
+                                                        //'option'    => 'it',
+                                                        'mime_type' => 'audio/it',
+                                                ),
+
+                                // MOD  - audio       - MODule (eXtended Module, various sub-formats)
+                                'xm'   => array(
+                                                        'pattern'   => '^Extended Module',
+                                                        'group'     => 'audio',
+                                                        'module'    => 'mod',
+                                                        //'option'    => 'xm',
+                                                        'mime_type' => 'audio/xm',
+                                                ),
+
+                                // MOD  - audio       - MODule (ScreamTracker)
+                                's3m'  => array(
+                                                        'pattern'   => '^.{44}SCRM',
+                                                        'group'     => 'audio',
+                                                        'module'    => 'mod',
+                                                        //'option'    => 's3m',
+                                                        'mime_type' => 'audio/s3m',
+                                                ),
+
+                                // MPC  - audio       - Musepack / MPEGplus
+                                'mpc'  => array(
+                                                        'pattern'   => '^(MPCK|MP\+|[\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',
+                                                        'mime_type' => 'audio/x-musepack',
+                                                ),
+
+                                // MP3  - audio       - MPEG-audio Layer 3 (very similar to AAC-ADTS)
+                                'mp3'  => array(
+                                                        'pattern'   => '^\xFF[\xE2-\xE7\xF2-\xF7\xFA-\xFF][\x00-\x0B\x10-\x1B\x20-\x2B\x30-\x3B\x40-\x4B\x50-\x5B\x60-\x6B\x70-\x7B\x80-\x8B\x90-\x9B\xA0-\xAB\xB0-\xBB\xC0-\xCB\xD0-\xDB\xE0-\xEB\xF0-\xFB]',
+                                                        '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+)
+                                'wv'   => 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',
+                                                        'iconv_req' => false,
+                                                ),
+
+                                // BINK - audio/video - Bink / Smacker
+                                'bink' => array(
+                                                        'pattern'   => '^(BIK|SMK)',
+                                                        'group'     => 'audio-video',
+                                                        'module'    => 'bink',
+                                                        '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',
+                                                        'group'     => 'audio-video',
+                                                        'module'    => 'matroska',
+                                                        'mime_type' => 'video/x-matroska', // may also be audio/x-matroska
+                                                ),
+
+                                // 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, Ogg-FLAC, Speex, Ogg-Theora(*), Ogg-Tarkin(*))
+                                'ogg'  => array(
+                                                        'pattern'   => '^OggS',
+                                                        'group'     => 'audio',
+                                                        'module'    => 'ogg',
+                                                        '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',
+                                                ),
+
+                                // TS - audio/video - MPEG-2 Transport Stream
+                                'ts' => array(
+                                                        'pattern'   => '^(\x47.{187}){10,}', // packets are 188 bytes long and start with 0x47 "G".  Check for at least 10 packets matching this pattern
+                                                        'group'     => 'audio-video',
+                                                        'module'    => 'ts',
+                                                        'mime_type' => 'video/MP2T',
+                                                ),
+
+
+                                // 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)
+                                'jpg'  => array(
+                                                        'pattern'   => '^\xFF\xD8\xFF',
+                                                        'group'     => 'graphic',
+                                                        'module'    => 'jpg',
+                                                        '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'   => '(<!DOCTYPE svg PUBLIC |xmlns="http:\/\/www\.w3\.org\/2000\/svg")',
+                                                        'group'     => 'graphic',
+                                                        'module'    => 'svg',
+                                                        'mime_type' => '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',
+                                                ),
+
+
+                                // EFAX - still image - eFax (TIFF derivative)
+                                'efax'  => array(
+                                                        'pattern'   => '^\xDC\xFE',
+                                                        'group'     => 'graphic',
+                                                        'module'    => 'efax',
+                                                        'mime_type' => 'image/efax',
+                                                        'fail_id3'  => 'ERROR',
+                                                        'fail_ape'  => 'ERROR',
+                                                ),
+
+
+                                // Data formats
+
+                                // 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',
+                                                        'iconv_req' => false,
+                                                ),
+
+                                // RAR  - data        - RAR compressed data
+                                'rar'  => array(
+                                                        'pattern'   => '^Rar\!',
+                                                        'group'     => 'archive',
+                                                        'module'    => 'rar',
+                                                        'mime_type' => 'application/octet-stream',
+                                                        'fail_id3'  => 'ERROR',
+                                                        'fail_ape'  => 'ERROR',
+                                                ),
+
+                                // SZIP - audio/data  - 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',
+                                                ),
+
+
+                                // Misc other formats
+
+                                // PAR2 - data        - Parity Volume Set Specification 2.0
+                                'par2' => array (
+                                                        'pattern'   => '^PAR2\x00PKT',
+                                                        'group'     => 'misc',
+                                                        'module'    => 'par2',
+                                                        'mime_type' => 'application/octet-stream',
+                                                        'fail_id3'  => 'ERROR',
+                                                        'fail_ape'  => 'ERROR',
+                                                ),
+
+                                // PDF  - data        - Portable Document Format
+                                'pdf'  => array(
+                                                        'pattern'   => '^\x25PDF',
+                                                        'group'     => 'misc',
+                                                        'module'    => 'pdf',
+                                                        'mime_type' => 'application/pdf',
+                                                        'fail_id3'  => 'ERROR',
+                                                        'fail_ape'  => 'ERROR',
+                                                ),
+
+                                // MSOFFICE  - data   - ZIP compressed data
+                                'msoffice' => array(
+                                                        'pattern'   => '^\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1', // D0CF11E == DOCFILE == Microsoft Office Document
+                                                        'group'     => 'misc',
+                                                        'module'    => 'msoffice',
+                                                        'mime_type' => 'application/octet-stream',
+                                                        'fail_id3'  => 'ERROR',
+                                                        'fail_ape'  => 'ERROR',
+                                                ),
+
+                                 // CUE  - data       - CUEsheet (index to single-file disc images)
+                                 'cue' => array(
+                                                        'pattern'   => '', // empty pattern means cannot be automatically detected, will fall through all other formats and match based on filename and very basic file contents
+                                                        'group'     => 'misc',
+                                                        'module'    => 'cue',
+                                                        'mime_type' => 'application/octet-stream',
+                                                   ),
+
+                        );
+                }
+
+                return $format_info;
+        }
+
+
+
+        public function GetFileFormat(&$filedata, $filename='') {
+                // this function will determine the format of a file based on usually
+                // the first 2-4 bytes of the file (8 bytes for PNG, 16 bytes for JPG,
+                // and in the case of ISO CD image, 6 bytes offset 32kb from the start
+                // of the file).
+
+                // Identify file format - loop through $format_info and detect with reg expr
+                foreach ($this->GetFileFormatArray() as $format_name => $info) {
+                        // The /s switch on preg_match() forces preg_match() NOT to treat
+                        // newline (0x0A) characters as special chars but do a binary match
+                        if (!empty($info['pattern']) && preg_match('#'.$info['pattern'].'#s', $filedata)) {
+                                $info['include'] = 'module.'.$info['group'].'.'.$info['module'].'.php';
+                                return $info;
+                        }
+                }
+
+
+                if (preg_match('#\.mp[123a]$#i', $filename)) {
+                        // Too many mp3 encoders on the market put gabage in front of mpeg files
+                        // use assume format on these if format detection failed
+                        $GetFileFormatArray = $this->GetFileFormatArray();
+                        $info = $GetFileFormatArray['mp3'];
+                        $info['include'] = 'module.'.$info['group'].'.'.$info['module'].'.php';
+                        return $info;
+                } elseif (preg_match('/\.cue$/i', $filename) && preg_match('#FILE "[^"]+" (BINARY|MOTOROLA|AIFF|WAVE|MP3)#', $filedata)) {
+                        // there's not really a useful consistent "magic" at the beginning of .cue files to identify them
+                        // so until I think of something better, just go by filename if all other format checks fail
+                        // and verify there's at least one instance of "TRACK xx AUDIO" in the file
+                        $GetFileFormatArray = $this->GetFileFormatArray();
+                        $info = $GetFileFormatArray['cue'];
+                        $info['include']   = 'module.'.$info['group'].'.'.$info['module'].'.php';
+                        return $info;
+                }
+
+                return false;
+        }
+
+
+        // converts array to $encoding charset from $this->encoding
+        public 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] = trim(getid3_lib::iconv_fallback($encoding, $this->encoding, $value));
+                        }
+                }
+        }
+
+
+        public function HandleAllTags() {
+
+                // key name => array (tag name, character encoding)
+                static $tags;
+                if (empty($tags)) {
+                        $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'     , 'UTF-8'),
+                                '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'         , $this->encoding_id3v1),
+                                'id3v2'     => array('id3v2'         , 'UTF-8'), // not according to the specs (every frame can have a different encoding), but getID3() force-converts all encodings to UTF-8
+                                'ape'       => array('ape'           , 'UTF-8'),
+                                'cue'       => array('cue'           , 'ISO-8859-1'),
+                                'matroska'  => array('matroska'      , 'UTF-8'),
+                                'flac'      => array('vorbiscomment' , 'UTF-8'),
+                                'divxtag'   => array('divx'          , 'ISO-8859-1'),
+                        );
+                }
+
+                // loop through comments array
+                foreach ($tags as $comment_name => $tagname_encoding_array) {
+                        list($tag_name, $encoding) = $tagname_encoding_array;
+
+                        // fill in default encoding type if not already present
+                        if (isset($this->info[$comment_name]) && !isset($this->info[$comment_name]['encoding'])) {
+                                $this->info[$comment_name]['encoding'] = $encoding;
+                        }
+
+                        // copy comments if key name set
+                        if (!empty($this->info[$comment_name]['comments'])) {
+                                foreach ($this->info[$comment_name]['comments'] as $tag_key => $valuearray) {
+                                        foreach ($valuearray as $key => $value) {
+                                                if (is_string($value)) {
+                                                        $value = trim($value, " \r\n\t"); // do not trim nulls from $value!! Unicode characters will get mangled if trailing nulls are removed!
+                                                }
+                                                if ($value) {
+                                                        $this->info['tags'][trim($tag_name)][trim($tag_key)][] = $value;
+                                                }
+                                        }
+                                        if ($tag_key == 'picture') {
+                                                unset($this->info[$comment_name]['comments'][$tag_key]);
+                                        }
+                                }
+
+                                if (!isset($this->info['tags'][$tag_name])) {
+                                        // comments are set but contain nothing but empty strings, so skip
+                                        continue;
+                                }
+
+                                if ($this->option_tags_html) {
+                                        foreach ($this->info['tags'][$tag_name] as $tag_key => $valuearray) {
+                                                foreach ($valuearray as $key => $value) {
+                                                        if (is_string($value)) {
+                                                                //$this->info['tags_html'][$tag_name][$tag_key][$key] = getid3_lib::MultiByteCharString2HTML($value, $encoding);
+                                                                $this->info['tags_html'][$tag_name][$tag_key][$key] = str_replace('&#0;', '', trim(getid3_lib::MultiByteCharString2HTML($value, $encoding)));
+                                                        } else {
+                                                                $this->info['tags_html'][$tag_name][$tag_key][$key] = $value;
+                                                        }
+                                                }
+                                        }
+                                }
+
+                                $this->CharConvert($this->info['tags'][$tag_name], $encoding);           // only copy gets converted!
+                        }
+
+                }
+
+                // pictures can take up a lot of space, and we don't need multiple copies of them
+                // let there be a single copy in [comments][picture], and not elsewhere
+                if (!empty($this->info['tags'])) {
+                        $unset_keys = array('tags', 'tags_html');
+                        foreach ($this->info['tags'] as $tagtype => $tagarray) {
+                                foreach ($tagarray as $tagname => $tagdata) {
+                                        if ($tagname == 'picture') {
+                                                foreach ($tagdata as $key => $tagarray) {
+                                                        $this->info['comments']['picture'][] = $tagarray;
+                                                        if (isset($tagarray['data']) && isset($tagarray['image_mime'])) {
+                                                                if (isset($this->info['tags'][$tagtype][$tagname][$key])) {
+                                                                        unset($this->info['tags'][$tagtype][$tagname][$key]);
+                                                                }
+                                                                if (isset($this->info['tags_html'][$tagtype][$tagname][$key])) {
+                                                                        unset($this->info['tags_html'][$tagtype][$tagname][$key]);
+                                                                }
+                                                        }
+                                                }
+                                        }
+                                }
+                                foreach ($unset_keys as $unset_key) {
+                                        // remove possible empty keys from (e.g. [tags][id3v2][picture])
+                                        if (empty($this->info[$unset_key][$tagtype]['picture'])) {
+                                                unset($this->info[$unset_key][$tagtype]['picture']);
+                                        }
+                                        if (empty($this->info[$unset_key][$tagtype])) {
+                                                unset($this->info[$unset_key][$tagtype]);
+                                        }
+                                        if (empty($this->info[$unset_key])) {
+                                                unset($this->info[$unset_key]);
+                                        }
+                                }
+                                // remove duplicate copy of picture data from (e.g. [id3v2][comments][picture])
+                                if (isset($this->info[$tagtype]['comments']['picture'])) {
+                                        unset($this->info[$tagtype]['comments']['picture']);
+                                }
+                                if (empty($this->info[$tagtype]['comments'])) {
+                                        unset($this->info[$tagtype]['comments']);
+                                }
+                                if (empty($this->info[$tagtype])) {
+                                        unset($this->info[$tagtype]);
+                                }
+                        }
+                }
+                return true;
+        }
+
+
+        public function getHashdata($algorithm) {
+                switch ($algorithm) {
+                        case 'md5':
+                        case 'sha1':
+                                break;
+
+                        default:
+                                return $this->error('bad algorithm "'.$algorithm.'" in getHashdata()');
+                                break;
+                }
+
+                if (!empty($this->info['fileformat']) && !empty($this->info['dataformat']) && ($this->info['fileformat'] == 'ogg') && ($this->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 (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
+
+                                $this->warning('Failed making system call to vorbiscomment.exe - '.$algorithm.'_data is incorrect - error returned: PHP running in Safe Mode (backtick operator not available)');
+                                $this->info[$algorithm.'_data'] = false;
+
+                        } else {
+
+                                // Prevent user from aborting script
+                                $old_abort = ignore_user_abort(true);
+
+                                // Create empty file
+                                $empty = tempnam(GETID3_TEMP_DIR, 'getID3');
+                                touch($empty);
+
+                                // Use vorbiscomment to make temp file without comments
+                                $temp = tempnam(GETID3_TEMP_DIR, 'getID3');
+                                $file = $this->info['filenamepath'];
+
+                                if (GETID3_OS_ISWINDOWS) {
+
+                                        if (file_exists(GETID3_HELPERAPPSDIR.'vorbiscomment.exe')) {
+
+                                                $commandline = '"'.GETID3_HELPERAPPSDIR.'vorbiscomment.exe" -w -c "'.$empty.'" "'.$file.'" "'.$temp.'"';
+                                                $VorbisCommentError = `$commandline`;
+
+                                        } else {
+
+                                                $VorbisCommentError = 'vorbiscomment.exe not found in '.GETID3_HELPERAPPSDIR;
+
+                                        }
+
+                                } else {
+
+                                        $commandline = 'vorbiscomment -w -c "'.$empty.'" "'.$file.'" "'.$temp.'" 2>&1';
+                                        $commandline = 'vorbiscomment -w -c '.escapeshellarg($empty).' '.escapeshellarg($file).' '.escapeshellarg($temp).' 2>&1';
+                                        $VorbisCommentError = `$commandline`;
+
+                                }
+
+                                if (!empty($VorbisCommentError)) {
+
+                                        $this->info['warning'][]         = 'Failed making system call to vorbiscomment(.exe) - '.$algorithm.'_data will be incorrect. If vorbiscomment is unavailable, please download from http://www.vorbis.com/download.psp and put in the getID3() directory. Error returned: '.$VorbisCommentError;
+                                        $this->info[$algorithm.'_data']  = false;
+
+                                } else {
+
+                                        // Get hash of newly created file
+                                        switch ($algorithm) {
+                                                case 'md5':
+                                                        $this->info[$algorithm.'_data'] = md5_file($temp);
+                                                        break;
+
+                                                case 'sha1':
+                                                        $this->info[$algorithm.'_data'] = sha1_file($temp);
+                                                        break;
+                                        }
+                                }
+
+                                // Clean up
+                                unlink($empty);
+                                unlink($temp);
+
+                                // Reset abort setting
+                                ignore_user_abort($old_abort);
+
+                        }
+
+                } else {
+
+                        if (!empty($this->info['avdataoffset']) || (isset($this->info['avdataend']) && ($this->info['avdataend'] < $this->info['filesize']))) {
+
+                                // get hash from part of file
+                                $this->info[$algorithm.'_data'] = getid3_lib::hash_data($this->info['filenamepath'], $this->info['avdataoffset'], $this->info['avdataend'], $algorithm);
+
+                        } else {
+
+                                // get hash from whole file
+                                switch ($algorithm) {
+                                        case 'md5':
+                                                $this->info[$algorithm.'_data'] = md5_file($this->info['filenamepath']);
+                                                break;
+
+                                        case 'sha1':
+                                                $this->info[$algorithm.'_data'] = sha1_file($this->info['filenamepath']);
+                                                break;
+                                }
+                        }
+
+                }
+                return true;
+        }
+
+
+        public function ChannelsBitratePlaytimeCalculations() {
+
+                // set channelmode on audio
+                if (!empty($this->info['audio']['channelmode']) || !isset($this->info['audio']['channels'])) {
+                        // ignore
+                } elseif ($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
+                $CombinedBitrate  = 0;
+                $CombinedBitrate += (isset($this->info['audio']['bitrate']) ? $this->info['audio']['bitrate'] : 0);
+                $CombinedBitrate += (isset($this->info['video']['bitrate']) ? $this->info['video']['bitrate'] : 0);
+                if (($CombinedBitrate > 0) && empty($this->info['bitrate'])) {
+                        $this->info['bitrate'] = $CombinedBitrate;
+                }
+                //if ((isset($this->info['video']) && !isset($this->info['video']['bitrate'])) || (isset($this->info['audio']) && !isset($this->info['audio']['bitrate']))) {
+                //      // for example, VBR MPEG video files cannot determine video bitrate:
+                //      // should not set overall bitrate and playtime from audio bitrate only
+                //      unset($this->info['bitrate']);
+                //}
+
+                // video bitrate undetermined, but calculable
+                if (isset($this->info['video']['dataformat']) && $this->info['video']['dataformat'] && (!isset($this->info['video']['bitrate']) || ($this->info['video']['bitrate'] == 0))) {
+                        // if video bitrate not set
+                        if (isset($this->info['audio']['bitrate']) && ($this->info['audio']['bitrate'] > 0) && ($this->info['audio']['bitrate'] == $this->info['bitrate'])) {
+                                // AND if audio bitrate is set to same as overall bitrate
+                                if (isset($this->info['playtime_seconds']) && ($this->info['playtime_seconds'] > 0)) {
+                                        // AND if playtime is set
+                                        if (isset($this->info['avdataend']) && isset($this->info['avdataoffset'])) {
+                                                // AND if AV data offset start/end is known
+                                                // THEN we can calculate the video bitrate
+                                                $this->info['bitrate'] = round((($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['playtime_seconds']);
+                                                $this->info['video']['bitrate'] = $this->info['bitrate'] - $this->info['audio']['bitrate'];
+                                        }
+                                }
+                        }
+                }
+
+                if ((!isset($this->info['playtime_seconds']) || ($this->info['playtime_seconds'] <= 0)) && !empty($this->info['bitrate'])) {
+                        $this->info['playtime_seconds'] = (($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['bitrate'];
+                }
+
+                if (!isset($this->info['bitrate']) && !empty($this->info['playtime_seconds'])) {
+                        $this->info['bitrate'] = (($this->info['avdataend'] - $this->info['avdataoffset']) * 8) / $this->info['playtime_seconds'];
+                }
+                if (isset($this->info['bitrate']) && empty($this->info['audio']['bitrate']) && empty($this->info['video']['bitrate'])) {
+                        if (isset($this->info['audio']['dataformat']) && empty($this->info['video']['resolution_x'])) {
+                                // audio only
+                                $this->info['audio']['bitrate'] = $this->info['bitrate'];
+                        } elseif (isset($this->info['video']['resolution_x']) && empty($this->info['audio']['dataformat'])) {
+                                // video only
+                                $this->info['video']['bitrate'] = $this->info['bitrate'];
+                        }
+                }
+
+                // Set playtime string
+                if (!empty($this->info['playtime_seconds']) && empty($this->info['playtime_string'])) {
+                        $this->info['playtime_string'] = getid3_lib::PlaytimeString($this->info['playtime_seconds']);
+                }
+        }
+
+
+        public function CalculateCompressionRatioVideo() {
+                if (empty($this->info['video'])) {
+                        return false;
+                }
+                if (empty($this->info['video']['resolution_x']) || empty($this->info['video']['resolution_y'])) {
+                        return false;
+                }
+                if (empty($this->info['video']['bits_per_sample'])) {
+                        return false;
+                }
+
+                switch ($this->info['video']['dataformat']) {
+                        case 'bmp':
+                        case 'gif':
+                        case 'jpeg':
+                        case 'jpg':
+                        case 'png':
+                        case 'tiff':
+                                $FrameRate = 1;
+                                $PlaytimeSeconds = 1;
+                                $BitrateCompressed = $this->info['filesize'] * 8;
+                                break;
+
+                        default:
+                                if (!empty($this->info['video']['frame_rate'])) {
+                                        $FrameRate = $this->info['video']['frame_rate'];
+                                } else {
+                                        return false;
+                                }
+                                if (!empty($this->info['playtime_seconds'])) {
+                                        $PlaytimeSeconds = $this->info['playtime_seconds'];
+                                } else {
+                                        return false;
+                                }
+                                if (!empty($this->info['video']['bitrate'])) {
+                                        $BitrateCompressed = $this->info['video']['bitrate'];
+                                } else {
+                                        return false;
+                                }
+                                break;
+                }
+                $BitrateUncompressed = $this->info['video']['resolution_x'] * $this->info['video']['resolution_y'] * $this->info['video']['bits_per_sample'] * $FrameRate;
+
+                $this->info['video']['compression_ratio'] = $BitrateCompressed / $BitrateUncompressed;
+                return true;
+        }
+
+
+        public function CalculateCompressionRatioAudio() {
+                if (empty($this->info['audio']['bitrate']) || empty($this->info['audio']['channels']) || empty($this->info['audio']['sample_rate']) || !is_numeric($this->info['audio']['sample_rate'])) {
+                        return false;
+                }
+                $this->info['audio']['compression_ratio'] = $this->info['audio']['bitrate'] / ($this->info['audio']['channels'] * $this->info['audio']['sample_rate'] * (!empty($this->info['audio']['bits_per_sample']) ? $this->info['audio']['bits_per_sample'] : 16));
+
+                if (!empty($this->info['audio']['streams'])) {
+                        foreach ($this->info['audio']['streams'] as $streamnumber => $streamdata) {
+                                if (!empty($streamdata['bitrate']) && !empty($streamdata['channels']) && !empty($streamdata['sample_rate'])) {
+                                        $this->info['audio']['streams'][$streamnumber]['compression_ratio'] = $streamdata['bitrate'] / ($streamdata['channels'] * $streamdata['sample_rate'] * (!empty($streamdata['bits_per_sample']) ? $streamdata['bits_per_sample'] : 16));
+                                }
+                        }
+                }
+                return true;
+        }
+
+
+        public function CalculateReplayGain() {
+                if (isset($this->info['replay_gain'])) {
+                        if (!isset($this->info['replay_gain']['reference_volume'])) {
+                                $this->info['replay_gain']['reference_volume'] = (double) 89.0;
+                        }
+                        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 - getid3_lib::RGADamplitude2dB($this->info['replay_gain']['track']['peak']);
+                        }
+                        if (isset($this->info['replay_gain']['album']['peak'])) {
+                                $this->info['replay_gain']['album']['max_noclip_gain'] = 0 - getid3_lib::RGADamplitude2dB($this->info['replay_gain']['album']['peak']);
+                        }
+                }
+                return true;
+        }
+
+        public function ProcessAudioStreams() {
+                if (!empty($this->info['audio']['bitrate']) || !empty($this->info['audio']['channels']) || !empty($this->info['audio']['sample_rate'])) {
+                        if (!isset($this->info['audio']['streams'])) {
+                                foreach ($this->info['audio'] as $key => $value) {
+                                        if ($key != 'streams') {
+                                                $this->info['audio']['streams'][0][$key] = $value;
+                                        }
+                                }
+                        }
+                }
+                return true;
+        }
+
+        public function getid3_tempnam() {
+                return tempnam($this->tempdir, 'gI3');
+        }
+
+        public function include_module($name) {
+                //if (!file_exists($this->include_path.'module.'.$name.'.php')) {
+                if (!file_exists(GETID3_INCLUDEPATH.'module.'.$name.'.php')) {
+                        throw new getid3_exception('Required module.'.$name.'.php is missing.');
+                }
+                include_once(GETID3_INCLUDEPATH.'module.'.$name.'.php');
+                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
+        protected $data_string_length   = 0;     // string length
+
+        private $dependency_to = null;
+
+
+        public function __construct(getID3 $getid3, $call_module=null) {
+                $this->getid3 = $getid3;
+
+                if ($call_module) {
+                        $this->dependency_to = str_replace('getid3_', '', $call_module);
+                }
+        }
+
+
+        // Analyze from file pointer
+        abstract public function Analyze();
+
+
+        // Analyze from string instead
+        public function AnalyzeString($string) {
+                // Enter string mode
+            $this->setStringMode($string);
+
+                // Save info
+                $saved_avdataoffset = $this->getid3->info['avdataoffset'];
+                $saved_avdataend    = $this->getid3->info['avdataend'];
+                $saved_filesize     = (isset($this->getid3->info['filesize']) ? $this->getid3->info['filesize'] : null); // may be not set if called as dependency without openfile() call
+
+                // Reset some info
+                $this->getid3->info['avdataoffset'] = 0;
+                $this->getid3->info['avdataend']    = $this->getid3->info['filesize'] = $this->data_string_length;
+
+                // 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;
+        }
+
+        public function setStringMode($string) {
+                $this->data_string_flag   = true;
+                $this->data_string        = $string;
+                $this->data_string_length = strlen($string);
+        }
+
+        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);
+                }
+            $pos = $this->ftell() + $bytes;
+            if (!getid3_lib::intValueSupported($pos)) {
+                        throw new getid3_exception('cannot fread('.$bytes.' from '.$this->ftell().') because beyond PHP filesystem limit', 10);
+            }
+                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;
+                                        break;
+
+                                case SEEK_CUR:
+                                        $this->data_string_position += $bytes;
+                                        break;
+
+                                case SEEK_END:
+                                        $this->data_string_position = $this->data_string_length + $bytes;
+                                        break;
+                        }
+                        return 0;
+            } else {
+                $pos = $bytes;
+                if ($whence == SEEK_CUR) {
+                                $pos = $this->ftell() + $bytes;
+                } elseif ($whence == SEEK_END) {
+                                $pos = $this->info['filesize'] + $bytes;
+                }
+                if (!getid3_lib::intValueSupported($pos)) {
+                                throw new getid3_exception('cannot fseek('.$pos.') because beyond PHP filesystem limit', 10);
+                        }
+                }
+                return fseek($this->getid3->fp, $bytes, $whence);
+        }
+
+        protected function feof() {
+                if ($this->data_string_flag) {
+                        return $this->data_string_position >= $this->data_string_length;
+                }
+                return feof($this->getid3->fp);
+        }
+
+        final protected function isDependencyFor($module) {
+                return $this->dependency_to == $module;
+        }
+
+        protected function error($text)
+        {
+                $this->getid3->info['error'][] = $text;
+
+                return false;
+        }
+
+        protected function warning($text)
+        {
+                return $this->getid3->warning($text);
+        }
+
+        protected function notice($text)
+        {
+                // does nothing for now
+        }
+
+        public function saveAttachment($name, $offset, $length, $image_mime=null) {
+                try {
+
+                        // do not extract at all
+                        if ($this->getid3->option_save_attachments === getID3::ATTACHMENTS_NONE) {
+
+                                $attachment = null; // do not set any
+
+                        // extract to return array
+                        } elseif ($this->getid3->option_save_attachments === getID3::ATTACHMENTS_INLINE) {
+
+                                $this->fseek($offset);
+                                $attachment = $this->fread($length); // get whole data in one pass, till it is anyway stored in memory
+                                if ($attachment === false || strlen($attachment) != $length) {
+                                        throw new Exception('failed to read attachment data');
+                                }
+
+                        // assume directory path is given
+                        } else {
+
+                                // set up destination path
+                                $dir = rtrim(str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $this->getid3->option_save_attachments), DIRECTORY_SEPARATOR);
+                                if (!is_dir($dir) || !is_writable($dir)) { // check supplied directory
+                                        throw new Exception('supplied path ('.$dir.') does not exist, or is not writable');
+                                }
+                                $dest = $dir.DIRECTORY_SEPARATOR.$name.($image_mime ? '.'.getid3_lib::ImageExtFromMime($image_mime) : '');
+
+                                // create dest file
+                                if (($fp_dest = fopen($dest, 'wb')) == false) {
+                                        throw new Exception('failed to create file '.$dest);
+                                }
+
+                                // copy data
+                                $this->fseek($offset);
+                                $buffersize = ($this->data_string_flag ? $length : $this->getid3->fread_buffer_size());
+                                $bytesleft = $length;
+                                while ($bytesleft > 0) {
+                                        if (($buffer = $this->fread(min($buffersize, $bytesleft))) === false || ($byteswritten = fwrite($fp_dest, $buffer)) === false || ($byteswritten === 0)) {
+                                                throw new Exception($buffer === false ? 'not enough data to read' : 'failed to write to destination file, may be not enough disk space');
+                                        }
+                                        $bytesleft -= $byteswritten;
+                                }
+
+                                fclose($fp_dest);
+                                $attachment = $dest;
+
+                        }
+
+                } catch (Exception $e) {
+
+                        // close and remove dest file if created
+                        if (isset($fp_dest) && is_resource($fp_dest)) {
+                                fclose($fp_dest);
+                                unlink($dest);
+                        }
+
+                        // do not set any is case of error
+                        $attachment = null;
+                        $this->warning('Failed to extract attachment '.$name.': '.$e->getMessage());
+
+                }
+
+                // seek to the end of attachment
+                $this->fseek($offset + $length);
+
+                return $attachment;
+        }
+}
+
+class getid3_exception extends Exception {
+        public $message;
+}
+ No newline at end of file

new file wp-includes/ID3/getid3.lib.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// getid3.lib.php - part of getID3()                           //
+// See readme.txt for more details                             //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+
+class getid3_lib
+{
+
+        public static function PrintHexBytes($string, $hex=true, $spaces=true, $htmlencoding='UTF-8') {
+                $returnstring = '';
+                for ($i = 0; $i < strlen($string); $i++) {
+                        if ($hex) {
+                                $returnstring .= str_pad(dechex(ord($string{$i})), 2, '0', STR_PAD_LEFT);
+                        } else {
+                                $returnstring .= ' '.(preg_match("#[\x20-\x7E]#", $string{$i}) ? $string{$i} : '¤');
+                        }
+                        if ($spaces) {
+                                $returnstring .= ' ';
+                        }
+                }
+                if (!empty($htmlencoding)) {
+                        if ($htmlencoding === true) {
+                                $htmlencoding = 'UTF-8'; // prior to getID3 v1.9.0 the function's 4th parameter was boolean
+                        }
+                        $returnstring = htmlentities($returnstring, ENT_QUOTES, $htmlencoding);
+                }
+                return $returnstring;
+        }
+
+        public static function trunc($floatnumber) {
+                // truncates a floating-point number at the decimal point
+                // returns int (if possible, otherwise float)
+                if ($floatnumber >= 1) {
+                        $truncatednumber = floor($floatnumber);
+                } elseif ($floatnumber <= -1) {
+                        $truncatednumber = ceil($floatnumber);
+                } else {
+                        $truncatednumber = 0;
+                }
+                if (self::intValueSupported($truncatednumber)) {
+                        $truncatednumber = (int) $truncatednumber;
+                }
+                return $truncatednumber;
+        }
+
+
+        public static function safe_inc(&$variable, $increment=1) {
+                if (isset($variable)) {
+                        $variable += $increment;
+                } else {
+                        $variable = $increment;
+                }
+                return true;
+        }
+
+        public static function CastAsInt($floatnum) {
+                // convert to float if not already
+                $floatnum = (float) $floatnum;
+
+                // convert a float to type int, only if possible
+                if (self::trunc($floatnum) == $floatnum) {
+                        // it's not floating point
+                        if (self::intValueSupported($floatnum)) {
+                                // it's within int range
+                                $floatnum = (int) $floatnum;
+                        }
+                }
+                return $floatnum;
+        }
+
+        public static function intValueSupported($num) {
+                // check if integers are 64-bit
+                static $hasINT64 = null;
+                if ($hasINT64 === null) { // 10x faster than is_null()
+                        $hasINT64 = is_int(pow(2, 31)); // 32-bit int are limited to (2^31)-1
+                        if (!$hasINT64 && !defined('PHP_INT_MIN')) {
+                                define('PHP_INT_MIN', ~PHP_INT_MAX);
+                        }
+                }
+                // if integers are 64-bit - no other check required
+                if ($hasINT64 || (($num <= PHP_INT_MAX) && ($num >= PHP_INT_MIN))) {
+                        return true;
+                }
+                return false;
+        }
+
+        public static function DecimalizeFraction($fraction) {
+                list($numerator, $denominator) = explode('/', $fraction);
+                return $numerator / ($denominator ? $denominator : 1);
+        }
+
+
+        public static function DecimalBinary2Float($binarynumerator) {
+                $numerator   = self::Bin2Dec($binarynumerator);
+                $denominator = self::Bin2Dec('1'.str_repeat('0', strlen($binarynumerator)));
+                return ($numerator / $denominator);
+        }
+
+
+        public static function NormalizeBinaryPoint($binarypointnumber, $maxbits=52) {
+                // http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html
+                if (strpos($binarypointnumber, '.') === false) {
+                        $binarypointnumber = '0.'.$binarypointnumber;
+                } elseif ($binarypointnumber{0} == '.') {
+                        $binarypointnumber = '0'.$binarypointnumber;
+                }
+                $exponent = 0;
+                while (($binarypointnumber{0} != '1') || (substr($binarypointnumber, 1, 1) != '.')) {
+                        if (substr($binarypointnumber, 1, 1) == '.') {
+                                $exponent--;
+                                $binarypointnumber = substr($binarypointnumber, 2, 1).'.'.substr($binarypointnumber, 3);
+                        } else {
+                                $pointpos = strpos($binarypointnumber, '.');
+                                $exponent += ($pointpos - 1);
+                                $binarypointnumber = str_replace('.', '', $binarypointnumber);
+                                $binarypointnumber = $binarypointnumber{0}.'.'.substr($binarypointnumber, 1);
+                        }
+                }
+                $binarypointnumber = str_pad(substr($binarypointnumber, 0, $maxbits + 2), $maxbits + 2, '0', STR_PAD_RIGHT);
+                return array('normalized'=>$binarypointnumber, 'exponent'=>(int) $exponent);
+        }
+
+
+        public static function Float2BinaryDecimal($floatvalue) {
+                // http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html
+                $maxbits = 128; // to how many bits of precision should the calculations be taken?
+                $intpart   = self::trunc($floatvalue);
+                $floatpart = abs($floatvalue - $intpart);
+                $pointbitstring = '';
+                while (($floatpart != 0) && (strlen($pointbitstring) < $maxbits)) {
+                        $floatpart *= 2;
+                        $pointbitstring .= (string) self::trunc($floatpart);
+                        $floatpart -= self::trunc($floatpart);
+                }
+                $binarypointnumber = decbin($intpart).'.'.$pointbitstring;
+                return $binarypointnumber;
+        }
+
+
+        public static function Float2String($floatvalue, $bits) {
+                // http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html
+                switch ($bits) {
+                        case 32:
+                                $exponentbits = 8;
+                                $fractionbits = 23;
+                                break;
+
+                        case 64:
+                                $exponentbits = 11;
+                                $fractionbits = 52;
+                                break;
+
+                        default:
+                                return false;
+                                break;
+                }
+                if ($floatvalue >= 0) {
+                        $signbit = '0';
+                } else {
+                        $signbit = '1';
+                }
+                $normalizedbinary  = self::NormalizeBinaryPoint(self::Float2BinaryDecimal($floatvalue), $fractionbits);
+                $biasedexponent    = pow(2, $exponentbits - 1) - 1 + $normalizedbinary['exponent']; // (127 or 1023) +/- exponent
+                $exponentbitstring = str_pad(decbin($biasedexponent), $exponentbits, '0', STR_PAD_LEFT);
+                $fractionbitstring = str_pad(substr($normalizedbinary['normalized'], 2), $fractionbits, '0', STR_PAD_RIGHT);
+
+                return self::BigEndian2String(self::Bin2Dec($signbit.$exponentbitstring.$fractionbitstring), $bits % 8, false);
+        }
+
+
+        public static function LittleEndian2Float($byteword) {
+                return self::BigEndian2Float(strrev($byteword));
+        }
+
+
+        public static function BigEndian2Float($byteword) {
+                // 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
+
+                $bitword = self::BigEndian2Bin($byteword);
+                if (!$bitword) {
+                        return 0;
+                }
+                $signbit = $bitword{0};
+
+                switch (strlen($byteword) * 8) {
+                        case 32:
+                                $exponentbits = 8;
+                                $fractionbits = 23;
+                                break;
+
+                        case 64:
+                                $exponentbits = 11;
+                                $fractionbits = 52;
+                                break;
+
+                        case 80:
+                                // 80-bit Apple SANE format
+                                // http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/
+                                $exponentstring = substr($bitword, 1, 15);
+                                $isnormalized = intval($bitword{16});
+                                $fractionstring = substr($bitword, 17, 63);
+                                $exponent = pow(2, self::Bin2Dec($exponentstring) - 16383);
+                                $fraction = $isnormalized + self::DecimalBinary2Float($fractionstring);
+                                $floatvalue = $exponent * $fraction;
+                                if ($signbit == '1') {
+                                        $floatvalue *= -1;
+                                }
+                                return $floatvalue;
+                                break;
+
+                        default:
+                                return false;
+                                break;
+                }
+                $exponentstring = substr($bitword, 1, $exponentbits);
+                $fractionstring = substr($bitword, $exponentbits + 1, $fractionbits);
+                $exponent = self::Bin2Dec($exponentstring);
+                $fraction = self::Bin2Dec($fractionstring);
+
+                if (($exponent == (pow(2, $exponentbits) - 1)) && ($fraction != 0)) {
+                        // Not a Number
+                        $floatvalue = false;
+                } elseif (($exponent == (pow(2, $exponentbits) - 1)) && ($fraction == 0)) {
+                        if ($signbit == '1') {
+                                $floatvalue = '-infinity';
+                        } else {
+                                $floatvalue = '+infinity';
+                        }
+                } elseif (($exponent == 0) && ($fraction == 0)) {
+                        if ($signbit == '1') {
+                                $floatvalue = -0;
+                        } else {
+                                $floatvalue = 0;
+                        }
+                        $floatvalue = ($signbit ? 0 : -0);
+                } elseif (($exponent == 0) && ($fraction != 0)) {
+                        // These are 'unnormalized' values
+                        $floatvalue = pow(2, (-1 * (pow(2, $exponentbits - 1) - 2))) * self::DecimalBinary2Float($fractionstring);
+                        if ($signbit == '1') {
+                                $floatvalue *= -1;
+                        }
+                } elseif ($exponent != 0) {
+                        $floatvalue = pow(2, ($exponent - (pow(2, $exponentbits - 1) - 1))) * (1 + self::DecimalBinary2Float($fractionstring));
+                        if ($signbit == '1') {
+                                $floatvalue *= -1;
+                        }
+                }
+                return (float) $floatvalue;
+        }
+
+
+        public static function BigEndian2Int($byteword, $synchsafe=false, $signed=false) {
+                $intvalue = 0;
+                $bytewordlen = strlen($byteword);
+                if ($bytewordlen == 0) {
+                        return false;
+                }
+                for ($i = 0; $i < $bytewordlen; $i++) {
+                        if ($synchsafe) { // disregard MSB, effectively 7-bit bytes
+                                //$intvalue = $intvalue | (ord($byteword{$i}) & 0x7F) << (($bytewordlen - 1 - $i) * 7); // faster, but runs into problems past 2^31 on 32-bit systems
+                                $intvalue += (ord($byteword{$i}) & 0x7F) * pow(2, ($bytewordlen - 1 - $i) * 7);
+                        } else {
+                                $intvalue += ord($byteword{$i}) * pow(256, ($bytewordlen - 1 - $i));
+                        }
+                }
+                if ($signed && !$synchsafe) {
+                        // synchsafe ints are not allowed to be signed
+                        if ($bytewordlen <= PHP_INT_SIZE) {
+                                $signMaskBit = 0x80 << (8 * ($bytewordlen - 1));
+                                if ($intvalue & $signMaskBit) {
+                                        $intvalue = 0 - ($intvalue & ($signMaskBit - 1));
+                                }
+                        } else {
+                                throw new Exception('ERROR: Cannot have signed integers larger than '.(8 * PHP_INT_SIZE).'-bits ('.strlen($byteword).') in self::BigEndian2Int()');
+                                break;
+                        }
+                }
+                return self::CastAsInt($intvalue);
+        }
+
+
+        public static function LittleEndian2Int($byteword, $signed=false) {
+                return self::BigEndian2Int(strrev($byteword), false, $signed);
+        }
+
+
+        public static function BigEndian2Bin($byteword) {
+                $binvalue = '';
+                $bytewordlen = strlen($byteword);
+                for ($i = 0; $i < $bytewordlen; $i++) {
+                        $binvalue .= str_pad(decbin(ord($byteword{$i})), 8, '0', STR_PAD_LEFT);
+                }
+                return $binvalue;
+        }
+
+
+        public static function BigEndian2String($number, $minbytes=1, $synchsafe=false, $signed=false) {
+                if ($number < 0) {
+                        throw new Exception('ERROR: self::BigEndian2String() does not support negative numbers');
+                }
+                $maskbyte = (($synchsafe || $signed) ? 0x7F : 0xFF);
+                $intstring = '';
+                if ($signed) {
+                        if ($minbytes > PHP_INT_SIZE) {
+                                throw new Exception('ERROR: Cannot have signed integers larger than '.(8 * PHP_INT_SIZE).'-bits in self::BigEndian2String()');
+                        }
+                        $number = $number & (0x80 << (8 * ($minbytes - 1)));
+                }
+                while ($number != 0) {
+                        $quotient = ($number / ($maskbyte + 1));
+                        $intstring = chr(ceil(($quotient - floor($quotient)) * $maskbyte)).$intstring;
+                        $number = floor($quotient);
+                }
+                return str_pad($intstring, $minbytes, "\x00", STR_PAD_LEFT);
+        }
+
+
+        public static function Dec2Bin($number) {
+                while ($number >= 256) {
+                        $bytes[] = (($number / 256) - (floor($number / 256))) * 256;
+                        $number = floor($number / 256);
+                }
+                $bytes[] = $number;
+                $binstring = '';
+                for ($i = 0; $i < count($bytes); $i++) {
+                        $binstring = (($i == count($bytes) - 1) ? decbin($bytes[$i]) : str_pad(decbin($bytes[$i]), 8, '0', STR_PAD_LEFT)).$binstring;
+                }
+                return $binstring;
+        }
+
+
+        public static function Bin2Dec($binstring, $signed=false) {
+                $signmult = 1;
+                if ($signed) {
+                        if ($binstring{0} == '1') {
+                                $signmult = -1;
+                        }
+                        $binstring = substr($binstring, 1);
+                }
+                $decvalue = 0;
+                for ($i = 0; $i < strlen($binstring); $i++) {
+                        $decvalue += ((int) substr($binstring, strlen($binstring) - $i - 1, 1)) * pow(2, $i);
+                }
+                return self::CastAsInt($decvalue * $signmult);
+        }
+
+
+        public static function Bin2String($binstring) {
+                // return 'hi' for input of '0110100001101001'
+                $string = '';
+                $binstringreversed = strrev($binstring);
+                for ($i = 0; $i < strlen($binstringreversed); $i += 8) {
+                        $string = chr(self::Bin2Dec(strrev(substr($binstringreversed, $i, 8)))).$string;
+                }
+                return $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);
+        }
+
+
+        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] = self::array_merge_clobber($newarray[$key], $val);
+                        } else {
+                                $newarray[$key] = $val;
+                        }
+                }
+                return $newarray;
+        }
+
+
+        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] = self::array_merge_noclobber($newarray[$key], $val);
+                        } elseif (!isset($newarray[$key])) {
+                                $newarray[$key] = $val;
+                        }
+                }
+                return $newarray;
+        }
+
+
+        public static function ksort_recursive(&$theArray) {
+                ksort($theArray);
+                foreach ($theArray as $key => $value) {
+                        if (is_array($value)) {
+                                self::ksort_recursive($theArray[$key]);
+                        }
+                }
+                return true;
+        }
+
+        public static function fileextension($filename, $numextensions=1) {
+                if (strstr($filename, '.')) {
+                        $reversedfilename = strrev($filename);
+                        $offset = 0;
+                        for ($i = 0; $i < $numextensions; $i++) {
+                                $offset = strpos($reversedfilename, '.', $offset + 1);
+                                if ($offset === false) {
+                                        return '';
+                                }
+                        }
+                        return strrev(substr($reversedfilename, 0, $offset));
+                }
+                return '';
+        }
+
+
+        public static function PlaytimeString($seconds) {
+                $sign = (($seconds < 0) ? '-' : '');
+                $seconds = round(abs($seconds));
+                $H = (int) floor( $seconds                            / 3600);
+                $M = (int) floor(($seconds - (3600 * $H)            ) /   60);
+                $S = (int) round( $seconds - (3600 * $H) - (60 * $M)        );
+                return $sign.($H ? $H.':' : '').($H ? str_pad($M, 2, '0', STR_PAD_LEFT) : intval($M)).':'.str_pad($S, 2, 0, STR_PAD_LEFT);
+        }
+
+
+        public static function DateMac2Unix($macdate) {
+                // Macintosh timestamp: seconds since 00:00h January 1, 1904
+                // UNIX timestamp:      seconds since 00:00h January 1, 1970
+                return self::CastAsInt($macdate - 2082844800);
+        }
+
+
+        public static function FixedPoint8_8($rawdata) {
+                return self::BigEndian2Int(substr($rawdata, 0, 1)) + (float) (self::BigEndian2Int(substr($rawdata, 1, 1)) / pow(2, 8));
+        }
+
+
+        public static function FixedPoint16_16($rawdata) {
+                return self::BigEndian2Int(substr($rawdata, 0, 2)) + (float) (self::BigEndian2Int(substr($rawdata, 2, 2)) / pow(2, 16));
+        }
+
+
+        public static function FixedPoint2_30($rawdata) {
+                $binarystring = self::BigEndian2Bin($rawdata);
+                return self::Bin2Dec(substr($binarystring, 0, 2)) + (float) (self::Bin2Dec(substr($binarystring, 2, 30)) / pow(2, 30));
+        }
+
+
+        public static function CreateDeepArray($ArrayPath, $Separator, $Value) {
+                // assigns $Value to a nested array path:
+                //   $foo = self::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';
+                $ArrayPath = ltrim($ArrayPath, $Separator);
+                if (($pos = strpos($ArrayPath, $Separator)) !== false) {
+                        $ReturnedArray[substr($ArrayPath, 0, $pos)] = self::CreateDeepArray(substr($ArrayPath, $pos + 1), $Separator, $Value);
+                } else {
+                        $ReturnedArray[$ArrayPath] = $Value;
+                }
+                return $ReturnedArray;
+        }
+
+        public static function array_max($arraydata, $returnkey=false) {
+                $maxvalue = false;
+                $maxkey = false;
+                foreach ($arraydata as $key => $value) {
+                        if (!is_array($value)) {
+                                if ($value > $maxvalue) {
+                                        $maxvalue = $value;
+                                        $maxkey = $key;
+                                }
+                        }
+                }
+                return ($returnkey ? $maxkey : $maxvalue);
+        }
+
+        public static function array_min($arraydata, $returnkey=false) {
+                $minvalue = false;
+                $minkey = false;
+                foreach ($arraydata as $key => $value) {
+                        if (!is_array($value)) {
+                                if ($value > $minvalue) {
+                                        $minvalue = $value;
+                                        $minkey = $key;
+                                }
+                        }
+                }
+                return ($returnkey ? $minkey : $minvalue);
+        }
+
+        public static function XML2array($XMLstring) {
+                if (function_exists('simplexml_load_string')) {
+                        if (function_exists('get_object_vars')) {
+                                $XMLobject = simplexml_load_string($XMLstring);
+                                return self::SimpleXMLelement2array($XMLobject);
+                        }
+                }
+                return false;
+        }
+
+        public static function SimpleXMLelement2array($XMLobject) {
+                if (!is_object($XMLobject) && !is_array($XMLobject)) {
+                        return $XMLobject;
+                }
+                $XMLarray = (is_object($XMLobject) ? get_object_vars($XMLobject) : $XMLobject);
+                foreach ($XMLarray as $key => $value) {
+                        $XMLarray[$key] = self::SimpleXMLelement2array($value);
+                }
+                return $XMLarray;
+        }
+
+
+        // Allan Hansen <ahØartemis*dk>
+        // self::md5_data() - returns md5sum for a file from startuing position to absolute end position
+        public static function hash_data($file, $offset, $end, $algorithm) {
+                static $tempdir = '';
+                if (!self::intValueSupported($end)) {
+                        return false;
+                }
+                switch ($algorithm) {
+                        case 'md5':
+                                $hash_function = 'md5_file';
+                                $unix_call     = 'md5sum';
+                                $windows_call  = 'md5sum.exe';
+                                $hash_length   = 32;
+                                break;
+
+                        case 'sha1':
+                                $hash_function = 'sha1_file';
+                                $unix_call     = 'sha1sum';
+                                $windows_call  = 'sha1sum.exe';
+                                $hash_length   = 40;
+                                break;
+
+                        default:
+                                throw new Exception('Invalid algorithm ('.$algorithm.') in self::hash_data()');
+                                break;
+                }
+                $size = $end - $offset;
+                while (true) {
+                        if (GETID3_OS_ISWINDOWS) {
+
+                                // 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') {
+                                        break;
+                                }
+
+                                $RequiredFiles = array('cygwin1.dll', 'head.exe', 'tail.exe', $windows_call);
+                                foreach ($RequiredFiles as $required_file) {
+                                        if (!is_readable(GETID3_HELPERAPPSDIR.$required_file)) {
+                                                // helper apps not available - fall back to old method
+                                                break 2;
+                                        }
+                                }
+                                $commandline  = GETID3_HELPERAPPSDIR.'head.exe -c '.$end.' '.escapeshellarg(str_replace('/', DIRECTORY_SEPARATOR, $file)).' | ';
+                                $commandline .= GETID3_HELPERAPPSDIR.'tail.exe -c '.$size.' | ';
+                                $commandline .= GETID3_HELPERAPPSDIR.$windows_call;
+
+                        } else {
+
+                                $commandline  = 'head -c'.$end.' '.escapeshellarg($file).' | ';
+                                $commandline .= 'tail -c'.$size.' | ';
+                                $commandline .= $unix_call;
+
+                        }
+                        if (preg_match('#(1|ON)#i', ini_get('safe_mode'))) {
+                                //throw new Exception('PHP running in Safe Mode - backtick operator not available, using slower non-system-call '.$algorithm.' algorithm');
+                                break;
+                        }
+                        return substr(`$commandline`, 0, $hash_length);
+                }
+
+                if (empty($tempdir)) {
+                        // yes this is ugly, feel free to suggest a better way
+                        require_once(dirname(__FILE__).'/getid3.php');
+                        $getid3_temp = new getID3();
+                        $tempdir = $getid3_temp->tempdir;
+                        unset($getid3_temp);
+                }
+                // try to create a temporary file in the system temp directory - invalid dirname should force to system temp dir
+                if (($data_filename = tempnam($tempdir, 'gI3')) === false) {
+                        // can't find anywhere to create a temp file, just fail
+                        return false;
+                }
+
+                // Init
+                $result = false;
+
+                // copy parts of file
+                try {
+                        self::CopyFileParts($file, $data_filename, $offset, $end - $offset);
+                        $result = $hash_function($data_filename);
+                } catch (Exception $e) {
+                        throw new Exception('self::CopyFileParts() failed in getid_lib::hash_data(): '.$e->getMessage());
+                }
+                unlink($data_filename);
+                return $result;
+        }
+
+        public static function CopyFileParts($filename_source, $filename_dest, $offset, $length) {
+                if (!self::intValueSupported($offset + $length)) {
+                        throw new Exception('cannot copy file portion, it extends beyond the '.round(PHP_INT_MAX / 1073741824).'GB limit');
+                }
+                if (is_readable($filename_source) && is_file($filename_source) && ($fp_src = fopen($filename_source, 'rb'))) {
+                        if (($fp_dest = fopen($filename_dest, 'wb'))) {
+                                if (fseek($fp_src, $offset, SEEK_SET) == 0) {
+                                        $byteslefttowrite = $length;
+                                        while (($byteslefttowrite > 0) && ($buffer = fread($fp_src, min($byteslefttowrite, getID3::FREAD_BUFFER_SIZE)))) {
+                                                $byteswritten = fwrite($fp_dest, $buffer, $byteslefttowrite);
+                                                $byteslefttowrite -= $byteswritten;
+                                        }
+                                        return true;
+                                } else {
+                                        throw new Exception('failed to seek to offset '.$offset.' in '.$filename_source);
+                                }
+                                fclose($fp_dest);
+                        } else {
+                                throw new Exception('failed to create file for writing '.$filename_dest);
+                        }
+                        fclose($fp_src);
+                } else {
+                        throw new Exception('failed to open file for reading '.$filename_source);
+                }
+                return false;
+        }
+
+        public static function iconv_fallback_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_fallback_iso88591_utf8($string, $bom=false) {
+                if (function_exists('utf8_encode')) {
+                        return utf8_encode($string);
+                }
+                // utf8_encode() unavailable, use getID3()'s iconv_fallback() 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 .= self::iconv_fallback_int_utf8($charval);
+                }
+                return $newcharstring;
+        }
+
+        // ISO-8859-1 => UTF-16BE
+        public static function iconv_fallback_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_fallback_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-16LE (BOM)
+        public static function iconv_fallback_iso88591_utf16($string) {
+                return self::iconv_fallback_iso88591_utf16le($string, true);
+        }
+
+        // UTF-8 => ISO-8859-1
+        public static function iconv_fallback_utf8_iso88591($string) {
+                if (function_exists('utf8_decode')) {
+                        return utf8_decode($string);
+                }
+                // utf8_decode() unavailable, use getID3()'s iconv_fallback() 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_fallback_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) ? self::BigEndian2String($charval, 2) : "\x00".'?');
+                        }
+                }
+                return $newcharstring;
+        }
+
+        // UTF-8 => UTF-16LE
+        public static function iconv_fallback_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) ? self::LittleEndian2String($charval, 2) : '?'."\x00");
+                        }
+                }
+                return $newcharstring;
+        }
+
+        // UTF-8 => UTF-16LE (BOM)
+        public static function iconv_fallback_utf8_utf16($string) {
+                return self::iconv_fallback_utf8_utf16le($string, true);
+        }
+
+        // UTF-16BE => UTF-8
+        public static function iconv_fallback_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 = self::BigEndian2Int(substr($string, $i, 2));
+                        $newcharstring .= self::iconv_fallback_int_utf8($charval);
+                }
+                return $newcharstring;
+        }
+
+        // UTF-16LE => UTF-8
+        public static function iconv_fallback_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 = self::LittleEndian2Int(substr($string, $i, 2));
+                        $newcharstring .= self::iconv_fallback_int_utf8($charval);
+                }
+                return $newcharstring;
+        }
+
+        // UTF-16BE => ISO-8859-1
+        public static function iconv_fallback_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 = self::BigEndian2Int(substr($string, $i, 2));
+                        $newcharstring .= (($charval < 256) ? chr($charval) : '?');
+                }
+                return $newcharstring;
+        }
+
+        // UTF-16LE => ISO-8859-1
+        public static function iconv_fallback_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 = self::LittleEndian2Int(substr($string, $i, 2));
+                        $newcharstring .= (($charval < 256) ? chr($charval) : '?');
+                }
+                return $newcharstring;
+        }
+
+        // UTF-16 (BOM) => ISO-8859-1
+        public static function iconv_fallback_utf16_iso88591($string) {
+                $bom = substr($string, 0, 2);
+                if ($bom == "\xFE\xFF") {
+                        return self::iconv_fallback_utf16be_iso88591(substr($string, 2));
+                } elseif ($bom == "\xFF\xFE") {
+                        return self::iconv_fallback_utf16le_iso88591(substr($string, 2));
+                }
+                return $string;
+        }
+
+        // UTF-16 (BOM) => UTF-8
+        public static function iconv_fallback_utf16_utf8($string) {
+                $bom = substr($string, 0, 2);
+                if ($bom == "\xFE\xFF") {
+                        return self::iconv_fallback_utf16be_utf8(substr($string, 2));
+                } elseif ($bom == "\xFF\xFE") {
+                        return self::iconv_fallback_utf16le_utf8(substr($string, 2));
+                }
+                return $string;
+        }
+
+        public static function iconv_fallback($in_charset, $out_charset, $string) {
+
+                if ($in_charset == $out_charset) {
+                        return $string;
+                }
+
+                // iconv() availble
+                if (function_exists('iconv')) {
+                        if ($converted_string = @iconv($in_charset, $out_charset.'//TRANSLIT', $string)) {
+                                switch ($out_charset) {
+                                        case 'ISO-8859-1':
+                                                $converted_string = rtrim($converted_string, "\x00");
+                                                break;
+                                }
+                                return $converted_string;
+                        }
+
+                        // iconv() may sometimes fail with "illegal character in input string" error message
+                        // and return an empty string, but returning the unconverted string is more useful
+                        return $string;
+                }
+
+
+                // iconv() not available
+                static $ConversionFunctionList = array();
+                if (empty($ConversionFunctionList)) {
+                        $ConversionFunctionList['ISO-8859-1']['UTF-8']    = 'iconv_fallback_iso88591_utf8';
+                        $ConversionFunctionList['ISO-8859-1']['UTF-16']   = 'iconv_fallback_iso88591_utf16';
+                        $ConversionFunctionList['ISO-8859-1']['UTF-16BE'] = 'iconv_fallback_iso88591_utf16be';
+                        $ConversionFunctionList['ISO-8859-1']['UTF-16LE'] = 'iconv_fallback_iso88591_utf16le';
+                        $ConversionFunctionList['UTF-8']['ISO-8859-1']    = 'iconv_fallback_utf8_iso88591';
+                        $ConversionFunctionList['UTF-8']['UTF-16']        = 'iconv_fallback_utf8_utf16';
+                        $ConversionFunctionList['UTF-8']['UTF-16BE']      = 'iconv_fallback_utf8_utf16be';
+                        $ConversionFunctionList['UTF-8']['UTF-16LE']      = 'iconv_fallback_utf8_utf16le';
+                        $ConversionFunctionList['UTF-16']['ISO-8859-1']   = 'iconv_fallback_utf16_iso88591';
+                        $ConversionFunctionList['UTF-16']['UTF-8']        = 'iconv_fallback_utf16_utf8';
+                        $ConversionFunctionList['UTF-16LE']['ISO-8859-1'] = 'iconv_fallback_utf16le_iso88591';
+                        $ConversionFunctionList['UTF-16LE']['UTF-8']      = 'iconv_fallback_utf16le_utf8';
+                        $ConversionFunctionList['UTF-16BE']['ISO-8859-1'] = 'iconv_fallback_utf16be_iso88591';
+                        $ConversionFunctionList['UTF-16BE']['UTF-8']      = 'iconv_fallback_utf16be_utf8';
+                }
+                if (isset($ConversionFunctionList[strtoupper($in_charset)][strtoupper($out_charset)])) {
+                        $ConversionFunction = $ConversionFunctionList[strtoupper($in_charset)][strtoupper($out_charset)];
+                        return self::$ConversionFunction($string);
+                }
+                throw new Exception('PHP does not have iconv() support - cannot convert from '.$in_charset.' to '.$out_charset);
+        }
+
+
+        public static function MultiByteCharString2HTML($string, $charset='ISO-8859-1') {
+                $string = (string) $string; // in case trying to pass a numeric (float, int) string, would otherwise return an empty string
+                $HTMLstring = '';
+
+                switch ($charset) {
+                        case '1251':
+                        case '1252':
+                        case '866':
+                        case '932':
+                        case '936':
+                        case '950':
+                        case 'BIG5':
+                        case 'BIG5-HKSCS':
+                        case 'cp1251':
+                        case 'cp1252':
+                        case 'cp866':
+                        case 'EUC-JP':
+                        case 'EUCJP':
+                        case 'GB2312':
+                        case 'ibm866':
+                        case 'ISO-8859-1':
+                        case 'ISO-8859-15':
+                        case 'ISO8859-1':
+                        case 'ISO8859-15':
+                        case 'KOI8-R':
+                        case 'koi8-ru':
+                        case 'koi8r':
+                        case 'Shift_JIS':
+                        case 'SJIS':
+                        case 'win-1251':
+                        case 'Windows-1251':
+                        case 'Windows-1252':
+                                $HTMLstring = htmlentities($string, ENT_COMPAT, $charset);
+                                break;
+
+                        case 'UTF-8':
+                                $strlen = strlen($string);
+                                for ($i = 0; $i < $strlen; $i++) {
+                                        $char_ord_val = ord($string{$i});
+                                        $charval = 0;
+                                        if ($char_ord_val < 0x80) {
+                                                $charval = $char_ord_val;
+                                        } elseif ((($char_ord_val & 0xF0) >> 4) == 0x0F  &&  $i+3 < $strlen) {
+                                                $charval  = (($char_ord_val & 0x07) << 18);
+                                                $charval += ((ord($string{++$i}) & 0x3F) << 12);
+                                                $charval += ((ord($string{++$i}) & 0x3F) << 6);
+                                                $charval +=  (ord($string{++$i}) & 0x3F);
+                                        } elseif ((($char_ord_val & 0xE0) >> 5) == 0x07  &&  $i+2 < $strlen) {
+                                                $charval  = (($char_ord_val & 0x0F) << 12);
+                                                $charval += ((ord($string{++$i}) & 0x3F) << 6);
+                                                $charval +=  (ord($string{++$i}) & 0x3F);
+                                        } elseif ((($char_ord_val & 0xC0) >> 6) == 0x03  &&  $i+1 < $strlen) {
+                                                $charval  = (($char_ord_val & 0x1F) << 6);
+                                                $charval += (ord($string{++$i}) & 0x3F);
+                                        }
+                                        if (($charval >= 32) && ($charval <= 127)) {
+                                                $HTMLstring .= htmlentities(chr($charval));
+                                        } else {
+                                                $HTMLstring .= '&#'.$charval.';';
+                                        }
+                                }
+                                break;
+
+                        case 'UTF-16LE':
+                                for ($i = 0; $i < strlen($string); $i += 2) {
+                                        $charval = self::LittleEndian2Int(substr($string, $i, 2));
+                                        if (($charval >= 32) && ($charval <= 127)) {
+                                                $HTMLstring .= chr($charval);
+                                        } else {
+                                                $HTMLstring .= '&#'.$charval.';';
+                                        }
+                                }
+                                break;
+
+                        case 'UTF-16BE':
+                                for ($i = 0; $i < strlen($string); $i += 2) {
+                                        $charval = self::BigEndian2Int(substr($string, $i, 2));
+                                        if (($charval >= 32) && ($charval <= 127)) {
+                                                $HTMLstring .= chr($charval);
+                                        } else {
+                                                $HTMLstring .= '&#'.$charval.';';
+                                        }
+                                }
+                                break;
+
+                        default:
+                                $HTMLstring = 'ERROR: Character set "'.$charset.'" not supported in MultiByteCharString2HTML()';
+                                break;
+                }
+                return $HTMLstring;
+        }
+
+
+
+        public static function RGADnameLookup($namecode) {
+                static $RGADname = array();
+                if (empty($RGADname)) {
+                        $RGADname[0] = 'not set';
+                        $RGADname[1] = 'Track Gain Adjustment';
+                        $RGADname[2] = 'Album Gain Adjustment';
+                }
+
+                return (isset($RGADname[$namecode]) ? $RGADname[$namecode] : '');
+        }
+
+
+        public static function RGADoriginatorLookup($originatorcode) {
+                static $RGADoriginator = array();
+                if (empty($RGADoriginator)) {
+                        $RGADoriginator[0] = 'unspecified';
+                        $RGADoriginator[1] = 'pre-set by artist/producer/mastering engineer';
+                        $RGADoriginator[2] = 'set by user';
+                        $RGADoriginator[3] = 'determined automatically';
+                }
+
+                return (isset($RGADoriginator[$originatorcode]) ? $RGADoriginator[$originatorcode] : '');
+        }
+
+
+        public static function RGADadjustmentLookup($rawadjustment, $signbit) {
+                $adjustment = $rawadjustment / 10;
+                if ($signbit == 1) {
+                        $adjustment *= -1;
+                }
+                return (float) $adjustment;
+        }
+
+
+        public static function RGADgainString($namecode, $originatorcode, $replaygain) {
+                if ($replaygain < 0) {
+                        $signbit = '1';
+                } else {
+                        $signbit = '0';
+                }
+                $storedreplaygain = intval(round($replaygain * 10));
+                $gainstring  = str_pad(decbin($namecode), 3, '0', STR_PAD_LEFT);
+                $gainstring .= str_pad(decbin($originatorcode), 3, '0', STR_PAD_LEFT);
+                $gainstring .= $signbit;
+                $gainstring .= str_pad(decbin($storedreplaygain), 9, '0', STR_PAD_LEFT);
+
+                return $gainstring;
+        }
+
+        public static function RGADamplitude2dB($amplitude) {
+                return 20 * log10($amplitude);
+        }
+
+
+        public static function GetDataImageSize($imgData, &$imageinfo=array()) {
+                static $tempdir = '';
+                if (empty($tempdir)) {
+                        // yes this is ugly, feel free to suggest a better way
+                        require_once(dirname(__FILE__).'/class-getid3.php');
+                        $getid3_temp = new getID3();
+                        $tempdir = $getid3_temp->tempdir;
+                        unset($getid3_temp);
+                }
+                $GetDataImageSize = false;
+                if ($tempfilename = tempnam($tempdir, 'gI3')) {
+                        if (is_writable($tempfilename) && is_file($tempfilename) && ($tmp = fopen($tempfilename, 'wb'))) {
+                                fwrite($tmp, $imgData);
+                                fclose($tmp);
+                                $GetDataImageSize = @getimagesize($tempfilename, $imageinfo);
+                        }
+                        unlink($tempfilename);
+                }
+                return $GetDataImageSize;
+        }
+
+        public static function ImageExtFromMime($mime_type) {
+                // temporary way, works OK for now, but should be reworked in the future
+                return str_replace(array('image/', 'x-', 'jpeg'), array('', '', 'jpg'), $mime_type);
+        }
+
+        public static function ImageTypesLookup($imagetypeid) {
+                static $ImageTypesLookup = array();
+                if (empty($ImageTypesLookup)) {
+                        $ImageTypesLookup[1]  = 'gif';
+                        $ImageTypesLookup[2]  = 'jpeg';
+                        $ImageTypesLookup[3]  = 'png';
+                        $ImageTypesLookup[4]  = 'swf';
+                        $ImageTypesLookup[5]  = 'psd';
+                        $ImageTypesLookup[6]  = 'bmp';
+                        $ImageTypesLookup[7]  = 'tiff (little-endian)';
+                        $ImageTypesLookup[8]  = 'tiff (big-endian)';
+                        $ImageTypesLookup[9]  = 'jpc';
+                        $ImageTypesLookup[10] = 'jp2';
+                        $ImageTypesLookup[11] = 'jpx';
+                        $ImageTypesLookup[12] = 'jb2';
+                        $ImageTypesLookup[13] = 'swc';
+                        $ImageTypesLookup[14] = 'iff';
+                }
+                return (isset($ImageTypesLookup[$imagetypeid]) ? $ImageTypesLookup[$imagetypeid] : '');
+        }
+
+        public static function CopyTagsToComments(&$ThisFileInfo) {
+
+                // Copy all entries from ['tags'] into common ['comments']
+                if (!empty($ThisFileInfo['tags'])) {
+                        foreach ($ThisFileInfo['tags'] as $tagtype => $tagarray) {
+                                foreach ($tagarray as $tagname => $tagdata) {
+                                        foreach ($tagdata as $key => $value) {
+                                                if (!empty($value)) {
+                                                        if (empty($ThisFileInfo['comments'][$tagname])) {
+
+                                                                // fall through and append value
+
+                                                        } elseif ($tagtype == 'id3v1') {
+
+                                                                $newvaluelength = strlen(trim($value));
+                                                                foreach ($ThisFileInfo['comments'][$tagname] as $existingkey => $existingvalue) {
+                                                                        $oldvaluelength = strlen(trim($existingvalue));
+                                                                        if (($newvaluelength <= $oldvaluelength) && (substr($existingvalue, 0, $newvaluelength) == trim($value))) {
+                                                                                // new value is identical but shorter-than (or equal-length to) one already in comments - skip
+                                                                                break 2;
+                                                                        }
+                                                                }
+
+                                                        } elseif (!is_array($value)) {
+
+                                                                $newvaluelength = strlen(trim($value));
+                                                                foreach ($ThisFileInfo['comments'][$tagname] as $existingkey => $existingvalue) {
+                                                                        $oldvaluelength = strlen(trim($existingvalue));
+                                                                        if (($newvaluelength > $oldvaluelength) && (substr(trim($value), 0, strlen($existingvalue)) == $existingvalue)) {
+                                                                                $ThisFileInfo['comments'][$tagname][$existingkey] = trim($value);
+                                                                                break 2;
+                                                                        }
+                                                                }
+
+                                                        }
+                                                        if (is_array($value) || empty($ThisFileInfo['comments'][$tagname]) || !in_array(trim($value), $ThisFileInfo['comments'][$tagname])) {
+                                                                $value = (is_string($value) ? trim($value) : $value);
+                                                                $ThisFileInfo['comments'][$tagname][] = $value;
+                                                        }
+                                                }
+                                        }
+                                }
+                        }
+
+                        // Copy to ['comments_html']
+                        foreach ($ThisFileInfo['comments'] as $field => $values) {
+                                if ($field == 'picture') {
+                                        // pictures can take up a lot of space, and we don't need multiple copies of them
+                                        // let there be a single copy in [comments][picture], and not elsewhere
+                                        continue;
+                                }
+                                foreach ($values as $index => $value) {
+                                        if (is_array($value)) {
+                                                $ThisFileInfo['comments_html'][$field][$index] = $value;
+                                        } else {
+                                                $ThisFileInfo['comments_html'][$field][$index] = str_replace('&#0;', '', self::MultiByteCharString2HTML($value, $ThisFileInfo['encoding']));
+                                        }
+                                }
+                        }
+                }
+                return true;
+        }
+
+
+        public static function EmbeddedLookup($key, $begin, $end, $file, $name) {
+
+                // Cached
+                static $cache;
+                if (isset($cache[$file][$name])) {
+                        return (isset($cache[$file][$name][$key]) ? $cache[$file][$name][$key] : '');
+                }
+
+                // Init
+                $keylength  = strlen($key);
+                $line_count = $end - $begin - 7;
+
+                // Open php file
+                $fp = fopen($file, 'r');
+
+                // Discard $begin lines
+                for ($i = 0; $i < ($begin + 3); $i++) {
+                        fgets($fp, 1024);
+                }
+
+                // Loop thru line
+                while (0 < $line_count--) {
+
+                        // Read line
+                        $line = ltrim(fgets($fp, 1024), "\t ");
+
+                        // METHOD A: only cache the matching key - less memory but slower on next lookup of not-previously-looked-up key
+                        //$keycheck = substr($line, 0, $keylength);
+                        //if ($key == $keycheck)  {
+                        //      $cache[$file][$name][$keycheck] = substr($line, $keylength + 1);
+                        //      break;
+                        //}
+
+                        // METHOD B: cache all keys in this lookup - more memory but faster on next lookup of not-previously-looked-up key
+                        //$cache[$file][$name][substr($line, 0, $keylength)] = trim(substr($line, $keylength + 1));
+                        $explodedLine = explode("\t", $line, 2);
+                        $ThisKey   = (isset($explodedLine[0]) ? $explodedLine[0] : '');
+                        $ThisValue = (isset($explodedLine[1]) ? $explodedLine[1] : '');
+                        $cache[$file][$name][$ThisKey] = trim($ThisValue);
+                }
+
+                // Close and return
+                fclose($fp);
+                return (isset($cache[$file][$name][$key]) ? $cache[$file][$name][$key] : '');
+        }
+
+        public static function IncludeDependency($filename, $sourcefile, $DieOnFailure=false) {
+                global $GETID3_ERRORARRAY;
+
+                if (file_exists($filename)) {
+                        if (include_once($filename)) {
+                                return true;
+                        } else {
+                                $diemessage = basename($sourcefile).' depends on '.$filename.', which has errors';
+                        }
+                } else {
+                        $diemessage = basename($sourcefile).' depends on '.$filename.', which is missing';
+                }
+                if ($DieOnFailure) {
+                        throw new Exception($diemessage);
+                } else {
+                        $GETID3_ERRORARRAY[] = $diemessage;
+                }
+                return false;
+        }
+
+        public static function trimNullByte($string) {
+                return trim($string, "\x00");
+        }
+
+        public static function getFileSizeSyscall($path) {
+                $filesize = false;
+
+                if (GETID3_OS_ISWINDOWS) {
+                        if (class_exists('COM')) { // From PHP 5.3.15 and 5.4.5, COM and DOTNET is no longer built into the php core.you have to add COM support in php.ini:
+                                $filesystem = new COM('Scripting.FileSystemObject');
+                                $file = $filesystem->GetFile($path);
+                                $filesize = $file->Size();
+                                unset($filesystem, $file);
+                        } else {
+                                $commandline = 'for %I in ('.escapeshellarg($path).') do @echo %~zI';
+                        }
+                } else {
+                        $commandline = 'ls -l '.escapeshellarg($path).' | awk \'{print $5}\'';
+                }
+                if (isset($commandline)) {
+                        $output = trim(`$commandline`);
+                        if (ctype_digit($output)) {
+                                $filesize = (float) $output;
+                        }
+                }
+                return $filesize;
+        }
+}
+ No newline at end of file

new file wp-includes/ID3/module.audio-video.asf.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio-video.asf.php                                  //
+// module for analyzing ASF, WMA and WMV files                 //
+// dependencies: module.audio-video.riff.php                   //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio-video.riff.php', __FILE__, true);
+
+class getid3_asf extends getid3_handler
+{
+
+        public function __construct(getID3 $getid3) {
+                parent::__construct($getid3);  // extends getid3_handler::__construct()
+
+                // initialize all GUID constants
+                $GUIDarray = $this->KnownGUIDs();
+                foreach ($GUIDarray as $GUIDname => $hexstringvalue) {
+                        if (!defined($GUIDname)) {
+                                define($GUIDname, $this->GUIDtoBytestring($hexstringvalue));
+                        }
+                }
+        }
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                // Shortcuts
+                $thisfile_audio = &$info['audio'];
+                $thisfile_video = &$info['video'];
+                $info['asf']  = array();
+                $thisfile_asf = &$info['asf'];
+                $thisfile_asf['comments'] = array();
+                $thisfile_asf_comments    = &$thisfile_asf['comments'];
+                $thisfile_asf['header_object'] = array();
+                $thisfile_asf_headerobject     = &$thisfile_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
+
+                $info['fileformat'] = 'asf';
+
+                fseek($this->getid3->fp, $info['avdataoffset'], SEEK_SET);
+                $HeaderObjectData = fread($this->getid3->fp, 30);
+
+                $thisfile_asf_headerobject['objectid']      = substr($HeaderObjectData, 0, 16);
+                $thisfile_asf_headerobject['objectid_guid'] = $this->BytestringToGUID($thisfile_asf_headerobject['objectid']);
+                if ($thisfile_asf_headerobject['objectid'] != GETID3_ASF_Header_Object) {
+                        $info['warning'][] = 'ASF header GUID {'.$this->BytestringToGUID($thisfile_asf_headerobject['objectid']).'} does not match expected "GETID3_ASF_Header_Object" GUID {'.$this->BytestringToGUID(GETID3_ASF_Header_Object).'}';
+                        unset($info['fileformat']);
+                        unset($info['asf']);
+                        return false;
+                        break;
+                }
+                $thisfile_asf_headerobject['objectsize']    = getid3_lib::LittleEndian2Int(substr($HeaderObjectData, 16, 8));
+                $thisfile_asf_headerobject['headerobjects'] = getid3_lib::LittleEndian2Int(substr($HeaderObjectData, 24, 4));
+                $thisfile_asf_headerobject['reserved1']     = getid3_lib::LittleEndian2Int(substr($HeaderObjectData, 28, 1));
+                $thisfile_asf_headerobject['reserved2']     = getid3_lib::LittleEndian2Int(substr($HeaderObjectData, 29, 1));
+
+                $NextObjectOffset = ftell($this->getid3->fp);
+                $ASFHeaderData = fread($this->getid3->fp, $thisfile_asf_headerobject['objectsize'] - 30);
+                $offset = 0;
+
+                for ($HeaderObjectsCounter = 0; $HeaderObjectsCounter < $thisfile_asf_headerobject['headerobjects']; $HeaderObjectsCounter++) {
+                        $NextObjectGUID = substr($ASFHeaderData, $offset, 16);
+                        $offset += 16;
+                        $NextObjectGUIDtext = $this->BytestringToGUID($NextObjectGUID);
+                        $NextObjectSize = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                        $offset += 8;
+                        switch ($NextObjectGUID) {
+
+                                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
+
+                                        // shortcut
+                                        $thisfile_asf['file_properties_object'] = array();
+                                        $thisfile_asf_filepropertiesobject      = &$thisfile_asf['file_properties_object'];
+
+                                        $thisfile_asf_filepropertiesobject['offset']             = $NextObjectOffset + $offset;
+                                        $thisfile_asf_filepropertiesobject['objectid']           = $NextObjectGUID;
+                                        $thisfile_asf_filepropertiesobject['objectid_guid']      = $NextObjectGUIDtext;
+                                        $thisfile_asf_filepropertiesobject['objectsize']         = $NextObjectSize;
+                                        $thisfile_asf_filepropertiesobject['fileid']             = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_filepropertiesobject['fileid_guid']        = $this->BytestringToGUID($thisfile_asf_filepropertiesobject['fileid']);
+                                        $thisfile_asf_filepropertiesobject['filesize']           = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                        $offset += 8;
+                                        $thisfile_asf_filepropertiesobject['creation_date']      = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                        $thisfile_asf_filepropertiesobject['creation_date_unix'] = $this->FILETIMEtoUNIXtime($thisfile_asf_filepropertiesobject['creation_date']);
+                                        $offset += 8;
+                                        $thisfile_asf_filepropertiesobject['data_packets']       = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                        $offset += 8;
+                                        $thisfile_asf_filepropertiesobject['play_duration']      = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                        $offset += 8;
+                                        $thisfile_asf_filepropertiesobject['send_duration']      = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                        $offset += 8;
+                                        $thisfile_asf_filepropertiesobject['preroll']            = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                        $offset += 8;
+                                        $thisfile_asf_filepropertiesobject['flags_raw']          = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        $thisfile_asf_filepropertiesobject['flags']['broadcast'] = (bool) ($thisfile_asf_filepropertiesobject['flags_raw'] & 0x0001);
+                                        $thisfile_asf_filepropertiesobject['flags']['seekable']  = (bool) ($thisfile_asf_filepropertiesobject['flags_raw'] & 0x0002);
+
+                                        $thisfile_asf_filepropertiesobject['min_packet_size']    = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        $thisfile_asf_filepropertiesobject['max_packet_size']    = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        $thisfile_asf_filepropertiesobject['max_bitrate']        = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+
+                                        if ($thisfile_asf_filepropertiesobject['flags']['broadcast']) {
+
+                                                // broadcast flag is set, some values invalid
+                                                unset($thisfile_asf_filepropertiesobject['filesize']);
+                                                unset($thisfile_asf_filepropertiesobject['data_packets']);
+                                                unset($thisfile_asf_filepropertiesobject['play_duration']);
+                                                unset($thisfile_asf_filepropertiesobject['send_duration']);
+                                                unset($thisfile_asf_filepropertiesobject['min_packet_size']);
+                                                unset($thisfile_asf_filepropertiesobject['max_packet_size']);
+
+                                        } else {
+
+                                                // broadcast flag NOT set, perform calculations
+                                                $info['playtime_seconds'] = ($thisfile_asf_filepropertiesobject['play_duration'] / 10000000) - ($thisfile_asf_filepropertiesobject['preroll'] / 1000);
+
+                                                //$info['bitrate'] = $thisfile_asf_filepropertiesobject['max_bitrate'];
+                                                $info['bitrate'] = ((isset($thisfile_asf_filepropertiesobject['filesize']) ? $thisfile_asf_filepropertiesobject['filesize'] : $info['filesize']) * 8) / $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
+
+                                        $StreamPropertiesObjectData['offset']             = $NextObjectOffset + $offset;
+                                        $StreamPropertiesObjectData['objectid']           = $NextObjectGUID;
+                                        $StreamPropertiesObjectData['objectid_guid']      = $NextObjectGUIDtext;
+                                        $StreamPropertiesObjectData['objectsize']         = $NextObjectSize;
+                                        $StreamPropertiesObjectData['stream_type']        = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $StreamPropertiesObjectData['stream_type_guid']   = $this->BytestringToGUID($StreamPropertiesObjectData['stream_type']);
+                                        $StreamPropertiesObjectData['error_correct_type'] = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $StreamPropertiesObjectData['error_correct_guid'] = $this->BytestringToGUID($StreamPropertiesObjectData['error_correct_type']);
+                                        $StreamPropertiesObjectData['time_offset']        = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                        $offset += 8;
+                                        $StreamPropertiesObjectData['type_data_length']   = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        $StreamPropertiesObjectData['error_data_length']  = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        $StreamPropertiesObjectData['flags_raw']          = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $StreamPropertiesObjectStreamNumber               = $StreamPropertiesObjectData['flags_raw'] & 0x007F;
+                                        $StreamPropertiesObjectData['flags']['encrypted'] = (bool) ($StreamPropertiesObjectData['flags_raw'] & 0x8000);
+
+                                        $offset += 4; // reserved - DWORD
+                                        $StreamPropertiesObjectData['type_specific_data'] = substr($ASFHeaderData, $offset, $StreamPropertiesObjectData['type_data_length']);
+                                        $offset += $StreamPropertiesObjectData['type_data_length'];
+                                        $StreamPropertiesObjectData['error_correct_data'] = substr($ASFHeaderData, $offset, $StreamPropertiesObjectData['error_data_length']);
+                                        $offset += $StreamPropertiesObjectData['error_data_length'];
+
+                                        switch ($StreamPropertiesObjectData['stream_type']) {
+
+                                                case GETID3_ASF_Audio_Media:
+                                                        $thisfile_audio['dataformat']   = (!empty($thisfile_audio['dataformat'])   ? $thisfile_audio['dataformat']   : 'asf');
+                                                        $thisfile_audio['bitrate_mode'] = (!empty($thisfile_audio['bitrate_mode']) ? $thisfile_audio['bitrate_mode'] : 'cbr');
+
+                                                        $audiodata = getid3_riff::parseWAVEFORMATex(substr($StreamPropertiesObjectData['type_specific_data'], 0, 16));
+                                                        unset($audiodata['raw']);
+                                                        $thisfile_audio = getid3_lib::array_merge_noclobber($audiodata, $thisfile_audio);
+                                                        break;
+
+                                                case GETID3_ASF_Video_Media:
+                                                        $thisfile_video['dataformat']   = (!empty($thisfile_video['dataformat'])   ? $thisfile_video['dataformat']   : 'asf');
+                                                        $thisfile_video['bitrate_mode'] = (!empty($thisfile_video['bitrate_mode']) ? $thisfile_video['bitrate_mode'] : 'cbr');
+                                                        break;
+
+                                                case GETID3_ASF_Command_Media:
+                                                default:
+                                                        // do nothing
+                                                        break;
+
+                                        }
+
+                                        $thisfile_asf['stream_properties_object'][$StreamPropertiesObjectStreamNumber] = $StreamPropertiesObjectData;
+                                        unset($StreamPropertiesObjectData); // 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
+
+                                        // shortcut
+                                        $thisfile_asf['header_extension_object'] = array();
+                                        $thisfile_asf_headerextensionobject      = &$thisfile_asf['header_extension_object'];
+
+                                        $thisfile_asf_headerextensionobject['offset']              = $NextObjectOffset + $offset;
+                                        $thisfile_asf_headerextensionobject['objectid']            = $NextObjectGUID;
+                                        $thisfile_asf_headerextensionobject['objectid_guid']       = $NextObjectGUIDtext;
+                                        $thisfile_asf_headerextensionobject['objectsize']          = $NextObjectSize;
+                                        $thisfile_asf_headerextensionobject['reserved_1']          = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_headerextensionobject['reserved_1_guid']     = $this->BytestringToGUID($thisfile_asf_headerextensionobject['reserved_1']);
+                                        if ($thisfile_asf_headerextensionobject['reserved_1'] != GETID3_ASF_Reserved_1) {
+                                                $info['warning'][] = 'header_extension_object.reserved_1 GUID ('.$this->BytestringToGUID($thisfile_asf_headerextensionobject['reserved_1']).') does not match expected "GETID3_ASF_Reserved_1" GUID ('.$this->BytestringToGUID(GETID3_ASF_Reserved_1).')';
+                                                //return false;
+                                                break;
+                                        }
+                                        $thisfile_asf_headerextensionobject['reserved_2']          = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        if ($thisfile_asf_headerextensionobject['reserved_2'] != 6) {
+                                                $info['warning'][] = 'header_extension_object.reserved_2 ('.getid3_lib::PrintHexBytes($thisfile_asf_headerextensionobject['reserved_2']).') does not match expected value of "6"';
+                                                //return false;
+                                                break;
+                                        }
+                                        $thisfile_asf_headerextensionobject['extension_data_size'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        $thisfile_asf_headerextensionobject['extension_data']      =                              substr($ASFHeaderData, $offset, $thisfile_asf_headerextensionobject['extension_data_size']);
+                                        $unhandled_sections = 0;
+                                        $thisfile_asf_headerextensionobject['extension_data_parsed'] = $this->ASF_HeaderExtensionObjectDataParse($thisfile_asf_headerextensionobject['extension_data'], $unhandled_sections);
+                                        if ($unhandled_sections === 0) {
+                                                unset($thisfile_asf_headerextensionobject['extension_data']);
+                                        }
+                                        $offset += $thisfile_asf_headerextensionobject['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
+
+                                        // shortcut
+                                        $thisfile_asf['codec_list_object'] = array();
+                                        $thisfile_asf_codeclistobject      = &$thisfile_asf['codec_list_object'];
+
+                                        $thisfile_asf_codeclistobject['offset']                    = $NextObjectOffset + $offset;
+                                        $thisfile_asf_codeclistobject['objectid']                  = $NextObjectGUID;
+                                        $thisfile_asf_codeclistobject['objectid_guid']             = $NextObjectGUIDtext;
+                                        $thisfile_asf_codeclistobject['objectsize']                = $NextObjectSize;
+                                        $thisfile_asf_codeclistobject['reserved']                  = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_codeclistobject['reserved_guid']             = $this->BytestringToGUID($thisfile_asf_codeclistobject['reserved']);
+                                        if ($thisfile_asf_codeclistobject['reserved'] != $this->GUIDtoBytestring('86D15241-311D-11D0-A3A4-00A0C90348F6')) {
+                                                $info['warning'][] = 'codec_list_object.reserved GUID {'.$this->BytestringToGUID($thisfile_asf_codeclistobject['reserved']).'} does not match expected "GETID3_ASF_Reserved_1" GUID {86D15241-311D-11D0-A3A4-00A0C90348F6}';
+                                                //return false;
+                                                break;
+                                        }
+                                        $thisfile_asf_codeclistobject['codec_entries_count'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        for ($CodecEntryCounter = 0; $CodecEntryCounter < $thisfile_asf_codeclistobject['codec_entries_count']; $CodecEntryCounter++) {
+                                                // shortcut
+                                                $thisfile_asf_codeclistobject['codec_entries'][$CodecEntryCounter] = array();
+                                                $thisfile_asf_codeclistobject_codecentries_current = &$thisfile_asf_codeclistobject['codec_entries'][$CodecEntryCounter];
+
+                                                $thisfile_asf_codeclistobject_codecentries_current['type_raw'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_codeclistobject_codecentries_current['type'] = $this->ASFCodecListObjectTypeLookup($thisfile_asf_codeclistobject_codecentries_current['type_raw']);
+
+                                                $CodecNameLength = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2)) * 2; // 2 bytes per character
+                                                $offset += 2;
+                                                $thisfile_asf_codeclistobject_codecentries_current['name'] = substr($ASFHeaderData, $offset, $CodecNameLength);
+                                                $offset += $CodecNameLength;
+
+                                                $CodecDescriptionLength = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2)) * 2; // 2 bytes per character
+                                                $offset += 2;
+                                                $thisfile_asf_codeclistobject_codecentries_current['description'] = substr($ASFHeaderData, $offset, $CodecDescriptionLength);
+                                                $offset += $CodecDescriptionLength;
+
+                                                $CodecInformationLength = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_codeclistobject_codecentries_current['information'] = substr($ASFHeaderData, $offset, $CodecInformationLength);
+                                                $offset += $CodecInformationLength;
+
+                                                if ($thisfile_asf_codeclistobject_codecentries_current['type_raw'] == 2) { // audio codec
+
+                                                        if (strpos($thisfile_asf_codeclistobject_codecentries_current['description'], ',') === false) {
+                                                                $info['warning'][] = '[asf][codec_list_object][codec_entries]['.$CodecEntryCounter.'][description] expected to contain comma-seperated list of parameters: "'.$thisfile_asf_codeclistobject_codecentries_current['description'].'"';
+                                                        } else {
+
+                                                                list($AudioCodecBitrate, $AudioCodecFrequency, $AudioCodecChannels) = explode(',', $this->TrimConvert($thisfile_asf_codeclistobject_codecentries_current['description']));
+                                                                $thisfile_audio['codec'] = $this->TrimConvert($thisfile_asf_codeclistobject_codecentries_current['name']);
+
+                                                                if (!isset($thisfile_audio['bitrate']) && strstr($AudioCodecBitrate, 'kbps')) {
+                                                                        $thisfile_audio['bitrate'] = (int) (trim(str_replace('kbps', '', $AudioCodecBitrate)) * 1000);
+                                                                }
+                                                                //if (!isset($thisfile_video['bitrate']) && isset($thisfile_audio['bitrate']) && isset($thisfile_asf['file_properties_object']['max_bitrate']) && ($thisfile_asf_codeclistobject['codec_entries_count'] > 1)) {
+                                                                if (empty($thisfile_video['bitrate']) && !empty($thisfile_audio['bitrate']) && !empty($info['bitrate'])) {
+                                                                        //$thisfile_video['bitrate'] = $thisfile_asf['file_properties_object']['max_bitrate'] - $thisfile_audio['bitrate'];
+                                                                        $thisfile_video['bitrate'] = $info['bitrate'] - $thisfile_audio['bitrate'];
+                                                                }
+
+                                                                $AudioCodecFrequency = (int) trim(str_replace('kHz', '', $AudioCodecFrequency));
+                                                                switch ($AudioCodecFrequency) {
+                                                                        case 8:
+                                                                        case 8000:
+                                                                                $thisfile_audio['sample_rate'] = 8000;
+                                                                                break;
+
+                                                                        case 11:
+                                                                        case 11025:
+                                                                                $thisfile_audio['sample_rate'] = 11025;
+                                                                                break;
+
+                                                                        case 12:
+                                                                        case 12000:
+                                                                                $thisfile_audio['sample_rate'] = 12000;
+                                                                                break;
+
+                                                                        case 16:
+                                                                        case 16000:
+                                                                                $thisfile_audio['sample_rate'] = 16000;
+                                                                                break;
+
+                                                                        case 22:
+                                                                        case 22050:
+                                                                                $thisfile_audio['sample_rate'] = 22050;
+                                                                                break;
+
+                                                                        case 24:
+                                                                        case 24000:
+                                                                                $thisfile_audio['sample_rate'] = 24000;
+                                                                                break;
+
+                                                                        case 32:
+                                                                        case 32000:
+                                                                                $thisfile_audio['sample_rate'] = 32000;
+                                                                                break;
+
+                                                                        case 44:
+                                                                        case 441000:
+                                                                                $thisfile_audio['sample_rate'] = 44100;
+                                                                                break;
+
+                                                                        case 48:
+                                                                        case 48000:
+                                                                                $thisfile_audio['sample_rate'] = 48000;
+                                                                                break;
+
+                                                                        default:
+                                                                                $info['warning'][] = 'unknown frequency: "'.$AudioCodecFrequency.'" ('.$this->TrimConvert($thisfile_asf_codeclistobject_codecentries_current['description']).')';
+                                                                                break;
+                                                                }
+
+                                                                if (!isset($thisfile_audio['channels'])) {
+                                                                        if (strstr($AudioCodecChannels, 'stereo')) {
+                                                                                $thisfile_audio['channels'] = 2;
+                                                                        } elseif (strstr($AudioCodecChannels, 'mono')) {
+                                                                                $thisfile_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
+                                        $thisfile_asf['script_command_object'] = array();
+                                        $thisfile_asf_scriptcommandobject      = &$thisfile_asf['script_command_object'];
+
+                                        $thisfile_asf_scriptcommandobject['offset']               = $NextObjectOffset + $offset;
+                                        $thisfile_asf_scriptcommandobject['objectid']             = $NextObjectGUID;
+                                        $thisfile_asf_scriptcommandobject['objectid_guid']        = $NextObjectGUIDtext;
+                                        $thisfile_asf_scriptcommandobject['objectsize']           = $NextObjectSize;
+                                        $thisfile_asf_scriptcommandobject['reserved']             = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_scriptcommandobject['reserved_guid']        = $this->BytestringToGUID($thisfile_asf_scriptcommandobject['reserved']);
+                                        if ($thisfile_asf_scriptcommandobject['reserved'] != $this->GUIDtoBytestring('4B1ACBE3-100B-11D0-A39B-00A0C90348F6')) {
+                                                $info['warning'][] = 'script_command_object.reserved GUID {'.$this->BytestringToGUID($thisfile_asf_scriptcommandobject['reserved']).'} does not match expected "GETID3_ASF_Reserved_1" GUID {4B1ACBE3-100B-11D0-A39B-00A0C90348F6}';
+                                                //return false;
+                                                break;
+                                        }
+                                        $thisfile_asf_scriptcommandobject['commands_count']       = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_scriptcommandobject['command_types_count']  = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        for ($CommandTypesCounter = 0; $CommandTypesCounter < $thisfile_asf_scriptcommandobject['command_types_count']; $CommandTypesCounter++) {
+                                                $CommandTypeNameLength = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2)) * 2; // 2 bytes per character
+                                                $offset += 2;
+                                                $thisfile_asf_scriptcommandobject['command_types'][$CommandTypesCounter]['name'] = substr($ASFHeaderData, $offset, $CommandTypeNameLength);
+                                                $offset += $CommandTypeNameLength;
+                                        }
+                                        for ($CommandsCounter = 0; $CommandsCounter < $thisfile_asf_scriptcommandobject['commands_count']; $CommandsCounter++) {
+                                                $thisfile_asf_scriptcommandobject['commands'][$CommandsCounter]['presentation_time']  = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                                $offset += 4;
+                                                $thisfile_asf_scriptcommandobject['commands'][$CommandsCounter]['type_index']         = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+
+                                                $CommandTypeNameLength = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2)) * 2; // 2 bytes per character
+                                                $offset += 2;
+                                                $thisfile_asf_scriptcommandobject['commands'][$CommandsCounter]['name'] = substr($ASFHeaderData, $offset, $CommandTypeNameLength);
+                                                $offset += $CommandTypeNameLength;
+                                        }
+                                        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
+
+                                        // shortcut
+                                        $thisfile_asf['marker_object'] = array();
+                                        $thisfile_asf_markerobject     = &$thisfile_asf['marker_object'];
+
+                                        $thisfile_asf_markerobject['offset']               = $NextObjectOffset + $offset;
+                                        $thisfile_asf_markerobject['objectid']             = $NextObjectGUID;
+                                        $thisfile_asf_markerobject['objectid_guid']        = $NextObjectGUIDtext;
+                                        $thisfile_asf_markerobject['objectsize']           = $NextObjectSize;
+                                        $thisfile_asf_markerobject['reserved']             = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_markerobject['reserved_guid']        = $this->BytestringToGUID($thisfile_asf_markerobject['reserved']);
+                                        if ($thisfile_asf_markerobject['reserved'] != $this->GUIDtoBytestring('4CFEDB20-75F6-11CF-9C0F-00A0C90349CB')) {
+                                                $info['warning'][] = 'marker_object.reserved GUID {'.$this->BytestringToGUID($thisfile_asf_markerobject['reserved_1']).'} does not match expected "GETID3_ASF_Reserved_1" GUID {4CFEDB20-75F6-11CF-9C0F-00A0C90349CB}';
+                                                break;
+                                        }
+                                        $thisfile_asf_markerobject['markers_count'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        $thisfile_asf_markerobject['reserved_2'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        if ($thisfile_asf_markerobject['reserved_2'] != 0) {
+                                                $info['warning'][] = 'marker_object.reserved_2 ('.getid3_lib::PrintHexBytes($thisfile_asf_markerobject['reserved_2']).') does not match expected value of "0"';
+                                                break;
+                                        }
+                                        $thisfile_asf_markerobject['name_length'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_markerobject['name'] = substr($ASFHeaderData, $offset, $thisfile_asf_markerobject['name_length']);
+                                        $offset += $thisfile_asf_markerobject['name_length'];
+                                        for ($MarkersCounter = 0; $MarkersCounter < $thisfile_asf_markerobject['markers_count']; $MarkersCounter++) {
+                                                $thisfile_asf_markerobject['markers'][$MarkersCounter]['offset']  = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                                $offset += 8;
+                                                $thisfile_asf_markerobject['markers'][$MarkersCounter]['presentation_time']         = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 8));
+                                                $offset += 8;
+                                                $thisfile_asf_markerobject['markers'][$MarkersCounter]['entry_length']              = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_markerobject['markers'][$MarkersCounter]['send_time']                 = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                                $offset += 4;
+                                                $thisfile_asf_markerobject['markers'][$MarkersCounter]['flags']                     = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                                $offset += 4;
+                                                $thisfile_asf_markerobject['markers'][$MarkersCounter]['marker_description_length'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                                $offset += 4;
+                                                $thisfile_asf_markerobject['markers'][$MarkersCounter]['marker_description']        = substr($ASFHeaderData, $offset, $thisfile_asf_markerobject['markers'][$MarkersCounter]['marker_description_length']);
+                                                $offset += $thisfile_asf_markerobject['markers'][$MarkersCounter]['marker_description_length'];
+                                                $PaddingLength = $thisfile_asf_markerobject['markers'][$MarkersCounter]['entry_length'] - 4 -  4 - 4 - $thisfile_asf_markerobject['markers'][$MarkersCounter]['marker_description_length'];
+                                                if ($PaddingLength > 0) {
+                                                        $thisfile_asf_markerobject['markers'][$MarkersCounter]['padding']               = substr($ASFHeaderData, $offset, $PaddingLength);
+                                                        $offset += $PaddingLength;
+                                                }
+                                        }
+                                        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
+                                        $thisfile_asf['bitrate_mutual_exclusion_object'] = array();
+                                        $thisfile_asf_bitratemutualexclusionobject       = &$thisfile_asf['bitrate_mutual_exclusion_object'];
+
+                                        $thisfile_asf_bitratemutualexclusionobject['offset']               = $NextObjectOffset + $offset;
+                                        $thisfile_asf_bitratemutualexclusionobject['objectid']             = $NextObjectGUID;
+                                        $thisfile_asf_bitratemutualexclusionobject['objectid_guid']        = $NextObjectGUIDtext;
+                                        $thisfile_asf_bitratemutualexclusionobject['objectsize']           = $NextObjectSize;
+                                        $thisfile_asf_bitratemutualexclusionobject['reserved']             = substr($ASFHeaderData, $offset, 16);
+                                        $thisfile_asf_bitratemutualexclusionobject['reserved_guid']        = $this->BytestringToGUID($thisfile_asf_bitratemutualexclusionobject['reserved']);
+                                        $offset += 16;
+                                        if (($thisfile_asf_bitratemutualexclusionobject['reserved'] != GETID3_ASF_Mutex_Bitrate) && ($thisfile_asf_bitratemutualexclusionobject['reserved'] != GETID3_ASF_Mutex_Unknown)) {
+                                                $info['warning'][] = 'bitrate_mutual_exclusion_object.reserved GUID {'.$this->BytestringToGUID($thisfile_asf_bitratemutualexclusionobject['reserved']).'} does not match expected "GETID3_ASF_Mutex_Bitrate" GUID {'.$this->BytestringToGUID(GETID3_ASF_Mutex_Bitrate).'} or  "GETID3_ASF_Mutex_Unknown" GUID {'.$this->BytestringToGUID(GETID3_ASF_Mutex_Unknown).'}';
+                                                //return false;
+                                                break;
+                                        }
+                                        $thisfile_asf_bitratemutualexclusionobject['stream_numbers_count'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        for ($StreamNumberCounter = 0; $StreamNumberCounter < $thisfile_asf_bitratemutualexclusionobject['stream_numbers_count']; $StreamNumberCounter++) {
+                                                $thisfile_asf_bitratemutualexclusionobject['stream_numbers'][$StreamNumberCounter] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $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
+
+                                        // shortcut
+                                        $thisfile_asf['error_correction_object'] = array();
+                                        $thisfile_asf_errorcorrectionobject      = &$thisfile_asf['error_correction_object'];
+
+                                        $thisfile_asf_errorcorrectionobject['offset']                = $NextObjectOffset + $offset;
+                                        $thisfile_asf_errorcorrectionobject['objectid']              = $NextObjectGUID;
+                                        $thisfile_asf_errorcorrectionobject['objectid_guid']         = $NextObjectGUIDtext;
+                                        $thisfile_asf_errorcorrectionobject['objectsize']            = $NextObjectSize;
+                                        $thisfile_asf_errorcorrectionobject['error_correction_type'] = substr($ASFHeaderData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_errorcorrectionobject['error_correction_guid'] = $this->BytestringToGUID($thisfile_asf_errorcorrectionobject['error_correction_type']);
+                                        $thisfile_asf_errorcorrectionobject['error_correction_data_length'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 4));
+                                        $offset += 4;
+                                        switch ($thisfile_asf_errorcorrectionobject['error_correction_type']) {
+                                                case GETID3_ASF_No_Error_Correction:
+                                                        // should be no data, but just in case there is, skip to the end of the field
+                                                        $offset += $thisfile_asf_errorcorrectionobject['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
+
+                                                        $thisfile_asf_errorcorrectionobject['span']                  = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 1));
+                                                        $offset += 1;
+                                                        $thisfile_asf_errorcorrectionobject['virtual_packet_length'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                        $offset += 2;
+                                                        $thisfile_asf_errorcorrectionobject['virtual_chunk_length']  = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                        $offset += 2;
+                                                        $thisfile_asf_errorcorrectionobject['silence_data_length']   = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                        $offset += 2;
+                                                        $thisfile_asf_errorcorrectionobject['silence_data']          = substr($ASFHeaderData, $offset, $thisfile_asf_errorcorrectionobject['silence_data_length']);
+                                                        $offset += $thisfile_asf_errorcorrectionobject['silence_data_length'];
+                                                        break;
+
+                                                default:
+                                                        $info['warning'][] = 'error_correction_object.error_correction_type GUID {'.$this->BytestringToGUID($thisfile_asf_errorcorrectionobject['reserved']).'} does not match expected "GETID3_ASF_No_Error_Correction" GUID {'.$this->BytestringToGUID(GETID3_ASF_No_Error_Correction).'} or  "GETID3_ASF_Audio_Spread" GUID {'.$this->BytestringToGUID(GETID3_ASF_Audio_Spread).'}';
+                                                        //return false;
+                                                        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
+
+                                        // shortcut
+                                        $thisfile_asf['content_description_object'] = array();
+                                        $thisfile_asf_contentdescriptionobject      = &$thisfile_asf['content_description_object'];
+
+                                        $thisfile_asf_contentdescriptionobject['offset']                = $NextObjectOffset + $offset;
+                                        $thisfile_asf_contentdescriptionobject['objectid']              = $NextObjectGUID;
+                                        $thisfile_asf_contentdescriptionobject['objectid_guid']         = $NextObjectGUIDtext;
+                                        $thisfile_asf_contentdescriptionobject['objectsize']            = $NextObjectSize;
+                                        $thisfile_asf_contentdescriptionobject['title_length']          = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_contentdescriptionobject['author_length']         = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_contentdescriptionobject['copyright_length']      = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_contentdescriptionobject['description_length']    = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_contentdescriptionobject['rating_length']         = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_contentdescriptionobject['title']                 = substr($ASFHeaderData, $offset, $thisfile_asf_contentdescriptionobject['title_length']);
+                                        $offset += $thisfile_asf_contentdescriptionobject['title_length'];
+                                        $thisfile_asf_contentdescriptionobject['author']                = substr($ASFHeaderData, $offset, $thisfile_asf_contentdescriptionobject['author_length']);
+                                        $offset += $thisfile_asf_contentdescriptionobject['author_length'];
+                                        $thisfile_asf_contentdescriptionobject['copyright']             = substr($ASFHeaderData, $offset, $thisfile_asf_contentdescriptionobject['copyright_length']);
+                                        $offset += $thisfile_asf_contentdescriptionobject['copyright_length'];
+                                        $thisfile_asf_contentdescriptionobject['description']           = substr($ASFHeaderData, $offset, $thisfile_asf_contentdescriptionobject['description_length']);
+                                        $offset += $thisfile_asf_contentdescriptionobject['description_length'];
+                                        $thisfile_asf_contentdescriptionobject['rating']                = substr($ASFHeaderData, $offset, $thisfile_asf_contentdescriptionobject['rating_length']);
+                                        $offset += $thisfile_asf_contentdescriptionobject['rating_length'];
+
+                                        $ASFcommentKeysToCopy = array('title'=>'title', 'author'=>'artist', 'copyright'=>'copyright', 'description'=>'comment', 'rating'=>'rating');
+                                        foreach ($ASFcommentKeysToCopy as $keytocopyfrom => $keytocopyto) {
+                                                if (!empty($thisfile_asf_contentdescriptionobject[$keytocopyfrom])) {
+                                                        $thisfile_asf_comments[$keytocopyto][] = $this->TrimTerm($thisfile_asf_contentdescriptionobject[$keytocopyfrom]);
+                                                }
+                                        }
+                                        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
+
+                                        // shortcut
+                                        $thisfile_asf['extended_content_description_object'] = array();
+                                        $thisfile_asf_extendedcontentdescriptionobject       = &$thisfile_asf['extended_content_description_object'];
+
+                                        $thisfile_asf_extendedcontentdescriptionobject['offset']                    = $NextObjectOffset + $offset;
+                                        $thisfile_asf_extendedcontentdescriptionobject['objectid']                  = $NextObjectGUID;
+                                        $thisfile_asf_extendedcontentdescriptionobject['objectid_guid']             = $NextObjectGUIDtext;
+                                        $thisfile_asf_extendedcontentdescriptionobject['objectsize']                = $NextObjectSize;
+                                        $thisfile_asf_extendedcontentdescriptionobject['content_descriptors_count'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        for ($ExtendedContentDescriptorsCounter = 0; $ExtendedContentDescriptorsCounter < $thisfile_asf_extendedcontentdescriptionobject['content_descriptors_count']; $ExtendedContentDescriptorsCounter++) {
+                                                // shortcut
+                                                $thisfile_asf_extendedcontentdescriptionobject['content_descriptors'][$ExtendedContentDescriptorsCounter] = array();
+                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current                 = &$thisfile_asf_extendedcontentdescriptionobject['content_descriptors'][$ExtendedContentDescriptorsCounter];
+
+                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['base_offset']  = $offset + 30;
+                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['name_length']  = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['name']         = substr($ASFHeaderData, $offset, $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['name_length']);
+                                                $offset += $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['name_length'];
+                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value_type']   = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value_length'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']        = substr($ASFHeaderData, $offset, $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value_length']);
+                                                $offset += $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value_length'];
+                                                switch ($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value_type']) {
+                                                        case 0x0000: // Unicode string
+                                                                break;
+
+                                                        case 0x0001: // BYTE array
+                                                                // do nothing
+                                                                break;
+
+                                                        case 0x0002: // BOOL
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value'] = (bool) getid3_lib::LittleEndian2Int($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']);
+                                                                break;
+
+                                                        case 0x0003: // DWORD
+                                                        case 0x0004: // QWORD
+                                                        case 0x0005: // WORD
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value'] = getid3_lib::LittleEndian2Int($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']);
+                                                                break;
+
+                                                        default:
+                                                                $info['warning'][] = 'extended_content_description.content_descriptors.'.$ExtendedContentDescriptorsCounter.'.value_type is invalid ('.$thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value_type'].')';
+                                                                //return false;
+                                                                break;
+                                                }
+                                                switch ($this->TrimConvert(strtolower($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['name']))) {
+
+                                                        case 'wm/albumartist':
+                                                        case 'artist':
+                                                                // Note: not 'artist', that comes from 'author' tag
+                                                                $thisfile_asf_comments['albumartist'] = array($this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                break;
+
+                                                        case 'wm/albumtitle':
+                                                        case 'album':
+                                                                $thisfile_asf_comments['album']  = array($this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                break;
+
+                                                        case 'wm/genre':
+                                                        case 'genre':
+                                                                $thisfile_asf_comments['genre'] = array($this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                break;
+
+                                                        case 'wm/partofset':
+                                                                $thisfile_asf_comments['partofset'] = array($this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                break;
+
+                                                        case 'wm/tracknumber':
+                                                        case 'tracknumber':
+                                                                // be careful casting to int: casting unicode strings to int gives unexpected results (stops parsing at first non-numeric character)
+                                                                $thisfile_asf_comments['track'] = array($this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                foreach ($thisfile_asf_comments['track'] as $key => $value) {
+                                                                        if (preg_match('/^[0-9\x00]+$/', $value)) {
+                                                                                $thisfile_asf_comments['track'][$key] = intval(str_replace("\x00", '', $value));
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                        case 'wm/track':
+                                                                if (empty($thisfile_asf_comments['track'])) {
+                                                                        $thisfile_asf_comments['track'] = array(1 + $this->TrimConvert($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                }
+                                                                break;
+
+                                                        case 'wm/year':
+                                                        case 'year':
+                                                        case 'date':
+                                                                $thisfile_asf_comments['year'] = array( $this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                break;
+
+                                                        case 'wm/lyrics':
+                                                        case 'lyrics':
+                                                                $thisfile_asf_comments['lyrics'] = array($this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']));
+                                                                break;
+
+                                                        case 'isvbr':
+                                                                if ($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']) {
+                                                                        $thisfile_audio['bitrate_mode'] = 'vbr';
+                                                                        $thisfile_video['bitrate_mode'] = 'vbr';
+                                                                }
+                                                                break;
+
+                                                        case 'id3':
+                                                                // id3v2 module might not be loaded
+                                                                if (class_exists('getid3_id3v2')) {
+                                                                        $tempfile         = tempnam(GETID3_TEMP_DIR, 'getID3');
+                                                                        $tempfilehandle   = fopen($tempfile, 'wb');
+                                                                        $tempThisfileInfo = array('encoding'=>$info['encoding']);
+                                                                        fwrite($tempfilehandle, $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']);
+                                                                        fclose($tempfilehandle);
+
+                                                                        $getid3_temp = new getID3();
+                                                                        $getid3_temp->openfile($tempfile);
+                                                                        $getid3_id3v2 = new getid3_id3v2($getid3_temp);
+                                                                        $getid3_id3v2->Analyze();
+                                                                        $info['id3v2'] = $getid3_temp->info['id3v2'];
+                                                                        unset($getid3_temp, $getid3_id3v2);
+
+                                                                        unlink($tempfile);
+                                                                }
+                                                                break;
+
+                                                        case 'wm/encodingtime':
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['encoding_time_unix'] = $this->FILETIMEtoUNIXtime($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']);
+                                                                $thisfile_asf_comments['encoding_time_unix'] = array($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['encoding_time_unix']);
+                                                                break;
+
+                                                        case 'wm/picture':
+                                                                $WMpicture = $this->ASF_WMpicture($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']);
+                                                                foreach ($WMpicture as $key => $value) {
+                                                                        $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current[$key] = $value;
+                                                                }
+                                                                unset($WMpicture);
+/*
+                                                                $wm_picture_offset = 0;
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_type_id'] = getid3_lib::LittleEndian2Int(substr($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value'], $wm_picture_offset, 1));
+                                                                $wm_picture_offset += 1;
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_type']    = $this->WMpictureTypeLookup($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_type_id']);
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_size']    = getid3_lib::LittleEndian2Int(substr($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value'], $wm_picture_offset, 4));
+                                                                $wm_picture_offset += 4;
+
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_mime'] = '';
+                                                                do {
+                                                                        $next_byte_pair = substr($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value'], $wm_picture_offset, 2);
+                                                                        $wm_picture_offset += 2;
+                                                                        $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_mime'] .= $next_byte_pair;
+                                                                } while ($next_byte_pair !== "\x00\x00");
+
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_description'] = '';
+                                                                do {
+                                                                        $next_byte_pair = substr($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value'], $wm_picture_offset, 2);
+                                                                        $wm_picture_offset += 2;
+                                                                        $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_description'] .= $next_byte_pair;
+                                                                } while ($next_byte_pair !== "\x00\x00");
+
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['dataoffset'] = $wm_picture_offset;
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['data'] = substr($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value'], $wm_picture_offset);
+                                                                unset($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value']);
+
+                                                                $imageinfo = array();
+                                                                $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_mime'] = '';
+                                                                $imagechunkcheck = getid3_lib::GetDataImageSize($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['data'], $imageinfo);
+                                                                unset($imageinfo);
+                                                                if (!empty($imagechunkcheck)) {
+                                                                        $thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_mime'] = image_type_to_mime_type($imagechunkcheck[2]);
+                                                                }
+                                                                if (!isset($thisfile_asf_comments['picture'])) {
+                                                                        $thisfile_asf_comments['picture'] = array();
+                                                                }
+                                                                $thisfile_asf_comments['picture'][] = array('data'=>$thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['data'], 'image_mime'=>$thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['image_mime']);
+*/
+                                                                break;
+
+                                                        default:
+                                                                switch ($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['value_type']) {
+                                                                        case 0: // Unicode string
+                                                                                if (substr($this->TrimConvert($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['name']), 0, 3) == 'WM/') {
+                                                                                        $thisfile_asf_comments[str_replace('wm/', '', strtolower($this->TrimConvert($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_current['name'])))] = array($this->TrimTerm($thisfile_asf_extendedcontentdescriptionobject_contentdescriptor_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
+                                        $thisfile_asf['stream_bitrate_properties_object'] = array();
+                                        $thisfile_asf_streambitratepropertiesobject       = &$thisfile_asf['stream_bitrate_properties_object'];
+
+                                        $thisfile_asf_streambitratepropertiesobject['offset']                    = $NextObjectOffset + $offset;
+                                        $thisfile_asf_streambitratepropertiesobject['objectid']                  = $NextObjectGUID;
+                                        $thisfile_asf_streambitratepropertiesobject['objectid_guid']             = $NextObjectGUIDtext;
+                                        $thisfile_asf_streambitratepropertiesobject['objectsize']                = $NextObjectSize;
+                                        $thisfile_asf_streambitratepropertiesobject['bitrate_records_count']     = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                        $offset += 2;
+                                        for ($BitrateRecordsCounter = 0; $BitrateRecordsCounter < $thisfile_asf_streambitratepropertiesobject['bitrate_records_count']; $BitrateRecordsCounter++) {
+                                                $thisfile_asf_streambitratepropertiesobject['bitrate_records'][$BitrateRecordsCounter]['flags_raw'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_streambitratepropertiesobject['bitrate_records'][$BitrateRecordsCounter]['flags']['stream_number'] = $thisfile_asf_streambitratepropertiesobject['bitrate_records'][$BitrateRecordsCounter]['flags_raw'] & 0x007F;
+                                                $thisfile_asf_streambitratepropertiesobject['bitrate_records'][$BitrateRecordsCounter]['bitrate'] = getid3_lib::LittleEndian2Int(substr($ASFHeaderData, $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
+                                        $thisfile_asf['padding_object'] = array();
+                                        $thisfile_asf_paddingobject     = &$thisfile_asf['padding_object'];
+
+                                        $thisfile_asf_paddingobject['offset']                    = $NextObjectOffset + $offset;
+                                        $thisfile_asf_paddingobject['objectid']                  = $NextObjectGUID;
+                                        $thisfile_asf_paddingobject['objectid_guid']             = $NextObjectGUIDtext;
+                                        $thisfile_asf_paddingobject['objectsize']                = $NextObjectSize;
+                                        $thisfile_asf_paddingobject['padding_length']            = $thisfile_asf_paddingobject['objectsize'] - 16 - 8;
+                                        $thisfile_asf_paddingobject['padding']                   = substr($ASFHeaderData, $offset, $thisfile_asf_paddingobject['padding_length']);
+                                        $offset += ($NextObjectSize - 16 - 8);
+                                        break;
+
+                                case GETID3_ASF_Extended_Content_Encryption_Object:
+                                case GETID3_ASF_Content_Encryption_Object:
+                                        // WMA DRM - just ignore
+                                        $offset += ($NextObjectSize - 16 - 8);
+                                        break;
+
+                                default:
+                                        // Implementations shall ignore any standard or non-standard object that they do not know how to handle.
+                                        if ($this->GUIDname($NextObjectGUIDtext)) {
+                                                $info['warning'][] = 'unhandled GUID "'.$this->GUIDname($NextObjectGUIDtext).'" {'.$NextObjectGUIDtext.'} in ASF header at offset '.($offset - 16 - 8);
+                                        } else {
+                                                $info['warning'][] = 'unknown GUID {'.$NextObjectGUIDtext.'} in ASF header at offset '.($offset - 16 - 8);
+                                        }
+                                        $offset += ($NextObjectSize - 16 - 8);
+                                        break;
+                        }
+                }
+                if (isset($thisfile_asf_streambitrateproperties['bitrate_records_count'])) {
+                        $ASFbitrateAudio = 0;
+                        $ASFbitrateVideo = 0;
+                        for ($BitrateRecordsCounter = 0; $BitrateRecordsCounter < $thisfile_asf_streambitrateproperties['bitrate_records_count']; $BitrateRecordsCounter++) {
+                                if (isset($thisfile_asf_codeclistobject['codec_entries'][$BitrateRecordsCounter])) {
+                                        switch ($thisfile_asf_codeclistobject['codec_entries'][$BitrateRecordsCounter]['type_raw']) {
+                                                case 1:
+                                                        $ASFbitrateVideo += $thisfile_asf_streambitrateproperties['bitrate_records'][$BitrateRecordsCounter]['bitrate'];
+                                                        break;
+
+                                                case 2:
+                                                        $ASFbitrateAudio += $thisfile_asf_streambitrateproperties['bitrate_records'][$BitrateRecordsCounter]['bitrate'];
+                                                        break;
+
+                                                default:
+                                                        // do nothing
+                                                        break;
+                                        }
+                                }
+                        }
+                        if ($ASFbitrateAudio > 0) {
+                                $thisfile_audio['bitrate'] = $ASFbitrateAudio;
+                        }
+                        if ($ASFbitrateVideo > 0) {
+                                $thisfile_video['bitrate'] = $ASFbitrateVideo;
+                        }
+                }
+                if (isset($thisfile_asf['stream_properties_object']) && is_array($thisfile_asf['stream_properties_object'])) {
+
+                        $thisfile_audio['bitrate'] = 0;
+                        $thisfile_video['bitrate'] = 0;
+
+                        foreach ($thisfile_asf['stream_properties_object'] as $streamnumber => $streamdata) {
+
+                                switch ($streamdata['stream_type']) {
+                                        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
+                                                $thisfile_asf['audio_media'][$streamnumber] = array();
+                                                $thisfile_asf_audiomedia_currentstream      = &$thisfile_asf['audio_media'][$streamnumber];
+
+                                                $audiomediaoffset = 0;
+
+                                                $thisfile_asf_audiomedia_currentstream = getid3_riff::parseWAVEFORMATex(substr($streamdata['type_specific_data'], $audiomediaoffset, 16));
+                                                $audiomediaoffset += 16;
+
+                                                $thisfile_audio['lossless'] = false;
+                                                switch ($thisfile_asf_audiomedia_currentstream['raw']['wFormatTag']) {
+                                                        case 0x0001: // PCM
+                                                        case 0x0163: // WMA9 Lossless
+                                                                $thisfile_audio['lossless'] = true;
+                                                                break;
+                                                }
+
+                                                if (!empty($thisfile_asf['stream_bitrate_properties_object']['bitrate_records'])) {
+                                                        foreach ($thisfile_asf['stream_bitrate_properties_object']['bitrate_records'] as $dummy => $dataarray) {
+                                                                if (isset($dataarray['flags']['stream_number']) && ($dataarray['flags']['stream_number'] == $streamnumber)) {
+                                                                        $thisfile_asf_audiomedia_currentstream['bitrate'] = $dataarray['bitrate'];
+                                                                        $thisfile_audio['bitrate'] += $dataarray['bitrate'];
+                                                                        break;
+                                                                }
+                                                        }
+                                                } else {
+                                                        if (!empty($thisfile_asf_audiomedia_currentstream['bytes_sec'])) {
+                                                                $thisfile_audio['bitrate'] += $thisfile_asf_audiomedia_currentstream['bytes_sec'] * 8;
+                                                        } elseif (!empty($thisfile_asf_audiomedia_currentstream['bitrate'])) {
+                                                                $thisfile_audio['bitrate'] += $thisfile_asf_audiomedia_currentstream['bitrate'];
+                                                        }
+                                                }
+                                                $thisfile_audio['streams'][$streamnumber]                = $thisfile_asf_audiomedia_currentstream;
+                                                $thisfile_audio['streams'][$streamnumber]['wformattag']  = $thisfile_asf_audiomedia_currentstream['raw']['wFormatTag'];
+                                                $thisfile_audio['streams'][$streamnumber]['lossless']    = $thisfile_audio['lossless'];
+                                                $thisfile_audio['streams'][$streamnumber]['bitrate']     = $thisfile_audio['bitrate'];
+                                                $thisfile_audio['streams'][$streamnumber]['dataformat']  = 'wma';
+                                                unset($thisfile_audio['streams'][$streamnumber]['raw']);
+
+                                                $thisfile_asf_audiomedia_currentstream['codec_data_size'] = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $audiomediaoffset, 2));
+                                                $audiomediaoffset += 2;
+                                                $thisfile_asf_audiomedia_currentstream['codec_data']      = substr($streamdata['type_specific_data'], $audiomediaoffset, $thisfile_asf_audiomedia_currentstream['codec_data_size']);
+                                                $audiomediaoffset += $thisfile_asf_audiomedia_currentstream['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
+
+                                                // shortcut
+                                                $thisfile_asf['video_media'][$streamnumber] = array();
+                                                $thisfile_asf_videomedia_currentstream      = &$thisfile_asf['video_media'][$streamnumber];
+
+                                                $videomediaoffset = 0;
+                                                $thisfile_asf_videomedia_currentstream['image_width']                     = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['image_height']                    = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['flags']                           = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 1));
+                                                $videomediaoffset += 1;
+                                                $thisfile_asf_videomedia_currentstream['format_data_size']                = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 2));
+                                                $videomediaoffset += 2;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['format_data_size'] = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['image_width']      = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['image_height']     = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['reserved']         = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 2));
+                                                $videomediaoffset += 2;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['bits_per_pixel']   = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 2));
+                                                $videomediaoffset += 2;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['codec_fourcc']     = substr($streamdata['type_specific_data'], $videomediaoffset, 4);
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['image_size']       = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['horizontal_pels']  = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['vertical_pels']    = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['colors_used']      = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['colors_important'] = getid3_lib::LittleEndian2Int(substr($streamdata['type_specific_data'], $videomediaoffset, 4));
+                                                $videomediaoffset += 4;
+                                                $thisfile_asf_videomedia_currentstream['format_data']['codec_data']       = substr($streamdata['type_specific_data'], $videomediaoffset);
+
+                                                if (!empty($thisfile_asf['stream_bitrate_properties_object']['bitrate_records'])) {
+                                                        foreach ($thisfile_asf['stream_bitrate_properties_object']['bitrate_records'] as $dummy => $dataarray) {
+                                                                if (isset($dataarray['flags']['stream_number']) && ($dataarray['flags']['stream_number'] == $streamnumber)) {
+                                                                        $thisfile_asf_videomedia_currentstream['bitrate'] = $dataarray['bitrate'];
+                                                                        $thisfile_video['streams'][$streamnumber]['bitrate'] = $dataarray['bitrate'];
+                                                                        $thisfile_video['bitrate'] += $dataarray['bitrate'];
+                                                                        break;
+                                                                }
+                                                        }
+                                                }
+
+                                                $thisfile_asf_videomedia_currentstream['format_data']['codec'] = getid3_riff::fourccLookup($thisfile_asf_videomedia_currentstream['format_data']['codec_fourcc']);
+
+                                                $thisfile_video['streams'][$streamnumber]['fourcc']          = $thisfile_asf_videomedia_currentstream['format_data']['codec_fourcc'];
+                                                $thisfile_video['streams'][$streamnumber]['codec']           = $thisfile_asf_videomedia_currentstream['format_data']['codec'];
+                                                $thisfile_video['streams'][$streamnumber]['resolution_x']    = $thisfile_asf_videomedia_currentstream['image_width'];
+                                                $thisfile_video['streams'][$streamnumber]['resolution_y']    = $thisfile_asf_videomedia_currentstream['image_height'];
+                                                $thisfile_video['streams'][$streamnumber]['bits_per_sample'] = $thisfile_asf_videomedia_currentstream['format_data']['bits_per_pixel'];
+                                                break;
+
+                                        default:
+                                                break;
+                                }
+                        }
+                }
+
+                while (ftell($this->getid3->fp) < $info['avdataend']) {
+                        $NextObjectDataHeader = fread($this->getid3->fp, 24);
+                        $offset = 0;
+                        $NextObjectGUID = substr($NextObjectDataHeader, 0, 16);
+                        $offset += 16;
+                        $NextObjectGUIDtext = $this->BytestringToGUID($NextObjectGUID);
+                        $NextObjectSize = getid3_lib::LittleEndian2Int(substr($NextObjectDataHeader, $offset, 8));
+                        $offset += 8;
+
+                        switch ($NextObjectGUID) {
+                                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
+                                        $thisfile_asf['data_object'] = array();
+                                        $thisfile_asf_dataobject     = &$thisfile_asf['data_object'];
+
+                                        $DataObjectData = $NextObjectDataHeader.fread($this->getid3->fp, 50 - 24);
+                                        $offset = 24;
+
+                                        $thisfile_asf_dataobject['objectid']           = $NextObjectGUID;
+                                        $thisfile_asf_dataobject['objectid_guid']      = $NextObjectGUIDtext;
+                                        $thisfile_asf_dataobject['objectsize']         = $NextObjectSize;
+
+                                        $thisfile_asf_dataobject['fileid']             = substr($DataObjectData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_dataobject['fileid_guid']        = $this->BytestringToGUID($thisfile_asf_dataobject['fileid']);
+                                        $thisfile_asf_dataobject['total_data_packets'] = getid3_lib::LittleEndian2Int(substr($DataObjectData, $offset, 8));
+                                        $offset += 8;
+                                        $thisfile_asf_dataobject['reserved']           = getid3_lib::LittleEndian2Int(substr($DataObjectData, $offset, 2));
+                                        $offset += 2;
+                                        if ($thisfile_asf_dataobject['reserved'] != 0x0101) {
+                                                $info['warning'][] = 'data_object.reserved ('.getid3_lib::PrintHexBytes($thisfile_asf_dataobject['reserved']).') does not match expected value of "0x0101"';
+                                                //return false;
+                                                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
+
+                                        $info['avdataoffset'] = ftell($this->getid3->fp);
+                                        fseek($this->getid3->fp, ($thisfile_asf_dataobject['objectsize'] - 50), SEEK_CUR); // skip actual audio/video data
+                                        $info['avdataend'] = ftell($this->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
+                                        $thisfile_asf['simple_index_object'] = array();
+                                        $thisfile_asf_simpleindexobject      = &$thisfile_asf['simple_index_object'];
+
+                                        $SimpleIndexObjectData = $NextObjectDataHeader.fread($this->getid3->fp, 56 - 24);
+                                        $offset = 24;
+
+                                        $thisfile_asf_simpleindexobject['objectid']                  = $NextObjectGUID;
+                                        $thisfile_asf_simpleindexobject['objectid_guid']             = $NextObjectGUIDtext;
+                                        $thisfile_asf_simpleindexobject['objectsize']                = $NextObjectSize;
+
+                                        $thisfile_asf_simpleindexobject['fileid']                    =                  substr($SimpleIndexObjectData, $offset, 16);
+                                        $offset += 16;
+                                        $thisfile_asf_simpleindexobject['fileid_guid']               = $this->BytestringToGUID($thisfile_asf_simpleindexobject['fileid']);
+                                        $thisfile_asf_simpleindexobject['index_entry_time_interval'] = getid3_lib::LittleEndian2Int(substr($SimpleIndexObjectData, $offset, 8));
+                                        $offset += 8;
+                                        $thisfile_asf_simpleindexobject['maximum_packet_count']      = getid3_lib::LittleEndian2Int(substr($SimpleIndexObjectData, $offset, 4));
+                                        $offset += 4;
+                                        $thisfile_asf_simpleindexobject['index_entries_count']       = getid3_lib::LittleEndian2Int(substr($SimpleIndexObjectData, $offset, 4));
+                                        $offset += 4;
+
+                                        $IndexEntriesData = $SimpleIndexObjectData.fread($this->getid3->fp, 6 * $thisfile_asf_simpleindexobject['index_entries_count']);
+                                        for ($IndexEntriesCounter = 0; $IndexEntriesCounter < $thisfile_asf_simpleindexobject['index_entries_count']; $IndexEntriesCounter++) {
+                                                $thisfile_asf_simpleindexobject['index_entries'][$IndexEntriesCounter]['packet_number'] = getid3_lib::LittleEndian2Int(substr($IndexEntriesData, $offset, 4));
+                                                $offset += 4;
+                                                $thisfile_asf_simpleindexobject['index_entries'][$IndexEntriesCounter]['packet_count']  = getid3_lib::LittleEndian2Int(substr($IndexEntriesData, $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
+                                        $thisfile_asf['asf_index_object'] = array();
+                                        $thisfile_asf_asfindexobject      = &$thisfile_asf['asf_index_object'];
+
+                                        $ASFIndexObjectData = $NextObjectDataHeader.fread($this->getid3->fp, 34 - 24);
+                                        $offset = 24;
+
+                                        $thisfile_asf_asfindexobject['objectid']                  = $NextObjectGUID;
+                                        $thisfile_asf_asfindexobject['objectid_guid']             = $NextObjectGUIDtext;
+                                        $thisfile_asf_asfindexobject['objectsize']                = $NextObjectSize;
+
+                                        $thisfile_asf_asfindexobject['entry_time_interval']       = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 4));
+                                        $offset += 4;
+                                        $thisfile_asf_asfindexobject['index_specifiers_count']    = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 2));
+                                        $offset += 2;
+                                        $thisfile_asf_asfindexobject['index_blocks_count']        = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 4));
+                                        $offset += 4;
+
+                                        $ASFIndexObjectData .= fread($this->getid3->fp, 4 * $thisfile_asf_asfindexobject['index_specifiers_count']);
+                                        for ($IndexSpecifiersCounter = 0; $IndexSpecifiersCounter < $thisfile_asf_asfindexobject['index_specifiers_count']; $IndexSpecifiersCounter++) {
+                                                $IndexSpecifierStreamNumber = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_asfindexobject['index_specifiers'][$IndexSpecifiersCounter]['stream_number']   = $IndexSpecifierStreamNumber;
+                                                $thisfile_asf_asfindexobject['index_specifiers'][$IndexSpecifiersCounter]['index_type']      = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 2));
+                                                $offset += 2;
+                                                $thisfile_asf_asfindexobject['index_specifiers'][$IndexSpecifiersCounter]['index_type_text'] = $this->ASFIndexObjectIndexTypeLookup($thisfile_asf_asfindexobject['index_specifiers'][$IndexSpecifiersCounter]['index_type']);
+                                        }
+
+                                        $ASFIndexObjectData .= fread($this->getid3->fp, 4);
+                                        $thisfile_asf_asfindexobject['index_entry_count'] = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 4));
+                                        $offset += 4;
+
+                                        $ASFIndexObjectData .= fread($this->getid3->fp, 8 * $thisfile_asf_asfindexobject['index_specifiers_count']);
+                                        for ($IndexSpecifiersCounter = 0; $IndexSpecifiersCounter < $thisfile_asf_asfindexobject['index_specifiers_count']; $IndexSpecifiersCounter++) {
+                                                $thisfile_asf_asfindexobject['block_positions'][$IndexSpecifiersCounter] = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 8));
+                                                $offset += 8;
+                                        }
+
+                                        $ASFIndexObjectData .= fread($this->getid3->fp, 4 * $thisfile_asf_asfindexobject['index_specifiers_count'] * $thisfile_asf_asfindexobject['index_entry_count']);
+                                        for ($IndexEntryCounter = 0; $IndexEntryCounter < $thisfile_asf_asfindexobject['index_entry_count']; $IndexEntryCounter++) {
+                                                for ($IndexSpecifiersCounter = 0; $IndexSpecifiersCounter < $thisfile_asf_asfindexobject['index_specifiers_count']; $IndexSpecifiersCounter++) {
+                                                        $thisfile_asf_asfindexobject['offsets'][$IndexSpecifiersCounter][$IndexEntryCounter] = getid3_lib::LittleEndian2Int(substr($ASFIndexObjectData, $offset, 4));
+                                                        $offset += 4;
+                                                }
+                                        }
+                                        break;
+
+
+                                default:
+                                        // Implementations shall ignore any standard or non-standard object that they do not know how to handle.
+                                        if ($this->GUIDname($NextObjectGUIDtext)) {
+                                                $info['warning'][] = 'unhandled GUID "'.$this->GUIDname($NextObjectGUIDtext).'" {'.$NextObjectGUIDtext.'} in ASF body at offset '.($offset - 16 - 8);
+                                        } else {
+                                                $info['warning'][] = 'unknown GUID {'.$NextObjectGUIDtext.'} in ASF body at offset '.(ftell($this->getid3->fp) - 16 - 8);
+                                        }
+                                        fseek($this->getid3->fp, ($NextObjectSize - 16 - 8), SEEK_CUR);
+                                        break;
+                        }
+                }
+
+                if (isset($thisfile_asf_codeclistobject['codec_entries']) && is_array($thisfile_asf_codeclistobject['codec_entries'])) {
+                        foreach ($thisfile_asf_codeclistobject['codec_entries'] as $streamnumber => $streamdata) {
+                                switch ($streamdata['information']) {
+                                        case 'WMV1':
+                                        case 'WMV2':
+                                        case 'WMV3':
+                                        case 'MSS1':
+                                        case 'MSS2':
+                                        case 'WMVA':
+                                        case 'WVC1':
+                                        case 'WMVP':
+                                        case 'WVP2':
+                                                $thisfile_video['dataformat'] = 'wmv';
+                                                $info['mime_type'] = 'video/x-ms-wmv';
+                                                break;
+
+                                        case 'MP42':
+                                        case 'MP43':
+                                        case 'MP4S':
+                                        case 'mp4s':
+                                                $thisfile_video['dataformat'] = 'asf';
+                                                $info['mime_type'] = 'video/x-ms-asf';
+                                                break;
+
+                                        default:
+                                                switch ($streamdata['type_raw']) {
+                                                        case 1:
+                                                                if (strstr($this->TrimConvert($streamdata['name']), 'Windows Media')) {
+                                                                        $thisfile_video['dataformat'] = 'wmv';
+                                                                        if ($info['mime_type'] == 'video/x-ms-asf') {
+                                                                                $info['mime_type'] = 'video/x-ms-wmv';
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                        case 2:
+                                                                if (strstr($this->TrimConvert($streamdata['name']), 'Windows Media')) {
+                                                                        $thisfile_audio['dataformat'] = 'wma';
+                                                                        if ($info['mime_type'] == 'video/x-ms-asf') {
+                                                                                $info['mime_type'] = 'audio/x-ms-wma';
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                }
+                                                break;
+                                }
+                        }
+                }
+
+                switch (isset($thisfile_audio['codec']) ? $thisfile_audio['codec'] : '') {
+                        case 'MPEG Layer-3':
+                                $thisfile_audio['dataformat'] = 'mp3';
+                                break;
+
+                        default:
+                                break;
+                }
+
+                if (isset($thisfile_asf_codeclistobject['codec_entries'])) {
+                        foreach ($thisfile_asf_codeclistobject['codec_entries'] as $streamnumber => $streamdata) {
+                                switch ($streamdata['type_raw']) {
+
+                                        case 1: // video
+                                                $thisfile_video['encoder'] = $this->TrimConvert($thisfile_asf_codeclistobject['codec_entries'][$streamnumber]['name']);
+                                                break;
+
+                                        case 2: // audio
+                                                $thisfile_audio['encoder'] = $this->TrimConvert($thisfile_asf_codeclistobject['codec_entries'][$streamnumber]['name']);
+
+                                                // AH 2003-10-01
+                                                $thisfile_audio['encoder_options'] = $this->TrimConvert($thisfile_asf_codeclistobject['codec_entries'][0]['description']);
+
+                                                $thisfile_audio['codec']   = $thisfile_audio['encoder'];
+                                                break;
+
+                                        default:
+                                                $info['warning'][] = 'Unknown streamtype: [codec_list_object][codec_entries]['.$streamnumber.'][type_raw] == '.$streamdata['type_raw'];
+                                                break;
+
+                                }
+                        }
+                }
+
+                if (isset($info['audio'])) {
+                        $thisfile_audio['lossless']           = (isset($thisfile_audio['lossless'])           ? $thisfile_audio['lossless']           : false);
+                        $thisfile_audio['dataformat']         = (!empty($thisfile_audio['dataformat'])        ? $thisfile_audio['dataformat']         : 'asf');
+                }
+                if (!empty($thisfile_video['dataformat'])) {
+                        $thisfile_video['lossless']           = (isset($thisfile_audio['lossless'])           ? $thisfile_audio['lossless']           : false);
+                        $thisfile_video['pixel_aspect_ratio'] = (isset($thisfile_audio['pixel_aspect_ratio']) ? $thisfile_audio['pixel_aspect_ratio'] : (float) 1);
+                        $thisfile_video['dataformat']         = (!empty($thisfile_video['dataformat'])        ? $thisfile_video['dataformat']         : 'asf');
+                }
+                if (!empty($thisfile_video['streams'])) {
+                        $thisfile_video['streams']['resolution_x'] = 0;
+                        $thisfile_video['streams']['resolution_y'] = 0;
+                        foreach ($thisfile_video['streams'] as $key => $valuearray) {
+                                if (($valuearray['resolution_x'] > $thisfile_video['streams']['resolution_x']) || ($valuearray['resolution_y'] > $thisfile_video['streams']['resolution_y'])) {
+                                        $thisfile_video['resolution_x'] = $valuearray['resolution_x'];
+                                        $thisfile_video['resolution_y'] = $valuearray['resolution_y'];
+                                }
+                        }
+                }
+                $info['bitrate'] = (isset($thisfile_audio['bitrate']) ? $thisfile_audio['bitrate'] : 0) + (isset($thisfile_video['bitrate']) ? $thisfile_video['bitrate'] : 0);
+
+                if ((!isset($info['playtime_seconds']) || ($info['playtime_seconds'] <= 0)) && ($info['bitrate'] > 0)) {
+                        $info['playtime_seconds'] = ($info['filesize'] - $info['avdataoffset']) / ($info['bitrate'] / 8);
+                }
+
+                return true;
+        }
+
+        public static function ASFCodecListObjectTypeLookup($CodecListType) {
+                static $ASFCodecListObjectTypeLookup = array();
+                if (empty($ASFCodecListObjectTypeLookup)) {
+                        $ASFCodecListObjectTypeLookup[0x0001] = 'Video Codec';
+                        $ASFCodecListObjectTypeLookup[0x0002] = 'Audio Codec';
+                        $ASFCodecListObjectTypeLookup[0xFFFF] = 'Unknown Codec';
+                }
+
+                return (isset($ASFCodecListObjectTypeLookup[$CodecListType]) ? $ASFCodecListObjectTypeLookup[$CodecListType] : 'Invalid Codec Type');
+        }
+
+        public static function KnownGUIDs() {
+                static $GUIDarray = array(
+                        'GETID3_ASF_Extended_Stream_Properties_Object'   => '14E6A5CB-C672-4332-8399-A96952065B5A',
+                        'GETID3_ASF_Padding_Object'                      => '1806D474-CADF-4509-A4BA-9AABCB96AAE8',
+                        'GETID3_ASF_Payload_Ext_Syst_Pixel_Aspect_Ratio' => '1B1EE554-F9EA-4BC8-821A-376B74E4C4B8',
+                        'GETID3_ASF_Script_Command_Object'               => '1EFB1A30-0B62-11D0-A39B-00A0C90348F6',
+                        'GETID3_ASF_No_Error_Correction'                 => '20FB5700-5B55-11CF-A8FD-00805F5C442B',
+                        'GETID3_ASF_Content_Branding_Object'             => '2211B3FA-BD23-11D2-B4B7-00A0C955FC6E',
+                        'GETID3_ASF_Content_Encryption_Object'           => '2211B3FB-BD23-11D2-B4B7-00A0C955FC6E',
+                        'GETID3_ASF_Digital_Signature_Object'            => '2211B3FC-BD23-11D2-B4B7-00A0C955FC6E',
+                        'GETID3_ASF_Extended_Content_Encryption_Object'  => '298AE614-2622-4C17-B935-DAE07EE9289C',
+                        'GETID3_ASF_Simple_Index_Object'                 => '33000890-E5B1-11CF-89F4-00A0C90349CB',
+                        'GETID3_ASF_Degradable_JPEG_Media'               => '35907DE0-E415-11CF-A917-00805F5C442B',
+                        'GETID3_ASF_Payload_Extension_System_Timecode'   => '399595EC-8667-4E2D-8FDB-98814CE76C1E',
+                        'GETID3_ASF_Binary_Media'                        => '3AFB65E2-47EF-40F2-AC2C-70A90D71D343',
+                        'GETID3_ASF_Timecode_Index_Object'               => '3CB73FD0-0C4A-4803-953D-EDF7B6228F0C',
+                        'GETID3_ASF_Metadata_Library_Object'             => '44231C94-9498-49D1-A141-1D134E457054',
+                        'GETID3_ASF_Reserved_3'                          => '4B1ACBE3-100B-11D0-A39B-00A0C90348F6',
+                        'GETID3_ASF_Reserved_4'                          => '4CFEDB20-75F6-11CF-9C0F-00A0C90349CB',
+                        'GETID3_ASF_Command_Media'                       => '59DACFC0-59E6-11D0-A3AC-00A0C90348F6',
+                        'GETID3_ASF_Header_Extension_Object'             => '5FBF03B5-A92E-11CF-8EE3-00C00C205365',
+                        'GETID3_ASF_Media_Object_Index_Parameters_Obj'   => '6B203BAD-3F11-4E84-ACA8-D7613DE2CFA7',
+                        'GETID3_ASF_Header_Object'                       => '75B22630-668E-11CF-A6D9-00AA0062CE6C',
+                        'GETID3_ASF_Content_Description_Object'          => '75B22633-668E-11CF-A6D9-00AA0062CE6C',
+                        'GETID3_ASF_Error_Correction_Object'             => '75B22635-668E-11CF-A6D9-00AA0062CE6C',
+                        'GETID3_ASF_Data_Object'                         => '75B22636-668E-11CF-A6D9-00AA0062CE6C',
+                        'GETID3_ASF_Web_Stream_Media_Subtype'            => '776257D4-C627-41CB-8F81-7AC7FF1C40CC',
+                        'GETID3_ASF_Stream_Bitrate_Properties_Object'    => '7BF875CE-468D-11D1-8D82-006097C9A2B2',
+                        'GETID3_ASF_Language_List_Object'                => '7C4346A9-EFE0-4BFC-B229-393EDE415C85',
+                        'GETID3_ASF_Codec_List_Object'                   => '86D15240-311D-11D0-A3A4-00A0C90348F6',
+                        'GETID3_ASF_Reserved_2'                          => '86D15241-311D-11D0-A3A4-00A0C90348F6',
+                        'GETID3_ASF_File_Properties_Object'              => '8CABDCA1-A947-11CF-8EE4-00C00C205365',
+                        'GETID3_ASF_File_Transfer_Media'                 => '91BD222C-F21C-497A-8B6D-5AA86BFC0185',
+                        'GETID3_ASF_Old_RTP_Extension_Data'              => '96800C63-4C94-11D1-837B-0080C7A37F95',
+                        'GETID3_ASF_Advanced_Mutual_Exclusion_Object'    => 'A08649CF-4775-4670-8A16-6E35357566CD',
+                        'GETID3_ASF_Bandwidth_Sharing_Object'            => 'A69609E6-517B-11D2-B6AF-00C04FD908E9',
+                        'GETID3_ASF_Reserved_1'                          => 'ABD3D211-A9BA-11cf-8EE6-00C00C205365',
+                        'GETID3_ASF_Bandwidth_Sharing_Exclusive'         => 'AF6060AA-5197-11D2-B6AF-00C04FD908E9',
+                        'GETID3_ASF_Bandwidth_Sharing_Partial'           => 'AF6060AB-5197-11D2-B6AF-00C04FD908E9',
+                        'GETID3_ASF_JFIF_Media'                          => 'B61BE100-5B4E-11CF-A8FD-00805F5C442B',
+                        'GETID3_ASF_Stream_Properties_Object'            => 'B7DC0791-A9B7-11CF-8EE6-00C00C205365',
+                        'GETID3_ASF_Video_Media'                         => 'BC19EFC0-5B4D-11CF-A8FD-00805F5C442B',
+                        'GETID3_ASF_Audio_Spread'                        => 'BFC3CD50-618F-11CF-8BB2-00AA00B4E220',
+                        'GETID3_ASF_Metadata_Object'                     => 'C5F8CBEA-5BAF-4877-8467-AA8C44FA4CCA',
+                        'GETID3_ASF_Payload_Ext_Syst_Sample_Duration'    => 'C6BD9450-867F-4907-83A3-C77921B733AD',
+                        'GETID3_ASF_Group_Mutual_Exclusion_Object'       => 'D1465A40-5A79-4338-B71B-E36B8FD6C249',
+                        'GETID3_ASF_Extended_Content_Description_Object' => 'D2D0A440-E307-11D2-97F0-00A0C95EA850',
+                        'GETID3_ASF_Stream_Prioritization_Object'        => 'D4FED15B-88D3-454F-81F0-ED5C45999E24',
+                        'GETID3_ASF_Payload_Ext_System_Content_Type'     => 'D590DC20-07BC-436C-9CF7-F3BBFBF1A4DC',
+                        'GETID3_ASF_Old_File_Properties_Object'          => 'D6E229D0-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_ASF_Header_Object'               => 'D6E229D1-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_ASF_Data_Object'                 => 'D6E229D2-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Index_Object'                        => 'D6E229D3-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Stream_Properties_Object'        => 'D6E229D4-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Content_Description_Object'      => 'D6E229D5-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Script_Command_Object'           => 'D6E229D6-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Marker_Object'                   => 'D6E229D7-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Component_Download_Object'       => 'D6E229D8-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Stream_Group_Object'             => 'D6E229D9-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Scalable_Object'                 => 'D6E229DA-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Prioritization_Object'           => 'D6E229DB-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Bitrate_Mutual_Exclusion_Object'     => 'D6E229DC-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Inter_Media_Dependency_Object'   => 'D6E229DD-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Rating_Object'                   => 'D6E229DE-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Index_Parameters_Object'             => 'D6E229DF-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Color_Table_Object'              => 'D6E229E0-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Language_List_Object'            => 'D6E229E1-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Audio_Media'                     => 'D6E229E2-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Video_Media'                     => 'D6E229E3-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Image_Media'                     => 'D6E229E4-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Timecode_Media'                  => 'D6E229E5-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Text_Media'                      => 'D6E229E6-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_MIDI_Media'                      => 'D6E229E7-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Command_Media'                   => 'D6E229E8-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_No_Error_Concealment'            => 'D6E229EA-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Scrambled_Audio'                 => 'D6E229EB-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_No_Color_Table'                  => 'D6E229EC-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_SMPTE_Time'                      => 'D6E229ED-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_ASCII_Text'                      => 'D6E229EE-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Unicode_Text'                    => 'D6E229EF-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_HTML_Text'                       => 'D6E229F0-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_URL_Command'                     => 'D6E229F1-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Filename_Command'                => 'D6E229F2-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_ACM_Codec'                       => 'D6E229F3-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_VCM_Codec'                       => 'D6E229F4-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_QuickTime_Codec'                 => 'D6E229F5-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_DirectShow_Transform_Filter'     => 'D6E229F6-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_DirectShow_Rendering_Filter'     => 'D6E229F7-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_No_Enhancement'                  => 'D6E229F8-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Unknown_Enhancement_Type'        => 'D6E229F9-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Temporal_Enhancement'            => 'D6E229FA-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Spatial_Enhancement'             => 'D6E229FB-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Quality_Enhancement'             => 'D6E229FC-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Number_of_Channels_Enhancement'  => 'D6E229FD-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Frequency_Response_Enhancement'  => 'D6E229FE-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Media_Object'                    => 'D6E229FF-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Mutex_Language'                      => 'D6E22A00-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Mutex_Bitrate'                       => 'D6E22A01-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Mutex_Unknown'                       => 'D6E22A02-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_ASF_Placeholder_Object'          => 'D6E22A0E-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Old_Data_Unit_Extension_Object'      => 'D6E22A0F-35DA-11D1-9034-00A0C90349BE',
+                        'GETID3_ASF_Web_Stream_Format'                   => 'DA1E6B13-8359-4050-B398-388E965BF00C',
+                        'GETID3_ASF_Payload_Ext_System_File_Name'        => 'E165EC0E-19ED-45D7-B4A7-25CBD1E28E9B',
+                        'GETID3_ASF_Marker_Object'                       => 'F487CD01-A951-11CF-8EE6-00C00C205365',
+                        'GETID3_ASF_Timecode_Index_Parameters_Object'    => 'F55E496D-9797-4B5D-8C8B-604DFE9BFB24',
+                        'GETID3_ASF_Audio_Media'                         => 'F8699E40-5B4D-11CF-A8FD-00805F5C442B',
+                        'GETID3_ASF_Media_Object_Index_Object'           => 'FEB103F8-12AD-4C64-840F-2A1D2F7AD48C',
+                        'GETID3_ASF_Alt_Extended_Content_Encryption_Obj' => 'FF889EF1-ADEE-40DA-9E71-98704BB928CE',
+                        'GETID3_ASF_Index_Placeholder_Object'            => 'D9AADE20-7C17-4F9C-BC28-8555DD98E2A2', // http://cpan.uwinnipeg.ca/htdocs/Audio-WMA/Audio/WMA.pm.html
+                        'GETID3_ASF_Compatibility_Object'                => '26F18B5D-4584-47EC-9F5F-0E651F0452C9', // http://cpan.uwinnipeg.ca/htdocs/Audio-WMA/Audio/WMA.pm.html
+                );
+                return $GUIDarray;
+        }
+
+        public static function GUIDname($GUIDstring) {
+                static $GUIDarray = array();
+                if (empty($GUIDarray)) {
+                        $GUIDarray = self::KnownGUIDs();
+                }
+                return array_search($GUIDstring, $GUIDarray);
+        }
+
+        public static function ASFIndexObjectIndexTypeLookup($id) {
+                static $ASFIndexObjectIndexTypeLookup = array();
+                if (empty($ASFIndexObjectIndexTypeLookup)) {
+                        $ASFIndexObjectIndexTypeLookup[1] = 'Nearest Past Data Packet';
+                        $ASFIndexObjectIndexTypeLookup[2] = 'Nearest Past Media Object';
+                        $ASFIndexObjectIndexTypeLookup[3] = 'Nearest Past Cleanpoint';
+                }
+                return (isset($ASFIndexObjectIndexTypeLookup[$id]) ? $ASFIndexObjectIndexTypeLookup[$id] : 'invalid');
+        }
+
+        public static function GUIDtoBytestring($GUIDstring) {
+                // 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
+
+                $hexbytecharstring  = chr(hexdec(substr($GUIDstring,  6, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring,  4, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring,  2, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring,  0, 2)));
+
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 11, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring,  9, 2)));
+
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 16, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 14, 2)));
+
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 19, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 21, 2)));
+
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 24, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 26, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 28, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 30, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 32, 2)));
+                $hexbytecharstring .= chr(hexdec(substr($GUIDstring, 34, 2)));
+
+                return $hexbytecharstring;
+        }
+
+        public static function BytestringToGUID($Bytestring) {
+                $GUIDstring  = str_pad(dechex(ord($Bytestring{3})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{2})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{1})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{0})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= '-';
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{5})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{4})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= '-';
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{7})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{6})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= '-';
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{8})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{9})),  2, '0', STR_PAD_LEFT);
+                $GUIDstring .= '-';
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{10})), 2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{11})), 2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{12})), 2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{13})), 2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{14})), 2, '0', STR_PAD_LEFT);
+                $GUIDstring .= str_pad(dechex(ord($Bytestring{15})), 2, '0', STR_PAD_LEFT);
+
+                return strtoupper($GUIDstring);
+        }
+
+        public static function FILETIMEtoUNIXtime($FILETIME, $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
+                if ($round) {
+                        return intval(round(($FILETIME - 116444736000000000) / 10000000));
+                }
+                return ($FILETIME - 116444736000000000) / 10000000;
+        }
+
+        public static function WMpictureTypeLookup($WMpictureType) {
+                static $WMpictureTypeLookup = array();
+                if (empty($WMpictureTypeLookup)) {
+                        $WMpictureTypeLookup[0x03] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Front Cover');
+                        $WMpictureTypeLookup[0x04] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Back Cover');
+                        $WMpictureTypeLookup[0x00] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'User Defined');
+                        $WMpictureTypeLookup[0x05] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Leaflet Page');
+                        $WMpictureTypeLookup[0x06] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Media Label');
+                        $WMpictureTypeLookup[0x07] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Lead Artist');
+                        $WMpictureTypeLookup[0x08] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Artist');
+                        $WMpictureTypeLookup[0x09] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Conductor');
+                        $WMpictureTypeLookup[0x0A] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Band');
+                        $WMpictureTypeLookup[0x0B] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Composer');
+                        $WMpictureTypeLookup[0x0C] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Lyricist');
+                        $WMpictureTypeLookup[0x0D] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Recording Location');
+                        $WMpictureTypeLookup[0x0E] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'During Recording');
+                        $WMpictureTypeLookup[0x0F] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'During Performance');
+                        $WMpictureTypeLookup[0x10] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Video Screen Capture');
+                        $WMpictureTypeLookup[0x12] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Illustration');
+                        $WMpictureTypeLookup[0x13] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Band Logotype');
+                        $WMpictureTypeLookup[0x14] = getid3_lib::iconv_fallback('ISO-8859-1', 'UTF-16LE', 'Publisher Logotype');
+                }
+                return (isset($WMpictureTypeLookup[$WMpictureType]) ? $WMpictureTypeLookup[$WMpictureType] : '');
+        }
+
+        public function ASF_HeaderExtensionObjectDataParse(&$asf_header_extension_object_data, &$unhandled_sections) {
+                // http://msdn.microsoft.com/en-us/library/bb643323.aspx
+
+                $offset = 0;
+                $objectOffset = 0;
+                $HeaderExtensionObjectParsed = array();
+                while ($objectOffset < strlen($asf_header_extension_object_data)) {
+                        $offset = $objectOffset;
+                        $thisObject = array();
+
+                        $thisObject['guid']                              =                              substr($asf_header_extension_object_data, $offset, 16);
+                        $offset += 16;
+                        $thisObject['guid_text'] = $this->BytestringToGUID($thisObject['guid']);
+                        $thisObject['guid_name'] = $this->GUIDname($thisObject['guid_text']);
+
+                        $thisObject['size']                              = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  8));
+                        $offset += 8;
+                        if ($thisObject['size'] <= 0) {
+                                break;
+                        }
+
+                        switch ($thisObject['guid']) {
+                                case GETID3_ASF_Extended_Stream_Properties_Object:
+                                        $thisObject['start_time']                        = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  8));
+                                        $offset += 8;
+                                        $thisObject['start_time_unix']                   = $this->FILETIMEtoUNIXtime($thisObject['start_time']);
+
+                                        $thisObject['end_time']                          = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  8));
+                                        $offset += 8;
+                                        $thisObject['end_time_unix']                     = $this->FILETIMEtoUNIXtime($thisObject['end_time']);
+
+                                        $thisObject['data_bitrate']                      = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['buffer_size']                       = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['initial_buffer_fullness']           = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['alternate_data_bitrate']            = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['alternate_buffer_size']             = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['alternate_initial_buffer_fullness'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['maximum_object_size']               = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['flags_raw']                         = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+                                        $thisObject['flags']['reliable']                = (bool) $thisObject['flags_raw'] & 0x00000001;
+                                        $thisObject['flags']['seekable']                = (bool) $thisObject['flags_raw'] & 0x00000002;
+                                        $thisObject['flags']['no_cleanpoints']          = (bool) $thisObject['flags_raw'] & 0x00000004;
+                                        $thisObject['flags']['resend_live_cleanpoints'] = (bool) $thisObject['flags_raw'] & 0x00000008;
+
+                                        $thisObject['stream_number']                     = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                        $offset += 2;
+
+                                        $thisObject['stream_language_id_index']          = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                        $offset += 2;
+
+                                        $thisObject['average_time_per_frame']            = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                        $offset += 4;
+
+                                        $thisObject['stream_name_count']                 = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                        $offset += 2;
+
+                                        $thisObject['payload_extension_system_count']    = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                        $offset += 2;
+
+                                        for ($i = 0; $i < $thisObject['stream_name_count']; $i++) {
+                                                $streamName = array();
+
+                                                $streamName['language_id_index']             = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+
+                                                $streamName['stream_name_length']            = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+
+                                                $streamName['stream_name']                   = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  $streamName['stream_name_length']));
+                                                $offset += $streamName['stream_name_length'];
+
+                                                $thisObject['stream_names'][$i] = $streamName;
+                                        }
+
+                                        for ($i = 0; $i < $thisObject['payload_extension_system_count']; $i++) {
+                                                $payloadExtensionSystem = array();
+
+                                                $payloadExtensionSystem['extension_system_id']   =                              substr($asf_header_extension_object_data, $offset, 16);
+                                                $offset += 16;
+                                                $payloadExtensionSystem['extension_system_id_text'] = $this->BytestringToGUID($payloadExtensionSystem['extension_system_id']);
+
+                                                $payloadExtensionSystem['extension_system_size'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+                                                if ($payloadExtensionSystem['extension_system_size'] <= 0) {
+                                                        break 2;
+                                                }
+
+                                                $payloadExtensionSystem['extension_system_info_length'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                                $offset += 4;
+
+                                                $payloadExtensionSystem['extension_system_info_length'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  $payloadExtensionSystem['extension_system_info_length']));
+                                                $offset += $payloadExtensionSystem['extension_system_info_length'];
+
+                                                $thisObject['payload_extension_systems'][$i] = $payloadExtensionSystem;
+                                        }
+
+                                        break;
+
+                                case GETID3_ASF_Padding_Object:
+                                        // padding, skip it
+                                        break;
+
+                                case GETID3_ASF_Metadata_Object:
+                                        $thisObject['description_record_counts'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                        $offset += 2;
+
+                                        for ($i = 0; $i < $thisObject['description_record_counts']; $i++) {
+                                                $descriptionRecord = array();
+
+                                                $descriptionRecord['reserved_1']         = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2)); // must be zero
+                                                $offset += 2;
+
+                                                $descriptionRecord['stream_number']      = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+
+                                                $descriptionRecord['name_length']        = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+
+                                                $descriptionRecord['data_type']          = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+                                                $descriptionRecord['data_type_text'] = $this->ASFmetadataLibraryObjectDataTypeLookup($descriptionRecord['data_type']);
+
+                                                $descriptionRecord['data_length']        = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                                $offset += 4;
+
+                                                $descriptionRecord['name']               =                              substr($asf_header_extension_object_data, $offset,  $descriptionRecord['name_length']);
+                                                $offset += $descriptionRecord['name_length'];
+
+                                                $descriptionRecord['data']               =                              substr($asf_header_extension_object_data, $offset,  $descriptionRecord['data_length']);
+                                                $offset += $descriptionRecord['data_length'];
+                                                switch ($descriptionRecord['data_type']) {
+                                                        case 0x0000: // Unicode string
+                                                                break;
+
+                                                        case 0x0001: // BYTE array
+                                                                // do nothing
+                                                                break;
+
+                                                        case 0x0002: // BOOL
+                                                                $descriptionRecord['data'] = (bool) getid3_lib::LittleEndian2Int($descriptionRecord['data']);
+                                                                break;
+
+                                                        case 0x0003: // DWORD
+                                                        case 0x0004: // QWORD
+                                                        case 0x0005: // WORD
+                                                                $descriptionRecord['data'] = getid3_lib::LittleEndian2Int($descriptionRecord['data']);
+                                                                break;
+
+                                                        case 0x0006: // GUID
+                                                                $descriptionRecord['data_text'] = $this->BytestringToGUID($descriptionRecord['data']);
+                                                                break;
+                                                }
+
+                                                $thisObject['description_record'][$i] = $descriptionRecord;
+                                        }
+                                        break;
+
+                                case GETID3_ASF_Language_List_Object:
+                                        $thisObject['language_id_record_counts'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                        $offset += 2;
+
+                                        for ($i = 0; $i < $thisObject['language_id_record_counts']; $i++) {
+                                                $languageIDrecord = array();
+
+                                                $languageIDrecord['language_id_length']         = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  1));
+                                                $offset += 1;
+
+                                                $languageIDrecord['language_id']                =                              substr($asf_header_extension_object_data, $offset,  $languageIDrecord['language_id_length']);
+                                                $offset += $languageIDrecord['language_id_length'];
+
+                                                $thisObject['language_id_record'][$i] = $languageIDrecord;
+                                        }
+                                        break;
+
+                                case GETID3_ASF_Metadata_Library_Object:
+                                        $thisObject['description_records_count'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                        $offset += 2;
+
+                                        for ($i = 0; $i < $thisObject['description_records_count']; $i++) {
+                                                $descriptionRecord = array();
+
+                                                $descriptionRecord['language_list_index'] = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+
+                                                $descriptionRecord['stream_number']       = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+
+                                                $descriptionRecord['name_length']         = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+
+                                                $descriptionRecord['data_type']           = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  2));
+                                                $offset += 2;
+                                                $descriptionRecord['data_type_text'] = $this->ASFmetadataLibraryObjectDataTypeLookup($descriptionRecord['data_type']);
+
+                                                $descriptionRecord['data_length']         = getid3_lib::LittleEndian2Int(substr($asf_header_extension_object_data, $offset,  4));
+                                                $offset += 4;
+
+                                                $descriptionRecord['name']                =                              substr($asf_header_extension_object_data, $offset,  $descriptionRecord['name_length']);
+                                                $offset += $descriptionRecord['name_length'];
+
+                                                $descriptionRecord['data']                =                              substr($asf_header_extension_object_data, $offset,  $descriptionRecord['data_length']);
+                                                $offset += $descriptionRecord['data_length'];
+
+                                                if (preg_match('#^WM/Picture$#', str_replace("\x00", '', trim($descriptionRecord['name'])))) {
+                                                        $WMpicture = $this->ASF_WMpicture($descriptionRecord['data']);
+                                                        foreach ($WMpicture as $key => $value) {
+                                                                $descriptionRecord['data'] = $WMpicture;
+                                                        }
+                                                        unset($WMpicture);
+                                                }
+
+                                                $thisObject['description_record'][$i] = $descriptionRecord;
+                                        }
+                                        break;
+
+                                default:
+                                        $unhandled_sections++;
+                                        if ($this->GUIDname($thisObject['guid_text'])) {
+                                                $this->getid3->info['warning'][] = 'unhandled Header Extension Object GUID "'.$this->GUIDname($thisObject['guid_text']).'" {'.$thisObject['guid_text'].'} at offset '.($offset - 16 - 8);
+                                        } else {
+                                                $this->getid3->info['warning'][] = 'unknown Header Extension Object GUID {'.$thisObject['guid_text'].'} in at offset '.($offset - 16 - 8);
+                                        }
+                                        break;
+                        }
+                        $HeaderExtensionObjectParsed[] = $thisObject;
+
+                        $objectOffset += $thisObject['size'];
+                }
+                return $HeaderExtensionObjectParsed;
+        }
+
+
+        public static function ASFmetadataLibraryObjectDataTypeLookup($id) {
+                static $ASFmetadataLibraryObjectDataTypeLookup = array(
+                        0x0000 => 'Unicode string', // The data consists of a sequence of Unicode characters
+                        0x0001 => 'BYTE array',     // The type of the data is implementation-specific
+                        0x0002 => 'BOOL',           // The data is 2 bytes long and should be interpreted as a 16-bit unsigned integer. Only 0x0000 or 0x0001 are permitted values
+                        0x0003 => 'DWORD',          // The data is 4 bytes long and should be interpreted as a 32-bit unsigned integer
+                        0x0004 => 'QWORD',          // The data is 8 bytes long and should be interpreted as a 64-bit unsigned integer
+                        0x0005 => 'WORD',           // The data is 2 bytes long and should be interpreted as a 16-bit unsigned integer
+                        0x0006 => 'GUID',           // The data is 16 bytes long and should be interpreted as a 128-bit GUID
+                );
+                return (isset($ASFmetadataLibraryObjectDataTypeLookup[$id]) ? $ASFmetadataLibraryObjectDataTypeLookup[$id] : 'invalid');
+        }
+
+        public function ASF_WMpicture(&$data) {
+                //typedef struct _WMPicture{
+                //  LPWSTR  pwszMIMEType;
+                //  BYTE  bPictureType;
+                //  LPWSTR  pwszDescription;
+                //  DWORD  dwDataLen;
+                //  BYTE*  pbData;
+                //} WM_PICTURE;
+
+                $WMpicture = array();
+
+                $offset = 0;
+                $WMpicture['image_type_id'] = getid3_lib::LittleEndian2Int(substr($data, $offset, 1));
+                $offset += 1;
+                $WMpicture['image_type']    = $this->WMpictureTypeLookup($WMpicture['image_type_id']);
+                $WMpicture['image_size']    = getid3_lib::LittleEndian2Int(substr($data, $offset, 4));
+                $offset += 4;
+
+                $WMpicture['image_mime'] = '';
+                do {
+                        $next_byte_pair = substr($data, $offset, 2);
+                        $offset += 2;
+                        $WMpicture['image_mime'] .= $next_byte_pair;
+                } while ($next_byte_pair !== "\x00\x00");
+
+                $WMpicture['image_description'] = '';
+                do {
+                        $next_byte_pair = substr($data, $offset, 2);
+                        $offset += 2;
+                        $WMpicture['image_description'] .= $next_byte_pair;
+                } while ($next_byte_pair !== "\x00\x00");
+
+                $WMpicture['dataoffset'] = $offset;
+                $WMpicture['data'] = substr($data, $offset);
+
+                $imageinfo = array();
+                $WMpicture['image_mime'] = '';
+                $imagechunkcheck = getid3_lib::GetDataImageSize($WMpicture['data'], $imageinfo);
+                unset($imageinfo);
+                if (!empty($imagechunkcheck)) {
+                        $WMpicture['image_mime'] = image_type_to_mime_type($imagechunkcheck[2]);
+                }
+                if (!isset($this->getid3->info['asf']['comments']['picture'])) {
+                        $this->getid3->info['asf']['comments']['picture'] = array();
+                }
+                $this->getid3->info['asf']['comments']['picture'][] = array('data'=>$WMpicture['data'], 'image_mime'=>$WMpicture['image_mime']);
+
+                return $WMpicture;
+        }
+
+
+        // Remove terminator 00 00 and convert UTF-16LE to Latin-1
+        public static function TrimConvert($string) {
+                return trim(getid3_lib::iconv_fallback('UTF-16LE', 'ISO-8859-1', self::TrimTerm($string)), ' ');
+        }
+
+
+        // Remove terminator 00 00
+        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;
+        }
+
+}

new file wp-includes/ID3/module.audio-video.flv.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+//                                                             //
+//  FLV module by Seth Kaufman <sethØwhirl-i-gig*com>          //
+//                                                             //
+//  * version 0.1 (26 June 2005)                               //
+//                                                             //
+//                                                             //
+//  * version 0.1.1 (15 July 2005)                             //
+//  minor modifications by James Heinrich <info@getid3.org>    //
+//                                                             //
+//  * version 0.2 (22 February 2006)                           //
+//  Support for On2 VP6 codec and meta information             //
+//    by Steve Webster <steve.websterØfeaturecreep*com>        //
+//                                                             //
+//  * version 0.3 (15 June 2006)                               //
+//  Modified to not read entire file into memory               //
+//    by James Heinrich <info@getid3.org>                      //
+//                                                             //
+//  * version 0.4 (07 December 2007)                           //
+//  Bugfixes for incorrectly parsed FLV dimensions             //
+//    and incorrect parsing of onMetaTag                       //
+//    by Evgeny Moysevich <moysevichØgmail*com>                //
+//                                                             //
+//  * version 0.5 (21 May 2009)                                //
+//  Fixed parsing of audio tags and added additional codec     //
+//    details. The duration is now read from onMetaTag (if     //
+//    exists), rather than parsing whole file                  //
+//    by Nigel Barnes <ngbarnesØhotmail*com>                   //
+//                                                             //
+//  * version 0.6 (24 May 2009)                                //
+//  Better parsing of files with h264 video                    //
+//    by Evgeny Moysevich <moysevichØgmail*com>                //
+//                                                             //
+//  * version 0.6.1 (30 May 2011)                              //
+//    prevent infinite loops in expGolombUe()                  //
+//                                                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio-video.flv.php                                  //
+// module for analyzing Shockwave Flash Video files            //
+// dependencies: NONE                                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+define('GETID3_FLV_TAG_AUDIO',          8);
+define('GETID3_FLV_TAG_VIDEO',          9);
+define('GETID3_FLV_TAG_META',          18);
+
+define('GETID3_FLV_VIDEO_H263',         2);
+define('GETID3_FLV_VIDEO_SCREEN',       3);
+define('GETID3_FLV_VIDEO_VP6FLV',       4);
+define('GETID3_FLV_VIDEO_VP6FLV_ALPHA', 5);
+define('GETID3_FLV_VIDEO_SCREENV2',     6);
+define('GETID3_FLV_VIDEO_H264',         7);
+
+define('H264_AVC_SEQUENCE_HEADER',          0);
+define('H264_PROFILE_BASELINE',            66);
+define('H264_PROFILE_MAIN',                77);
+define('H264_PROFILE_EXTENDED',            88);
+define('H264_PROFILE_HIGH',               100);
+define('H264_PROFILE_HIGH10',             110);
+define('H264_PROFILE_HIGH422',            122);
+define('H264_PROFILE_HIGH444',            144);
+define('H264_PROFILE_HIGH444_PREDICTIVE', 244);
+
+class getid3_flv extends getid3_handler
+{
+        public $max_frames = 100000; // break out of the loop if too many frames have been scanned; only scan this many if meta frame does not contain useful duration
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                fseek($this->getid3->fp, $info['avdataoffset'], SEEK_SET);
+
+                $FLVdataLength = $info['avdataend'] - $info['avdataoffset'];
+                $FLVheader = fread($this->getid3->fp, 5);
+
+                $info['fileformat'] = 'flv';
+                $info['flv']['header']['signature'] =                           substr($FLVheader, 0, 3);
+                $info['flv']['header']['version']   = getid3_lib::BigEndian2Int(substr($FLVheader, 3, 1));
+                $TypeFlags                          = getid3_lib::BigEndian2Int(substr($FLVheader, 4, 1));
+
+                $magic = 'FLV';
+                if ($info['flv']['header']['signature'] != $magic) {
+                        $info['error'][] = 'Expecting "'.getid3_lib::PrintHexBytes($magic).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib::PrintHexBytes($info['flv']['header']['signature']).'"';
+                        unset($info['flv']);
+                        unset($info['fileformat']);
+                        return false;
+                }
+
+                $info['flv']['header']['hasAudio'] = (bool) ($TypeFlags & 0x04);
+                $info['flv']['header']['hasVideo'] = (bool) ($TypeFlags & 0x01);
+
+                $FrameSizeDataLength = getid3_lib::BigEndian2Int(fread($this->getid3->fp, 4));
+                $FLVheaderFrameLength = 9;
+                if ($FrameSizeDataLength > $FLVheaderFrameLength) {
+                        fseek($this->getid3->fp, $FrameSizeDataLength - $FLVheaderFrameLength, SEEK_CUR);
+                }
+                $Duration = 0;
+                $found_video = false;
+                $found_audio = false;
+                $found_meta  = false;
+                $found_valid_meta_playtime = false;
+                $tagParseCount = 0;
+                $info['flv']['framecount'] = array('total'=>0, 'audio'=>0, 'video'=>0);
+                $flv_framecount = &$info['flv']['framecount'];
+                while (((ftell($this->getid3->fp) + 16) < $info['avdataend']) && (($tagParseCount++ <= $this->max_frames) || !$found_valid_meta_playtime))  {
+                        $ThisTagHeader = fread($this->getid3->fp, 16);
+
+                        $PreviousTagLength = getid3_lib::BigEndian2Int(substr($ThisTagHeader,  0, 4));
+                        $TagType           = getid3_lib::BigEndian2Int(substr($ThisTagHeader,  4, 1));
+                        $DataLength        = getid3_lib::BigEndian2Int(substr($ThisTagHeader,  5, 3));
+                        $Timestamp         = getid3_lib::BigEndian2Int(substr($ThisTagHeader,  8, 3));
+                        $LastHeaderByte    = getid3_lib::BigEndian2Int(substr($ThisTagHeader, 15, 1));
+                        $NextOffset = ftell($this->getid3->fp) - 1 + $DataLength;
+                        if ($Timestamp > $Duration) {
+                                $Duration = $Timestamp;
+                        }
+
+                        $flv_framecount['total']++;
+                        switch ($TagType) {
+                                case GETID3_FLV_TAG_AUDIO:
+                                        $flv_framecount['audio']++;
+                                        if (!$found_audio) {
+                                                $found_audio = true;
+                                                $info['flv']['audio']['audioFormat']     = ($LastHeaderByte >> 4) & 0x0F;
+                                                $info['flv']['audio']['audioRate']       = ($LastHeaderByte >> 2) & 0x03;
+                                                $info['flv']['audio']['audioSampleSize'] = ($LastHeaderByte >> 1) & 0x01;
+                                                $info['flv']['audio']['audioType']       =  $LastHeaderByte       & 0x01;
+                                        }
+                                        break;
+
+                                case GETID3_FLV_TAG_VIDEO:
+                                        $flv_framecount['video']++;
+                                        if (!$found_video) {
+                                                $found_video = true;
+                                                $info['flv']['video']['videoCodec'] = $LastHeaderByte & 0x07;
+
+                                                $FLVvideoHeader = fread($this->getid3->fp, 11);
+
+                                                if ($info['flv']['video']['videoCodec'] == GETID3_FLV_VIDEO_H264) {
+                                                        // this code block contributed by: moysevichØgmail*com
+
+                                                        $AVCPacketType = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 0, 1));
+                                                        if ($AVCPacketType == H264_AVC_SEQUENCE_HEADER) {
+                                                                //      read AVCDecoderConfigurationRecord
+                                                                $configurationVersion       = getid3_lib::BigEndian2Int(substr($FLVvideoHeader,  4, 1));
+                                                                $AVCProfileIndication       = getid3_lib::BigEndian2Int(substr($FLVvideoHeader,  5, 1));
+                                                                $profile_compatibility      = getid3_lib::BigEndian2Int(substr($FLVvideoHeader,  6, 1));
+                                                                $lengthSizeMinusOne         = getid3_lib::BigEndian2Int(substr($FLVvideoHeader,  7, 1));
+                                                                $numOfSequenceParameterSets = getid3_lib::BigEndian2Int(substr($FLVvideoHeader,  8, 1));
+
+                                                                if (($numOfSequenceParameterSets & 0x1F) != 0) {
+                                                                        //      there is at least one SequenceParameterSet
+                                                                        //      read size of the first SequenceParameterSet
+                                                                        //$spsSize = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 9, 2));
+                                                                        $spsSize = getid3_lib::LittleEndian2Int(substr($FLVvideoHeader, 9, 2));
+                                                                        //      read the first SequenceParameterSet
+                                                                        $sps = fread($this->getid3->fp, $spsSize);
+                                                                        if (strlen($sps) == $spsSize) { //      make sure that whole SequenceParameterSet was red
+                                                                                $spsReader = new AVCSequenceParameterSetReader($sps);
+                                                                                $spsReader->readData();
+                                                                                $info['video']['resolution_x'] = $spsReader->getWidth();
+                                                                                $info['video']['resolution_y'] = $spsReader->getHeight();
+                                                                        }
+                                                                }
+                                                        }
+                                                        // end: moysevichØgmail*com
+
+                                                } elseif ($info['flv']['video']['videoCodec'] == GETID3_FLV_VIDEO_H263) {
+
+                                                        $PictureSizeType = (getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 3, 2))) >> 7;
+                                                        $PictureSizeType = $PictureSizeType & 0x0007;
+                                                        $info['flv']['header']['videoSizeType'] = $PictureSizeType;
+                                                        switch ($PictureSizeType) {
+                                                                case 0:
+                                                                        //$PictureSizeEnc = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 5, 2));
+                                                                        //$PictureSizeEnc <<= 1;
+                                                                        //$info['video']['resolution_x'] = ($PictureSizeEnc & 0xFF00) >> 8;
+                                                                        //$PictureSizeEnc = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 6, 2));
+                                                                        //$PictureSizeEnc <<= 1;
+                                                                        //$info['video']['resolution_y'] = ($PictureSizeEnc & 0xFF00) >> 8;
+
+                                                                        $PictureSizeEnc['x'] = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 4, 2));
+                                                                        $PictureSizeEnc['y'] = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 5, 2));
+                                                                        $PictureSizeEnc['x'] >>= 7;
+                                                                        $PictureSizeEnc['y'] >>= 7;
+                                                                        $info['video']['resolution_x'] = $PictureSizeEnc['x'] & 0xFF;
+                                                                        $info['video']['resolution_y'] = $PictureSizeEnc['y'] & 0xFF;
+                                                                        break;
+
+                                                                case 1:
+                                                                        $PictureSizeEnc['x'] = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 4, 3));
+                                                                        $PictureSizeEnc['y'] = getid3_lib::BigEndian2Int(substr($FLVvideoHeader, 6, 3));
+                                                                        $PictureSizeEnc['x'] >>= 7;
+                                                                        $PictureSizeEnc['y'] >>= 7;
+                                                                        $info['video']['resolution_x'] = $PictureSizeEnc['x'] & 0xFFFF;
+                                                                        $info['video']['resolution_y'] = $PictureSizeEnc['y'] & 0xFFFF;
+                                                                        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;
+
+                                                        }
+                                                }
+                                                $info['video']['pixel_aspect_ratio'] = $info['video']['resolution_x'] / $info['video']['resolution_y'];
+                                        }
+                                        break;
+
+                                // Meta tag
+                                case GETID3_FLV_TAG_META:
+                                        if (!$found_meta) {
+                                                $found_meta = true;
+                                                fseek($this->getid3->fp, -1, SEEK_CUR);
+                                                $datachunk = fread($this->getid3->fp, $DataLength);
+                                                $AMFstream = new AMFStream($datachunk);
+                                                $reader = new AMFReader($AMFstream);
+                                                $eventName = $reader->readData();
+                                                $info['flv']['meta'][$eventName] = $reader->readData();
+                                                unset($reader);
+
+                                                $copykeys = array('framerate'=>'frame_rate', 'width'=>'resolution_x', 'height'=>'resolution_y', 'audiodatarate'=>'bitrate', 'videodatarate'=>'bitrate');
+                                                foreach ($copykeys as $sourcekey => $destkey) {
+                                                        if (isset($info['flv']['meta']['onMetaData'][$sourcekey])) {
+                                                                switch ($sourcekey) {
+                                                                        case 'width':
+                                                                        case 'height':
+                                                                                $info['video'][$destkey] = intval(round($info['flv']['meta']['onMetaData'][$sourcekey]));
+                                                                                break;
+                                                                        case 'audiodatarate':
+                                                                                $info['audio'][$destkey] = getid3_lib::CastAsInt(round($info['flv']['meta']['onMetaData'][$sourcekey] * 1000));
+                                                                                break;
+                                                                        case 'videodatarate':
+                                                                        case 'frame_rate':
+                                                                        default:
+                                                                                $info['video'][$destkey] = $info['flv']['meta']['onMetaData'][$sourcekey];
+                                                                                break;
+                                                                }
+                                                        }
+                                                }
+                                                if (!empty($info['flv']['meta']['onMetaData']['duration'])) {
+                                                        $found_valid_meta_playtime = true;
+                                                }
+                                        }
+                                        break;
+
+                                default:
+                                        // noop
+                                        break;
+                        }
+                        fseek($this->getid3->fp, $NextOffset, SEEK_SET);
+                }
+
+                $info['playtime_seconds'] = $Duration / 1000;
+                if ($info['playtime_seconds'] > 0) {
+                        $info['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $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 (!empty($info['flv']['header']['hasVideo'])) {
+                        $info['video']['codec']      = $this->FLVvideoCodec($info['flv']['video']['videoCodec']);
+                        $info['video']['dataformat'] = 'flv';
+                        $info['video']['lossless']   = false;
+                }
+
+                // Set information from meta
+                if (!empty($info['flv']['meta']['onMetaData']['duration'])) {
+                        $info['playtime_seconds'] = $info['flv']['meta']['onMetaData']['duration'];
+                        $info['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $info['playtime_seconds'];
+                }
+                if (isset($info['flv']['meta']['onMetaData']['audiocodecid'])) {
+                        $info['audio']['codec'] = $this->FLVaudioFormat($info['flv']['meta']['onMetaData']['audiocodecid']);
+                }
+                if (isset($info['flv']['meta']['onMetaData']['videocodecid'])) {
+                        $info['video']['codec'] = $this->FLVvideoCodec($info['flv']['meta']['onMetaData']['videocodecid']);
+                }
+                return true;
+        }
+
+
+        public function FLVaudioFormat($id) {
+                $FLVaudioFormat = array(
+                        0  => 'Linear PCM, platform endian',
+                        1  => 'ADPCM',
+                        2  => 'mp3',
+                        3  => 'Linear PCM, little endian',
+                        4  => 'Nellymoser 16kHz mono',
+                        5  => 'Nellymoser 8kHz mono',
+                        6  => 'Nellymoser',
+                        7  => 'G.711A-law logarithmic PCM',
+                        8  => 'G.711 mu-law logarithmic PCM',
+                        9  => 'reserved',
+                        10 => 'AAC',
+                        11 => false, // unknown?
+                        12 => false, // unknown?
+                        13 => false, // unknown?
+                        14 => 'mp3 8kHz',
+                        15 => 'Device-specific sound',
+                );
+                return (isset($FLVaudioFormat[$id]) ? $FLVaudioFormat[$id] : false);
+        }
+
+        public function FLVaudioRate($id) {
+                $FLVaudioRate = array(
+                        0 =>  5500,
+                        1 => 11025,
+                        2 => 22050,
+                        3 => 44100,
+                );
+                return (isset($FLVaudioRate[$id]) ? $FLVaudioRate[$id] : false);
+        }
+
+        public function FLVaudioBitDepth($id) {
+                $FLVaudioBitDepth = array(
+                        0 =>  8,
+                        1 => 16,
+                );
+                return (isset($FLVaudioBitDepth[$id]) ? $FLVaudioBitDepth[$id] : false);
+        }
+
+        public function FLVvideoCodec($id) {
+                $FLVvideoCodec = array(
+                        GETID3_FLV_VIDEO_H263         => 'Sorenson H.263',
+                        GETID3_FLV_VIDEO_SCREEN       => 'Screen video',
+                        GETID3_FLV_VIDEO_VP6FLV       => 'On2 VP6',
+                        GETID3_FLV_VIDEO_VP6FLV_ALPHA => 'On2 VP6 with alpha channel',
+                        GETID3_FLV_VIDEO_SCREENV2     => 'Screen video v2',
+                        GETID3_FLV_VIDEO_H264         => 'Sorenson H.264',
+                );
+                return (isset($FLVvideoCodec[$id]) ? $FLVvideoCodec[$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 AMFReader(&$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()) {
+                        $data[$key] = $this->readData();
+                }
+                // Mixed array record ends with empty string (0x00 0x00) and 0x09
+                if (($key == '') && ($this->stream->peekByte() == 0x09)) {
+                        // Consume byte
+                        $this->stream->readByte();
+                }
+                return $data;
+        }
+
+        public function readMixedArray() {
+                // Get highest numerical index - ignored
+                $highestIndex = $this->stream->readLong();
+
+                $data = array();
+
+                while ($key = $this->stream->readUTF()) {
+                        if (is_numeric($key)) {
+                                $key = (float) $key;
+                        }
+                        $data[$key] = $this->readData();
+                }
+                // Mixed array record ends with empty string (0x00 0x00) and 0x09
+                if (($key == '') && ($this->stream->peekByte() == 0x09)) {
+                        // Consume byte
+                        $this->stream->readByte();
+                }
+
+                return $data;
+        }
+
+        public function readArray() {
+                $length = $this->stream->readLong();
+                $data = array();
+
+                for ($i = 0; $i < $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();
+        }
+}
+
+class AVCSequenceParameterSetReader {
+        public $sps;
+        public $start = 0;
+        public $currentBytes = 0;
+        public $currentBits = 0;
+        public $width;
+        public $height;
+
+        public function AVCSequenceParameterSetReader($sps) {
+                $this->sps = $sps;
+        }
+
+        public function readData() {
+                $this->skipBits(8);
+                $this->skipBits(8);
+                $profile = $this->getBits(8);   //      read profile
+                $this->skipBits(16);
+                $this->expGolombUe();   //      read sps id
+                if (in_array($profile, array(H264_PROFILE_HIGH, H264_PROFILE_HIGH10, H264_PROFILE_HIGH422, H264_PROFILE_HIGH444, H264_PROFILE_HIGH444_PREDICTIVE))) {
+                        if ($this->expGolombUe() == 3) {
+                                $this->skipBits(1);
+                        }
+                        $this->expGolombUe();
+                        $this->expGolombUe();
+                        $this->skipBits(1);
+                        if ($this->getBit()) {
+                                for ($i = 0; $i < 8; $i++) {
+                                        if ($this->getBit()) {
+                                                $size = $i < 6 ? 16 : 64;
+                                                $lastScale = 8;
+                                                $nextScale = 8;
+                                                for ($j = 0; $j < $size; $j++) {
+                                                        if ($nextScale != 0) {
+                                                                $deltaScale = $this->expGolombUe();
+                                                                $nextScale = ($lastScale + $deltaScale + 256) % 256;
+                                                        }
+                                                        if ($nextScale != 0) {
+                                                                $lastScale = $nextScale;
+                                                        }
+                                                }
+                                        }
+                                }
+                        }
+                }
+                $this->expGolombUe();
+                $pocType = $this->expGolombUe();
+                if ($pocType == 0) {
+                        $this->expGolombUe();
+                } elseif ($pocType == 1) {
+                        $this->skipBits(1);
+                        $this->expGolombSe();
+                        $this->expGolombSe();
+                        $pocCycleLength = $this->expGolombUe();
+                        for ($i = 0; $i < $pocCycleLength; $i++) {
+                                $this->expGolombSe();
+                        }
+                }
+                $this->expGolombUe();
+                $this->skipBits(1);
+                $this->width = ($this->expGolombUe() + 1) * 16;
+                $heightMap = $this->expGolombUe() + 1;
+                $this->height = (2 - $this->getBit()) * $heightMap * 16;
+        }
+
+        public function skipBits($bits) {
+                $newBits = $this->currentBits + $bits;
+                $this->currentBytes += (int)floor($newBits / 8);
+                $this->currentBits = $newBits % 8;
+        }
+
+        public function getBit() {
+                $result = (getid3_lib::BigEndian2Int(substr($this->sps, $this->currentBytes, 1)) >> (7 - $this->currentBits)) & 0x01;
+                $this->skipBits(1);
+                return $result;
+        }
+
+        public function getBits($bits) {
+                $result = 0;
+                for ($i = 0; $i < $bits; $i++) {
+                        $result = ($result << 1) + $this->getBit();
+                }
+                return $result;
+        }
+
+        public function expGolombUe() {
+                $significantBits = 0;
+                $bit = $this->getBit();
+                while ($bit == 0) {
+                        $significantBits++;
+                        $bit = $this->getBit();
+
+                        if ($significantBits > 31) {
+                                // something is broken, this is an emergency escape to prevent infinite loops
+                                return 0;
+                        }
+                }
+                return (1 << $significantBits) + $this->getBits($significantBits) - 1;
+        }
+
+        public function expGolombSe() {
+                $result = $this->expGolombUe();
+                if (($result & 0x01) == 0) {
+                        return -($result >> 1);
+                } else {
+                        return ($result + 1) >> 1;
+                }
+        }
+
+        public function getWidth() {
+                return $this->width;
+        }
+
+        public function getHeight() {
+                return $this->height;
+        }
+}

new file wp-includes/ID3/module.audio-video.matroska.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio-video.matriska.php                             //
+// module for analyzing Matroska containers                    //
+// dependencies: NONE                                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+
+define('EBML_ID_CHAPTERS',                  0x0043A770); // [10][43][A7][70] -- A system to define basic menus and partition data. For more detailed information, look at the Chapters Explanation.
+define('EBML_ID_SEEKHEAD',                  0x014D9B74); // [11][4D][9B][74] -- Contains the position of other level 1 elements.
+define('EBML_ID_TAGS',                      0x0254C367); // [12][54][C3][67] -- Element containing elements specific to Tracks/Chapters. A list of valid tags can be found <http://www.matroska.org/technical/specs/tagging/index.html>.
+define('EBML_ID_INFO',                      0x0549A966); // [15][49][A9][66] -- Contains miscellaneous general information and statistics on the file.
+define('EBML_ID_TRACKS',                    0x0654AE6B); // [16][54][AE][6B] -- A top-level block of information with many tracks described.
+define('EBML_ID_SEGMENT',                   0x08538067); // [18][53][80][67] -- This element contains all other top-level (level 1) elements. Typically a Matroska file is composed of 1 segment.
+define('EBML_ID_ATTACHMENTS',               0x0941A469); // [19][41][A4][69] -- Contain attached files.
+define('EBML_ID_EBML',                      0x0A45DFA3); // [1A][45][DF][A3] -- Set the EBML characteristics of the data to follow. Each EBML document has to start with this.
+define('EBML_ID_CUES',                      0x0C53BB6B); // [1C][53][BB][6B] -- A top-level element to speed seeking access. All entries are local to the segment.
+define('EBML_ID_CLUSTER',                   0x0F43B675); // [1F][43][B6][75] -- The lower level element containing the (monolithic) Block structure.
+define('EBML_ID_LANGUAGE',                    0x02B59C); //     [22][B5][9C] -- Specifies the language of the track in the Matroska languages form.
+define('EBML_ID_TRACKTIMECODESCALE',          0x03314F); //     [23][31][4F] -- The scale to apply on this track to work at normal speed in relation with other tracks (mostly used to adjust video speed when the audio length differs).
+define('EBML_ID_DEFAULTDURATION',             0x03E383); //     [23][E3][83] -- Number of nanoseconds (i.e. not scaled) per frame.
+define('EBML_ID_CODECNAME',                   0x058688); //     [25][86][88] -- A human-readable string specifying the codec.
+define('EBML_ID_CODECDOWNLOADURL',            0x06B240); //     [26][B2][40] -- A URL to download about the codec used.
+define('EBML_ID_TIMECODESCALE',               0x0AD7B1); //     [2A][D7][B1] -- Timecode scale in nanoseconds (1.000.000 means all timecodes in the segment are expressed in milliseconds).
+define('EBML_ID_COLOURSPACE',                 0x0EB524); //     [2E][B5][24] -- Same value as in AVI (32 bits).
+define('EBML_ID_GAMMAVALUE',                  0x0FB523); //     [2F][B5][23] -- Gamma Value.
+define('EBML_ID_CODECSETTINGS',               0x1A9697); //     [3A][96][97] -- A string describing the encoding setting used.
+define('EBML_ID_CODECINFOURL',                0x1B4040); //     [3B][40][40] -- A URL to find information about the codec used.
+define('EBML_ID_PREVFILENAME',                0x1C83AB); //     [3C][83][AB] -- An escaped filename corresponding to the previous segment.
+define('EBML_ID_PREVUID',                     0x1CB923); //     [3C][B9][23] -- A unique ID to identify the previous chained segment (128 bits).
+define('EBML_ID_NEXTFILENAME',                0x1E83BB); //     [3E][83][BB] -- An escaped filename corresponding to the next segment.
+define('EBML_ID_NEXTUID',                     0x1EB923); //     [3E][B9][23] -- A unique ID to identify the next chained segment (128 bits).
+define('EBML_ID_CONTENTCOMPALGO',               0x0254); //         [42][54] -- The compression algorithm used. Algorithms that have been specified so far are:
+define('EBML_ID_CONTENTCOMPSETTINGS',           0x0255); //         [42][55] -- Settings that might be needed by the decompressor. For Header Stripping (ContentCompAlgo=3), the bytes that were removed from the beggining of each frames of the track.
+define('EBML_ID_DOCTYPE',                       0x0282); //         [42][82] -- A string that describes the type of document that follows this EBML header ('matroska' in our case).
+define('EBML_ID_DOCTYPEREADVERSION',            0x0285); //         [42][85] -- The minimum DocType version an interpreter has to support to read this file.
+define('EBML_ID_EBMLVERSION',                   0x0286); //         [42][86] -- The version of EBML parser used to create the file.
+define('EBML_ID_DOCTYPEVERSION',                0x0287); //         [42][87] -- The version of DocType interpreter used to create the file.
+define('EBML_ID_EBMLMAXIDLENGTH',               0x02F2); //         [42][F2] -- The maximum length of the IDs you'll find in this file (4 or less in Matroska).
+define('EBML_ID_EBMLMAXSIZELENGTH',             0x02F3); //         [42][F3] -- The maximum length of the sizes you'll find in this file (8 or less in Matroska). This does not override the element size indicated at the beginning of an element. Elements that have an indicated size which is larger than what is allowed by EBMLMaxSizeLength shall be considered invalid.
+define('EBML_ID_EBMLREADVERSION',               0x02F7); //         [42][F7] -- The minimum EBML version a parser has to support to read this file.
+define('EBML_ID_CHAPLANGUAGE',                  0x037C); //         [43][7C] -- The languages corresponding to the string, in the bibliographic ISO-639-2 form.
+define('EBML_ID_CHAPCOUNTRY',                   0x037E); //         [43][7E] -- The countries corresponding to the string, same 2 octets as in Internet domains.
+define('EBML_ID_SEGMENTFAMILY',                 0x0444); //         [44][44] -- A randomly generated unique ID that all segments related to each other must use (128 bits).
+define('EBML_ID_DATEUTC',                       0x0461); //         [44][61] -- Date of the origin of timecode (value 0), i.e. production date.
+define('EBML_ID_TAGLANGUAGE',                   0x047A); //         [44][7A] -- Specifies the language of the tag specified, in the Matroska languages form.
+define('EBML_ID_TAGDEFAULT',                    0x0484); //         [44][84] -- Indication to know if this is the default/original language to use for the given tag.
+define('EBML_ID_TAGBINARY',                     0x0485); //         [44][85] -- The values of the Tag if it is binary. Note that this cannot be used in the same SimpleTag as TagString.
+define('EBML_ID_TAGSTRING',                     0x0487); //         [44][87] -- The value of the Tag.
+define('EBML_ID_DURATION',                      0x0489); //         [44][89] -- Duration of the segment (based on TimecodeScale).
+define('EBML_ID_CHAPPROCESSPRIVATE',            0x050D); //         [45][0D] -- Some optional data attached to the ChapProcessCodecID information. For ChapProcessCodecID = 1, it is the "DVD level" equivalent.
+define('EBML_ID_CHAPTERFLAGENABLED',            0x0598); //         [45][98] -- Specify wether the chapter is enabled. It can be enabled/disabled by a Control Track. When disabled, the movie should skip all the content between the TimeStart and TimeEnd of this chapter.
+define('EBML_ID_TAGNAME',                       0x05A3); //         [45][A3] -- The name of the Tag that is going to be stored.
+define('EBML_ID_EDITIONENTRY',                  0x05B9); //         [45][B9] -- Contains all information about a segment edition.
+define('EBML_ID_EDITIONUID',                    0x05BC); //         [45][BC] -- A unique ID to identify the edition. It's useful for tagging an edition.
+define('EBML_ID_EDITIONFLAGHIDDEN',             0x05BD); //         [45][BD] -- If an edition is hidden (1), it should not be available to the user interface (but still to Control Tracks).
+define('EBML_ID_EDITIONFLAGDEFAULT',            0x05DB); //         [45][DB] -- If a flag is set (1) the edition should be used as the default one.
+define('EBML_ID_EDITIONFLAGORDERED',            0x05DD); //         [45][DD] -- Specify if the chapters can be defined multiple times and the order to play them is enforced.
+define('EBML_ID_FILEDATA',                      0x065C); //         [46][5C] -- The data of the file.
+define('EBML_ID_FILEMIMETYPE',                  0x0660); //         [46][60] -- MIME type of the file.
+define('EBML_ID_FILENAME',                      0x066E); //         [46][6E] -- Filename of the attached file.
+define('EBML_ID_FILEREFERRAL',                  0x0675); //         [46][75] -- A binary value that a track/codec can refer to when the attachment is needed.
+define('EBML_ID_FILEDESCRIPTION',               0x067E); //         [46][7E] -- A human-friendly name for the attached file.
+define('EBML_ID_FILEUID',                       0x06AE); //         [46][AE] -- Unique ID representing the file, as random as possible.
+define('EBML_ID_CONTENTENCALGO',                0x07E1); //         [47][E1] -- The encryption algorithm used. The value '0' means that the contents have not been encrypted but only signed. Predefined values:
+define('EBML_ID_CONTENTENCKEYID',               0x07E2); //         [47][E2] -- For public key algorithms this is the ID of the public key the the data was encrypted with.
+define('EBML_ID_CONTENTSIGNATURE',              0x07E3); //         [47][E3] -- A cryptographic signature of the contents.
+define('EBML_ID_CONTENTSIGKEYID',               0x07E4); //         [47][E4] -- This is the ID of the private key the data was signed with.
+define('EBML_ID_CONTENTSIGALGO',                0x07E5); //         [47][E5] -- The algorithm used for the signature. A value of '0' means that the contents have not been signed but only encrypted. Predefined values:
+define('EBML_ID_CONTENTSIGHASHALGO',            0x07E6); //         [47][E6] -- The hash algorithm used for the signature. A value of '0' means that the contents have not been signed but only encrypted. Predefined values:
+define('EBML_ID_MUXINGAPP',                     0x0D80); //         [4D][80] -- Muxing application or library ("libmatroska-0.4.3").
+define('EBML_ID_SEEK',                          0x0DBB); //         [4D][BB] -- Contains a single seek entry to an EBML element.
+define('EBML_ID_CONTENTENCODINGORDER',          0x1031); //         [50][31] -- Tells when this modification was used during encoding/muxing starting with 0 and counting upwards. The decoder/demuxer has to start with the highest order number it finds and work its way down. This value has to be unique over all ContentEncodingOrder elements in the segment.
+define('EBML_ID_CONTENTENCODINGSCOPE',          0x1032); //         [50][32] -- A bit field that describes which elements have been modified in this way. Values (big endian) can be OR'ed. Possible values:
+define('EBML_ID_CONTENTENCODINGTYPE',           0x1033); //         [50][33] -- A value describing what kind of transformation has been done. Possible values:
+define('EBML_ID_CONTENTCOMPRESSION',            0x1034); //         [50][34] -- Settings describing the compression used. Must be present if the value of ContentEncodingType is 0 and absent otherwise. Each block must be decompressable even if no previous block is available in order not to prevent seeking.
+define('EBML_ID_CONTENTENCRYPTION',             0x1035); //         [50][35] -- Settings describing the encryption used. Must be present if the value of ContentEncodingType is 1 and absent otherwise.
+define('EBML_ID_CUEREFNUMBER',                  0x135F); //         [53][5F] -- Number of the referenced Block of Track X in the specified Cluster.
+define('EBML_ID_NAME',                          0x136E); //         [53][6E] -- A human-readable track name.
+define('EBML_ID_CUEBLOCKNUMBER',                0x1378); //         [53][78] -- Number of the Block in the specified Cluster.
+define('EBML_ID_TRACKOFFSET',                   0x137F); //         [53][7F] -- A value to add to the Block's Timecode. This can be used to adjust the playback offset of a track.
+define('EBML_ID_SEEKID',                        0x13AB); //         [53][AB] -- The binary ID corresponding to the element name.
+define('EBML_ID_SEEKPOSITION',                  0x13AC); //         [53][AC] -- The position of the element in the segment in octets (0 = first level 1 element).
+define('EBML_ID_STEREOMODE',                    0x13B8); //         [53][B8] -- Stereo-3D video mode.
+define('EBML_ID_OLDSTEREOMODE',                 0x13B9); //         [53][B9] -- Bogus StereoMode value used in old versions of libmatroska. DO NOT USE. (0: mono, 1: right eye, 2: left eye, 3: both eyes).
+define('EBML_ID_PIXELCROPBOTTOM',               0x14AA); //         [54][AA] -- The number of video pixels to remove at the bottom of the image (for HDTV content).
+define('EBML_ID_DISPLAYWIDTH',                  0x14B0); //         [54][B0] -- Width of the video frames to display.
+define('EBML_ID_DISPLAYUNIT',                   0x14B2); //         [54][B2] -- Type of the unit for DisplayWidth/Height (0: pixels, 1: centimeters, 2: inches).
+define('EBML_ID_ASPECTRATIOTYPE',               0x14B3); //         [54][B3] -- Specify the possible modifications to the aspect ratio (0: free resizing, 1: keep aspect ratio, 2: fixed).
+define('EBML_ID_DISPLAYHEIGHT',                 0x14BA); //         [54][BA] -- Height of the video frames to display.
+define('EBML_ID_PIXELCROPTOP',                  0x14BB); //         [54][BB] -- The number of video pixels to remove at the top of the image.
+define('EBML_ID_PIXELCROPLEFT',                 0x14CC); //         [54][CC] -- The number of video pixels to remove on the left of the image.
+define('EBML_ID_PIXELCROPRIGHT',                0x14DD); //         [54][DD] -- The number of video pixels to remove on the right of the image.
+define('EBML_ID_FLAGFORCED',                    0x15AA); //         [55][AA] -- Set if that track MUST be used during playback. There can be many forced track for a kind (audio, video or subs), the player should select the one which language matches the user preference or the default + forced track. Overlay MAY happen between a forced and non-forced track of the same kind.
+define('EBML_ID_MAXBLOCKADDITIONID',            0x15EE); //         [55][EE] -- The maximum value of BlockAddID. A value 0 means there is no BlockAdditions for this track.
+define('EBML_ID_WRITINGAPP',                    0x1741); //         [57][41] -- Writing application ("mkvmerge-0.3.3").
+define('EBML_ID_CLUSTERSILENTTRACKS',           0x1854); //         [58][54] -- The list of tracks that are not used in that part of the stream. It is useful when using overlay tracks on seeking. Then you should decide what track to use.
+define('EBML_ID_CLUSTERSILENTTRACKNUMBER',      0x18D7); //         [58][D7] -- One of the track number that are not used from now on in the stream. It could change later if not specified as silent in a further Cluster.
+define('EBML_ID_ATTACHEDFILE',                  0x21A7); //         [61][A7] -- An attached file.
+define('EBML_ID_CONTENTENCODING',               0x2240); //         [62][40] -- Settings for one content encoding like compression or encryption.
+define('EBML_ID_BITDEPTH',                      0x2264); //         [62][64] -- Bits per sample, mostly used for PCM.
+define('EBML_ID_CODECPRIVATE',                  0x23A2); //         [63][A2] -- Private data only known to the codec.
+define('EBML_ID_TARGETS',                       0x23C0); //         [63][C0] -- Contain all UIDs where the specified meta data apply. It is void to describe everything in the segment.
+define('EBML_ID_CHAPTERPHYSICALEQUIV',          0x23C3); //         [63][C3] -- Specify the physical equivalent of this ChapterAtom like "DVD" (60) or "SIDE" (50), see complete list of values.
+define('EBML_ID_TAGCHAPTERUID',                 0x23C4); //         [63][C4] -- A unique ID to identify the Chapter(s) the tags belong to. If the value is 0 at this level, the tags apply to all chapters in the Segment.
+define('EBML_ID_TAGTRACKUID',                   0x23C5); //         [63][C5] -- A unique ID to identify the Track(s) the tags belong to. If the value is 0 at this level, the tags apply to all tracks in the Segment.
+define('EBML_ID_TAGATTACHMENTUID',              0x23C6); //         [63][C6] -- A unique ID to identify the Attachment(s) the tags belong to. If the value is 0 at this level, the tags apply to all the attachments in the Segment.
+define('EBML_ID_TAGEDITIONUID',                 0x23C9); //         [63][C9] -- A unique ID to identify the EditionEntry(s) the tags belong to. If the value is 0 at this level, the tags apply to all editions in the Segment.
+define('EBML_ID_TARGETTYPE',                    0x23CA); //         [63][CA] -- An informational string that can be used to display the logical level of the target like "ALBUM", "TRACK", "MOVIE", "CHAPTER", etc (see TargetType).
+define('EBML_ID_TRACKTRANSLATE',                0x2624); //         [66][24] -- The track identification for the given Chapter Codec.
+define('EBML_ID_TRACKTRANSLATETRACKID',         0x26A5); //         [66][A5] -- The binary value used to represent this track in the chapter codec data. The format depends on the ChapProcessCodecID used.
+define('EBML_ID_TRACKTRANSLATECODEC',           0x26BF); //         [66][BF] -- The chapter codec using this ID (0: Matroska Script, 1: DVD-menu).
+define('EBML_ID_TRACKTRANSLATEEDITIONUID',      0x26FC); //         [66][FC] -- Specify an edition UID on which this translation applies. When not specified, it means for all editions found in the segment.
+define('EBML_ID_SIMPLETAG',                     0x27C8); //         [67][C8] -- Contains general information about the target.
+define('EBML_ID_TARGETTYPEVALUE',               0x28CA); //         [68][CA] -- A number to indicate the logical level of the target (see TargetType).
+define('EBML_ID_CHAPPROCESSCOMMAND',            0x2911); //         [69][11] -- Contains all the commands associated to the Atom.
+define('EBML_ID_CHAPPROCESSTIME',               0x2922); //         [69][22] -- Defines when the process command should be handled (0: during the whole chapter, 1: before starting playback, 2: after playback of the chapter).
+define('EBML_ID_CHAPTERTRANSLATE',              0x2924); //         [69][24] -- A tuple of corresponding ID used by chapter codecs to represent this segment.
+define('EBML_ID_CHAPPROCESSDATA',               0x2933); //         [69][33] -- Contains the command information. The data should be interpreted depending on the ChapProcessCodecID value. For ChapProcessCodecID = 1, the data correspond to the binary DVD cell pre/post commands.
+define('EBML_ID_CHAPPROCESS',                   0x2944); //         [69][44] -- Contains all the commands associated to the Atom.
+define('EBML_ID_CHAPPROCESSCODECID',            0x2955); //         [69][55] -- Contains the type of the codec used for the processing. A value of 0 means native Matroska processing (to be defined), a value of 1 means the DVD command set is used. More codec IDs can be added later.
+define('EBML_ID_CHAPTERTRANSLATEID',            0x29A5); //         [69][A5] -- The binary value used to represent this segment in the chapter codec data. The format depends on the ChapProcessCodecID used.
+define('EBML_ID_CHAPTERTRANSLATECODEC',         0x29BF); //         [69][BF] -- The chapter codec using this ID (0: Matroska Script, 1: DVD-menu).
+define('EBML_ID_CHAPTERTRANSLATEEDITIONUID',    0x29FC); //         [69][FC] -- Specify an edition UID on which this correspondance applies. When not specified, it means for all editions found in the segment.
+define('EBML_ID_CONTENTENCODINGS',              0x2D80); //         [6D][80] -- Settings for several content encoding mechanisms like compression or encryption.
+define('EBML_ID_MINCACHE',                      0x2DE7); //         [6D][E7] -- The minimum number of frames a player should be able to cache during playback. If set to 0, the reference pseudo-cache system is not used.
+define('EBML_ID_MAXCACHE',                      0x2DF8); //         [6D][F8] -- The maximum cache size required to store referenced frames in and the current frame. 0 means no cache is needed.
+define('EBML_ID_CHAPTERSEGMENTUID',             0x2E67); //         [6E][67] -- A segment to play in place of this chapter. Edition ChapterSegmentEditionUID should be used for this segment, otherwise no edition is used.
+define('EBML_ID_CHAPTERSEGMENTEDITIONUID',      0x2EBC); //         [6E][BC] -- The edition to play from the segment linked in ChapterSegmentUID.
+define('EBML_ID_TRACKOVERLAY',                  0x2FAB); //         [6F][AB] -- Specify that this track is an overlay track for the Track specified (in the u-integer). That means when this track has a gap (see SilentTracks) the overlay track should be used instead. The order of multiple TrackOverlay matters, the first one is the one that should be used. If not found it should be the second, etc.
+define('EBML_ID_TAG',                           0x3373); //         [73][73] -- Element containing elements specific to Tracks/Chapters.
+define('EBML_ID_SEGMENTFILENAME',               0x3384); //         [73][84] -- A filename corresponding to this segment.
+define('EBML_ID_SEGMENTUID',                    0x33A4); //         [73][A4] -- A randomly generated unique ID to identify the current segment between many others (128 bits).
+define('EBML_ID_CHAPTERUID',                    0x33C4); //         [73][C4] -- A unique ID to identify the Chapter.
+define('EBML_ID_TRACKUID',                      0x33C5); //         [73][C5] -- A unique ID to identify the Track. This should be kept the same when making a direct stream copy of the Track to another file.
+define('EBML_ID_ATTACHMENTLINK',                0x3446); //         [74][46] -- The UID of an attachment that is used by this codec.
+define('EBML_ID_CLUSTERBLOCKADDITIONS',         0x35A1); //         [75][A1] -- Contain additional blocks to complete the main one. An EBML parser that has no knowledge of the Block structure could still see and use/skip these data.
+define('EBML_ID_CHANNELPOSITIONS',              0x347B); //         [7D][7B] -- Table of horizontal angles for each successive channel, see appendix.
+define('EBML_ID_OUTPUTSAMPLINGFREQUENCY',       0x38B5); //         [78][B5] -- Real output sampling frequency in Hz (used for SBR techniques).
+define('EBML_ID_TITLE',                         0x3BA9); //         [7B][A9] -- General name of the segment.
+define('EBML_ID_CHAPTERDISPLAY',                  0x00); //             [80] -- Contains all possible strings to use for the chapter display.
+define('EBML_ID_TRACKTYPE',                       0x03); //             [83] -- A set of track types coded on 8 bits (1: video, 2: audio, 3: complex, 0x10: logo, 0x11: subtitle, 0x12: buttons, 0x20: control).
+define('EBML_ID_CHAPSTRING',                      0x05); //             [85] -- Contains the string to use as the chapter atom.
+define('EBML_ID_CODECID',                         0x06); //             [86] -- An ID corresponding to the codec, see the codec page for more info.
+define('EBML_ID_FLAGDEFAULT',                     0x08); //             [88] -- Set if that track (audio, video or subs) SHOULD be used if no language found matches the user preference.
+define('EBML_ID_CHAPTERTRACKNUMBER',              0x09); //             [89] -- UID of the Track to apply this chapter too. In the absense of a control track, choosing this chapter will select the listed Tracks and deselect unlisted tracks. Absense of this element indicates that the Chapter should be applied to any currently used Tracks.
+define('EBML_ID_CLUSTERSLICES',                   0x0E); //             [8E] -- Contains slices description.
+define('EBML_ID_CHAPTERTRACK',                    0x0F); //             [8F] -- List of tracks on which the chapter applies. If this element is not present, all tracks apply
+define('EBML_ID_CHAPTERTIMESTART',                0x11); //             [91] -- Timecode of the start of Chapter (not scaled).
+define('EBML_ID_CHAPTERTIMEEND',                  0x12); //             [92] -- Timecode of the end of Chapter (timecode excluded, not scaled).
+define('EBML_ID_CUEREFTIME',                      0x16); //             [96] -- Timecode of the referenced Block.
+define('EBML_ID_CUEREFCLUSTER',                   0x17); //             [97] -- Position of the Cluster containing the referenced Block.
+define('EBML_ID_CHAPTERFLAGHIDDEN',               0x18); //             [98] -- If a chapter is hidden (1), it should not be available to the user interface (but still to Control Tracks).
+define('EBML_ID_FLAGINTERLACED',                  0x1A); //             [9A] -- Set if the video is interlaced.
+define('EBML_ID_CLUSTERBLOCKDURATION',            0x1B); //             [9B] -- The duration of the Block (based on TimecodeScale). This element is mandatory when DefaultDuration is set for the track. When not written and with no DefaultDuration, the value is assumed to be the difference between the timecode of this Block and the timecode of the next Block in "display" order (not coding order). This element can be useful at the end of a Track (as there is not other Block available), or when there is a break in a track like for subtitle tracks.
+define('EBML_ID_FLAGLACING',                      0x1C); //             [9C] -- Set if the track may contain blocks using lacing.
+define('EBML_ID_CHANNELS',                        0x1F); //             [9F] -- Numbers of channels in the track.
+define('EBML_ID_CLUSTERBLOCKGROUP',               0x20); //             [A0] -- Basic container of information containing a single Block or BlockVirtual, and information specific to that Block/VirtualBlock.
+define('EBML_ID_CLUSTERBLOCK',                    0x21); //             [A1] -- Block containing the actual data to be rendered and a timecode relative to the Cluster Timecode.
+define('EBML_ID_CLUSTERBLOCKVIRTUAL',             0x22); //             [A2] -- A Block with no data. It must be stored in the stream at the place the real Block should be in display order.
+define('EBML_ID_CLUSTERSIMPLEBLOCK',              0x23); //             [A3] -- Similar to Block but without all the extra information, mostly used to reduced overhead when no extra feature is needed.
+define('EBML_ID_CLUSTERCODECSTATE',               0x24); //             [A4] -- The new codec state to use. Data interpretation is private to the codec. This information should always be referenced by a seek entry.
+define('EBML_ID_CLUSTERBLOCKADDITIONAL',          0x25); //             [A5] -- Interpreted by the codec as it wishes (using the BlockAddID).
+define('EBML_ID_CLUSTERBLOCKMORE',                0x26); //             [A6] -- Contain the BlockAdditional and some parameters.
+define('EBML_ID_CLUSTERPOSITION',                 0x27); //             [A7] -- Position of the Cluster in the segment (0 in live broadcast streams). It might help to resynchronise offset on damaged streams.
+define('EBML_ID_CODECDECODEALL',                  0x2A); //             [AA] -- The codec can decode potentially damaged data.
+define('EBML_ID_CLUSTERPREVSIZE',                 0x2B); //             [AB] -- Size of the previous Cluster, in octets. Can be useful for backward playing.
+define('EBML_ID_TRACKENTRY',                      0x2E); //             [AE] -- Describes a track with all elements.
+define('EBML_ID_CLUSTERENCRYPTEDBLOCK',           0x2F); //             [AF] -- Similar to SimpleBlock but the data inside the Block are Transformed (encrypt and/or signed).
+define('EBML_ID_PIXELWIDTH',                      0x30); //             [B0] -- Width of the encoded video frames in pixels.
+define('EBML_ID_CUETIME',                         0x33); //             [B3] -- Absolute timecode according to the segment time base.
+define('EBML_ID_SAMPLINGFREQUENCY',               0x35); //             [B5] -- Sampling frequency in Hz.
+define('EBML_ID_CHAPTERATOM',                     0x36); //             [B6] -- Contains the atom information to use as the chapter atom (apply to all tracks).
+define('EBML_ID_CUETRACKPOSITIONS',               0x37); //             [B7] -- Contain positions for different tracks corresponding to the timecode.
+define('EBML_ID_FLAGENABLED',                     0x39); //             [B9] -- Set if the track is used.
+define('EBML_ID_PIXELHEIGHT',                     0x3A); //             [BA] -- Height of the encoded video frames in pixels.
+define('EBML_ID_CUEPOINT',                        0x3B); //             [BB] -- Contains all information relative to a seek point in the segment.
+define('EBML_ID_CRC32',                           0x3F); //             [BF] -- The CRC is computed on all the data of the Master element it's in, regardless of its position. It's recommended to put the CRC value at the beggining of the Master element for easier reading. All level 1 elements should include a CRC-32.
+define('EBML_ID_CLUSTERBLOCKADDITIONID',          0x4B); //             [CB] -- The ID of the BlockAdditional element (0 is the main Block).
+define('EBML_ID_CLUSTERLACENUMBER',               0x4C); //             [CC] -- The reverse number of the frame in the lace (0 is the last frame, 1 is the next to last, etc). While there are a few files in the wild with this element, it is no longer in use and has been deprecated. Being able to interpret this element is not required for playback.
+define('EBML_ID_CLUSTERFRAMENUMBER',              0x4D); //             [CD] -- The number of the frame to generate from this lace with this delay (allow you to generate many frames from the same Block/Frame).
+define('EBML_ID_CLUSTERDELAY',                    0x4E); //             [CE] -- The (scaled) delay to apply to the element.
+define('EBML_ID_CLUSTERDURATION',                 0x4F); //             [CF] -- The (scaled) duration to apply to the element.
+define('EBML_ID_TRACKNUMBER',                     0x57); //             [D7] -- The track number as used in the Block Header (using more than 127 tracks is not encouraged, though the design allows an unlimited number).
+define('EBML_ID_CUEREFERENCE',                    0x5B); //             [DB] -- The Clusters containing the required referenced Blocks.
+define('EBML_ID_VIDEO',                           0x60); //             [E0] -- Video settings.
+define('EBML_ID_AUDIO',                           0x61); //             [E1] -- Audio settings.
+define('EBML_ID_CLUSTERTIMESLICE',                0x68); //             [E8] -- Contains extra time information about the data contained in the Block. While there are a few files in the wild with this element, it is no longer in use and has been deprecated. Being able to interpret this element is not required for playback.
+define('EBML_ID_CUECODECSTATE',                   0x6A); //             [EA] -- The position of the Codec State corresponding to this Cue element. 0 means that the data is taken from the initial Track Entry.
+define('EBML_ID_CUEREFCODECSTATE',                0x6B); //             [EB] -- The position of the Codec State corresponding to this referenced element. 0 means that the data is taken from the initial Track Entry.
+define('EBML_ID_VOID',                            0x6C); //             [EC] -- Used to void damaged data, to avoid unexpected behaviors when using damaged data. The content is discarded. Also used to reserve space in a sub-element for later use.
+define('EBML_ID_CLUSTERTIMECODE',                 0x67); //             [E7] -- Absolute timecode of the cluster (based on TimecodeScale).
+define('EBML_ID_CLUSTERBLOCKADDID',               0x6E); //             [EE] -- An ID to identify the BlockAdditional level.
+define('EBML_ID_CUECLUSTERPOSITION',              0x71); //             [F1] -- The position of the Cluster containing the required Block.
+define('EBML_ID_CUETRACK',                        0x77); //             [F7] -- The track for which a position is given.
+define('EBML_ID_CLUSTERREFERENCEPRIORITY',        0x7A); //             [FA] -- This frame is referenced and has the specified cache priority. In cache only a frame of the same or higher priority can replace this frame. A value of 0 means the frame is not referenced.
+define('EBML_ID_CLUSTERREFERENCEBLOCK',           0x7B); //             [FB] -- Timecode of another frame used as a reference (ie: B or P frame). The timecode is relative to the block it's attached to.
+define('EBML_ID_CLUSTERREFERENCEVIRTUAL',         0x7D); //             [FD] -- Relative position of the data that should be in position of the virtual block.
+
+
+/**
+* @tutorial http://www.matroska.org/technical/specs/index.html
+*
+* @todo Rewrite EBML parser to reduce it's size and honor default element values
+* @todo After rewrite implement stream size calculation, that will provide additional useful info and enable AAC/FLAC audio bitrate detection
+*/
+class getid3_matroska extends getid3_handler
+{
+        // public options
+        public static $hide_clusters    = true;  // if true, do not return information about CLUSTER chunks, since there's a lot of them and they're not usually useful [default: TRUE]
+    public static $parse_whole_file = false; // true to parse the whole file, not only header [default: FALSE]
+
+    // private parser settings/placeholders
+    private $EBMLbuffer        = '';
+    private $EBMLbuffer_offset = 0;
+    private $EBMLbuffer_length = 0;
+    private $current_offset    = 0;
+    private $unuseful_elements = array(EBML_ID_CRC32, EBML_ID_VOID);
+
+        public function Analyze()
+        {
+                $info = &$this->getid3->info;
+
+                // parse container
+                try {
+                        $this->parseEBML($info);
+                } catch (Exception $e) {
+                        $info['error'][] = 'EBML parser: '.$e->getMessage();
+                }
+
+                // calculate playtime
+                if (isset($info['matroska']['info']) && is_array($info['matroska']['info'])) {
+                        foreach ($info['matroska']['info'] as $key => $infoarray) {
+                                if (isset($infoarray['Duration'])) {
+                                        // TimecodeScale is how many nanoseconds each Duration unit is
+                                        $info['playtime_seconds'] = $infoarray['Duration'] * ((isset($infoarray['TimecodeScale']) ? $infoarray['TimecodeScale'] : 1000000) / 1000000000);
+                                        break;
+                                }
+                        }
+                }
+
+                // extract tags
+                if (isset($info['matroska']['tags']) && is_array($info['matroska']['tags'])) {
+                        foreach ($info['matroska']['tags'] as $key => $infoarray) {
+                                $this->ExtractCommentsSimpleTag($infoarray);
+                        }
+                }
+
+                // process tracks
+                if (isset($info['matroska']['tracks']['tracks']) && is_array($info['matroska']['tracks']['tracks'])) {
+                        foreach ($info['matroska']['tracks']['tracks'] as $key => $trackarray) {
+
+                                $track_info = array();
+                                $track_info['dataformat'] = self::CodecIDtoCommonName($trackarray['CodecID']);
+                                $track_info['default'] = (isset($trackarray['FlagDefault']) ? $trackarray['FlagDefault'] : true);
+                                if (isset($trackarray['Name'])) { $track_info['name'] = $trackarray['Name']; }
+
+                                switch ($trackarray['TrackType']) {
+
+                                        case 1: // Video
+                                                $track_info['resolution_x'] = $trackarray['PixelWidth'];
+                                                $track_info['resolution_y'] = $trackarray['PixelHeight'];
+                                                $track_info['display_unit'] = self::displayUnit(isset($trackarray['DisplayUnit']) ? $trackarray['DisplayUnit'] : 0);
+                                                $track_info['display_x']    = (isset($trackarray['DisplayWidth']) ? $trackarray['DisplayWidth'] : $trackarray['PixelWidth']);
+                                                $track_info['display_y']    = (isset($trackarray['DisplayHeight']) ? $trackarray['DisplayHeight'] : $trackarray['PixelHeight']);
+
+                                                if (isset($trackarray['PixelCropBottom'])) { $track_info['crop_bottom'] = $trackarray['PixelCropBottom']; }
+                                                if (isset($trackarray['PixelCropTop']))    { $track_info['crop_top']    = $trackarray['PixelCropTop']; }
+                                                if (isset($trackarray['PixelCropLeft']))   { $track_info['crop_left']   = $trackarray['PixelCropLeft']; }
+                                                if (isset($trackarray['PixelCropRight']))  { $track_info['crop_right']  = $trackarray['PixelCropRight']; }
+                                                if (isset($trackarray['DefaultDuration'])) { $track_info['frame_rate']  = round(1000000000 / $trackarray['DefaultDuration'], 3); }
+                                                if (isset($trackarray['CodecName']))       { $track_info['codec']       = $trackarray['CodecName']; }
+
+                                                switch ($trackarray['CodecID']) {
+                                                        case 'V_MS/VFW/FOURCC':
+                                                                if (!getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio-video.riff.php', __FILE__, false)) {
+                                                                        $this->warning('Unable to parse codec private data ['.basename(__FILE__).':'.__LINE__.'] because cannot include "module.audio-video.riff.php"');
+                                                                        break;
+                                                                }
+                                                                $parsed = getid3_riff::ParseBITMAPINFOHEADER($trackarray['CodecPrivate']);
+                                                                $track_info['codec'] = getid3_riff::fourccLookup($parsed['fourcc']);
+                                                                $info['matroska']['track_codec_parsed'][$trackarray['TrackNumber']] = $parsed;
+                                                                break;
+
+                                                        /*case 'V_MPEG4/ISO/AVC':
+                                                                $h264['profile']    = getid3_lib::BigEndian2Int(substr($trackarray['CodecPrivate'], 1, 1));
+                                                                $h264['level']      = getid3_lib::BigEndian2Int(substr($trackarray['CodecPrivate'], 3, 1));
+                                                                $rn                 = getid3_lib::BigEndian2Int(substr($trackarray['CodecPrivate'], 4, 1));
+                                                                $h264['NALUlength'] = ($rn & 3) + 1;
+                                                                $rn                 = getid3_lib::BigEndian2Int(substr($trackarray['CodecPrivate'], 5, 1));
+                                                                $nsps               = ($rn & 31);
+                                                                $offset             = 6;
+                                                                for ($i = 0; $i < $nsps; $i ++) {
+                                                                        $length        = getid3_lib::BigEndian2Int(substr($trackarray['CodecPrivate'], $offset, 2));
+                                                                        $h264['SPS'][] = substr($trackarray['CodecPrivate'], $offset + 2, $length);
+                                                                        $offset       += 2 + $length;
+                                                                }
+                                                                $npps               = getid3_lib::BigEndian2Int(substr($trackarray['CodecPrivate'], $offset, 1));
+                                                                $offset            += 1;
+                                                                for ($i = 0; $i < $npps; $i ++) {
+                                                                        $length        = getid3_lib::BigEndian2Int(substr($trackarray['CodecPrivate'], $offset, 2));
+                                                                        $h264['PPS'][] = substr($trackarray['CodecPrivate'], $offset + 2, $length);
+                                                                        $offset       += 2 + $length;
+                                                                }
+                                                                $info['matroska']['track_codec_parsed'][$trackarray['TrackNumber']] = $h264;
+                                                                break;*/
+                                                }
+
+                                                $info['video']['streams'][] = $track_info;
+                                                break;
+
+                                        case 2: // Audio
+                                                $track_info['sample_rate'] = (isset($trackarray['SamplingFrequency']) ? $trackarray['SamplingFrequency'] : 8000.0);
+                                                $track_info['channels']    = (isset($trackarray['Channels']) ? $trackarray['Channels'] : 1);
+                                                $track_info['language']    = (isset($trackarray['Language']) ? $trackarray['Language'] : 'eng');
+                                                if (isset($trackarray['BitDepth']))  { $track_info['bits_per_sample'] = $trackarray['BitDepth']; }
+                                                if (isset($trackarray['CodecName'])) { $track_info['codec']           = $trackarray['CodecName']; }
+
+                                                switch ($trackarray['CodecID']) {
+                                                        case 'A_PCM/INT/LIT':
+                                                        case 'A_PCM/INT/BIG':
+                                                                $track_info['bitrate'] = $trackarray['SamplingFrequency'] * $trackarray['Channels'] * $trackarray['BitDepth'];
+                                                                break;
+
+                                                        case 'A_AC3':
+                                                        case 'A_DTS':
+                                                        case 'A_MPEG/L3':
+                                                        case 'A_MPEG/L2':
+                                                        case 'A_FLAC':
+                                                                if (!getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.'.($track_info['dataformat'] == 'mp2' ? 'mp3' : $track_info['dataformat']).'.php', __FILE__, false)) {
+                                                                        $this->warning('Unable to parse audio data ['.basename(__FILE__).':'.__LINE__.'] because cannot include "module.audio.'.$track_info['dataformat'].'.php"');
+                                                                        break;
+                                                                }
+
+                                                                if (!isset($info['matroska']['track_data_offsets'][$trackarray['TrackNumber']])) {
+                                                                        $this->warning('Unable to parse audio data ['.basename(__FILE__).':'.__LINE__.'] because $info[matroska][track_data_offsets]['.$trackarray['TrackNumber'].'] not set');
+                                                                        break;
+                                                                }
+
+                                                                // create temp instance
+                                                                $getid3_temp = new getID3();
+                                                                if ($track_info['dataformat'] != 'flac') {
+                                                                        $getid3_temp->openfile($this->getid3->filename);
+                                                                }
+                                                                $getid3_temp->info['avdataoffset'] = $info['matroska']['track_data_offsets'][$trackarray['TrackNumber']]['offset'];
+                                                                if ($track_info['dataformat'][0] == 'm' || $track_info['dataformat'] == 'flac') {
+                                                                        $getid3_temp->info['avdataend'] = $info['matroska']['track_data_offsets'][$trackarray['TrackNumber']]['offset'] + $info['matroska']['track_data_offsets'][$trackarray['TrackNumber']]['length'];
+                                                                }
+
+                                                                // analyze
+                                                                $class = 'getid3_'.($track_info['dataformat'] == 'mp2' ? 'mp3' : $track_info['dataformat']);
+                                                                $header_data_key = $track_info['dataformat'][0] == 'm' ? 'mpeg' : $track_info['dataformat'];
+                                                                $getid3_audio = new $class($getid3_temp, __CLASS__);
+                                                                if ($track_info['dataformat'] == 'flac') {
+                                                                        $getid3_audio->AnalyzeString($trackarray['CodecPrivate']);
+                                                                }
+                                                                else {
+                                                                        $getid3_audio->Analyze();
+                                                                }
+                                                                if (!empty($getid3_temp->info[$header_data_key])) {
+                                                                        $info['matroska']['track_codec_parsed'][$trackarray['TrackNumber']] = $getid3_temp->info[$header_data_key];
+                                                                        if (isset($getid3_temp->info['audio']) && is_array($getid3_temp->info['audio'])) {
+                                                                                foreach ($getid3_temp->info['audio'] as $key => $value) {
+                                                                                        $track_info[$key] = $value;
+                                                                                }
+                                                                        }
+                                                                }
+                                                                else {
+                                                                        $this->warning('Unable to parse audio data ['.basename(__FILE__).':'.__LINE__.'] because '.$class.'::Analyze() failed at offset '.$getid3_temp->info['avdataoffset']);
+                                                                }
+
+                                                                // copy errors and warnings
+                                                                if (!empty($getid3_temp->info['error'])) {
+                                                                        foreach ($getid3_temp->info['error'] as $newerror) {
+                                                                                $this->warning($class.'() says: ['.$newerror.']');
+                                                                        }
+                                                                }
+                                                                if (!empty($getid3_temp->info['warning'])) {
+                                                                        foreach ($getid3_temp->info['warning'] as $newerror) {
+                                                                                if ($track_info['dataformat'] == 'mp3' && preg_match('/^Probable truncated file: expecting \d+ bytes of audio data, only found \d+ \(short by \d+ bytes\)$/', $newerror)) {
+                                                                                        // LAME/Xing header is probably set, but audio data is chunked into Matroska file and near-impossible to verify if audio stream is complete, so ignore useless warning
+                                                                                        continue;
+                                                                                }
+                                                                                $this->warning($class.'() says: ['.$newerror.']');
+                                                                        }
+                                                                }
+                                                                unset($getid3_temp, $getid3_audio);
+                                                                break;
+
+                                                        case 'A_AAC':
+                                                        case 'A_AAC/MPEG2/LC':
+                                                        case 'A_AAC/MPEG2/LC/SBR':
+                                                        case 'A_AAC/MPEG4/LC':
+                                                        case 'A_AAC/MPEG4/LC/SBR':
+                                                            $this->warning($trackarray['CodecID'].' audio data contains no header, audio/video bitrates can\'t be calculated');
+                                                                break;
+
+                                                        case 'A_VORBIS':
+                                                                if (!isset($trackarray['CodecPrivate'])) {
+                                                                        $this->warning('Unable to parse audio data ['.basename(__FILE__).':'.__LINE__.'] because CodecPrivate data not set');
+                                                                        break;
+                                                                }
+                                                                $vorbis_offset = strpos($trackarray['CodecPrivate'], 'vorbis', 1);
+                                                                if ($vorbis_offset === false) {
+                                                                        $this->warning('Unable to parse audio data ['.basename(__FILE__).':'.__LINE__.'] because CodecPrivate data does not contain "vorbis" keyword');
+                                                                        break;
+                                                                }
+                                                                $vorbis_offset -= 1;
+
+                                                                if (!getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.ogg.php', __FILE__, false)) {
+                                                                        $this->warning('Unable to parse audio data ['.basename(__FILE__).':'.__LINE__.'] because cannot include "module.audio.ogg.php"');
+                                                                        break;
+                                                                }
+
+                                                                // create temp instance
+                                                                $getid3_temp = new getID3();
+
+                                                                // analyze
+                                                                $getid3_ogg = new getid3_ogg($getid3_temp);
+                                                                $oggpageinfo['page_seqno'] = 0;
+                                                                $getid3_ogg->ParseVorbisPageHeader($trackarray['CodecPrivate'], $vorbis_offset, $oggpageinfo);
+                                                                if (!empty($getid3_temp->info['ogg'])) {
+                                                                        $info['matroska']['track_codec_parsed'][$trackarray['TrackNumber']] = $getid3_temp->info['ogg'];
+                                                                        if (isset($getid3_temp->info['audio']) && is_array($getid3_temp->info['audio'])) {
+                                                                                foreach ($getid3_temp->info['audio'] as $key => $value) {
+                                                                                        $track_info[$key] = $value;
+                                                                                }
+                                                                        }
+                                                                }
+
+                                                                // copy errors and warnings
+                                                                if (!empty($getid3_temp->info['error'])) {
+                                                                        foreach ($getid3_temp->info['error'] as $newerror) {
+                                                                                $this->warning('getid3_ogg() says: ['.$newerror.']');
+                                                                        }
+                                                                }
+                                                                if (!empty($getid3_temp->info['warning'])) {
+                                                                        foreach ($getid3_temp->info['warning'] as $newerror) {
+                                                                                $this->warning('getid3_ogg() says: ['.$newerror.']');
+                                                                        }
+                                                                }
+
+                                                                if (!empty($getid3_temp->info['ogg']['bitrate_nominal'])) {
+                                                                        $track_info['bitrate'] = $getid3_temp->info['ogg']['bitrate_nominal'];
+                                                                }
+                                                                unset($getid3_temp, $getid3_ogg, $oggpageinfo, $vorbis_offset);
+                                                                break;
+
+                                                        case 'A_MS/ACM':
+                                                                if (!getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio-video.riff.php', __FILE__, false)) {
+                                                                        $this->warning('Unable to parse audio data ['.basename(__FILE__).':'.__LINE__.'] because cannot include "module.audio-video.riff.php"');
+                                                                        break;
+                                                                }
+
+                                                                $parsed = getid3_riff::parseWAVEFORMATex($trackarray['CodecPrivate']);
+                                                                foreach ($parsed as $key => $value) {
+                                                                        if ($key != 'raw') {
+                                                                                $track_info[$key] = $value;
+                                                                        }
+                                                                }
+                                                                $info['matroska']['track_codec_parsed'][$trackarray['TrackNumber']] = $parsed;
+                                                                break;
+
+                                                        default:
+                                                                $this->warning('Unhandled audio type "'.(isset($trackarray['CodecID']) ? $trackarray['CodecID'] : '').'"');
+                                                }
+
+                                                $info['audio']['streams'][] = $track_info;
+                                                break;
+                                }
+                        }
+
+                        if (!empty($info['video']['streams'])) {
+                                $info['video'] = self::getDefaultStreamInfo($info['video']['streams']);
+                        }
+                        if (!empty($info['audio']['streams'])) {
+                                $info['audio'] = self::getDefaultStreamInfo($info['audio']['streams']);
+                        }
+                }
+
+                // process attachments
+                if (isset($info['matroska']['attachments']) && $this->getid3->option_save_attachments !== getID3::ATTACHMENTS_NONE) {
+                        foreach ($info['matroska']['attachments'] as $i => $entry) {
+                                if (strpos($entry['FileMimeType'], 'image/') === 0 && !empty($entry['FileData'])) {
+                                        $info['matroska']['comments']['picture'][] = array('data' => $entry['FileData'], 'image_mime' => $entry['FileMimeType'], 'filename' => $entry['FileName']);
+                                }
+                        }
+                }
+
+        // determine mime type
+                if (!empty($info['video']['streams'])) {
+                        $info['mime_type'] = ($info['matroska']['doctype'] == 'webm' ? 'video/webm' : 'video/x-matroska');
+                } elseif (!empty($info['audio']['streams'])) {
+                        $info['mime_type'] = ($info['matroska']['doctype'] == 'webm' ? 'audio/webm' : 'audio/x-matroska');
+                } elseif (isset($info['mime_type'])) {
+                        unset($info['mime_type']);
+                }
+
+                return true;
+        }
+
+    private function parseEBML(&$info) {
+                // http://www.matroska.org/technical/specs/index.html#EBMLBasics
+                $this->current_offset = $info['avdataoffset'];
+
+                while ($this->getEBMLelement($top_element, $info['avdataend'])) {
+                        switch ($top_element['id']) {
+
+                                case EBML_ID_EBML:
+                                        $info['fileformat'] = 'matroska';
+                                        $info['matroska']['header']['offset'] = $top_element['offset'];
+                                        $info['matroska']['header']['length'] = $top_element['length'];
+
+                                        while ($this->getEBMLelement($element_data, $top_element['end'], true)) {
+                                                switch ($element_data['id']) {
+
+                                                        case EBML_ID_EBMLVERSION:
+                                                        case EBML_ID_EBMLREADVERSION:
+                                                        case EBML_ID_EBMLMAXIDLENGTH:
+                                                        case EBML_ID_EBMLMAXSIZELENGTH:
+                                                        case EBML_ID_DOCTYPEVERSION:
+                                                        case EBML_ID_DOCTYPEREADVERSION:
+                                                                $element_data['data'] = getid3_lib::BigEndian2Int($element_data['data']);
+                                                                break;
+
+                                                        case EBML_ID_DOCTYPE:
+                                                                $element_data['data'] = getid3_lib::trimNullByte($element_data['data']);
+                                                                $info['matroska']['doctype'] = $element_data['data'];
+                                                                break;
+
+                                                        case EBML_ID_CRC32: // not useful, ignore
+                                                                $this->current_offset = $element_data['end'];
+                                                                unset($element_data);
+                                                                break;
+
+                                                        default:
+                                                                $this->unhandledElement('header', __LINE__, $element_data);
+                                                }
+                                                if (!empty($element_data)) {
+                                                        unset($element_data['offset'], $element_data['end']);
+                                                        $info['matroska']['header']['elements'][] = $element_data;
+                                                }
+                                        }
+                                        break;
+
+                                case EBML_ID_SEGMENT:
+                                        $info['matroska']['segment'][0]['offset'] = $top_element['offset'];
+                                        $info['matroska']['segment'][0]['length'] = $top_element['length'];
+
+                                        while ($this->getEBMLelement($element_data, $top_element['end'])) {
+                                                if ($element_data['id'] != EBML_ID_CLUSTER || !self::$hide_clusters) { // collect clusters only if required
+                                                        $info['matroska']['segments'][] = $element_data;
+                                                }
+                                                switch ($element_data['id']) {
+
+                                                        case EBML_ID_SEEKHEAD: // Contains the position of other level 1 elements.
+
+                                                                while ($this->getEBMLelement($seek_entry, $element_data['end'])) {
+                                                                        switch ($seek_entry['id']) {
+
+                                                                                case EBML_ID_SEEK: // Contains a single seek entry to an EBML element
+                                                                                        while ($this->getEBMLelement($sub_seek_entry, $seek_entry['end'], true)) {
+
+                                                                                                switch ($sub_seek_entry['id']) {
+
+                                                                                                        case EBML_ID_SEEKID:
+                                                                                                                $seek_entry['target_id']   = self::EBML2Int($sub_seek_entry['data']);
+                                                                                                                $seek_entry['target_name'] = self::EBMLidName($seek_entry['target_id']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_SEEKPOSITION:
+                                                                                                                $seek_entry['target_offset'] = $element_data['offset'] + getid3_lib::BigEndian2Int($sub_seek_entry['data']);
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('seekhead.seek', __LINE__, $sub_seek_entry);                                                                                            }
+                                                                                        }
+
+                                                                                        if ($seek_entry['target_id'] != EBML_ID_CLUSTER || !self::$hide_clusters) { // collect clusters only if required
+                                                                                                $info['matroska']['seek'][] = $seek_entry;
+                                                                                        }
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('seekhead', __LINE__, $seek_entry);
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                        case EBML_ID_TRACKS: // A top-level block of information with many tracks described.
+                                                                $info['matroska']['tracks'] = $element_data;
+
+                                                                while ($this->getEBMLelement($track_entry, $element_data['end'])) {
+                                                                        switch ($track_entry['id']) {
+
+                                                                                case EBML_ID_TRACKENTRY: //subelements: Describes a track with all elements.
+
+                                                                                        while ($this->getEBMLelement($subelement, $track_entry['end'], array(EBML_ID_VIDEO, EBML_ID_AUDIO, EBML_ID_CONTENTENCODINGS, EBML_ID_CODECPRIVATE))) {
+                                                                                                switch ($subelement['id']) {
+
+                                                                                                        case EBML_ID_TRACKNUMBER:
+                                                                                                        case EBML_ID_TRACKUID:
+                                                                                                        case EBML_ID_TRACKTYPE:
+                                                                                                        case EBML_ID_MINCACHE:
+                                                                                                        case EBML_ID_MAXCACHE:
+                                                                                                        case EBML_ID_MAXBLOCKADDITIONID:
+                                                                                                        case EBML_ID_DEFAULTDURATION: // nanoseconds per frame
+                                                                                                                $track_entry[$subelement['id_name']] = getid3_lib::BigEndian2Int($subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_TRACKTIMECODESCALE:
+                                                                                                                $track_entry[$subelement['id_name']] = getid3_lib::BigEndian2Float($subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CODECID:
+                                                                                                        case EBML_ID_LANGUAGE:
+                                                                                                        case EBML_ID_NAME:
+                                                                                                        case EBML_ID_CODECNAME:
+                                                                                                                $track_entry[$subelement['id_name']] = getid3_lib::trimNullByte($subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CODECPRIVATE:
+                                                                                                                $track_entry[$subelement['id_name']] = $this->readEBMLelementData($subelement['length'], true);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_FLAGENABLED:
+                                                                                                        case EBML_ID_FLAGDEFAULT:
+                                                                                                        case EBML_ID_FLAGFORCED:
+                                                                                                        case EBML_ID_FLAGLACING:
+                                                                                                        case EBML_ID_CODECDECODEALL:
+                                                                                                                $track_entry[$subelement['id_name']] = (bool) getid3_lib::BigEndian2Int($subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_VIDEO:
+
+                                                                                                                while ($this->getEBMLelement($sub_subelement, $subelement['end'], true)) {
+                                                                                                                        switch ($sub_subelement['id']) {
+
+                                                                                                                                case EBML_ID_PIXELWIDTH:
+                                                                                                                                case EBML_ID_PIXELHEIGHT:
+                                                                                                                                case EBML_ID_PIXELCROPBOTTOM:
+                                                                                                                                case EBML_ID_PIXELCROPTOP:
+                                                                                                                                case EBML_ID_PIXELCROPLEFT:
+                                                                                                                                case EBML_ID_PIXELCROPRIGHT:
+                                                                                                                                case EBML_ID_DISPLAYWIDTH:
+                                                                                                                                case EBML_ID_DISPLAYHEIGHT:
+                                                                                                                                case EBML_ID_DISPLAYUNIT:
+                                                                                                                                case EBML_ID_ASPECTRATIOTYPE:
+                                                                                                                                case EBML_ID_STEREOMODE:
+                                                                                                                                case EBML_ID_OLDSTEREOMODE:
+                                                                                                                                        $track_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_FLAGINTERLACED:
+                                                                                                                                        $track_entry[$sub_subelement['id_name']] = (bool)getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_GAMMAVALUE:
+                                                                                                                                        $track_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Float($sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_COLOURSPACE:
+                                                                                                                                        $track_entry[$sub_subelement['id_name']] = getid3_lib::trimNullByte($sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                default:
+                                                                                                                                        $this->unhandledElement('track.video', __LINE__, $sub_subelement);
+                                                                                                                        }
+                                                                                                                }
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_AUDIO:
+
+                                                                                                                while ($this->getEBMLelement($sub_subelement, $subelement['end'], true)) {
+                                                                                                                        switch ($sub_subelement['id']) {
+
+                                                                                                                                case EBML_ID_CHANNELS:
+                                                                                                                                case EBML_ID_BITDEPTH:
+                                                                                                                                        $track_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_SAMPLINGFREQUENCY:
+                                                                                                                                case EBML_ID_OUTPUTSAMPLINGFREQUENCY:
+                                                                                                                                        $track_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Float($sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_CHANNELPOSITIONS:
+                                                                                                                                        $track_entry[$sub_subelement['id_name']] = getid3_lib::trimNullByte($sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                default:
+                                                                                                                                        $this->unhandledElement('track.audio', __LINE__, $sub_subelement);
+                                                                                                                        }
+                                                                                                                }
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CONTENTENCODINGS:
+
+                                                                                                                while ($this->getEBMLelement($sub_subelement, $subelement['end'])) {
+                                                                                                                        switch ($sub_subelement['id']) {
+
+                                                                                                                                case EBML_ID_CONTENTENCODING:
+
+                                                                                                                                        while ($this->getEBMLelement($sub_sub_subelement, $sub_subelement['end'], array(EBML_ID_CONTENTCOMPRESSION, EBML_ID_CONTENTENCRYPTION))) {
+                                                                                                                                                switch ($sub_sub_subelement['id']) {
+
+                                                                                                                                                        case EBML_ID_CONTENTENCODINGORDER:
+                                                                                                                                                        case EBML_ID_CONTENTENCODINGSCOPE:
+                                                                                                                                                        case EBML_ID_CONTENTENCODINGTYPE:
+                                                                                                                                                                $track_entry[$sub_subelement['id_name']][$sub_sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_sub_subelement['data']);
+                                                                                                                                                                break;
+
+                                                                                                                                                        case EBML_ID_CONTENTCOMPRESSION:
+
+                                                                                                                                                                while ($this->getEBMLelement($sub_sub_sub_subelement, $sub_sub_subelement['end'], true)) {
+                                                                                                                                                                        switch ($sub_sub_sub_subelement['id']) {
+
+                                                                                                                                                                                case EBML_ID_CONTENTCOMPALGO:
+                                                                                                                                                                                        $track_entry[$sub_subelement['id_name']][$sub_sub_subelement['id_name']][$sub_sub_sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_sub_sub_subelement['data']);
+                                                                                                                                                                                        break;
+
+                                                                                                                                                                                case EBML_ID_CONTENTCOMPSETTINGS:
+                                                                                                                                                                                        $track_entry[$sub_subelement['id_name']][$sub_sub_subelement['id_name']][$sub_sub_sub_subelement['id_name']] = $sub_sub_sub_subelement['data'];
+                                                                                                                                                                                        break;
+
+                                                                                                                                                                                default:
+                                                                                                                                                                                        $this->unhandledElement('track.contentencodings.contentencoding.contentcompression', __LINE__, $sub_sub_sub_subelement);
+                                                                                                                                                                        }
+                                                                                                                                                                }
+                                                                                                                                                                break;
+
+                                                                                                                                                        case EBML_ID_CONTENTENCRYPTION:
+
+                                                                                                                                                                while ($this->getEBMLelement($sub_sub_sub_subelement, $sub_sub_subelement['end'], true)) {
+                                                                                                                                                                        switch ($sub_sub_sub_subelement['id']) {
+
+                                                                                                                                                                                case EBML_ID_CONTENTENCALGO:
+                                                                                                                                                                                case EBML_ID_CONTENTSIGALGO:
+                                                                                                                                                                                case EBML_ID_CONTENTSIGHASHALGO:
+                                                                                                                                                                                        $track_entry[$sub_subelement['id_name']][$sub_sub_subelement['id_name']][$sub_sub_sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_sub_sub_subelement['data']);
+                                                                                                                                                                                        break;
+
+                                                                                                                                                                                case EBML_ID_CONTENTENCKEYID:
+                                                                                                                                                                                case EBML_ID_CONTENTSIGNATURE:
+                                                                                                                                                                                case EBML_ID_CONTENTSIGKEYID:
+                                                                                                                                                                                        $track_entry[$sub_subelement['id_name']][$sub_sub_subelement['id_name']][$sub_sub_sub_subelement['id_name']] = $sub_sub_sub_subelement['data'];
+                                                                                                                                                                                        break;
+
+                                                                                                                                                                                default:
+                                                                                                                                                                                        $this->unhandledElement('track.contentencodings.contentencoding.contentcompression', __LINE__, $sub_sub_sub_subelement);
+                                                                                                                                                                        }
+                                                                                                                                                                }
+                                                                                                                                                                break;
+
+                                                                                                                                                        default:
+                                                                                                                                                                $this->unhandledElement('track.contentencodings.contentencoding', __LINE__, $sub_sub_subelement);
+                                                                                                                                                }
+                                                                                                                                        }
+                                                                                                                                        break;
+
+                                                                                                                                default:
+                                                                                                                                        $this->unhandledElement('track.contentencodings', __LINE__, $sub_subelement);
+                                                                                                                        }
+                                                                                                                }
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('track', __LINE__, $subelement);
+                                                                                                }
+                                                                                        }
+
+                                                                                        $info['matroska']['tracks']['tracks'][] = $track_entry;
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('tracks', __LINE__, $track_entry);
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                        case EBML_ID_INFO: // Contains miscellaneous general information and statistics on the file.
+                                                                $info_entry = array();
+
+                                                                while ($this->getEBMLelement($subelement, $element_data['end'], true)) {
+                                                                        switch ($subelement['id']) {
+
+                                                                                case EBML_ID_TIMECODESCALE:
+                                                                                        $info_entry[$subelement['id_name']] = getid3_lib::BigEndian2Int($subelement['data']);
+                                                                                        break;
+
+                                                                                case EBML_ID_DURATION:
+                                                                                        $info_entry[$subelement['id_name']] = getid3_lib::BigEndian2Float($subelement['data']);
+                                                                                        break;
+
+                                                                                case EBML_ID_DATEUTC:
+                                                                                        $info_entry[$subelement['id_name']]         = getid3_lib::BigEndian2Int($subelement['data']);
+                                                                                        $info_entry[$subelement['id_name'].'_unix'] = self::EBMLdate2unix($info_entry[$subelement['id_name']]);
+                                                                                        break;
+
+                                                                                case EBML_ID_SEGMENTUID:
+                                                                                case EBML_ID_PREVUID:
+                                                                                case EBML_ID_NEXTUID:
+                                                                                        $info_entry[$subelement['id_name']] = getid3_lib::trimNullByte($subelement['data']);
+                                                                                        break;
+
+                                                                                case EBML_ID_SEGMENTFAMILY:
+                                                                                        $info_entry[$subelement['id_name']][] = getid3_lib::trimNullByte($subelement['data']);
+                                                                                        break;
+
+                                                                                case EBML_ID_SEGMENTFILENAME:
+                                                                                case EBML_ID_PREVFILENAME:
+                                                                                case EBML_ID_NEXTFILENAME:
+                                                                                case EBML_ID_TITLE:
+                                                                                case EBML_ID_MUXINGAPP:
+                                                                                case EBML_ID_WRITINGAPP:
+                                                                                        $info_entry[$subelement['id_name']] = getid3_lib::trimNullByte($subelement['data']);
+                                                                                        $info['matroska']['comments'][strtolower($subelement['id_name'])][] = $info_entry[$subelement['id_name']];
+                                                                                        break;
+
+                                                                                case EBML_ID_CHAPTERTRANSLATE:
+                                                                                        $chaptertranslate_entry = array();
+
+                                                                                        while ($this->getEBMLelement($sub_subelement, $subelement['end'], true)) {
+                                                                                                switch ($sub_subelement['id']) {
+
+                                                                                                        case EBML_ID_CHAPTERTRANSLATEEDITIONUID:
+                                                                                                                $chaptertranslate_entry[$sub_subelement['id_name']][] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CHAPTERTRANSLATECODEC:
+                                                                                                                $chaptertranslate_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CHAPTERTRANSLATEID:
+                                                                                                                $chaptertranslate_entry[$sub_subelement['id_name']] = getid3_lib::trimNullByte($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('info.chaptertranslate', __LINE__, $sub_subelement);
+                                                                                                }
+                                                                                        }
+                                                                                        $info_entry[$subelement['id_name']] = $chaptertranslate_entry;
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('info', __LINE__, $subelement);
+                                                                        }
+                                                                }
+                                                                $info['matroska']['info'][] = $info_entry;
+                                                                break;
+
+                                                        case EBML_ID_CUES: // A top-level element to speed seeking access. All entries are local to the segment. Should be mandatory for non "live" streams.
+                                                                if (self::$hide_clusters) { // do not parse cues if hide clusters is "ON" till they point to clusters anyway
+                                                                        $this->current_offset = $element_data['end'];
+                                                                        break;
+                                                                }
+                                                                $cues_entry = array();
+
+                                                                while ($this->getEBMLelement($subelement, $element_data['end'])) {
+                                                                        switch ($subelement['id']) {
+
+                                                                                case EBML_ID_CUEPOINT:
+                                                                                        $cuepoint_entry = array();
+
+                                                                                        while ($this->getEBMLelement($sub_subelement, $subelement['end'], array(EBML_ID_CUETRACKPOSITIONS))) {
+                                                                                                switch ($sub_subelement['id']) {
+
+                                                                                                        case EBML_ID_CUETRACKPOSITIONS:
+                                                        $cuetrackpositions_entry = array();
+
+                                                                                                                while ($this->getEBMLelement($sub_sub_subelement, $sub_subelement['end'], true)) {
+                                                                                                                        switch ($sub_sub_subelement['id']) {
+
+                                                                                                                                case EBML_ID_CUETRACK:
+                                                                                                                                case EBML_ID_CUECLUSTERPOSITION:
+                                                                                                                                case EBML_ID_CUEBLOCKNUMBER:
+                                                                                                                                case EBML_ID_CUECODECSTATE:
+                                                                                                                                        $cuetrackpositions_entry[$sub_sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                default:
+                                                                                                                                        $this->unhandledElement('cues.cuepoint.cuetrackpositions', __LINE__, $sub_sub_subelement);
+                                                                                                                        }
+                                                                                                                }
+                                                                                                                $cuepoint_entry[$sub_subelement['id_name']][] = $cuetrackpositions_entry;
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CUETIME:
+                                                                                                                $cuepoint_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('cues.cuepoint', __LINE__, $sub_subelement);
+                                                                                                }
+                                                                                        }
+                                                                                        $cues_entry[] = $cuepoint_entry;
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('cues', __LINE__, $subelement);
+                                                                        }
+                                                                }
+                                                                $info['matroska']['cues'] = $cues_entry;
+                                                                break;
+
+                                                        case EBML_ID_TAGS: // Element containing elements specific to Tracks/Chapters.
+                                $tags_entry = array();
+
+                                                                while ($this->getEBMLelement($subelement, $element_data['end'], false)) {
+                                                                        switch ($subelement['id']) {
+
+                                                                                case EBML_ID_TAG:
+                                                                                        $tag_entry = array();
+
+                                                                                        while ($this->getEBMLelement($sub_subelement, $subelement['end'], false)) {
+                                                                                                switch ($sub_subelement['id']) {
+
+                                                                                                        case EBML_ID_TARGETS:
+                                                                                                                $targets_entry = array();
+
+                                                                                                                while ($this->getEBMLelement($sub_sub_subelement, $sub_subelement['end'], true)) {
+                                                                                                                        switch ($sub_sub_subelement['id']) {
+
+                                                                                                                                case EBML_ID_TARGETTYPEVALUE:
+                                                                                                                                        $targets_entry[$sub_sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_sub_subelement['data']);
+                                                                                                                                        $targets_entry[strtolower($sub_sub_subelement['id_name']).'_long'] = self::TargetTypeValue($targets_entry[$sub_sub_subelement['id_name']]);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_TARGETTYPE:
+                                                                                                                                        $targets_entry[$sub_sub_subelement['id_name']] = $sub_sub_subelement['data'];
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_TAGTRACKUID:
+                                                                                                                                case EBML_ID_TAGEDITIONUID:
+                                                                                                                                case EBML_ID_TAGCHAPTERUID:
+                                                                                                                                case EBML_ID_TAGATTACHMENTUID:
+                                                                                                                                        $targets_entry[$sub_sub_subelement['id_name']][] = getid3_lib::BigEndian2Int($sub_sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                default:
+                                                                                                                                        $this->unhandledElement('tags.tag.targets', __LINE__, $sub_sub_subelement);
+                                                                                                                        }
+                                                                                                                }
+                                                                                                                $tag_entry[$sub_subelement['id_name']] = $targets_entry;
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_SIMPLETAG:
+                                                                                                                $tag_entry[$sub_subelement['id_name']][] = $this->HandleEMBLSimpleTag($sub_subelement['end']);
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('tags.tag', __LINE__, $sub_subelement);
+                                                                                                }
+                                                                                        }
+                                                                                        $tags_entry[] = $tag_entry;
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('tags', __LINE__, $subelement);
+                                                                        }
+                                                                }
+                                                                $info['matroska']['tags'] = $tags_entry;
+                                                                break;
+
+                                                        case EBML_ID_ATTACHMENTS: // Contain attached files.
+
+                                                                while ($this->getEBMLelement($subelement, $element_data['end'])) {
+                                                                        switch ($subelement['id']) {
+
+                                                                                case EBML_ID_ATTACHEDFILE:
+                                                                                        $attachedfile_entry = array();
+
+                                                                                        while ($this->getEBMLelement($sub_subelement, $subelement['end'], array(EBML_ID_FILEDATA))) {
+                                                                                                switch ($sub_subelement['id']) {
+
+                                                                                                        case EBML_ID_FILEDESCRIPTION:
+                                                                                                        case EBML_ID_FILENAME:
+                                                                                                        case EBML_ID_FILEMIMETYPE:
+                                                                                                                $attachedfile_entry[$sub_subelement['id_name']] = $sub_subelement['data'];
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_FILEDATA:
+                                                                                                                $attachedfile_entry['data_offset'] = $this->current_offset;
+                                                                                                                $attachedfile_entry['data_length'] = $sub_subelement['length'];
+
+                                                                                                                $attachedfile_entry[$sub_subelement['id_name']] = $this->saveAttachment(
+                                                                                                                        $attachedfile_entry['FileName'],
+                                                                                                                        $attachedfile_entry['data_offset'],
+                                                                                                                        $attachedfile_entry['data_length']);
+
+                                                                                                                $this->current_offset = $sub_subelement['end'];
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_FILEUID:
+                                                                                                                $attachedfile_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('attachments.attachedfile', __LINE__, $sub_subelement);
+                                                                                                }
+                                                                                        }
+                                                                                        $info['matroska']['attachments'][] = $attachedfile_entry;
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('attachments', __LINE__, $subelement);
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                        case EBML_ID_CHAPTERS:
+
+                                                                while ($this->getEBMLelement($subelement, $element_data['end'])) {
+                                                                        switch ($subelement['id']) {
+
+                                                                                case EBML_ID_EDITIONENTRY:
+                                                                                        $editionentry_entry = array();
+
+                                                                                        while ($this->getEBMLelement($sub_subelement, $subelement['end'], array(EBML_ID_CHAPTERATOM))) {
+                                                                                                switch ($sub_subelement['id']) {
+
+                                                                                                        case EBML_ID_EDITIONUID:
+                                                                                                                $editionentry_entry[$sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_EDITIONFLAGHIDDEN:
+                                                                                                        case EBML_ID_EDITIONFLAGDEFAULT:
+                                                                                                        case EBML_ID_EDITIONFLAGORDERED:
+                                                                                                                $editionentry_entry[$sub_subelement['id_name']] = (bool)getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CHAPTERATOM:
+                                                                                                                $chapteratom_entry = array();
+
+                                                                                                                while ($this->getEBMLelement($sub_sub_subelement, $sub_subelement['end'], array(EBML_ID_CHAPTERTRACK, EBML_ID_CHAPTERDISPLAY))) {
+                                                                                                                        switch ($sub_sub_subelement['id']) {
+
+                                                                                                                                case EBML_ID_CHAPTERSEGMENTUID:
+                                                                                                                                case EBML_ID_CHAPTERSEGMENTEDITIONUID:
+                                                                                                                                        $chapteratom_entry[$sub_sub_subelement['id_name']] = $sub_sub_subelement['data'];
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_CHAPTERFLAGENABLED:
+                                                                                                                                case EBML_ID_CHAPTERFLAGHIDDEN:
+                                                                                                                                        $chapteratom_entry[$sub_sub_subelement['id_name']] = (bool)getid3_lib::BigEndian2Int($sub_sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_CHAPTERUID:
+                                                                                                                                case EBML_ID_CHAPTERTIMESTART:
+                                                                                                                                case EBML_ID_CHAPTERTIMEEND:
+                                                                                                                                        $chapteratom_entry[$sub_sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_sub_subelement['data']);
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_CHAPTERTRACK:
+                                                                                                                                        $chaptertrack_entry = array();
+
+                                                                                                                                        while ($this->getEBMLelement($sub_sub_sub_subelement, $sub_sub_subelement['end'], true)) {
+                                                                                                                                                switch ($sub_sub_sub_subelement['id']) {
+
+                                                                                                                                                        case EBML_ID_CHAPTERTRACKNUMBER:
+                                                                                                                                                                $chaptertrack_entry[$sub_sub_sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_sub_sub_subelement['data']);
+                                                                                                                                                                break;
+
+                                                                                                                                                        default:
+                                                                                                                                                                $this->unhandledElement('chapters.editionentry.chapteratom.chaptertrack', __LINE__, $sub_sub_sub_subelement);
+                                                                                                                                                }
+                                                                                                                                        }
+                                                                                                                                        $chapteratom_entry[$sub_sub_subelement['id_name']][] = $chaptertrack_entry;
+                                                                                                                                        break;
+
+                                                                                                                                case EBML_ID_CHAPTERDISPLAY:
+                                                                                                                                        $chapterdisplay_entry = array();
+
+                                                                                                                                        while ($this->getEBMLelement($sub_sub_sub_subelement, $sub_sub_subelement['end'], true)) {
+                                                                                                                                                switch ($sub_sub_sub_subelement['id']) {
+
+                                                                                                                                                        case EBML_ID_CHAPSTRING:
+                                                                                                                                                        case EBML_ID_CHAPLANGUAGE:
+                                                                                                                                                        case EBML_ID_CHAPCOUNTRY:
+                                                                                                                                                                $chapterdisplay_entry[$sub_sub_sub_subelement['id_name']] = $sub_sub_sub_subelement['data'];
+                                                                                                                                                                break;
+
+                                                                                                                                                        default:
+                                                                                                                                                                $this->unhandledElement('chapters.editionentry.chapteratom.chapterdisplay', __LINE__, $sub_sub_sub_subelement);
+                                                                                                                                                }
+                                                                                                                                        }
+                                                                                                                                        $chapteratom_entry[$sub_sub_subelement['id_name']][] = $chapterdisplay_entry;
+                                                                                                                                        break;
+
+                                                                                                                                default:
+                                                                                                                                        $this->unhandledElement('chapters.editionentry.chapteratom', __LINE__, $sub_sub_subelement);
+                                                                                                                        }
+                                                                                                                }
+                                                                                                                $editionentry_entry[$sub_subelement['id_name']][] = $chapteratom_entry;
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('chapters.editionentry', __LINE__, $sub_subelement);
+                                                                                                }
+                                                                                        }
+                                                                                        $info['matroska']['chapters'][] = $editionentry_entry;
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('chapters', __LINE__, $subelement);
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                        case EBML_ID_CLUSTER: // The lower level element containing the (monolithic) Block structure.
+                                                                $cluster_entry = array();
+
+                                                                while ($this->getEBMLelement($subelement, $element_data['end'], array(EBML_ID_CLUSTERSILENTTRACKS, EBML_ID_CLUSTERBLOCKGROUP, EBML_ID_CLUSTERSIMPLEBLOCK))) {
+                                                                        switch ($subelement['id']) {
+
+                                                                                case EBML_ID_CLUSTERTIMECODE:
+                                                                                case EBML_ID_CLUSTERPOSITION:
+                                                                                case EBML_ID_CLUSTERPREVSIZE:
+                                                                                        $cluster_entry[$subelement['id_name']] = getid3_lib::BigEndian2Int($subelement['data']);
+                                                                                        break;
+
+                                                                                case EBML_ID_CLUSTERSILENTTRACKS:
+                                                                                        $cluster_silent_tracks = array();
+
+                                                                                        while ($this->getEBMLelement($sub_subelement, $subelement['end'], true)) {
+                                                                                                switch ($sub_subelement['id']) {
+
+                                                                                                        case EBML_ID_CLUSTERSILENTTRACKNUMBER:
+                                                                                                                $cluster_silent_tracks[] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('cluster.silenttracks', __LINE__, $sub_subelement);
+                                                                                                }
+                                                                                        }
+                                                                                        $cluster_entry[$subelement['id_name']][] = $cluster_silent_tracks;
+                                                                                        break;
+
+                                                                                case EBML_ID_CLUSTERBLOCKGROUP:
+                                                                                        $cluster_block_group = array('offset' => $this->current_offset);
+
+                                                                                        while ($this->getEBMLelement($sub_subelement, $subelement['end'], array(EBML_ID_CLUSTERBLOCK))) {
+                                                                                                switch ($sub_subelement['id']) {
+
+                                                                                                        case EBML_ID_CLUSTERBLOCK:
+                                                                                                                $cluster_block_group[$sub_subelement['id_name']] = $this->HandleEMBLClusterBlock($sub_subelement, EBML_ID_CLUSTERBLOCK, $info);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CLUSTERREFERENCEPRIORITY: // unsigned-int
+                                                                                                        case EBML_ID_CLUSTERBLOCKDURATION:     // unsigned-int
+                                                                                                                $cluster_block_group[$sub_subelement['id_name']] = getid3_lib::BigEndian2Int($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CLUSTERREFERENCEBLOCK:    // signed-int
+                                                                                                                $cluster_block_group[$sub_subelement['id_name']][] = getid3_lib::BigEndian2Int($sub_subelement['data'], false, true);
+                                                                                                                break;
+
+                                                                                                        case EBML_ID_CLUSTERCODECSTATE:
+                                                                                                                $cluster_block_group[$sub_subelement['id_name']] = getid3_lib::trimNullByte($sub_subelement['data']);
+                                                                                                                break;
+
+                                                                                                        default:
+                                                                                                                $this->unhandledElement('clusters.blockgroup', __LINE__, $sub_subelement);
+                                                                                                }
+                                                                                        }
+                                                                                        $cluster_entry[$subelement['id_name']][] = $cluster_block_group;
+                                                                                        break;
+
+                                                                                case EBML_ID_CLUSTERSIMPLEBLOCK:
+                                                                                        $cluster_entry[$subelement['id_name']][] = $this->HandleEMBLClusterBlock($subelement, EBML_ID_CLUSTERSIMPLEBLOCK, $info);
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $this->unhandledElement('cluster', __LINE__, $subelement);
+                                                                        }
+                                                                        $this->current_offset = $subelement['end'];
+                                                                }
+                                                                if (!self::$hide_clusters) {
+                                                                        $info['matroska']['cluster'][] = $cluster_entry;
+                                                                }
+
+                                                                // check to see if all the data we need exists already, if so, break out of the loop
+                                                                if (!self::$parse_whole_file) {
+                                                                        if (isset($info['matroska']['info']) && is_array($info['matroska']['info'])) {
+                                                                                if (isset($info['matroska']['tracks']['tracks']) && is_array($info['matroska']['tracks']['tracks'])) {
+                                                                                        if (count($info['matroska']['track_data_offsets']) == count($info['matroska']['tracks']['tracks'])) {
+                                                                                                return;
+                                                                                        }
+                                                                                }
+                                                                        }
+                                                                }
+                                                                break;
+
+                                                        default:
+                                                                $this->unhandledElement('segment', __LINE__, $element_data);
+                                                }
+                                        }
+                                        break;
+
+                                default:
+                                        $this->unhandledElement('root', __LINE__, $top_element);
+                        }
+                }
+    }
+
+        private function EnsureBufferHasEnoughData($min_data=1024) {
+                if (($this->current_offset - $this->EBMLbuffer_offset) >= ($this->EBMLbuffer_length - $min_data)) {
+                        $read_bytes = max($min_data, $this->getid3->fread_buffer_size());
+
+                        try {
+                                $this->fseek($this->current_offset);
+                                $this->EBMLbuffer_offset = $this->current_offset;
+                                $this->EBMLbuffer        = $this->fread($read_bytes);
+                                $this->EBMLbuffer_length = strlen($this->EBMLbuffer);
+                        } catch (getid3_exception $e) {
+                                $this->warning('EBML parser: '.$e->getMessage());
+                                return false;
+                        }
+
+                        if ($this->EBMLbuffer_length == 0 && $this->feof()) {
+                                return $this->error('EBML parser: ran out of file at offset '.$this->current_offset);
+                        }
+                }
+                return true;
+        }
+
+        private function readEBMLint() {
+                $actual_offset = $this->current_offset - $this->EBMLbuffer_offset;
+
+                // get length of integer
+                $first_byte_int = ord($this->EBMLbuffer[$actual_offset]);
+                if       (0x80 & $first_byte_int) {
+                        $length = 1;
+                } elseif (0x40 & $first_byte_int) {
+                        $length = 2;
+                } elseif (0x20 & $first_byte_int) {
+                        $length = 3;
+                } elseif (0x10 & $first_byte_int) {
+                        $length = 4;
+                } elseif (0x08 & $first_byte_int) {
+                        $length = 5;
+                } elseif (0x04 & $first_byte_int) {
+                        $length = 6;
+                } elseif (0x02 & $first_byte_int) {
+                        $length = 7;
+                } elseif (0x01 & $first_byte_int) {
+                        $length = 8;
+                } else {
+                        throw new Exception('invalid EBML integer (leading 0x00) at '.$this->current_offset);
+                }
+
+                // read
+                $int_value = self::EBML2Int(substr($this->EBMLbuffer, $actual_offset, $length));
+                $this->current_offset += $length;
+
+                return $int_value;
+        }
+
+        private function readEBMLelementData($length, $check_buffer=false) {
+                if ($check_buffer && !$this->EnsureBufferHasEnoughData($length)) {
+                        return false;
+                }
+                $data = substr($this->EBMLbuffer, $this->current_offset - $this->EBMLbuffer_offset, $length);
+                $this->current_offset += $length;
+                return $data;
+        }
+
+        private function getEBMLelement(&$element, $parent_end, $get_data=false) {
+                if ($this->current_offset >= $parent_end) {
+                        return false;
+                }
+
+                if (!$this->EnsureBufferHasEnoughData()) {
+                        $this->current_offset = PHP_INT_MAX; // do not exit parser right now, allow to finish current loop to gather maximum information
+                        return false;
+                }
+
+                $element = array();
+
+                // set offset
+                $element['offset'] = $this->current_offset;
+
+                // get ID
+                $element['id'] = $this->readEBMLint();
+
+                // get name
+                $element['id_name'] = self::EBMLidName($element['id']);
+
+                // get length
+                $element['length'] = $this->readEBMLint();
+
+                // get end offset
+                $element['end'] = $this->current_offset + $element['length'];
+
+                // get raw data
+                $dont_parse = (in_array($element['id'], $this->unuseful_elements) || $element['id_name'] == dechex($element['id']));
+                if (($get_data === true || (is_array($get_data) && !in_array($element['id'], $get_data))) && !$dont_parse) {
+                        $element['data'] = $this->readEBMLelementData($element['length'], $element);
+                }
+
+                return true;
+        }
+
+        private function unhandledElement($type, $line, $element) {
+                // warn only about unknown and missed elements, not about unuseful
+                if (!in_array($element['id'], $this->unuseful_elements)) {
+                        $this->warning('Unhandled '.$type.' element ['.basename(__FILE__).':'.$line.'] ('.$element['id'].'::'.$element['id_name'].' ['.$element['length'].' bytes]) at '.$element['offset']);
+                }
+
+                // increase offset for unparsed elements
+                if (!isset($element['data'])) {
+                        $this->current_offset = $element['end'];
+                }
+        }
+
+        private function ExtractCommentsSimpleTag($SimpleTagArray) {
+                if (!empty($SimpleTagArray['SimpleTag'])) {
+                        foreach ($SimpleTagArray['SimpleTag'] as $SimpleTagKey => $SimpleTagData) {
+                                if (!empty($SimpleTagData['TagName']) && !empty($SimpleTagData['TagString'])) {
+                                        $this->getid3->info['matroska']['comments'][strtolower($SimpleTagData['TagName'])][] = $SimpleTagData['TagString'];
+                                }
+                                if (!empty($SimpleTagData['SimpleTag'])) {
+                                        $this->ExtractCommentsSimpleTag($SimpleTagData);
+                                }
+                        }
+                }
+
+                return true;
+        }
+
+        private function HandleEMBLSimpleTag($parent_end) {
+                $simpletag_entry = array();
+
+                while ($this->getEBMLelement($element, $parent_end, array(EBML_ID_SIMPLETAG))) {
+                        switch ($element['id']) {
+
+                                case EBML_ID_TAGNAME:
+                                case EBML_ID_TAGLANGUAGE:
+                                case EBML_ID_TAGSTRING:
+                                case EBML_ID_TAGBINARY:
+                                        $simpletag_entry[$element['id_name']] = $element['data'];
+                                        break;
+
+                                case EBML_ID_SIMPLETAG:
+                                        $simpletag_entry[$element['id_name']][] = $this->HandleEMBLSimpleTag($element['end']);
+                                        break;
+
+                                case EBML_ID_TAGDEFAULT:
+                                        $simpletag_entry[$element['id_name']] = (bool)getid3_lib::BigEndian2Int($element['data']);
+                                        break;
+
+                                default:
+                                        $this->unhandledElement('tag.simpletag', __LINE__, $element);
+                        }
+                }
+
+                return $simpletag_entry;
+        }
+
+        private function HandleEMBLClusterBlock($element, $block_type, &$info) {
+                // http://www.matroska.org/technical/specs/index.html#block_structure
+                // http://www.matroska.org/technical/specs/index.html#simpleblock_structure
+
+                $block_data = array();
+                $block_data['tracknumber'] = $this->readEBMLint();
+                $block_data['timecode']    = getid3_lib::BigEndian2Int($this->readEBMLelementData(2), false, true);
+                $block_data['flags_raw']   = getid3_lib::BigEndian2Int($this->readEBMLelementData(1));
+
+                if ($block_type == EBML_ID_CLUSTERSIMPLEBLOCK) {
+                        $block_data['flags']['keyframe']  = (($block_data['flags_raw'] & 0x80) >> 7);
+                        //$block_data['flags']['reserved1'] = (($block_data['flags_raw'] & 0x70) >> 4);
+                }
+                else {
+                        //$block_data['flags']['reserved1'] = (($block_data['flags_raw'] & 0xF0) >> 4);
+                }
+                $block_data['flags']['invisible'] = (bool)(($block_data['flags_raw'] & 0x08) >> 3);
+                $block_data['flags']['lacing']    =       (($block_data['flags_raw'] & 0x06) >> 1);  // 00=no lacing; 01=Xiph lacing; 11=EBML lacing; 10=fixed-size lacing
+                if ($block_type == EBML_ID_CLUSTERSIMPLEBLOCK) {
+                        $block_data['flags']['discardable'] = (($block_data['flags_raw'] & 0x01));
+                }
+                else {
+                        //$block_data['flags']['reserved2'] = (($block_data['flags_raw'] & 0x01) >> 0);
+                }
+                $block_data['flags']['lacing_type'] = self::BlockLacingType($block_data['flags']['lacing']);
+
+        // Lace (when lacing bit is set)
+                if ($block_data['flags']['lacing'] > 0) {
+                        $block_data['lace_frames'] = getid3_lib::BigEndian2Int($this->readEBMLelementData(1)) + 1; // Number of frames in the lace-1 (uint8)
+                        if ($block_data['flags']['lacing'] != 0x02) {
+                                for ($i = 1; $i < $block_data['lace_frames']; $i ++) { // Lace-coded size of each frame of the lace, except for the last one (multiple uint8). *This is not used with Fixed-size lacing as it is calculated automatically from (total size of lace) / (number of frames in lace).
+                                        if ($block_data['flags']['lacing'] == 0x03) { // EBML lacing
+                                                $block_data['lace_frames_size'][$i] = $this->readEBMLint(); // TODO: read size correctly, calc size for the last frame. For now offsets are deteminded OK with readEBMLint() and that's the most important thing.
+                                        }
+                                        else { // Xiph lacing
+                                                $block_data['lace_frames_size'][$i] = 0;
+                                                do {
+                                                        $size = getid3_lib::BigEndian2Int($this->readEBMLelementData(1));
+                                                        $block_data['lace_frames_size'][$i] += $size;
+                                                }
+                                                while ($size == 255);
+                                        }
+                                }
+                                if ($block_data['flags']['lacing'] == 0x01) { // calc size of the last frame only for Xiph lacing, till EBML sizes are now anyway determined incorrectly
+                                        $block_data['lace_frames_size'][] = $element['end'] - $this->current_offset - array_sum($block_data['lace_frames_size']);
+                                }
+                        }
+                }
+
+                if (!isset($info['matroska']['track_data_offsets'][$block_data['tracknumber']])) {
+                        $info['matroska']['track_data_offsets'][$block_data['tracknumber']]['offset'] = $this->current_offset;
+                        $info['matroska']['track_data_offsets'][$block_data['tracknumber']]['length'] = $element['end'] - $this->current_offset;
+                        //$info['matroska']['track_data_offsets'][$block_data['tracknumber']]['total_length'] = 0;
+                }
+                //$info['matroska']['track_data_offsets'][$block_data['tracknumber']]['total_length'] += $info['matroska']['track_data_offsets'][$block_data['tracknumber']]['length'];
+                //$info['matroska']['track_data_offsets'][$block_data['tracknumber']]['duration']      = $block_data['timecode'] * ((isset($info['matroska']['info'][0]['TimecodeScale']) ? $info['matroska']['info'][0]['TimecodeScale'] : 1000000) / 1000000000);
+
+                // set offset manually
+                $this->current_offset = $element['end'];
+
+                return $block_data;
+        }
+
+        private static function EBML2Int($EBMLstring) {
+                // http://matroska.org/specs/
+
+                // Element ID coded with an UTF-8 like system:
+                // 1xxx xxxx                                  - Class A IDs (2^7 -2 possible values) (base 0x8X)
+                // 01xx xxxx  xxxx xxxx                       - Class B IDs (2^14-2 possible values) (base 0x4X 0xXX)
+                // 001x xxxx  xxxx xxxx  xxxx xxxx            - Class C IDs (2^21-2 possible values) (base 0x2X 0xXX 0xXX)
+                // 0001 xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx - Class D IDs (2^28-2 possible values) (base 0x1X 0xXX 0xXX 0xXX)
+                // Values with all x at 0 and 1 are reserved (hence the -2).
+
+                // Data size, in octets, is also coded with an UTF-8 like system :
+                // 1xxx xxxx                                                                              - value 0 to  2^7-2
+                // 01xx xxxx  xxxx xxxx                                                                   - value 0 to 2^14-2
+                // 001x xxxx  xxxx xxxx  xxxx xxxx                                                        - value 0 to 2^21-2
+                // 0001 xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx                                             - value 0 to 2^28-2
+                // 0000 1xxx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx                                  - value 0 to 2^35-2
+                // 0000 01xx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx                       - value 0 to 2^42-2
+                // 0000 001x  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx            - value 0 to 2^49-2
+                // 0000 0001  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx  xxxx xxxx - value 0 to 2^56-2
+
+                $first_byte_int = ord($EBMLstring[0]);
+                if (0x80 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x7F);
+                } elseif (0x40 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x3F);
+                } elseif (0x20 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x1F);
+                } elseif (0x10 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x0F);
+                } elseif (0x08 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x07);
+                } elseif (0x04 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x03);
+                } elseif (0x02 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x01);
+                } elseif (0x01 & $first_byte_int) {
+                        $EBMLstring[0] = chr($first_byte_int & 0x00);
+                }
+
+                return getid3_lib::BigEndian2Int($EBMLstring);
+        }
+
+        private static function EBMLdate2unix($EBMLdatestamp) {
+                // Date - signed 8 octets integer in nanoseconds with 0 indicating the precise beginning of the millennium (at 2001-01-01T00:00:00,000000000 UTC)
+                // 978307200 == mktime(0, 0, 0, 1, 1, 2001) == January 1, 2001 12:00:00am UTC
+                return round(($EBMLdatestamp / 1000000000) + 978307200);
+        }
+
+        public static function TargetTypeValue($target_type) {
+                // http://www.matroska.org/technical/specs/tagging/index.html
+                static $TargetTypeValue = array();
+                if (empty($TargetTypeValue)) {
+                        $TargetTypeValue[10] = 'A: ~ V:shot';                                           // the lowest hierarchy found in music or movies
+                        $TargetTypeValue[20] = 'A:subtrack/part/movement ~ V:scene';                    // corresponds to parts of a track for audio (like a movement)
+                        $TargetTypeValue[30] = 'A:track/song ~ V:chapter';                              // the common parts of an album or a movie
+                        $TargetTypeValue[40] = 'A:part/session ~ V:part/session';                       // when an album or episode has different logical parts
+                        $TargetTypeValue[50] = 'A:album/opera/concert ~ V:movie/episode/concert';       // the most common grouping level of music and video (equals to an episode for TV series)
+                        $TargetTypeValue[60] = 'A:edition/issue/volume/opus ~ V:season/sequel/volume';  // a list of lower levels grouped together
+                        $TargetTypeValue[70] = 'A:collection ~ V:collection';                           // the high hierarchy consisting of many different lower items
+                }
+                return (isset($TargetTypeValue[$target_type]) ? $TargetTypeValue[$target_type] : $target_type);
+        }
+
+        public static function BlockLacingType($lacingtype) {
+                // http://matroska.org/technical/specs/index.html#block_structure
+                static $BlockLacingType = array();
+                if (empty($BlockLacingType)) {
+                        $BlockLacingType[0x00] = 'no lacing';
+                        $BlockLacingType[0x01] = 'Xiph lacing';
+                        $BlockLacingType[0x02] = 'fixed-size lacing';
+                        $BlockLacingType[0x03] = 'EBML lacing';
+                }
+                return (isset($BlockLacingType[$lacingtype]) ? $BlockLacingType[$lacingtype] : $lacingtype);
+        }
+
+        public static function CodecIDtoCommonName($codecid) {
+                // http://www.matroska.org/technical/specs/codecid/index.html
+                static $CodecIDlist = array();
+                if (empty($CodecIDlist)) {
+                        $CodecIDlist['A_AAC']            = 'aac';
+                        $CodecIDlist['A_AAC/MPEG2/LC']   = 'aac';
+                        $CodecIDlist['A_AC3']            = 'ac3';
+                        $CodecIDlist['A_DTS']            = 'dts';
+                        $CodecIDlist['A_FLAC']           = 'flac';
+                        $CodecIDlist['A_MPEG/L1']        = 'mp1';
+                        $CodecIDlist['A_MPEG/L2']        = 'mp2';
+                        $CodecIDlist['A_MPEG/L3']        = 'mp3';
+                        $CodecIDlist['A_PCM/INT/LIT']    = 'pcm';       // PCM Integer Little Endian
+                        $CodecIDlist['A_PCM/INT/BIG']    = 'pcm';       // PCM Integer Big Endian
+                        $CodecIDlist['A_QUICKTIME/QDMC'] = 'quicktime'; // Quicktime: QDesign Music
+                        $CodecIDlist['A_QUICKTIME/QDM2'] = 'quicktime'; // Quicktime: QDesign Music v2
+                        $CodecIDlist['A_VORBIS']         = 'vorbis';
+                        $CodecIDlist['V_MPEG1']          = 'mpeg';
+                        $CodecIDlist['V_THEORA']         = 'theora';
+                        $CodecIDlist['V_REAL/RV40']      = 'real';
+                        $CodecIDlist['V_REAL/RV10']      = 'real';
+                        $CodecIDlist['V_REAL/RV20']      = 'real';
+                        $CodecIDlist['V_REAL/RV30']      = 'real';
+                        $CodecIDlist['V_QUICKTIME']      = 'quicktime'; // Quicktime
+                        $CodecIDlist['V_MPEG4/ISO/AP']   = 'mpeg4';
+                        $CodecIDlist['V_MPEG4/ISO/ASP']  = 'mpeg4';
+                        $CodecIDlist['V_MPEG4/ISO/AVC']  = 'h264';
+                        $CodecIDlist['V_MPEG4/ISO/SP']   = 'mpeg4';
+                        $CodecIDlist['V_VP8']            = 'vp8';
+                        $CodecIDlist['V_MS/VFW/FOURCC']  = 'riff';
+                        $CodecIDlist['A_MS/ACM']         = 'riff';
+                }
+                return (isset($CodecIDlist[$codecid]) ? $CodecIDlist[$codecid] : $codecid);
+        }
+
+        private static function EBMLidName($value) {
+                static $EBMLidList = array();
+                if (empty($EBMLidList)) {
+                        $EBMLidList[EBML_ID_ASPECTRATIOTYPE]            = 'AspectRatioType';
+                        $EBMLidList[EBML_ID_ATTACHEDFILE]               = 'AttachedFile';
+                        $EBMLidList[EBML_ID_ATTACHMENTLINK]             = 'AttachmentLink';
+                        $EBMLidList[EBML_ID_ATTACHMENTS]                = 'Attachments';
+                        $EBMLidList[EBML_ID_AUDIO]                      = 'Audio';
+                        $EBMLidList[EBML_ID_BITDEPTH]                   = 'BitDepth';
+                        $EBMLidList[EBML_ID_CHANNELPOSITIONS]           = 'ChannelPositions';
+                        $EBMLidList[EBML_ID_CHANNELS]                   = 'Channels';
+                        $EBMLidList[EBML_ID_CHAPCOUNTRY]                = 'ChapCountry';
+                        $EBMLidList[EBML_ID_CHAPLANGUAGE]               = 'ChapLanguage';
+                        $EBMLidList[EBML_ID_CHAPPROCESS]                = 'ChapProcess';
+                        $EBMLidList[EBML_ID_CHAPPROCESSCODECID]         = 'ChapProcessCodecID';
+                        $EBMLidList[EBML_ID_CHAPPROCESSCOMMAND]         = 'ChapProcessCommand';
+                        $EBMLidList[EBML_ID_CHAPPROCESSDATA]            = 'ChapProcessData';
+                        $EBMLidList[EBML_ID_CHAPPROCESSPRIVATE]         = 'ChapProcessPrivate';
+                        $EBMLidList[EBML_ID_CHAPPROCESSTIME]            = 'ChapProcessTime';
+                        $EBMLidList[EBML_ID_CHAPSTRING]                 = 'ChapString';
+                        $EBMLidList[EBML_ID_CHAPTERATOM]                = 'ChapterAtom';
+                        $EBMLidList[EBML_ID_CHAPTERDISPLAY]             = 'ChapterDisplay';
+                        $EBMLidList[EBML_ID_CHAPTERFLAGENABLED]         = 'ChapterFlagEnabled';
+                        $EBMLidList[EBML_ID_CHAPTERFLAGHIDDEN]          = 'ChapterFlagHidden';
+                        $EBMLidList[EBML_ID_CHAPTERPHYSICALEQUIV]       = 'ChapterPhysicalEquiv';
+                        $EBMLidList[EBML_ID_CHAPTERS]                   = 'Chapters';
+                        $EBMLidList[EBML_ID_CHAPTERSEGMENTEDITIONUID]   = 'ChapterSegmentEditionUID';
+                        $EBMLidList[EBML_ID_CHAPTERSEGMENTUID]          = 'ChapterSegmentUID';
+                        $EBMLidList[EBML_ID_CHAPTERTIMEEND]             = 'ChapterTimeEnd';
+                        $EBMLidList[EBML_ID_CHAPTERTIMESTART]           = 'ChapterTimeStart';
+                        $EBMLidList[EBML_ID_CHAPTERTRACK]               = 'ChapterTrack';
+                        $EBMLidList[EBML_ID_CHAPTERTRACKNUMBER]         = 'ChapterTrackNumber';
+                        $EBMLidList[EBML_ID_CHAPTERTRANSLATE]           = 'ChapterTranslate';
+                        $EBMLidList[EBML_ID_CHAPTERTRANSLATECODEC]      = 'ChapterTranslateCodec';
+                        $EBMLidList[EBML_ID_CHAPTERTRANSLATEEDITIONUID] = 'ChapterTranslateEditionUID';
+                        $EBMLidList[EBML_ID_CHAPTERTRANSLATEID]         = 'ChapterTranslateID';
+                        $EBMLidList[EBML_ID_CHAPTERUID]                 = 'ChapterUID';
+                        $EBMLidList[EBML_ID_CLUSTER]                    = 'Cluster';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCK]               = 'ClusterBlock';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKADDID]          = 'ClusterBlockAddID';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKADDITIONAL]     = 'ClusterBlockAdditional';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKADDITIONID]     = 'ClusterBlockAdditionID';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKADDITIONS]      = 'ClusterBlockAdditions';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKDURATION]       = 'ClusterBlockDuration';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKGROUP]          = 'ClusterBlockGroup';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKMORE]           = 'ClusterBlockMore';
+                        $EBMLidList[EBML_ID_CLUSTERBLOCKVIRTUAL]        = 'ClusterBlockVirtual';
+                        $EBMLidList[EBML_ID_CLUSTERCODECSTATE]          = 'ClusterCodecState';
+                        $EBMLidList[EBML_ID_CLUSTERDELAY]               = 'ClusterDelay';
+                        $EBMLidList[EBML_ID_CLUSTERDURATION]            = 'ClusterDuration';
+                        $EBMLidList[EBML_ID_CLUSTERENCRYPTEDBLOCK]      = 'ClusterEncryptedBlock';
+                        $EBMLidList[EBML_ID_CLUSTERFRAMENUMBER]         = 'ClusterFrameNumber';
+                        $EBMLidList[EBML_ID_CLUSTERLACENUMBER]          = 'ClusterLaceNumber';
+                        $EBMLidList[EBML_ID_CLUSTERPOSITION]            = 'ClusterPosition';
+                        $EBMLidList[EBML_ID_CLUSTERPREVSIZE]            = 'ClusterPrevSize';
+                        $EBMLidList[EBML_ID_CLUSTERREFERENCEBLOCK]      = 'ClusterReferenceBlock';
+                        $EBMLidList[EBML_ID_CLUSTERREFERENCEPRIORITY]   = 'ClusterReferencePriority';
+                        $EBMLidList[EBML_ID_CLUSTERREFERENCEVIRTUAL]    = 'ClusterReferenceVirtual';
+                        $EBMLidList[EBML_ID_CLUSTERSILENTTRACKNUMBER]   = 'ClusterSilentTrackNumber';
+                        $EBMLidList[EBML_ID_CLUSTERSILENTTRACKS]        = 'ClusterSilentTracks';
+                        $EBMLidList[EBML_ID_CLUSTERSIMPLEBLOCK]         = 'ClusterSimpleBlock';
+                        $EBMLidList[EBML_ID_CLUSTERTIMECODE]            = 'ClusterTimecode';
+                        $EBMLidList[EBML_ID_CLUSTERTIMESLICE]           = 'ClusterTimeSlice';
+                        $EBMLidList[EBML_ID_CODECDECODEALL]             = 'CodecDecodeAll';
+                        $EBMLidList[EBML_ID_CODECDOWNLOADURL]           = 'CodecDownloadURL';
+                        $EBMLidList[EBML_ID_CODECID]                    = 'CodecID';
+                        $EBMLidList[EBML_ID_CODECINFOURL]               = 'CodecInfoURL';
+                        $EBMLidList[EBML_ID_CODECNAME]                  = 'CodecName';
+                        $EBMLidList[EBML_ID_CODECPRIVATE]               = 'CodecPrivate';
+                        $EBMLidList[EBML_ID_CODECSETTINGS]              = 'CodecSettings';
+                        $EBMLidList[EBML_ID_COLOURSPACE]                = 'ColourSpace';
+                        $EBMLidList[EBML_ID_CONTENTCOMPALGO]            = 'ContentCompAlgo';
+                        $EBMLidList[EBML_ID_CONTENTCOMPRESSION]         = 'ContentCompression';
+                        $EBMLidList[EBML_ID_CONTENTCOMPSETTINGS]        = 'ContentCompSettings';
+                        $EBMLidList[EBML_ID_CONTENTENCALGO]             = 'ContentEncAlgo';
+                        $EBMLidList[EBML_ID_CONTENTENCKEYID]            = 'ContentEncKeyID';
+                        $EBMLidList[EBML_ID_CONTENTENCODING]            = 'ContentEncoding';
+                        $EBMLidList[EBML_ID_CONTENTENCODINGORDER]       = 'ContentEncodingOrder';
+                        $EBMLidList[EBML_ID_CONTENTENCODINGS]           = 'ContentEncodings';
+                        $EBMLidList[EBML_ID_CONTENTENCODINGSCOPE]       = 'ContentEncodingScope';
+                        $EBMLidList[EBML_ID_CONTENTENCODINGTYPE]        = 'ContentEncodingType';
+                        $EBMLidList[EBML_ID_CONTENTENCRYPTION]          = 'ContentEncryption';
+                        $EBMLidList[EBML_ID_CONTENTSIGALGO]             = 'ContentSigAlgo';
+                        $EBMLidList[EBML_ID_CONTENTSIGHASHALGO]         = 'ContentSigHashAlgo';
+                        $EBMLidList[EBML_ID_CONTENTSIGKEYID]            = 'ContentSigKeyID';
+                        $EBMLidList[EBML_ID_CONTENTSIGNATURE]           = 'ContentSignature';
+                        $EBMLidList[EBML_ID_CRC32]                      = 'CRC32';
+                        $EBMLidList[EBML_ID_CUEBLOCKNUMBER]             = 'CueBlockNumber';
+                        $EBMLidList[EBML_ID_CUECLUSTERPOSITION]         = 'CueClusterPosition';
+                        $EBMLidList[EBML_ID_CUECODECSTATE]              = 'CueCodecState';
+                        $EBMLidList[EBML_ID_CUEPOINT]                   = 'CuePoint';
+                        $EBMLidList[EBML_ID_CUEREFCLUSTER]              = 'CueRefCluster';
+                        $EBMLidList[EBML_ID_CUEREFCODECSTATE]           = 'CueRefCodecState';
+                        $EBMLidList[EBML_ID_CUEREFERENCE]               = 'CueReference';
+                        $EBMLidList[EBML_ID_CUEREFNUMBER]               = 'CueRefNumber';
+                        $EBMLidList[EBML_ID_CUEREFTIME]                 = 'CueRefTime';
+                        $EBMLidList[EBML_ID_CUES]                       = 'Cues';
+                        $EBMLidList[EBML_ID_CUETIME]                    = 'CueTime';
+                        $EBMLidList[EBML_ID_CUETRACK]                   = 'CueTrack';
+                        $EBMLidList[EBML_ID_CUETRACKPOSITIONS]          = 'CueTrackPositions';
+                        $EBMLidList[EBML_ID_DATEUTC]                    = 'DateUTC';
+                        $EBMLidList[EBML_ID_DEFAULTDURATION]            = 'DefaultDuration';
+                        $EBMLidList[EBML_ID_DISPLAYHEIGHT]              = 'DisplayHeight';
+                        $EBMLidList[EBML_ID_DISPLAYUNIT]                = 'DisplayUnit';
+                        $EBMLidList[EBML_ID_DISPLAYWIDTH]               = 'DisplayWidth';
+                        $EBMLidList[EBML_ID_DOCTYPE]                    = 'DocType';
+                        $EBMLidList[EBML_ID_DOCTYPEREADVERSION]         = 'DocTypeReadVersion';
+                        $EBMLidList[EBML_ID_DOCTYPEVERSION]             = 'DocTypeVersion';
+                        $EBMLidList[EBML_ID_DURATION]                   = 'Duration';
+                        $EBMLidList[EBML_ID_EBML]                       = 'EBML';
+                        $EBMLidList[EBML_ID_EBMLMAXIDLENGTH]            = 'EBMLMaxIDLength';
+                        $EBMLidList[EBML_ID_EBMLMAXSIZELENGTH]          = 'EBMLMaxSizeLength';
+                        $EBMLidList[EBML_ID_EBMLREADVERSION]            = 'EBMLReadVersion';
+                        $EBMLidList[EBML_ID_EBMLVERSION]                = 'EBMLVersion';
+                        $EBMLidList[EBML_ID_EDITIONENTRY]               = 'EditionEntry';
+                        $EBMLidList[EBML_ID_EDITIONFLAGDEFAULT]         = 'EditionFlagDefault';
+                        $EBMLidList[EBML_ID_EDITIONFLAGHIDDEN]          = 'EditionFlagHidden';
+                        $EBMLidList[EBML_ID_EDITIONFLAGORDERED]         = 'EditionFlagOrdered';
+                        $EBMLidList[EBML_ID_EDITIONUID]                 = 'EditionUID';
+                        $EBMLidList[EBML_ID_FILEDATA]                   = 'FileData';
+                        $EBMLidList[EBML_ID_FILEDESCRIPTION]            = 'FileDescription';
+                        $EBMLidList[EBML_ID_FILEMIMETYPE]               = 'FileMimeType';
+                        $EBMLidList[EBML_ID_FILENAME]                   = 'FileName';
+                        $EBMLidList[EBML_ID_FILEREFERRAL]               = 'FileReferral';
+                        $EBMLidList[EBML_ID_FILEUID]                    = 'FileUID';
+                        $EBMLidList[EBML_ID_FLAGDEFAULT]                = 'FlagDefault';
+                        $EBMLidList[EBML_ID_FLAGENABLED]                = 'FlagEnabled';
+                        $EBMLidList[EBML_ID_FLAGFORCED]                 = 'FlagForced';
+                        $EBMLidList[EBML_ID_FLAGINTERLACED]             = 'FlagInterlaced';
+                        $EBMLidList[EBML_ID_FLAGLACING]                 = 'FlagLacing';
+                        $EBMLidList[EBML_ID_GAMMAVALUE]                 = 'GammaValue';
+                        $EBMLidList[EBML_ID_INFO]                       = 'Info';
+                        $EBMLidList[EBML_ID_LANGUAGE]                   = 'Language';
+                        $EBMLidList[EBML_ID_MAXBLOCKADDITIONID]         = 'MaxBlockAdditionID';
+                        $EBMLidList[EBML_ID_MAXCACHE]                   = 'MaxCache';
+                        $EBMLidList[EBML_ID_MINCACHE]                   = 'MinCache';
+                        $EBMLidList[EBML_ID_MUXINGAPP]                  = 'MuxingApp';
+                        $EBMLidList[EBML_ID_NAME]                       = 'Name';
+                        $EBMLidList[EBML_ID_NEXTFILENAME]               = 'NextFilename';
+                        $EBMLidList[EBML_ID_NEXTUID]                    = 'NextUID';
+                        $EBMLidList[EBML_ID_OUTPUTSAMPLINGFREQUENCY]    = 'OutputSamplingFrequency';
+                        $EBMLidList[EBML_ID_PIXELCROPBOTTOM]            = 'PixelCropBottom';
+                        $EBMLidList[EBML_ID_PIXELCROPLEFT]              = 'PixelCropLeft';
+                        $EBMLidList[EBML_ID_PIXELCROPRIGHT]             = 'PixelCropRight';
+                        $EBMLidList[EBML_ID_PIXELCROPTOP]               = 'PixelCropTop';
+                        $EBMLidList[EBML_ID_PIXELHEIGHT]                = 'PixelHeight';
+                        $EBMLidList[EBML_ID_PIXELWIDTH]                 = 'PixelWidth';
+                        $EBMLidList[EBML_ID_PREVFILENAME]               = 'PrevFilename';
+                        $EBMLidList[EBML_ID_PREVUID]                    = 'PrevUID';
+                        $EBMLidList[EBML_ID_SAMPLINGFREQUENCY]          = 'SamplingFrequency';
+                        $EBMLidList[EBML_ID_SEEK]                       = 'Seek';
+                        $EBMLidList[EBML_ID_SEEKHEAD]                   = 'SeekHead';
+                        $EBMLidList[EBML_ID_SEEKID]                     = 'SeekID';
+                        $EBMLidList[EBML_ID_SEEKPOSITION]               = 'SeekPosition';
+                        $EBMLidList[EBML_ID_SEGMENT]                    = 'Segment';
+                        $EBMLidList[EBML_ID_SEGMENTFAMILY]              = 'SegmentFamily';
+                        $EBMLidList[EBML_ID_SEGMENTFILENAME]            = 'SegmentFilename';
+                        $EBMLidList[EBML_ID_SEGMENTUID]                 = 'SegmentUID';
+                        $EBMLidList[EBML_ID_SIMPLETAG]                  = 'SimpleTag';
+                        $EBMLidList[EBML_ID_CLUSTERSLICES]              = 'ClusterSlices';
+                        $EBMLidList[EBML_ID_STEREOMODE]                 = 'StereoMode';
+                        $EBMLidList[EBML_ID_OLDSTEREOMODE]              = 'OldStereoMode';
+                        $EBMLidList[EBML_ID_TAG]                        = 'Tag';
+                        $EBMLidList[EBML_ID_TAGATTACHMENTUID]           = 'TagAttachmentUID';
+                        $EBMLidList[EBML_ID_TAGBINARY]                  = 'TagBinary';
+                        $EBMLidList[EBML_ID_TAGCHAPTERUID]              = 'TagChapterUID';
+                        $EBMLidList[EBML_ID_TAGDEFAULT]                 = 'TagDefault';
+                        $EBMLidList[EBML_ID_TAGEDITIONUID]              = 'TagEditionUID';
+                        $EBMLidList[EBML_ID_TAGLANGUAGE]                = 'TagLanguage';
+                        $EBMLidList[EBML_ID_TAGNAME]                    = 'TagName';
+                        $EBMLidList[EBML_ID_TAGTRACKUID]                = 'TagTrackUID';
+                        $EBMLidList[EBML_ID_TAGS]                       = 'Tags';
+                        $EBMLidList[EBML_ID_TAGSTRING]                  = 'TagString';
+                        $EBMLidList[EBML_ID_TARGETS]                    = 'Targets';
+                        $EBMLidList[EBML_ID_TARGETTYPE]                 = 'TargetType';
+                        $EBMLidList[EBML_ID_TARGETTYPEVALUE]            = 'TargetTypeValue';
+                        $EBMLidList[EBML_ID_TIMECODESCALE]              = 'TimecodeScale';
+                        $EBMLidList[EBML_ID_TITLE]                      = 'Title';
+                        $EBMLidList[EBML_ID_TRACKENTRY]                 = 'TrackEntry';
+                        $EBMLidList[EBML_ID_TRACKNUMBER]                = 'TrackNumber';
+                        $EBMLidList[EBML_ID_TRACKOFFSET]                = 'TrackOffset';
+                        $EBMLidList[EBML_ID_TRACKOVERLAY]               = 'TrackOverlay';
+                        $EBMLidList[EBML_ID_TRACKS]                     = 'Tracks';
+                        $EBMLidList[EBML_ID_TRACKTIMECODESCALE]         = 'TrackTimecodeScale';
+                        $EBMLidList[EBML_ID_TRACKTRANSLATE]             = 'TrackTranslate';
+                        $EBMLidList[EBML_ID_TRACKTRANSLATECODEC]        = 'TrackTranslateCodec';
+                        $EBMLidList[EBML_ID_TRACKTRANSLATEEDITIONUID]   = 'TrackTranslateEditionUID';
+                        $EBMLidList[EBML_ID_TRACKTRANSLATETRACKID]      = 'TrackTranslateTrackID';
+                        $EBMLidList[EBML_ID_TRACKTYPE]                  = 'TrackType';
+                        $EBMLidList[EBML_ID_TRACKUID]                   = 'TrackUID';
+                        $EBMLidList[EBML_ID_VIDEO]                      = 'Video';
+                        $EBMLidList[EBML_ID_VOID]                       = 'Void';
+                        $EBMLidList[EBML_ID_WRITINGAPP]                 = 'WritingApp';
+                }
+
+                return (isset($EBMLidList[$value]) ? $EBMLidList[$value] : dechex($value));
+        }
+
+        public static function displayUnit($value) {
+                // http://www.matroska.org/technical/specs/index.html#DisplayUnit
+                static $units = array(
+                        0 => 'pixels',
+                        1 => 'centimeters',
+                        2 => 'inches',
+                        3 => 'Display Aspect Ratio');
+
+                return (isset($units[$value]) ? $units[$value] : 'unknown');
+        }
+
+        private static function getDefaultStreamInfo($streams)
+        {
+                foreach (array_reverse($streams) as $stream) {
+                        if ($stream['default']) {
+                                break;
+                        }
+                }
+
+                $unset = array('default', 'name');
+                foreach ($unset as $u) {
+                        if (isset($stream[$u])) {
+                                unset($stream[$u]);
+                        }
+                }
+
+                $info = $stream;
+                $info['streams'] = $streams;
+
+                return $info;
+        }
+
+}

new file wp-includes/ID3/module.audio-video.quicktime.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio-video.quicktime.php                            //
+// module for analyzing Quicktime and MP3-in-MP4 files         //
+// dependencies: module.audio.mp3.php                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.mp3.php', __FILE__, true);
+
+class getid3_quicktime extends getid3_handler
+{
+
+        public $ReturnAtomData        = true;
+        public $ParseAllPossibleAtoms = false;
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                $info['fileformat'] = 'quicktime';
+                $info['quicktime']['hinting']    = false;
+                $info['quicktime']['controller'] = 'standard'; // may be overridden if 'ctyp' atom is present
+
+                fseek($this->getid3->fp, $info['avdataoffset'], SEEK_SET);
+
+                $offset      = 0;
+                $atomcounter = 0;
+
+                while ($offset < $info['avdataend']) {
+                        if (!getid3_lib::intValueSupported($offset)) {
+                                $info['error'][] = 'Unable to parse atom at offset '.$offset.' because beyond '.round(PHP_INT_MAX / 1073741824).'GB limit of PHP filesystem functions';
+                                break;
+                        }
+                        fseek($this->getid3->fp, $offset, SEEK_SET);
+                        $AtomHeader = fread($this->getid3->fp, 8);
+
+                        $atomsize = getid3_lib::BigEndian2Int(substr($AtomHeader, 0, 4));
+                        $atomname = substr($AtomHeader, 4, 4);
+
+                        // 64-bit MOV patch by jlegateØktnc*com
+                        if ($atomsize == 1) {
+                                $atomsize = getid3_lib::BigEndian2Int(fread($this->getid3->fp, 8));
+                        }
+
+                        $info['quicktime'][$atomname]['name']   = $atomname;
+                        $info['quicktime'][$atomname]['size']   = $atomsize;
+                        $info['quicktime'][$atomname]['offset'] = $offset;
+
+                        if (($offset + $atomsize) > $info['avdataend']) {
+                                $info['error'][] = 'Atom at offset '.$offset.' claims to go beyond end-of-file (length: '.$atomsize.' bytes)';
+                                return false;
+                        }
+
+                        if ($atomsize == 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 ($atomname) {
+                                case 'mdat': // Media DATa atom
+                                        // 'mdat' contains the actual data for the audio/video
+                                        if (($atomsize > 8) && (!isset($info['avdataend_tmp']) || ($info['quicktime'][$atomname]['size'] > ($info['avdataend_tmp'] - $info['avdataoffset'])))) {
+
+                                                $info['avdataoffset'] = $info['quicktime'][$atomname]['offset'] + 8;
+                                                $OldAVDataEnd         = $info['avdataend'];
+                                                $info['avdataend']    = $info['quicktime'][$atomname]['offset'] + $info['quicktime'][$atomname]['size'];
+
+                                                $getid3_temp = new getID3();
+                                                $getid3_temp->openfile($this->getid3->filename);
+                                                $getid3_temp->info['avdataoffset'] = $info['avdataoffset'];
+                                                $getid3_temp->info['avdataend']    = $info['avdataend'];
+                                                $getid3_mp3 = new getid3_mp3($getid3_temp);
+                                                if ($getid3_mp3->MPEGaudioHeaderValid($getid3_mp3->MPEGaudioHeaderDecode(fread($this->getid3->fp, 4)))) {
+                                                        $getid3_mp3->getOnlyMPEGaudioInfo($getid3_temp->info['avdataoffset'], false);
+                                                        if (!empty($getid3_temp->info['warning'])) {
+                                                                foreach ($getid3_temp->info['warning'] as $value) {
+                                                                        $info['warning'][] = $value;
+                                                                }
+                                                        }
+                                                        if (!empty($getid3_temp->info['mpeg'])) {
+                                                                $info['mpeg'] = $getid3_temp->info['mpeg'];
+                                                                if (isset($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'];
+                                                                }
+                                                        }
+                                                }
+                                                unset($getid3_mp3, $getid3_temp);
+                                                $info['avdataend'] = $OldAVDataEnd;
+                                                unset($OldAVDataEnd);
+
+                                        }
+                                        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:
+                                        $atomHierarchy = array();
+                                        $info['quicktime'][$atomname] = $this->QuicktimeParseAtom($atomname, $atomsize, fread($this->getid3->fp, $atomsize), $offset, $atomHierarchy, $this->ParseAllPossibleAtoms);
+                                        break;
+                        }
+
+                        $offset += $atomsize;
+                        $atomcounter++;
+                }
+
+                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 (!empty($info['playtime_seconds']) && !isset($info['video']['frame_rate']) && !empty($info['quicktime']['stts_framecount'])) {
+                        foreach ($info['quicktime']['stts_framecount'] as $key => $samples_count) {
+                                $samples_per_second = $samples_count / $info['playtime_seconds'];
+                                if ($samples_per_second > 240) {
+                                        // has to be audio samples
+                                } else {
+                                        $info['video']['frame_rate'] = $samples_per_second;
+                                        break;
+                                }
+                        }
+                }
+                if (($info['audio']['dataformat'] == 'mp4') && empty($info['video']['resolution_x'])) {
+                        $info['fileformat'] = 'mp4';
+                        $info['mime_type']  = 'audio/mp4';
+                        unset($info['video']['dataformat']);
+                }
+
+                if (!$this->ReturnAtomData) {
+                        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;
+        }
+
+        public function QuicktimeParseAtom($atomname, $atomsize, $atom_data, $baseoffset, &$atomHierarchy, $ParseAllPossibleAtoms) {
+                // http://developer.apple.com/techpubs/quicktime/qtdevdocs/APIREF/INDEX/atomalphaindex.htm
+
+                $info = &$this->getid3->info;
+
+                $atom_parent = array_pop($atomHierarchy);
+                array_push($atomHierarchy, $atomname);
+                $atom_structure['hierarchy'] = implode(' ', $atomHierarchy);
+                $atom_structure['name']      = $atomname;
+                $atom_structure['size']      = $atomsize;
+                $atom_structure['offset']    = $baseoffset;
+//echo getid3_lib::PrintHexBytes(substr($atom_data, 0, 8)).'<br>';
+//echo getid3_lib::PrintHexBytes(substr($atom_data, 0, 8), false).'<br><br>';
+                switch ($atomname) {
+                        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 '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, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
+                                break;
+
+                        case 'ilst': // Item LiST container atom
+                                $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
+
+                                // some "ilst" atoms contain data atoms that have a numeric name, and the data is far more accessible if the returned array is compacted
+                                $allnumericnames = true;
+                                foreach ($atom_structure['subatoms'] as $subatomarray) {
+                                        if (!is_integer($subatomarray['name']) || (count($subatomarray['subatoms']) != 1)) {
+                                                $allnumericnames = false;
+                                                break;
+                                        }
+                                }
+                                if ($allnumericnames) {
+                                        $newData = array();
+                                        foreach ($atom_structure['subatoms'] as $subatomarray) {
+                                                foreach ($subatomarray['subatoms'] as $newData_subatomarray) {
+                                                        unset($newData_subatomarray['hierarchy'], $newData_subatomarray['name']);
+                                                        $newData[$subatomarray['name']] = $newData_subatomarray;
+                                                        break;
+                                                }
+                                        }
+                                        $atom_structure['data'] = $newData;
+                                        unset($atom_structure['subatoms']);
+                                }
+                                break;
+
+                        case "\x00\x00\x00\x01":
+                        case "\x00\x00\x00\x02":
+                        case "\x00\x00\x00\x03":
+                        case "\x00\x00\x00\x04":
+                        case "\x00\x00\x00\x05":
+                                $atomname = getid3_lib::BigEndian2Int($atomname);
+                                $atom_structure['name'] = $atomname;
+                                $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
+                                break;
+
+                        case 'stbl': // Sample TaBLe container atom
+                                $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
+                                $isVideo = false;
+                                $framerate  = 0;
+                                $framecount = 0;
+                                foreach ($atom_structure['subatoms'] as $key => $value_array) {
+                                        if (isset($value_array['sample_description_table'])) {
+                                                foreach ($value_array['sample_description_table'] as $key2 => $value_array2) {
+                                                        if (isset($value_array2['data_format'])) {
+                                                                switch ($value_array2['data_format']) {
+                                                                        case 'avc1':
+                                                                        case 'mp4v':
+                                                                                // video data
+                                                                                $isVideo = true;
+                                                                                break;
+                                                                        case 'mp4a':
+                                                                                // audio data
+                                                                                break;
+                                                                }
+                                                        }
+                                                }
+                                        } elseif (isset($value_array['time_to_sample_table'])) {
+                                                foreach ($value_array['time_to_sample_table'] as $key2 => $value_array2) {
+                                                        if (isset($value_array2['sample_count']) && isset($value_array2['sample_duration']) && ($value_array2['sample_duration'] > 0)) {
+                                                                $framerate  = round($info['quicktime']['time_scale'] / $value_array2['sample_duration'], 3);
+                                                                $framecount = $value_array2['sample_count'];
+                                                        }
+                                                }
+                                        }
+                                }
+                                if ($isVideo && $framerate) {
+                                        $info['quicktime']['video']['frame_rate'] = $framerate;
+                                        $info['video']['frame_rate'] = $info['quicktime']['video']['frame_rate'];
+                                }
+                                if ($isVideo && $framecount) {
+                                        $info['quicktime']['video']['frame_count'] = $framecount;
+                                }
+                                break;
+
+
+                        case 'aART': // Album ARTist
+                        case 'catg': // CaTeGory
+                        case 'covr': // COVeR artwork
+                        case 'cpil': // ComPILation
+                        case 'cprt': // CoPyRighT
+                        case 'desc': // DESCription
+                        case 'disk': // DISK number
+                        case 'egid': // Episode Global ID
+                        case 'gnre': // GeNRE
+                        case 'keyw': // KEYWord
+                        case 'ldes':
+                        case 'pcst': // PodCaST
+                        case 'pgap': // GAPless Playback
+                        case 'purd': // PURchase Date
+                        case 'purl': // Podcast URL
+                        case 'rati':
+                        case 'rndu':
+                        case 'rpdu':
+                        case 'rtng': // RaTiNG
+                        case 'stik':
+                        case 'tmpo': // TeMPO (BPM)
+                        case 'trkn': // TRacK Number
+                        case 'tves': // TV EpiSode
+                        case 'tvnn': // TV Network Name
+                        case 'tvsh': // TV SHow Name
+                        case 'tvsn': // TV SeasoN
+                        case 'akID': // iTunes store account type
+                        case 'apID':
+                        case 'atID':
+                        case 'cmID':
+                        case 'cnID':
+                        case 'geID':
+                        case 'plID':
+                        case 'sfID': // iTunes store country
+                        case '©alb': // ALBum
+                        case '©art': // ARTist
+                        case '©ART':
+                        case '©aut':
+                        case '©cmt': // CoMmenT
+                        case '©com': // COMposer
+                        case '©cpy':
+                        case '©day': // content created year
+                        case '©dir':
+                        case '©ed1':
+                        case '©ed2':
+                        case '©ed3':
+                        case '©ed4':
+                        case '©ed5':
+                        case '©ed6':
+                        case '©ed7':
+                        case '©ed8':
+                        case '©ed9':
+                        case '©enc':
+                        case '©fmt':
+                        case '©gen': // GENre
+                        case '©grp': // GRouPing
+                        case '©hst':
+                        case '©inf':
+                        case '©lyr': // LYRics
+                        case '©mak':
+                        case '©mod':
+                        case '©nam': // full NAMe
+                        case '©ope':
+                        case '©PRD':
+                        case '©prd':
+                        case '©prf':
+                        case '©req':
+                        case '©src':
+                        case '©swr':
+                        case '©too': // encoder
+                        case '©trk': // TRacK
+                        case '©url':
+                        case '©wrn':
+                        case '©wrt': // WRiTer
+                        case '----': // itunes specific
+                                if ($atom_parent == 'udta') {
+                                        // User data atom handler
+                                        $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'];
+                                        }
+                                } else {
+                                        // Apple item list box atom handler
+                                        $atomoffset = 0;
+                                        if (substr($atom_data, 2, 2) == "\x10\xB5") {
+                                                // not sure what it means, but observed on iPhone4 data.
+                                                // Each $atom_data has 2 bytes of datasize, plus 0x10B5, then data
+                                                while ($atomoffset < strlen($atom_data)) {
+                                                        $boxsmallsize = getid3_lib::BigEndian2Int(substr($atom_data, $atomoffset,     2));
+                                                        $boxsmalltype =                           substr($atom_data, $atomoffset + 2, 2);
+                                                        $boxsmalldata =                           substr($atom_data, $atomoffset + 4, $boxsmallsize);
+                                                        switch ($boxsmalltype) {
+                                                                case "\x10\xB5":
+                                                                        $atom_structure['data'] = $boxsmalldata;
+                                                                        break;
+                                                                default:
+                                                                        $info['warning'][] = 'Unknown QuickTime smallbox type: "'.getid3_lib::PrintHexBytes($boxsmalltype).'" at offset '.$baseoffset;
+                                                                        $atom_structure['data'] = $atom_data;
+                                                                        break;
+                                                        }
+                                                        $atomoffset += (4 + $boxsmallsize);
+                                                }
+                                        } else {
+                                                while ($atomoffset < strlen($atom_data)) {
+                                                        $boxsize = getid3_lib::BigEndian2Int(substr($atom_data, $atomoffset, 4));
+                                                        $boxtype =                           substr($atom_data, $atomoffset + 4, 4);
+                                                        $boxdata =                           substr($atom_data, $atomoffset + 8, $boxsize - 8);
+                                                        if ($boxsize <= 1) {
+                                                                $info['warning'][] = 'Invalid QuickTime atom box size "'.$boxsize.'" in atom "'.$atomname.'" at offset: '.($atom_structure['offset'] + $atomoffset);
+                                                                $atom_structure['data'] = null;
+                                                                $atomoffset = strlen($atom_data);
+                                                                break;
+                                                        }
+                                                        $atomoffset += $boxsize;
+
+                                                        switch ($boxtype) {
+                                                                case 'mean':
+                                                                case 'name':
+                                                                        $atom_structure[$boxtype] = substr($boxdata, 4);
+                                                                        break;
+
+                                                                case 'data':
+                                                                        $atom_structure['version']   = getid3_lib::BigEndian2Int(substr($boxdata,  0, 1));
+                                                                        $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($boxdata,  1, 3));
+                                                                        switch ($atom_structure['flags_raw']) {
+                                                                                case 0:  // data flag
+                                                                                case 21: // tmpo/cpil flag
+                                                                                        switch ($atomname) {
+                                                                                                case 'cpil':
+                                                                                                case 'pcst':
+                                                                                                case 'pgap':
+                                                                                                        $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 1));
+                                                                                                        break;
+
+                                                                                                case 'tmpo':
+                                                                                                        $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 2));
+                                                                                                        break;
+
+                                                                                                case 'disk':
+                                                                                                case 'trkn':
+                                                                                                        $num       = getid3_lib::BigEndian2Int(substr($boxdata, 10, 2));
+                                                                                                        $num_total = getid3_lib::BigEndian2Int(substr($boxdata, 12, 2));
+                                                                                                        $atom_structure['data']  = empty($num) ? '' : $num;
+                                                                                                        $atom_structure['data'] .= empty($num_total) ? '' : '/'.$num_total;
+                                                                                                        break;
+
+                                                                                                case 'gnre':
+                                                                                                        $GenreID = getid3_lib::BigEndian2Int(substr($boxdata, 8, 4));
+                                                                                                        $atom_structure['data']    = getid3_id3v1::LookupGenreName($GenreID - 1);
+                                                                                                        break;
+
+                                                                                                case 'rtng':
+                                                                                                        $atom_structure[$atomname] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 1));
+                                                                                                        $atom_structure['data']    = $this->QuicktimeContentRatingLookup($atom_structure[$atomname]);
+                                                                                                        break;
+
+                                                                                                case 'stik':
+                                                                                                        $atom_structure[$atomname] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 1));
+                                                                                                        $atom_structure['data']    = $this->QuicktimeSTIKLookup($atom_structure[$atomname]);
+                                                                                                        break;
+
+                                                                                                case 'sfID':
+                                                                                                        $atom_structure[$atomname] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 4));
+                                                                                                        $atom_structure['data']    = $this->QuicktimeStoreFrontCodeLookup($atom_structure[$atomname]);
+                                                                                                        break;
+
+                                                                                                case 'egid':
+                                                                                                case 'purl':
+                                                                                                        $atom_structure['data'] = substr($boxdata, 8);
+                                                                                                        break;
+
+                                                                                                default:
+                                                                                                        $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 4));
+                                                                                        }
+                                                                                        break;
+
+                                                                                case 1:  // text flag
+                                                                                case 13: // image flag
+                                                                                default:
+                                                                                        $atom_structure['data'] = substr($boxdata, 8);
+                                                                                        break;
+
+                                                                        }
+                                                                        break;
+
+                                                                default:
+                                                                        $info['warning'][] = 'Unknown QuickTime box type: "'.getid3_lib::PrintHexBytes($boxtype).'" at offset '.$baseoffset;
+                                                                        $atom_structure['data'] = $atom_data;
+
+                                                        }
+                                                }
+                                        }
+                                }
+                                $this->CopyToAppropriateCommentsSection($atomname, $atom_structure['data'], $atom_structure['name']);
+                                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));
+
+                                $CompressedFileData = substr($atom_data, 4);
+                                if ($UncompressedHeader = @gzuncompress($CompressedFileData)) {
+                                        $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($UncompressedHeader, 0, $atomHierarchy, $ParseAllPossibleAtoms);
+                                } else {
+                                        $info['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'] = $this->QuicktimeDCOMLookup($atom_data);
+                                break;
+
+
+                        case 'rdrf': // Reference movie Data ReFerence atom
+                                $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
+                                $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
+                                $atom_structure['flags']['internal_data'] = (bool) ($atom_structure['flags_raw'] & 0x000001);
+
+                                $atom_structure['reference_type_name']    =                           substr($atom_data,  4, 4);
+                                $atom_structure['reference_length']       = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
+                                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
+                                $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['cpu_speed_rating'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
+                                break;
+
+
+                        case 'rmvc': // Reference Movie Version Check 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['gestalt_selector']   =                           substr($atom_data,  4, 4);
+                                $atom_structure['gestalt_value_mask'] = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
+                                $atom_structure['gestalt_value']      = getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
+                                $atom_structure['gestalt_check_type'] = getid3_lib::BigEndian2Int(substr($atom_data, 14, 2));
+                                break;
+
+
+                        case 'rmcd': // Reference Movie Component check 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['component_type']         =                           substr($atom_data,  4, 4);
+                                $atom_structure['component_subtype']      =                           substr($atom_data,  8, 4);
+                                $atom_structure['component_manufacturer'] =                           substr($atom_data, 12, 4);
+                                $atom_structure['component_flags_raw']    = getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
+                                $atom_structure['component_flags_mask']   = getid3_lib::BigEndian2Int(substr($atom_data, 20, 4));
+                                $atom_structure['component_min_version']  = getid3_lib::BigEndian2Int(substr($atom_data, 24, 4));
+                                break;
+
+
+                        case 'rmdr': // Reference Movie Data Rate 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['data_rate']     = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
+
+                                $atom_structure['data_rate_bps'] = $atom_structure['data_rate'] * 10;
+                                break;
+
+
+                        case 'rmla': // Reference Movie Language 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['language_id'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 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
+                                $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['track_id']  = getid3_lib::BigEndian2Int(substr($atom_data,  4, 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
+                                $atom_structure['display_size_raw']  = getid3_lib::BigEndian2Int(substr($atom_data, 0, 2));
+                                $atom_structure['reserved_1']        = getid3_lib::BigEndian2Int(substr($atom_data, 2, 2)); // hardcoded: 0x0000
+                                $atom_structure['reserved_2']        = getid3_lib::BigEndian2Int(substr($atom_data, 4, 2)); // hardcoded: 0x0000
+                                $atom_structure['slide_show_flag']   = getid3_lib::BigEndian2Int(substr($atom_data, 6, 1));
+                                $atom_structure['play_on_open_flag'] = getid3_lib::BigEndian2Int(substr($atom_data, 7, 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 {
+                                        $info['warning'][] = 'unknown "ptv " display constant ('.$atom_structure['display_size_raw'].')';
+                                }
+                                break;
+
+
+                        case 'stsd': // Sample Table Sample Description 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));
+                                $stsdEntriesDataOffset = 8;
+                                for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
+                                        $atom_structure['sample_description_table'][$i]['size']             = getid3_lib::BigEndian2Int(substr($atom_data, $stsdEntriesDataOffset, 4));
+                                        $stsdEntriesDataOffset += 4;
+                                        $atom_structure['sample_description_table'][$i]['data_format']      =                           substr($atom_data, $stsdEntriesDataOffset, 4);
+                                        $stsdEntriesDataOffset += 4;
+                                        $atom_structure['sample_description_table'][$i]['reserved']         = getid3_lib::BigEndian2Int(substr($atom_data, $stsdEntriesDataOffset, 6));
+                                        $stsdEntriesDataOffset += 6;
+                                        $atom_structure['sample_description_table'][$i]['reference_index']  = getid3_lib::BigEndian2Int(substr($atom_data, $stsdEntriesDataOffset, 2));
+                                        $stsdEntriesDataOffset += 2;
+                                        $atom_structure['sample_description_table'][$i]['data']             =                           substr($atom_data, $stsdEntriesDataOffset, ($atom_structure['sample_description_table'][$i]['size'] - 4 - 4 - 6 - 2));
+                                        $stsdEntriesDataOffset += ($atom_structure['sample_description_table'][$i]['size'] - 4 - 4 - 6 - 2);
+
+                                        $atom_structure['sample_description_table'][$i]['encoder_version']  = getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  0, 2));
+                                        $atom_structure['sample_description_table'][$i]['encoder_revision'] = getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  2, 2));
+                                        $atom_structure['sample_description_table'][$i]['encoder_vendor']   =                           substr($atom_structure['sample_description_table'][$i]['data'],  4, 4);
+
+                                        switch ($atom_structure['sample_description_table'][$i]['encoder_vendor']) {
+
+                                                case "\x00\x00\x00\x00":
+                                                        // audio atom
+                                                        $atom_structure['sample_description_table'][$i]['audio_channels']       =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  8,  2));
+                                                        $atom_structure['sample_description_table'][$i]['audio_bit_depth']      =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 10,  2));
+                                                        $atom_structure['sample_description_table'][$i]['audio_compression_id'] =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 12,  2));
+                                                        $atom_structure['sample_description_table'][$i]['audio_packet_size']    =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 14,  2));
+                                                        $atom_structure['sample_description_table'][$i]['audio_sample_rate']    = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 16,  4));
+
+                                                        switch ($atom_structure['sample_description_table'][$i]['data_format']) {
+                                                                case 'avc1':
+                                                                case 'mp4v':
+                                                                        $info['fileformat'] = 'mp4';
+                                                                        $info['video']['fourcc'] = $atom_structure['sample_description_table'][$i]['data_format'];
+                                                                        //$info['warning'][] = 'This version of getID3() ['.$this->getid3->version().'] does not fully support MPEG-4 audio/video streams'; // 2011-02-18: why am I warning about this again? What's not supported?
+                                                                        break;
+
+                                                                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
+                                                                        $atom_structure['sample_description_table'][$i]['video_temporal_quality']  =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  8,  4));
+                                                                        $atom_structure['sample_description_table'][$i]['video_spatial_quality']   =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 12,  4));
+                                                                        $atom_structure['sample_description_table'][$i]['video_frame_width']       =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 16,  2));
+                                                                        $atom_structure['sample_description_table'][$i]['video_frame_height']      =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 18,  2));
+                                                                        $atom_structure['sample_description_table'][$i]['video_resolution_x']      = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 20,  4));
+                                                                        $atom_structure['sample_description_table'][$i]['video_resolution_y']      = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 24,  4));
+                                                                        $atom_structure['sample_description_table'][$i]['video_data_size']         =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 28,  4));
+                                                                        $atom_structure['sample_description_table'][$i]['video_frame_count']       =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 32,  2));
+                                                                        $atom_structure['sample_description_table'][$i]['video_encoder_name_len']  =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 34,  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_len'] > 0) ? $atom_structure['sample_description_table'][$i]['video_encoder_name'] : $atom_structure['sample_description_table'][$i]['data_format']);
+                                                                                $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']         = 'mp4';
+                                                        $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':
+                                                        $info['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
+                                $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));
+                                $sttsEntriesDataOffset = 8;
+                                //$FrameRateCalculatorArray = array();
+                                $frames_count = 0;
+                                for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
+                                        $atom_structure['time_to_sample_table'][$i]['sample_count']    = getid3_lib::BigEndian2Int(substr($atom_data, $sttsEntriesDataOffset, 4));
+                                        $sttsEntriesDataOffset += 4;
+                                        $atom_structure['time_to_sample_table'][$i]['sample_duration'] = getid3_lib::BigEndian2Int(substr($atom_data, $sttsEntriesDataOffset, 4));
+                                        $sttsEntriesDataOffset += 4;
+
+                                        $frames_count += $atom_structure['time_to_sample_table'][$i]['sample_count'];
+
+                                        // THIS SECTION REPLACED WITH CODE IN "stbl" ATOM
+                                        //if (!empty($info['quicktime']['time_scale']) && ($atom_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);
+                                        //      }
+                                        //}
+                                        //
+                                        //$FrameRateCalculatorArray[($info['quicktime']['time_scale'] / $atom_structure['time_to_sample_table'][$i]['sample_duration'])] += $atom_structure['time_to_sample_table'][$i]['sample_count'];
+                                }
+                                $info['quicktime']['stts_framecount'][] = $frames_count;
+                                //$sttsFramesTotal  = 0;
+                                //$sttsSecondsTotal = 0;
+                                //foreach ($FrameRateCalculatorArray as $frames_per_second => $frame_count) {
+                                //      if (($frames_per_second > 60) || ($frames_per_second < 1)) {
+                                //              // not video FPS information, probably audio information
+                                //              $sttsFramesTotal  = 0;
+                                //              $sttsSecondsTotal = 0;
+                                //              break;
+                                //      }
+                                //      $sttsFramesTotal  += $frame_count;
+                                //      $sttsSecondsTotal += $frame_count / $frames_per_second;
+                                //}
+                                //if (($sttsFramesTotal > 0) && ($sttsSecondsTotal > 0)) {
+                                //      if (($sttsFramesTotal / $sttsSecondsTotal) > $info['video']['frame_rate']) {
+                                //              $info['video']['frame_rate'] = $sttsFramesTotal / $sttsSecondsTotal;
+                                //      }
+                                //}
+                                break;
+
+
+                        case 'stss': // Sample Table Sync Sample (key frames) atom
+                                if ($ParseAllPossibleAtoms) {
+                                        $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));
+                                        $stssEntriesDataOffset = 8;
+                                        for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
+                                                $atom_structure['time_to_sample_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stssEntriesDataOffset, 4));
+                                                $stssEntriesDataOffset += 4;
+                                        }
+                                }
+                                break;
+
+
+                        case 'stsc': // Sample Table Sample-to-Chunk atom
+                                if ($ParseAllPossibleAtoms) {
+                                        $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));
+                                        $stscEntriesDataOffset = 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, $stscEntriesDataOffset, 4));
+                                                $stscEntriesDataOffset += 4;
+                                                $atom_structure['sample_to_chunk_table'][$i]['samples_per_chunk']  = getid3_lib::BigEndian2Int(substr($atom_data, $stscEntriesDataOffset, 4));
+                                                $stscEntriesDataOffset += 4;
+                                                $atom_structure['sample_to_chunk_table'][$i]['sample_description'] = getid3_lib::BigEndian2Int(substr($atom_data, $stscEntriesDataOffset, 4));
+                                                $stscEntriesDataOffset += 4;
+                                        }
+                                }
+                                break;
+
+
+                        case 'stsz': // Sample Table SiZe atom
+                                if ($ParseAllPossibleAtoms) {
+                                        $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));
+                                        $stszEntriesDataOffset = 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, $stszEntriesDataOffset, 4));
+                                                        $stszEntriesDataOffset += 4;
+                                                }
+                                        }
+                                }
+                                break;
+
+
+                        case 'stco': // Sample Table Chunk Offset atom
+                                if ($ParseAllPossibleAtoms) {
+                                        $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));
+                                        $stcoEntriesDataOffset = 8;
+                                        for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
+                                                $atom_structure['chunk_offset_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stcoEntriesDataOffset, 4));
+                                                $stcoEntriesDataOffset += 4;
+                                        }
+                                }
+                                break;
+
+
+                        case 'co64': // Chunk Offset 64-bit (version of "stco" that supports > 2GB files)
+                                if ($ParseAllPossibleAtoms) {
+                                        $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));
+                                        $stcoEntriesDataOffset = 8;
+                                        for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
+                                                $atom_structure['chunk_offset_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stcoEntriesDataOffset, 8));
+                                                $stcoEntriesDataOffset += 8;
+                                        }
+                                }
+                                break;
+
+
+                        case 'dref': // Data REFerence 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));
+                                $drefDataOffset = 8;
+                                for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
+                                        $atom_structure['data_references'][$i]['size']                    = getid3_lib::BigEndian2Int(substr($atom_data, $drefDataOffset, 4));
+                                        $drefDataOffset += 4;
+                                        $atom_structure['data_references'][$i]['type']                    =               substr($atom_data, $drefDataOffset, 4);
+                                        $drefDataOffset += 4;
+                                        $atom_structure['data_references'][$i]['version']                 = getid3_lib::BigEndian2Int(substr($atom_data,  $drefDataOffset, 1));
+                                        $drefDataOffset += 1;
+                                        $atom_structure['data_references'][$i]['flags_raw']               = getid3_lib::BigEndian2Int(substr($atom_data,  $drefDataOffset, 3)); // hardcoded: 0x0000
+                                        $drefDataOffset += 3;
+                                        $atom_structure['data_references'][$i]['data']                    =               substr($atom_data, $drefDataOffset, ($atom_structure['data_references'][$i]['size'] - 4 - 4 - 1 - 3));
+                                        $drefDataOffset += ($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
+                                $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['graphics_mode']          = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
+                                $atom_structure['opcolor_red']            = getid3_lib::BigEndian2Int(substr($atom_data,  6, 2));
+                                $atom_structure['opcolor_green']          = getid3_lib::BigEndian2Int(substr($atom_data,  8, 2));
+                                $atom_structure['opcolor_blue']           = getid3_lib::BigEndian2Int(substr($atom_data, 10, 2));
+                                $atom_structure['balance']                = getid3_lib::BigEndian2Int(substr($atom_data, 12, 2));
+                                $atom_structure['reserved']               = getid3_lib::BigEndian2Int(substr($atom_data, 14, 2));
+                                break;
+
+
+                        case 'smhd': // Sound Media information HeaDer 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['balance']                = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
+                                $atom_structure['reserved']               = getid3_lib::BigEndian2Int(substr($atom_data,  6, 2));
+                                break;
+
+
+                        case 'vmhd': // Video Media information HeaDer atom
+                                $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
+                                $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
+                                $atom_structure['graphics_mode']          = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
+                                $atom_structure['opcolor_red']            = getid3_lib::BigEndian2Int(substr($atom_data,  6, 2));
+                                $atom_structure['opcolor_green']          = getid3_lib::BigEndian2Int(substr($atom_data,  8, 2));
+                                $atom_structure['opcolor_blue']           = getid3_lib::BigEndian2Int(substr($atom_data, 10, 2));
+
+                                $atom_structure['flags']['no_lean_ahead'] = (bool) ($atom_structure['flags_raw'] & 0x001);
+                                break;
+
+
+                        case 'hdlr': // HanDLeR reference 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['component_type']         =                           substr($atom_data,  4, 4);
+                                $atom_structure['component_subtype']      =                           substr($atom_data,  8, 4);
+                                $atom_structure['component_manufacturer'] =                           substr($atom_data, 12, 4);
+                                $atom_structure['component_flags_raw']    = getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
+                                $atom_structure['component_flags_mask']   = getid3_lib::BigEndian2Int(substr($atom_data, 20, 4));
+                                $atom_structure['component_name']         =      $this->Pascal2String(substr($atom_data, 24));
+
+                                if (($atom_structure['component_subtype'] == 'STpn') && ($atom_structure['component_manufacturer'] == 'zzzz')) {
+                                        $info['video']['dataformat'] = 'quicktimevr';
+                                }
+                                break;
+
+
+                        case 'mdhd': // MeDia HeaDer 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['creation_time']         = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
+                                $atom_structure['modify_time']           = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
+                                $atom_structure['time_scale']            = getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
+                                $atom_structure['duration']              = getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
+                                $atom_structure['language_id']           = getid3_lib::BigEndian2Int(substr($atom_data, 20, 2));
+                                $atom_structure['quality']               = getid3_lib::BigEndian2Int(substr($atom_data, 22, 2));
+
+                                if ($atom_structure['time_scale'] == 0) {
+                                        $info['error'][] = 'Corrupt Quicktime file: mdhd.time_scale == zero';
+                                        return false;
+                                }
+                                $info['quicktime']['time_scale'] = (isset($info['quicktime']['time_scale']) ? max($info['quicktime']['time_scale'], $atom_structure['time_scale']) : $atom_structure['time_scale']);
+
+                                $atom_structure['creation_time_unix']    = getid3_lib::DateMac2Unix($atom_structure['creation_time']);
+                                $atom_structure['modify_time_unix']      = getid3_lib::DateMac2Unix($atom_structure['modify_time']);
+                                $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
+                                $atom_structure['modification_date']      = getid3_lib::BigEndian2Int(substr($atom_data,  0, 4)); // "standard Macintosh format"
+                                $atom_structure['version_number']         = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2)); // hardcoded: 0x00
+                                $atom_structure['atom_type']              =               substr($atom_data,  6, 4);        // usually: 'PICT'
+                                $atom_structure['atom_index']             = getid3_lib::BigEndian2Int(substr($atom_data, 10, 2)); // usually: 0x01
+
+                                $atom_structure['modification_date_unix'] = getid3_lib::DateMac2Unix($atom_structure['modification_date']);
+                                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
+                                $atom_structure['preload_start_time'] = getid3_lib::BigEndian2Int(substr($atom_data,  0, 4));
+                                $atom_structure['preload_duration']   = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
+                                $atom_structure['preload_flags_raw']  = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
+                                $atom_structure['default_hints_raw']  = getid3_lib::BigEndian2Int(substr($atom_data, 12, 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
+                                $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));
+                                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_lib::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
+                                $atom_structure['version']            =   getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
+                                $atom_structure['flags_raw']          =   getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
+                                $atom_structure['creation_time']      =   getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
+                                $atom_structure['modify_time']        =   getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
+                                $atom_structure['time_scale']         =   getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
+                                $atom_structure['duration']           =   getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
+                                $atom_structure['preferred_rate']     = getid3_lib::FixedPoint16_16(substr($atom_data, 20, 4));
+                                $atom_structure['preferred_volume']   =   getid3_lib::FixedPoint8_8(substr($atom_data, 24, 2));
+                                $atom_structure['reserved']           =                             substr($atom_data, 26, 10);
+                                $atom_structure['matrix_a']           = getid3_lib::FixedPoint16_16(substr($atom_data, 36, 4));
+                                $atom_structure['matrix_b']           = getid3_lib::FixedPoint16_16(substr($atom_data, 40, 4));
+                                $atom_structure['matrix_u']           =  getid3_lib::FixedPoint2_30(substr($atom_data, 44, 4));
+                                $atom_structure['matrix_c']           = getid3_lib::FixedPoint16_16(substr($atom_data, 48, 4));
+                                $atom_structure['matrix_d']           = getid3_lib::FixedPoint16_16(substr($atom_data, 52, 4));
+                                $atom_structure['matrix_v']           =  getid3_lib::FixedPoint2_30(substr($atom_data, 56, 4));
+                                $atom_structure['matrix_x']           = getid3_lib::FixedPoint16_16(substr($atom_data, 60, 4));
+                                $atom_structure['matrix_y']           = getid3_lib::FixedPoint16_16(substr($atom_data, 64, 4));
+                                $atom_structure['matrix_w']           =  getid3_lib::FixedPoint2_30(substr($atom_data, 68, 4));
+                                $atom_structure['preview_time']       =   getid3_lib::BigEndian2Int(substr($atom_data, 72, 4));
+                                $atom_structure['preview_duration']   =   getid3_lib::BigEndian2Int(substr($atom_data, 76, 4));
+                                $atom_structure['poster_time']        =   getid3_lib::BigEndian2Int(substr($atom_data, 80, 4));
+                                $atom_structure['selection_time']     =   getid3_lib::BigEndian2Int(substr($atom_data, 84, 4));
+                                $atom_structure['selection_duration'] =   getid3_lib::BigEndian2Int(substr($atom_data, 88, 4));
+                                $atom_structure['current_time']       =   getid3_lib::BigEndian2Int(substr($atom_data, 92, 4));
+                                $atom_structure['next_track_id']      =   getid3_lib::BigEndian2Int(substr($atom_data, 96, 4));
+
+                                if ($atom_structure['time_scale'] == 0) {
+                                        $info['error'][] = 'Corrupt Quicktime file: mvhd.time_scale == zero';
+                                        return false;
+                                }
+                                $atom_structure['creation_time_unix']        = getid3_lib::DateMac2Unix($atom_structure['creation_time']);
+                                $atom_structure['modify_time_unix']          = getid3_lib::DateMac2Unix($atom_structure['modify_time']);
+                                $info['quicktime']['time_scale']    = (isset($info['quicktime']['time_scale']) ? max($info['quicktime']['time_scale'], $atom_structure['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
+                                $atom_structure['version']             =   getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
+                                $atom_structure['flags_raw']           =   getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
+                                $atom_structure['creation_time']       =   getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
+                                $atom_structure['modify_time']         =   getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
+                                $atom_structure['trackid']             =   getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
+                                $atom_structure['reserved1']           =   getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
+                                $atom_structure['duration']            =   getid3_lib::BigEndian2Int(substr($atom_data, 20, 4));
+                                $atom_structure['reserved2']           =   getid3_lib::BigEndian2Int(substr($atom_data, 24, 8));
+                                $atom_structure['layer']               =   getid3_lib::BigEndian2Int(substr($atom_data, 32, 2));
+                                $atom_structure['alternate_group']     =   getid3_lib::BigEndian2Int(substr($atom_data, 34, 2));
+                                $atom_structure['volume']              =   getid3_lib::FixedPoint8_8(substr($atom_data, 36, 2));
+                                $atom_structure['reserved3']           =   getid3_lib::BigEndian2Int(substr($atom_data, 38, 2));
+                                $atom_structure['matrix_a']            = getid3_lib::FixedPoint16_16(substr($atom_data, 40, 4));
+                                $atom_structure['matrix_b']            = getid3_lib::FixedPoint16_16(substr($atom_data, 44, 4));
+                                $atom_structure['matrix_u']            = getid3_lib::FixedPoint16_16(substr($atom_data, 48, 4));
+                                $atom_structure['matrix_c']            = getid3_lib::FixedPoint16_16(substr($atom_data, 52, 4));
+                                $atom_structure['matrix_d']            = getid3_lib::FixedPoint16_16(substr($atom_data, 56, 4));
+                                $atom_structure['matrix_v']            = getid3_lib::FixedPoint16_16(substr($atom_data, 60, 4));
+                                $atom_structure['matrix_x']            =  getid3_lib::FixedPoint2_30(substr($atom_data, 64, 4));
+                                $atom_structure['matrix_y']            =  getid3_lib::FixedPoint2_30(substr($atom_data, 68, 4));
+                                $atom_structure['matrix_w']            =  getid3_lib::FixedPoint2_30(substr($atom_data, 72, 4));
+                                $atom_structure['width']               = getid3_lib::FixedPoint16_16(substr($atom_data, 76, 4));
+                                $atom_structure['height']              = getid3_lib::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']  = getid3_lib::DateMac2Unix($atom_structure['creation_time']);
+                                $atom_structure['modify_time_unix']    = getid3_lib::DateMac2Unix($atom_structure['modify_time']);
+
+                                if ($atom_structure['flags']['enabled'] == 1) {
+                                        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'];
+                                        }
+                                        $info['video']['resolution_x'] = max($info['video']['resolution_x'], $atom_structure['width']);
+                                        $info['video']['resolution_y'] = max($info['video']['resolution_y'], $atom_structure['height']);
+                                        $info['quicktime']['video']['resolution_x'] = $info['video']['resolution_x'];
+                                        $info['quicktime']['video']['resolution_y'] = $info['video']['resolution_y'];
+                                } else {
+                                        // see: http://www.getid3.org/phpBB3/viewtopic.php?t=1295
+                                        //if (isset($info['video']['resolution_x'])) { unset($info['video']['resolution_x']); }
+                                        //if (isset($info['video']['resolution_y'])) { unset($info['video']['resolution_y']); }
+                                        //if (isset($info['quicktime']['video']))    { unset($info['quicktime']['video']);    }
+                                }
+                                break;
+
+
+                        case 'iods': // Initial Object DeScriptor atom
+                                // http://www.koders.com/c/fid1FAB3E762903DC482D8A246D4A4BF9F28E049594.aspx?s=windows.h
+                                // http://libquicktime.sourcearchive.com/documentation/1.0.2plus-pdebian/iods_8c-source.html
+                                $offset = 0;
+                                $atom_structure['version']                =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                $offset += 1;
+                                $atom_structure['flags_raw']              =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 3));
+                                $offset += 3;
+                                $atom_structure['mp4_iod_tag']            =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                $offset += 1;
+                                $atom_structure['length']                 = $this->quicktime_read_mp4_descr_length($atom_data, $offset);
+                                //$offset already adjusted by quicktime_read_mp4_descr_length()
+                                $atom_structure['object_descriptor_id']   =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 2));
+                                $offset += 2;
+                                $atom_structure['od_profile_level']       =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                $offset += 1;
+                                $atom_structure['scene_profile_level']    =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                $offset += 1;
+                                $atom_structure['audio_profile_id']       =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                $offset += 1;
+                                $atom_structure['video_profile_id']       =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                $offset += 1;
+                                $atom_structure['graphics_profile_level'] =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                $offset += 1;
+
+                                $atom_structure['num_iods_tracks'] = ($atom_structure['length'] - 7) / 6; // 6 bytes would only be right if all tracks use 1-byte length fields
+                                for ($i = 0; $i < $atom_structure['num_iods_tracks']; $i++) {
+                                        $atom_structure['track'][$i]['ES_ID_IncTag'] =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
+                                        $offset += 1;
+                                        $atom_structure['track'][$i]['length']       = $this->quicktime_read_mp4_descr_length($atom_data, $offset);
+                                        //$offset already adjusted by quicktime_read_mp4_descr_length()
+                                        $atom_structure['track'][$i]['track_id']     =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 4));
+                                        $offset += 4;
+                                }
+
+                                $atom_structure['audio_profile_name'] = $this->QuicktimeIODSaudioProfileName($atom_structure['audio_profile_id']);
+                                $atom_structure['video_profile_name'] = $this->QuicktimeIODSvideoProfileName($atom_structure['video_profile_id']);
+                                break;
+
+                        case 'ftyp': // FileTYPe (?) atom (for MP4 it seems)
+                                $atom_structure['signature'] =                           substr($atom_data,  0, 4);
+                                $atom_structure['unknown_1'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
+                                $atom_structure['fourcc']    =                           substr($atom_data,  8, 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);
+                                $info['quicktime']['controller'] = $atom_structure['ctyp'];
+                                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;
+
+
+                        // Observed-but-not-handled atom types are just listed here to prevent warnings being generated
+                        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
+                        case 'tapt': // TrackApertureModeDimensionsAID - http://developer.apple.com/documentation/QuickTime/Reference/QT7-1_Update_Reference/Constants/Constants.html
+                                                // tapt seems to be used to compute the video size [http://www.getid3.org/phpBB3/viewtopic.php?t=838]
+                                                // * http://lists.apple.com/archives/quicktime-api/2006/Aug/msg00014.html
+                                                // * http://handbrake.fr/irclogs/handbrake-dev/handbrake-dev20080128_pg2.html
+                        case 'ctts'://  STCompositionOffsetAID             - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
+                        case 'cslg'://  STCompositionShiftLeastGreatestAID - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
+                        case 'sdtp'://  STSampleDependencyAID              - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
+                        case 'stps'://  STPartialSyncSampleAID             - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
+                                //$atom_structure['data'] = $atom_data;
+                                break;
+
+                        case '©xyz':  // GPS latitude+longitude+altitude
+                                $atom_structure['data'] = $atom_data;
+                                if (preg_match('#([\\+\\-][0-9\\.]+)([\\+\\-][0-9\\.]+)([\\+\\-][0-9\\.]+)?/$#i', $atom_data, $matches)) {
+                                        @list($all, $latitude, $longitude, $altitude) = $matches;
+                                        $info['quicktime']['comments']['gps_latitude'][]  = floatval($latitude);
+                                        $info['quicktime']['comments']['gps_longitude'][] = floatval($longitude);
+                                        if (!empty($altitude)) {
+                                                $info['quicktime']['comments']['gps_altitude'][] = floatval($altitude);
+                                        }
+                                } else {
+                                        $info['warning'][] = 'QuickTime atom "©xyz" data does not match expected data pattern at offset '.$baseoffset.'. Please report as getID3() bug.';
+                                }
+                                break;
+
+                        case 'NCDT':
+                                // http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html
+                                // Nikon-specific QuickTime tags found in the NCDT atom of MOV videos from some Nikon cameras such as the Coolpix S8000 and D5100
+                                $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 4, $atomHierarchy, $ParseAllPossibleAtoms);
+                                break;
+                        case 'NCTH': // Nikon Camera THumbnail image
+                        case 'NCVW': // Nikon Camera preVieW image
+                                // http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html
+                                if (preg_match('/^\xFF\xD8\xFF/', $atom_data)) {
+                                        $atom_structure['data'] = $atom_data;
+                                        $atom_structure['image_mime'] = 'image/jpeg';
+                                        $atom_structure['description'] = (($atomname == 'NCTH') ? 'Nikon Camera Thumbnail Image' : (($atomname == 'NCVW') ? 'Nikon Camera Preview Image' : 'Nikon preview image'));
+                                        $info['quicktime']['comments']['picture'][] = array('image_mime'=>$atom_structure['image_mime'], 'data'=>$atom_data, 'description'=>$atom_structure['description']);
+                                }
+                                break;
+                        case 'NCHD': // MakerNoteVersion
+                                // http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html
+                                $atom_structure['data'] = $atom_data;
+                                break;
+                        case 'NCTG': // NikonTags
+                                // http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html#NCTG
+                                $atom_structure['data'] = $this->QuicktimeParseNikonNCTG($atom_data);
+                                break;
+                        case 'NCDB': // NikonTags
+                                // http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html
+                                $atom_structure['data'] = $atom_data;
+                                break;
+
+                        case "\x00\x00\x00\x00":
+                        case 'meta': // METAdata atom
+                                // some kind of metacontainer, may contain a big data dump such as:
+                                // mdta keys  mdtacom.apple.quicktime.make (mdtacom.apple.quicktime.creationdate ,mdtacom.apple.quicktime.location.ISO6709 $mdtacom.apple.quicktime.software !mdtacom.apple.quicktime.model ilst 
  data DEApple 0  (data DE2011-05-11T17:54:04+0200 2  *data DE+52.4936+013.3897+040.247/ 
  data DE4.3.1  data DEiPhone 4
+                                // http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt
+
+                    $atom_structure['version']   =          getid3_lib::BigEndian2Int(substr($atom_data, 0, 1));
+                    $atom_structure['flags_raw'] =          getid3_lib::BigEndian2Int(substr($atom_data, 1, 3));
+                    $atom_structure['subatoms']  = $this->QuicktimeParseContainerAtom(substr($atom_data, 4), $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
+                                //$atom_structure['subatoms']  = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
+                                break;
+
+                        case 'data': // metaDATA atom
+                                // seems to be 2 bytes language code (ASCII), 2 bytes unknown (set to 0x10B5 in sample I have), remainder is useful data
+                                $atom_structure['language'] =                           substr($atom_data, 4 + 0, 2);
+                                $atom_structure['unknown']  = getid3_lib::BigEndian2Int(substr($atom_data, 4 + 2, 2));
+                                $atom_structure['data']     =                           substr($atom_data, 4 + 4);
+                                break;
+
+                        default:
+                                $info['warning'][] = 'Unknown QuickTime atom type: "'.$atomname.'" ('.trim(getid3_lib::PrintHexBytes($atomname)).') at offset '.$baseoffset;
+                                $atom_structure['data'] = $atom_data;
+                                break;
+                }
+                array_pop($atomHierarchy);
+                return $atom_structure;
+        }
+
+        public function QuicktimeParseContainerAtom($atom_data, $baseoffset, &$atomHierarchy, $ParseAllPossibleAtoms) {
+//echo 'QuicktimeParseContainerAtom('.substr($atom_data, 4, 4).') @ '.$baseoffset.'<br><br>';
+                $atom_structure  = false;
+                $subatomoffset  = 0;
+                $subatomcounter = 0;
+                if ((strlen($atom_data) == 4) && (getid3_lib::BigEndian2Int($atom_data) == 0x00000000)) {
+                        return false;
+                }
+                while ($subatomoffset < strlen($atom_data)) {
+                        $subatomsize = getid3_lib::BigEndian2Int(substr($atom_data, $subatomoffset + 0, 4));
+                        $subatomname =                           substr($atom_data, $subatomoffset + 4, 4);
+                        $subatomdata =                           substr($atom_data, $subatomoffset + 8, $subatomsize - 8);
+                        if ($subatomsize == 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[$subatomcounter] = $this->QuicktimeParseAtom($subatomname, $subatomsize, $subatomdata, $baseoffset + $subatomoffset, $atomHierarchy, $ParseAllPossibleAtoms);
+
+                        $subatomoffset += $subatomsize;
+                        $subatomcounter++;
+                }
+                return $atom_structure;
+        }
+
+
+        public function quicktime_read_mp4_descr_length($data, &$offset) {
+                // http://libquicktime.sourcearchive.com/documentation/2:1.0.2plus-pdebian-2build1/esds_8c-source.html
+                $num_bytes = 0;
+                $length    = 0;
+                do {
+                        $b = ord(substr($data, $offset++, 1));
+                        $length = ($length << 7) | ($b & 0x7F);
+                } while (($b & 0x80) && ($num_bytes++ < 4));
+                return $length;
+        }
+
+
+        public function QuicktimeLanguageLookup($languageid) {
+                static $QuicktimeLanguageLookup = array();
+                if (empty($QuicktimeLanguageLookup)) {
+                        $QuicktimeLanguageLookup[0]   = 'English';
+                        $QuicktimeLanguageLookup[1]   = 'French';
+                        $QuicktimeLanguageLookup[2]   = 'German';
+                        $QuicktimeLanguageLookup[3]   = 'Italian';
+                        $QuicktimeLanguageLookup[4]   = 'Dutch';
+                        $QuicktimeLanguageLookup[5]   = 'Swedish';
+                        $QuicktimeLanguageLookup[6]   = 'Spanish';
+                        $QuicktimeLanguageLookup[7]   = 'Danish';
+                        $QuicktimeLanguageLookup[8]   = 'Portuguese';
+                        $QuicktimeLanguageLookup[9]   = 'Norwegian';
+                        $QuicktimeLanguageLookup[10]  = 'Hebrew';
+                        $QuicktimeLanguageLookup[11]  = 'Japanese';
+                        $QuicktimeLanguageLookup[12]  = 'Arabic';
+                        $QuicktimeLanguageLookup[13]  = 'Finnish';
+                        $QuicktimeLanguageLookup[14]  = 'Greek';
+                        $QuicktimeLanguageLookup[15]  = 'Icelandic';
+                        $QuicktimeLanguageLookup[16]  = 'Maltese';
+                        $QuicktimeLanguageLookup[17]  = 'Turkish';
+                        $QuicktimeLanguageLookup[18]  = 'Croatian';
+                        $QuicktimeLanguageLookup[19]  = 'Chinese (Traditional)';
+                        $QuicktimeLanguageLookup[20]  = 'Urdu';
+                        $QuicktimeLanguageLookup[21]  = 'Hindi';
+                        $QuicktimeLanguageLookup[22]  = 'Thai';
+                        $QuicktimeLanguageLookup[23]  = 'Korean';
+                        $QuicktimeLanguageLookup[24]  = 'Lithuanian';
+                        $QuicktimeLanguageLookup[25]  = 'Polish';
+                        $QuicktimeLanguageLookup[26]  = 'Hungarian';
+                        $QuicktimeLanguageLookup[27]  = 'Estonian';
+                        $QuicktimeLanguageLookup[28]  = 'Lettish';
+                        $QuicktimeLanguageLookup[28]  = 'Latvian';
+                        $QuicktimeLanguageLookup[29]  = 'Saamisk';
+                        $QuicktimeLanguageLookup[29]  = 'Lappish';
+                        $QuicktimeLanguageLookup[30]  = 'Faeroese';
+                        $QuicktimeLanguageLookup[31]  = 'Farsi';
+                        $QuicktimeLanguageLookup[31]  = 'Persian';
+                        $QuicktimeLanguageLookup[32]  = 'Russian';
+                        $QuicktimeLanguageLookup[33]  = 'Chinese (Simplified)';
+                        $QuicktimeLanguageLookup[34]  = 'Flemish';
+                        $QuicktimeLanguageLookup[35]  = 'Irish';
+                        $QuicktimeLanguageLookup[36]  = 'Albanian';
+                        $QuicktimeLanguageLookup[37]  = 'Romanian';
+                        $QuicktimeLanguageLookup[38]  = 'Czech';
+                        $QuicktimeLanguageLookup[39]  = 'Slovak';
+                        $QuicktimeLanguageLookup[40]  = 'Slovenian';
+                        $QuicktimeLanguageLookup[41]  = 'Yiddish';
+                        $QuicktimeLanguageLookup[42]  = 'Serbian';
+                        $QuicktimeLanguageLookup[43]  = 'Macedonian';
+                        $QuicktimeLanguageLookup[44]  = 'Bulgarian';
+                        $QuicktimeLanguageLookup[45]  = 'Ukrainian';
+                        $QuicktimeLanguageLookup[46]  = 'Byelorussian';
+                        $QuicktimeLanguageLookup[47]  = 'Uzbek';
+                        $QuicktimeLanguageLookup[48]  = 'Kazakh';
+                        $QuicktimeLanguageLookup[49]  = 'Azerbaijani';
+                        $QuicktimeLanguageLookup[50]  = 'AzerbaijanAr';
+                        $QuicktimeLanguageLookup[51]  = 'Armenian';
+                        $QuicktimeLanguageLookup[52]  = 'Georgian';
+                        $QuicktimeLanguageLookup[53]  = 'Moldavian';
+                        $QuicktimeLanguageLookup[54]  = 'Kirghiz';
+                        $QuicktimeLanguageLookup[55]  = 'Tajiki';
+                        $QuicktimeLanguageLookup[56]  = 'Turkmen';
+                        $QuicktimeLanguageLookup[57]  = 'Mongolian';
+                        $QuicktimeLanguageLookup[58]  = 'MongolianCyr';
+                        $QuicktimeLanguageLookup[59]  = 'Pashto';
+                        $QuicktimeLanguageLookup[60]  = 'Kurdish';
+                        $QuicktimeLanguageLookup[61]  = 'Kashmiri';
+                        $QuicktimeLanguageLookup[62]  = 'Sindhi';
+                        $QuicktimeLanguageLookup[63]  = 'Tibetan';
+                        $QuicktimeLanguageLookup[64]  = 'Nepali';
+                        $QuicktimeLanguageLookup[65]  = 'Sanskrit';
+                        $QuicktimeLanguageLookup[66]  = 'Marathi';
+                        $QuicktimeLanguageLookup[67]  = 'Bengali';
+                        $QuicktimeLanguageLookup[68]  = 'Assamese';
+                        $QuicktimeLanguageLookup[69]  = 'Gujarati';
+                        $QuicktimeLanguageLookup[70]  = 'Punjabi';
+                        $QuicktimeLanguageLookup[71]  = 'Oriya';
+                        $QuicktimeLanguageLookup[72]  = 'Malayalam';
+                        $QuicktimeLanguageLookup[73]  = 'Kannada';
+                        $QuicktimeLanguageLookup[74]  = 'Tamil';
+                        $QuicktimeLanguageLookup[75]  = 'Telugu';
+                        $QuicktimeLanguageLookup[76]  = 'Sinhalese';
+                        $QuicktimeLanguageLookup[77]  = 'Burmese';
+                        $QuicktimeLanguageLookup[78]  = 'Khmer';
+                        $QuicktimeLanguageLookup[79]  = 'Lao';
+                        $QuicktimeLanguageLookup[80]  = 'Vietnamese';
+                        $QuicktimeLanguageLookup[81]  = 'Indonesian';
+                        $QuicktimeLanguageLookup[82]  = 'Tagalog';
+                        $QuicktimeLanguageLookup[83]  = 'MalayRoman';
+                        $QuicktimeLanguageLookup[84]  = 'MalayArabic';
+                        $QuicktimeLanguageLookup[85]  = 'Amharic';
+                        $QuicktimeLanguageLookup[86]  = 'Tigrinya';
+                        $QuicktimeLanguageLookup[87]  = 'Galla';
+                        $QuicktimeLanguageLookup[87]  = 'Oromo';
+                        $QuicktimeLanguageLookup[88]  = 'Somali';
+                        $QuicktimeLanguageLookup[89]  = 'Swahili';
+                        $QuicktimeLanguageLookup[90]  = 'Ruanda';
+                        $QuicktimeLanguageLookup[91]  = 'Rundi';
+                        $QuicktimeLanguageLookup[92]  = 'Chewa';
+                        $QuicktimeLanguageLookup[93]  = 'Malagasy';
+                        $QuicktimeLanguageLookup[94]  = 'Esperanto';
+                        $QuicktimeLanguageLookup[128] = 'Welsh';
+                        $QuicktimeLanguageLookup[129] = 'Basque';
+                        $QuicktimeLanguageLookup[130] = 'Catalan';
+                        $QuicktimeLanguageLookup[131] = 'Latin';
+                        $QuicktimeLanguageLookup[132] = 'Quechua';
+                        $QuicktimeLanguageLookup[133] = 'Guarani';
+                        $QuicktimeLanguageLookup[134] = 'Aymara';
+                        $QuicktimeLanguageLookup[135] = 'Tatar';
+                        $QuicktimeLanguageLookup[136] = 'Uighur';
+                        $QuicktimeLanguageLookup[137] = 'Dzongkha';
+                        $QuicktimeLanguageLookup[138] = 'JavaneseRom';
+                }
+                return (isset($QuicktimeLanguageLookup[$languageid]) ? $QuicktimeLanguageLookup[$languageid] : 'invalid');
+        }
+
+        public function QuicktimeVideoCodecLookup($codecid) {
+                static $QuicktimeVideoCodecLookup = array();
+                if (empty($QuicktimeVideoCodecLookup)) {
+                        $QuicktimeVideoCodecLookup['.SGI'] = 'SGI';
+                        $QuicktimeVideoCodecLookup['3IV1'] = '3ivx MPEG-4 v1';
+                        $QuicktimeVideoCodecLookup['3IV2'] = '3ivx MPEG-4 v2';
+                        $QuicktimeVideoCodecLookup['3IVX'] = '3ivx MPEG-4';
+                        $QuicktimeVideoCodecLookup['8BPS'] = 'Planar RGB';
+                        $QuicktimeVideoCodecLookup['avc1'] = 'H.264/MPEG-4 AVC';
+                        $QuicktimeVideoCodecLookup['avr '] = 'AVR-JPEG';
+                        $QuicktimeVideoCodecLookup['b16g'] = '16Gray';
+                        $QuicktimeVideoCodecLookup['b32a'] = '32AlphaGray';
+                        $QuicktimeVideoCodecLookup['b48r'] = '48RGB';
+                        $QuicktimeVideoCodecLookup['b64a'] = '64ARGB';
+                        $QuicktimeVideoCodecLookup['base'] = 'Base';
+                        $QuicktimeVideoCodecLookup['clou'] = 'Cloud';
+                        $QuicktimeVideoCodecLookup['cmyk'] = 'CMYK';
+                        $QuicktimeVideoCodecLookup['cvid'] = 'Cinepak';
+                        $QuicktimeVideoCodecLookup['dmb1'] = 'OpenDML JPEG';
+                        $QuicktimeVideoCodecLookup['dvc '] = 'DVC-NTSC';
+                        $QuicktimeVideoCodecLookup['dvcp'] = 'DVC-PAL';
+                        $QuicktimeVideoCodecLookup['dvpn'] = 'DVCPro-NTSC';
+                        $QuicktimeVideoCodecLookup['dvpp'] = 'DVCPro-PAL';
+                        $QuicktimeVideoCodecLookup['fire'] = 'Fire';
+                        $QuicktimeVideoCodecLookup['flic'] = 'FLC';
+                        $QuicktimeVideoCodecLookup['gif '] = 'GIF';
+                        $QuicktimeVideoCodecLookup['h261'] = 'H261';
+                        $QuicktimeVideoCodecLookup['h263'] = 'H263';
+                        $QuicktimeVideoCodecLookup['IV41'] = 'Indeo4';
+                        $QuicktimeVideoCodecLookup['jpeg'] = 'JPEG';
+                        $QuicktimeVideoCodecLookup['kpcd'] = 'PhotoCD';
+                        $QuicktimeVideoCodecLookup['mjpa'] = 'Motion JPEG-A';
+                        $QuicktimeVideoCodecLookup['mjpb'] = 'Motion JPEG-B';
+                        $QuicktimeVideoCodecLookup['msvc'] = 'Microsoft Video1';
+                        $QuicktimeVideoCodecLookup['myuv'] = 'MPEG YUV420';
+                        $QuicktimeVideoCodecLookup['path'] = 'Vector';
+                        $QuicktimeVideoCodecLookup['png '] = 'PNG';
+                        $QuicktimeVideoCodecLookup['PNTG'] = 'MacPaint';
+                        $QuicktimeVideoCodecLookup['qdgx'] = 'QuickDrawGX';
+                        $QuicktimeVideoCodecLookup['qdrw'] = 'QuickDraw';
+                        $QuicktimeVideoCodecLookup['raw '] = 'RAW';
+                        $QuicktimeVideoCodecLookup['ripl'] = 'WaterRipple';
+                        $QuicktimeVideoCodecLookup['rpza'] = 'Video';
+                        $QuicktimeVideoCodecLookup['smc '] = 'Graphics';
+                        $QuicktimeVideoCodecLookup['SVQ1'] = 'Sorenson Video 1';
+                        $QuicktimeVideoCodecLookup['SVQ1'] = 'Sorenson Video 3';
+                        $QuicktimeVideoCodecLookup['syv9'] = 'Sorenson YUV9';
+                        $QuicktimeVideoCodecLookup['tga '] = 'Targa';
+                        $QuicktimeVideoCodecLookup['tiff'] = 'TIFF';
+                        $QuicktimeVideoCodecLookup['WRAW'] = 'Windows RAW';
+                        $QuicktimeVideoCodecLookup['WRLE'] = 'BMP';
+                        $QuicktimeVideoCodecLookup['y420'] = 'YUV420';
+                        $QuicktimeVideoCodecLookup['yuv2'] = 'ComponentVideo';
+                        $QuicktimeVideoCodecLookup['yuvs'] = 'ComponentVideoUnsigned';
+                        $QuicktimeVideoCodecLookup['yuvu'] = 'ComponentVideoSigned';
+                }
+                return (isset($QuicktimeVideoCodecLookup[$codecid]) ? $QuicktimeVideoCodecLookup[$codecid] : '');
+        }
+
+        public function QuicktimeAudioCodecLookup($codecid) {
+                static $QuicktimeAudioCodecLookup = array();
+                if (empty($QuicktimeAudioCodecLookup)) {
+                        $QuicktimeAudioCodecLookup['.mp3']          = 'Fraunhofer MPEG Layer-III alias';
+                        $QuicktimeAudioCodecLookup['aac ']          = 'ISO/IEC 14496-3 AAC';
+                        $QuicktimeAudioCodecLookup['agsm']          = 'Apple GSM 10:1';
+                        $QuicktimeAudioCodecLookup['alac']          = 'Apple Lossless Audio Codec';
+                        $QuicktimeAudioCodecLookup['alaw']          = 'A-law 2:1';
+                        $QuicktimeAudioCodecLookup['conv']          = 'Sample Format';
+                        $QuicktimeAudioCodecLookup['dvca']          = 'DV';
+                        $QuicktimeAudioCodecLookup['dvi ']          = 'DV 4:1';
+                        $QuicktimeAudioCodecLookup['eqal']          = 'Frequency Equalizer';
+                        $QuicktimeAudioCodecLookup['fl32']          = '32-bit Floating Point';
+                        $QuicktimeAudioCodecLookup['fl64']          = '64-bit Floating Point';
+                        $QuicktimeAudioCodecLookup['ima4']          = 'Interactive Multimedia Association 4:1';
+                        $QuicktimeAudioCodecLookup['in24']          = '24-bit Integer';
+                        $QuicktimeAudioCodecLookup['in32']          = '32-bit Integer';
+                        $QuicktimeAudioCodecLookup['lpc ']          = 'LPC 23:1';
+                        $QuicktimeAudioCodecLookup['MAC3']          = 'Macintosh Audio Compression/Expansion (MACE) 3:1';
+                        $QuicktimeAudioCodecLookup['MAC6']          = 'Macintosh Audio Compression/Expansion (MACE) 6:1';
+                        $QuicktimeAudioCodecLookup['mixb']          = '8-bit Mixer';
+                        $QuicktimeAudioCodecLookup['mixw']          = '16-bit Mixer';
+                        $QuicktimeAudioCodecLookup['mp4a']          = 'ISO/IEC 14496-3 AAC';
+                        $QuicktimeAudioCodecLookup['MS'."\x00\x02"] = 'Microsoft ADPCM';
+                        $QuicktimeAudioCodecLookup['MS'."\x00\x11"] = 'DV IMA';
+                        $QuicktimeAudioCodecLookup['MS'."\x00\x55"] = 'Fraunhofer MPEG Layer III';
+                        $QuicktimeAudioCodecLookup['NONE']          = 'No Encoding';
+                        $QuicktimeAudioCodecLookup['Qclp']          = 'Qualcomm PureVoice';
+                        $QuicktimeAudioCodecLookup['QDM2']          = 'QDesign Music 2';
+                        $QuicktimeAudioCodecLookup['QDMC']          = 'QDesign Music 1';
+                        $QuicktimeAudioCodecLookup['ratb']          = '8-bit Rate';
+                        $QuicktimeAudioCodecLookup['ratw']          = '16-bit Rate';
+                        $QuicktimeAudioCodecLookup['raw ']          = 'raw PCM';
+                        $QuicktimeAudioCodecLookup['sour']          = 'Sound Source';
+                        $QuicktimeAudioCodecLookup['sowt']          = 'signed/two\'s complement (Little Endian)';
+                        $QuicktimeAudioCodecLookup['str1']          = 'Iomega MPEG layer II';
+                        $QuicktimeAudioCodecLookup['str2']          = 'Iomega MPEG *layer II';
+                        $QuicktimeAudioCodecLookup['str3']          = 'Iomega MPEG **layer II';
+                        $QuicktimeAudioCodecLookup['str4']          = 'Iomega MPEG ***layer II';
+                        $QuicktimeAudioCodecLookup['twos']          = 'signed/two\'s complement (Big Endian)';
+                        $QuicktimeAudioCodecLookup['ulaw']          = 'mu-law 2:1';
+                }
+                return (isset($QuicktimeAudioCodecLookup[$codecid]) ? $QuicktimeAudioCodecLookup[$codecid] : '');
+        }
+
+        public function QuicktimeDCOMLookup($compressionid) {
+                static $QuicktimeDCOMLookup = array();
+                if (empty($QuicktimeDCOMLookup)) {
+                        $QuicktimeDCOMLookup['zlib'] = 'ZLib Deflate';
+                        $QuicktimeDCOMLookup['adec'] = 'Apple Compression';
+                }
+                return (isset($QuicktimeDCOMLookup[$compressionid]) ? $QuicktimeDCOMLookup[$compressionid] : '');
+        }
+
+        public function QuicktimeColorNameLookup($colordepthid) {
+                static $QuicktimeColorNameLookup = array();
+                if (empty($QuicktimeColorNameLookup)) {
+                        $QuicktimeColorNameLookup[1]  = '2-color (monochrome)';
+                        $QuicktimeColorNameLookup[2]  = '4-color';
+                        $QuicktimeColorNameLookup[4]  = '16-color';
+                        $QuicktimeColorNameLookup[8]  = '256-color';
+                        $QuicktimeColorNameLookup[16] = 'thousands (16-bit color)';
+                        $QuicktimeColorNameLookup[24] = 'millions (24-bit color)';
+                        $QuicktimeColorNameLookup[32] = 'millions+ (32-bit color)';
+                        $QuicktimeColorNameLookup[33] = 'black & white';
+                        $QuicktimeColorNameLookup[34] = '4-gray';
+                        $QuicktimeColorNameLookup[36] = '16-gray';
+                        $QuicktimeColorNameLookup[40] = '256-gray';
+                }
+                return (isset($QuicktimeColorNameLookup[$colordepthid]) ? $QuicktimeColorNameLookup[$colordepthid] : 'invalid');
+        }
+
+        public function QuicktimeSTIKLookup($stik) {
+                static $QuicktimeSTIKLookup = array();
+                if (empty($QuicktimeSTIKLookup)) {
+                        $QuicktimeSTIKLookup[0]  = 'Movie';
+                        $QuicktimeSTIKLookup[1]  = 'Normal';
+                        $QuicktimeSTIKLookup[2]  = 'Audiobook';
+                        $QuicktimeSTIKLookup[5]  = 'Whacked Bookmark';
+                        $QuicktimeSTIKLookup[6]  = 'Music Video';
+                        $QuicktimeSTIKLookup[9]  = 'Short Film';
+                        $QuicktimeSTIKLookup[10] = 'TV Show';
+                        $QuicktimeSTIKLookup[11] = 'Booklet';
+                        $QuicktimeSTIKLookup[14] = 'Ringtone';
+                        $QuicktimeSTIKLookup[21] = 'Podcast';
+                }
+                return (isset($QuicktimeSTIKLookup[$stik]) ? $QuicktimeSTIKLookup[$stik] : 'invalid');
+        }
+
+        public function QuicktimeIODSaudioProfileName($audio_profile_id) {
+                static $QuicktimeIODSaudioProfileNameLookup = array();
+                if (empty($QuicktimeIODSaudioProfileNameLookup)) {
+                        $QuicktimeIODSaudioProfileNameLookup = array(
+                            0x00 => 'ISO Reserved (0x00)',
+                            0x01 => 'Main Audio Profile @ Level 1',
+                            0x02 => 'Main Audio Profile @ Level 2',
+                            0x03 => 'Main Audio Profile @ Level 3',
+                            0x04 => 'Main Audio Profile @ Level 4',
+                            0x05 => 'Scalable Audio Profile @ Level 1',
+                            0x06 => 'Scalable Audio Profile @ Level 2',
+                            0x07 => 'Scalable Audio Profile @ Level 3',
+                            0x08 => 'Scalable Audio Profile @ Level 4',
+                            0x09 => 'Speech Audio Profile @ Level 1',
+                            0x0A => 'Speech Audio Profile @ Level 2',
+                            0x0B => 'Synthetic Audio Profile @ Level 1',
+                            0x0C => 'Synthetic Audio Profile @ Level 2',
+                            0x0D => 'Synthetic Audio Profile @ Level 3',
+                            0x0E => 'High Quality Audio Profile @ Level 1',
+                            0x0F => 'High Quality Audio Profile @ Level 2',
+                            0x10 => 'High Quality Audio Profile @ Level 3',
+                            0x11 => 'High Quality Audio Profile @ Level 4',
+                            0x12 => 'High Quality Audio Profile @ Level 5',
+                            0x13 => 'High Quality Audio Profile @ Level 6',
+                            0x14 => 'High Quality Audio Profile @ Level 7',
+                            0x15 => 'High Quality Audio Profile @ Level 8',
+                            0x16 => 'Low Delay Audio Profile @ Level 1',
+                            0x17 => 'Low Delay Audio Profile @ Level 2',
+                            0x18 => 'Low Delay Audio Profile @ Level 3',
+                            0x19 => 'Low Delay Audio Profile @ Level 4',
+                            0x1A => 'Low Delay Audio Profile @ Level 5',
+                            0x1B => 'Low Delay Audio Profile @ Level 6',
+                            0x1C => 'Low Delay Audio Profile @ Level 7',
+                            0x1D => 'Low Delay Audio Profile @ Level 8',
+                            0x1E => 'Natural Audio Profile @ Level 1',
+                            0x1F => 'Natural Audio Profile @ Level 2',
+                            0x20 => 'Natural Audio Profile @ Level 3',
+                            0x21 => 'Natural Audio Profile @ Level 4',
+                            0x22 => 'Mobile Audio Internetworking Profile @ Level 1',
+                            0x23 => 'Mobile Audio Internetworking Profile @ Level 2',
+                            0x24 => 'Mobile Audio Internetworking Profile @ Level 3',
+                            0x25 => 'Mobile Audio Internetworking Profile @ Level 4',
+                            0x26 => 'Mobile Audio Internetworking Profile @ Level 5',
+                            0x27 => 'Mobile Audio Internetworking Profile @ Level 6',
+                            0x28 => 'AAC Profile @ Level 1',
+                            0x29 => 'AAC Profile @ Level 2',
+                            0x2A => 'AAC Profile @ Level 4',
+                            0x2B => 'AAC Profile @ Level 5',
+                            0x2C => 'High Efficiency AAC Profile @ Level 2',
+                            0x2D => 'High Efficiency AAC Profile @ Level 3',
+                            0x2E => 'High Efficiency AAC Profile @ Level 4',
+                            0x2F => 'High Efficiency AAC Profile @ Level 5',
+                            0xFE => 'Not part of MPEG-4 audio profiles',
+                            0xFF => 'No audio capability required',
+                        );
+                }
+                return (isset($QuicktimeIODSaudioProfileNameLookup[$audio_profile_id]) ? $QuicktimeIODSaudioProfileNameLookup[$audio_profile_id] : 'ISO Reserved / User Private');
+        }
+
+
+        public function QuicktimeIODSvideoProfileName($video_profile_id) {
+                static $QuicktimeIODSvideoProfileNameLookup = array();
+                if (empty($QuicktimeIODSvideoProfileNameLookup)) {
+                        $QuicktimeIODSvideoProfileNameLookup = array(
+                                0x00 => 'Reserved (0x00) Profile',
+                                0x01 => 'Simple Profile @ Level 1',
+                                0x02 => 'Simple Profile @ Level 2',
+                                0x03 => 'Simple Profile @ Level 3',
+                                0x08 => 'Simple Profile @ Level 0',
+                                0x10 => 'Simple Scalable Profile @ Level 0',
+                                0x11 => 'Simple Scalable Profile @ Level 1',
+                                0x12 => 'Simple Scalable Profile @ Level 2',
+                                0x15 => 'AVC/H264 Profile',
+                                0x21 => 'Core Profile @ Level 1',
+                                0x22 => 'Core Profile @ Level 2',
+                                0x32 => 'Main Profile @ Level 2',
+                                0x33 => 'Main Profile @ Level 3',
+                                0x34 => 'Main Profile @ Level 4',
+                                0x42 => 'N-bit Profile @ Level 2',
+                                0x51 => 'Scalable Texture Profile @ Level 1',
+                                0x61 => 'Simple Face Animation Profile @ Level 1',
+                                0x62 => 'Simple Face Animation Profile @ Level 2',
+                                0x63 => 'Simple FBA Profile @ Level 1',
+                                0x64 => 'Simple FBA Profile @ Level 2',
+                                0x71 => 'Basic Animated Texture Profile @ Level 1',
+                                0x72 => 'Basic Animated Texture Profile @ Level 2',
+                                0x81 => 'Hybrid Profile @ Level 1',
+                                0x82 => 'Hybrid Profile @ Level 2',
+                                0x91 => 'Advanced Real Time Simple Profile @ Level 1',
+                                0x92 => 'Advanced Real Time Simple Profile @ Level 2',
+                                0x93 => 'Advanced Real Time Simple Profile @ Level 3',
+                                0x94 => 'Advanced Real Time Simple Profile @ Level 4',
+                                0xA1 => 'Core Scalable Profile @ Level1',
+                                0xA2 => 'Core Scalable Profile @ Level2',
+                                0xA3 => 'Core Scalable Profile @ Level3',
+                                0xB1 => 'Advanced Coding Efficiency Profile @ Level 1',
+                                0xB2 => 'Advanced Coding Efficiency Profile @ Level 2',
+                                0xB3 => 'Advanced Coding Efficiency Profile @ Level 3',
+                                0xB4 => 'Advanced Coding Efficiency Profile @ Level 4',
+                                0xC1 => 'Advanced Core Profile @ Level 1',
+                                0xC2 => 'Advanced Core Profile @ Level 2',
+                                0xD1 => 'Advanced Scalable Texture @ Level1',
+                                0xD2 => 'Advanced Scalable Texture @ Level2',
+                                0xE1 => 'Simple Studio Profile @ Level 1',
+                                0xE2 => 'Simple Studio Profile @ Level 2',
+                                0xE3 => 'Simple Studio Profile @ Level 3',
+                                0xE4 => 'Simple Studio Profile @ Level 4',
+                                0xE5 => 'Core Studio Profile @ Level 1',
+                                0xE6 => 'Core Studio Profile @ Level 2',
+                                0xE7 => 'Core Studio Profile @ Level 3',
+                                0xE8 => 'Core Studio Profile @ Level 4',
+                                0xF0 => 'Advanced Simple Profile @ Level 0',
+                                0xF1 => 'Advanced Simple Profile @ Level 1',
+                                0xF2 => 'Advanced Simple Profile @ Level 2',
+                                0xF3 => 'Advanced Simple Profile @ Level 3',
+                                0xF4 => 'Advanced Simple Profile @ Level 4',
+                                0xF5 => 'Advanced Simple Profile @ Level 5',
+                                0xF7 => 'Advanced Simple Profile @ Level 3b',
+                                0xF8 => 'Fine Granularity Scalable Profile @ Level 0',
+                                0xF9 => 'Fine Granularity Scalable Profile @ Level 1',
+                                0xFA => 'Fine Granularity Scalable Profile @ Level 2',
+                                0xFB => 'Fine Granularity Scalable Profile @ Level 3',
+                                0xFC => 'Fine Granularity Scalable Profile @ Level 4',
+                                0xFD => 'Fine Granularity Scalable Profile @ Level 5',
+                                0xFE => 'Not part of MPEG-4 Visual profiles',
+                                0xFF => 'No visual capability required',
+                        );
+                }
+                return (isset($QuicktimeIODSvideoProfileNameLookup[$video_profile_id]) ? $QuicktimeIODSvideoProfileNameLookup[$video_profile_id] : 'ISO Reserved Profile');
+        }
+
+
+        public function QuicktimeContentRatingLookup($rtng) {
+                static $QuicktimeContentRatingLookup = array();
+                if (empty($QuicktimeContentRatingLookup)) {
+                        $QuicktimeContentRatingLookup[0]  = 'None';
+                        $QuicktimeContentRatingLookup[2]  = 'Clean';
+                        $QuicktimeContentRatingLookup[4]  = 'Explicit';
+                }
+                return (isset($QuicktimeContentRatingLookup[$rtng]) ? $QuicktimeContentRatingLookup[$rtng] : 'invalid');
+        }
+
+        public function QuicktimeStoreAccountTypeLookup($akid) {
+                static $QuicktimeStoreAccountTypeLookup = array();
+                if (empty($QuicktimeStoreAccountTypeLookup)) {
+                        $QuicktimeStoreAccountTypeLookup[0] = 'iTunes';
+                        $QuicktimeStoreAccountTypeLookup[1] = 'AOL';
+                }
+                return (isset($QuicktimeStoreAccountTypeLookup[$akid]) ? $QuicktimeStoreAccountTypeLookup[$akid] : 'invalid');
+        }
+
+        public function QuicktimeStoreFrontCodeLookup($sfid) {
+                static $QuicktimeStoreFrontCodeLookup = array();
+                if (empty($QuicktimeStoreFrontCodeLookup)) {
+                        $QuicktimeStoreFrontCodeLookup[143460] = 'Australia';
+                        $QuicktimeStoreFrontCodeLookup[143445] = 'Austria';
+                        $QuicktimeStoreFrontCodeLookup[143446] = 'Belgium';
+                        $QuicktimeStoreFrontCodeLookup[143455] = 'Canada';
+                        $QuicktimeStoreFrontCodeLookup[143458] = 'Denmark';
+                        $QuicktimeStoreFrontCodeLookup[143447] = 'Finland';
+                        $QuicktimeStoreFrontCodeLookup[143442] = 'France';
+                        $QuicktimeStoreFrontCodeLookup[143443] = 'Germany';
+                        $QuicktimeStoreFrontCodeLookup[143448] = 'Greece';
+                        $QuicktimeStoreFrontCodeLookup[143449] = 'Ireland';
+                        $QuicktimeStoreFrontCodeLookup[143450] = 'Italy';
+                        $QuicktimeStoreFrontCodeLookup[143462] = 'Japan';
+                        $QuicktimeStoreFrontCodeLookup[143451] = 'Luxembourg';
+                        $QuicktimeStoreFrontCodeLookup[143452] = 'Netherlands';
+                        $QuicktimeStoreFrontCodeLookup[143461] = 'New Zealand';
+                        $QuicktimeStoreFrontCodeLookup[143457] = 'Norway';
+                        $QuicktimeStoreFrontCodeLookup[143453] = 'Portugal';
+                        $QuicktimeStoreFrontCodeLookup[143454] = 'Spain';
+                        $QuicktimeStoreFrontCodeLookup[143456] = 'Sweden';
+                        $QuicktimeStoreFrontCodeLookup[143459] = 'Switzerland';
+                        $QuicktimeStoreFrontCodeLookup[143444] = 'United Kingdom';
+                        $QuicktimeStoreFrontCodeLookup[143441] = 'United States';
+                }
+                return (isset($QuicktimeStoreFrontCodeLookup[$sfid]) ? $QuicktimeStoreFrontCodeLookup[$sfid] : 'invalid');
+        }
+
+        public function QuicktimeParseNikonNCTG($atom_data) {
+                // http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html#NCTG
+                // Nikon-specific QuickTime tags found in the NCDT atom of MOV videos from some Nikon cameras such as the Coolpix S8000 and D5100
+                // Data is stored as records of:
+                // * 4 bytes record type
+                // * 2 bytes size of data field type:
+                //     0x0001 = flag   (size field *= 1-byte)
+                //     0x0002 = char   (size field *= 1-byte)
+                //     0x0003 = DWORD+ (size field *= 2-byte), values are stored CDAB
+                //     0x0004 = QWORD+ (size field *= 4-byte), values are stored EFGHABCD
+                //     0x0005 = float  (size field *= 8-byte), values are stored aaaabbbb where value is aaaa/bbbb; possibly multiple sets of values appended together
+                //     0x0007 = bytes  (size field *= 1-byte), values are stored as ??????
+                //     0x0008 = ?????  (size field *= 2-byte), values are stored as ??????
+                // * 2 bytes data size field
+                // * ? bytes data (string data may be null-padded; datestamp fields are in the format "2011:05:25 20:24:15")
+                // all integers are stored BigEndian
+
+                $NCTGtagName = array(
+                        0x00000001 => 'Make',
+                        0x00000002 => 'Model',
+                        0x00000003 => 'Software',
+                        0x00000011 => 'CreateDate',
+                        0x00000012 => 'DateTimeOriginal',
+                        0x00000013 => 'FrameCount',
+                        0x00000016 => 'FrameRate',
+                        0x00000022 => 'FrameWidth',
+                        0x00000023 => 'FrameHeight',
+                        0x00000032 => 'AudioChannels',
+                        0x00000033 => 'AudioBitsPerSample',
+                        0x00000034 => 'AudioSampleRate',
+                        0x02000001 => 'MakerNoteVersion',
+                        0x02000005 => 'WhiteBalance',
+                        0x0200000b => 'WhiteBalanceFineTune',
+                        0x0200001e => 'ColorSpace',
+                        0x02000023 => 'PictureControlData',
+                        0x02000024 => 'WorldTime',
+                        0x02000032 => 'UnknownInfo',
+                        0x02000083 => 'LensType',
+                        0x02000084 => 'Lens',
+                );
+
+                $offset = 0;
+                $datalength = strlen($atom_data);
+                $parsed = array();
+                while ($offset < $datalength) {
+//echo getid3_lib::PrintHexBytes(substr($atom_data, $offset, 4)).'<br>';
+                        $record_type       = getid3_lib::BigEndian2Int(substr($atom_data, $offset, 4));  $offset += 4;
+                        $data_size_type    = getid3_lib::BigEndian2Int(substr($atom_data, $offset, 2));  $offset += 2;
+                        $data_size         = getid3_lib::BigEndian2Int(substr($atom_data, $offset, 2));  $offset += 2;
+                        switch ($data_size_type) {
+                                case 0x0001: // 0x0001 = flag   (size field *= 1-byte)
+                                        $data = getid3_lib::BigEndian2Int(substr($atom_data, $offset, $data_size * 1));
+                                        $offset += ($data_size * 1);
+                                        break;
+                                case 0x0002: // 0x0002 = char   (size field *= 1-byte)
+                                        $data = substr($atom_data, $offset, $data_size * 1);
+                                        $offset += ($data_size * 1);
+                                        $data = rtrim($data, "\x00");
+                                        break;
+                                case 0x0003: // 0x0003 = DWORD+ (size field *= 2-byte), values are stored CDAB
+                                        $data = '';
+                                        for ($i = $data_size - 1; $i >= 0; $i--) {
+                                                $data .= substr($atom_data, $offset + ($i * 2), 2);
+                                        }
+                                        $data = getid3_lib::BigEndian2Int($data);
+                                        $offset += ($data_size * 2);
+                                        break;
+                                case 0x0004: // 0x0004 = QWORD+ (size field *= 4-byte), values are stored EFGHABCD
+                                        $data = '';
+                                        for ($i = $data_size - 1; $i >= 0; $i--) {
+                                                $data .= substr($atom_data, $offset + ($i * 4), 4);
+                                        }
+                                        $data = getid3_lib::BigEndian2Int($data);
+                                        $offset += ($data_size * 4);
+                                        break;
+                                case 0x0005: // 0x0005 = float  (size field *= 8-byte), values are stored aaaabbbb where value is aaaa/bbbb; possibly multiple sets of values appended together
+                                        $data = array();
+                                        for ($i = 0; $i < $data_size; $i++) {
+                                                $numerator    = getid3_lib::BigEndian2Int(substr($atom_data, $offset + ($i * 8) + 0, 4));
+                                                $denomninator = getid3_lib::BigEndian2Int(substr($atom_data, $offset + ($i * 8) + 4, 4));
+                                                if ($denomninator == 0) {
+                                                        $data[$i] = false;
+                                                } else {
+                                                        $data[$i] = (double) $numerator / $denomninator;
+                                                }
+                                        }
+                                        $offset += (8 * $data_size);
+                                        if (count($data) == 1) {
+                                                $data = $data[0];
+                                        }
+                                        break;
+                                case 0x0007: // 0x0007 = bytes  (size field *= 1-byte), values are stored as ??????
+                                        $data = substr($atom_data, $offset, $data_size * 1);
+                                        $offset += ($data_size * 1);
+                                        break;
+                                case 0x0008: // 0x0008 = ?????  (size field *= 2-byte), values are stored as ??????
+                                        $data = substr($atom_data, $offset, $data_size * 2);
+                                        $offset += ($data_size * 2);
+                                        break;
+                                default:
+echo 'QuicktimeParseNikonNCTG()::unknown $data_size_type: '.$data_size_type.'<br>';
+                                        break 2;
+                        }
+
+                        switch ($record_type) {
+                                case 0x00000011: // CreateDate
+                                case 0x00000012: // DateTimeOriginal
+                                        $data = strtotime($data);
+                                        break;
+                                case 0x0200001e: // ColorSpace
+                                        switch ($data) {
+                                                case 1:
+                                                        $data = 'sRGB';
+                                                        break;
+                                                case 2:
+                                                        $data = 'Adobe RGB';
+                                                        break;
+                                        }
+                                        break;
+                                case 0x02000023: // PictureControlData
+                                        $PictureControlAdjust = array(0=>'default', 1=>'quick', 2=>'full');
+                                        $FilterEffect = array(0x80=>'off', 0x81=>'yellow', 0x82=>'orange',    0x83=>'red', 0x84=>'green',  0xff=>'n/a');
+                                        $ToningEffect = array(0x80=>'b&w', 0x81=>'sepia',  0x82=>'cyanotype', 0x83=>'red', 0x84=>'yellow', 0x85=>'green', 0x86=>'blue-green', 0x87=>'blue', 0x88=>'purple-blue', 0x89=>'red-purple', 0xff=>'n/a');
+                                        $data = array(
+                                                'PictureControlVersion'     =>                           substr($data,  0,  4),
+                                                'PictureControlName'        =>                     rtrim(substr($data,  4, 20), "\x00"),
+                                                'PictureControlBase'        =>                     rtrim(substr($data, 24, 20), "\x00"),
+                                                //'?'                       =>                           substr($data, 44,  4),
+                                                'PictureControlAdjust'      => $PictureControlAdjust[ord(substr($data, 48,  1))],
+                                                'PictureControlQuickAdjust' =>                       ord(substr($data, 49,  1)),
+                                                'Sharpness'                 =>                       ord(substr($data, 50,  1)),
+                                                'Contrast'                  =>                       ord(substr($data, 51,  1)),
+                                                'Brightness'                =>                       ord(substr($data, 52,  1)),
+                                                'Saturation'                =>                       ord(substr($data, 53,  1)),
+                                                'HueAdjustment'             =>                       ord(substr($data, 54,  1)),
+                                                'FilterEffect'              =>         $FilterEffect[ord(substr($data, 55,  1))],
+                                                'ToningEffect'              =>         $ToningEffect[ord(substr($data, 56,  1))],
+                                                'ToningSaturation'          =>                       ord(substr($data, 57,  1)),
+                                        );
+                                        break;
+                                case 0x02000024: // WorldTime
+                                        // http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html#WorldTime
+                                        // timezone is stored as offset from GMT in minutes
+                                        $timezone = getid3_lib::BigEndian2Int(substr($data, 0, 2));
+                                        if ($timezone & 0x8000) {
+                                                $timezone = 0 - (0x10000 - $timezone);
+                                        }
+                                        $timezone /= 60;
+
+                                        $dst = (bool) getid3_lib::BigEndian2Int(substr($data, 2, 1));
+                                        switch (getid3_lib::BigEndian2Int(substr($data, 3, 1))) {
+                                                case 2:
+                                                        $datedisplayformat = 'D/M/Y'; break;
+                                                case 1:
+                                                        $datedisplayformat = 'M/D/Y'; break;
+                                                case 0:
+                                                default:
+                                                        $datedisplayformat = 'Y/M/D'; break;
+                                        }
+
+                                        $data = array('timezone'=>floatval($timezone), 'dst'=>$dst, 'display'=>$datedisplayformat);
+                                        break;
+                                case 0x02000083: // LensType
+                                        $data = array(
+                                                //'_'  => $data,
+                                                'mf' => (bool) ($data & 0x01),
+                                                'd'  => (bool) ($data & 0x02),
+                                                'g'  => (bool) ($data & 0x04),
+                                                'vr' => (bool) ($data & 0x08),
+                                        );
+                                        break;
+                        }
+                        $tag_name = (isset($NCTGtagName[$record_type]) ? $NCTGtagName[$record_type] : '0x'.str_pad(dechex($record_type), 8, '0', STR_PAD_LEFT));
+                        $parsed[$tag_name] = $data;
+                }
+                return $parsed;
+        }
+
+
+        public function CopyToAppropriateCommentsSection($keyname, $data, $boxname='') {
+                static $handyatomtranslatorarray = array();
+                if (empty($handyatomtranslatorarray)) {
+                        $handyatomtranslatorarray['©cpy'] = 'copyright';
+                        $handyatomtranslatorarray['©day'] = 'creation_date';    // iTunes 4.0
+                        $handyatomtranslatorarray['©dir'] = 'director';
+                        $handyatomtranslatorarray['©ed1'] = 'edit1';
+                        $handyatomtranslatorarray['©ed2'] = 'edit2';
+                        $handyatomtranslatorarray['©ed3'] = 'edit3';
+                        $handyatomtranslatorarray['©ed4'] = 'edit4';
+                        $handyatomtranslatorarray['©ed5'] = 'edit5';
+                        $handyatomtranslatorarray['©ed6'] = 'edit6';
+                        $handyatomtranslatorarray['©ed7'] = 'edit7';
+                        $handyatomtranslatorarray['©ed8'] = 'edit8';
+                        $handyatomtranslatorarray['©ed9'] = 'edit9';
+                        $handyatomtranslatorarray['©fmt'] = 'format';
+                        $handyatomtranslatorarray['©inf'] = 'information';
+                        $handyatomtranslatorarray['©prd'] = 'producer';
+                        $handyatomtranslatorarray['©prf'] = 'performers';
+                        $handyatomtranslatorarray['©req'] = 'system_requirements';
+                        $handyatomtranslatorarray['©src'] = 'source_credit';
+                        $handyatomtranslatorarray['©wrt'] = 'writer';
+
+                        // http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt
+                        $handyatomtranslatorarray['©nam'] = 'title';           // iTunes 4.0
+                        $handyatomtranslatorarray['©cmt'] = 'comment';         // iTunes 4.0
+                        $handyatomtranslatorarray['©wrn'] = 'warning';
+                        $handyatomtranslatorarray['©hst'] = 'host_computer';
+                        $handyatomtranslatorarray['©mak'] = 'make';
+                        $handyatomtranslatorarray['©mod'] = 'model';
+                        $handyatomtranslatorarray['©PRD'] = 'product';
+                        $handyatomtranslatorarray['©swr'] = 'software';
+                        $handyatomtranslatorarray['©aut'] = 'author';
+                        $handyatomtranslatorarray['©ART'] = 'artist';
+                        $handyatomtranslatorarray['©trk'] = 'track';
+                        $handyatomtranslatorarray['©alb'] = 'album';           // iTunes 4.0
+                        $handyatomtranslatorarray['©com'] = 'comment';
+                        $handyatomtranslatorarray['©gen'] = 'genre';           // iTunes 4.0
+                        $handyatomtranslatorarray['©ope'] = 'composer';
+                        $handyatomtranslatorarray['©url'] = 'url';
+                        $handyatomtranslatorarray['©enc'] = 'encoder';
+
+                        // http://atomicparsley.sourceforge.net/mpeg-4files.html
+                        $handyatomtranslatorarray['©art'] = 'artist';           // iTunes 4.0
+                        $handyatomtranslatorarray['aART'] = 'album_artist';
+                        $handyatomtranslatorarray['trkn'] = 'track_number';     // iTunes 4.0
+                        $handyatomtranslatorarray['disk'] = 'disc_number';      // iTunes 4.0
+                        $handyatomtranslatorarray['gnre'] = 'genre';            // iTunes 4.0
+                        $handyatomtranslatorarray['©too'] = 'encoder';          // iTunes 4.0
+                        $handyatomtranslatorarray['tmpo'] = 'bpm';              // iTunes 4.0
+                        $handyatomtranslatorarray['cprt'] = 'copyright';        // iTunes 4.0?
+                        $handyatomtranslatorarray['cpil'] = 'compilation';      // iTunes 4.0
+                        $handyatomtranslatorarray['covr'] = 'picture';          // iTunes 4.0
+                        $handyatomtranslatorarray['rtng'] = 'rating';           // iTunes 4.0
+                        $handyatomtranslatorarray['©grp'] = 'grouping';         // iTunes 4.2
+                        $handyatomtranslatorarray['stik'] = 'stik';             // iTunes 4.9
+                        $handyatomtranslatorarray['pcst'] = 'podcast';          // iTunes 4.9
+                        $handyatomtranslatorarray['catg'] = 'category';         // iTunes 4.9
+                        $handyatomtranslatorarray['keyw'] = 'keyword';          // iTunes 4.9
+                        $handyatomtranslatorarray['purl'] = 'podcast_url';      // iTunes 4.9
+                        $handyatomtranslatorarray['egid'] = 'episode_guid';     // iTunes 4.9
+                        $handyatomtranslatorarray['desc'] = 'description';      // iTunes 5.0
+                        $handyatomtranslatorarray['©lyr'] = 'lyrics';           // iTunes 5.0
+                        $handyatomtranslatorarray['tvnn'] = 'tv_network_name';  // iTunes 6.0
+                        $handyatomtranslatorarray['tvsh'] = 'tv_show_name';     // iTunes 6.0
+                        $handyatomtranslatorarray['tvsn'] = 'tv_season';        // iTunes 6.0
+                        $handyatomtranslatorarray['tves'] = 'tv_episode';       // iTunes 6.0
+                        $handyatomtranslatorarray['purd'] = 'purchase_date';    // iTunes 6.0.2
+                        $handyatomtranslatorarray['pgap'] = 'gapless_playback'; // iTunes 7.0
+
+                        // http://www.geocities.com/xhelmboyx/quicktime/formats/mp4-layout.txt
+
+
+
+                        // boxnames:
+                        /*
+                        $handyatomtranslatorarray['iTunSMPB']                    = 'iTunSMPB';
+                        $handyatomtranslatorarray['iTunNORM']                    = 'iTunNORM';
+                        $handyatomtranslatorarray['Encoding Params']             = 'Encoding Params';
+                        $handyatomtranslatorarray['replaygain_track_gain']       = 'replaygain_track_gain';
+                        $handyatomtranslatorarray['replaygain_track_peak']       = 'replaygain_track_peak';
+                        $handyatomtranslatorarray['replaygain_track_minmax']     = 'replaygain_track_minmax';
+                        $handyatomtranslatorarray['MusicIP PUID']                = 'MusicIP PUID';
+                        $handyatomtranslatorarray['MusicBrainz Artist Id']       = 'MusicBrainz Artist Id';
+                        $handyatomtranslatorarray['MusicBrainz Album Id']        = 'MusicBrainz Album Id';
+                        $handyatomtranslatorarray['MusicBrainz Album Artist Id'] = 'MusicBrainz Album Artist Id';
+                        $handyatomtranslatorarray['MusicBrainz Track Id']        = 'MusicBrainz Track Id';
+                        $handyatomtranslatorarray['MusicBrainz Disc Id']         = 'MusicBrainz Disc Id';
+
+                        // http://age.hobba.nl/audio/tag_frame_reference.html
+                        $handyatomtranslatorarray['PLAY_COUNTER']                = 'play_counter'; // Foobar2000 - http://www.getid3.org/phpBB3/viewtopic.php?t=1355
+                        $handyatomtranslatorarray['MEDIATYPE']                   = 'mediatype';    // Foobar2000 - http://www.getid3.org/phpBB3/viewtopic.php?t=1355
+                        */
+                }
+                $info = &$this->getid3->info;
+                $comment_key = '';
+                if ($boxname && ($boxname != $keyname)) {
+                        $comment_key = (isset($handyatomtranslatorarray[$boxname]) ? $handyatomtranslatorarray[$boxname] : $boxname);
+                } elseif (isset($handyatomtranslatorarray[$keyname])) {
+                        $comment_key = $handyatomtranslatorarray[$keyname];
+                }
+                if ($comment_key) {
+                        if ($comment_key == 'picture') {
+                                if (!is_array($data)) {
+                                        $image_mime = '';
+                                        if (preg_match('#^\x89\x50\x4E\x47\x0D\x0A\x1A\x0A#', $data)) {
+                                                $image_mime = 'image/png';
+                                        } elseif (preg_match('#^\xFF\xD8\xFF#', $data)) {
+                                                $image_mime = 'image/jpeg';
+                                        } elseif (preg_match('#^GIF#', $data)) {
+                                                $image_mime = 'image/gif';
+                                        } elseif (preg_match('#^BM#', $data)) {
+                                                $image_mime = 'image/bmp';
+                                        }
+                                        $data = array('data'=>$data, 'image_mime'=>$image_mime);
+                                }
+                        }
+                        $info['quicktime']['comments'][$comment_key][] = $data;
+                }
+                return true;
+        }
+
+        public function NoNullString($nullterminatedstring) {
+                // remove the single null terminator on null terminated strings
+                if (substr($nullterminatedstring, strlen($nullterminatedstring) - 1, 1) === "\x00") {
+                        return substr($nullterminatedstring, 0, strlen($nullterminatedstring) - 1);
+                }
+                return $nullterminatedstring;
+        }
+
+        public function Pascal2String($pascalstring) {
+                // Pascal strings have 1 unsigned byte at the beginning saying how many chars (1-255) are in the string
+                return substr($pascalstring, 1);
+        }

new file wp-includes/ID3/module.audio-video.riff.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio-video.riff.php                                 //
+// module for analyzing RIFF files                             //
+// multiple formats supported by this module:                  //
+//    Wave, AVI, AIFF/AIFC, (MP3,AC3)/RIFF, Wavpack v3, 8SVX   //
+// dependencies: module.audio.mp3.php                          //
+//               module.audio.ac3.php                          //
+//               module.audio.dts.php                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+/**
+* @todo Parse AC-3/DTS audio inside WAVE correctly
+* @todo Rewrite RIFF parser totally
+*/
+
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.mp3.php', __FILE__, true);
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.ac3.php', __FILE__, true);
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.dts.php', __FILE__, true);
+
+class getid3_riff extends getid3_handler
+{
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                // initialize these values to an empty array, otherwise they default to NULL
+                // and you can't append array values to a NULL value
+                $info['riff'] = array('raw'=>array());
+
+                // Shortcuts
+                $thisfile_riff             = &$info['riff'];
+                $thisfile_riff_raw         = &$thisfile_riff['raw'];
+                $thisfile_audio            = &$info['audio'];
+                $thisfile_video            = &$info['video'];
+                $thisfile_audio_dataformat = &$thisfile_audio['dataformat'];
+                $thisfile_riff_audio       = &$thisfile_riff['audio'];
+                $thisfile_riff_video       = &$thisfile_riff['video'];
+
+                $Original['avdataoffset'] = $info['avdataoffset'];
+                $Original['avdataend']    = $info['avdataend'];
+
+                $this->fseek($info['avdataoffset']);
+                $RIFFheader = $this->fread(12);
+                $offset = $this->ftell();
+                $RIFFtype    = substr($RIFFheader, 0, 4);
+                $RIFFsize    = substr($RIFFheader, 4, 4);
+                $RIFFsubtype = substr($RIFFheader, 8, 4);
+
+                switch ($RIFFtype) {
+
+                        case 'FORM':  // AIFF, AIFC
+                                $info['fileformat']   = 'aiff';
+                                $thisfile_riff['header_size'] = $this->EitherEndian2Int($RIFFsize);
+                                $thisfile_riff[$RIFFsubtype]  = $this->ParseRIFF($offset, ($offset + $thisfile_riff['header_size'] - 4));
+                                break;
+
+                        case 'RIFF':  // AVI, WAV, etc
+                        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
+                                $info['fileformat']   = 'riff';
+                                $thisfile_riff['header_size'] = $this->EitherEndian2Int($RIFFsize);
+                                if ($RIFFsubtype == 'RMP3') {
+                                        // RMP3 is identical to WAVE, just renamed. Used by [unknown program] when creating RIFF-MP3s
+                                        $RIFFsubtype = 'WAVE';
+                                }
+                                $thisfile_riff[$RIFFsubtype]  = $this->ParseRIFF($offset, ($offset + $thisfile_riff['header_size'] - 4));
+                                if (($info['avdataend'] - $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
+                                        $info['avdataend'] = $info['filesize'];
+                                }
+
+                                $nextRIFFoffset = $Original['avdataoffset'] + 8 + $thisfile_riff['header_size']; // 8 = "RIFF" + 32-bit offset
+                                while ($nextRIFFoffset < min($info['filesize'], $info['avdataend'])) {
+                                        try {
+                                                $this->fseek($nextRIFFoffset);
+                                        } catch (getid3_exception $e) {
+                                                if ($e->getCode() == 10) {
+                                                        //$this->warning('RIFF parser: '.$e->getMessage());
+                                                        $this->error('AVI extends beyond '.round(PHP_INT_MAX / 1073741824).'GB and PHP filesystem functions cannot read that far, playtime may be wrong');
+                                                        $this->warning('[avdataend] value may be incorrect, multiple AVIX chunks may be present');
+                                                        break;
+                                                } else {
+                                                        throw $e;
+                                                }
+                                        }
+                                        $nextRIFFheader = $this->fread(12);
+                                        if ($nextRIFFoffset == ($info['avdataend'] - 1)) {
+                                                if (substr($nextRIFFheader, 0, 1) == "\x00") {
+                                                        // RIFF padded to WORD boundary, we're actually already at the end
+                                                        break;
+                                                }
+                                        }
+                                        $nextRIFFheaderID =                         substr($nextRIFFheader, 0, 4);
+                                        $nextRIFFsize     = $this->EitherEndian2Int(substr($nextRIFFheader, 4, 4));
+                                        $nextRIFFtype     =                         substr($nextRIFFheader, 8, 4);
+                                        $chunkdata = array();
+                                        $chunkdata['offset'] = $nextRIFFoffset + 8;
+                                        $chunkdata['size']   = $nextRIFFsize;
+                                        $nextRIFFoffset = $chunkdata['offset'] + $chunkdata['size'];
+
+                                        switch ($nextRIFFheaderID) {
+
+                                                case 'RIFF':
+                                                        $chunkdata['chunks'] = $this->ParseRIFF($chunkdata['offset'] + 4, $nextRIFFoffset);
+
+                                                        if (!isset($thisfile_riff[$nextRIFFtype])) {
+                                                                $thisfile_riff[$nextRIFFtype] = array();
+                                                        }
+                                                        $thisfile_riff[$nextRIFFtype][] = $chunkdata;
+                                                        break;
+
+                                                case 'JUNK':
+                                                        // ignore
+                                                        $thisfile_riff[$nextRIFFheaderID][] = $chunkdata;
+                                                        break;
+
+                                                case 'IDVX':
+                                                        $info['divxtag']['comments'] = self::ParseDIVXTAG($this->fread($chunkdata['size']));
+                                                        break;
+
+                                                default:
+                                                        if ($info['filesize'] == ($chunkdata['offset'] - 8 + 128)) {
+                                                                $DIVXTAG = $nextRIFFheader.$this->fread(128 - 12);
+                                                                if (substr($DIVXTAG, -7) == 'DIVXTAG') {
+                                                                        // DIVXTAG is supposed to be inside an IDVX chunk in a LIST chunk, but some bad encoders just slap it on the end of a file
+                                                                        $this->warning('Found wrongly-structured DIVXTAG at offset '.($this->ftell() - 128).', parsing anyway');
+                                                                        $info['divxtag']['comments'] = self::ParseDIVXTAG($DIVXTAG);
+                                                                        break 2;
+                                                                }
+                                                        }
+                                                        $this->warning('Expecting "RIFF|JUNK|IDVX" at '.$nextRIFFoffset.', found "'.$nextRIFFheaderID.'" ('.getid3_lib::PrintHexBytes($nextRIFFheaderID).') - skipping rest of file');
+                                                        break 2;
+
+                                        }
+
+                                }
+                                if ($RIFFsubtype == 'WAVE') {
+                                        $thisfile_riff_WAVE = &$thisfile_riff['WAVE'];
+                                }
+                                break;
+
+                        default:
+                                $this->error('Cannot parse RIFF (this is maybe not a RIFF / WAV / AVI file?) - expecting "FORM|RIFF|SDSS|RMP3" found "'.$RIFFsubtype.'" instead');
+                                unset($info['fileformat']);
+                                return false;
+                }
+
+                $streamindex = 0;
+                switch ($RIFFsubtype) {
+                        case 'WAVE':
+                                if (empty($thisfile_audio['bitrate_mode'])) {
+                                        $thisfile_audio['bitrate_mode'] = 'cbr';
+                                }
+                                if (empty($thisfile_audio_dataformat)) {
+                                        $thisfile_audio_dataformat = 'wav';
+                                }
+
+                                if (isset($thisfile_riff_WAVE['data'][0]['offset'])) {
+                                        $info['avdataoffset'] = $thisfile_riff_WAVE['data'][0]['offset'] + 8;
+                                        $info['avdataend']    = $info['avdataoffset'] + $thisfile_riff_WAVE['data'][0]['size'];
+                                }
+                                if (isset($thisfile_riff_WAVE['fmt '][0]['data'])) {
+
+                                        $thisfile_riff_audio[$streamindex] = self::parseWAVEFORMATex($thisfile_riff_WAVE['fmt '][0]['data']);
+                                        $thisfile_audio['wformattag'] = $thisfile_riff_audio[$streamindex]['raw']['wFormatTag'];
+                                        if (!isset($thisfile_riff_audio[$streamindex]['bitrate']) || ($thisfile_riff_audio[$streamindex]['bitrate'] == 0)) {
+                                                $info['error'][] = 'Corrupt RIFF file: bitrate_audio == zero';
+                                                return false;
+                                        }
+                                        $thisfile_riff_raw['fmt '] = $thisfile_riff_audio[$streamindex]['raw'];
+                                        unset($thisfile_riff_audio[$streamindex]['raw']);
+                                        $thisfile_audio['streams'][$streamindex] = $thisfile_riff_audio[$streamindex];
+
+                                        $thisfile_audio = getid3_lib::array_merge_noclobber($thisfile_audio, $thisfile_riff_audio[$streamindex]);
+                                        if (substr($thisfile_audio['codec'], 0, strlen('unknown: 0x')) == 'unknown: 0x') {
+                                                $info['warning'][] = 'Audio codec = '.$thisfile_audio['codec'];
+                                        }
+                                        $thisfile_audio['bitrate'] = $thisfile_riff_audio[$streamindex]['bitrate'];
+
+                                        if (empty($info['playtime_seconds'])) { // may already be set (e.g. DTS-WAV)
+                                                $info['playtime_seconds'] = (float) ((($info['avdataend'] - $info['avdataoffset']) * 8) / $thisfile_audio['bitrate']);
+                                        }
+
+                                        $thisfile_audio['lossless'] = false;
+                                        if (isset($thisfile_riff_WAVE['data'][0]['offset']) && isset($thisfile_riff_raw['fmt ']['wFormatTag'])) {
+                                                switch ($thisfile_riff_raw['fmt ']['wFormatTag']) {
+
+                                                        case 0x0001:  // PCM
+                                                                $thisfile_audio['lossless'] = true;
+                                                                break;
+
+                                                        case 0x2000:  // AC-3
+                                                                $thisfile_audio_dataformat = 'ac3';
+                                                                break;
+
+                                                        default:
+                                                                // do nothing
+                                                                break;
+
+                                                }
+                                        }
+                                        $thisfile_audio['streams'][$streamindex]['wformattag']   = $thisfile_audio['wformattag'];
+                                        $thisfile_audio['streams'][$streamindex]['bitrate_mode'] = $thisfile_audio['bitrate_mode'];
+                                        $thisfile_audio['streams'][$streamindex]['lossless']     = $thisfile_audio['lossless'];
+                                        $thisfile_audio['streams'][$streamindex]['dataformat']   = $thisfile_audio_dataformat;
+                                }
+
+                                if (isset($thisfile_riff_WAVE['rgad'][0]['data'])) {
+
+                                        // shortcuts
+                                        $rgadData = &$thisfile_riff_WAVE['rgad'][0]['data'];
+                                        $thisfile_riff_raw['rgad']    = array('track'=>array(), 'album'=>array());
+                                        $thisfile_riff_raw_rgad       = &$thisfile_riff_raw['rgad'];
+                                        $thisfile_riff_raw_rgad_track = &$thisfile_riff_raw_rgad['track'];
+                                        $thisfile_riff_raw_rgad_album = &$thisfile_riff_raw_rgad['album'];
+
+                                        $thisfile_riff_raw_rgad['fPeakAmplitude']      = getid3_lib::LittleEndian2Float(substr($rgadData, 0, 4));
+                                        $thisfile_riff_raw_rgad['nRadioRgAdjust']      =        $this->EitherEndian2Int(substr($rgadData, 4, 2));
+                                        $thisfile_riff_raw_rgad['nAudiophileRgAdjust'] =        $this->EitherEndian2Int(substr($rgadData, 6, 2));
+
+                                        $nRadioRgAdjustBitstring      = str_pad(getid3_lib::Dec2Bin($thisfile_riff_raw_rgad['nRadioRgAdjust']), 16, '0', STR_PAD_LEFT);
+                                        $nAudiophileRgAdjustBitstring = str_pad(getid3_lib::Dec2Bin($thisfile_riff_raw_rgad['nAudiophileRgAdjust']), 16, '0', STR_PAD_LEFT);
+                                        $thisfile_riff_raw_rgad_track['name']       = getid3_lib::Bin2Dec(substr($nRadioRgAdjustBitstring, 0, 3));
+                                        $thisfile_riff_raw_rgad_track['originator'] = getid3_lib::Bin2Dec(substr($nRadioRgAdjustBitstring, 3, 3));
+                                        $thisfile_riff_raw_rgad_track['signbit']    = getid3_lib::Bin2Dec(substr($nRadioRgAdjustBitstring, 6, 1));
+                                        $thisfile_riff_raw_rgad_track['adjustment'] = getid3_lib::Bin2Dec(substr($nRadioRgAdjustBitstring, 7, 9));
+                                        $thisfile_riff_raw_rgad_album['name']       = getid3_lib::Bin2Dec(substr($nAudiophileRgAdjustBitstring, 0, 3));
+                                        $thisfile_riff_raw_rgad_album['originator'] = getid3_lib::Bin2Dec(substr($nAudiophileRgAdjustBitstring, 3, 3));
+                                        $thisfile_riff_raw_rgad_album['signbit']    = getid3_lib::Bin2Dec(substr($nAudiophileRgAdjustBitstring, 6, 1));
+                                        $thisfile_riff_raw_rgad_album['adjustment'] = getid3_lib::Bin2Dec(substr($nAudiophileRgAdjustBitstring, 7, 9));
+
+                                        $thisfile_riff['rgad']['peakamplitude'] = $thisfile_riff_raw_rgad['fPeakAmplitude'];
+                                        if (($thisfile_riff_raw_rgad_track['name'] != 0) && ($thisfile_riff_raw_rgad_track['originator'] != 0)) {
+                                                $thisfile_riff['rgad']['track']['name']            = getid3_lib::RGADnameLookup($thisfile_riff_raw_rgad_track['name']);
+                                                $thisfile_riff['rgad']['track']['originator']      = getid3_lib::RGADoriginatorLookup($thisfile_riff_raw_rgad_track['originator']);
+                                                $thisfile_riff['rgad']['track']['adjustment']      = getid3_lib::RGADadjustmentLookup($thisfile_riff_raw_rgad_track['adjustment'], $thisfile_riff_raw_rgad_track['signbit']);
+                                        }
+                                        if (($thisfile_riff_raw_rgad_album['name'] != 0) && ($thisfile_riff_raw_rgad_album['originator'] != 0)) {
+                                                $thisfile_riff['rgad']['album']['name']       = getid3_lib::RGADnameLookup($thisfile_riff_raw_rgad_album['name']);
+                                                $thisfile_riff['rgad']['album']['originator'] = getid3_lib::RGADoriginatorLookup($thisfile_riff_raw_rgad_album['originator']);
+                                                $thisfile_riff['rgad']['album']['adjustment'] = getid3_lib::RGADadjustmentLookup($thisfile_riff_raw_rgad_album['adjustment'], $thisfile_riff_raw_rgad_album['signbit']);
+                                        }
+                                }
+
+                                if (isset($thisfile_riff_WAVE['fact'][0]['data'])) {
+                                        $thisfile_riff_raw['fact']['NumberOfSamples'] = $this->EitherEndian2Int(substr($thisfile_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($thisfile_riff_raw['fmt ']['nSamplesPerSec'])) {
+                                        //     $info['playtime_seconds'] = (float) $thisfile_riff_raw['fact']['NumberOfSamples'] / $thisfile_riff_raw['fmt ']['nSamplesPerSec'];
+                                        // }
+                                }
+                                if (!empty($thisfile_riff_raw['fmt ']['nAvgBytesPerSec'])) {
+                                        $thisfile_audio['bitrate'] = getid3_lib::CastAsInt($thisfile_riff_raw['fmt ']['nAvgBytesPerSec'] * 8);
+                                }
+
+                                if (isset($thisfile_riff_WAVE['bext'][0]['data'])) {
+                                        // shortcut
+                                        $thisfile_riff_WAVE_bext_0 = &$thisfile_riff_WAVE['bext'][0];
+
+                                        $thisfile_riff_WAVE_bext_0['title']          =                         trim(substr($thisfile_riff_WAVE_bext_0['data'],   0, 256));
+                                        $thisfile_riff_WAVE_bext_0['author']         =                         trim(substr($thisfile_riff_WAVE_bext_0['data'], 256,  32));
+                                        $thisfile_riff_WAVE_bext_0['reference']      =                         trim(substr($thisfile_riff_WAVE_bext_0['data'], 288,  32));
+                                        $thisfile_riff_WAVE_bext_0['origin_date']    =                              substr($thisfile_riff_WAVE_bext_0['data'], 320,  10);
+                                        $thisfile_riff_WAVE_bext_0['origin_time']    =                              substr($thisfile_riff_WAVE_bext_0['data'], 330,   8);
+                                        $thisfile_riff_WAVE_bext_0['time_reference'] = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_bext_0['data'], 338,   8));
+                                        $thisfile_riff_WAVE_bext_0['bwf_version']    = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_bext_0['data'], 346,   1));
+                                        $thisfile_riff_WAVE_bext_0['reserved']       =                              substr($thisfile_riff_WAVE_bext_0['data'], 347, 254);
+                                        $thisfile_riff_WAVE_bext_0['coding_history'] =         explode("\r\n", trim(substr($thisfile_riff_WAVE_bext_0['data'], 601)));
+                                        if (preg_match('#^([0-9]{4}).([0-9]{2}).([0-9]{2})$#', $thisfile_riff_WAVE_bext_0['origin_date'], $matches_bext_date)) {
+                                                if (preg_match('#^([0-9]{2}).([0-9]{2}).([0-9]{2})$#', $thisfile_riff_WAVE_bext_0['origin_time'], $matches_bext_time)) {
+                                                        list($dummy, $bext_timestamp['year'], $bext_timestamp['month'],  $bext_timestamp['day'])    = $matches_bext_date;
+                                                        list($dummy, $bext_timestamp['hour'], $bext_timestamp['minute'], $bext_timestamp['second']) = $matches_bext_time;
+                                                        $thisfile_riff_WAVE_bext_0['origin_date_unix'] = gmmktime($bext_timestamp['hour'], $bext_timestamp['minute'], $bext_timestamp['second'], $bext_timestamp['month'], $bext_timestamp['day'], $bext_timestamp['year']);
+                                                } else {
+                                                        $info['warning'][] = 'RIFF.WAVE.BEXT.origin_time is invalid';
+                                                }
+                                        } else {
+                                                $info['warning'][] = 'RIFF.WAVE.BEXT.origin_date is invalid';
+                                        }
+                                        $thisfile_riff['comments']['author'][] = $thisfile_riff_WAVE_bext_0['author'];
+                                        $thisfile_riff['comments']['title'][]  = $thisfile_riff_WAVE_bext_0['title'];
+                                }
+
+                                if (isset($thisfile_riff_WAVE['MEXT'][0]['data'])) {
+                                        // shortcut
+                                        $thisfile_riff_WAVE_MEXT_0 = &$thisfile_riff_WAVE['MEXT'][0];
+
+                                        $thisfile_riff_WAVE_MEXT_0['raw']['sound_information']      = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_MEXT_0['data'], 0, 2));
+                                        $thisfile_riff_WAVE_MEXT_0['flags']['homogenous']           = (bool) ($thisfile_riff_WAVE_MEXT_0['raw']['sound_information'] & 0x0001);
+                                        if ($thisfile_riff_WAVE_MEXT_0['flags']['homogenous']) {
+                                                $thisfile_riff_WAVE_MEXT_0['flags']['padding']          = ($thisfile_riff_WAVE_MEXT_0['raw']['sound_information'] & 0x0002) ? false : true;
+                                                $thisfile_riff_WAVE_MEXT_0['flags']['22_or_44']         =        (bool) ($thisfile_riff_WAVE_MEXT_0['raw']['sound_information'] & 0x0004);
+                                                $thisfile_riff_WAVE_MEXT_0['flags']['free_format']      =        (bool) ($thisfile_riff_WAVE_MEXT_0['raw']['sound_information'] & 0x0008);
+
+                                                $thisfile_riff_WAVE_MEXT_0['nominal_frame_size']        = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_MEXT_0['data'], 2, 2));
+                                        }
+                                        $thisfile_riff_WAVE_MEXT_0['anciliary_data_length']         = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_MEXT_0['data'], 6, 2));
+                                        $thisfile_riff_WAVE_MEXT_0['raw']['anciliary_data_def']     = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_MEXT_0['data'], 8, 2));
+                                        $thisfile_riff_WAVE_MEXT_0['flags']['anciliary_data_left']  = (bool) ($thisfile_riff_WAVE_MEXT_0['raw']['anciliary_data_def'] & 0x0001);
+                                        $thisfile_riff_WAVE_MEXT_0['flags']['anciliary_data_free']  = (bool) ($thisfile_riff_WAVE_MEXT_0['raw']['anciliary_data_def'] & 0x0002);
+                                        $thisfile_riff_WAVE_MEXT_0['flags']['anciliary_data_right'] = (bool) ($thisfile_riff_WAVE_MEXT_0['raw']['anciliary_data_def'] & 0x0004);
+                                }
+
+                                if (isset($thisfile_riff_WAVE['cart'][0]['data'])) {
+                                        // shortcut
+                                        $thisfile_riff_WAVE_cart_0 = &$thisfile_riff_WAVE['cart'][0];
+
+                                        $thisfile_riff_WAVE_cart_0['version']              =                              substr($thisfile_riff_WAVE_cart_0['data'],   0,  4);
+                                        $thisfile_riff_WAVE_cart_0['title']                =                         trim(substr($thisfile_riff_WAVE_cart_0['data'],   4, 64));
+                                        $thisfile_riff_WAVE_cart_0['artist']               =                         trim(substr($thisfile_riff_WAVE_cart_0['data'],  68, 64));
+                                        $thisfile_riff_WAVE_cart_0['cut_id']               =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 132, 64));
+                                        $thisfile_riff_WAVE_cart_0['client_id']            =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 196, 64));
+                                        $thisfile_riff_WAVE_cart_0['category']             =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 260, 64));
+                                        $thisfile_riff_WAVE_cart_0['classification']       =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 324, 64));
+                                        $thisfile_riff_WAVE_cart_0['out_cue']              =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 388, 64));
+                                        $thisfile_riff_WAVE_cart_0['start_date']           =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 452, 10));
+                                        $thisfile_riff_WAVE_cart_0['start_time']           =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 462,  8));
+                                        $thisfile_riff_WAVE_cart_0['end_date']             =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 470, 10));
+                                        $thisfile_riff_WAVE_cart_0['end_time']             =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 480,  8));
+                                        $thisfile_riff_WAVE_cart_0['producer_app_id']      =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 488, 64));
+                                        $thisfile_riff_WAVE_cart_0['producer_app_version'] =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 552, 64));
+                                        $thisfile_riff_WAVE_cart_0['user_defined_text']    =                         trim(substr($thisfile_riff_WAVE_cart_0['data'], 616, 64));
+                                        $thisfile_riff_WAVE_cart_0['zero_db_reference']    = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_cart_0['data'], 680,  4), true);
+                                        for ($i = 0; $i < 8; $i++) {
+                                                $thisfile_riff_WAVE_cart_0['post_time'][$i]['usage_fourcc'] =                  substr($thisfile_riff_WAVE_cart_0['data'], 684 + ($i * 8), 4);
+                                                $thisfile_riff_WAVE_cart_0['post_time'][$i]['timer_value']  = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE_cart_0['data'], 684 + ($i * 8) + 4, 4));
+                                        }
+                                        $thisfile_riff_WAVE_cart_0['url']              =                 trim(substr($thisfile_riff_WAVE_cart_0['data'],  748, 1024));
+                                        $thisfile_riff_WAVE_cart_0['tag_text']         = explode("\r\n", trim(substr($thisfile_riff_WAVE_cart_0['data'], 1772)));
+
+                                        $thisfile_riff['comments']['artist'][] = $thisfile_riff_WAVE_cart_0['artist'];
+                                        $thisfile_riff['comments']['title'][]  = $thisfile_riff_WAVE_cart_0['title'];
+                                }
+
+                                if (isset($thisfile_riff_WAVE['SNDM'][0]['data'])) {
+                                        // SoundMiner metadata
+
+                                        // shortcuts
+                                        $thisfile_riff_WAVE_SNDM_0      = &$thisfile_riff_WAVE['SNDM'][0];
+                                        $thisfile_riff_WAVE_SNDM_0_data = &$thisfile_riff_WAVE_SNDM_0['data'];
+                                        $SNDM_startoffset = 0;
+                                        $SNDM_endoffset   = $thisfile_riff_WAVE_SNDM_0['size'];
+
+                                        while ($SNDM_startoffset < $SNDM_endoffset) {
+                                                $SNDM_thisTagOffset = 0;
+                                                $SNDM_thisTagSize      = getid3_lib::BigEndian2Int(substr($thisfile_riff_WAVE_SNDM_0_data, $SNDM_startoffset + $SNDM_thisTagOffset, 4));
+                                                $SNDM_thisTagOffset += 4;
+                                                $SNDM_thisTagKey       =                           substr($thisfile_riff_WAVE_SNDM_0_data, $SNDM_startoffset + $SNDM_thisTagOffset, 4);
+                                                $SNDM_thisTagOffset += 4;
+                                                $SNDM_thisTagDataSize  = getid3_lib::BigEndian2Int(substr($thisfile_riff_WAVE_SNDM_0_data, $SNDM_startoffset + $SNDM_thisTagOffset, 2));
+                                                $SNDM_thisTagOffset += 2;
+                                                $SNDM_thisTagDataFlags = getid3_lib::BigEndian2Int(substr($thisfile_riff_WAVE_SNDM_0_data, $SNDM_startoffset + $SNDM_thisTagOffset, 2));
+                                                $SNDM_thisTagOffset += 2;
+                                                $SNDM_thisTagDataText =                            substr($thisfile_riff_WAVE_SNDM_0_data, $SNDM_startoffset + $SNDM_thisTagOffset, $SNDM_thisTagDataSize);
+                                                $SNDM_thisTagOffset += $SNDM_thisTagDataSize;
+
+                                                if ($SNDM_thisTagSize != (4 + 4 + 2 + 2 + $SNDM_thisTagDataSize)) {
+                                                        $info['warning'][] = 'RIFF.WAVE.SNDM.data contains tag not expected length (expected: '.$SNDM_thisTagSize.', found: '.(4 + 4 + 2 + 2 + $SNDM_thisTagDataSize).') at offset '.$SNDM_startoffset.' (file offset '.($thisfile_riff_WAVE_SNDM_0['offset'] + $SNDM_startoffset).')';
+                                                        break;
+                                                } elseif ($SNDM_thisTagSize <= 0) {
+                                                        $info['warning'][] = 'RIFF.WAVE.SNDM.data contains zero-size tag at offset '.$SNDM_startoffset.' (file offset '.($thisfile_riff_WAVE_SNDM_0['offset'] + $SNDM_startoffset).')';
+                                                        break;
+                                                }
+                                                $SNDM_startoffset += $SNDM_thisTagSize;
+
+                                                $thisfile_riff_WAVE_SNDM_0['parsed_raw'][$SNDM_thisTagKey] = $SNDM_thisTagDataText;
+                                                if ($parsedkey = self::waveSNDMtagLookup($SNDM_thisTagKey)) {
+                                                        $thisfile_riff_WAVE_SNDM_0['parsed'][$parsedkey] = $SNDM_thisTagDataText;
+                                                } else {
+                                                        $info['warning'][] = 'RIFF.WAVE.SNDM contains unknown tag "'.$SNDM_thisTagKey.'" at offset '.$SNDM_startoffset.' (file offset '.($thisfile_riff_WAVE_SNDM_0['offset'] + $SNDM_startoffset).')';
+                                                }
+                                        }
+
+                                        $tagmapping = array(
+                                                'tracktitle'=>'title',
+                                                'category'  =>'genre',
+                                                'cdtitle'   =>'album',
+                                                'tracktitle'=>'title',
+                                        );
+                                        foreach ($tagmapping as $fromkey => $tokey) {
+                                                if (isset($thisfile_riff_WAVE_SNDM_0['parsed'][$fromkey])) {
+                                                        $thisfile_riff['comments'][$tokey][] = $thisfile_riff_WAVE_SNDM_0['parsed'][$fromkey];
+                                                }
+                                        }
+                                }
+
+                                if (isset($thisfile_riff_WAVE['iXML'][0]['data'])) {
+                                        // requires functions simplexml_load_string and get_object_vars
+                                        if ($parsedXML = getid3_lib::XML2array($thisfile_riff_WAVE['iXML'][0]['data'])) {
+                                                $thisfile_riff_WAVE['iXML'][0]['parsed'] = $parsedXML;
+                                                if (isset($parsedXML['SPEED']['MASTER_SPEED'])) {
+                                                        @list($numerator, $denominator) = explode('/', $parsedXML['SPEED']['MASTER_SPEED']);
+                                                        $thisfile_riff_WAVE['iXML'][0]['master_speed'] = $numerator / ($denominator ? $denominator : 1000);
+                                                }
+                                                if (isset($parsedXML['SPEED']['TIMECODE_RATE'])) {
+                                                        @list($numerator, $denominator) = explode('/', $parsedXML['SPEED']['TIMECODE_RATE']);
+                                                        $thisfile_riff_WAVE['iXML'][0]['timecode_rate'] = $numerator / ($denominator ? $denominator : 1000);
+                                                }
+                                                if (isset($parsedXML['SPEED']['TIMESTAMP_SAMPLES_SINCE_MIDNIGHT_LO']) && !empty($parsedXML['SPEED']['TIMESTAMP_SAMPLE_RATE']) && !empty($thisfile_riff_WAVE['iXML'][0]['timecode_rate'])) {
+                                                        $samples_since_midnight = floatval(ltrim($parsedXML['SPEED']['TIMESTAMP_SAMPLES_SINCE_MIDNIGHT_HI'].$parsedXML['SPEED']['TIMESTAMP_SAMPLES_SINCE_MIDNIGHT_LO'], '0'));
+                                                        $thisfile_riff_WAVE['iXML'][0]['timecode_seconds'] = $samples_since_midnight / $parsedXML['SPEED']['TIMESTAMP_SAMPLE_RATE'];
+                                                        $h = floor( $thisfile_riff_WAVE['iXML'][0]['timecode_seconds']       / 3600);
+                                                        $m = floor(($thisfile_riff_WAVE['iXML'][0]['timecode_seconds'] - ($h * 3600))      / 60);
+                                                        $s = floor( $thisfile_riff_WAVE['iXML'][0]['timecode_seconds'] - ($h * 3600) - ($m * 60));
+                                                        $f =       ($thisfile_riff_WAVE['iXML'][0]['timecode_seconds'] - ($h * 3600) - ($m * 60) - $s) * $thisfile_riff_WAVE['iXML'][0]['timecode_rate'];
+                                                        $thisfile_riff_WAVE['iXML'][0]['timecode_string']       = sprintf('%02d:%02d:%02d:%05.2f', $h, $m, $s,       $f);
+                                                        $thisfile_riff_WAVE['iXML'][0]['timecode_string_round'] = sprintf('%02d:%02d:%02d:%02d',   $h, $m, $s, round($f));
+                                                }
+                                                unset($parsedXML);
+                                        }
+                                }
+
+
+
+                                if (!isset($thisfile_audio['bitrate']) && isset($thisfile_riff_audio[$streamindex]['bitrate'])) {
+                                        $thisfile_audio['bitrate'] = $thisfile_riff_audio[$streamindex]['bitrate'];
+                                        $info['playtime_seconds'] = (float) ((($info['avdataend'] - $info['avdataoffset']) * 8) / $thisfile_audio['bitrate']);
+                                }
+
+                                if (!empty($info['wavpack'])) {
+                                        $thisfile_audio_dataformat = 'wavpack';
+                                        $thisfile_audio['bitrate_mode'] = 'vbr';
+                                        $thisfile_audio['encoder']      = 'WavPack v'.$info['wavpack']['version'];
+
+                                        // Reset to the way it was - RIFF parsing will have messed this up
+                                        $info['avdataend']        = $Original['avdataend'];
+                                        $thisfile_audio['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $info['playtime_seconds'];
+
+                                        $this->fseek($info['avdataoffset'] - 44);
+                                        $RIFFdata = $this->fread(44);
+                                        $OrignalRIFFheaderSize = getid3_lib::LittleEndian2Int(substr($RIFFdata,  4, 4)) +  8;
+                                        $OrignalRIFFdataSize   = getid3_lib::LittleEndian2Int(substr($RIFFdata, 40, 4)) + 44;
+
+                                        if ($OrignalRIFFheaderSize > $OrignalRIFFdataSize) {
+                                                $info['avdataend'] -= ($OrignalRIFFheaderSize - $OrignalRIFFdataSize);
+                                                $this->fseek($info['avdataend']);
+                                                $RIFFdata .= $this->fread($OrignalRIFFheaderSize - $OrignalRIFFdataSize);
+                                        }
+
+                                        // 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
+                                        $RIFFdata = substr($RIFFdata, 0, 36).substr($RIFFdata, 44).substr($RIFFdata, 36, 8);
+                                        $getid3_riff = new getid3_riff($this->getid3);
+                                        $getid3_riff->ParseRIFFdata($RIFFdata);
+                                        unset($getid3_riff);
+                                }
+
+                                if (isset($thisfile_riff_raw['fmt ']['wFormatTag'])) {
+                                        switch ($thisfile_riff_raw['fmt ']['wFormatTag']) {
+                                                case 0x0001: // PCM
+                                                        if (!empty($info['ac3'])) {
+                                                                // Dolby Digital WAV files masquerade as PCM-WAV, but they're not
+                                                                $thisfile_audio['wformattag']  = 0x2000;
+                                                                $thisfile_audio['codec']       = self::wFormatTagLookup($thisfile_audio['wformattag']);
+                                                                $thisfile_audio['lossless']    = false;
+                                                                $thisfile_audio['bitrate']     = $info['ac3']['bitrate'];
+                                                                $thisfile_audio['sample_rate'] = $info['ac3']['sample_rate'];
+                                                        }
+                                                        if (!empty($info['dts'])) {
+                                                                // Dolby DTS files masquerade as PCM-WAV, but they're not
+                                                                $thisfile_audio['wformattag']  = 0x2001;
+                                                                $thisfile_audio['codec']       = self::wFormatTagLookup($thisfile_audio['wformattag']);
+                                                                $thisfile_audio['lossless']    = false;
+                                                                $thisfile_audio['bitrate']     = $info['dts']['bitrate'];
+                                                                $thisfile_audio['sample_rate'] = $info['dts']['sample_rate'];
+                                                        }
+                                                        break;
+                                                case 0x08AE: // ClearJump LiteWave
+                                                        $thisfile_audio['bitrate_mode'] = 'vbr';
+                                                        $thisfile_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;
+
+                                                        // shortcut
+                                                        $thisfile_riff['litewave']['raw'] = array();
+                                                        $riff_litewave     = &$thisfile_riff['litewave'];
+                                                        $riff_litewave_raw = &$riff_litewave['raw'];
+
+                                                        $flags = 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,
+                                                        );
+                                                        $litewave_offset = 18;
+                                                        foreach ($flags as $flag => $length) {
+                                                                $riff_litewave_raw[$flag] = getid3_lib::LittleEndian2Int(substr($thisfile_riff_WAVE['fmt '][0]['data'], $litewave_offset, $length));
+                                                                $litewave_offset += $length;
+                                                        }
+
+                                                        //$riff_litewave['quality_factor'] = intval(round((2000 - $riff_litewave_raw['m_dwScale']) / 20));
+                                                        $riff_litewave['quality_factor'] = $riff_litewave_raw['m_wQuality'];
+
+                                                        $riff_litewave['flags']['raw_source']    = ($riff_litewave_raw['compression_flags'] & 0x01) ? false : true;
+                                                        $riff_litewave['flags']['vbr_blocksize'] = ($riff_litewave_raw['compression_flags'] & 0x02) ? false : true;
+                                                        $riff_litewave['flags']['seekpoints']    =        (bool) ($riff_litewave_raw['compression_flags'] & 0x04);
+
+                                                        $thisfile_audio['lossless']        = (($riff_litewave_raw['m_wQuality'] == 100) ? true : false);
+                                                        $thisfile_audio['encoder_options'] = '-q'.$riff_litewave['quality_factor'];
+                                                        break;
+
+                                                default:
+                                                        break;
+                                        }
+                                }
+                                if ($info['avdataend'] > $info['filesize']) {
+                                        switch (!empty($thisfile_audio_dataformat) ? $thisfile_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'] - $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
+                                                                $info['warning'][] = 'Probably truncated file - expecting '.$thisfile_riff[$RIFFsubtype]['data'][0]['size'].' bytes of data, only found '.($info['filesize'] - $info['avdataoffset']).' (short by '.($thisfile_riff[$RIFFsubtype]['data'][0]['size'] - ($info['filesize'] - $info['avdataoffset'])).' bytes)';
+                                                                $info['avdataend'] = $info['filesize'];
+                                                        }
+                                                        break;
+
+                                                default:
+                                                        if ((($info['avdataend'] - $info['filesize']) == 1) && (($thisfile_riff[$RIFFsubtype]['data'][0]['size'] % 2) == 0) && ((($info['filesize'] - $info['avdataoffset']) % 2) == 1)) {
+                                                                // output file appears to be incorrectly *not* padded to nearest WORD boundary
+                                                                // Output less severe warning
+                                                                $info['warning'][] = 'File should probably be padded to nearest WORD boundary, but it is not (expecting '.$thisfile_riff[$RIFFsubtype]['data'][0]['size'].' bytes of data, only found '.($info['filesize'] - $info['avdataoffset']).' therefore short by '.($thisfile_riff[$RIFFsubtype]['data'][0]['size'] - ($info['filesize'] - $info['avdataoffset'])).' bytes)';
+                                                                $info['avdataend'] = $info['filesize'];
+                                                        } else {
+                                                                // Short by more than one byte, throw warning
+                                                                $info['warning'][] = 'Probably truncated file - expecting '.$thisfile_riff[$RIFFsubtype]['data'][0]['size'].' bytes of data, only found '.($info['filesize'] - $info['avdataoffset']).' (short by '.($thisfile_riff[$RIFFsubtype]['data'][0]['size'] - ($info['filesize'] - $info['avdataoffset'])).' bytes)';
+                                                                $info['avdataend'] = $info['filesize'];
+                                                        }
+                                                        break;
+                                        }
+                                }
+                                if (!empty($info['mpeg']['audio']['LAME']['audio_bytes'])) {
+                                        if ((($info['avdataend'] - $info['avdataoffset']) - $info['mpeg']['audio']['LAME']['audio_bytes']) == 1) {
+                                                $info['avdataend']--;
+                                                $info['warning'][] = 'Extra null byte at end of MP3 data assumed to be RIFF padding and therefore ignored';
+                                        }
+                                }
+                                if (isset($thisfile_audio_dataformat) && ($thisfile_audio_dataformat == 'ac3')) {
+                                        unset($thisfile_audio['bits_per_sample']);
+                                        if (!empty($info['ac3']['bitrate']) && ($info['ac3']['bitrate'] != $thisfile_audio['bitrate'])) {
+                                                $thisfile_audio['bitrate'] = $info['ac3']['bitrate'];
+                                        }
+                                }
+                                break;
+
+                        case 'AVI ':
+                                $thisfile_video['bitrate_mode'] = 'vbr'; // maybe not, but probably
+                                $thisfile_video['dataformat']   = 'avi';
+                                $info['mime_type']      = 'video/avi';
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['movi']['offset'])) {
+                                        $info['avdataoffset'] = $thisfile_riff[$RIFFsubtype]['movi']['offset'] + 8;
+                                        if (isset($thisfile_riff['AVIX'])) {
+                                                $info['avdataend'] = $thisfile_riff['AVIX'][(count($thisfile_riff['AVIX']) - 1)]['chunks']['movi']['offset'] + $thisfile_riff['AVIX'][(count($thisfile_riff['AVIX']) - 1)]['chunks']['movi']['size'];
+                                        } else {
+                                                $info['avdataend'] = $thisfile_riff['AVI ']['movi']['offset'] + $thisfile_riff['AVI ']['movi']['size'];
+                                        }
+                                        if ($info['avdataend'] > $info['filesize']) {
+                                                $info['warning'][] = 'Probably truncated file - expecting '.($info['avdataend'] - $info['avdataoffset']).' bytes of data, only found '.($info['filesize'] - $info['avdataoffset']).' (short by '.($info['avdataend'] - $info['filesize']).' bytes)';
+                                                $info['avdataend'] = $info['filesize'];
+                                        }
+                                }
+
+                                if (isset($thisfile_riff['AVI ']['hdrl']['strl']['indx'])) {
+                                        //$bIndexType = array(
+                                        //      0x00 => 'AVI_INDEX_OF_INDEXES',
+                                        //      0x01 => 'AVI_INDEX_OF_CHUNKS',
+                                        //      0x80 => 'AVI_INDEX_IS_DATA',
+                                        //);
+                                        //$bIndexSubtype = array(
+                                        //      0x01 => array(
+                                        //              0x01 => 'AVI_INDEX_2FIELD',
+                                        //      ),
+                                        //);
+                                        foreach ($thisfile_riff['AVI ']['hdrl']['strl']['indx'] as $streamnumber => $steamdataarray) {
+                                                $ahsisd = &$thisfile_riff['AVI ']['hdrl']['strl']['indx'][$streamnumber]['data'];
+
+                                                $thisfile_riff_raw['indx'][$streamnumber]['wLongsPerEntry'] = $this->EitherEndian2Int(substr($ahsisd,  0, 2));
+                                                $thisfile_riff_raw['indx'][$streamnumber]['bIndexSubType']  = $this->EitherEndian2Int(substr($ahsisd,  2, 1));
+                                                $thisfile_riff_raw['indx'][$streamnumber]['bIndexType']     = $this->EitherEndian2Int(substr($ahsisd,  3, 1));
+                                                $thisfile_riff_raw['indx'][$streamnumber]['nEntriesInUse']  = $this->EitherEndian2Int(substr($ahsisd,  4, 4));
+                                                $thisfile_riff_raw['indx'][$streamnumber]['dwChunkId']      =                         substr($ahsisd,  8, 4);
+                                                $thisfile_riff_raw['indx'][$streamnumber]['dwReserved']     = $this->EitherEndian2Int(substr($ahsisd, 12, 4));
+
+                                                //$thisfile_riff_raw['indx'][$streamnumber]['bIndexType_name']    =    $bIndexType[$thisfile_riff_raw['indx'][$streamnumber]['bIndexType']];
+                                                //$thisfile_riff_raw['indx'][$streamnumber]['bIndexSubType_name'] = $bIndexSubtype[$thisfile_riff_raw['indx'][$streamnumber]['bIndexType']][$thisfile_riff_raw['indx'][$streamnumber]['bIndexSubType']];
+
+                                                unset($ahsisd);
+                                        }
+                                }
+                                if (isset($thisfile_riff['AVI ']['hdrl']['avih'][$streamindex]['data'])) {
+                                        $avihData = $thisfile_riff['AVI ']['hdrl']['avih'][$streamindex]['data'];
+
+                                        // shortcut
+                                        $thisfile_riff_raw['avih'] = array();
+                                        $thisfile_riff_raw_avih = &$thisfile_riff_raw['avih'];
+
+                                        $thisfile_riff_raw_avih['dwMicroSecPerFrame']    = $this->EitherEndian2Int(substr($avihData,  0, 4)); // frame display rate (or 0L)
+                                        if ($thisfile_riff_raw_avih['dwMicroSecPerFrame'] == 0) {
+                                                $info['error'][] = 'Corrupt RIFF file: avih.dwMicroSecPerFrame == zero';
+                                                return false;
+                                        }
+
+                                        $flags = array(
+                                                'dwMaxBytesPerSec',       // max. transfer rate
+                                                'dwPaddingGranularity',   // pad to multiples of this size; normally 2K.
+                                                'dwFlags',                // the ever-present flags
+                                                'dwTotalFrames',          // # frames in file
+                                                'dwInitialFrames',        //
+                                                'dwStreams',              //
+                                                'dwSuggestedBufferSize',  //
+                                                'dwWidth',                //
+                                                'dwHeight',               //
+                                                'dwScale',                //
+                                                'dwRate',                 //
+                                                'dwStart',                //
+                                                'dwLength',               //
+                                        );
+                                        $avih_offset = 4;
+                                        foreach ($flags as $flag) {
+                                                $thisfile_riff_raw_avih[$flag] = $this->EitherEndian2Int(substr($avihData, $avih_offset, 4));
+                                                $avih_offset += 4;
+                                        }
+
+                                        $flags = array(
+                                                'hasindex'     => 0x00000010,
+                                                'mustuseindex' => 0x00000020,
+                                                'interleaved'  => 0x00000100,
+                                                'trustcktype'  => 0x00000800,
+                                                'capturedfile' => 0x00010000,
+                                                'copyrighted'  => 0x00020010,
+                                        );
+                    foreach ($flags as $flag => $value) {
+                                                $thisfile_riff_raw_avih['flags'][$flag] = (bool) ($thisfile_riff_raw_avih['dwFlags'] & $value);
+                                        }
+
+                                        // shortcut
+                                        $thisfile_riff_video[$streamindex] = array();
+                                        $thisfile_riff_video_current = &$thisfile_riff_video[$streamindex];
+
+                                        if ($thisfile_riff_raw_avih['dwWidth'] > 0) {
+                                                $thisfile_riff_video_current['frame_width'] = $thisfile_riff_raw_avih['dwWidth'];
+                                                $thisfile_video['resolution_x']             = $thisfile_riff_video_current['frame_width'];
+                                        }
+                                        if ($thisfile_riff_raw_avih['dwHeight'] > 0) {
+                                                $thisfile_riff_video_current['frame_height'] = $thisfile_riff_raw_avih['dwHeight'];
+                                                $thisfile_video['resolution_y']              = $thisfile_riff_video_current['frame_height'];
+                                        }
+                                        if ($thisfile_riff_raw_avih['dwTotalFrames'] > 0) {
+                                                $thisfile_riff_video_current['total_frames'] = $thisfile_riff_raw_avih['dwTotalFrames'];
+                                                $thisfile_video['total_frames']              = $thisfile_riff_video_current['total_frames'];
+                                        }
+
+                                        $thisfile_riff_video_current['frame_rate'] = round(1000000 / $thisfile_riff_raw_avih['dwMicroSecPerFrame'], 3);
+                                        $thisfile_video['frame_rate'] = $thisfile_riff_video_current['frame_rate'];
+                                }
+                                if (isset($thisfile_riff['AVI ']['hdrl']['strl']['strh'][0]['data'])) {
+                                        if (is_array($thisfile_riff['AVI ']['hdrl']['strl']['strh'])) {
+                                                for ($i = 0; $i < count($thisfile_riff['AVI ']['hdrl']['strl']['strh']); $i++) {
+                                                        if (isset($thisfile_riff['AVI ']['hdrl']['strl']['strh'][$i]['data'])) {
+                                                                $strhData = $thisfile_riff['AVI ']['hdrl']['strl']['strh'][$i]['data'];
+                                                                $strhfccType = substr($strhData,  0, 4);
+
+                                                                if (isset($thisfile_riff['AVI ']['hdrl']['strl']['strf'][$i]['data'])) {
+                                                                        $strfData = $thisfile_riff['AVI ']['hdrl']['strl']['strf'][$i]['data'];
+
+                                                                        // shortcut
+                                                                        $thisfile_riff_raw_strf_strhfccType_streamindex = &$thisfile_riff_raw['strf'][$strhfccType][$streamindex];
+
+                                                                        switch ($strhfccType) {
+                                                                                case 'auds':
+                                                                                        $thisfile_audio['bitrate_mode'] = 'cbr';
+                                                                                        $thisfile_audio_dataformat      = 'wav';
+                                                                                        if (isset($thisfile_riff_audio) && is_array($thisfile_riff_audio)) {
+                                                                                                $streamindex = count($thisfile_riff_audio);
+                                                                                        }
+
+                                                                                        $thisfile_riff_audio[$streamindex] = self::parseWAVEFORMATex($strfData);
+                                                                                        $thisfile_audio['wformattag'] = $thisfile_riff_audio[$streamindex]['raw']['wFormatTag'];
+
+                                                                                        // shortcut
+                                                                                        $thisfile_audio['streams'][$streamindex] = $thisfile_riff_audio[$streamindex];
+                                                                                        $thisfile_audio_streams_currentstream = &$thisfile_audio['streams'][$streamindex];
+
+                                                                                        if ($thisfile_audio_streams_currentstream['bits_per_sample'] == 0) {
+                                                                                                unset($thisfile_audio_streams_currentstream['bits_per_sample']);
+                                                                                        }
+                                                                                        $thisfile_audio_streams_currentstream['wformattag'] = $thisfile_audio_streams_currentstream['raw']['wFormatTag'];
+                                                                                        unset($thisfile_audio_streams_currentstream['raw']);
+
+                                                                                        // shortcut
+                                                                                        $thisfile_riff_raw['strf'][$strhfccType][$streamindex] = $thisfile_riff_audio[$streamindex]['raw'];
+
+                                                                                        unset($thisfile_riff_audio[$streamindex]['raw']);
+                                                                                        $thisfile_audio = getid3_lib::array_merge_noclobber($thisfile_audio, $thisfile_riff_audio[$streamindex]);
+
+                                                                                        $thisfile_audio['lossless'] = false;
+                                                                                        switch ($thisfile_riff_raw_strf_strhfccType_streamindex['wFormatTag']) {
+                                                                                                case 0x0001:  // PCM
+                                                                                                        $thisfile_audio_dataformat  = 'wav';
+                                                                                                        $thisfile_audio['lossless'] = true;
+                                                                                                        break;
+
+                                                                                                case 0x0050: // MPEG Layer 2 or Layer 1
+                                                                                                        $thisfile_audio_dataformat = 'mp2'; // Assume Layer-2
+                                                                                                        break;
+
+                                                                                                case 0x0055: // MPEG Layer 3
+                                                                                                        $thisfile_audio_dataformat = 'mp3';
+                                                                                                        break;
+
+                                                                                                case 0x00FF: // AAC
+                                                                                                        $thisfile_audio_dataformat = 'aac';
+                                                                                                        break;
+
+                                                                                                case 0x0161: // Windows Media v7 / v8 / v9
+                                                                                                case 0x0162: // Windows Media Professional v9
+                                                                                                case 0x0163: // Windows Media Lossess v9
+                                                                                                        $thisfile_audio_dataformat = 'wma';
+                                                                                                        break;
+
+                                                                                                case 0x2000: // AC-3
+                                                                                                        $thisfile_audio_dataformat = 'ac3';
+                                                                                                        break;
+
+                                                                                                case 0x2001: // DTS
+                                                                                                        $thisfile_audio_dataformat = 'dts';
+                                                                                                        break;
+
+                                                                                                default:
+                                                                                                        $thisfile_audio_dataformat = 'wav';
+                                                                                                        break;
+                                                                                        }
+                                                                                        $thisfile_audio_streams_currentstream['dataformat']   = $thisfile_audio_dataformat;
+                                                                                        $thisfile_audio_streams_currentstream['lossless']     = $thisfile_audio['lossless'];
+                                                                                        $thisfile_audio_streams_currentstream['bitrate_mode'] = $thisfile_audio['bitrate_mode'];
+                                                                                        break;
+
+
+                                                                                case 'iavs':
+                                                                                case 'vids':
+                                                                                        // shortcut
+                                                                                        $thisfile_riff_raw['strh'][$i]                  = array();
+                                                                                        $thisfile_riff_raw_strh_current                 = &$thisfile_riff_raw['strh'][$i];
+
+                                                                                        $thisfile_riff_raw_strh_current['fccType']               =                         substr($strhData,  0, 4);  // same as $strhfccType;
+                                                                                        $thisfile_riff_raw_strh_current['fccHandler']            =                         substr($strhData,  4, 4);
+                                                                                        $thisfile_riff_raw_strh_current['dwFlags']               = $this->EitherEndian2Int(substr($strhData,  8, 4)); // Contains AVITF_* flags
+                                                                                        $thisfile_riff_raw_strh_current['wPriority']             = $this->EitherEndian2Int(substr($strhData, 12, 2));
+                                                                                        $thisfile_riff_raw_strh_current['wLanguage']             = $this->EitherEndian2Int(substr($strhData, 14, 2));
+                                                                                        $thisfile_riff_raw_strh_current['dwInitialFrames']       = $this->EitherEndian2Int(substr($strhData, 16, 4));
+                                                                                        $thisfile_riff_raw_strh_current['dwScale']               = $this->EitherEndian2Int(substr($strhData, 20, 4));
+                                                                                        $thisfile_riff_raw_strh_current['dwRate']                = $this->EitherEndian2Int(substr($strhData, 24, 4));
+                                                                                        $thisfile_riff_raw_strh_current['dwStart']               = $this->EitherEndian2Int(substr($strhData, 28, 4));
+                                                                                        $thisfile_riff_raw_strh_current['dwLength']              = $this->EitherEndian2Int(substr($strhData, 32, 4));
+                                                                                        $thisfile_riff_raw_strh_current['dwSuggestedBufferSize'] = $this->EitherEndian2Int(substr($strhData, 36, 4));
+                                                                                        $thisfile_riff_raw_strh_current['dwQuality']             = $this->EitherEndian2Int(substr($strhData, 40, 4));
+                                                                                        $thisfile_riff_raw_strh_current['dwSampleSize']          = $this->EitherEndian2Int(substr($strhData, 44, 4));
+                                                                                        $thisfile_riff_raw_strh_current['rcFrame']               = $this->EitherEndian2Int(substr($strhData, 48, 4));
+
+                                                                                        $thisfile_riff_video_current['codec'] = self::fourccLookup($thisfile_riff_raw_strh_current['fccHandler']);
+                                                                                        $thisfile_video['fourcc']             = $thisfile_riff_raw_strh_current['fccHandler'];
+                                                                                        if (!$thisfile_riff_video_current['codec'] && isset($thisfile_riff_raw_strf_strhfccType_streamindex['fourcc']) && self::fourccLookup($thisfile_riff_raw_strf_strhfccType_streamindex['fourcc'])) {
+                                                                                                $thisfile_riff_video_current['codec'] = self::fourccLookup($thisfile_riff_raw_strf_strhfccType_streamindex['fourcc']);
+                                                                                                $thisfile_video['fourcc']             = $thisfile_riff_raw_strf_strhfccType_streamindex['fourcc'];
+                                                                                        }
+                                                                                        $thisfile_video['codec']              = $thisfile_riff_video_current['codec'];
+                                                                                        $thisfile_video['pixel_aspect_ratio'] = (float) 1;
+                                                                                        switch ($thisfile_riff_raw_strh_current['fccHandler']) {
+                                                                                                case 'HFYU': // Huffman Lossless Codec
+                                                                                                case 'IRAW': // Intel YUV Uncompressed
+                                                                                                case 'YUY2': // Uncompressed YUV 4:2:2
+                                                                                                        $thisfile_video['lossless'] = true;
+                                                                                                        break;
+
+                                                                                                default:
+                                                                                                        $thisfile_video['lossless'] = false;
+                                                                                                        break;
+                                                                                        }
+
+                                                                                        switch ($strhfccType) {
+                                                                                                case 'vids':
+                                                                                                        $thisfile_riff_raw_strf_strhfccType_streamindex = self::ParseBITMAPINFOHEADER(substr($strfData, 0, 40), ($info['fileformat'] == 'riff'));
+                                                                                                        $thisfile_video['bits_per_sample'] = $thisfile_riff_raw_strf_strhfccType_streamindex['biBitCount'];
+
+                                                                                                        if ($thisfile_riff_video_current['codec'] == 'DV') {
+                                                                                                                $thisfile_riff_video_current['dv_type'] = 2;
+                                                                                                        }
+                                                                                                        break;
+
+                                                                                                case 'iavs':
+                                                                                                        $thisfile_riff_video_current['dv_type'] = 1;
+                                                                                                        break;
+                                                                                        }
+                                                                                        break;
+
+                                                                                default:
+                                                                                        $info['warning'][] = 'Unhandled fccType for stream ('.$i.'): "'.$strhfccType.'"';
+                                                                                        break;
+
+                                                                        }
+                                                                }
+                                                        }
+
+                                                        if (isset($thisfile_riff_raw_strf_strhfccType_streamindex['fourcc'])) {
+
+                                                                $thisfile_video['fourcc'] = $thisfile_riff_raw_strf_strhfccType_streamindex['fourcc'];
+                                                                if (self::fourccLookup($thisfile_video['fourcc'])) {
+                                                                        $thisfile_riff_video_current['codec'] = self::fourccLookup($thisfile_video['fourcc']);
+                                                                        $thisfile_video['codec']              = $thisfile_riff_video_current['codec'];
+                                                                }
+
+                                                                switch ($thisfile_riff_raw_strf_strhfccType_streamindex['fourcc']) {
+                                                                        case 'HFYU': // Huffman Lossless Codec
+                                                                        case 'IRAW': // Intel YUV Uncompressed
+                                                                        case 'YUY2': // Uncompressed YUV 4:2:2
+                                                                                $thisfile_video['lossless']        = true;
+                                                                                //$thisfile_video['bits_per_sample'] = 24;
+                                                                                break;
+
+                                                                        default:
+                                                                                $thisfile_video['lossless']        = false;
+                                                                                //$thisfile_video['bits_per_sample'] = 24;
+                                                                                break;
+                                                                }
+
+                                                        }
+                                                }
+                                        }
+                                }
+                                break;
+
+                        case 'CDDA':
+                                $thisfile_audio['bitrate_mode'] = 'cbr';
+                                $thisfile_audio_dataformat      = 'cda';
+                                $thisfile_audio['lossless']     = true;
+                                unset($info['mime_type']);
+
+                                $info['avdataoffset'] = 44;
+
+                                if (isset($thisfile_riff['CDDA']['fmt '][0]['data'])) {
+                                        // shortcut
+                                        $thisfile_riff_CDDA_fmt_0 = &$thisfile_riff['CDDA']['fmt '][0];
+
+                                        $thisfile_riff_CDDA_fmt_0['unknown1']           = $this->EitherEndian2Int(substr($thisfile_riff_CDDA_fmt_0['data'],  0, 2));
+                                        $thisfile_riff_CDDA_fmt_0['track_num']          = $this->EitherEndian2Int(substr($thisfile_riff_CDDA_fmt_0['data'],  2, 2));
+                                        $thisfile_riff_CDDA_fmt_0['disc_id']            = $this->EitherEndian2Int(substr($thisfile_riff_CDDA_fmt_0['data'],  4, 4));
+                                        $thisfile_riff_CDDA_fmt_0['start_offset_frame'] = $this->EitherEndian2Int(substr($thisfile_riff_CDDA_fmt_0['data'],  8, 4));
+                                        $thisfile_riff_CDDA_fmt_0['playtime_frames']    = $this->EitherEndian2Int(substr($thisfile_riff_CDDA_fmt_0['data'], 12, 4));
+                                        $thisfile_riff_CDDA_fmt_0['unknown6']           = $this->EitherEndian2Int(substr($thisfile_riff_CDDA_fmt_0['data'], 16, 4));
+                                        $thisfile_riff_CDDA_fmt_0['unknown7']           = $this->EitherEndian2Int(substr($thisfile_riff_CDDA_fmt_0['data'], 20, 4));
+
+                                        $thisfile_riff_CDDA_fmt_0['start_offset_seconds'] = (float) $thisfile_riff_CDDA_fmt_0['start_offset_frame'] / 75;
+                                        $thisfile_riff_CDDA_fmt_0['playtime_seconds']     = (float) $thisfile_riff_CDDA_fmt_0['playtime_frames'] / 75;
+                                        $info['comments']['track']                = $thisfile_riff_CDDA_fmt_0['track_num'];
+                                        $info['playtime_seconds']                 = $thisfile_riff_CDDA_fmt_0['playtime_seconds'];
+
+                                        // hardcoded data for CD-audio
+                                        $thisfile_audio['sample_rate']     = 44100;
+                                        $thisfile_audio['channels']        = 2;
+                                        $thisfile_audio['bits_per_sample'] = 16;
+                                        $thisfile_audio['bitrate']         = $thisfile_audio['sample_rate'] * $thisfile_audio['channels'] * $thisfile_audio['bits_per_sample'];
+                                        $thisfile_audio['bitrate_mode']    = 'cbr';
+                                }
+                                break;
+
+
+                        case 'AIFF':
+                        case 'AIFC':
+                                $thisfile_audio['bitrate_mode'] = 'cbr';
+                                $thisfile_audio_dataformat      = 'aiff';
+                                $thisfile_audio['lossless']     = true;
+                                $info['mime_type']      = 'audio/x-aiff';
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['SSND'][0]['offset'])) {
+                                        $info['avdataoffset'] = $thisfile_riff[$RIFFsubtype]['SSND'][0]['offset'] + 8;
+                                        $info['avdataend']    = $info['avdataoffset'] + $thisfile_riff[$RIFFsubtype]['SSND'][0]['size'];
+                                        if ($info['avdataend'] > $info['filesize']) {
+                                                if (($info['avdataend'] == ($info['filesize'] + 1)) && (($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 {
+                                                        $info['warning'][] = 'Probable truncated AIFF file: expecting '.$thisfile_riff[$RIFFsubtype]['SSND'][0]['size'].' bytes of audio data, only '.($info['filesize'] - $info['avdataoffset']).' bytes found';
+                                                }
+                                                $info['avdataend'] = $info['filesize'];
+                                        }
+                                }
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['COMM'][0]['data'])) {
+
+                                        // shortcut
+                                        $thisfile_riff_RIFFsubtype_COMM_0_data = &$thisfile_riff[$RIFFsubtype]['COMM'][0]['data'];
+
+                                        $thisfile_riff_audio['channels']         =         getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_COMM_0_data,  0,  2), true);
+                                        $thisfile_riff_audio['total_samples']    =         getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_COMM_0_data,  2,  4), false);
+                                        $thisfile_riff_audio['bits_per_sample']  =         getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_COMM_0_data,  6,  2), true);
+                                        $thisfile_riff_audio['sample_rate']      = (int) getid3_lib::BigEndian2Float(substr($thisfile_riff_RIFFsubtype_COMM_0_data,  8, 10));
+
+                                        if ($thisfile_riff[$RIFFsubtype]['COMM'][0]['size'] > 18) {
+                                                $thisfile_riff_audio['codec_fourcc'] =                                   substr($thisfile_riff_RIFFsubtype_COMM_0_data, 18,  4);
+                                                $CodecNameSize                       =         getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_COMM_0_data, 22,  1), false);
+                                                $thisfile_riff_audio['codec_name']   =                                   substr($thisfile_riff_RIFFsubtype_COMM_0_data, 23,  $CodecNameSize);
+                                                switch ($thisfile_riff_audio['codec_name']) {
+                                                        case 'NONE':
+                                                                $thisfile_audio['codec']    = 'Pulse Code Modulation (PCM)';
+                                                                $thisfile_audio['lossless'] = true;
+                                                                break;
+
+                                                        case '':
+                                                                switch ($thisfile_riff_audio['codec_fourcc']) {
+                                                                        // http://developer.apple.com/qa/snd/snd07.html
+                                                                        case 'sowt':
+                                                                                $thisfile_riff_audio['codec_name'] = 'Two\'s Compliment Little-Endian PCM';
+                                                                                $thisfile_audio['lossless'] = true;
+                                                                                break;
+
+                                                                        case 'twos':
+                                                                                $thisfile_riff_audio['codec_name'] = 'Two\'s Compliment Big-Endian PCM';
+                                                                                $thisfile_audio['lossless'] = true;
+                                                                                break;
+
+                                                                        default:
+                                                                                break;
+                                                                }
+                                                                break;
+
+                                                        default:
+                                                                $thisfile_audio['codec']    = $thisfile_riff_audio['codec_name'];
+                                                                $thisfile_audio['lossless'] = false;
+                                                                break;
+                                                }
+                                        }
+
+                                        $thisfile_audio['channels']        = $thisfile_riff_audio['channels'];
+                                        if ($thisfile_riff_audio['bits_per_sample'] > 0) {
+                                                $thisfile_audio['bits_per_sample'] = $thisfile_riff_audio['bits_per_sample'];
+                                        }
+                                        $thisfile_audio['sample_rate']     = $thisfile_riff_audio['sample_rate'];
+                                        if ($thisfile_audio['sample_rate'] == 0) {
+                                                $info['error'][] = 'Corrupted AIFF file: sample_rate == zero';
+                                                return false;
+                                        }
+                                        $info['playtime_seconds'] = $thisfile_riff_audio['total_samples'] / $thisfile_audio['sample_rate'];
+                                }
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['COMT'])) {
+                                        $offset = 0;
+                                        $CommentCount                                   = getid3_lib::BigEndian2Int(substr($thisfile_riff[$RIFFsubtype]['COMT'][0]['data'], $offset, 2), false);
+                                        $offset += 2;
+                                        for ($i = 0; $i < $CommentCount; $i++) {
+                                                $info['comments_raw'][$i]['timestamp']      = getid3_lib::BigEndian2Int(substr($thisfile_riff[$RIFFsubtype]['COMT'][0]['data'], $offset, 4), false);
+                                                $offset += 4;
+                                                $info['comments_raw'][$i]['marker_id']      = getid3_lib::BigEndian2Int(substr($thisfile_riff[$RIFFsubtype]['COMT'][0]['data'], $offset, 2), true);
+                                                $offset += 2;
+                                                $CommentLength                              = getid3_lib::BigEndian2Int(substr($thisfile_riff[$RIFFsubtype]['COMT'][0]['data'], $offset, 2), false);
+                                                $offset += 2;
+                                                $info['comments_raw'][$i]['comment']        =                           substr($thisfile_riff[$RIFFsubtype]['COMT'][0]['data'], $offset, $CommentLength);
+                                                $offset += $CommentLength;
+
+                                                $info['comments_raw'][$i]['timestamp_unix'] = getid3_lib::DateMac2Unix($info['comments_raw'][$i]['timestamp']);
+                                                $thisfile_riff['comments']['comment'][] = $info['comments_raw'][$i]['comment'];
+                                        }
+                                }
+
+                                $CommentsChunkNames = array('NAME'=>'title', 'author'=>'artist', '(c) '=>'copyright', 'ANNO'=>'comment');
+                                foreach ($CommentsChunkNames as $key => $value) {
+                                        if (isset($thisfile_riff[$RIFFsubtype][$key][0]['data'])) {
+                                                $thisfile_riff['comments'][$value][] = $thisfile_riff[$RIFFsubtype][$key][0]['data'];
+                                        }
+                                }
+/*
+                                if (isset($thisfile_riff[$RIFFsubtype]['ID3 '])) {
+                                        getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.tag.id3v2.php', __FILE__, true);
+                                        $getid3_temp = new getID3();
+                                        $getid3_temp->openfile($this->getid3->filename);
+                                        $getid3_id3v2 = new getid3_id3v2($getid3_temp);
+                                        $getid3_id3v2->StartingOffset = $thisfile_riff[$RIFFsubtype]['ID3 '][0]['offset'] + 8;
+                                        if ($thisfile_riff[$RIFFsubtype]['ID3 '][0]['valid'] = $getid3_id3v2->Analyze()) {
+                                                $info['id3v2'] = $getid3_temp->info['id3v2'];
+                                        }
+                                        unset($getid3_temp, $getid3_id3v2);
+                                }
+*/
+                                break;
+
+                        case '8SVX':
+                                $thisfile_audio['bitrate_mode']    = 'cbr';
+                                $thisfile_audio_dataformat         = '8svx';
+                                $thisfile_audio['bits_per_sample'] = 8;
+                                $thisfile_audio['channels']        = 1; // overridden below, if need be
+                                $info['mime_type']                = 'audio/x-aiff';
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['BODY'][0]['offset'])) {
+                                        $info['avdataoffset'] = $thisfile_riff[$RIFFsubtype]['BODY'][0]['offset'] + 8;
+                                        $info['avdataend']    = $info['avdataoffset'] + $thisfile_riff[$RIFFsubtype]['BODY'][0]['size'];
+                                        if ($info['avdataend'] > $info['filesize']) {
+                                                $info['warning'][] = 'Probable truncated AIFF file: expecting '.$thisfile_riff[$RIFFsubtype]['BODY'][0]['size'].' bytes of audio data, only '.($info['filesize'] - $info['avdataoffset']).' bytes found';
+                                        }
+                                }
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['VHDR'][0]['offset'])) {
+                                        // shortcut
+                                        $thisfile_riff_RIFFsubtype_VHDR_0 = &$thisfile_riff[$RIFFsubtype]['VHDR'][0];
+
+                                        $thisfile_riff_RIFFsubtype_VHDR_0['oneShotHiSamples']  =   getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_VHDR_0['data'],  0, 4));
+                                        $thisfile_riff_RIFFsubtype_VHDR_0['repeatHiSamples']   =   getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_VHDR_0['data'],  4, 4));
+                                        $thisfile_riff_RIFFsubtype_VHDR_0['samplesPerHiCycle'] =   getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_VHDR_0['data'],  8, 4));
+                                        $thisfile_riff_RIFFsubtype_VHDR_0['samplesPerSec']     =   getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_VHDR_0['data'], 12, 2));
+                                        $thisfile_riff_RIFFsubtype_VHDR_0['ctOctave']          =   getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_VHDR_0['data'], 14, 1));
+                                        $thisfile_riff_RIFFsubtype_VHDR_0['sCompression']      =   getid3_lib::BigEndian2Int(substr($thisfile_riff_RIFFsubtype_VHDR_0['data'], 15, 1));
+                                        $thisfile_riff_RIFFsubtype_VHDR_0['Volume']            = getid3_lib::FixedPoint16_16(substr($thisfile_riff_RIFFsubtype_VHDR_0['data'], 16, 4));
+
+                                        $thisfile_audio['sample_rate'] = $thisfile_riff_RIFFsubtype_VHDR_0['samplesPerSec'];
+
+                                        switch ($thisfile_riff_RIFFsubtype_VHDR_0['sCompression']) {
+                                                case 0:
+                                                        $thisfile_audio['codec']    = 'Pulse Code Modulation (PCM)';
+                                                        $thisfile_audio['lossless'] = true;
+                                                        $ActualBitsPerSample        = 8;
+                                                        break;
+
+                                                case 1:
+                                                        $thisfile_audio['codec']    = 'Fibonacci-delta encoding';
+                                                        $thisfile_audio['lossless'] = false;
+                                                        $ActualBitsPerSample        = 4;
+                                                        break;
+
+                                                default:
+                                                        $info['warning'][] = 'Unexpected sCompression value in 8SVX.VHDR chunk - expecting 0 or 1, found "'.sCompression.'"';
+                                                        break;
+                                        }
+                                }
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['CHAN'][0]['data'])) {
+                                        $ChannelsIndex = getid3_lib::BigEndian2Int(substr($thisfile_riff[$RIFFsubtype]['CHAN'][0]['data'], 0, 4));
+                                        switch ($ChannelsIndex) {
+                                                case 6: // Stereo
+                                                        $thisfile_audio['channels'] = 2;
+                                                        break;
+
+                                                case 2: // Left channel only
+                                                case 4: // Right channel only
+                                                        $thisfile_audio['channels'] = 1;
+                                                        break;
+
+                                                default:
+                                                        $info['warning'][] = 'Unexpected value in 8SVX.CHAN chunk - expecting 2 or 4 or 6, found "'.$ChannelsIndex.'"';
+                                                        break;
+                                        }
+
+                                }
+
+                                $CommentsChunkNames = array('NAME'=>'title', 'author'=>'artist', '(c) '=>'copyright', 'ANNO'=>'comment');
+                                foreach ($CommentsChunkNames as $key => $value) {
+                                        if (isset($thisfile_riff[$RIFFsubtype][$key][0]['data'])) {
+                                                $thisfile_riff['comments'][$value][] = $thisfile_riff[$RIFFsubtype][$key][0]['data'];
+                                        }
+                                }
+
+                                $thisfile_audio['bitrate'] = $thisfile_audio['sample_rate'] * $ActualBitsPerSample * $thisfile_audio['channels'];
+                                if (!empty($thisfile_audio['bitrate'])) {
+                                        $info['playtime_seconds'] = ($info['avdataend'] - $info['avdataoffset']) / ($thisfile_audio['bitrate'] / 8);
+                                }
+                                break;
+
+
+                        case 'CDXA':
+                                $info['mime_type'] = 'video/mpeg';
+                                if (!empty($thisfile_riff['CDXA']['data'][0]['size'])) {
+                                        if (getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio-video.mpeg.php', __FILE__, false)) {
+                                                $getid3_temp = new getID3();
+                                                $getid3_temp->openfile($this->getid3->filename);
+                                                $getid3_mpeg = new getid3_mpeg($getid3_temp);
+                                                $getid3_mpeg->Analyze();
+                                                if (empty($getid3_temp->info['error'])) {
+                                                        $info['audio']   = $getid3_temp->info['audio'];
+                                                        $info['video']   = $getid3_temp->info['video'];
+                                                        $info['mpeg']    = $getid3_temp->info['mpeg'];
+                                                        $info['warning'] = $getid3_temp->info['warning'];
+                                                }
+                                                unset($getid3_temp, $getid3_mpeg);
+                                        }
+                                }
+                                break;
+
+
+                        default:
+                                $info['error'][] = 'Unknown RIFF type: expecting one of (WAVE|RMP3|AVI |CDDA|AIFF|AIFC|8SVX|CDXA), found "'.$RIFFsubtype.'" instead';
+                                unset($info['fileformat']);
+                                break;
+                }
+
+                switch ($RIFFsubtype) {
+                        case 'WAVE':
+                        case 'AIFF':
+                        case 'AIFC':
+                                $ID3v2_key_good = 'id3 ';
+                                $ID3v2_keys_bad = array('ID3 ', 'tag ');
+                                foreach ($ID3v2_keys_bad as $ID3v2_key_bad) {
+                                        if (isset($thisfile_riff[$RIFFsubtype][$ID3v2_key_bad]) && !array_key_exists($ID3v2_key_good, $thisfile_riff[$RIFFsubtype])) {
+                                                $thisfile_riff[$RIFFsubtype][$ID3v2_key_good] = $thisfile_riff[$RIFFsubtype][$ID3v2_key_bad];
+                                                $info['warning'][] = 'mapping "'.$ID3v2_key_bad.'" chunk to "'.$ID3v2_key_good.'"';
+                                        }
+                                }
+
+                                if (isset($thisfile_riff[$RIFFsubtype]['id3 '])) {
+                                        getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.tag.id3v2.php', __FILE__, true);
+                                        $getid3_temp = new getID3();
+                                        $getid3_temp->openfile($this->getid3->filename);
+                                        $getid3_id3v2 = new getid3_id3v2($getid3_temp);
+                                        $getid3_id3v2->StartingOffset = $thisfile_riff[$RIFFsubtype]['id3 '][0]['offset'] + 8;
+                                        if ($thisfile_riff[$RIFFsubtype]['id3 '][0]['valid'] = $getid3_id3v2->Analyze()) {
+                                                $info['id3v2'] = $getid3_temp->info['id3v2'];
+                                        }
+                                        unset($getid3_temp, $getid3_id3v2);
+                                }
+                                break;
+                }
+
+                if (isset($thisfile_riff_WAVE['DISP']) && is_array($thisfile_riff_WAVE['DISP'])) {
+                        $thisfile_riff['comments']['title'][] = trim(substr($thisfile_riff_WAVE['DISP'][count($thisfile_riff_WAVE['DISP']) - 1]['data'], 4));
+                }
+                if (isset($thisfile_riff_WAVE['INFO']) && is_array($thisfile_riff_WAVE['INFO'])) {
+                        self::parseComments($thisfile_riff_WAVE['INFO'], $thisfile_riff['comments']);
+                }
+                if (isset($thisfile_riff['AVI ']['INFO']) && is_array($thisfile_riff['AVI ']['INFO'])) {
+                        self::parseComments($thisfile_riff['AVI ']['INFO'], $thisfile_riff['comments']);
+                }
+
+                if (empty($thisfile_audio['encoder']) && !empty($info['mpeg']['audio']['LAME']['short_version'])) {
+                        $thisfile_audio['encoder'] = $info['mpeg']['audio']['LAME']['short_version'];
+                }
+
+                if (!isset($info['playtime_seconds'])) {
+                        $info['playtime_seconds'] = 0;
+                }
+                if (isset($thisfile_riff_raw['strh'][0]['dwLength']) && isset($thisfile_riff_raw['avih']['dwMicroSecPerFrame'])) {
+                        // needed for >2GB AVIs where 'avih' chunk only lists number of frames in that chunk, not entire movie
+                        $info['playtime_seconds'] = $thisfile_riff_raw['strh'][0]['dwLength'] * ($thisfile_riff_raw['avih']['dwMicroSecPerFrame'] / 1000000);
+                } elseif (isset($thisfile_riff_raw['avih']['dwTotalFrames']) && isset($thisfile_riff_raw['avih']['dwMicroSecPerFrame'])) {
+                        $info['playtime_seconds'] = $thisfile_riff_raw['avih']['dwTotalFrames'] * ($thisfile_riff_raw['avih']['dwMicroSecPerFrame'] / 1000000);
+                }
+
+                if ($info['playtime_seconds'] > 0) {
+                        if (isset($thisfile_riff_audio) && isset($thisfile_riff_video)) {
+
+                                if (!isset($info['bitrate'])) {
+                                        $info['bitrate'] = ((($info['avdataend'] - $info['avdataoffset']) / $info['playtime_seconds']) * 8);
+                                }
+
+                        } elseif (isset($thisfile_riff_audio) && !isset($thisfile_riff_video)) {
+
+                                if (!isset($thisfile_audio['bitrate'])) {
+                                        $thisfile_audio['bitrate'] = ((($info['avdataend'] - $info['avdataoffset']) / $info['playtime_seconds']) * 8);
+                                }
+
+                        } elseif (!isset($thisfile_riff_audio) && isset($thisfile_riff_video)) {
+
+                                if (!isset($thisfile_video['bitrate'])) {
+                                        $thisfile_video['bitrate'] = ((($info['avdataend'] - $info['avdataoffset']) / $info['playtime_seconds']) * 8);
+                                }
+
+                        }
+                }
+
+
+                if (isset($thisfile_riff_video) && isset($thisfile_audio['bitrate']) && ($thisfile_audio['bitrate'] > 0) && ($info['playtime_seconds'] > 0)) {
+
+                        $info['bitrate'] = ((($info['avdataend'] - $info['avdataoffset']) / $info['playtime_seconds']) * 8);
+                        $thisfile_audio['bitrate'] = 0;
+                        $thisfile_video['bitrate'] = $info['bitrate'];
+                        foreach ($thisfile_riff_audio as $channelnumber => $audioinfoarray) {
+                                $thisfile_video['bitrate'] -= $audioinfoarray['bitrate'];
+                                $thisfile_audio['bitrate'] += $audioinfoarray['bitrate'];
+                        }
+                        if ($thisfile_video['bitrate'] <= 0) {
+                                unset($thisfile_video['bitrate']);
+                        }
+                        if ($thisfile_audio['bitrate'] <= 0) {
+                                unset($thisfile_audio['bitrate']);
+                        }
+                }
+
+                if (isset($info['mpeg']['audio'])) {
+                        $thisfile_audio_dataformat      = 'mp'.$info['mpeg']['audio']['layer'];
+                        $thisfile_audio['sample_rate']  = $info['mpeg']['audio']['sample_rate'];
+                        $thisfile_audio['channels']     = $info['mpeg']['audio']['channels'];
+                        $thisfile_audio['bitrate']      = $info['mpeg']['audio']['bitrate'];
+                        $thisfile_audio['bitrate_mode'] = strtolower($info['mpeg']['audio']['bitrate_mode']);
+                        if (!empty($info['mpeg']['audio']['codec'])) {
+                                $thisfile_audio['codec'] = $info['mpeg']['audio']['codec'].' '.$thisfile_audio['codec'];
+                        }
+                        if (!empty($thisfile_audio['streams'])) {
+                                foreach ($thisfile_audio['streams'] as $streamnumber => $streamdata) {
+                                        if ($streamdata['dataformat'] == $thisfile_audio_dataformat) {
+                                                $thisfile_audio['streams'][$streamnumber]['sample_rate']  = $thisfile_audio['sample_rate'];
+                                                $thisfile_audio['streams'][$streamnumber]['channels']     = $thisfile_audio['channels'];
+                                                $thisfile_audio['streams'][$streamnumber]['bitrate']      = $thisfile_audio['bitrate'];
+                                                $thisfile_audio['streams'][$streamnumber]['bitrate_mode'] = $thisfile_audio['bitrate_mode'];
+                                                $thisfile_audio['streams'][$streamnumber]['codec']        = $thisfile_audio['codec'];
+                                        }
+                                }
+                        }
+                        $getid3_mp3 = new getid3_mp3($this->getid3);
+                        $thisfile_audio['encoder_options'] = $getid3_mp3->GuessEncoderOptions();
+                        unset($getid3_mp3);
+                }
+
+
+                if (!empty($thisfile_riff_raw['fmt ']['wBitsPerSample']) && ($thisfile_riff_raw['fmt ']['wBitsPerSample'] > 0)) {
+                        switch ($thisfile_audio_dataformat) {
+                                case 'ac3':
+                                        // ignore bits_per_sample
+                                        break;
+
+                                default:
+                                        $thisfile_audio['bits_per_sample'] = $thisfile_riff_raw['fmt ']['wBitsPerSample'];
+                                        break;
+                        }
+                }
+
+
+                if (empty($thisfile_riff_raw)) {
+                        unset($thisfile_riff['raw']);
+                }
+                if (empty($thisfile_riff_audio)) {
+                        unset($thisfile_riff['audio']);
+                }
+                if (empty($thisfile_riff_video)) {
+                        unset($thisfile_riff['video']);
+                }
+
+                return true;
+        }
+
+        public function ParseRIFF($startoffset, $maxoffset) {
+                $info = &$this->getid3->info;
+
+                $RIFFchunk = false;
+                $FoundAllChunksWeNeed = false;
+
+                try {
+                        $this->fseek($startoffset);
+                        $maxoffset = min($maxoffset, $info['avdataend']);
+                        while ($this->ftell() < $maxoffset) {
+                                $chunknamesize = $this->fread(8);
+                                //$chunkname =                          substr($chunknamesize, 0, 4);
+                                $chunkname = str_replace("\x00", '_', substr($chunknamesize, 0, 4));  // note: chunk names of 4 null bytes do appear to be legal (has been observed inside INFO and PRMI chunks, for example), but makes traversing array keys more difficult
+                                $chunksize =  $this->EitherEndian2Int(substr($chunknamesize, 4, 4));
+                                //if (strlen(trim($chunkname, "\x00")) < 4) {
+                                if (strlen($chunkname) < 4) {
+                                        $this->error('Expecting chunk name at offset '.($this->ftell() - 8).' but found nothing. Aborting RIFF parsing.');
+                                        break;
+                                }
+                                if (($chunksize == 0) && ($chunkname != 'JUNK')) {
+                                        $this->warning('Chunk ('.$chunkname.') size at offset '.($this->ftell() - 4).' is zero. Aborting RIFF parsing.');
+                                        break;
+                                }
+                                if (($chunksize % 2) != 0) {
+                                        // all structures are packed on word boundaries
+                                        $chunksize++;
+                                }
+
+                                switch ($chunkname) {
+                                        case 'LIST':
+                                                $listname = $this->fread(4);
+                                                if (preg_match('#^(movi|rec )$#i', $listname)) {
+                                                        $RIFFchunk[$listname]['offset'] = $this->ftell() - 4;
+                                                        $RIFFchunk[$listname]['size']   = $chunksize;
+
+                                                        if (!$FoundAllChunksWeNeed) {
+                                                                $WhereWeWere      = $this->ftell();
+                                                                $AudioChunkHeader = $this->fread(12);
+                                                                $AudioChunkStreamNum  =                              substr($AudioChunkHeader, 0, 2);
+                                                                $AudioChunkStreamType =                              substr($AudioChunkHeader, 2, 2);
+                                                                $AudioChunkSize       = getid3_lib::LittleEndian2Int(substr($AudioChunkHeader, 4, 4));
+
+                                                                if ($AudioChunkStreamType == 'wb') {
+                                                                        $FirstFourBytes = substr($AudioChunkHeader, 8, 4);
+                                                                        if (preg_match('/^\xFF[\xE2-\xE7\xF2-\xF7\xFA-\xFF][\x00-\xEB]/s', $FirstFourBytes)) {
+                                                                                // MP3
+                                                                                if (getid3_mp3::MPEGaudioHeaderBytesValid($FirstFourBytes)) {
+                                                                                        $getid3_temp = new getID3();
+                                                                                        $getid3_temp->openfile($this->getid3->filename);
+                                                                                        $getid3_temp->info['avdataoffset'] = $this->ftell() - 4;
+                                                                                        $getid3_temp->info['avdataend']    = $this->ftell() + $AudioChunkSize;
+                                                                                        $getid3_mp3 = new getid3_mp3($getid3_temp);
+                                                                                        $getid3_mp3->getOnlyMPEGaudioInfo($getid3_temp->info['avdataoffset'], false);
+                                                                                        if (isset($getid3_temp->info['mpeg']['audio'])) {
+                                                                                                $info['mpeg']['audio']         = $getid3_temp->info['mpeg']['audio'];
+                                                                                                $info['audio']                 = $getid3_temp->info['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'];
+                                                                                        }
+                                                                                        unset($getid3_temp, $getid3_mp3);
+                                                                                }
+
+                                                                        } elseif (strpos($FirstFourBytes, getid3_ac3::syncword) === 0) {
+
+                                                                                // AC3
+                                                                                $getid3_temp = new getID3();
+                                                                                $getid3_temp->openfile($this->getid3->filename);
+                                                                                $getid3_temp->info['avdataoffset'] = $this->ftell() - 4;
+                                                                                $getid3_temp->info['avdataend']    = $this->ftell() + $AudioChunkSize;
+                                                                                $getid3_ac3 = new getid3_ac3($getid3_temp);
+                                                                                $getid3_ac3->Analyze();
+                                                                                if (empty($getid3_temp->info['error'])) {
+                                                                                        $info['audio']   = $getid3_temp->info['audio'];
+                                                                                        $info['ac3']     = $getid3_temp->info['ac3'];
+                                                                                        if (!empty($getid3_temp->info['warning'])) {
+                                                                                                foreach ($getid3_temp->info['warning'] as $key => $value) {
+                                                                                                        $info['warning'][] = $value;
+                                                                                                }
+                                                                                        }
+                                                                                }
+                                                                                unset($getid3_temp, $getid3_ac3);
+                                                                        }
+                                                                }
+                                                                $FoundAllChunksWeNeed = true;
+                                                                $this->fseek($WhereWeWere);
+                                                        }
+                                                        $this->fseek($chunksize - 4, SEEK_CUR);
+
+                                                } else {
+
+                                                        if (!isset($RIFFchunk[$listname])) {
+                                                                $RIFFchunk[$listname] = array();
+                                                        }
+                                                        $LISTchunkParent    = $listname;
+                                                        $LISTchunkMaxOffset = $this->ftell() - 4 + $chunksize;
+                                                        if ($parsedChunk = $this->ParseRIFF($this->ftell(), $LISTchunkMaxOffset)) {
+                                                                $RIFFchunk[$listname] = array_merge_recursive($RIFFchunk[$listname], $parsedChunk);
+                                                        }
+
+                                                }
+                                                break;
+
+                                        default:
+                                                if (preg_match('#^[0-9]{2}(wb|pc|dc|db)$#', $chunkname)) {
+                                                        $this->fseek($chunksize, SEEK_CUR);
+                                                        break;
+                                                }
+                                                $thisindex = 0;
+                                                if (isset($RIFFchunk[$chunkname]) && is_array($RIFFchunk[$chunkname])) {
+                                                        $thisindex = count($RIFFchunk[$chunkname]);
+                                                }
+                                                $RIFFchunk[$chunkname][$thisindex]['offset'] = $this->ftell() - 8;
+                                                $RIFFchunk[$chunkname][$thisindex]['size']   = $chunksize;
+                                                switch ($chunkname) {
+                                                        case 'data':
+                                                                $info['avdataoffset'] = $this->ftell();
+                                                                $info['avdataend']    = $info['avdataoffset'] + $chunksize;
+
+                                                                $testData = $this->fread(36);
+                                                                if ($testData === '') {
+                                                                        break;
+                                                                }
+                                                                if (preg_match('/^\xFF[\xE2-\xE7\xF2-\xF7\xFA-\xFF][\x00-\xEB]/s', substr($testData, 0, 4))) {
+
+                                                                        // Probably is MP3 data
+                                                                        if (getid3_mp3::MPEGaudioHeaderBytesValid(substr($testData, 0, 4))) {
+                                                                                $getid3_temp = new getID3();
+                                                                                $getid3_temp->openfile($this->getid3->filename);
+                                                                                $getid3_temp->info['avdataoffset'] = $info['avdataoffset'];
+                                                                                $getid3_temp->info['avdataend']    = $info['avdataend'];
+                                                                                $getid3_mp3 = new getid3_mp3($getid3_temp);
+                                                                                $getid3_mp3->getOnlyMPEGaudioInfo($info['avdataoffset'], false);
+                                                                                if (empty($getid3_temp->info['error'])) {
+                                                                                        $info['audio'] = $getid3_temp->info['audio'];
+                                                                                        $info['mpeg']  = $getid3_temp->info['mpeg'];
+                                                                                }
+                                                                                unset($getid3_temp, $getid3_mp3);
+                                                                        }
+
+                                                                } elseif (($isRegularAC3 = (substr($testData, 0, 2) == getid3_ac3::syncword)) || substr($testData, 8, 2) == strrev(getid3_ac3::syncword)) {
+
+                                                                        // This is probably AC-3 data
+                                                                        $getid3_temp = new getID3();
+                                                                        if ($isRegularAC3) {
+                                                                                $getid3_temp->openfile($this->getid3->filename);
+                                                                                $getid3_temp->info['avdataoffset'] = $info['avdataoffset'];
+                                                                                $getid3_temp->info['avdataend']    = $info['avdataend'];
+                                                                        }
+                                                                        $getid3_ac3 = new getid3_ac3($getid3_temp);
+                                                                        if ($isRegularAC3) {
+                                                                                $getid3_ac3->Analyze();
+                                                                        } else {
+                                                                                // Dolby Digital WAV
+                                                                                // AC-3 content, but not encoded in same format as normal AC-3 file
+                                                                                // For one thing, byte order is swapped
+                                                                                $ac3_data = '';
+                                                                                for ($i = 0; $i < 28; $i += 2) {
+                                                                                        $ac3_data .= substr($testData, 8 + $i + 1, 1);
+                                                                                        $ac3_data .= substr($testData, 8 + $i + 0, 1);
+                                                                                }
+                                                                                $getid3_ac3->AnalyzeString($ac3_data);
+                                                                        }
+
+                                                                        if (empty($getid3_temp->info['error'])) {
+                                                                                $info['audio'] = $getid3_temp->info['audio'];
+                                                                                $info['ac3']   = $getid3_temp->info['ac3'];
+                                                                                if (!empty($getid3_temp->info['warning'])) {
+                                                                                        foreach ($getid3_temp->info['warning'] as $newerror) {
+                                                                                                $this->warning('getid3_ac3() says: ['.$newerror.']');
+                                                                                        }
+                                                                                }
+                                                                        }
+                                                                        unset($getid3_temp, $getid3_ac3);
+
+                                                                } elseif (preg_match('/^('.implode('|', array_map('preg_quote', getid3_dts::$syncwords)).')/', $testData)) {
+
+                                                                        // This is probably DTS data
+                                                                        $getid3_temp = new getID3();
+                                                                        $getid3_temp->openfile($this->getid3->filename);
+                                                                        $getid3_temp->info['avdataoffset'] = $info['avdataoffset'];
+                                                                        $getid3_dts = new getid3_dts($getid3_temp);
+                                                                        $getid3_dts->Analyze();
+                                                                        if (empty($getid3_temp->info['error'])) {
+                                                                                $info['audio']            = $getid3_temp->info['audio'];
+                                                                                $info['dts']              = $getid3_temp->info['dts'];
+                                                                                $info['playtime_seconds'] = $getid3_temp->info['playtime_seconds']; // may not match RIFF calculations since DTS-WAV often used 14/16 bit-word packing
+                                                                                if (!empty($getid3_temp->info['warning'])) {
+                                                                                        foreach ($getid3_temp->info['warning'] as $newerror) {
+                                                                                                $this->warning('getid3_dts() says: ['.$newerror.']');
+                                                                                        }
+                                                                                }
+                                                                        }
+
+                                                                        unset($getid3_temp, $getid3_dts);
+
+                                                                } elseif (substr($testData, 0, 4) == 'wvpk') {
+
+                                                                        // This is WavPack data
+                                                                        $info['wavpack']['offset'] = $info['avdataoffset'];
+                                                                        $info['wavpack']['size']   = getid3_lib::LittleEndian2Int(substr($testData, 4, 4));
+                                                                        $this->parseWavPackHeader(substr($testData, 8, 28));
+
+                                                                } else {
+                                                                        // This is some other kind of data (quite possibly just PCM)
+                                                                        // do nothing special, just skip it
+                                                                }
+                                                                $nextoffset = $info['avdataend'];
+                                                                $this->fseek($nextoffset);
+                                                                break;
+
+                                                        case 'iXML':
+                                                        case 'bext':
+                                                        case 'cart':
+                                                        case 'fmt ':
+                                                        case 'strh':
+                                                        case 'strf':
+                                                        case 'indx':
+                                                        case 'MEXT':
+                                                        case 'DISP':
+                                                                // always read data in
+                                                        case 'JUNK':
+                                                                // should be: never read data in
+                                                                // but some programs write their version strings in a JUNK chunk (e.g. VirtualDub, AVIdemux, etc)
+                                                                if ($chunksize < 1048576) {
+                                                                        if ($chunksize > 0) {
+                                                                                $RIFFchunk[$chunkname][$thisindex]['data'] = $this->fread($chunksize);
+                                                                                if ($chunkname == 'JUNK') {
+                                                                                        if (preg_match('#^([\\x20-\\x7F]+)#', $RIFFchunk[$chunkname][$thisindex]['data'], $matches)) {
+                                                                                                // only keep text characters [chr(32)-chr(127)]
+                                                                                                $info['riff']['comments']['junk'][] = trim($matches[1]);
+                                                                                        }
+                                                                                        // but if nothing there, ignore
+                                                                                        // remove the key in either case
+                                                                                        unset($RIFFchunk[$chunkname][$thisindex]['data']);
+                                                                                }
+                                                                        }
+                                                                } else {
+                                                                        $this->warning('Chunk "'.$chunkname.'" at offset '.$this->ftell().' is unexpectedly larger than 1MB (claims to be '.number_format($chunksize).' bytes), skipping data');
+                                                                        $this->fseek($chunksize, SEEK_CUR);
+                                                                }
+                                                                break;
+
+                                                        //case 'IDVX':
+                                                        //      $info['divxtag']['comments'] = self::ParseDIVXTAG($this->fread($chunksize));
+                                                        //      break;
+
+                                                        default:
+                                                                if (!empty($LISTchunkParent) && (($RIFFchunk[$chunkname][$thisindex]['offset'] + $RIFFchunk[$chunkname][$thisindex]['size']) <= $LISTchunkMaxOffset)) {
+                                                                        $RIFFchunk[$LISTchunkParent][$chunkname][$thisindex]['offset'] = $RIFFchunk[$chunkname][$thisindex]['offset'];
+                                                                        $RIFFchunk[$LISTchunkParent][$chunkname][$thisindex]['size']   = $RIFFchunk[$chunkname][$thisindex]['size'];
+                                                                        unset($RIFFchunk[$chunkname][$thisindex]['offset']);
+                                                                        unset($RIFFchunk[$chunkname][$thisindex]['size']);
+                                                                        if (isset($RIFFchunk[$chunkname][$thisindex]) && empty($RIFFchunk[$chunkname][$thisindex])) {
+                                                                                unset($RIFFchunk[$chunkname][$thisindex]);
+                                                                        }
+                                                                        if (isset($RIFFchunk[$chunkname]) && empty($RIFFchunk[$chunkname])) {
+                                                                                unset($RIFFchunk[$chunkname]);
+                                                                        }
+                                                                        $RIFFchunk[$LISTchunkParent][$chunkname][$thisindex]['data'] = $this->fread($chunksize);
+                                                                } elseif ($chunksize < 2048) {
+                                                                        // only read data in if smaller than 2kB
+                                                                        $RIFFchunk[$chunkname][$thisindex]['data'] = $this->fread($chunksize);
+                                                                } else {
+                                                                        $this->fseek($chunksize, SEEK_CUR);
+                                                                }
+                                                                break;
+                                                }
+                                                break;
+                                }
+                        }
+
+                } catch (getid3_exception $e) {
+                        if ($e->getCode() == 10) {
+                                $this->warning('RIFF parser: '.$e->getMessage());
+                        } else {
+                                throw $e;
+                        }
+                }
+
+                return $RIFFchunk;
+        }
+
+        public function ParseRIFFdata(&$RIFFdata) {
+                $info = &$this->getid3->info;
+                if ($RIFFdata) {
+                        $tempfile = tempnam(GETID3_TEMP_DIR, 'getID3');
+                        $fp_temp  = fopen($tempfile, 'wb');
+                        $RIFFdataLength = strlen($RIFFdata);
+                        $NewLengthString = getid3_lib::LittleEndian2String($RIFFdataLength, 4);
+                        for ($i = 0; $i < 4; $i++) {
+                                $RIFFdata[($i + 4)] = $NewLengthString[$i];
+                        }
+                        fwrite($fp_temp, $RIFFdata);
+                        fclose($fp_temp);
+
+                        $getid3_temp = new getID3();
+                        $getid3_temp->openfile($tempfile);
+                        $getid3_temp->info['filesize']     = $RIFFdataLength;
+                        $getid3_temp->info['filenamepath'] = $info['filenamepath'];
+                        $getid3_temp->info['tags']         = $info['tags'];
+                        $getid3_temp->info['warning']      = $info['warning'];
+                        $getid3_temp->info['error']        = $info['error'];
+                        $getid3_temp->info['comments']     = $info['comments'];
+                        $getid3_temp->info['audio']        = (isset($info['audio']) ? $info['audio'] : array());
+                        $getid3_temp->info['video']        = (isset($info['video']) ? $info['video'] : array());
+                        $getid3_riff = new getid3_riff($getid3_temp);
+                        $getid3_riff->Analyze();
+
+                        $info['riff']     = $getid3_temp->info['riff'];
+                        $info['warning']  = $getid3_temp->info['warning'];
+                        $info['error']    = $getid3_temp->info['error'];
+                        $info['tags']     = $getid3_temp->info['tags'];
+                        $info['comments'] = $getid3_temp->info['comments'];
+                        unset($getid3_riff, $getid3_temp);
+                        unlink($tempfile);
+                }
+                return false;
+        }
+
+        public static function parseComments(&$RIFFinfoArray, &$CommentsTargetArray) {
+                $RIFFinfoKeyLookup = 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',
+                        '____'=>'comment',
+                );
+                foreach ($RIFFinfoKeyLookup as $key => $value) {
+                        if (isset($RIFFinfoArray[$key])) {
+                                foreach ($RIFFinfoArray[$key] as $commentid => $commentdata) {
+                                        if (trim($commentdata['data']) != '') {
+                                                if (isset($CommentsTargetArray[$value])) {
+                                                        $CommentsTargetArray[$value][] =     trim($commentdata['data']);
+                                                } else {
+                                                        $CommentsTargetArray[$value] = array(trim($commentdata['data']));
+                                                }
+                                        }
+                                }
+                        }
+                }
+                return true;
+        }
+
+        public static function parseWAVEFORMATex($WaveFormatExData) {
+                // shortcut
+                $WaveFormatEx['raw'] = array();
+                $WaveFormatEx_raw    = &$WaveFormatEx['raw'];
+
+                $WaveFormatEx_raw['wFormatTag']      = substr($WaveFormatExData,  0, 2);
+                $WaveFormatEx_raw['nChannels']       = substr($WaveFormatExData,  2, 2);
+                $WaveFormatEx_raw['nSamplesPerSec']  = substr($WaveFormatExData,  4, 4);
+                $WaveFormatEx_raw['nAvgBytesPerSec'] = substr($WaveFormatExData,  8, 4);
+                $WaveFormatEx_raw['nBlockAlign']     = substr($WaveFormatExData, 12, 2);
+                $WaveFormatEx_raw['wBitsPerSample']  = substr($WaveFormatExData, 14, 2);
+                if (strlen($WaveFormatExData) > 16) {
+                        $WaveFormatEx_raw['cbSize']      = substr($WaveFormatExData, 16, 2);
+                }
+                $WaveFormatEx_raw = array_map('getid3_lib::LittleEndian2Int', $WaveFormatEx_raw);
+
+                $WaveFormatEx['codec']           = self::wFormatTagLookup($WaveFormatEx_raw['wFormatTag']);
+                $WaveFormatEx['channels']        = $WaveFormatEx_raw['nChannels'];
+                $WaveFormatEx['sample_rate']     = $WaveFormatEx_raw['nSamplesPerSec'];
+                $WaveFormatEx['bitrate']         = $WaveFormatEx_raw['nAvgBytesPerSec'] * 8;
+                $WaveFormatEx['bits_per_sample'] = $WaveFormatEx_raw['wBitsPerSample'];
+
+                return $WaveFormatEx;
+        }
+
+        public function parseWavPackHeader($WavPackChunkData) {
+                // 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;
+
+                // shortcut
+                $info = &$this->getid3->info;
+                $info['wavpack']  = array();
+                $thisfile_wavpack = &$info['wavpack'];
+
+                $thisfile_wavpack['version']           = getid3_lib::LittleEndian2Int(substr($WavPackChunkData,  0, 2));
+                if ($thisfile_wavpack['version'] >= 2) {
+                        $thisfile_wavpack['bits']          = getid3_lib::LittleEndian2Int(substr($WavPackChunkData,  2, 2));
+                }
+                if ($thisfile_wavpack['version'] >= 3) {
+                        $thisfile_wavpack['flags_raw']     = getid3_lib::LittleEndian2Int(substr($WavPackChunkData,  4, 2));
+                        $thisfile_wavpack['shift']         = getid3_lib::LittleEndian2Int(substr($WavPackChunkData,  6, 2));
+                        $thisfile_wavpack['total_samples'] = getid3_lib::LittleEndian2Int(substr($WavPackChunkData,  8, 4));
+                        $thisfile_wavpack['crc1']          = getid3_lib::LittleEndian2Int(substr($WavPackChunkData, 12, 4));
+                        $thisfile_wavpack['crc2']          = getid3_lib::LittleEndian2Int(substr($WavPackChunkData, 16, 4));
+                        $thisfile_wavpack['extension']     =                              substr($WavPackChunkData, 20, 4);
+                        $thisfile_wavpack['extra_bc']      = getid3_lib::LittleEndian2Int(substr($WavPackChunkData, 24, 1));
+                        for ($i = 0; $i <= 2; $i++) {
+                                $thisfile_wavpack['extras'][]  = getid3_lib::LittleEndian2Int(substr($WavPackChunkData, 25 + $i, 1));
+                        }
+
+                        // shortcut
+                        $thisfile_wavpack['flags'] = array();
+                        $thisfile_wavpack_flags = &$thisfile_wavpack['flags'];
+
+                        $thisfile_wavpack_flags['mono']                 = (bool) ($thisfile_wavpack['flags_raw'] & 0x000001);
+                        $thisfile_wavpack_flags['fast_mode']            = (bool) ($thisfile_wavpack['flags_raw'] & 0x000002);
+                        $thisfile_wavpack_flags['raw_mode']             = (bool) ($thisfile_wavpack['flags_raw'] & 0x000004);
+                        $thisfile_wavpack_flags['calc_noise']           = (bool) ($thisfile_wavpack['flags_raw'] & 0x000008);
+                        $thisfile_wavpack_flags['high_quality']         = (bool) ($thisfile_wavpack['flags_raw'] & 0x000010);
+                        $thisfile_wavpack_flags['3_byte_samples']       = (bool) ($thisfile_wavpack['flags_raw'] & 0x000020);
+                        $thisfile_wavpack_flags['over_20_bits']         = (bool) ($thisfile_wavpack['flags_raw'] & 0x000040);
+                        $thisfile_wavpack_flags['use_wvc']              = (bool) ($thisfile_wavpack['flags_raw'] & 0x000080);
+                        $thisfile_wavpack_flags['noiseshaping']         = (bool) ($thisfile_wavpack['flags_raw'] & 0x000100);
+                        $thisfile_wavpack_flags['very_fast_mode']       = (bool) ($thisfile_wavpack['flags_raw'] & 0x000200);
+                        $thisfile_wavpack_flags['new_high_quality']     = (bool) ($thisfile_wavpack['flags_raw'] & 0x000400);
+                        $thisfile_wavpack_flags['cancel_extreme']       = (bool) ($thisfile_wavpack['flags_raw'] & 0x000800);
+                        $thisfile_wavpack_flags['cross_decorrelation']  = (bool) ($thisfile_wavpack['flags_raw'] & 0x001000);
+                        $thisfile_wavpack_flags['new_decorrelation']    = (bool) ($thisfile_wavpack['flags_raw'] & 0x002000);
+                        $thisfile_wavpack_flags['joint_stereo']         = (bool) ($thisfile_wavpack['flags_raw'] & 0x004000);
+                        $thisfile_wavpack_flags['extra_decorrelation']  = (bool) ($thisfile_wavpack['flags_raw'] & 0x008000);
+                        $thisfile_wavpack_flags['override_noiseshape']  = (bool) ($thisfile_wavpack['flags_raw'] & 0x010000);
+                        $thisfile_wavpack_flags['override_jointstereo'] = (bool) ($thisfile_wavpack['flags_raw'] & 0x020000);
+                        $thisfile_wavpack_flags['copy_source_filetime'] = (bool) ($thisfile_wavpack['flags_raw'] & 0x040000);
+                        $thisfile_wavpack_flags['create_exe']           = (bool) ($thisfile_wavpack['flags_raw'] & 0x080000);
+                }
+
+                return true;
+        }
+
+        public static function ParseBITMAPINFOHEADER($BITMAPINFOHEADER, $littleEndian=true) {
+
+                $parsed['biSize']          = substr($BITMAPINFOHEADER,  0, 4); // number of bytes required by the BITMAPINFOHEADER structure
+                $parsed['biWidth']         = substr($BITMAPINFOHEADER,  4, 4); // width of the bitmap in pixels
+                $parsed['biHeight']        = substr($BITMAPINFOHEADER,  8, 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
+                $parsed['biPlanes']        = substr($BITMAPINFOHEADER, 12, 2); // number of color planes on the target device. In most cases this value must be set to 1
+                $parsed['biBitCount']      = substr($BITMAPINFOHEADER, 14, 2); // Specifies the number of bits per pixels
+                $parsed['biSizeImage']     = substr($BITMAPINFOHEADER, 20, 4); // size of the bitmap data section of the image (the actual pixel data, excluding BITMAPINFOHEADER and RGBQUAD structures)
+                $parsed['biXPelsPerMeter'] = substr($BITMAPINFOHEADER, 24, 4); // horizontal resolution, in pixels per metre, of the target device
+                $parsed['biYPelsPerMeter'] = substr($BITMAPINFOHEADER, 28, 4); // vertical resolution, in pixels per metre, of the target device
+                $parsed['biClrUsed']       = substr($BITMAPINFOHEADER, 32, 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
+                $parsed['biClrImportant']  = substr($BITMAPINFOHEADER, 36, 4); // number of color indices that are considered important for displaying the bitmap. If this value is zero, all colors are important
+                $parsed = array_map('getid3_lib::'.($littleEndian ? 'Little' : 'Big').'Endian2Int', $parsed);
+
+                $parsed['fourcc']          = substr($BITMAPINFOHEADER, 16, 4);  // compression identifier
+
+                return $parsed;
+        }
+
+        public static function ParseDIVXTAG($DIVXTAG, $raw=false) {
+                // structure from "IDivX" source, Form1.frm, by "Greg Frazier of Daemonic Software Group", email: gfrazier@icestorm.net, web: http://dsg.cjb.net/
+                // source available at http://files.divx-digest.com/download/c663efe7ef8ad2e90bf4af4d3ea6188a/on0SWN2r/edit/IDivX.zip
+                // 'Byte Layout:                   '1111111111111111
+                // '32 for Movie - 1               '1111111111111111
+                // '28 for Author - 6              '6666666666666666
+                // '4  for year - 2                '6666666666662222
+                // '3  for genre - 3               '7777777777777777
+                // '48 for Comments - 7            '7777777777777777
+                // '1  for Rating - 4              '7777777777777777
+                // '5  for Future Additions - 0    '333400000DIVXTAG
+                // '128 bytes total
+
+                static $DIVXTAGgenre  = array(
+                         0 => 'Action',
+                         1 => 'Action/Adventure',
+                         2 => 'Adventure',
+                         3 => 'Adult',
+                         4 => 'Anime',
+                         5 => 'Cartoon',
+                         6 => 'Claymation',
+                         7 => 'Comedy',
+                         8 => 'Commercial',
+                         9 => 'Documentary',
+                        10 => 'Drama',
+                        11 => 'Home Video',
+                        12 => 'Horror',
+                        13 => 'Infomercial',
+                        14 => 'Interactive',
+                        15 => 'Mystery',
+                        16 => 'Music Video',
+                        17 => 'Other',
+                        18 => 'Religion',
+                        19 => 'Sci Fi',
+                        20 => 'Thriller',
+                        21 => 'Western',
+                ),
+                $DIVXTAGrating = array(
+                         0 => 'Unrated',
+                         1 => 'G',
+                         2 => 'PG',
+                         3 => 'PG-13',
+                         4 => 'R',
+                         5 => 'NC-17',
+                );
+
+                $parsed['title']     =        trim(substr($DIVXTAG,   0, 32));
+                $parsed['artist']    =        trim(substr($DIVXTAG,  32, 28));
+                $parsed['year']      = intval(trim(substr($DIVXTAG,  60,  4)));
+                $parsed['comment']   =        trim(substr($DIVXTAG,  64, 48));
+                $parsed['genre_id']  = intval(trim(substr($DIVXTAG, 112,  3)));
+                $parsed['rating_id'] =         ord(substr($DIVXTAG, 115,  1));
+                //$parsed['padding'] =             substr($DIVXTAG, 116,  5);  // 5-byte null
+                //$parsed['magic']   =             substr($DIVXTAG, 121,  7);  // "DIVXTAG"
+
+                $parsed['genre']  = (isset($DIVXTAGgenre[$parsed['genre_id']])   ? $DIVXTAGgenre[$parsed['genre_id']]   : $parsed['genre_id']);
+                $parsed['rating'] = (isset($DIVXTAGrating[$parsed['rating_id']]) ? $DIVXTAGrating[$parsed['rating_id']] : $parsed['rating_id']);
+
+                if (!$raw) {
+                        unset($parsed['genre_id'], $parsed['rating_id']);
+                        foreach ($parsed as $key => $value) {
+                                if (!$value === '') {
+                                        unset($parsed['key']);
+                                }
+                        }
+                }
+
+                foreach ($parsed as $tag => $value) {
+                        $parsed[$tag] = array($value);
+                }
+
+                return $parsed;
+        }
+
+        public static function waveSNDMtagLookup($tagshortname) {
+                $begin = __LINE__;
+
+                /** This is not a comment!
+
+                        ©kwd    keywords
+                        ©BPM    bpm
+                        ©trt    tracktitle
+                        ©des    description
+                        ©gen    category
+                        ©fin    featuredinstrument
+                        ©LID    longid
+                        ©bex    bwdescription
+                        ©pub    publisher
+                        ©cdt    cdtitle
+                        ©alb    library
+                        ©com    composer
+
+                */
+
+                return getid3_lib::EmbeddedLookup($tagshortname, $begin, __LINE__, __FILE__, 'riff-sndm');
+        }
+
+        public static function wFormatTagLookup($wFormatTag) {
+
+                $begin = __LINE__;
+
+                /** This is not a comment!
+
+                        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 getid3_lib::EmbeddedLookup('0x'.str_pad(strtoupper(dechex($wFormatTag)), 4, '0', STR_PAD_LEFT), $begin, __LINE__, __FILE__, 'riff-wFormatTag');
+        }
+
+        public static function fourccLookup($fourcc) {
+
+                $begin = __LINE__;
+
+                /** This is not a comment!
+
+                        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    Blizzard DivX 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
+                        FLV1    Sorenson Spark
+                        FLV4    On2 TrueMotion VP6
+                        FRWT    Darim Vision Forward Motion JPEG (www.darvision.com)
+                        FRWU    Darim Vision Forward Uncompressed (www.darvision.com)
+                        FLJP    D-Vision Field Encoded Motion JPEG
+                        FPS1    FRAPS v1
+                        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
+                        VP6F    On2 TrueMotion VP6
+                        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 getid3_lib::EmbeddedLookup($fourcc, $begin, __LINE__, __FILE__, 'riff-fourcc');
+        }
+
+        private function EitherEndian2Int($byteword, $signed=false) {
+                if ($this->getid3->info['fileformat'] == 'riff') {
+                        return getid3_lib::LittleEndian2Int($byteword, $signed);
+                }
+                return getid3_lib::BigEndian2Int($byteword, false, $signed);
+        }
+
+}

new file wp-includes/ID3/module.audio.ac3.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio.ac3.php                                        //
+// module for analyzing AC-3 (aka Dolby Digital) audio files   //
+// dependencies: NONE                                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+
+class getid3_ac3 extends getid3_handler
+{
+    private $AC3header = array();
+    private $BSIoffset = 0;
+
+    const syncword = "\x0B\x77";
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                ///AH
+                $info['ac3']['raw']['bsi'] = array();
+                $thisfile_ac3              = &$info['ac3'];
+                $thisfile_ac3_raw          = &$thisfile_ac3['raw'];
+                $thisfile_ac3_raw_bsi      = &$thisfile_ac3_raw['bsi'];
+
+
+                // http://www.atsc.org/standards/a_52a.pdf
+
+                $info['fileformat'] = 'ac3';
+
+                // 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
+
+                // syncinfo() {
+                //       syncword    16
+                //       crc1        16
+                //       fscod        2
+                //       frmsizecod   6
+                // } /* end of syncinfo */
+
+                $this->fseek($info['avdataoffset']);
+                $this->AC3header['syncinfo'] = $this->fread(5);
+
+                if (strpos($this->AC3header['syncinfo'], self::syncword) === 0) {
+                        $thisfile_ac3_raw['synchinfo']['synchword'] = self::syncword;
+                        $offset = 2;
+                } else {
+                        if (!$this->isDependencyFor('matroska')) {
+                                unset($info['fileformat'], $info['ac3']);
+                                return $this->error('Expecting "'.getid3_lib::PrintHexBytes(self::syncword).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib::PrintHexBytes(substr($this->AC3header['syncinfo'], 0, 2)).'"');
+                        }
+                        $offset = 0;
+                        $this->fseek(-2, SEEK_CUR);
+                }
+
+                $info['audio']['dataformat']   = 'ac3';
+                $info['audio']['bitrate_mode'] = 'cbr';
+                $info['audio']['lossless']     = false;
+
+                $thisfile_ac3_raw['synchinfo']['crc1']       = getid3_lib::LittleEndian2Int(substr($this->AC3header['syncinfo'], $offset, 2));
+                $ac3_synchinfo_fscod_frmsizecod              = getid3_lib::LittleEndian2Int(substr($this->AC3header['syncinfo'], ($offset + 2), 1));
+                $thisfile_ac3_raw['synchinfo']['fscod']      = ($ac3_synchinfo_fscod_frmsizecod & 0xC0) >> 6;
+                $thisfile_ac3_raw['synchinfo']['frmsizecod'] = ($ac3_synchinfo_fscod_frmsizecod & 0x3F);
+
+                $thisfile_ac3['sample_rate'] = self::sampleRateCodeLookup($thisfile_ac3_raw['synchinfo']['fscod']);
+                if ($thisfile_ac3_raw['synchinfo']['fscod'] <= 3) {
+                        $info['audio']['sample_rate'] = $thisfile_ac3['sample_rate'];
+                }
+
+                $thisfile_ac3['frame_length'] = self::frameSizeLookup($thisfile_ac3_raw['synchinfo']['frmsizecod'], $thisfile_ac3_raw['synchinfo']['fscod']);
+                $thisfile_ac3['bitrate']      = self::bitrateLookup($thisfile_ac3_raw['synchinfo']['frmsizecod']);
+                $info['audio']['bitrate'] = $thisfile_ac3['bitrate'];
+
+                $this->AC3header['bsi'] = getid3_lib::BigEndian2Bin($this->fread(15));
+                $ac3_bsi_offset = 0;
+
+                $thisfile_ac3_raw_bsi['bsid'] = $this->readHeaderBSI(5);
+                if ($thisfile_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.
+                        $this->error('Bit stream identification is version '.$thisfile_ac3_raw_bsi['bsid'].', but getID3() only understands up to version 8');
+                    unset($info['ac3']);
+                        return false;
+                }
+
+                $thisfile_ac3_raw_bsi['bsmod'] = $this->readHeaderBSI(3);
+                $thisfile_ac3_raw_bsi['acmod'] = $this->readHeaderBSI(3);
+
+                $thisfile_ac3['service_type'] = self::serviceTypeLookup($thisfile_ac3_raw_bsi['bsmod'], $thisfile_ac3_raw_bsi['acmod']);
+                $ac3_coding_mode = self::audioCodingModeLookup($thisfile_ac3_raw_bsi['acmod']);
+                foreach($ac3_coding_mode as $key => $value) {
+                        $thisfile_ac3[$key] = $value;
+                }
+                switch ($thisfile_ac3_raw_bsi['acmod']) {
+                        case 0:
+                        case 1:
+                                $info['audio']['channelmode'] = 'mono';
+                                break;
+                        case 3:
+                        case 4:
+                                $info['audio']['channelmode'] = 'stereo';
+                                break;
+                        default:
+                                $info['audio']['channelmode'] = 'surround';
+                                break;
+                }
+                $info['audio']['channels'] = $thisfile_ac3['num_channels'];
+
+                if ($thisfile_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.
+                        $thisfile_ac3_raw_bsi['cmixlev'] = $this->readHeaderBSI(2);
+                        $thisfile_ac3['center_mix_level'] = self::centerMixLevelLookup($thisfile_ac3_raw_bsi['cmixlev']);
+                }
+
+                if ($thisfile_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.
+                        $thisfile_ac3_raw_bsi['surmixlev'] = $this->readHeaderBSI(2);
+                        $thisfile_ac3['surround_mix_level'] = self::surroundMixLevelLookup($thisfile_ac3_raw_bsi['surmixlev']);
+                }
+
+                if ($thisfile_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.
+                        $thisfile_ac3_raw_bsi['dsurmod'] = $this->readHeaderBSI(2);
+                        $thisfile_ac3['dolby_surround_mode'] = self::dolbySurroundModeLookup($thisfile_ac3_raw_bsi['dsurmod']);
+                }
+
+                $thisfile_ac3_raw_bsi['lfeon'] = (bool) $this->readHeaderBSI(1);
+                $thisfile_ac3['lfe_enabled'] = $thisfile_ac3_raw_bsi['lfeon'];
+                if ($thisfile_ac3_raw_bsi['lfeon']) {
+                        //$info['audio']['channels']++;
+                        $info['audio']['channels'] .= '.1';
+                }
+
+                $thisfile_ac3['channels_enabled'] = self::channelsEnabledLookup($thisfile_ac3_raw_bsi['acmod'], $thisfile_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.
+                $thisfile_ac3_raw_bsi['dialnorm'] = $this->readHeaderBSI(5);
+                $thisfile_ac3['dialogue_normalization'] = '-'.$thisfile_ac3_raw_bsi['dialnorm'].'dB';
+
+                $thisfile_ac3_raw_bsi['compre_flag'] = (bool) $this->readHeaderBSI(1);
+                if ($thisfile_ac3_raw_bsi['compre_flag']) {
+                        $thisfile_ac3_raw_bsi['compr'] = $this->readHeaderBSI(8);
+                        $thisfile_ac3['heavy_compression'] = self::heavyCompression($thisfile_ac3_raw_bsi['compr']);
+                }
+
+                $thisfile_ac3_raw_bsi['langcode_flag'] = (bool) $this->readHeaderBSI(1);
+                if ($thisfile_ac3_raw_bsi['langcode_flag']) {
+                        $thisfile_ac3_raw_bsi['langcod'] = $this->readHeaderBSI(8);
+                }
+
+                $thisfile_ac3_raw_bsi['audprodie'] = (bool) $this->readHeaderBSI(1);
+                if ($thisfile_ac3_raw_bsi['audprodie']) {
+                        $thisfile_ac3_raw_bsi['mixlevel'] = $this->readHeaderBSI(5);
+                        $thisfile_ac3_raw_bsi['roomtyp']  = $this->readHeaderBSI(2);
+
+                        $thisfile_ac3['mixing_level'] = (80 + $thisfile_ac3_raw_bsi['mixlevel']).'dB';
+                        $thisfile_ac3['room_type']    = self::roomTypeLookup($thisfile_ac3_raw_bsi['roomtyp']);
+                }
+
+                if ($thisfile_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.
+                        $thisfile_ac3_raw_bsi['dialnorm2'] = $this->readHeaderBSI(5);
+                        $thisfile_ac3['dialogue_normalization2'] = '-'.$thisfile_ac3_raw_bsi['dialnorm2'].'dB';
+
+                        $thisfile_ac3_raw_bsi['compre_flag2'] = (bool) $this->readHeaderBSI(1);
+                        if ($thisfile_ac3_raw_bsi['compre_flag2']) {
+                                $thisfile_ac3_raw_bsi['compr2'] = $this->readHeaderBSI(8);
+                                $thisfile_ac3['heavy_compression2'] = self::heavyCompression($thisfile_ac3_raw_bsi['compr2']);
+                        }
+
+                        $thisfile_ac3_raw_bsi['langcode_flag2'] = (bool) $this->readHeaderBSI(1);
+                        if ($thisfile_ac3_raw_bsi['langcode_flag2']) {
+                                $thisfile_ac3_raw_bsi['langcod2'] = $this->readHeaderBSI(8);
+                        }
+
+                        $thisfile_ac3_raw_bsi['audprodie2'] = (bool) $this->readHeaderBSI(1);
+                        if ($thisfile_ac3_raw_bsi['audprodie2']) {
+                                $thisfile_ac3_raw_bsi['mixlevel2'] = $this->readHeaderBSI(5);
+                                $thisfile_ac3_raw_bsi['roomtyp2']  = $this->readHeaderBSI(2);
+
+                                $thisfile_ac3['mixing_level2'] = (80 + $thisfile_ac3_raw_bsi['mixlevel2']).'dB';
+                                $thisfile_ac3['room_type2']    = self::roomTypeLookup($thisfile_ac3_raw_bsi['roomtyp2']);
+                        }
+
+                }
+
+                $thisfile_ac3_raw_bsi['copyright'] = (bool) $this->readHeaderBSI(1);
+
+                $thisfile_ac3_raw_bsi['original']  = (bool) $this->readHeaderBSI(1);
+
+                $thisfile_ac3_raw_bsi['timecode1_flag'] = (bool) $this->readHeaderBSI(1);
+                if ($thisfile_ac3_raw_bsi['timecode1_flag']) {
+                        $thisfile_ac3_raw_bsi['timecode1'] = $this->readHeaderBSI(14);
+                }
+
+                $thisfile_ac3_raw_bsi['timecode2_flag'] = (bool) $this->readHeaderBSI(1);
+                if ($thisfile_ac3_raw_bsi['timecode2_flag']) {
+                        $thisfile_ac3_raw_bsi['timecode2'] = $this->readHeaderBSI(14);
+                }
+
+                $thisfile_ac3_raw_bsi['addbsi_flag'] = (bool) $this->readHeaderBSI(1);
+                if ($thisfile_ac3_raw_bsi['addbsi_flag']) {
+                        $thisfile_ac3_raw_bsi['addbsi_length'] = $this->readHeaderBSI(6);
+
+                        $this->AC3header['bsi'] .= getid3_lib::BigEndian2Bin($this->fread($thisfile_ac3_raw_bsi['addbsi_length']));
+
+                        $thisfile_ac3_raw_bsi['addbsi_data'] = substr($this->AC3header['bsi'], $this->BSIoffset, $thisfile_ac3_raw_bsi['addbsi_length'] * 8);
+                        $this->BSIoffset += $thisfile_ac3_raw_bsi['addbsi_length'] * 8;
+                }
+
+                return true;
+        }
+
+        private function readHeaderBSI($length) {
+                $data = substr($this->AC3header['bsi'], $this->BSIoffset, $length);
+                $this->BSIoffset += $length;
+
+                return bindec($data);
+        }
+
+        public static function sampleRateCodeLookup($fscod) {
+                static $sampleRateCodeLookup = 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($sampleRateCodeLookup[$fscod]) ? $sampleRateCodeLookup[$fscod] : false);
+        }
+
+        public static function serviceTypeLookup($bsmod, $acmod) {
+                static $serviceTypeLookup = array();
+                if (empty($serviceTypeLookup)) {
+                        for ($i = 0; $i <= 7; $i++) {
+                                $serviceTypeLookup[0][$i] = 'main audio service: complete main (CM)';
+                                $serviceTypeLookup[1][$i] = 'main audio service: music and effects (ME)';
+                                $serviceTypeLookup[2][$i] = 'associated service: visually impaired (VI)';
+                                $serviceTypeLookup[3][$i] = 'associated service: hearing impaired (HI)';
+                                $serviceTypeLookup[4][$i] = 'associated service: dialogue (D)';
+                                $serviceTypeLookup[5][$i] = 'associated service: commentary (C)';
+                                $serviceTypeLookup[6][$i] = 'associated service: emergency (E)';
+                        }
+
+                        $serviceTypeLookup[7][1]      = 'associated service: voice over (VO)';
+                        for ($i = 2; $i <= 7; $i++) {
+                                $serviceTypeLookup[7][$i] = 'main audio service: karaoke';
+                        }
+                }
+                return (isset($serviceTypeLookup[$bsmod][$acmod]) ? $serviceTypeLookup[$bsmod][$acmod] : false);
+        }
+
+        public static function audioCodingModeLookup($acmod) {
+                // array(channel configuration, # channels (not incl LFE), channel order)
+                static $audioCodingModeLookup = 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($audioCodingModeLookup[$acmod]) ? $audioCodingModeLookup[$acmod] : false);
+        }
+
+        public static function centerMixLevelLookup($cmixlev) {
+                static $centerMixLevelLookup;
+                if (empty($centerMixLevelLookup)) {
+                        $centerMixLevelLookup = 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($centerMixLevelLookup[$cmixlev]) ? $centerMixLevelLookup[$cmixlev] : false);
+        }
+
+        public static function surroundMixLevelLookup($surmixlev) {
+                static $surroundMixLevelLookup;
+                if (empty($surroundMixLevelLookup)) {
+                        $surroundMixLevelLookup = array(
+                                0 => pow(2, -3.0 / 6),
+                                1 => pow(2, -6.0 / 6),
+                                2 => 0,
+                                3 => 'reserved'
+                        );
+                }
+                return (isset($surroundMixLevelLookup[$surmixlev]) ? $surroundMixLevelLookup[$surmixlev] : false);
+        }
+
+        public static function dolbySurroundModeLookup($dsurmod) {
+                static $dolbySurroundModeLookup = array(
+                        0 => 'not indicated',
+                        1 => 'Not Dolby Surround encoded',
+                        2 => 'Dolby Surround encoded',
+                        3 => 'reserved'
+                );
+                return (isset($dolbySurroundModeLookup[$dsurmod]) ? $dolbySurroundModeLookup[$dsurmod] : false);
+        }
+
+        public static function channelsEnabledLookup($acmod, $lfeon) {
+                $lookup = array(
+                        'ch1'=>(bool) ($acmod == 0),
+                        'ch2'=>(bool) ($acmod == 0),
+                        'left'=>(bool) ($acmod > 1),
+                        'right'=>(bool) ($acmod > 1),
+                        'center'=>(bool) ($acmod & 0x01),
+                        'surround_mono'=>false,
+                        'surround_left'=>false,
+                        'surround_right'=>false,
+                        'lfe'=>$lfeon);
+                switch ($acmod) {
+                        case 4:
+                        case 5:
+                                $lookup['surround_mono']  = true;
+                                break;
+                        case 6:
+                        case 7:
+                                $lookup['surround_left']  = true;
+                                $lookup['surround_right'] = true;
+                                break;
+                }
+                return $lookup;
+        }
+
+        public static function heavyCompression($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) * getid3_lib::RGADamplitude2dB(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 roomTypeLookup($roomtyp) {
+                static $roomTypeLookup = array(
+                        0 => 'not indicated',
+                        1 => 'large room, X curve monitor',
+                        2 => 'small room, flat monitor',
+                        3 => 'reserved'
+                );
+                return (isset($roomTypeLookup[$roomtyp]) ? $roomTypeLookup[$roomtyp] : false);
+        }
+
+        public static function frameSizeLookup($frmsizecod, $fscod) {
+                $padding     = (bool) ($frmsizecod % 2);
+                $framesizeid =   floor($frmsizecod / 2);
+
+                static $frameSizeLookup = array();
+                if (empty($frameSizeLookup)) {
+                        $frameSizeLookup = 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
+                        $frameSizeLookup[$frmsizecod] += 2;
+                }
+                return (isset($frameSizeLookup[$framesizeid][$fscod]) ? $frameSizeLookup[$framesizeid][$fscod] : false);
+        }
+
+        public static function bitrateLookup($frmsizecod) {
+                $framesizeid =   floor($frmsizecod / 2);
+
+                static $bitrateLookup = 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
+                );
+                return (isset($bitrateLookup[$framesizeid]) ? $bitrateLookup[$framesizeid] : false);
+        }
+
+
+}

new file wp-includes/ID3/module.audio.dts.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio.dts.php                                        //
+// module for analyzing DTS Audio files                        //
+// dependencies: NONE                                          //
+//                                                             //
+/////////////////////////////////////////////////////////////////
+
+
+/**
+* @tutorial http://wiki.multimedia.cx/index.php?title=DTS
+*/
+class getid3_dts extends getid3_handler
+{
+        /**
+        * Default DTS syncword used in native .cpt or .dts formats
+        */
+    const syncword = "\x7F\xFE\x80\x01";
+
+        private $readBinDataOffset = 0;
+
+    /**
+    * Possible syncwords indicating bitstream encoding
+    */
+    public static $syncwords = array(
+        0 => "\x7F\xFE\x80\x01",  // raw big-endian
+        1 => "\xFE\x7F\x01\x80",  // raw little-endian
+        2 => "\x1F\xFF\xE8\x00",  // 14-bit big-endian
+        3 => "\xFF\x1F\x00\xE8"); // 14-bit little-endian
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+                $info['fileformat'] = 'dts';
+
+                $this->fseek($info['avdataoffset']);
+                $DTSheader = $this->fread(20); // we only need 2 words magic + 6 words frame header, but these words may be normal 16-bit words OR 14-bit words with 2 highest bits set to zero, so 8 words can be either 8*16/8 = 16 bytes OR 8*16*(16/14)/8 = 18.3 bytes
+
+                // check syncword
+                $sync = substr($DTSheader, 0, 4);
+        if (($encoding = array_search($sync, self::$syncwords)) !== false) {
+
+                $info['dts']['raw']['magic'] = $sync;
+                        $this->readBinDataOffset = 32;
+
+        } elseif ($this->isDependencyFor('matroska')) {
+
+                        // Matroska contains DTS without syncword encoded as raw big-endian format
+                        $encoding = 0;
+                        $this->readBinDataOffset = 0;
+
+        } else {
+
+                        unset($info['fileformat']);
+                        return $this->error('Expecting "'.implode('| ', array_map('getid3_lib::PrintHexBytes', self::$syncwords)).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib::PrintHexBytes($sync).'"');
+
+                }
+
+                // decode header
+                $fhBS = '';
+                for ($word_offset = 0; $word_offset <= strlen($DTSheader); $word_offset += 2) {
+                        switch ($encoding) {
+                                case 0: // raw big-endian
+                                        $fhBS .=        getid3_lib::BigEndian2Bin(       substr($DTSheader, $word_offset, 2) );
+                                        break;
+                                case 1: // raw little-endian
+                                        $fhBS .=        getid3_lib::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2)));
+                                        break;
+                                case 2: // 14-bit big-endian
+                                        $fhBS .= substr(getid3_lib::BigEndian2Bin(       substr($DTSheader, $word_offset, 2) ), 2, 14);
+                                        break;
+                                case 3: // 14-bit little-endian
+                                        $fhBS .= substr(getid3_lib::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2))), 2, 14);
+                                        break;
+                        }
+                }
+
+                $info['dts']['raw']['frame_type']             =        $this->readBinData($fhBS,  1);
+                $info['dts']['raw']['deficit_samples']        =        $this->readBinData($fhBS,  5);
+                $info['dts']['flags']['crc_present']          = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['raw']['pcm_sample_blocks']      =        $this->readBinData($fhBS,  7);
+                $info['dts']['raw']['frame_byte_size']        =        $this->readBinData($fhBS, 14);
+                $info['dts']['raw']['channel_arrangement']    =        $this->readBinData($fhBS,  6);
+                $info['dts']['raw']['sample_frequency']       =        $this->readBinData($fhBS,  4);
+                $info['dts']['raw']['bitrate']                =        $this->readBinData($fhBS,  5);
+                $info['dts']['flags']['embedded_downmix']     = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['flags']['dynamicrange']         = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['flags']['timestamp']            = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['flags']['auxdata']              = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['flags']['hdcd']                 = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['raw']['extension_audio']        =        $this->readBinData($fhBS,  3);
+                $info['dts']['flags']['extended_coding']      = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['flags']['audio_sync_insertion'] = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['raw']['lfe_effects']            =        $this->readBinData($fhBS,  2);
+                $info['dts']['flags']['predictor_history']    = (bool) $this->readBinData($fhBS,  1);
+                if ($info['dts']['flags']['crc_present']) {
+                        $info['dts']['raw']['crc16']              =        $this->readBinData($fhBS, 16);
+                }
+                $info['dts']['flags']['mri_perfect_reconst']  = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['raw']['encoder_soft_version']   =        $this->readBinData($fhBS,  4);
+                $info['dts']['raw']['copy_history']           =        $this->readBinData($fhBS,  2);
+                $info['dts']['raw']['bits_per_sample']        =        $this->readBinData($fhBS,  2);
+                $info['dts']['flags']['surround_es']          = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['flags']['front_sum_diff']       = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['flags']['surround_sum_diff']    = (bool) $this->readBinData($fhBS,  1);
+                $info['dts']['raw']['dialog_normalization']   =        $this->readBinData($fhBS,  4);
+
+
+                $info['dts']['bitrate']              = self::bitrateLookup($info['dts']['raw']['bitrate']);
+                $info['dts']['bits_per_sample']      = self::bitPerSampleLookup($info['dts']['raw']['bits_per_sample']);
+                $info['dts']['sample_rate']          = self::sampleRateLookup($info['dts']['raw']['sample_frequency']);
+                $info['dts']['dialog_normalization'] = self::dialogNormalization($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']             = self::numChannelsLookup($info['dts']['raw']['channel_arrangement']);
+                $info['dts']['channel_arrangement']  = self::channelArrangementLookup($info['dts']['raw']['channel_arrangement']);
+
+                $info['audio']['dataformat']          = 'dts';
+                $info['audio']['lossless']            = $info['dts']['flags']['lossless'];
+                $info['audio']['bitrate_mode']        = $info['dts']['bitrate_mode'];
+                $info['audio']['bits_per_sample']     = $info['dts']['bits_per_sample'];
+                $info['audio']['sample_rate']         = $info['dts']['sample_rate'];
+                $info['audio']['channels']            = $info['dts']['channels'];
+                $info['audio']['bitrate']             = $info['dts']['bitrate'];
+                if (isset($info['avdataend']) && !empty($info['dts']['bitrate']) && is_numeric($info['dts']['bitrate'])) {
+                        $info['playtime_seconds']         = ($info['avdataend'] - $info['avdataoffset']) / ($info['dts']['bitrate'] / 8);
+                        if (($encoding == 2) || ($encoding == 3)) {
+                                // 14-bit data packed into 16-bit words, so the playtime is wrong because only (14/16) of the bytes in the data portion of the file are used at the specified bitrate
+                                $info['playtime_seconds'] *= (14 / 16);
+                        }
+                }
+                return true;
+        }
+
+        private function readBinData($bin, $length) {
+                $data = substr($bin, $this->readBinDataOffset, $length);
+                $this->readBinDataOffset += $length;
+
+                return bindec($data);
+        }
+
+        public static function bitrateLookup($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 (isset($lookup[$index]) ? $lookup[$index] : false);
+        }
+
+        public static function sampleRateLookup($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 (isset($lookup[$index]) ? $lookup[$index] : false);
+        }
+
+        public static function bitPerSampleLookup($index) {
+                static $lookup = array(
+                        0  => 16,
+                        1  => 20,
+                        2  => 24,
+                        3  => 24,
+                );
+                return (isset($lookup[$index]) ? $lookup[$index] : false);
+        }
+
+        public static function numChannelsLookup($index) {
+                switch ($index) {
+                        case 0:
+                                return 1;
+                                break;
+                        case 1:
+                        case 2:
+                        case 3:
+                        case 4:
+                                return 2;
+                                break;
+                        case 5:
+                        case 6:
+                                return 3;
+                                break;
+                        case 7:
+                        case 8:
+                                return 4;
+                                break;
+                        case 9:
+                                return 5;
+                                break;
+                        case 10:
+                        case 11:
+                        case 12:
+                                return 6;
+                                break;
+                        case 13:
+                                return 7;
+                                break;
+                        case 14:
+                        case 15:
+                                return 8;
+                                break;
+                }
+                return false;
+        }
+
+        public static function channelArrangementLookup($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 (isset($lookup[$index]) ? $lookup[$index] : 'user-defined');
+        }
+
+        public static function dialogNormalization($index, $version) {
+                switch ($version) {
+                        case 7:
+                                return 0 - $index;
+                                break;
+                        case 6:
+                                return 0 - 16 - $index;
+                                break;
+                }
+                return false;
+        }
+
+}

new file wp-includes/ID3/module.audio.flac.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio.flac.php                                       //
+// module for analyzing FLAC and OggFLAC audio files           //
+// dependencies: module.audio.ogg.php                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.ogg.php', __FILE__, true);
+
+/**
+* @tutorial http://flac.sourceforge.net/format.html
+*/
+class getid3_flac extends getid3_handler
+{
+        const syncword = 'fLaC';
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                $this->fseek($info['avdataoffset']);
+                $StreamMarker = $this->fread(4);
+                if ($StreamMarker != self::syncword) {
+                        return $this->error('Expecting "'.getid3_lib::PrintHexBytes(self::syncword).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib::PrintHexBytes($StreamMarker).'"');
+                }
+                $info['fileformat']            = 'flac';
+                $info['audio']['dataformat']   = 'flac';
+                $info['audio']['bitrate_mode'] = 'vbr';
+                $info['audio']['lossless']     = true;
+
+                // parse flac container
+                return $this->parseMETAdata();
+        }
+
+        public function parseMETAdata() {
+                $info = &$this->getid3->info;
+                do {
+                        $BlockOffset   = $this->ftell();
+                        $BlockHeader   = $this->fread(4);
+                        $LBFBT         = getid3_lib::BigEndian2Int(substr($BlockHeader, 0, 1));
+                        $LastBlockFlag = (bool) ($LBFBT & 0x80);
+                        $BlockType     =        ($LBFBT & 0x7F);
+                        $BlockLength   = getid3_lib::BigEndian2Int(substr($BlockHeader, 1, 3));
+                        $BlockTypeText = self::metaBlockTypeLookup($BlockType);
+
+                        if (($BlockOffset + 4 + $BlockLength) > $info['avdataend']) {
+                                $this->error('METADATA_BLOCK_HEADER.BLOCK_TYPE ('.$BlockTypeText.') at offset '.$BlockOffset.' extends beyond end of file');
+                                break;
+                        }
+                        if ($BlockLength < 1) {
+                                $this->error('METADATA_BLOCK_HEADER.BLOCK_LENGTH ('.$BlockLength.') at offset '.$BlockOffset.' is invalid');
+                                break;
+                        }
+
+                        $info['flac'][$BlockTypeText]['raw'] = array();
+                        $BlockTypeText_raw = &$info['flac'][$BlockTypeText]['raw'];
+
+                        $BlockTypeText_raw['offset']          = $BlockOffset;
+                        $BlockTypeText_raw['last_meta_block'] = $LastBlockFlag;
+                        $BlockTypeText_raw['block_type']      = $BlockType;
+                        $BlockTypeText_raw['block_type_text'] = $BlockTypeText;
+                        $BlockTypeText_raw['block_length']    = $BlockLength;
+                        if ($BlockTypeText_raw['block_type'] != 0x06) { // do not read attachment data automatically
+                                $BlockTypeText_raw['block_data']  = $this->fread($BlockLength);
+                        }
+
+                        switch ($BlockTypeText) {
+                                case 'STREAMINFO':     // 0x00
+                                        if (!$this->parseSTREAMINFO($BlockTypeText_raw['block_data'])) {
+                                                return false;
+                                        }
+                                        break;
+
+                                case 'PADDING':        // 0x01
+                                        unset($info['flac']['PADDING']); // ignore
+                                        break;
+
+                                case 'APPLICATION':    // 0x02
+                                        if (!$this->parseAPPLICATION($BlockTypeText_raw['block_data'])) {
+                                                return false;
+                                        }
+                                        break;
+
+                                case 'SEEKTABLE':      // 0x03
+                                        if (!$this->parseSEEKTABLE($BlockTypeText_raw['block_data'])) {
+                                                return false;
+                                        }
+                                        break;
+
+                                case 'VORBIS_COMMENT': // 0x04
+                                        if (!$this->parseVORBIS_COMMENT($BlockTypeText_raw['block_data'])) {
+                                                return false;
+                                        }
+                                        break;
+
+                                case 'CUESHEET':       // 0x05
+                                        if (!$this->parseCUESHEET($BlockTypeText_raw['block_data'])) {
+                                                return false;
+                                        }
+                                        break;
+
+                                case 'PICTURE':        // 0x06
+                                        if (!$this->parsePICTURE()) {
+                                                return false;
+                                        }
+                                        break;
+
+                                default:
+                                        $this->warning('Unhandled METADATA_BLOCK_HEADER.BLOCK_TYPE ('.$BlockType.') at offset '.$BlockOffset);
+                        }
+
+                        unset($info['flac'][$BlockTypeText]['raw']);
+                        $info['avdataoffset'] = $this->ftell();
+                }
+                while ($LastBlockFlag === false);
+
+                // handle tags
+                if (!empty($info['flac']['VORBIS_COMMENT']['comments'])) {
+                        $info['flac']['comments'] = $info['flac']['VORBIS_COMMENT']['comments'];
+                }
+                if (!empty($info['flac']['VORBIS_COMMENT']['vendor'])) {
+                        $info['audio']['encoder'] = str_replace('reference ', '', $info['flac']['VORBIS_COMMENT']['vendor']);
+                }
+
+                // copy attachments to 'comments' array if nesesary
+                if (isset($info['flac']['PICTURE']) && ($this->getid3->option_save_attachments !== getID3::ATTACHMENTS_NONE)) {
+                        foreach ($info['flac']['PICTURE'] as $entry) {
+                                if (!empty($entry['data'])) {
+                                        $info['flac']['comments']['picture'][] = array('image_mime'=>$entry['image_mime'], 'data'=>$entry['data']);
+                                }
+                        }
+                }
+
+                if (isset($info['flac']['STREAMINFO'])) {
+                        if (!$this->isDependencyFor('matroska')) {
+                                $info['flac']['compressed_audio_bytes'] = $info['avdataend'] - $info['avdataoffset'];
+                        }
+                        $info['flac']['uncompressed_audio_bytes'] = $info['flac']['STREAMINFO']['samples_stream'] * $info['flac']['STREAMINFO']['channels'] * ($info['flac']['STREAMINFO']['bits_per_sample'] / 8);
+                        if ($info['flac']['uncompressed_audio_bytes'] == 0) {
+                                return $this->error('Corrupt FLAC file: uncompressed_audio_bytes == zero');
+                        }
+                        if (!empty($info['flac']['compressed_audio_bytes'])) {
+                                $info['flac']['compression_ratio'] = $info['flac']['compressed_audio_bytes'] / $info['flac']['uncompressed_audio_bytes'];
+                        }
+                }
+
+                // set md5_data_source - built into flac 0.5+
+                if (isset($info['flac']['STREAMINFO']['audio_signature'])) {
+
+                        if ($info['flac']['STREAMINFO']['audio_signature'] === str_repeat("\x00", 16)) {
+                $this->warning('FLAC STREAMINFO.audio_signature is null (known issue with libOggFLAC)');
+                        }
+                        else {
+                                $info['md5_data_source'] = '';
+                                $md5 = $info['flac']['STREAMINFO']['audio_signature'];
+                                for ($i = 0; $i < strlen($md5); $i++) {
+                                        $info['md5_data_source'] .= str_pad(dechex(ord($md5[$i])), 2, '00', STR_PAD_LEFT);
+                                }
+                                if (!preg_match('/^[0-9a-f]{32}$/', $info['md5_data_source'])) {
+                                        unset($info['md5_data_source']);
+                                }
+                        }
+                }
+
+                if (isset($info['flac']['STREAMINFO']['bits_per_sample'])) {
+                        $info['audio']['bits_per_sample'] = $info['flac']['STREAMINFO']['bits_per_sample'];
+                        if ($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
+                                $this->warning('FLAC calculates MD5 data strangely on 8-bit audio, so the stored md5_data_source value will not match the decoded WAV file');
+                        }
+                }
+
+                return true;
+        }
+
+        private function parseSTREAMINFO($BlockData) {
+                $info = &$this->getid3->info;
+
+                $info['flac']['STREAMINFO'] = array();
+                $streaminfo = &$info['flac']['STREAMINFO'];
+
+                $streaminfo['min_block_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 0, 2));
+                $streaminfo['max_block_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 2, 2));
+                $streaminfo['min_frame_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 4, 3));
+                $streaminfo['max_frame_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 7, 3));
+
+                $SRCSBSS                       = getid3_lib::BigEndian2Bin(substr($BlockData, 10, 8));
+                $streaminfo['sample_rate']     = getid3_lib::Bin2Dec(substr($SRCSBSS,  0, 20));
+                $streaminfo['channels']        = getid3_lib::Bin2Dec(substr($SRCSBSS, 20,  3)) + 1;
+                $streaminfo['bits_per_sample'] = getid3_lib::Bin2Dec(substr($SRCSBSS, 23,  5)) + 1;
+                $streaminfo['samples_stream']  = getid3_lib::Bin2Dec(substr($SRCSBSS, 28, 36));
+
+                $streaminfo['audio_signature'] = substr($BlockData, 18, 16);
+
+                if (!empty($streaminfo['sample_rate'])) {
+
+                        $info['audio']['bitrate_mode']    = 'vbr';
+                        $info['audio']['sample_rate']     = $streaminfo['sample_rate'];
+                        $info['audio']['channels']        = $streaminfo['channels'];
+                        $info['audio']['bits_per_sample'] = $streaminfo['bits_per_sample'];
+                        $info['playtime_seconds']         = $streaminfo['samples_stream'] / $streaminfo['sample_rate'];
+                        if ($info['playtime_seconds'] > 0) {
+                                if (!$this->isDependencyFor('matroska')) {
+                                        $info['audio']['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $info['playtime_seconds'];
+                                }
+                                else {
+                                        $this->warning('Cannot determine audio bitrate because total stream size is unknown');
+                                }
+                        }
+
+                } else {
+                        return $this->error('Corrupt METAdata block: STREAMINFO');
+                }
+
+                return true;
+        }
+
+        private function parseAPPLICATION($BlockData) {
+                $info = &$this->getid3->info;
+
+                $ApplicationID = getid3_lib::BigEndian2Int(substr($BlockData, 0, 4));
+                $info['flac']['APPLICATION'][$ApplicationID]['name'] = self::applicationIDLookup($ApplicationID);
+                $info['flac']['APPLICATION'][$ApplicationID]['data'] = substr($BlockData, 4);
+
+                return true;
+        }
+
+        private function parseSEEKTABLE($BlockData) {
+                $info = &$this->getid3->info;
+
+                $offset = 0;
+                $BlockLength = strlen($BlockData);
+                $placeholderpattern = str_repeat("\xFF", 8);
+                while ($offset < $BlockLength) {
+                        $SampleNumberString = substr($BlockData, $offset, 8);
+                        $offset += 8;
+                        if ($SampleNumberString == $placeholderpattern) {
+
+                                // placeholder point
+                                getid3_lib::safe_inc($info['flac']['SEEKTABLE']['placeholders'], 1);
+                                $offset += 10;
+
+                        } else {
+
+                                $SampleNumber                                        = getid3_lib::BigEndian2Int($SampleNumberString);
+                                $info['flac']['SEEKTABLE'][$SampleNumber]['offset']  = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
+                                $offset += 8;
+                                $info['flac']['SEEKTABLE'][$SampleNumber]['samples'] = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 2));
+                                $offset += 2;
+
+                        }
+                }
+
+                return true;
+        }
+
+        private function parseVORBIS_COMMENT($BlockData) {
+                $info = &$this->getid3->info;
+
+                $getid3_ogg = new getid3_ogg($this->getid3);
+                if ($this->isDependencyFor('matroska')) {
+                        $getid3_ogg->setStringMode($this->data_string);
+                }
+                $getid3_ogg->ParseVorbisComments();
+                if (isset($info['ogg'])) {
+                        unset($info['ogg']['comments_raw']);
+                        $info['flac']['VORBIS_COMMENT'] = $info['ogg'];
+                        unset($info['ogg']);
+                }
+
+                unset($getid3_ogg);
+
+                return true;
+        }
+
+        private function parseCUESHEET($BlockData) {
+                $info = &$this->getid3->info;
+                $offset = 0;
+                $info['flac']['CUESHEET']['media_catalog_number'] =                              trim(substr($BlockData, $offset, 128), "\0");
+                $offset += 128;
+                $info['flac']['CUESHEET']['lead_in_samples']      =         getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
+                $offset += 8;
+                $info['flac']['CUESHEET']['flags']['is_cd']       = (bool) (getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1)) & 0x80);
+                $offset += 1;
+
+                $offset += 258; // reserved
+
+                $info['flac']['CUESHEET']['number_tracks']        =         getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
+                $offset += 1;
+
+                for ($track = 0; $track < $info['flac']['CUESHEET']['number_tracks']; $track++) {
+                        $TrackSampleOffset = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
+                        $offset += 8;
+                        $TrackNumber       = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
+                        $offset += 1;
+
+                        $info['flac']['CUESHEET']['tracks'][$TrackNumber]['sample_offset']         = $TrackSampleOffset;
+
+                        $info['flac']['CUESHEET']['tracks'][$TrackNumber]['isrc']                  =                           substr($BlockData, $offset, 12);
+                        $offset += 12;
+
+                        $TrackFlagsRaw                                                             = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
+                        $offset += 1;
+                        $info['flac']['CUESHEET']['tracks'][$TrackNumber]['flags']['is_audio']     = (bool) ($TrackFlagsRaw & 0x80);
+                        $info['flac']['CUESHEET']['tracks'][$TrackNumber]['flags']['pre_emphasis'] = (bool) ($TrackFlagsRaw & 0x40);
+
+                        $offset += 13; // reserved
+
+                        $info['flac']['CUESHEET']['tracks'][$TrackNumber]['index_points']          = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
+                        $offset += 1;
+
+                        for ($index = 0; $index < $info['flac']['CUESHEET']['tracks'][$TrackNumber]['index_points']; $index++) {
+                                $IndexSampleOffset = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
+                                $offset += 8;
+                                $IndexNumber       = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
+                                $offset += 1;
+
+                                $offset += 3; // reserved
+
+                                $info['flac']['CUESHEET']['tracks'][$TrackNumber]['indexes'][$IndexNumber] = $IndexSampleOffset;
+                        }
+                }
+
+                return true;
+        }
+
+        /**
+        * Parse METADATA_BLOCK_PICTURE flac structure and extract attachment
+        * External usage: audio.ogg
+        */
+        public function parsePICTURE() {
+                $info = &$this->getid3->info;
+
+                $picture['typeid']         = getid3_lib::BigEndian2Int($this->fread(4));
+                $picture['type']           = self::pictureTypeLookup($picture['typeid']);
+                $picture['image_mime']     = $this->fread(getid3_lib::BigEndian2Int($this->fread(4)));
+                $descr_length              = getid3_lib::BigEndian2Int($this->fread(4));
+                if ($descr_length) {
+                        $picture['description'] = $this->fread($descr_length);
+                }
+                $picture['width']          = getid3_lib::BigEndian2Int($this->fread(4));
+                $picture['height']         = getid3_lib::BigEndian2Int($this->fread(4));
+                $picture['color_depth']    = getid3_lib::BigEndian2Int($this->fread(4));
+                $picture['colors_indexed'] = getid3_lib::BigEndian2Int($this->fread(4));
+                $data_length               = getid3_lib::BigEndian2Int($this->fread(4));
+
+                if ($picture['image_mime'] == '-->') {
+                        $picture['data'] = $this->fread($data_length);
+                } else {
+                        $picture['data'] = $this->saveAttachment(
+                                str_replace('/', '_', $picture['type']).'_'.$this->ftell(),
+                                $this->ftell(),
+                                $data_length,
+                                $picture['image_mime']);
+                }
+
+                $info['flac']['PICTURE'][] = $picture;
+
+                return true;
+        }
+
+        public static function metaBlockTypeLookup($blocktype) {
+                static $lookup = array(
+                        0 => 'STREAMINFO',
+                        1 => 'PADDING',
+                        2 => 'APPLICATION',
+                        3 => 'SEEKTABLE',
+                        4 => 'VORBIS_COMMENT',
+                        5 => 'CUESHEET',
+                        6 => 'PICTURE',
+                );
+                return (isset($lookup[$blocktype]) ? $lookup[$blocktype] : 'reserved');
+        }
+
+        public static function applicationIDLookup($applicationid) {
+                // http://flac.sourceforge.net/id.html
+                static $lookup = array(
+                        0x41544348 => 'FlacFile',                                                                           // "ATCH"
+                        0x42534F4C => 'beSolo',                                                                             // "BSOL"
+                        0x42554753 => 'Bugs Player',                                                                        // "BUGS"
+                        0x43756573 => 'GoldWave cue points (specification)',                                                // "Cues"
+                        0x46696361 => 'CUE Splitter',                                                                       // "Fica"
+                        0x46746F6C => 'flac-tools',                                                                         // "Ftol"
+                        0x4D4F5442 => 'MOTB MetaCzar',                                                                      // "MOTB"
+                        0x4D505345 => 'MP3 Stream Editor',                                                                  // "MPSE"
+                        0x4D754D4C => 'MusicML: Music Metadata Language',                                                   // "MuML"
+                        0x52494646 => 'Sound Devices RIFF chunk storage',                                                   // "RIFF"
+                        0x5346464C => 'Sound Font FLAC',                                                                    // "SFFL"
+                        0x534F4E59 => 'Sony Creative Software',                                                             // "SONY"
+                        0x5351455A => 'flacsqueeze',                                                                        // "SQEZ"
+                        0x54745776 => 'TwistedWave',                                                                        // "TtWv"
+                        0x55495453 => 'UITS Embedding tools',                                                               // "UITS"
+                        0x61696666 => 'FLAC AIFF chunk storage',                                                            // "aiff"
+                        0x696D6167 => 'flac-image application for storing arbitrary files in APPLICATION metadata blocks',  // "imag"
+                        0x7065656D => 'Parseable Embedded Extensible Metadata (specification)',                             // "peem"
+                        0x71667374 => 'QFLAC Studio',                                                                       // "qfst"
+                        0x72696666 => 'FLAC RIFF chunk storage',                                                            // "riff"
+                        0x74756E65 => 'TagTuner',                                                                           // "tune"
+                        0x78626174 => 'XBAT',                                                                               // "xbat"
+                        0x786D6364 => 'xmcd',                                                                               // "xmcd"
+                );
+                return (isset($lookup[$applicationid]) ? $lookup[$applicationid] : 'reserved');
+        }
+
+        public static function pictureTypeLookup($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');
+        }
+
+}

new file wp-includes/ID3/module.audio.mp3.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio.mp3.php                                        //
+// module for analyzing MP3 files                              //
+// dependencies: NONE                                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+
+// 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
+define('GETID3_MP3_VALID_CHECK_FRAMES', 35);
+
+
+class getid3_mp3 extends getid3_handler
+{
+
+        public $allow_bruteforce = false; // forces getID3() to scan the file byte-by-byte and log all the valid audio frame headers - extremely slow, unrecommended, but may provide data from otherwise-unusuable files
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                $initialOffset = $info['avdataoffset'];
+
+                if (!$this->getOnlyMPEGaudioInfo($info['avdataoffset'])) {
+                        if ($this->allow_bruteforce) {
+                                $info['error'][] = 'Rescanning file in BruteForce mode';
+                                $this->getOnlyMPEGaudioInfoBruteForce($this->getid3->fp, $info);
+                        }
+                }
+
+
+                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) && ($info['avdataoffset'] != $initialOffset)))) {
+
+                        $synchoffsetwarning = 'Unknown data before synch ';
+                        if (isset($info['id3v2']['headerlength'])) {
+                                $synchoffsetwarning .= '(ID3v2 header ends at '.$info['id3v2']['headerlength'].', then '.($info['avdataoffset'] - $info['id3v2']['headerlength']).' bytes garbage, ';
+                        } elseif ($initialOffset > 0) {
+                                $synchoffsetwarning .= '(should be at '.$initialOffset.', ';
+                        } else {
+                                $synchoffsetwarning .= '(should be at beginning of file, ';
+                        }
+                        $synchoffsetwarning .= 'synch detected at '.$info['avdataoffset'].')';
+                        if (isset($info['audio']['bitrate_mode']) && ($info['audio']['bitrate_mode'] == 'cbr')) {
+
+                                if (!empty($info['id3v2']['headerlength']) && (($info['avdataoffset'] - $info['id3v2']['headerlength']) == $info['mpeg']['audio']['framelength'])) {
+
+                                        $synchoffsetwarning .= '. This is a known problem with some versions of LAME (3.90-3.92) DLL in CBR mode.';
+                                        $info['audio']['codec'] = 'LAME';
+                                        $CurrentDataLAMEversionString = 'LAME3.';
+
+                                } elseif (empty($info['id3v2']['headerlength']) && ($info['avdataoffset'] == $info['mpeg']['audio']['framelength'])) {
+
+                                        $synchoffsetwarning .= '. This is a known problem with some versions of LAME (3.90 - 3.92) DLL in CBR mode.';
+                                        $info['audio']['codec'] = 'LAME';
+                                        $CurrentDataLAMEversionString = 'LAME3.';
+
+                                }
+
+                        }
+                        $info['warning'][] = $synchoffsetwarning;
+
+                }
+
+                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");
+                        }
+                }
+
+                $CurrentDataLAMEversionString = (!empty($CurrentDataLAMEversionString) ? $CurrentDataLAMEversionString : (isset($info['audio']['encoder']) ? $info['audio']['encoder'] : ''));
+                if (!empty($CurrentDataLAMEversionString) && (substr($CurrentDataLAMEversionString, 0, 6) == 'LAME3.') && !preg_match('[0-9\)]', substr($CurrentDataLAMEversionString, -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
+                        $PossiblyLongerLAMEversion_FrameLength = 1441;
+
+                        // Not sure what version of LAME this is - look in padding of last frame for longer version string
+                        $PossibleLAMEversionStringOffset = $info['avdataend'] - $PossiblyLongerLAMEversion_FrameLength;
+                        fseek($this->getid3->fp, $PossibleLAMEversionStringOffset);
+                        $PossiblyLongerLAMEversion_Data = fread($this->getid3->fp, $PossiblyLongerLAMEversion_FrameLength);
+                        switch (substr($CurrentDataLAMEversionString, -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
+                                        $CurrentDataLAMEversionString = substr($CurrentDataLAMEversionString, 0, -1);
+                                        break;
+                        }
+                        if (($PossiblyLongerLAMEversion_String = strstr($PossiblyLongerLAMEversion_Data, $CurrentDataLAMEversionString)) !== false) {
+                                if (substr($PossiblyLongerLAMEversion_String, 0, strlen($CurrentDataLAMEversionString)) == $CurrentDataLAMEversionString) {
+                                        $PossiblyLongerLAMEversion_NewString = substr($PossiblyLongerLAMEversion_String, 0, strspn($PossiblyLongerLAMEversion_String, 'LAME0123456789., (abcdefghijklmnopqrstuvwxyzJFSOND)')); //"LAME3.90.3"  "LAME3.87 (beta 1, Sep 27 2000)" "LAME3.88 (beta)"
+                                        if (empty($info['audio']['encoder']) || (strlen($PossiblyLongerLAMEversion_NewString) > strlen($info['audio']['encoder']))) {
+                                                $info['audio']['encoder'] = $PossiblyLongerLAMEversion_NewString;
+                                        }
+                                }
+                        }
+                }
+                if (!empty($info['audio']['encoder'])) {
+                        $info['audio']['encoder'] = rtrim($info['audio']['encoder'], "\x00 ");
+                }
+
+                switch (isset($info['mpeg']['audio']['layer']) ? $info['mpeg']['audio']['layer'] : '') {
+                        case 1:
+                        case 2:
+                                $info['audio']['dataformat'] = 'mp'.$info['mpeg']['audio']['layer'];
+                                break;
+                }
+                if (isset($info['fileformat']) && ($info['fileformat'] == 'mp3')) {
+                        switch ($info['audio']['dataformat']) {
+                                case 'mp1':
+                                case 'mp2':
+                                case 'mp3':
+                                        $info['fileformat'] = $info['audio']['dataformat'];
+                                        break;
+
+                                default:
+                                        $info['warning'][] = 'Expecting [audio][dataformat] to be mp1/mp2/mp3 when fileformat == mp3, [audio][dataformat] actually "'.$info['audio']['dataformat'].'"';
+                                        break;
+                        }
+                }
+
+                if (empty($info['fileformat'])) {
+                        unset($info['fileformat']);
+                        unset($info['audio']['bitrate_mode']);
+                        unset($info['avdataoffset']);
+                        unset($info['avdataend']);
+                        return false;
+                }
+
+                $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'] = $this->GuessEncoderOptions();
+
+                return true;
+        }
+
+
+        public function GuessEncoderOptions() {
+                // shortcuts
+                $info = &$this->getid3->info;
+                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 $NamedPresetBitrates = array(16, 24, 40, 56, 112, 128, 160, 192, 256);
+
+                if (isset($thisfile_mpeg_audio['VBR_method']) && ($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'], $NamedPresetBitrates))) {
+
+                        $encoder_options = $thisfile_mpeg_audio_lame['preset_used'];
+
+                } elseif (!empty($thisfile_mpeg_audio_lame['vbr_quality'])) {
+
+                        static $KnownEncoderValues = array();
+                        if (empty($KnownEncoderValues)) {
+
+                                //$KnownEncoderValues[abrbitrate_minbitrate][vbr_quality][raw_vbr_method][raw_noise_shaping][raw_stereo_mode][ath_type][lowpass_frequency] = 'preset name';
+                                $KnownEncoderValues[0xFF][58][1][1][3][2][20500] = '--alt-preset insane';        // 3.90,   3.90.1, 3.92
+                                $KnownEncoderValues[0xFF][58][1][1][3][2][20600] = '--alt-preset insane';        // 3.90.2, 3.90.3, 3.91
+                                $KnownEncoderValues[0xFF][57][1][1][3][4][20500] = '--alt-preset insane';        // 3.94,   3.95
+                                $KnownEncoderValues['**'][78][3][2][3][2][19500] = '--alt-preset extreme';       // 3.90,   3.90.1, 3.92
+                                $KnownEncoderValues['**'][78][3][2][3][2][19600] = '--alt-preset extreme';       // 3.90.2, 3.91
+                                $KnownEncoderValues['**'][78][3][1][3][2][19600] = '--alt-preset extreme';       // 3.90.3
+                                $KnownEncoderValues['**'][78][4][2][3][2][19500] = '--alt-preset fast extreme';  // 3.90,   3.90.1, 3.92
+                                $KnownEncoderValues['**'][78][4][2][3][2][19600] = '--alt-preset fast extreme';  // 3.90.2, 3.90.3, 3.91
+                                $KnownEncoderValues['**'][78][3][2][3][4][19000] = '--alt-preset standard';      // 3.90,   3.90.1, 3.90.2, 3.91, 3.92
+                                $KnownEncoderValues['**'][78][3][1][3][4][19000] = '--alt-preset standard';      // 3.90.3
+                                $KnownEncoderValues['**'][78][4][2][3][4][19000] = '--alt-preset fast standard'; // 3.90,   3.90.1, 3.90.2, 3.91, 3.92
+                                $KnownEncoderValues['**'][78][4][1][3][4][19000] = '--alt-preset fast standard'; // 3.90.3
+                                $KnownEncoderValues['**'][88][4][1][3][3][19500] = '--r3mix';                    // 3.90,   3.90.1, 3.92
+                                $KnownEncoderValues['**'][88][4][1][3][3][19600] = '--r3mix';                    // 3.90.2, 3.90.3, 3.91
+                                $KnownEncoderValues['**'][67][4][1][3][4][18000] = '--r3mix';                    // 3.94,   3.95
+                                $KnownEncoderValues['**'][68][3][2][3][4][18000] = '--alt-preset medium';        // 3.90.3
+                                $KnownEncoderValues['**'][68][4][2][3][4][18000] = '--alt-preset fast medium';   // 3.90.3
+
+                                $KnownEncoderValues[0xFF][99][1][1][1][2][0]     = '--preset studio';            // 3.90,   3.90.1, 3.90.2, 3.91, 3.92
+                                $KnownEncoderValues[0xFF][58][2][1][3][2][20600] = '--preset studio';            // 3.90.3, 3.93.1
+                                $KnownEncoderValues[0xFF][58][2][1][3][2][20500] = '--preset studio';            // 3.93
+                                $KnownEncoderValues[0xFF][57][2][1][3][4][20500] = '--preset studio';            // 3.94,   3.95
+                                $KnownEncoderValues[0xC0][88][1][1][1][2][0]     = '--preset cd';                // 3.90,   3.90.1, 3.90.2,   3.91, 3.92
+                                $KnownEncoderValues[0xC0][58][2][2][3][2][19600] = '--preset cd';                // 3.90.3, 3.93.1
+                                $KnownEncoderValues[0xC0][58][2][2][3][2][19500] = '--preset cd';                // 3.93
+                                $KnownEncoderValues[0xC0][57][2][1][3][4][19500] = '--preset cd';                // 3.94,   3.95
+                                $KnownEncoderValues[0xA0][78][1][1][3][2][18000] = '--preset hifi';              // 3.90,   3.90.1, 3.90.2,   3.91, 3.92
+                                $KnownEncoderValues[0xA0][58][2][2][3][2][18000] = '--preset hifi';              // 3.90.3, 3.93,   3.93.1
+                                $KnownEncoderValues[0xA0][57][2][1][3][4][18000] = '--preset hifi';              // 3.94,   3.95
+                                $KnownEncoderValues[0x80][67][1][1][3][2][18000] = '--preset tape';              // 3.90,   3.90.1, 3.90.2,   3.91, 3.92
+                                $KnownEncoderValues[0x80][67][1][1][3][2][15000] = '--preset radio';             // 3.90,   3.90.1, 3.90.2,   3.91, 3.92
+                                $KnownEncoderValues[0x70][67][1][1][3][2][15000] = '--preset fm';                // 3.90,   3.90.1, 3.90.2,   3.91, 3.92
+                                $KnownEncoderValues[0x70][58][2][2][3][2][16000] = '--preset tape/radio/fm';     // 3.90.3, 3.93,   3.93.1
+                                $KnownEncoderValues[0x70][57][2][1][3][4][16000] = '--preset tape/radio/fm';     // 3.94,   3.95
+                                $KnownEncoderValues[0x38][58][2][2][0][2][10000] = '--preset voice';             // 3.90.3, 3.93,   3.93.1
+                                $KnownEncoderValues[0x38][57][2][1][0][4][15000] = '--preset voice';             // 3.94,   3.95
+                                $KnownEncoderValues[0x38][57][2][1][0][4][16000] = '--preset voice';             // 3.94a14
+                                $KnownEncoderValues[0x28][65][1][1][0][2][7500]  = '--preset mw-us';             // 3.90,   3.90.1, 3.92
+                                $KnownEncoderValues[0x28][65][1][1][0][2][7600]  = '--preset mw-us';             // 3.90.2, 3.91
+                                $KnownEncoderValues[0x28][58][2][2][0][2][7000]  = '--preset mw-us';             // 3.90.3, 3.93,   3.93.1
+                                $KnownEncoderValues[0x28][57][2][1][0][4][10500] = '--preset mw-us';             // 3.94,   3.95
+                                $KnownEncoderValues[0x28][57][2][1][0][4][11200] = '--preset mw-us';             // 3.94a14
+                                $KnownEncoderValues[0x28][57][2][1][0][4][8800]  = '--preset mw-us';             // 3.94a15
+                                $KnownEncoderValues[0x18][58][2][2][0][2][4000]  = '--preset phon+/lw/mw-eu/sw'; // 3.90.3, 3.93.1
+                                $KnownEncoderValues[0x18][58][2][2][0][2][3900]  = '--preset phon+/lw/mw-eu/sw'; // 3.93
+                                $KnownEncoderValues[0x18][57][2][1][0][4][5900]  = '--preset phon+/lw/mw-eu/sw'; // 3.94,   3.95
+                                $KnownEncoderValues[0x18][57][2][1][0][4][6200]  = '--preset phon+/lw/mw-eu/sw'; // 3.94a14
+                                $KnownEncoderValues[0x18][57][2][1][0][4][3200]  = '--preset phon+/lw/mw-eu/sw'; // 3.94a15
+                                $KnownEncoderValues[0x10][58][2][2][0][2][3800]  = '--preset phone';             // 3.90.3, 3.93.1
+                                $KnownEncoderValues[0x10][58][2][2][0][2][3700]  = '--preset phone';             // 3.93
+                                $KnownEncoderValues[0x10][57][2][1][0][4][5600]  = '--preset phone';             // 3.94,   3.95
+                        }
+
+                        if (isset($KnownEncoderValues[$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 = $KnownEncoderValues[$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($KnownEncoderValues['**'][$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 = $KnownEncoderValues['**'][$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 (!empty($thisfile_mpeg_audio_lame['encoding_flags']['nogap_prev']) || !empty($thisfile_mpeg_audio_lame['encoding_flags']['nogap_next'])) {
+                        $encoder_options .= ' --nogap';
+                }
+
+                if (!empty($thisfile_mpeg_audio_lame['lowpass_frequency'])) {
+                        $ExplodedOptions = explode(' ', $encoder_options, 4);
+                        if ($ExplodedOptions[0] == '--r3mix') {
+                                $ExplodedOptions[1] = 'r3mix';
+                        }
+                        switch ($ExplodedOptions[0]) {
+                                case '--preset':
+                                case '--alt-preset':
+                                case '--r3mix':
+                                        if ($ExplodedOptions[1] == 'fast') {
+                                                $ExplodedOptions[1] .= ' '.$ExplodedOptions[2];
+                                        }
+                                        switch ($ExplodedOptions[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 $ExpectedLowpass = 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($ExpectedLowpass[$ExplodedOptions[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+
+                                                $ExplodedOptions = explode(' ', $encoder_options, 4);
+                                                switch ($ExplodedOptions[0]) {
+                                                        case '--preset':
+                                                        case '--alt-preset':
+                                                                switch ($ExplodedOptions[1]) {
+                                                                        case 'fast':
+                                                                        case 'portable':
+                                                                        case 'medium':
+                                                                        case 'standard':
+                                                                        case 'extreme':
+                                                                        case 'insane':
+                                                                                $encoder_options .= ' --resample '.$thisfile_mpeg_audio['sample_rate'];
+                                                                                break;
+
+                                                                        default:
+                                                                                static $ExpectedResampledRate = 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($ExpectedResampledRate[$ExplodedOptions[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($offset, &$info, $recursivesearch=true, $ScanAsCBR=false, $FastMPEGheaderScan=false) {
+                static $MPEGaudioVersionLookup;
+                static $MPEGaudioLayerLookup;
+                static $MPEGaudioBitrateLookup;
+                static $MPEGaudioFrequencyLookup;
+                static $MPEGaudioChannelModeLookup;
+                static $MPEGaudioModeExtensionLookup;
+                static $MPEGaudioEmphasisLookup;
+                if (empty($MPEGaudioVersionLookup)) {
+                        $MPEGaudioVersionLookup       = self::MPEGaudioVersionArray();
+                        $MPEGaudioLayerLookup         = self::MPEGaudioLayerArray();
+                        $MPEGaudioBitrateLookup       = self::MPEGaudioBitrateArray();
+                        $MPEGaudioFrequencyLookup     = self::MPEGaudioFrequencyArray();
+                        $MPEGaudioChannelModeLookup   = self::MPEGaudioChannelModeArray();
+                        $MPEGaudioModeExtensionLookup = self::MPEGaudioModeExtensionArray();
+                        $MPEGaudioEmphasisLookup      = self::MPEGaudioEmphasisArray();
+                }
+
+                if (fseek($this->getid3->fp, $offset, SEEK_SET) != 0) {
+                        $info['error'][] = 'decodeMPEGaudioHeader() failed to seek to next offset at '.$offset;
+                        return false;
+                }
+                //$headerstring = fread($this->getid3->fp, 1441); // worst-case max length = 32kHz @ 320kbps layer 3 = 1441 bytes/frame
+                $headerstring = fread($this->getid3->fp, 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($headerstring, 0, 4);
+
+                static $MPEGaudioHeaderDecodeCache = array();
+                if (isset($MPEGaudioHeaderDecodeCache[$head4])) {
+                        $MPEGheaderRawArray = $MPEGaudioHeaderDecodeCache[$head4];
+                } else {
+                        $MPEGheaderRawArray = self::MPEGaudioHeaderDecode($head4);
+                        $MPEGaudioHeaderDecodeCache[$head4] = $MPEGheaderRawArray;
+                }
+
+                static $MPEGaudioHeaderValidCache = array();
+                if (!isset($MPEGaudioHeaderValidCache[$head4])) { // Not in cache
+                        //$MPEGaudioHeaderValidCache[$head4] = self::MPEGaudioHeaderValid($MPEGheaderRawArray, false, true);  // allow badly-formatted freeformat (from LAME 3.90 - 3.93.1)
+                        $MPEGaudioHeaderValidCache[$head4] = self::MPEGaudioHeaderValid($MPEGheaderRawArray, false, false);
+                }
+
+                // shortcut
+                if (!isset($info['mpeg']['audio'])) {
+                        $info['mpeg']['audio'] = array();
+                }
+                $thisfile_mpeg_audio = &$info['mpeg']['audio'];
+
+
+                if ($MPEGaudioHeaderValidCache[$head4]) {
+                        $thisfile_mpeg_audio['raw'] = $MPEGheaderRawArray;
+                } else {
+                        $info['error'][] = 'Invalid MPEG audio header ('.getid3_lib::PrintHexBytes($head4).') at offset '.$offset;
+                        return false;
+                }
+
+                if (!$FastMPEGheaderScan) {
+                        $thisfile_mpeg_audio['version']       = $MPEGaudioVersionLookup[$thisfile_mpeg_audio['raw']['version']];
+                        $thisfile_mpeg_audio['layer']         = $MPEGaudioLayerLookup[$thisfile_mpeg_audio['raw']['layer']];
+
+                        $thisfile_mpeg_audio['channelmode']   = $MPEGaudioChannelModeLookup[$thisfile_mpeg_audio['raw']['channelmode']];
+                        $thisfile_mpeg_audio['channels']      = (($thisfile_mpeg_audio['channelmode'] == 'mono') ? 1 : 2);
+                        $thisfile_mpeg_audio['sample_rate']   = $MPEGaudioFrequencyLookup[$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'] = $MPEGaudioModeExtensionLookup[$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']      = $MPEGaudioEmphasisLookup[$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($headerstring, 4, 2));
+                        }
+                }
+
+                if ($thisfile_mpeg_audio['raw']['bitrate'] == 15) {
+                        // http://www.hydrogenaudio.org/?act=ST&f=16&t=9682&st=0
+                        $info['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'] = $MPEGaudioBitrateLookup[$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
+                        $recursivesearch = false;
+                }
+
+                // For Layer 2 there are some combinations of bitrate and mode which are not allowed.
+                if (!$FastMPEGheaderScan && ($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 {
+                                                $info['error'][] = $thisfile_mpeg_audio['bitrate'].'kbps not allowed in Layer 2, '.$thisfile_mpeg_audio['channelmode'].'.';
+                                                return false;
+                                        }
+                                        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 {
+                                                $info['error'][] = intval(round($thisfile_mpeg_audio['bitrate'] / 1000)).'kbps not allowed in Layer 2, '.$thisfile_mpeg_audio['channelmode'].'.';
+                                                return false;
+                                        }
+                                        break;
+
+                        }
+
+                }
+
+
+                if ($info['audio']['sample_rate'] > 0) {
+                        $thisfile_mpeg_audio['framelength'] = self::MPEGaudioFrameLength($thisfile_mpeg_audio['bitrate'], $thisfile_mpeg_audio['version'], $thisfile_mpeg_audio['layer'], (int) $thisfile_mpeg_audio['padding'], $info['audio']['sample_rate']);
+                }
+
+                $nextframetestoffset = $offset + 1;
+                if ($thisfile_mpeg_audio['bitrate'] != 'free') {
+
+                        $info['audio']['bitrate'] = $thisfile_mpeg_audio['bitrate'];
+
+                        if (isset($thisfile_mpeg_audio['framelength'])) {
+                                $nextframetestoffset = $offset + $thisfile_mpeg_audio['framelength'];
+                        } else {
+                                $info['error'][] = 'Frame at offset('.$offset.') is has an invalid frame length.';
+                                return false;
+                        }
+
+                }
+
+                $ExpectedNumberOfAudioBytes = 0;
+
+                ////////////////////////////////////////////////////////////////////////////////////
+                // Variable-bitrate headers
+
+                if (substr($headerstring, 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';
+
+                        $SideInfoData = substr($headerstring, 4 + 2, 32);
+
+                        $FraunhoferVBROffset = 36;
+
+                        $thisfile_mpeg_audio['VBR_encoder_version']     = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset +  4, 2)); // VbriVersion
+                        $thisfile_mpeg_audio['VBR_encoder_delay']       = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset +  6, 2)); // VbriDelay
+                        $thisfile_mpeg_audio['VBR_quality']             = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset +  8, 2)); // VbriQuality
+                        $thisfile_mpeg_audio['VBR_bytes']               = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset + 10, 4)); // VbriStreamBytes
+                        $thisfile_mpeg_audio['VBR_frames']              = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset + 14, 4)); // VbriStreamFrames
+                        $thisfile_mpeg_audio['VBR_seek_offsets']        = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset + 18, 2)); // VbriTableSize
+                        $thisfile_mpeg_audio['VBR_seek_scale']          = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset + 20, 2)); // VbriTableScale
+                        $thisfile_mpeg_audio['VBR_entry_bytes']         = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset + 22, 2)); // VbriEntryBytes
+                        $thisfile_mpeg_audio['VBR_entry_frames']        = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset + 24, 2)); // VbriEntryFrames
+
+                        $ExpectedNumberOfAudioBytes = $thisfile_mpeg_audio['VBR_bytes'];
+
+                        $previousbyteoffset = $offset;
+                        for ($i = 0; $i < $thisfile_mpeg_audio['VBR_seek_offsets']; $i++) {
+                                $Fraunhofer_OffsetN = getid3_lib::BigEndian2Int(substr($headerstring, $FraunhoferVBROffset, $thisfile_mpeg_audio['VBR_entry_bytes']));
+                                $FraunhoferVBROffset += $thisfile_mpeg_audio['VBR_entry_bytes'];
+                                $thisfile_mpeg_audio['VBR_offsets_relative'][$i] = ($Fraunhofer_OffsetN * $thisfile_mpeg_audio['VBR_seek_scale']);
+                                $thisfile_mpeg_audio['VBR_offsets_absolute'][$i] = ($Fraunhofer_OffsetN * $thisfile_mpeg_audio['VBR_seek_scale']) + $previousbyteoffset;
+                                $previousbyteoffset += $Fraunhofer_OffsetN;
+                        }
+
+
+                } 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
+
+                        $VBRidOffset = self::XingVBRidOffset($thisfile_mpeg_audio['version'], $thisfile_mpeg_audio['channelmode']);
+                        $SideInfoData = substr($headerstring, 4 + 2, $VBRidOffset - 4);
+
+                        if ((substr($headerstring, $VBRidOffset, strlen('Xing')) == 'Xing') || (substr($headerstring, $VBRidOffset, 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
+//                              if (substr($headerstring, $VBRidOffset, strlen('Info')) == 'Xing') {
+                                        $thisfile_mpeg_audio['bitrate_mode'] = 'vbr';
+                                        $thisfile_mpeg_audio['VBR_method']   = 'Xing';
+//                              } else {
+//                                      $ScanAsCBR = true;
+//                                      $thisfile_mpeg_audio['bitrate_mode'] = 'cbr';
+//                              }
+
+                                $thisfile_mpeg_audio['xing_flags_raw'] = getid3_lib::BigEndian2Int(substr($headerstring, $VBRidOffset + 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($headerstring, $VBRidOffset +  8, 4));
+                                        //$thisfile_mpeg_audio['VBR_frames']--; // don't count header Xing/Info frame
+                                }
+                                if ($thisfile_mpeg_audio['xing_flags']['bytes']) {
+                                        $thisfile_mpeg_audio['VBR_bytes']  = getid3_lib::BigEndian2Int(substr($headerstring, $VBRidOffset + 12, 4));
+                                }
+
+                                //if (($thisfile_mpeg_audio['bitrate'] == 'free') && !empty($thisfile_mpeg_audio['VBR_frames']) && !empty($thisfile_mpeg_audio['VBR_bytes'])) {
+                                if (!empty($thisfile_mpeg_audio['VBR_frames']) && !empty($thisfile_mpeg_audio['VBR_bytes'])) {
+
+                                        $framelengthfloat = $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'] = ((($framelengthfloat / 4) - intval($thisfile_mpeg_audio['padding'])) * $thisfile_mpeg_audio['sample_rate']) / 12;
+                                                $info['audio']['bitrate'] = ($framelengthfloat / 4) * $thisfile_mpeg_audio['sample_rate'] * (2 / $info['audio']['channels']) / 12;
+                                        } else {
+                                                // Bitrate = ((FrameLengthInBytes - Padding) * SampleRate) / 144
+                                                //$info['audio']['bitrate'] = (($framelengthfloat - intval($thisfile_mpeg_audio['padding'])) * $thisfile_mpeg_audio['sample_rate']) / 144;
+                                                $info['audio']['bitrate'] = $framelengthfloat * $thisfile_mpeg_audio['sample_rate'] * (2 / $info['audio']['channels']) / 144;
+                                        }
+                                        $thisfile_mpeg_audio['framelength'] = floor($framelengthfloat);
+                                }
+
+                                if ($thisfile_mpeg_audio['xing_flags']['toc']) {
+                                        $LAMEtocData = substr($headerstring, $VBRidOffset + 16, 100);
+                                        for ($i = 0; $i < 100; $i++) {
+                                                $thisfile_mpeg_audio['toc'][$i] = ord($LAMEtocData{$i});
+                                        }
+                                }
+                                if ($thisfile_mpeg_audio['xing_flags']['vbr_scale']) {
+                                        $thisfile_mpeg_audio['VBR_scale'] = getid3_lib::BigEndian2Int(substr($headerstring, $VBRidOffset + 116, 4));
+                                }
+
+
+                                // http://gabriel.mp3-tech.org/mp3infotag.html
+                                if (substr($headerstring, $VBRidOffset + 120, 4) == 'LAME') {
+
+                                        // shortcut
+                                        $thisfile_mpeg_audio['LAME'] = array();
+                                        $thisfile_mpeg_audio_lame    = &$thisfile_mpeg_audio['LAME'];
+
+
+                                        $thisfile_mpeg_audio_lame['long_version']  = substr($headerstring, $VBRidOffset + 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
+                                                $LAMEtagOffsetContant = $VBRidOffset - 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($headerstring, $LAMEtagOffsetContant + 0x9B, 1));
+
+                                                // bytes $9C-$A4  Encoder short VersionString
+                                                $thisfile_mpeg_audio_lame['short_version'] = substr($headerstring, $LAMEtagOffsetContant + 0x9C, 9);
+
+                                                // byte $A5  Info Tag revision + VBR method
+                                                $LAMEtagRevisionVBRmethod = getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 0xA5, 1));
+
+                                                $thisfile_mpeg_audio_lame['tag_revision']   = ($LAMEtagRevisionVBRmethod & 0xF0) >> 4;
+                                                $thisfile_mpeg_audio_lame_raw['vbr_method'] =  $LAMEtagRevisionVBRmethod & 0x0F;
+                                                $thisfile_mpeg_audio_lame['vbr_method']     = self::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($headerstring, $LAMEtagOffsetContant + 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($headerstring, $LAMEtagOffsetContant + 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($headerstring, $LAMEtagOffsetContant + 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'] = getid3_lib::RGADamplitude2dB($thisfile_mpeg_audio_lame_RGAD['peak_amplitude']);
+                                                }
+
+                                                $thisfile_mpeg_audio_lame_raw['RGAD_track']      =   getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 0xAB, 2));
+                                                $thisfile_mpeg_audio_lame_raw['RGAD_album']      =   getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 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::RGADnameLookup($thisfile_mpeg_audio_lame_RGAD_track['raw']['name']);
+                                                        $thisfile_mpeg_audio_lame_RGAD_track['originator'] = getid3_lib::RGADoriginatorLookup($thisfile_mpeg_audio_lame_RGAD_track['raw']['originator']);
+                                                        $thisfile_mpeg_audio_lame_RGAD_track['gain_db']    = getid3_lib::RGADadjustmentLookup($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::RGADnameLookup($thisfile_mpeg_audio_lame_RGAD_album['raw']['name']);
+                                                        $thisfile_mpeg_audio_lame_RGAD_album['originator'] = getid3_lib::RGADoriginatorLookup($thisfile_mpeg_audio_lame_RGAD_album['raw']['originator']);
+                                                        $thisfile_mpeg_audio_lame_RGAD_album['gain_db']    = getid3_lib::RGADadjustmentLookup($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
+                                                $EncodingFlagsATHtype = getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 0xAF, 1));
+                                                $thisfile_mpeg_audio_lame['encoding_flags']['nspsytune']   = (bool) ($EncodingFlagsATHtype & 0x10);
+                                                $thisfile_mpeg_audio_lame['encoding_flags']['nssafejoint'] = (bool) ($EncodingFlagsATHtype & 0x20);
+                                                $thisfile_mpeg_audio_lame['encoding_flags']['nogap_next']  = (bool) ($EncodingFlagsATHtype & 0x40);
+                                                $thisfile_mpeg_audio_lame['encoding_flags']['nogap_prev']  = (bool) ($EncodingFlagsATHtype & 0x80);
+                                                $thisfile_mpeg_audio_lame['ath_type']                      =         $EncodingFlagsATHtype & 0x0F;
+
+                                                // byte $B0  if ABR {specified bitrate} else {minimal bitrate}
+                                                $thisfile_mpeg_audio_lame['raw']['abrbitrate_minbitrate'] = getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 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
+                                                $EncoderDelays = getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 0xB1, 3));
+                                                $thisfile_mpeg_audio_lame['encoder_delay'] = ($EncoderDelays & 0xFFF000) >> 12;
+                                                $thisfile_mpeg_audio_lame['end_padding']   =  $EncoderDelays & 0x000FFF;
+
+                                                // byte $B4  Misc
+                                                $MiscByte = getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 0xB4, 1));
+                                                $thisfile_mpeg_audio_lame_raw['noise_shaping']       = ($MiscByte & 0x03);
+                                                $thisfile_mpeg_audio_lame_raw['stereo_mode']         = ($MiscByte & 0x1C) >> 2;
+                                                $thisfile_mpeg_audio_lame_raw['not_optimal_quality'] = ($MiscByte & 0x20) >> 5;
+                                                $thisfile_mpeg_audio_lame_raw['source_sample_freq']  = ($MiscByte & 0xC0) >> 6;
+                                                $thisfile_mpeg_audio_lame['noise_shaping']       = $thisfile_mpeg_audio_lame_raw['noise_shaping'];
+                                                $thisfile_mpeg_audio_lame['stereo_mode']         = self::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']  = self::LAMEmiscSourceSampleFrequencyLookup($thisfile_mpeg_audio_lame_raw['source_sample_freq']);
+
+                                                // byte $B5  MP3 Gain
+                                                $thisfile_mpeg_audio_lame_raw['mp3_gain'] = getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 0xB5, 1), false, true);
+                                                $thisfile_mpeg_audio_lame['mp3_gain_db']     = (getid3_lib::RGADamplitude2dB(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($headerstring, $LAMEtagOffsetContant + 0xB6, 2));
+                                                // Reserved                                                    = ($PresetSurroundBytes & 0xC000);
+                                                $thisfile_mpeg_audio_lame_raw['surround_info'] = ($PresetSurroundBytes & 0x3800);
+                                                $thisfile_mpeg_audio_lame['surround_info']     = self::LAMEsurroundInfoLookup($thisfile_mpeg_audio_lame_raw['surround_info']);
+                                                $thisfile_mpeg_audio_lame['preset_used_id']    = ($PresetSurroundBytes & 0x07FF);
+                                                $thisfile_mpeg_audio_lame['preset_used']       = self::LAMEpresetUsedLookup($thisfile_mpeg_audio_lame);
+                                                if (!empty($thisfile_mpeg_audio_lame['preset_used_id']) && empty($thisfile_mpeg_audio_lame['preset_used'])) {
+                                                        $info['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($headerstring, $LAMEtagOffsetContant + 0xB8, 4));
+                                                $ExpectedNumberOfAudioBytes = (($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($headerstring, $LAMEtagOffsetContant + 0xBC, 2));
+
+                                                // bytes $BE-$BF  CRC-16 of Info Tag
+                                                $thisfile_mpeg_audio_lame['lame_tag_crc'] = getid3_lib::BigEndian2Int(substr($headerstring, $LAMEtagOffsetContant + 0xBE, 2));
+
+
+                                                // LAME CBR
+                                                if ($thisfile_mpeg_audio_lame_raw['vbr_method'] == 1) {
+
+                                                        $thisfile_mpeg_audio['bitrate_mode'] = 'cbr';
+                                                        $thisfile_mpeg_audio['bitrate'] = self::ClosestStandardMP3Bitrate($thisfile_mpeg_audio['bitrate']);
+                                                        $info['audio']['bitrate'] = $thisfile_mpeg_audio['bitrate'];
+                                                        //if (empty($thisfile_mpeg_audio['bitrate']) || (!empty($thisfile_mpeg_audio_lame['bitrate_min']) && ($thisfile_mpeg_audio_lame['bitrate_min'] != 255))) {
+                                                        //      $thisfile_mpeg_audio['bitrate'] = $thisfile_mpeg_audio_lame['bitrate_min'];
+                                                        //}
+
+                                                }
+
+                                        }
+                                }
+
+                        } else {
+
+                                // not Fraunhofer or Xing VBR methods, most likely CBR (but could be VBR with no header)
+                                $thisfile_mpeg_audio['bitrate_mode'] = 'cbr';
+                                if ($recursivesearch) {
+                                        $thisfile_mpeg_audio['bitrate_mode'] = 'vbr';
+                                        if ($this->RecursiveFrameScanning($offset, $nextframetestoffset, true)) {
+                                                $recursivesearch = false;
+                                                $thisfile_mpeg_audio['bitrate_mode'] = 'cbr';
+                                        }
+                                        if ($thisfile_mpeg_audio['bitrate_mode'] == 'vbr') {
+                                                $info['warning'][] = 'VBR file with no VBR header. Bitrate values calculated from actual frame bitrates.';
+                                        }
+                                }
+
+                        }
+
+                }
+
+                if (($ExpectedNumberOfAudioBytes > 0) && ($ExpectedNumberOfAudioBytes != ($info['avdataend'] - $info['avdataoffset']))) {
+                        if ($ExpectedNumberOfAudioBytes > ($info['avdataend'] - $info['avdataoffset'])) {
+                                if (isset($info['fileformat']) && ($info['fileformat'] == 'riff')) {
+                                        // ignore, audio data is broken into chunks so will always be data "missing"
+                                } elseif (($ExpectedNumberOfAudioBytes - ($info['avdataend'] - $info['avdataoffset'])) == 1) {
+                                        $info['warning'][] = 'Last byte of data truncated (this is a known bug in Meracl ID3 Tag Writer before v1.3.5)';
+                                } else {
+                                        $info['warning'][] = 'Probable truncated file: expecting '.$ExpectedNumberOfAudioBytes.' bytes of audio data, only found '.($info['avdataend'] - $info['avdataoffset']).' (short by '.($ExpectedNumberOfAudioBytes - ($info['avdataend'] - $info['avdataoffset'])).' bytes)';
+                                }
+                        } else {
+                                if ((($info['avdataend'] - $info['avdataoffset']) - $ExpectedNumberOfAudioBytes) == 1) {
+                                //      $prenullbytefileoffset = ftell($this->getid3->fp);
+                                //      fseek($this->getid3->fp, $info['avdataend'], SEEK_SET);
+                                //      $PossibleNullByte = fread($this->getid3->fp, 1);
+                                //      fseek($this->getid3->fp, $prenullbytefileoffset, SEEK_SET);
+                                //      if ($PossibleNullByte === "\x00") {
+                                                $info['avdataend']--;
+                                //              $info['warning'][] = 'Extra null byte at end of MP3 data assumed to be RIFF padding and therefore ignored';
+                                //      } else {
+                                //              $info['warning'][] = 'Too much data in file: expecting '.$ExpectedNumberOfAudioBytes.' bytes of audio data, found '.($info['avdataend'] - $info['avdataoffset']).' ('.(($info['avdataend'] - $info['avdataoffset']) - $ExpectedNumberOfAudioBytes).' bytes too many)';
+                                //      }
+                                } else {
+                                        $info['warning'][] = 'Too much data in file: expecting '.$ExpectedNumberOfAudioBytes.' bytes of audio data, found '.($info['avdataend'] - $info['avdataoffset']).' ('.(($info['avdataend'] - $info['avdataoffset']) - $ExpectedNumberOfAudioBytes).' bytes too many)';
+                                }
+                        }
+                }
+
+                if (($thisfile_mpeg_audio['bitrate'] == 'free') && empty($info['audio']['bitrate'])) {
+                        if (($offset == $info['avdataoffset']) && empty($thisfile_mpeg_audio['VBR_frames'])) {
+                                $framebytelength = $this->FreeFormatFrameLength($offset, true);
+                                if ($framebytelength > 0) {
+                                        $thisfile_mpeg_audio['framelength'] = $framebytelength;
+                                        if ($thisfile_mpeg_audio['layer'] == '1') {
+                                                // BitRate = (((FrameLengthInBytes / 4) - Padding) * SampleRate) / 12
+                                                $info['audio']['bitrate'] = ((($framebytelength / 4) - intval($thisfile_mpeg_audio['padding'])) * $thisfile_mpeg_audio['sample_rate']) / 12;
+                                        } else {
+                                                // Bitrate = ((FrameLengthInBytes - Padding) * SampleRate) / 144
+                                                $info['audio']['bitrate'] = (($framebytelength - intval($thisfile_mpeg_audio['padding'])) * $thisfile_mpeg_audio['sample_rate']) / 144;
+                                        }
+                                } else {
+                                        $info['error'][] = 'Error calculating frame length of free-format MP3 without Xing/LAME header';
+                                }
+                        }
+                }
+
+                if (isset($thisfile_mpeg_audio['VBR_frames']) ? $thisfile_mpeg_audio['VBR_frames'] : '') {
+                        switch ($thisfile_mpeg_audio['bitrate_mode']) {
+                                case 'vbr':
+                                case 'abr':
+                                        $bytes_per_frame = 1152;
+                                        if (($thisfile_mpeg_audio['version'] == '1') && ($thisfile_mpeg_audio['layer'] == 1)) {
+                                                $bytes_per_frame = 384;
+                                        } elseif ((($thisfile_mpeg_audio['version'] == '2') || ($thisfile_mpeg_audio['version'] == '2.5')) && ($thisfile_mpeg_audio['layer'] == 3)) {
+                                                $bytes_per_frame = 576;
+                                        }
+                                        $thisfile_mpeg_audio['VBR_bitrate'] = (isset($thisfile_mpeg_audio['VBR_bytes']) ? (($thisfile_mpeg_audio['VBR_bytes'] / $thisfile_mpeg_audio['VBR_frames']) * 8) * ($info['audio']['sample_rate'] / $bytes_per_frame) : 0);
+                                        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 ($recursivesearch) {
+
+                        if (!$this->RecursiveFrameScanning($offset, $nextframetestoffset, $ScanAsCBR)) {
+                                return false;
+                        }
+
+                }
+
+
+                //if (false) {
+                //    // experimental side info parsing section - not returning anything useful yet
+                //
+                //    $SideInfoBitstream = getid3_lib::BigEndian2Bin($SideInfoData);
+                //    $SideInfoOffset = 0;
+                //
+                //    if ($thisfile_mpeg_audio['version'] == '1') {
+                //        if ($thisfile_mpeg_audio['channelmode'] == 'mono') {
+                //            // MPEG-1 (mono)
+                //            $thisfile_mpeg_audio['side_info']['main_data_begin'] = substr($SideInfoBitstream, $SideInfoOffset, 9);
+                //            $SideInfoOffset += 9;
+                //            $SideInfoOffset += 5;
+                //        } else {
+                //            // MPEG-1 (stereo, joint-stereo, dual-channel)
+                //            $thisfile_mpeg_audio['side_info']['main_data_begin'] = substr($SideInfoBitstream, $SideInfoOffset, 9);
+                //            $SideInfoOffset += 9;
+                //            $SideInfoOffset += 3;
+                //        }
+                //    } else { // 2 or 2.5
+                //        if ($thisfile_mpeg_audio['channelmode'] == 'mono') {
+                //            // MPEG-2, MPEG-2.5 (mono)
+                //            $thisfile_mpeg_audio['side_info']['main_data_begin'] = substr($SideInfoBitstream, $SideInfoOffset, 8);
+                //            $SideInfoOffset += 8;
+                //            $SideInfoOffset += 1;
+                //        } else {
+                //            // MPEG-2, MPEG-2.5 (stereo, joint-stereo, dual-channel)
+                //            $thisfile_mpeg_audio['side_info']['main_data_begin'] = substr($SideInfoBitstream, $SideInfoOffset, 8);
+                //            $SideInfoOffset += 8;
+                //            $SideInfoOffset += 2;
+                //        }
+                //    }
+                //
+                //    if ($thisfile_mpeg_audio['version'] == '1') {
+                //        for ($channel = 0; $channel < $info['audio']['channels']; $channel++) {
+                //            for ($scfsi_band = 0; $scfsi_band < 4; $scfsi_band++) {
+                //                $thisfile_mpeg_audio['scfsi'][$channel][$scfsi_band] = substr($SideInfoBitstream, $SideInfoOffset, 1);
+                //                $SideInfoOffset += 2;
+                //            }
+                //        }
+                //    }
+                //    for ($granule = 0; $granule < (($thisfile_mpeg_audio['version'] == '1') ? 2 : 1); $granule++) {
+                //        for ($channel = 0; $channel < $info['audio']['channels']; $channel++) {
+                //            $thisfile_mpeg_audio['part2_3_length'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 12);
+                //            $SideInfoOffset += 12;
+                //            $thisfile_mpeg_audio['big_values'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 9);
+                //            $SideInfoOffset += 9;
+                //            $thisfile_mpeg_audio['global_gain'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 8);
+                //            $SideInfoOffset += 8;
+                //            if ($thisfile_mpeg_audio['version'] == '1') {
+                //                $thisfile_mpeg_audio['scalefac_compress'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 4);
+                //                $SideInfoOffset += 4;
+                //            } else {
+                //                $thisfile_mpeg_audio['scalefac_compress'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 9);
+                //                $SideInfoOffset += 9;
+                //            }
+                //            $thisfile_mpeg_audio['window_switching_flag'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 1);
+                //            $SideInfoOffset += 1;
+                //
+                //            if ($thisfile_mpeg_audio['window_switching_flag'][$granule][$channel] == '1') {
+                //
+                //                $thisfile_mpeg_audio['block_type'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 2);
+                //                $SideInfoOffset += 2;
+                //                $thisfile_mpeg_audio['mixed_block_flag'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 1);
+                //                $SideInfoOffset += 1;
+                //
+                //                for ($region = 0; $region < 2; $region++) {
+                //                    $thisfile_mpeg_audio['table_select'][$granule][$channel][$region] = substr($SideInfoBitstream, $SideInfoOffset, 5);
+                //                    $SideInfoOffset += 5;
+                //                }
+                //                $thisfile_mpeg_audio['table_select'][$granule][$channel][2] = 0;
+                //
+                //                for ($window = 0; $window < 3; $window++) {
+                //                    $thisfile_mpeg_audio['subblock_gain'][$granule][$channel][$window] = substr($SideInfoBitstream, $SideInfoOffset, 3);
+                //                    $SideInfoOffset += 3;
+                //                }
+                //
+                //            } else {
+                //
+                //                for ($region = 0; $region < 3; $region++) {
+                //                    $thisfile_mpeg_audio['table_select'][$granule][$channel][$region] = substr($SideInfoBitstream, $SideInfoOffset, 5);
+                //                    $SideInfoOffset += 5;
+                //                }
+                //
+                //                $thisfile_mpeg_audio['region0_count'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 4);
+                //                $SideInfoOffset += 4;
+                //                $thisfile_mpeg_audio['region1_count'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 3);
+                //                $SideInfoOffset += 3;
+                //                $thisfile_mpeg_audio['block_type'][$granule][$channel] = 0;
+                //            }
+                //
+                //            if ($thisfile_mpeg_audio['version'] == '1') {
+                //                $thisfile_mpeg_audio['preflag'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 1);
+                //                $SideInfoOffset += 1;
+                //            }
+                //            $thisfile_mpeg_audio['scalefac_scale'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 1);
+                //            $SideInfoOffset += 1;
+                //            $thisfile_mpeg_audio['count1table_select'][$granule][$channel] = substr($SideInfoBitstream, $SideInfoOffset, 1);
+                //            $SideInfoOffset += 1;
+                //        }
+                //    }
+                //}
+
+                return true;
+        }
+
+        public function RecursiveFrameScanning(&$offset, &$nextframetestoffset, $ScanAsCBR) {
+                $info = &$this->getid3->info;
+                $firstframetestarray = array('error'=>'', 'warning'=>'', 'avdataend'=>$info['avdataend'], 'avdataoffset'=>$info['avdataoffset']);
+                $this->decodeMPEGaudioHeader($offset, $firstframetestarray, false);
+
+                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 (($nextframetestoffset + 4) >= $info['avdataend']) {
+                                // end of file
+                                return true;
+                        }
+
+                        $nextframetestarray = array('error'=>'', 'warning'=>'', 'avdataend'=>$info['avdataend'], 'avdataoffset'=>$info['avdataoffset']);
+                        if ($this->decodeMPEGaudioHeader($nextframetestoffset, $nextframetestarray, false)) {
+                                if ($ScanAsCBR) {
+                                        // 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($nextframetestarray['mpeg']['audio']['bitrate']) || !isset($firstframetestarray['mpeg']['audio']['bitrate']) || ($nextframetestarray['mpeg']['audio']['bitrate'] != $firstframetestarray['mpeg']['audio']['bitrate'])) {
+                                                return false;
+                                        }
+                                }
+
+
+                                // next frame is OK, get ready to check the one after that
+                                if (isset($nextframetestarray['mpeg']['audio']['framelength']) && ($nextframetestarray['mpeg']['audio']['framelength'] > 0)) {
+                                        $nextframetestoffset += $nextframetestarray['mpeg']['audio']['framelength'];
+                                } else {
+                                        $info['error'][] = 'Frame at offset ('.$offset.') is has an invalid frame length.';
+                                        return false;
+                                }
+
+                        } elseif (!empty($firstframetestarray['mpeg']['audio']['framelength']) && (($nextframetestoffset + $firstframetestarray['mpeg']['audio']['framelength']) > $info['avdataend'])) {
+
+                                // it's not the end of the file, but there's not enough data left for another frame, so assume it's garbage/padding and return OK
+                                return true;
+
+                        } else {
+
+                                // next frame is not valid, note the error and fail, so scanning can contiue for a valid frame sequence
+                                $info['warning'][] = 'Frame at offset ('.$offset.') is valid, but the next one at ('.$nextframetestoffset.') is not.';
+
+                                return false;
+                        }
+                }
+                return true;
+        }
+
+        public function FreeFormatFrameLength($offset, $deepscan=false) {
+                $info = &$this->getid3->info;
+
+                fseek($this->getid3->fp, $offset, SEEK_SET);
+                $MPEGaudioData = fread($this->getid3->fp, 32768);
+
+                $SyncPattern1 = substr($MPEGaudioData, 0, 4);
+                // may be different pattern due to padding
+                $SyncPattern2 = $SyncPattern1{0}.$SyncPattern1{1}.chr(ord($SyncPattern1{2}) | 0x02).$SyncPattern1{3};
+                if ($SyncPattern2 === $SyncPattern1) {
+                        $SyncPattern2 = $SyncPattern1{0}.$SyncPattern1{1}.chr(ord($SyncPattern1{2}) & 0xFD).$SyncPattern1{3};
+                }
+
+                $framelength = false;
+                $framelength1 = strpos($MPEGaudioData, $SyncPattern1, 4);
+                $framelength2 = strpos($MPEGaudioData, $SyncPattern2, 4);
+                if ($framelength1 > 4) {
+                        $framelength = $framelength1;
+                }
+                if (($framelength2 > 4) && ($framelength2 < $framelength1)) {
+                        $framelength = $framelength2;
+                }
+                if (!$framelength) {
+
+                        // LAME 3.88 has a different value for modeextension on the first frame vs the rest
+                        $framelength1 = strpos($MPEGaudioData, substr($SyncPattern1, 0, 3), 4);
+                        $framelength2 = strpos($MPEGaudioData, substr($SyncPattern2, 0, 3), 4);
+
+                        if ($framelength1 > 4) {
+                                $framelength = $framelength1;
+                        }
+                        if (($framelength2 > 4) && ($framelength2 < $framelength1)) {
+                                $framelength = $framelength2;
+                        }
+                        if (!$framelength) {
+                                $info['error'][] = 'Cannot find next free-format synch pattern ('.getid3_lib::PrintHexBytes($SyncPattern1).' or '.getid3_lib::PrintHexBytes($SyncPattern2).') after offset '.$offset;
+                                return false;
+                        } else {
+                                $info['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';
+                                $SyncPattern1 = substr($SyncPattern1, 0, 3);
+                                $SyncPattern2 = substr($SyncPattern2, 0, 3);
+                        }
+                }
+
+                if ($deepscan) {
+
+                        $ActualFrameLengthValues = array();
+                        $nextoffset = $offset + $framelength;
+                        while ($nextoffset < ($info['avdataend'] - 6)) {
+                                fseek($this->getid3->fp, $nextoffset - 1, SEEK_SET);
+                                $NextSyncPattern = fread($this->getid3->fp, 6);
+                                if ((substr($NextSyncPattern, 1, strlen($SyncPattern1)) == $SyncPattern1) || (substr($NextSyncPattern, 1, strlen($SyncPattern2)) == $SyncPattern2)) {
+                                        // good - found where expected
+                                        $ActualFrameLengthValues[] = $framelength;
+                                } elseif ((substr($NextSyncPattern, 0, strlen($SyncPattern1)) == $SyncPattern1) || (substr($NextSyncPattern, 0, strlen($SyncPattern2)) == $SyncPattern2)) {
+                                        // ok - found one byte earlier than expected (last frame wasn't padded, first frame was)
+                                        $ActualFrameLengthValues[] = ($framelength - 1);
+                                        $nextoffset--;
+                                } elseif ((substr($NextSyncPattern, 2, strlen($SyncPattern1)) == $SyncPattern1) || (substr($NextSyncPattern, 2, strlen($SyncPattern2)) == $SyncPattern2)) {
+                                        // ok - found one byte later than expected (last frame was padded, first frame wasn't)
+                                        $ActualFrameLengthValues[] = ($framelength + 1);
+                                        $nextoffset++;
+                                } else {
+                                        $info['error'][] = 'Did not find expected free-format sync pattern at offset '.$nextoffset;
+                                        return false;
+                                }
+                                $nextoffset += $framelength;
+                        }
+                        if (count($ActualFrameLengthValues) > 0) {
+                                $framelength = intval(round(array_sum($ActualFrameLengthValues) / count($ActualFrameLengthValues)));
+                        }
+                }
+                return $framelength;
+        }
+
+        public function getOnlyMPEGaudioInfoBruteForce() {
+                $MPEGaudioHeaderDecodeCache   = array();
+                $MPEGaudioHeaderValidCache    = array();
+                $MPEGaudioHeaderLengthCache   = array();
+                $MPEGaudioVersionLookup       = self::MPEGaudioVersionArray();
+                $MPEGaudioLayerLookup         = self::MPEGaudioLayerArray();
+                $MPEGaudioBitrateLookup       = self::MPEGaudioBitrateArray();
+                $MPEGaudioFrequencyLookup     = self::MPEGaudioFrequencyArray();
+                $MPEGaudioChannelModeLookup   = self::MPEGaudioChannelModeArray();
+                $MPEGaudioModeExtensionLookup = self::MPEGaudioModeExtensionArray();
+                $MPEGaudioEmphasisLookup      = self::MPEGaudioEmphasisArray();
+                $LongMPEGversionLookup        = array();
+                $LongMPEGlayerLookup          = array();
+                $LongMPEGbitrateLookup        = array();
+                $LongMPEGpaddingLookup        = array();
+                $LongMPEGfrequencyLookup      = array();
+                $Distribution['bitrate']      = array();
+                $Distribution['frequency']    = array();
+                $Distribution['layer']        = array();
+                $Distribution['version']      = array();
+                $Distribution['padding']      = array();
+
+                $info = &$this->getid3->info;
+                fseek($this->getid3->fp, $info['avdataoffset'], SEEK_SET);
+
+                $max_frames_scan = 5000;
+                $frames_scanned  = 0;
+
+                $previousvalidframe = $info['avdataoffset'];
+                while (ftell($this->getid3->fp) < $info['avdataend']) {
+                        set_time_limit(30);
+                        $head4 = fread($this->getid3->fp, 4);
+                        if (strlen($head4) < 4) {
+                                break;
+                        }
+                        if ($head4{0} != "\xFF") {
+                                for ($i = 1; $i < 4; $i++) {
+                                        if ($head4{$i} == "\xFF") {
+                                                fseek($this->getid3->fp, $i - 4, SEEK_CUR);
+                                                continue 2;
+                                        }
+                                }
+                                continue;
+                        }
+                        if (!isset($MPEGaudioHeaderDecodeCache[$head4])) {
+                                $MPEGaudioHeaderDecodeCache[$head4] = self::MPEGaudioHeaderDecode($head4);
+                        }
+                        if (!isset($MPEGaudioHeaderValidCache[$head4])) {
+                                $MPEGaudioHeaderValidCache[$head4] = self::MPEGaudioHeaderValid($MPEGaudioHeaderDecodeCache[$head4], false, false);
+                        }
+                        if ($MPEGaudioHeaderValidCache[$head4]) {
+
+                                if (!isset($MPEGaudioHeaderLengthCache[$head4])) {
+                                        $LongMPEGversionLookup[$head4]   = $MPEGaudioVersionLookup[$MPEGaudioHeaderDecodeCache[$head4]['version']];
+                                        $LongMPEGlayerLookup[$head4]     = $MPEGaudioLayerLookup[$MPEGaudioHeaderDecodeCache[$head4]['layer']];
+                                        $LongMPEGbitrateLookup[$head4]   = $MPEGaudioBitrateLookup[$LongMPEGversionLookup[$head4]][$LongMPEGlayerLookup[$head4]][$MPEGaudioHeaderDecodeCache[$head4]['bitrate']];
+                                        $LongMPEGpaddingLookup[$head4]   = (bool) $MPEGaudioHeaderDecodeCache[$head4]['padding'];
+                                        $LongMPEGfrequencyLookup[$head4] = $MPEGaudioFrequencyLookup[$LongMPEGversionLookup[$head4]][$MPEGaudioHeaderDecodeCache[$head4]['sample_rate']];
+                                        $MPEGaudioHeaderLengthCache[$head4] = self::MPEGaudioFrameLength(
+                                                $LongMPEGbitrateLookup[$head4],
+                                                $LongMPEGversionLookup[$head4],
+                                                $LongMPEGlayerLookup[$head4],
+                                                $LongMPEGpaddingLookup[$head4],
+                                                $LongMPEGfrequencyLookup[$head4]);
+                                }
+                                if ($MPEGaudioHeaderLengthCache[$head4] > 4) {
+                                        $WhereWeWere = ftell($this->getid3->fp);
+                                        fseek($this->getid3->fp, $MPEGaudioHeaderLengthCache[$head4] - 4, SEEK_CUR);
+                                        $next4 = fread($this->getid3->fp, 4);
+                                        if ($next4{0} == "\xFF") {
+                                                if (!isset($MPEGaudioHeaderDecodeCache[$next4])) {
+                                                        $MPEGaudioHeaderDecodeCache[$next4] = self::MPEGaudioHeaderDecode($next4);
+                                                }
+                                                if (!isset($MPEGaudioHeaderValidCache[$next4])) {
+                                                        $MPEGaudioHeaderValidCache[$next4] = self::MPEGaudioHeaderValid($MPEGaudioHeaderDecodeCache[$next4], false, false);
+                                                }
+                                                if ($MPEGaudioHeaderValidCache[$next4]) {
+                                                        fseek($this->getid3->fp, -4, SEEK_CUR);
+
+                                                        getid3_lib::safe_inc($Distribution['bitrate'][$LongMPEGbitrateLookup[$head4]]);
+                                                        getid3_lib::safe_inc($Distribution['layer'][$LongMPEGlayerLookup[$head4]]);
+                                                        getid3_lib::safe_inc($Distribution['version'][$LongMPEGversionLookup[$head4]]);
+                                                        getid3_lib::safe_inc($Distribution['padding'][intval($LongMPEGpaddingLookup[$head4])]);
+                                                        getid3_lib::safe_inc($Distribution['frequency'][$LongMPEGfrequencyLookup[$head4]]);
+                                                        if ($max_frames_scan && (++$frames_scanned >= $max_frames_scan)) {
+                                                                $pct_data_scanned = (ftell($this->getid3->fp) - $info['avdataoffset']) / ($info['avdataend'] - $info['avdataoffset']);
+                                                                $info['warning'][] = 'too many MPEG audio frames to scan, only scanned first '.$max_frames_scan.' frames ('.number_format($pct_data_scanned * 100, 1).'% of file) and extrapolated distribution, playtime and bitrate may be incorrect.';
+                                                                foreach ($Distribution as $key1 => $value1) {
+                                                                        foreach ($value1 as $key2 => $value2) {
+                                                                                $Distribution[$key1][$key2] = round($value2 / $pct_data_scanned);
+                                                                        }
+                                                                }
+                                                                break;
+                                                        }
+                                                        continue;
+                                                }
+                                        }
+                                        unset($next4);
+                                        fseek($this->getid3->fp, $WhereWeWere - 3, SEEK_SET);
+                                }
+
+                        }
+                }
+                foreach ($Distribution as $key => $value) {
+                        ksort($Distribution[$key], SORT_NUMERIC);
+                }
+                ksort($Distribution['version'], SORT_STRING);
+                $info['mpeg']['audio']['bitrate_distribution']   = $Distribution['bitrate'];
+                $info['mpeg']['audio']['frequency_distribution'] = $Distribution['frequency'];
+                $info['mpeg']['audio']['layer_distribution']     = $Distribution['layer'];
+                $info['mpeg']['audio']['version_distribution']   = $Distribution['version'];
+                $info['mpeg']['audio']['padding_distribution']   = $Distribution['padding'];
+                if (count($Distribution['version']) > 1) {
+                        $info['error'][] = 'Corrupt file - more than one MPEG version detected';
+                }
+                if (count($Distribution['layer']) > 1) {
+                        $info['error'][] = 'Corrupt file - more than one MPEG layer detected';
+                }
+                if (count($Distribution['frequency']) > 1) {
+                        $info['error'][] = 'Corrupt file - more than one MPEG sample rate detected';
+                }
+
+
+                $bittotal = 0;
+                foreach ($Distribution['bitrate'] as $bitratevalue => $bitratecount) {
+                        if ($bitratevalue != 'free') {
+                                $bittotal += ($bitratevalue * $bitratecount);
+                        }
+                }
+                $info['mpeg']['audio']['frame_count']  = array_sum($Distribution['bitrate']);
+                if ($info['mpeg']['audio']['frame_count'] == 0) {
+                        $info['error'][] = 'no MPEG audio frames found';
+                        return false;
+                }
+                $info['mpeg']['audio']['bitrate']      = ($bittotal / $info['mpeg']['audio']['frame_count']);
+                $info['mpeg']['audio']['bitrate_mode'] = ((count($Distribution['bitrate']) > 0) ? 'vbr' : 'cbr');
+                $info['mpeg']['audio']['sample_rate']  = getid3_lib::array_max($Distribution['frequency'], true);
+
+                $info['audio']['bitrate']      = $info['mpeg']['audio']['bitrate'];
+                $info['audio']['bitrate_mode'] = $info['mpeg']['audio']['bitrate_mode'];
+                $info['audio']['sample_rate']  = $info['mpeg']['audio']['sample_rate'];
+                $info['audio']['dataformat']   = 'mp'.getid3_lib::array_max($Distribution['layer'], true);
+                $info['fileformat']            = $info['audio']['dataformat'];
+
+                return true;
+        }
+
+
+        public function getOnlyMPEGaudioInfo($avdataoffset, $BitrateHistogram=false) {
+                // looks for synch, decodes MPEG audio header
+
+                $info = &$this->getid3->info;
+
+                static $MPEGaudioVersionLookup;
+                static $MPEGaudioLayerLookup;
+                static $MPEGaudioBitrateLookup;
+                if (empty($MPEGaudioVersionLookup)) {
+                   $MPEGaudioVersionLookup = self::MPEGaudioVersionArray();
+                   $MPEGaudioLayerLookup   = self::MPEGaudioLayerArray();
+                   $MPEGaudioBitrateLookup = self::MPEGaudioBitrateArray();
+
+                }
+
+                fseek($this->getid3->fp, $avdataoffset, SEEK_SET);
+                $sync_seek_buffer_size = min(128 * 1024, $info['avdataend'] - $avdataoffset);
+                if ($sync_seek_buffer_size <= 0) {
+                        $info['error'][] = 'Invalid $sync_seek_buffer_size at offset '.$avdataoffset;
+                        return false;
+                }
+                $header = fread($this->getid3->fp, $sync_seek_buffer_size);
+                $sync_seek_buffer_size = strlen($header);
+                $SynchSeekOffset = 0;
+                while ($SynchSeekOffset < $sync_seek_buffer_size) {
+                        if ((($avdataoffset + $SynchSeekOffset)  < $info['avdataend']) && !feof($this->getid3->fp)) {
+
+                                if ($SynchSeekOffset > $sync_seek_buffer_size) {
+                                        // if a synch's not found within the first 128k bytes, then give up
+                                        $info['error'][] = 'Could not find valid MPEG audio synch within the first '.round($sync_seek_buffer_size / 1024).'kB';
+                                        if (isset($info['audio']['bitrate'])) {
+                                                unset($info['audio']['bitrate']);
+                                        }
+                                        if (isset($info['mpeg']['audio'])) {
+                                                unset($info['mpeg']['audio']);
+                                        }
+                                        if (empty($info['mpeg'])) {
+                                                unset($info['mpeg']);
+                                        }
+                                        return false;
+
+                                } elseif (feof($this->getid3->fp)) {
+
+                                        $info['error'][] = 'Could not find valid MPEG audio synch before end of file';
+                                        if (isset($info['audio']['bitrate'])) {
+                                                unset($info['audio']['bitrate']);
+                                        }
+                                        if (isset($info['mpeg']['audio'])) {
+                                                unset($info['mpeg']['audio']);
+                                        }
+                                        if (isset($info['mpeg']) && (!is_array($info['mpeg']) || (count($info['mpeg']) == 0))) {
+                                                unset($info['mpeg']);
+                                        }
+                                        return false;
+                                }
+                        }
+
+                        if (($SynchSeekOffset + 1) >= strlen($header)) {
+                                $info['error'][] = 'Could not find valid MPEG synch before end of file';
+                                return false;
+                        }
+
+                        if (($header{$SynchSeekOffset} == "\xFF") && ($header{($SynchSeekOffset + 1)} > "\xE0")) { // synch detected
+                                if (!isset($FirstFrameThisfileInfo) && !isset($info['mpeg']['audio'])) {
+                                        $FirstFrameThisfileInfo = $info;
+                                        $FirstFrameAVDataOffset = $avdataoffset + $SynchSeekOffset;
+                                        if (!$this->decodeMPEGaudioHeader($FirstFrameAVDataOffset, $FirstFrameThisfileInfo, 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($FirstFrameThisfileInfo);
+                                        }
+                                }
+
+                                $dummy = $info; // only overwrite real data if valid header found
+                                if ($this->decodeMPEGaudioHeader($avdataoffset + $SynchSeekOffset, $dummy, true)) {
+                                        $info = $dummy;
+                                        $info['avdataoffset'] = $avdataoffset + $SynchSeekOffset;
+                                        switch (isset($info['fileformat']) ? $info['fileformat'] : '') {
+                                                case '':
+                                                case 'id3':
+                                                case 'ape':
+                                                case 'mp3':
+                                                        $info['fileformat']          = 'mp3';
+                                                        $info['audio']['dataformat'] = 'mp3';
+                                                        break;
+                                        }
+                                        if (isset($FirstFrameThisfileInfo['mpeg']['audio']['bitrate_mode']) && ($FirstFrameThisfileInfo['mpeg']['audio']['bitrate_mode'] == 'vbr')) {
+                                                if (!(abs($info['audio']['bitrate'] - $FirstFrameThisfileInfo['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 = $FirstFrameThisfileInfo;
+                                                        $info['avdataoffset']        = $FirstFrameAVDataOffset;
+                                                        $info['fileformat']          = 'mp3';
+                                                        $info['audio']['dataformat'] = 'mp3';
+                                                        $dummy                       = $info;
+                                                        unset($dummy['mpeg']['audio']);
+                                                        $GarbageOffsetStart = $FirstFrameAVDataOffset + $FirstFrameThisfileInfo['mpeg']['audio']['framelength'];
+                                                        $GarbageOffsetEnd   = $avdataoffset + $SynchSeekOffset;
+                                                        if ($this->decodeMPEGaudioHeader($GarbageOffsetEnd, $dummy, true, true)) {
+                                                                $info = $dummy;
+                                                                $info['avdataoffset'] = $GarbageOffsetEnd;
+                                                                $info['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 {
+                                                                $info['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
+                                                $BitrateHistogram = true;
+                                        }
+
+                                        if ($BitrateHistogram) {
+
+                                                $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('error'=>$info['error'], 'warning'=>$info['warning'], 'avdataend'=>$info['avdataend'], 'avdataoffset'=>$info['avdataoffset']);
+                                                $synchstartoffset = $info['avdataoffset'];
+                                                fseek($this->getid3->fp, $info['avdataoffset'], SEEK_SET);
+
+                                                // you can play with these numbers:
+                                                $max_frames_scan  = 50000;
+                                                $max_scan_segments = 10;
+
+                                                // don't play with these numbers:
+                                                $FastMode = false;
+                                                $SynchErrorsFound = 0;
+                                                $frames_scanned   = 0;
+                                                $this_scan_segment = 0;
+                                                $frames_scan_per_segment = ceil($max_frames_scan / $max_scan_segments);
+                                                $pct_data_scanned = 0;
+                                                for ($current_segment = 0; $current_segment < $max_scan_segments; $current_segment++) {
+                                                        $frames_scanned_this_segment = 0;
+                                                        if (ftell($this->getid3->fp) >= $info['avdataend']) {
+                                                                break;
+                                                        }
+                                                        $scan_start_offset[$current_segment] = max(ftell($this->getid3->fp), $info['avdataoffset'] + round($current_segment * (($info['avdataend'] - $info['avdataoffset']) / $max_scan_segments)));
+                                                        if ($current_segment > 0) {
+                                                                fseek($this->getid3->fp, $scan_start_offset[$current_segment], SEEK_SET);
+                                                                $buffer_4k = fread($this->getid3->fp, 4096);
+                                                                for ($j = 0; $j < (strlen($buffer_4k) - 4); $j++) {
+                                                                        if (($buffer_4k{$j} == "\xFF") && ($buffer_4k{($j + 1)} > "\xE0")) { // synch detected
+                                                                                if ($this->decodeMPEGaudioHeader($scan_start_offset[$current_segment] + $j, $dummy, false, false, $FastMode)) {
+                                                                                        $calculated_next_offset = $scan_start_offset[$current_segment] + $j + $dummy['mpeg']['audio']['framelength'];
+                                                                                        if ($this->decodeMPEGaudioHeader($calculated_next_offset, $dummy, false, false, $FastMode)) {
+                                                                                                $scan_start_offset[$current_segment] += $j;
+                                                                                                break;
+                                                                                        }
+                                                                                }
+                                                                        }
+                                                                }
+                                                        }
+                                                        $synchstartoffset = $scan_start_offset[$current_segment];
+                                                        while ($this->decodeMPEGaudioHeader($synchstartoffset, $dummy, false, false, $FastMode)) {
+                                                                $FastMode = true;
+                                                                $thisframebitrate = $MPEGaudioBitrateLookup[$MPEGaudioVersionLookup[$dummy['mpeg']['audio']['raw']['version']]][$MPEGaudioLayerLookup[$dummy['mpeg']['audio']['raw']['layer']]][$dummy['mpeg']['audio']['raw']['bitrate']];
+
+                                                                if (empty($dummy['mpeg']['audio']['framelength'])) {
+                                                                        $SynchErrorsFound++;
+                                                                        $synchstartoffset++;
+                                                                } else {
+                                                                        getid3_lib::safe_inc($info['mpeg']['audio']['bitrate_distribution'][$thisframebitrate]);
+                                                                        getid3_lib::safe_inc($info['mpeg']['audio']['stereo_distribution'][$dummy['mpeg']['audio']['channelmode']]);
+                                                                        getid3_lib::safe_inc($info['mpeg']['audio']['version_distribution'][$dummy['mpeg']['audio']['version']]);
+                                                                        $synchstartoffset += $dummy['mpeg']['audio']['framelength'];
+                                                                }
+                                                                $frames_scanned++;
+                                                                if ($frames_scan_per_segment && (++$frames_scanned_this_segment >= $frames_scan_per_segment)) {
+                                                                        $this_pct_scanned = (ftell($this->getid3->fp) - $scan_start_offset[$current_segment]) / ($info['avdataend'] - $info['avdataoffset']);
+                                                                        if (($current_segment == 0) && (($this_pct_scanned * $max_scan_segments) >= 1)) {
+                                                                                // file likely contains < $max_frames_scan, just scan as one segment
+                                                                                $max_scan_segments = 1;
+                                                                                $frames_scan_per_segment = $max_frames_scan;
+                                                                        } else {
+                                                                                $pct_data_scanned += $this_pct_scanned;
+                                                                                break;
+                                                                        }
+                                                                }
+                                                        }
+                                                }
+                                                if ($pct_data_scanned > 0) {
+                                                        $info['warning'][] = 'too many MPEG audio frames to scan, only scanned '.$frames_scanned.' frames in '.$max_scan_segments.' segments ('.number_format($pct_data_scanned * 100, 1).'% of file) and extrapolated distribution, playtime and bitrate may be incorrect.';
+                                                        foreach ($info['mpeg']['audio'] as $key1 => $value1) {
+                                                                if (!preg_match('#_distribution$#i', $key1)) {
+                                                                        continue;
+                                                                }
+                                                                foreach ($value1 as $key2 => $value2) {
+                                                                        $info['mpeg']['audio'][$key1][$key2] = round($value2 / $pct_data_scanned);
+                                                                }
+                                                        }
+                                                }
+
+                                                if ($SynchErrorsFound > 0) {
+                                                        $info['warning'][] = 'Found '.$SynchErrorsFound.' synch errors in histogram analysis';
+                                                        //return false;
+                                                }
+
+                                                $bittotal     = 0;
+                                                $framecounter = 0;
+                                                foreach ($info['mpeg']['audio']['bitrate_distribution'] as $bitratevalue => $bitratecount) {
+                                                        $framecounter += $bitratecount;
+                                                        if ($bitratevalue != 'free') {
+                                                                $bittotal += ($bitratevalue * $bitratecount);
+                                                        }
+                                                }
+                                                if ($framecounter == 0) {
+                                                        $info['error'][] = 'Corrupt MP3 file: framecounter == zero';
+                                                        return false;
+                                                }
+                                                $info['mpeg']['audio']['frame_count'] = getid3_lib::CastAsInt($framecounter);
+                                                $info['mpeg']['audio']['bitrate']     = ($bittotal / $framecounter);
+
+                                                $info['audio']['bitrate'] = $info['mpeg']['audio']['bitrate'];
+
+
+                                                // Definitively set VBR vs CBR, even if the Xing/LAME/VBRI header says differently
+                                                $distinct_bitrates = 0;
+                                                foreach ($info['mpeg']['audio']['bitrate_distribution'] as $bitrate_value => $bitrate_count) {
+                                                        if ($bitrate_count > 0) {
+                                                                $distinct_bitrates++;
+                                                        }
+                                                }
+                                                if ($distinct_bitrates > 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()
+                                }
+                        }
+
+                        $SynchSeekOffset++;
+                        if (($avdataoffset + $SynchSeekOffset) >= $info['avdataend']) {
+                                // end of file/data
+
+                                if (empty($info['mpeg']['audio'])) {
+
+                                        $info['error'][] = 'could not find valid MPEG synch before end of file';
+                                        if (isset($info['audio']['bitrate'])) {
+                                                unset($info['audio']['bitrate']);
+                                        }
+                                        if (isset($info['mpeg']['audio'])) {
+                                                unset($info['mpeg']['audio']);
+                                        }
+                                        if (isset($info['mpeg']) && (!is_array($info['mpeg']) || empty($info['mpeg']))) {
+                                                unset($info['mpeg']);
+                                        }
+                                        return false;
+
+                                }
+                                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 $MPEGaudioVersion = array('2.5', false, '2', '1');
+                return $MPEGaudioVersion;
+        }
+
+        public static function MPEGaudioLayerArray() {
+                static $MPEGaudioLayer = array(false, 3, 2, 1);
+                return $MPEGaudioLayer;
+        }
+
+        public static function MPEGaudioBitrateArray() {
+                static $MPEGaudioBitrate;
+                if (empty($MPEGaudioBitrate)) {
+                        $MPEGaudioBitrate = 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),
+                                                           )
+                        );
+                        $MPEGaudioBitrate['2'][3] = $MPEGaudioBitrate['2'][2];
+                        $MPEGaudioBitrate['2.5']  = $MPEGaudioBitrate['2'];
+                }
+                return $MPEGaudioBitrate;
+        }
+
+        public static function MPEGaudioFrequencyArray() {
+                static $MPEGaudioFrequency;
+                if (empty($MPEGaudioFrequency)) {
+                        $MPEGaudioFrequency = array (
+                                '1'   => array(44100, 48000, 32000),
+                                '2'   => array(22050, 24000, 16000),
+                                '2.5' => array(11025, 12000,  8000)
+                        );
+                }
+                return $MPEGaudioFrequency;
+        }
+
+        public static function MPEGaudioChannelModeArray() {
+                static $MPEGaudioChannelMode = array('stereo', 'joint stereo', 'dual channel', 'mono');
+                return $MPEGaudioChannelMode;
+        }
+
+        public static function MPEGaudioModeExtensionArray() {
+                static $MPEGaudioModeExtension;
+                if (empty($MPEGaudioModeExtension)) {
+                        $MPEGaudioModeExtension = 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 $MPEGaudioModeExtension;
+        }
+
+        public static function MPEGaudioEmphasisArray() {
+                static $MPEGaudioEmphasis = array('none', '50/15ms', false, 'CCIT J.17');
+                return $MPEGaudioEmphasis;
+        }
+
+        public static function MPEGaudioHeaderBytesValid($head4, $allowBitrate15=false) {
+                return self::MPEGaudioHeaderValid(self::MPEGaudioHeaderDecode($head4), false, $allowBitrate15);
+        }
+
+        public static function MPEGaudioHeaderValid($rawarray, $echoerrors=false, $allowBitrate15=false) {
+                if (($rawarray['synch'] & 0x0FFE) != 0x0FFE) {
+                        return false;
+                }
+
+                static $MPEGaudioVersionLookup;
+                static $MPEGaudioLayerLookup;
+                static $MPEGaudioBitrateLookup;
+                static $MPEGaudioFrequencyLookup;
+                static $MPEGaudioChannelModeLookup;
+                static $MPEGaudioModeExtensionLookup;
+                static $MPEGaudioEmphasisLookup;
+                if (empty($MPEGaudioVersionLookup)) {
+                        $MPEGaudioVersionLookup       = self::MPEGaudioVersionArray();
+                        $MPEGaudioLayerLookup         = self::MPEGaudioLayerArray();
+                        $MPEGaudioBitrateLookup       = self::MPEGaudioBitrateArray();
+                        $MPEGaudioFrequencyLookup     = self::MPEGaudioFrequencyArray();
+                        $MPEGaudioChannelModeLookup   = self::MPEGaudioChannelModeArray();
+                        $MPEGaudioModeExtensionLookup = self::MPEGaudioModeExtensionArray();
+                        $MPEGaudioEmphasisLookup      = self::MPEGaudioEmphasisArray();
+                }
+
+                if (isset($MPEGaudioVersionLookup[$rawarray['version']])) {
+                        $decodedVersion = $MPEGaudioVersionLookup[$rawarray['version']];
+                } else {
+                        echo ($echoerrors ? "\n".'invalid Version ('.$rawarray['version'].')' : '');
+                        return false;
+                }
+                if (isset($MPEGaudioLayerLookup[$rawarray['layer']])) {
+                        $decodedLayer = $MPEGaudioLayerLookup[$rawarray['layer']];
+                } else {
+                        echo ($echoerrors ? "\n".'invalid Layer ('.$rawarray['layer'].')' : '');
+                        return false;
+                }
+                if (!isset($MPEGaudioBitrateLookup[$decodedVersion][$decodedLayer][$rawarray['bitrate']])) {
+                        echo ($echoerrors ? "\n".'invalid Bitrate ('.$rawarray['bitrate'].')' : '');
+                        if ($rawarray['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 (!$allowBitrate15) {
+                                        return false;
+                                }
+                        } else {
+                                return false;
+                        }
+                }
+                if (!isset($MPEGaudioFrequencyLookup[$decodedVersion][$rawarray['sample_rate']])) {
+                        echo ($echoerrors ? "\n".'invalid Frequency ('.$rawarray['sample_rate'].')' : '');
+                        return false;
+                }
+                if (!isset($MPEGaudioChannelModeLookup[$rawarray['channelmode']])) {
+                        echo ($echoerrors ? "\n".'invalid ChannelMode ('.$rawarray['channelmode'].')' : '');
+                        return false;
+                }
+                if (!isset($MPEGaudioModeExtensionLookup[$decodedLayer][$rawarray['modeextension']])) {
+                        echo ($echoerrors ? "\n".'invalid Mode Extension ('.$rawarray['modeextension'].')' : '');
+                        return false;
+                }
+                if (!isset($MPEGaudioEmphasisLookup[$rawarray['emphasis']])) {
+                        echo ($echoerrors ? "\n".'invalid Emphasis ('.$rawarray['emphasis'].')' : '');
+                        return false;
+                }
+                // These are just either set or not set, you can't mess that up :)
+                // $rawarray['protection'];
+                // $rawarray['padding'];
+                // $rawarray['private'];
+                // $rawarray['copyright'];
+                // $rawarray['original'];
+
+                return true;
+        }
+
+        public static function MPEGaudioHeaderDecode($Header4Bytes) {
+                // 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($Header4Bytes) != 4) {
+                        return false;
+                }
+
+                $MPEGrawHeader['synch']         = (getid3_lib::BigEndian2Int(substr($Header4Bytes, 0, 2)) & 0xFFE0) >> 4;
+                $MPEGrawHeader['version']       = (ord($Header4Bytes{1}) & 0x18) >> 3; //    BB
+                $MPEGrawHeader['layer']         = (ord($Header4Bytes{1}) & 0x06) >> 1; //      CC
+                $MPEGrawHeader['protection']    = (ord($Header4Bytes{1}) & 0x01);      //        D
+                $MPEGrawHeader['bitrate']       = (ord($Header4Bytes{2}) & 0xF0) >> 4; // EEEE
+                $MPEGrawHeader['sample_rate']   = (ord($Header4Bytes{2}) & 0x0C) >> 2; //     FF
+                $MPEGrawHeader['padding']       = (ord($Header4Bytes{2}) & 0x02) >> 1; //       G
+                $MPEGrawHeader['private']       = (ord($Header4Bytes{2}) & 0x01);      //        H
+                $MPEGrawHeader['channelmode']   = (ord($Header4Bytes{3}) & 0xC0) >> 6; // II
+                $MPEGrawHeader['modeextension'] = (ord($Header4Bytes{3}) & 0x30) >> 4; //   JJ
+                $MPEGrawHeader['copyright']     = (ord($Header4Bytes{3}) & 0x08) >> 3; //     K
+                $MPEGrawHeader['original']      = (ord($Header4Bytes{3}) & 0x04) >> 2; //      L
+                $MPEGrawHeader['emphasis']      = (ord($Header4Bytes{3}) & 0x03);      //       MM
+
+                return $MPEGrawHeader;
+        }
+
+        public static function MPEGaudioFrameLength(&$bitrate, &$version, &$layer, $padding, &$samplerate) {
+                static $AudioFrameLengthCache = array();
+
+                if (!isset($AudioFrameLengthCache[$bitrate][$version][$layer][$padding][$samplerate])) {
+                        $AudioFrameLengthCache[$bitrate][$version][$layer][$padding][$samplerate] = false;
+                        if ($bitrate != 'free') {
+
+                                if ($version == '1') {
+
+                                        if ($layer == '1') {
+
+                                                // For Layer I slot is 32 bits long
+                                                $FrameLengthCoefficient = 48;
+                                                $SlotLength = 4;
+
+                                        } else { // Layer 2 / 3
+
+                                                // for Layer 2 and Layer 3 slot is 8 bits long.
+                                                $FrameLengthCoefficient = 144;
+                                                $SlotLength = 1;
+
+                                        }
+
+                                } else { // MPEG-2 / MPEG-2.5
+
+                                        if ($layer == '1') {
+
+                                                // For Layer I slot is 32 bits long
+                                                $FrameLengthCoefficient = 24;
+                                                $SlotLength = 4;
+
+                                        } elseif ($layer == '2') {
+
+                                                // for Layer 2 and Layer 3 slot is 8 bits long.
+                                                $FrameLengthCoefficient = 144;
+                                                $SlotLength = 1;
+
+                                        } else { // layer 3
+
+                                                // for Layer 2 and Layer 3 slot is 8 bits long.
+                                                $FrameLengthCoefficient = 72;
+                                                $SlotLength = 1;
+
+                                        }
+
+                                }
+
+                                // FrameLengthInBytes = ((Coefficient * BitRate) / SampleRate) + Padding
+                                if ($samplerate > 0) {
+                                        $NewFramelength  = ($FrameLengthCoefficient * $bitrate) / $samplerate;
+                                        $NewFramelength  = floor($NewFramelength / $SlotLength) * $SlotLength; // round to next-lower multiple of SlotLength (1 byte for Layer 2/3, 4 bytes for Layer I)
+                                        if ($padding) {
+                                                $NewFramelength += $SlotLength;
+                                        }
+                                        $AudioFrameLengthCache[$bitrate][$version][$layer][$padding][$samplerate] = (int) $NewFramelength;
+                                }
+                        }
+                }
+                return $AudioFrameLengthCache[$bitrate][$version][$layer][$padding][$samplerate];
+        }
+
+        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 > max($standard_bit_rates)) {
+                                $bit_rate_table[$round_bit_rate] = round($bit_rate, 2 - strlen($bit_rate));
+                        } else {
+                                $bit_rate_table[$round_bit_rate] = max($standard_bit_rates);
+                                foreach ($standard_bit_rates as $standard_bit_rate) {
+                                        if ($round_bit_rate >= $standard_bit_rate + (($bit_rate_table[$round_bit_rate] - $standard_bit_rate) / 2)) {
+                                                break;
+                                        }
+                                        $bit_rate_table[$round_bit_rate] = $standard_bit_rate;
+                                }
+                        }
+                }
+                return $bit_rate_table[$round_bit_rate];
+        }
+
+        public static function XingVBRidOffset($version, $channelmode) {
+                static $XingVBRidOffsetCache = array();
+                if (empty($XingVBRidOffset)) {
+                        $XingVBRidOffset = 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 $XingVBRidOffset[$version][$channelmode];
+        }
+
+        public static function LAMEvbrMethodLookup($VBRmethodID) {
+                static $LAMEvbrMethodLookup = array(
+                        0x00 => 'unknown',
+                        0x01 => 'cbr',
+                        0x02 => 'abr',
+                        0x03 => 'vbr-old / vbr-rh',
+                        0x04 => 'vbr-new / vbr-mtrh',
+                        0x05 => 'vbr-mt',
+                        0x06 => 'vbr (full vbr method 4)',
+                        0x08 => 'cbr (constant bitrate 2 pass)',
+                        0x09 => 'abr (2 pass)',
+                        0x0F => 'reserved'
+                );
+                return (isset($LAMEvbrMethodLookup[$VBRmethodID]) ? $LAMEvbrMethodLookup[$VBRmethodID] : '');
+        }
+
+        public static function LAMEmiscStereoModeLookup($StereoModeID) {
+                static $LAMEmiscStereoModeLookup = array(
+                        0 => 'mono',
+                        1 => 'stereo',
+                        2 => 'dual mono',
+                        3 => 'joint stereo',
+                        4 => 'forced stereo',
+                        5 => 'auto',
+                        6 => 'intensity stereo',
+                        7 => 'other'
+                );
+                return (isset($LAMEmiscStereoModeLookup[$StereoModeID]) ? $LAMEmiscStereoModeLookup[$StereoModeID] : '');
+        }
+
+        public static function LAMEmiscSourceSampleFrequencyLookup($SourceSampleFrequencyID) {
+                static $LAMEmiscSourceSampleFrequencyLookup = array(
+                        0 => '<= 32 kHz',
+                        1 => '44.1 kHz',
+                        2 => '48 kHz',
+                        3 => '> 48kHz'
+                );
+                return (isset($LAMEmiscSourceSampleFrequencyLookup[$SourceSampleFrequencyID]) ? $LAMEmiscSourceSampleFrequencyLookup[$SourceSampleFrequencyID] : '');
+        }
+
+        public static function LAMEsurroundInfoLookup($SurroundInfoID) {
+                static $LAMEsurroundInfoLookup = array(
+                        0 => 'no surround info',
+                        1 => 'DPL encoding',
+                        2 => 'DPL2 encoding',
+                        3 => 'Ambisonic encoding'
+                );
+                return (isset($LAMEsurroundInfoLookup[$SurroundInfoID]) ? $LAMEsurroundInfoLookup[$SurroundInfoID] : 'reserved');
+        }
+
+        public static function LAMEpresetUsedLookup($LAMEtag) {
+
+                if ($LAMEtag['preset_used_id'] == 0) {
+                        // no preset used (LAME >=3.93)
+                        // no preset recorded (LAME <3.93)
+                        return '';
+                }
+                $LAMEpresetUsedLookup = array();
+
+                /////  THIS PART CANNOT BE STATIC .
+                for ($i = 8; $i <= 320; $i++) {
+                        switch ($LAMEtag['vbr_method']) {
+                                case 'cbr':
+                                        $LAMEpresetUsedLookup[$i] = '--alt-preset '.$LAMEtag['vbr_method'].' '.$i;
+                                        break;
+                                case 'abr':
+                                default: // other VBR modes shouldn't be here(?)
+                                        $LAMEpresetUsedLookup[$i] = '--alt-preset '.$i;
+                                        break;
+                        }
+                }
+
+                // named old-style presets (studio, phone, voice, etc) are handled in GuessEncoderOptions()
+
+                // named alt-presets
+                $LAMEpresetUsedLookup[1000] = '--r3mix';
+                $LAMEpresetUsedLookup[1001] = '--alt-preset standard';
+                $LAMEpresetUsedLookup[1002] = '--alt-preset extreme';
+                $LAMEpresetUsedLookup[1003] = '--alt-preset insane';
+                $LAMEpresetUsedLookup[1004] = '--alt-preset fast standard';
+                $LAMEpresetUsedLookup[1005] = '--alt-preset fast extreme';
+                $LAMEpresetUsedLookup[1006] = '--alt-preset medium';
+                $LAMEpresetUsedLookup[1007] = '--alt-preset fast medium';
+
+                // LAME 3.94 additions/changes
+                $LAMEpresetUsedLookup[1010] = '--preset portable';                                                           // 3.94a15 Oct 21 2003
+                $LAMEpresetUsedLookup[1015] = '--preset radio';                                                              // 3.94a15 Oct 21 2003
+
+                $LAMEpresetUsedLookup[320]  = '--preset insane';                                                             // 3.94a15 Nov 12 2003
+                $LAMEpresetUsedLookup[410]  = '-V9';
+                $LAMEpresetUsedLookup[420]  = '-V8';
+                $LAMEpresetUsedLookup[440]  = '-V6';
+                $LAMEpresetUsedLookup[430]  = '--preset radio';                                                              // 3.94a15 Nov 12 2003
+                $LAMEpresetUsedLookup[450]  = '--preset '.(($LAMEtag['raw']['vbr_method'] == 4) ? 'fast ' : '').'portable';  // 3.94a15 Nov 12 2003
+                $LAMEpresetUsedLookup[460]  = '--preset '.(($LAMEtag['raw']['vbr_method'] == 4) ? 'fast ' : '').'medium';    // 3.94a15 Nov 12 2003
+                $LAMEpresetUsedLookup[470]  = '--r3mix';                                                                     // 3.94b1  Dec 18 2003
+                $LAMEpresetUsedLookup[480]  = '--preset '.(($LAMEtag['raw']['vbr_method'] == 4) ? 'fast ' : '').'standard';  // 3.94a15 Nov 12 2003
+                $LAMEpresetUsedLookup[490]  = '-V1';
+                $LAMEpresetUsedLookup[500]  = '--preset '.(($LAMEtag['raw']['vbr_method'] == 4) ? 'fast ' : '').'extreme';   // 3.94a15 Nov 12 2003
+
+                return (isset($LAMEpresetUsedLookup[$LAMEtag['preset_used_id']]) ? $LAMEpresetUsedLookup[$LAMEtag['preset_used_id']] : 'new/unknown preset: '.$LAMEtag['preset_used_id'].' - report to info@getid3.org');
+        }
+
+}

new file wp-includes/ID3/module.audio.ogg.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.audio.ogg.php                                        //
+// module for analyzing Ogg Vorbis, OggFLAC and Speex files    //
+// dependencies: module.audio.flac.php                         //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.flac.php', __FILE__, true);
+
+class getid3_ogg extends getid3_handler
+{
+        // http://xiph.org/vorbis/doc/Vorbis_I_spec.html
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                $info['fileformat'] = 'ogg';
+
+                // Warn about illegal tags - only vorbiscomments are allowed
+                if (isset($info['id3v2'])) {
+                        $info['warning'][] = 'Illegal ID3v2 tag present.';
+                }
+                if (isset($info['id3v1'])) {
+                        $info['warning'][] = 'Illegal ID3v1 tag present.';
+                }
+                if (isset($info['ape'])) {
+                        $info['warning'][] = 'Illegal APE tag present.';
+                }
+
+
+                // Page 1 - Stream Header
+
+                $this->fseek($info['avdataoffset']);
+
+                $oggpageinfo = $this->ParseOggPageHeader();
+                $info['ogg']['pageheader'][$oggpageinfo['page_seqno']] = $oggpageinfo;
+
+                if ($this->ftell() >= $this->getid3->fread_buffer_size()) {
+                        $info['error'][] = 'Could not find start of Ogg page in the first '.$this->getid3->fread_buffer_size().' bytes (this might not be an Ogg-Vorbis file?)';
+                        unset($info['fileformat']);
+                        unset($info['ogg']);
+                        return false;
+                }
+
+                $filedata = $this->fread($oggpageinfo['page_length']);
+                $filedataoffset = 0;
+
+                if (substr($filedata, 0, 4) == 'fLaC') {
+
+                        $info['audio']['dataformat']   = 'flac';
+                        $info['audio']['bitrate_mode'] = 'vbr';
+                        $info['audio']['lossless']     = true;
+
+                } elseif (substr($filedata, 1, 6) == 'vorbis') {
+
+                        $this->ParseVorbisPageHeader($filedata, $filedataoffset, $oggpageinfo);
+
+                } elseif (substr($filedata, 0, 8) == 'Speex   ') {
+
+                        // http://www.speex.org/manual/node10.html
+
+                        $info['audio']['dataformat']   = 'speex';
+                        $info['mime_type']             = 'audio/speex';
+                        $info['audio']['bitrate_mode'] = 'abr';
+                        $info['audio']['lossless']     = false;
+
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['speex_string']           =                              substr($filedata, $filedataoffset, 8); // hard-coded to 'Speex   '
+                        $filedataoffset += 8;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['speex_version']          =                              substr($filedata, $filedataoffset, 20);
+                        $filedataoffset += 20;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['speex_version_id']       = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['header_size']            = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['rate']                   = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['mode']                   = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['mode_bitstream_version'] = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['nb_channels']            = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['bitrate']                = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['framesize']              = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['vbr']                    = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['frames_per_packet']      = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['extra_headers']          = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['reserved1']              = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['reserved2']              = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                        $filedataoffset += 4;
+
+                        $info['speex']['speex_version'] = trim($info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['speex_version']);
+                        $info['speex']['sample_rate']   = $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['rate'];
+                        $info['speex']['channels']      = $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['nb_channels'];
+                        $info['speex']['vbr']           = (bool) $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['vbr'];
+                        $info['speex']['band_type']     = $this->SpeexBandModeLookup($info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['mode']);
+
+                        $info['audio']['sample_rate']   = $info['speex']['sample_rate'];
+                        $info['audio']['channels']      = $info['speex']['channels'];
+                        if ($info['speex']['vbr']) {
+                                $info['audio']['bitrate_mode'] = 'vbr';
+                        }
+
+
+                } elseif (substr($filedata, 0, 8) == "fishead\x00") {
+
+                        // Ogg Skeleton version 3.0 Format Specification
+                        // http://xiph.org/ogg/doc/skeleton.html
+                        $filedataoffset += 8;
+                        $info['ogg']['skeleton']['fishead']['raw']['version_major']                = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  2));
+                        $filedataoffset += 2;
+                        $info['ogg']['skeleton']['fishead']['raw']['version_minor']                = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  2));
+                        $filedataoffset += 2;
+                        $info['ogg']['skeleton']['fishead']['raw']['presentationtime_numerator']   = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  8));
+                        $filedataoffset += 8;
+                        $info['ogg']['skeleton']['fishead']['raw']['presentationtime_denominator'] = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  8));
+                        $filedataoffset += 8;
+                        $info['ogg']['skeleton']['fishead']['raw']['basetime_numerator']           = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  8));
+                        $filedataoffset += 8;
+                        $info['ogg']['skeleton']['fishead']['raw']['basetime_denominator']         = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  8));
+                        $filedataoffset += 8;
+                        $info['ogg']['skeleton']['fishead']['raw']['utc']                          = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 20));
+                        $filedataoffset += 20;
+
+                        $info['ogg']['skeleton']['fishead']['version']          = $info['ogg']['skeleton']['fishead']['raw']['version_major'].'.'.$info['ogg']['skeleton']['fishead']['raw']['version_minor'];
+                        $info['ogg']['skeleton']['fishead']['presentationtime'] = $info['ogg']['skeleton']['fishead']['raw']['presentationtime_numerator'] / $info['ogg']['skeleton']['fishead']['raw']['presentationtime_denominator'];
+                        $info['ogg']['skeleton']['fishead']['basetime']         = $info['ogg']['skeleton']['fishead']['raw']['basetime_numerator']         / $info['ogg']['skeleton']['fishead']['raw']['basetime_denominator'];
+                        $info['ogg']['skeleton']['fishead']['utc']              = $info['ogg']['skeleton']['fishead']['raw']['utc'];
+
+
+                        $counter = 0;
+                        do {
+                                $oggpageinfo = $this->ParseOggPageHeader();
+                                $info['ogg']['pageheader'][$oggpageinfo['page_seqno'].'.'.$counter++] = $oggpageinfo;
+                                $filedata = $this->fread($oggpageinfo['page_length']);
+                                $this->fseek($oggpageinfo['page_end_offset']);
+
+                                if (substr($filedata, 0, 8) == "fisbone\x00") {
+
+                                        $filedataoffset = 8;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['message_header_offset']   = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  4));
+                                        $filedataoffset += 4;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['serial_number']           = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  4));
+                                        $filedataoffset += 4;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['number_header_packets']   = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  4));
+                                        $filedataoffset += 4;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['granulerate_numerator']   = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  8));
+                                        $filedataoffset += 8;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['granulerate_denominator'] = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  8));
+                                        $filedataoffset += 8;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['basegranule']             = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  8));
+                                        $filedataoffset += 8;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['preroll']                 = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  4));
+                                        $filedataoffset += 4;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['granuleshift']            = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset,  1));
+                                        $filedataoffset += 1;
+                                        $info['ogg']['skeleton']['fisbone']['raw']['padding']                 =                              substr($filedata, $filedataoffset,  3);
+                                        $filedataoffset += 3;
+
+                                } elseif (substr($filedata, 1, 6) == 'theora') {
+
+                                        $info['video']['dataformat'] = 'theora';
+                                        $info['error'][] = 'Ogg Theora not correctly handled in this version of getID3 ['.$this->getid3->version().']';
+                                        //break;
+
+                                } elseif (substr($filedata, 1, 6) == 'vorbis') {
+
+                                        $this->ParseVorbisPageHeader($filedata, $filedataoffset, $oggpageinfo);
+
+                                } else {
+                                        $info['error'][] = 'unexpected';
+                                        //break;
+                                }
+                        //} while ($oggpageinfo['page_seqno'] == 0);
+                        } while (($oggpageinfo['page_seqno'] == 0) && (substr($filedata, 0, 8) != "fisbone\x00"));
+
+                        $this->fseek($oggpageinfo['page_start_offset']);
+
+                        $info['error'][] = 'Ogg Skeleton not correctly handled in this version of getID3 ['.$this->getid3->version().']';
+                        //return false;
+
+                } else {
+
+                        $info['error'][] = 'Expecting either "Speex   " or "vorbis" identifier strings, found "'.substr($filedata, 0, 8).'"';
+                        unset($info['ogg']);
+                        unset($info['mime_type']);
+                        return false;
+
+                }
+
+                // Page 2 - Comment Header
+                $oggpageinfo = $this->ParseOggPageHeader();
+                $info['ogg']['pageheader'][$oggpageinfo['page_seqno']] = $oggpageinfo;
+
+                switch ($info['audio']['dataformat']) {
+                        case 'vorbis':
+                                $filedata = $this->fread($info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_length']);
+                                $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['packet_type'] = getid3_lib::LittleEndian2Int(substr($filedata, 0, 1));
+                                $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['stream_type'] =                              substr($filedata, 1, 6); // hard-coded to 'vorbis'
+
+                                $this->ParseVorbisComments();
+                                break;
+
+                        case 'flac':
+                                $flac = new getid3_flac($this->getid3);
+                                if (!$flac->parseMETAdata()) {
+                                        $info['error'][] = 'Failed to parse FLAC headers';
+                                        return false;
+                                }
+                                unset($flac);
+                                break;
+
+                        case 'speex':
+                                $this->fseek($info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_length'], SEEK_CUR);
+                                $this->ParseVorbisComments();
+                                break;
+                }
+
+
+                // Last Page - Number of Samples
+                if (!getid3_lib::intValueSupported($info['avdataend'])) {
+
+                        $info['warning'][] = 'Unable to parse Ogg end chunk file (PHP does not support file operations beyond '.round(PHP_INT_MAX / 1073741824).'GB)';
+
+                } else {
+
+                        $this->fseek(max($info['avdataend'] - $this->getid3->fread_buffer_size(), 0));
+                        $LastChunkOfOgg = strrev($this->fread($this->getid3->fread_buffer_size()));
+                        if ($LastOggSpostion = strpos($LastChunkOfOgg, 'SggO')) {
+                                $this->fseek($info['avdataend'] - ($LastOggSpostion + strlen('SggO')));
+                                $info['avdataend'] = $this->ftell();
+                                $info['ogg']['pageheader']['eos'] = $this->ParseOggPageHeader();
+                                $info['ogg']['samples']   = $info['ogg']['pageheader']['eos']['pcm_abs_position'];
+                                if ($info['ogg']['samples'] == 0) {
+                                        $info['error'][] = 'Corrupt Ogg file: eos.number of samples == zero';
+                                        return false;
+                                }
+                                if (!empty($info['audio']['sample_rate'])) {
+                                        $info['ogg']['bitrate_average'] = (($info['avdataend'] - $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($info['playtime_seconds'])) {
+                        if ($info['audio']['bitrate'] == 0) {
+                                $info['error'][] = 'Corrupt Ogg file: bitrate_audio == zero';
+                                return false;
+                        }
+                        $info['playtime_seconds'] = (float) ((($info['avdataend'] - $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 '.$this->get_quality_from_nominal_bitrate($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;
+        }
+
+        public function ParseVorbisPageHeader(&$filedata, &$filedataoffset, &$oggpageinfo) {
+                $info = &$this->getid3->info;
+                $info['audio']['dataformat'] = 'vorbis';
+                $info['audio']['lossless']   = false;
+
+                $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['packet_type'] = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1));
+                $filedataoffset += 1;
+                $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['stream_type'] = substr($filedata, $filedataoffset, 6); // hard-coded to 'vorbis'
+                $filedataoffset += 6;
+                $info['ogg']['bitstreamversion'] = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                $info['ogg']['numberofchannels'] = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1));
+                $filedataoffset += 1;
+                $info['audio']['channels']       = $info['ogg']['numberofchannels'];
+                $info['ogg']['samplerate']       = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                if ($info['ogg']['samplerate'] == 0) {
+                        $info['error'][] = 'Corrupt Ogg file: sample rate == zero';
+                        return false;
+                }
+                $info['audio']['sample_rate']    = $info['ogg']['samplerate'];
+                $info['ogg']['samples']          = 0; // filled in later
+                $info['ogg']['bitrate_average']  = 0; // filled in later
+                $info['ogg']['bitrate_max']      = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                $info['ogg']['bitrate_nominal']  = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                $info['ogg']['bitrate_min']      = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                $info['ogg']['blocksize_small']  = pow(2,  getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1)) & 0x0F);
+                $info['ogg']['blocksize_large']  = pow(2, (getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1)) & 0xF0) >> 4);
+                $info['ogg']['stop_bit']         = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1)); // must be 1, marks end of packet
+
+                $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';
+                }
+                return true;
+        }
+
+        public function ParseOggPageHeader() {
+                // http://xiph.org/ogg/vorbis/doc/framing.html
+                $oggheader['page_start_offset'] = $this->ftell(); // where we started from in the file
+
+                $filedata = $this->fread($this->getid3->fread_buffer_size());
+                $filedataoffset = 0;
+                while ((substr($filedata, $filedataoffset++, 4) != 'OggS')) {
+                        if (($this->ftell() - $oggheader['page_start_offset']) >= $this->getid3->fread_buffer_size()) {
+                                // should be found before here
+                                return false;
+                        }
+                        if ((($filedataoffset + 28) > strlen($filedata)) || (strlen($filedata) < 28)) {
+                                if ($this->feof() || (($filedata .= $this->fread($this->getid3->fread_buffer_size())) === false)) {
+                                        // get some more data, unless eof, in which case fail
+                                        return false;
+                                }
+                        }
+                }
+                $filedataoffset += strlen('OggS') - 1; // page, delimited by 'OggS'
+
+                $oggheader['stream_structver']  = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1));
+                $filedataoffset += 1;
+                $oggheader['flags_raw']         = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1));
+                $filedataoffset += 1;
+                $oggheader['flags']['fresh']    = (bool) ($oggheader['flags_raw'] & 0x01); // fresh packet
+                $oggheader['flags']['bos']      = (bool) ($oggheader['flags_raw'] & 0x02); // first page of logical bitstream (bos)
+                $oggheader['flags']['eos']      = (bool) ($oggheader['flags_raw'] & 0x04); // last page of logical bitstream (eos)
+
+                $oggheader['pcm_abs_position']  = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 8));
+                $filedataoffset += 8;
+                $oggheader['stream_serialno']   = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                $oggheader['page_seqno']        = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                $oggheader['page_checksum']     = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 4));
+                $filedataoffset += 4;
+                $oggheader['page_segments']     = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1));
+                $filedataoffset += 1;
+                $oggheader['page_length'] = 0;
+                for ($i = 0; $i < $oggheader['page_segments']; $i++) {
+                        $oggheader['segment_table'][$i] = getid3_lib::LittleEndian2Int(substr($filedata, $filedataoffset, 1));
+                        $filedataoffset += 1;
+                        $oggheader['page_length'] += $oggheader['segment_table'][$i];
+                }
+                $oggheader['header_end_offset'] = $oggheader['page_start_offset'] + $filedataoffset;
+                $oggheader['page_end_offset']   = $oggheader['header_end_offset'] + $oggheader['page_length'];
+                $this->fseek($oggheader['header_end_offset']);
+
+                return $oggheader;
+        }
+
+    // http://xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-810005
+        public function ParseVorbisComments() {
+                $info = &$this->getid3->info;
+
+                $OriginalOffset = $this->ftell();
+                $commentdataoffset = 0;
+                $VorbisCommentPage = 1;
+
+                switch ($info['audio']['dataformat']) {
+                        case 'vorbis':
+                        case 'speex':
+                                $CommentStartOffset = $info['ogg']['pageheader'][$VorbisCommentPage]['page_start_offset'];  // Second Ogg page, after header block
+                                $this->fseek($CommentStartOffset);
+                                $commentdataoffset = 27 + $info['ogg']['pageheader'][$VorbisCommentPage]['page_segments'];
+                                $commentdata = $this->fread(self::OggPageSegmentLength($info['ogg']['pageheader'][$VorbisCommentPage], 1) + $commentdataoffset);
+
+                                if ($info['audio']['dataformat'] == 'vorbis') {
+                                        $commentdataoffset += (strlen('vorbis') + 1);
+                                }
+                                break;
+
+                        case 'flac':
+                                $CommentStartOffset = $info['flac']['VORBIS_COMMENT']['raw']['offset'] + 4;
+                                $this->fseek($CommentStartOffset);
+                                $commentdata = $this->fread($info['flac']['VORBIS_COMMENT']['raw']['block_length']);
+                                break;
+
+                        default:
+                                return false;
+                }
+
+                $VendorSize = getid3_lib::LittleEndian2Int(substr($commentdata, $commentdataoffset, 4));
+                $commentdataoffset += 4;
+
+                $info['ogg']['vendor'] = substr($commentdata, $commentdataoffset, $VendorSize);
+                $commentdataoffset += $VendorSize;
+
+                $CommentsCount = getid3_lib::LittleEndian2Int(substr($commentdata, $commentdataoffset, 4));
+                $commentdataoffset += 4;
+                $info['avdataoffset'] = $CommentStartOffset + $commentdataoffset;
+
+                $basicfields = array('TITLE', 'ARTIST', 'ALBUM', 'TRACKNUMBER', 'GENRE', 'DATE', 'DESCRIPTION', 'COMMENT');
+                $ThisFileInfo_ogg_comments_raw = &$info['ogg']['comments_raw'];
+                for ($i = 0; $i < $CommentsCount; $i++) {
+
+                        $ThisFileInfo_ogg_comments_raw[$i]['dataoffset'] = $CommentStartOffset + $commentdataoffset;
+
+                        if ($this->ftell() < ($ThisFileInfo_ogg_comments_raw[$i]['dataoffset'] + 4)) {
+                                if ($oggpageinfo = $this->ParseOggPageHeader()) {
+                                        $info['ogg']['pageheader'][$oggpageinfo['page_seqno']] = $oggpageinfo;
+
+                                        $VorbisCommentPage++;
+
+                                        // First, save what we haven't read yet
+                                        $AsYetUnusedData = substr($commentdata, $commentdataoffset);
+
+                                        // Then take that data off the end
+                                        $commentdata     = substr($commentdata, 0, $commentdataoffset);
+
+                                        // Add [headerlength] bytes of dummy data for the Ogg Page Header, just to keep absolute offsets correct
+                                        $commentdata .= str_repeat("\x00", 27 + $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_segments']);
+                                        $commentdataoffset += (27 + $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_segments']);
+
+                                        // Finally, stick the unused data back on the end
+                                        $commentdata .= $AsYetUnusedData;
+
+                                        //$commentdata .= $this->fread($info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_length']);
+                                        $commentdata .= $this->fread($this->OggPageSegmentLength($info['ogg']['pageheader'][$VorbisCommentPage], 1));
+                                }
+
+                        }
+                        $ThisFileInfo_ogg_comments_raw[$i]['size'] = getid3_lib::LittleEndian2Int(substr($commentdata, $commentdataoffset, 4));
+
+                        // replace avdataoffset with position just after the last vorbiscomment
+                        $info['avdataoffset'] = $ThisFileInfo_ogg_comments_raw[$i]['dataoffset'] + $ThisFileInfo_ogg_comments_raw[$i]['size'] + 4;
+
+                        $commentdataoffset += 4;
+                        while ((strlen($commentdata) - $commentdataoffset) < $ThisFileInfo_ogg_comments_raw[$i]['size']) {
+                                if (($ThisFileInfo_ogg_comments_raw[$i]['size'] > $info['avdataend']) || ($ThisFileInfo_ogg_comments_raw[$i]['size'] < 0)) {
+                                        $info['warning'][] = 'Invalid Ogg comment size (comment #'.$i.', claims to be '.number_format($ThisFileInfo_ogg_comments_raw[$i]['size']).' bytes) - aborting reading comments';
+                                        break 2;
+                                }
+
+                                $VorbisCommentPage++;
+
+                                $oggpageinfo = $this->ParseOggPageHeader();
+                                $info['ogg']['pageheader'][$oggpageinfo['page_seqno']] = $oggpageinfo;
+
+                                // First, save what we haven't read yet
+                                $AsYetUnusedData = substr($commentdata, $commentdataoffset);
+
+                                // Then take that data off the end
+                                $commentdata     = substr($commentdata, 0, $commentdataoffset);
+
+                                // Add [headerlength] bytes of dummy data for the Ogg Page Header, just to keep absolute offsets correct
+                                $commentdata .= str_repeat("\x00", 27 + $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_segments']);
+                                $commentdataoffset += (27 + $info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_segments']);
+
+                                // Finally, stick the unused data back on the end
+                                $commentdata .= $AsYetUnusedData;
+
+                                //$commentdata .= $this->fread($info['ogg']['pageheader'][$oggpageinfo['page_seqno']]['page_length']);
+                                if (!isset($info['ogg']['pageheader'][$VorbisCommentPage])) {
+                                        $info['warning'][] = 'undefined Vorbis Comment page "'.$VorbisCommentPage.'" at offset '.$this->ftell();
+                                        break;
+                                }
+                                $readlength = self::OggPageSegmentLength($info['ogg']['pageheader'][$VorbisCommentPage], 1);
+                                if ($readlength <= 0) {
+                                        $info['warning'][] = 'invalid length Vorbis Comment page "'.$VorbisCommentPage.'" at offset '.$this->ftell();
+                                        break;
+                                }
+                                $commentdata .= $this->fread($readlength);
+
+                                //$filebaseoffset += $oggpageinfo['header_end_offset'] - $oggpageinfo['page_start_offset'];
+                        }
+                        $ThisFileInfo_ogg_comments_raw[$i]['offset'] = $commentdataoffset;
+                        $commentstring = substr($commentdata, $commentdataoffset, $ThisFileInfo_ogg_comments_raw[$i]['size']);
+                        $commentdataoffset += $ThisFileInfo_ogg_comments_raw[$i]['size'];
+
+                        if (!$commentstring) {
+
+                                // no comment?
+                                $info['warning'][] = 'Blank Ogg comment ['.$i.']';
+
+                        } elseif (strstr($commentstring, '=')) {
+
+                                $commentexploded = explode('=', $commentstring, 2);
+                                $ThisFileInfo_ogg_comments_raw[$i]['key']   = strtoupper($commentexploded[0]);
+                                $ThisFileInfo_ogg_comments_raw[$i]['value'] = (isset($commentexploded[1]) ? $commentexploded[1] : '');
+
+                                if ($ThisFileInfo_ogg_comments_raw[$i]['key'] == 'METADATA_BLOCK_PICTURE') {
+
+                                        // http://wiki.xiph.org/VorbisComment#METADATA_BLOCK_PICTURE
+                                        // The unencoded format is that of the FLAC picture block. The fields are stored in big endian order as in FLAC, picture data is stored according to the relevant standard.
+                                        // http://flac.sourceforge.net/format.html#metadata_block_picture
+                                        $flac = new getid3_flac($this->getid3);
+                                        $flac->setStringMode(base64_decode($ThisFileInfo_ogg_comments_raw[$i]['value']));
+                                        $flac->parsePICTURE();
+                                        $info['ogg']['comments']['picture'][] = $flac->getid3->info['flac']['PICTURE'][0];
+                                        unset($flac);
+
+                                } elseif ($ThisFileInfo_ogg_comments_raw[$i]['key'] == 'COVERART') {
+
+                                        $data = base64_decode($ThisFileInfo_ogg_comments_raw[$i]['value']);
+                                        $this->notice('Found deprecated COVERART tag, it should be replaced in honor of METADATA_BLOCK_PICTURE structure');
+                                        /** @todo use 'coverartmime' where available */
+                                        $imageinfo = getid3_lib::GetDataImageSize($data);
+                                        if ($imageinfo === false || !isset($imageinfo['mime'])) {
+                                                $this->warning('COVERART vorbiscomment tag contains invalid image');
+                                                continue;
+                                        }
+
+                                        $ogg = new self($this->getid3);
+                                        $ogg->setStringMode($data);
+                                        $info['ogg']['comments']['picture'][] = array(
+                                                'image_mime' => $imageinfo['mime'],
+                                                'data'       => $ogg->saveAttachment('coverart', 0, strlen($data), $imageinfo['mime']),
+                                        );
+                                        unset($ogg);
+
+                                } else {
+
+                                        $info['ogg']['comments'][strtolower($ThisFileInfo_ogg_comments_raw[$i]['key'])][] = $ThisFileInfo_ogg_comments_raw[$i]['value'];
+
+                                }
+
+                        } else {
+
+                                $info['warning'][] = '[known problem with CDex >= v1.40, < v1.50b7] Invalid Ogg comment name/value pair ['.$i.']: '.$commentstring;
+
+                        }
+                        unset($ThisFileInfo_ogg_comments_raw[$i]);
+                }
+                unset($ThisFileInfo_ogg_comments_raw);
+
+
+                // Replay Gain Adjustment
+                // http://privatewww.essex.ac.uk/~djmrob/replaygain/
+                if (isset($info['ogg']['comments']) && is_array($info['ogg']['comments'])) {
+                        foreach ($info['ogg']['comments'] as $index => $commentvalue) {
+                                switch ($index) {
+                                        case 'rg_audiophile':
+                                        case 'replaygain_album_gain':
+                                                $info['replay_gain']['album']['adjustment'] = (double) $commentvalue[0];
+                                                unset($info['ogg']['comments'][$index]);
+                                                break;
+
+                                        case 'rg_radio':
+                                        case 'replaygain_track_gain':
+                                                $info['replay_gain']['track']['adjustment'] = (double) $commentvalue[0];
+                                                unset($info['ogg']['comments'][$index]);
+                                                break;
+
+                                        case 'replaygain_album_peak':
+                                                $info['replay_gain']['album']['peak'] = (double) $commentvalue[0];
+                                                unset($info['ogg']['comments'][$index]);
+                                                break;
+
+                                        case 'rg_peak':
+                                        case 'replaygain_track_peak':
+                                                $info['replay_gain']['track']['peak'] = (double) $commentvalue[0];
+                                                unset($info['ogg']['comments'][$index]);
+                                                break;
+
+                                        case 'replaygain_reference_loudness':
+                                                $info['replay_gain']['reference_volume'] = (double) $commentvalue[0];
+                                                unset($info['ogg']['comments'][$index]);
+                                                break;
+
+                                        default:
+                                                // do nothing
+                                                break;
+                                }
+                        }
+                }
+
+                $this->fseek($OriginalOffset);
+
+                return true;
+        }
+
+        public static function SpeexBandModeLookup($mode) {
+                static $SpeexBandModeLookup = array();
+                if (empty($SpeexBandModeLookup)) {
+                        $SpeexBandModeLookup[0] = 'narrow';
+                        $SpeexBandModeLookup[1] = 'wide';
+                        $SpeexBandModeLookup[2] = 'ultra-wide';
+                }
+                return (isset($SpeexBandModeLookup[$mode]) ? $SpeexBandModeLookup[$mode] : null);
+        }
+
+
+        public static function OggPageSegmentLength($OggInfoArray, $SegmentNumber=1) {
+                for ($i = 0; $i < $SegmentNumber; $i++) {
+                        $segmentlength = 0;
+                        foreach ($OggInfoArray['segment_table'] as $key => $value) {
+                                $segmentlength += $value;
+                                if ($value < 255) {
+                                        break;
+                                }
+                        }
+                }
+                return $segmentlength;
+        }
+
+
+        public static function get_quality_from_nominal_bitrate($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 $qval; // 5.031324
+                //return intval($qval); // 5
+                return round($qval, 1); // 5 or 4.9
+        }
+
+}

new file wp-includes/ID3/module.tag.apetag.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.tag.apetag.php                                       //
+// module for analyzing APE tags                               //
+// dependencies: NONE                                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+class getid3_apetag extends getid3_handler
+{
+        public $inline_attachments = true; // true: return full data for all attachments; false: return no data for all attachments; integer: return data for attachments <= than this; string: save as file to this directory
+        public $overrideendoffset  = 0;
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                if (!getid3_lib::intValueSupported($info['filesize'])) {
+                        $info['warning'][] = 'Unable to check for APEtags because file is larger than '.round(PHP_INT_MAX / 1073741824).'GB';
+                        return false;
+                }
+
+                $id3v1tagsize     = 128;
+                $apetagheadersize = 32;
+                $lyrics3tagsize   = 10;
+
+                if ($this->overrideendoffset == 0) {
+
+                        fseek($this->getid3->fp, 0 - $id3v1tagsize - $apetagheadersize - $lyrics3tagsize, SEEK_END);
+                        $APEfooterID3v1 = fread($this->getid3->fp, $id3v1tagsize + $apetagheadersize + $lyrics3tagsize);
+
+                        //if (preg_match('/APETAGEX.{24}TAG.{125}$/i', $APEfooterID3v1)) {
+                        if (substr($APEfooterID3v1, strlen($APEfooterID3v1) - $id3v1tagsize - $apetagheadersize, 8) == 'APETAGEX') {
+
+                                // APE tag found before ID3v1
+                                $info['ape']['tag_offset_end'] = $info['filesize'] - $id3v1tagsize;
+
+                        //} elseif (preg_match('/APETAGEX.{24}$/i', $APEfooterID3v1)) {
+                        } elseif (substr($APEfooterID3v1, strlen($APEfooterID3v1) - $apetagheadersize, 8) == 'APETAGEX') {
+
+                                // APE tag found, no ID3v1
+                                $info['ape']['tag_offset_end'] = $info['filesize'];
+
+                        }
+
+                } else {
+
+                        fseek($this->getid3->fp, $this->overrideendoffset - $apetagheadersize, SEEK_SET);
+                        if (fread($this->getid3->fp, 8) == 'APETAGEX') {
+                                $info['ape']['tag_offset_end'] = $this->overrideendoffset;
+                        }
+
+                }
+                if (!isset($info['ape']['tag_offset_end'])) {
+
+                        // APE tag not found
+                        unset($info['ape']);
+                        return false;
+
+                }
+
+                // shortcut
+                $thisfile_ape = &$info['ape'];
+
+                fseek($this->getid3->fp, $thisfile_ape['tag_offset_end'] - $apetagheadersize, SEEK_SET);
+                $APEfooterData = fread($this->getid3->fp, 32);
+                if (!($thisfile_ape['footer'] = $this->parseAPEheaderFooter($APEfooterData))) {
+                        $info['error'][] = 'Error parsing APE footer at offset '.$thisfile_ape['tag_offset_end'];
+                        return false;
+                }
+
+                if (isset($thisfile_ape['footer']['flags']['header']) && $thisfile_ape['footer']['flags']['header']) {
+                        fseek($this->getid3->fp, $thisfile_ape['tag_offset_end'] - $thisfile_ape['footer']['raw']['tagsize'] - $apetagheadersize, SEEK_SET);
+                        $thisfile_ape['tag_offset_start'] = ftell($this->getid3->fp);
+                        $APEtagData = fread($this->getid3->fp, $thisfile_ape['footer']['raw']['tagsize'] + $apetagheadersize);
+                } else {
+                        $thisfile_ape['tag_offset_start'] = $thisfile_ape['tag_offset_end'] - $thisfile_ape['footer']['raw']['tagsize'];
+                        fseek($this->getid3->fp, $thisfile_ape['tag_offset_start'], SEEK_SET);
+                        $APEtagData = fread($this->getid3->fp, $thisfile_ape['footer']['raw']['tagsize']);
+                }
+                $info['avdataend'] = $thisfile_ape['tag_offset_start'];
+
+                if (isset($info['id3v1']['tag_offset_start']) && ($info['id3v1']['tag_offset_start'] < $thisfile_ape['tag_offset_end'])) {
+                        $info['warning'][] = 'ID3v1 tag information ignored since it appears to be a false synch in APEtag data';
+                        unset($info['id3v1']);
+                        foreach ($info['warning'] as $key => $value) {
+                                if ($value == 'Some ID3v1 fields do not use NULL characters for padding') {
+                                        unset($info['warning'][$key]);
+                                        sort($info['warning']);
+                                        break;
+                                }
+                        }
+                }
+
+                $offset = 0;
+                if (isset($thisfile_ape['footer']['flags']['header']) && $thisfile_ape['footer']['flags']['header']) {
+                        if ($thisfile_ape['header'] = $this->parseAPEheaderFooter(substr($APEtagData, 0, $apetagheadersize))) {
+                                $offset += $apetagheadersize;
+                        } else {
+                                $info['error'][] = 'Error parsing APE header at offset '.$thisfile_ape['tag_offset_start'];
+                                return false;
+                        }
+                }
+
+                // shortcut
+                $info['replay_gain'] = array();
+                $thisfile_replaygain = &$info['replay_gain'];
+
+                for ($i = 0; $i < $thisfile_ape['footer']['raw']['tag_items']; $i++) {
+                        $value_size = getid3_lib::LittleEndian2Int(substr($APEtagData, $offset, 4));
+                        $offset += 4;
+                        $item_flags = getid3_lib::LittleEndian2Int(substr($APEtagData, $offset, 4));
+                        $offset += 4;
+                        if (strstr(substr($APEtagData, $offset), "\x00") === false) {
+                                $info['error'][] = 'Cannot find null-byte (0x00) seperator between ItemKey #'.$i.' and value. ItemKey starts '.$offset.' bytes into the APE tag, at file offset '.($thisfile_ape['tag_offset_start'] + $offset);
+                                return false;
+                        }
+                        $ItemKeyLength = strpos($APEtagData, "\x00", $offset) - $offset;
+                        $item_key      = strtolower(substr($APEtagData, $offset, $ItemKeyLength));
+
+                        // shortcut
+                        $thisfile_ape['items'][$item_key] = array();
+                        $thisfile_ape_items_current = &$thisfile_ape['items'][$item_key];
+
+                        $thisfile_ape_items_current['offset'] = $thisfile_ape['tag_offset_start'] + $offset;
+
+                        $offset += ($ItemKeyLength + 1); // skip 0x00 terminator
+                        $thisfile_ape_items_current['data'] = substr($APEtagData, $offset, $value_size);
+                        $offset += $value_size;
+
+                        $thisfile_ape_items_current['flags'] = $this->parseAPEtagFlags($item_flags);
+                        switch ($thisfile_ape_items_current['flags']['item_contents_raw']) {
+                                case 0: // UTF-8
+                                case 3: // Locator (URL, filename, etc), UTF-8 encoded
+                                        $thisfile_ape_items_current['data'] = explode("\x00", trim($thisfile_ape_items_current['data']));
+                                        break;
+
+                                default: // binary data
+                                        break;
+                        }
+
+                        switch (strtolower($item_key)) {
+                                case 'replaygain_track_gain':
+                                        $thisfile_replaygain['track']['adjustment'] = (float) str_replace(',', '.', $thisfile_ape_items_current['data'][0]); // float casting will see "0,95" as zero!
+                                        $thisfile_replaygain['track']['originator'] = 'unspecified';
+                                        break;
+
+                                case 'replaygain_track_peak':
+                                        $thisfile_replaygain['track']['peak']       = (float) str_replace(',', '.', $thisfile_ape_items_current['data'][0]); // float casting will see "0,95" as zero!
+                                        $thisfile_replaygain['track']['originator'] = 'unspecified';
+                                        if ($thisfile_replaygain['track']['peak'] <= 0) {
+                                                $info['warning'][] = 'ReplayGain Track peak from APEtag appears invalid: '.$thisfile_replaygain['track']['peak'].' (original value = "'.$thisfile_ape_items_current['data'][0].'")';
+                                        }
+                                        break;
+
+                                case 'replaygain_album_gain':
+                                        $thisfile_replaygain['album']['adjustment'] = (float) str_replace(',', '.', $thisfile_ape_items_current['data'][0]); // float casting will see "0,95" as zero!
+                                        $thisfile_replaygain['album']['originator'] = 'unspecified';
+                                        break;
+
+                                case 'replaygain_album_peak':
+                                        $thisfile_replaygain['album']['peak']       = (float) str_replace(',', '.', $thisfile_ape_items_current['data'][0]); // float casting will see "0,95" as zero!
+                                        $thisfile_replaygain['album']['originator'] = 'unspecified';
+                                        if ($thisfile_replaygain['album']['peak'] <= 0) {
+                                                $info['warning'][] = 'ReplayGain Album peak from APEtag appears invalid: '.$thisfile_replaygain['album']['peak'].' (original value = "'.$thisfile_ape_items_current['data'][0].'")';
+                                        }
+                                        break;
+
+                                case 'mp3gain_undo':
+                                        list($mp3gain_undo_left, $mp3gain_undo_right, $mp3gain_undo_wrap) = explode(',', $thisfile_ape_items_current['data'][0]);
+                                        $thisfile_replaygain['mp3gain']['undo_left']  = intval($mp3gain_undo_left);
+                                        $thisfile_replaygain['mp3gain']['undo_right'] = intval($mp3gain_undo_right);
+                                        $thisfile_replaygain['mp3gain']['undo_wrap']  = (($mp3gain_undo_wrap == 'Y') ? true : false);
+                                        break;
+
+                                case 'mp3gain_minmax':
+                                        list($mp3gain_globalgain_min, $mp3gain_globalgain_max) = explode(',', $thisfile_ape_items_current['data'][0]);
+                                        $thisfile_replaygain['mp3gain']['globalgain_track_min'] = intval($mp3gain_globalgain_min);
+                                        $thisfile_replaygain['mp3gain']['globalgain_track_max'] = intval($mp3gain_globalgain_max);
+                                        break;
+
+                                case 'mp3gain_album_minmax':
+                                        list($mp3gain_globalgain_album_min, $mp3gain_globalgain_album_max) = explode(',', $thisfile_ape_items_current['data'][0]);
+                                        $thisfile_replaygain['mp3gain']['globalgain_album_min'] = intval($mp3gain_globalgain_album_min);
+                                        $thisfile_replaygain['mp3gain']['globalgain_album_max'] = intval($mp3gain_globalgain_album_max);
+                                        break;
+
+                                case 'tracknumber':
+                                        if (is_array($thisfile_ape_items_current['data'])) {
+                                                foreach ($thisfile_ape_items_current['data'] as $comment) {
+                                                        $thisfile_ape['comments']['track'][] = $comment;
+                                                }
+                                        }
+                                        break;
+
+                                case 'cover art (artist)':
+                                case 'cover art (back)':
+                                case 'cover art (band logo)':
+                                case 'cover art (band)':
+                                case 'cover art (colored fish)':
+                                case 'cover art (composer)':
+                                case 'cover art (conductor)':
+                                case 'cover art (front)':
+                                case 'cover art (icon)':
+                                case 'cover art (illustration)':
+                                case 'cover art (lead)':
+                                case 'cover art (leaflet)':
+                                case 'cover art (lyricist)':
+                                case 'cover art (media)':
+                                case 'cover art (movie scene)':
+                                case 'cover art (other icon)':
+                                case 'cover art (other)':
+                                case 'cover art (performance)':
+                                case 'cover art (publisher logo)':
+                                case 'cover art (recording)':
+                                case 'cover art (studio)':
+                                        // list of possible cover arts from http://taglib-sharp.sourcearchive.com/documentation/2.0.3.0-2/Ape_2Tag_8cs-source.html
+                                        list($thisfile_ape_items_current['filename'], $thisfile_ape_items_current['data']) = explode("\x00", $thisfile_ape_items_current['data'], 2);
+                                        $thisfile_ape_items_current['data_offset'] = $thisfile_ape_items_current['offset'] + strlen($thisfile_ape_items_current['filename']."\x00");
+                                        $thisfile_ape_items_current['data_length'] = strlen($thisfile_ape_items_current['data']);
+
+                                        $thisfile_ape_items_current['image_mime'] = '';
+                                        $imageinfo = array();
+                                        $imagechunkcheck = getid3_lib::GetDataImageSize($thisfile_ape_items_current['data'], $imageinfo);
+                                        $thisfile_ape_items_current['image_mime'] = image_type_to_mime_type($imagechunkcheck[2]);
+
+                                        do {
+                                                if ($this->inline_attachments === false) {
+                                                        // skip entirely
+                                                        unset($thisfile_ape_items_current['data']);
+                                                        break;
+                                                }
+                                                if ($this->inline_attachments === true) {
+                                                        // great
+                                                } elseif (is_int($this->inline_attachments)) {
+                                                        if ($this->inline_attachments < $thisfile_ape_items_current['data_length']) {
+                                                                // too big, skip
+                                                                $info['warning'][] = 'attachment at '.$thisfile_ape_items_current['offset'].' is too large to process inline ('.number_format($thisfile_ape_items_current['data_length']).' bytes)';
+                                                                unset($thisfile_ape_items_current['data']);
+                                                                break;
+                                                        }
+                                                } elseif (is_string($this->inline_attachments)) {
+                                                        $this->inline_attachments = rtrim(str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $this->inline_attachments), DIRECTORY_SEPARATOR);
+                                                        if (!is_dir($this->inline_attachments) || !is_writable($this->inline_attachments)) {
+                                                                // cannot write, skip
+                                                                $info['warning'][] = 'attachment at '.$thisfile_ape_items_current['offset'].' cannot be saved to "'.$this->inline_attachments.'" (not writable)';
+                                                                unset($thisfile_ape_items_current['data']);
+                                                                break;
+                                                        }
+                                                }
+                                                // if we get this far, must be OK
+                                                if (is_string($this->inline_attachments)) {
+                                                        $destination_filename = $this->inline_attachments.DIRECTORY_SEPARATOR.md5($info['filenamepath']).'_'.$thisfile_ape_items_current['data_offset'];
+                                                        if (!file_exists($destination_filename) || is_writable($destination_filename)) {
+                                                                file_put_contents($destination_filename, $thisfile_ape_items_current['data']);
+                                                        } else {
+                                                                $info['warning'][] = 'attachment at '.$thisfile_ape_items_current['offset'].' cannot be saved to "'.$destination_filename.'" (not writable)';
+                                                        }
+                                                        $thisfile_ape_items_current['data_filename'] = $destination_filename;
+                                                        unset($thisfile_ape_items_current['data']);
+                                                } else {
+                                                        if (!isset($info['ape']['comments']['picture'])) {
+                                                                $info['ape']['comments']['picture'] = array();
+                                                        }
+                                                        $info['ape']['comments']['picture'][] = array('data'=>$thisfile_ape_items_current['data'], 'image_mime'=>$thisfile_ape_items_current['image_mime']);
+                                                }
+                                        } while (false);
+                                        break;
+
+                                default:
+                                        if (is_array($thisfile_ape_items_current['data'])) {
+                                                foreach ($thisfile_ape_items_current['data'] as $comment) {
+                                                        $thisfile_ape['comments'][strtolower($item_key)][] = $comment;
+                                                }
+                                        }
+                                        break;
+                        }
+
+                }
+                if (empty($thisfile_replaygain)) {
+                        unset($info['replay_gain']);
+                }
+                return true;
+        }
+
+        public function parseAPEheaderFooter($APEheaderFooterData) {
+                // http://www.uni-jena.de/~pfk/mpp/sv8/apeheader.html
+
+                // shortcut
+                $headerfooterinfo['raw'] = array();
+                $headerfooterinfo_raw = &$headerfooterinfo['raw'];
+
+                $headerfooterinfo_raw['footer_tag']   =                  substr($APEheaderFooterData,  0, 8);
+                if ($headerfooterinfo_raw['footer_tag'] != 'APETAGEX') {
+                        return false;
+                }
+                $headerfooterinfo_raw['version']      = getid3_lib::LittleEndian2Int(substr($APEheaderFooterData,  8, 4));
+                $headerfooterinfo_raw['tagsize']      = getid3_lib::LittleEndian2Int(substr($APEheaderFooterData, 12, 4));
+                $headerfooterinfo_raw['tag_items']    = getid3_lib::LittleEndian2Int(substr($APEheaderFooterData, 16, 4));
+                $headerfooterinfo_raw['global_flags'] = getid3_lib::LittleEndian2Int(substr($APEheaderFooterData, 20, 4));
+                $headerfooterinfo_raw['reserved']     =                              substr($APEheaderFooterData, 24, 8);
+
+                $headerfooterinfo['tag_version']         = $headerfooterinfo_raw['version'] / 1000;
+                if ($headerfooterinfo['tag_version'] >= 2) {
+                        $headerfooterinfo['flags'] = $this->parseAPEtagFlags($headerfooterinfo_raw['global_flags']);
+                }
+                return $headerfooterinfo;
+        }
+
+        public function parseAPEtagFlags($rawflagint) {
+                // "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
+                $flags['header']            = (bool) ($rawflagint & 0x80000000);
+                $flags['footer']            = (bool) ($rawflagint & 0x40000000);
+                $flags['this_is_header']    = (bool) ($rawflagint & 0x20000000);
+                $flags['item_contents_raw'] =        ($rawflagint & 0x00000006) >> 1;
+                $flags['read_only']         = (bool) ($rawflagint & 0x00000001);
+
+                $flags['item_contents']     = $this->APEcontentTypeFlagLookup($flags['item_contents_raw']);
+
+                return $flags;
+        }
+
+        public function APEcontentTypeFlagLookup($contenttypeid) {
+                static $APEcontentTypeFlagLookup = array(
+                        0 => 'utf-8',
+                        1 => 'binary',
+                        2 => 'external',
+                        3 => 'reserved'
+                );
+                return (isset($APEcontentTypeFlagLookup[$contenttypeid]) ? $APEcontentTypeFlagLookup[$contenttypeid] : 'invalid');
+        }
+
+        public function APEtagItemIsUTF8Lookup($itemkey) {
+                static $APEtagItemIsUTF8Lookup = 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($itemkey), $APEtagItemIsUTF8Lookup);
+        }
+
+}

new file wp-includes/ID3/module.tag.id3v1.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+//                                                             //
+// module.tag.id3v1.php                                        //
+// module for analyzing ID3v1 tags                             //
+// dependencies: NONE                                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+
+class getid3_id3v1 extends getid3_handler
+{
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                if (!getid3_lib::intValueSupported($info['filesize'])) {
+                        $info['warning'][] = 'Unable to check for ID3v1 because file is larger than '.round(PHP_INT_MAX / 1073741824).'GB';
+                        return false;
+                }
+
+                fseek($this->getid3->fp, -256, SEEK_END);
+                $preid3v1 = fread($this->getid3->fp, 128);
+                $id3v1tag = fread($this->getid3->fp, 128);
+
+                if (substr($id3v1tag, 0, 3) == 'TAG') {
+
+                        $info['avdataend'] = $info['filesize'] - 128;
+
+                        $ParsedID3v1['title']   = $this->cutfield(substr($id3v1tag,   3, 30));
+                        $ParsedID3v1['artist']  = $this->cutfield(substr($id3v1tag,  33, 30));
+                        $ParsedID3v1['album']   = $this->cutfield(substr($id3v1tag,  63, 30));
+                        $ParsedID3v1['year']    = $this->cutfield(substr($id3v1tag,  93,  4));
+                        $ParsedID3v1['comment'] =                 substr($id3v1tag,  97, 30);  // can't remove nulls yet, track detection depends on them
+                        $ParsedID3v1['genreid'] =             ord(substr($id3v1tag, 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 (($id3v1tag{125} === "\x00") && ($id3v1tag{126} !== "\x00")) {
+                                $ParsedID3v1['track']   = ord(substr($ParsedID3v1['comment'], 29,  1));
+                                $ParsedID3v1['comment'] =     substr($ParsedID3v1['comment'],  0, 28);
+                        }
+                        $ParsedID3v1['comment'] = $this->cutfield($ParsedID3v1['comment']);
+
+                        $ParsedID3v1['genre'] = $this->LookupGenreName($ParsedID3v1['genreid']);
+                        if (!empty($ParsedID3v1['genre'])) {
+                                unset($ParsedID3v1['genreid']);
+                        }
+                        if (isset($ParsedID3v1['genre']) && (empty($ParsedID3v1['genre']) || ($ParsedID3v1['genre'] == 'Unknown'))) {
+                                unset($ParsedID3v1['genre']);
+                        }
+
+                        foreach ($ParsedID3v1 as $key => $value) {
+                                $ParsedID3v1['comments'][$key][0] = $value;
+                        }
+
+                        // ID3v1 data is supposed to be padded with NULL characters, but some taggers pad with spaces
+                        $GoodFormatID3v1tag = $this->GenerateID3v1Tag(
+                                                                                        $ParsedID3v1['title'],
+                                                                                        $ParsedID3v1['artist'],
+                                                                                        $ParsedID3v1['album'],
+                                                                                        $ParsedID3v1['year'],
+                                                                                        (isset($ParsedID3v1['genre']) ? $this->LookupGenreID($ParsedID3v1['genre']) : false),
+                                                                                        $ParsedID3v1['comment'],
+                                                                                        (!empty($ParsedID3v1['track']) ? $ParsedID3v1['track'] : ''));
+                        $ParsedID3v1['padding_valid'] = true;
+                        if ($id3v1tag !== $GoodFormatID3v1tag) {
+                                $ParsedID3v1['padding_valid'] = false;
+                                $info['warning'][] = 'Some ID3v1 fields do not use NULL characters for padding';
+                        }
+
+                        $ParsedID3v1['tag_offset_end']   = $info['filesize'];
+                        $ParsedID3v1['tag_offset_start'] = $ParsedID3v1['tag_offset_end'] - 128;
+
+                        $info['id3v1'] = $ParsedID3v1;
+                }
+
+                if (substr($preid3v1, 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($preid3v1, 96, 8) == 'APETAGEX') {
+                                // an APE tag footer was found before the last ID3v1, assume false "TAG" synch
+                        } elseif (substr($preid3v1, 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
+                                $info['warning'][] = 'Duplicate ID3v1 tag detected - this has been known to happen with iTunes';
+                                $info['avdataend'] -= 128;
+                        }
+                }
+
+                return true;
+        }
+
+        public static function cutfield($str) {
+                return trim(substr($str, 0, strcspn($str, "\x00")));
+        }
+
+        public static function ArrayOfGenres($allowSCMPXextended=false) {
+                static $GenreLookup = 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  => 'Thrash Metal',
+                        145  => 'Anime',
+                        146  => 'JPop',
+                        147  => 'Synthpop',
+
+                        255  => 'Unknown',
+
+                        'CR' => 'Cover',
+                        'RX' => 'Remix'
+                );
+
+                static $GenreLookupSCMPX = array();
+                if ($allowSCMPXextended && empty($GenreLookupSCMPX)) {
+                        $GenreLookupSCMPX = $GenreLookup;
+                        // 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"
+                        $GenreLookupSCMPX[240] = 'Sacred';
+                        $GenreLookupSCMPX[241] = 'Northern Europe';
+                        $GenreLookupSCMPX[242] = 'Irish & Scottish';
+                        $GenreLookupSCMPX[243] = 'Scotland';
+                        $GenreLookupSCMPX[244] = 'Ethnic Europe';
+                        $GenreLookupSCMPX[245] = 'Enka';
+                        $GenreLookupSCMPX[246] = 'Children\'s Song';
+                        $GenreLookupSCMPX[247] = 'Japanese Sky';
+                        $GenreLookupSCMPX[248] = 'Japanese Heavy Rock';
+                        $GenreLookupSCMPX[249] = 'Japanese Doom Rock';
+                        $GenreLookupSCMPX[250] = 'Japanese J-POP';
+                        $GenreLookupSCMPX[251] = 'Japanese Seiyu';
+                        $GenreLookupSCMPX[252] = 'Japanese Ambient Techno';
+                        $GenreLookupSCMPX[253] = 'Japanese Moemoe';
+                        $GenreLookupSCMPX[254] = 'Japanese Tokusatsu';
+                        //$GenreLookupSCMPX[255] = 'Japanese Anime';
+                }
+
+                return ($allowSCMPXextended ? $GenreLookupSCMPX : $GenreLookup);
+        }
+
+        public static function LookupGenreName($genreid, $allowSCMPXextended=true) {
+                switch ($genreid) {
+                        case 'RX':
+                        case 'CR':
+                                break;
+                        default:
+                                if (!is_numeric($genreid)) {
+                                        return false;
+                                }
+                                $genreid = intval($genreid); // to handle 3 or '3' or '03'
+                                break;
+                }
+                $GenreLookup = self::ArrayOfGenres($allowSCMPXextended);
+                return (isset($GenreLookup[$genreid]) ? $GenreLookup[$genreid] : false);
+        }
+
+        public static function LookupGenreID($genre, $allowSCMPXextended=false) {
+                $GenreLookup = self::ArrayOfGenres($allowSCMPXextended);
+                $LowerCaseNoSpaceSearchTerm = strtolower(str_replace(' ', '', $genre));
+                foreach ($GenreLookup as $key => $value) {
+                        if (strtolower(str_replace(' ', '', $value)) == $LowerCaseNoSpaceSearchTerm) {
+                                return $key;
+                        }
+                }
+                return false;
+        }
+
+        public static function StandardiseID3v1GenreName($OriginalGenre) {
+                if (($GenreID = self::LookupGenreID($OriginalGenre)) !== false) {
+                        return self::LookupGenreName($GenreID);
+                }
+                return $OriginalGenre;
+        }
+
+        public static function GenerateID3v1Tag($title, $artist, $album, $year, $genreid, $comment, $track='') {
+                $ID3v1Tag  = 'TAG';
+                $ID3v1Tag .= str_pad(trim(substr($title,  0, 30)), 30, "\x00", STR_PAD_RIGHT);
+                $ID3v1Tag .= str_pad(trim(substr($artist, 0, 30)), 30, "\x00", STR_PAD_RIGHT);
+                $ID3v1Tag .= str_pad(trim(substr($album,  0, 30)), 30, "\x00", STR_PAD_RIGHT);
+                $ID3v1Tag .= str_pad(trim(substr($year,   0,  4)),  4, "\x00", STR_PAD_LEFT);
+                if (!empty($track) && ($track > 0) && ($track <= 255)) {
+                        $ID3v1Tag .= str_pad(trim(substr($comment, 0, 28)), 28, "\x00", STR_PAD_RIGHT);
+                        $ID3v1Tag .= "\x00";
+                        if (gettype($track) == 'string') {
+                                $track = (int) $track;
+                        }
+                        $ID3v1Tag .= chr($track);
+                } else {
+                        $ID3v1Tag .= str_pad(trim(substr($comment, 0, 30)), 30, "\x00", STR_PAD_RIGHT);
+                }
+                if (($genreid < 0) || ($genreid > 147)) {
+                        $genreid = 255; // 'unknown' genre
+                }
+                switch (gettype($genreid)) {
+                        case 'string':
+                        case 'integer':
+                                $ID3v1Tag .= chr(intval($genreid));
+                                break;
+                        default:
+                                $ID3v1Tag .= chr(255); // 'unknown' genre
+                                break;
+                }
+
+                return $ID3v1Tag;
+        }
+
+}

new file wp-includes/ID3/module.tag.id3v2.php

@@ +1 @@
+<?php
+/////////////////////////////////////////////////////////////////
+/// getID3() by James Heinrich <info@getid3.org>               //
+//  available at http://getid3.sourceforge.net                 //
+//            or http://www.getid3.org                         //
+/////////////////////////////////////////////////////////////////
+// See readme.txt for more details                             //
+/////////////////////////////////////////////////////////////////
+///                                                            //
+// module.tag.id3v2.php                                        //
+// module for analyzing ID3v2 tags                             //
+// dependencies: module.tag.id3v1.php                          //
+//                                                            ///
+/////////////////////////////////////////////////////////////////
+
+getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.tag.id3v1.php', __FILE__, true);
+
+class getid3_id3v2 extends getid3_handler
+{
+        public $StartingOffset = 0;
+
+        public function Analyze() {
+                $info = &$this->getid3->info;
+
+                //    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
+                $info['id3v2']['header'] = true;
+                $thisfile_id3v2                  = &$info['id3v2'];
+                $thisfile_id3v2['flags']         =  array();
+                $thisfile_id3v2_flags            = &$thisfile_id3v2['flags'];
+
+
+                fseek($this->getid3->fp, $this->StartingOffset, SEEK_SET);
+                $header = fread($this->getid3->fp, 10);
+                if (substr($header, 0, 3) == 'ID3'  &&  strlen($header) == 10) {
+
+                        $thisfile_id3v2['majorversion'] = ord($header{3});
+                        $thisfile_id3v2['minorversion'] = ord($header{4});
+
+                        // shortcut
+                        $id3v2_majorversion = &$thisfile_id3v2['majorversion'];
+
+                } else {
+
+                        unset($info['id3v2']);
+                        return false;
+
+                }
+
+                if ($id3v2_majorversion > 4) { // this script probably won't correctly parse ID3v2.5.x and above (if it ever exists)
+
+                        $info['error'][] = 'this script only parses up to ID3v2.4.x - this tag is ID3v2.'.$id3v2_majorversion.'.'.$thisfile_id3v2['minorversion'];
+                        return false;
+
+                }
+
+                $id3_flags = ord($header{5});
+                switch ($id3v2_majorversion) {
+                        case 2:
+                                // %ab000000 in v2.2
+                                $thisfile_id3v2_flags['unsynch']     = (bool) ($id3_flags & 0x80); // a - Unsynchronisation
+                                $thisfile_id3v2_flags['compression'] = (bool) ($id3_flags & 0x40); // b - Compression
+                                break;
+
+                        case 3:
+                                // %abc00000 in v2.3
+                                $thisfile_id3v2_flags['unsynch']     = (bool) ($id3_flags & 0x80); // a - Unsynchronisation
+                                $thisfile_id3v2_flags['exthead']     = (bool) ($id3_flags & 0x40); // b - Extended header
+                                $thisfile_id3v2_flags['experim']     = (bool) ($id3_flags & 0x20); // c - Experimental indicator
+                                break;
+
+                        case 4:
+                                // %abcd0000 in v2.4
+                                $thisfile_id3v2_flags['unsynch']     = (bool) ($id3_flags & 0x80); // a - Unsynchronisation
+                                $thisfile_id3v2_flags['exthead']     = (bool) ($id3_flags & 0x40); // b - Extended header
+                                $thisfile_id3v2_flags['experim']     = (bool) ($id3_flags & 0x20); // c - Experimental indicator
+                                $thisfile_id3v2_flags['isfooter']    = (bool) ($id3_flags & 0x10); // d - Footer present
+                                break;
+                }
+
+                $thisfile_id3v2['headerlength'] = getid3_lib::BigEndian2Int(substr($header, 6, 4), 1) + 10; // length of ID3v2 tag in 10-byte header doesn't include 10-byte header length
+
+                $thisfile_id3v2['tag_offset_start'] = $this->StartingOffset;
+                $thisfile_id3v2['tag_offset_end']   = $thisfile_id3v2['tag_offset_start'] + $thisfile_id3v2['headerlength'];
+
+
+
+                // create 'encoding' key - used by getid3::HandleAllTags()
+                // in ID3v2 every field can have it's own encoding type
+                // so force everything to UTF-8 so it can be handled consistantly
+                $thisfile_id3v2['encoding'] = 'UTF-8';
+
+
+        //    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
+
+                $sizeofframes = $thisfile_id3v2['headerlength'] - 10; // not including 10-byte initial header
+                if (!empty($thisfile_id3v2['exthead']['length'])) {
+                        $sizeofframes -= ($thisfile_id3v2['exthead']['length'] + 4);
+                }
+                if (!empty($thisfile_id3v2_flags['isfooter'])) {
+                        $sizeofframes -= 10; // footer takes last 10 bytes of ID3v2 header, after frame data, before audio
+                }
+                if ($sizeofframes > 0) {
+
+                        $framedata = fread($this->getid3->fp, $sizeofframes); // read all frames from file into $framedata variable
+
+                        //    if entire frame data is unsynched, de-unsynch it now (ID3v2.3.x)
+                        if (!empty($thisfile_id3v2_flags['unsynch']) && ($id3v2_majorversion <= 3)) {
+                                $framedata = $this->DeUnsynchronise($framedata);
+                        }
+                        //        [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.
+
+
+                        //$framedataoffset = 10 + ($thisfile_id3v2['exthead']['length'] ? $thisfile_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)
+                        $framedataoffset = 10; // how many bytes into the stream - start from after the 10-byte header
+
+
+                        //    Extended Header
+                        if (!empty($thisfile_id3v2_flags['exthead'])) {
+                                $extended_header_offset = 0;
+
+                                if ($id3v2_majorversion == 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
+
+                                        $thisfile_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 4), 0);
+                                        $extended_header_offset += 4;
+
+                                        $thisfile_id3v2['exthead']['flag_bytes'] = 2;
+                                        $thisfile_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, $thisfile_id3v2['exthead']['flag_bytes']));
+                                        $extended_header_offset += $thisfile_id3v2['exthead']['flag_bytes'];
+
+                                        $thisfile_id3v2['exthead']['flags']['crc'] = (bool) ($thisfile_id3v2['exthead']['flag_raw'] & 0x8000);
+
+                                        $thisfile_id3v2['exthead']['padding_size'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 4));
+                                        $extended_header_offset += 4;
+
+                                        if ($thisfile_id3v2['exthead']['flags']['crc']) {
+                                                $thisfile_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 4));
+                                                $extended_header_offset += 4;
+                                        }
+                                        $extended_header_offset += $thisfile_id3v2['exthead']['padding_size'];
+
+                                } elseif ($id3v2_majorversion == 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
+
+                                        $thisfile_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 4), true);
+                                        $extended_header_offset += 4;
+
+                                        $thisfile_id3v2['exthead']['flag_bytes'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 1)); // should always be 1
+                                        $extended_header_offset += 1;
+
+                                        $thisfile_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, $thisfile_id3v2['exthead']['flag_bytes']));
+                                        $extended_header_offset += $thisfile_id3v2['exthead']['flag_bytes'];
+
+                                        $thisfile_id3v2['exthead']['flags']['update']       = (bool) ($thisfile_id3v2['exthead']['flag_raw'] & 0x40);
+                                        $thisfile_id3v2['exthead']['flags']['crc']          = (bool) ($thisfile_id3v2['exthead']['flag_raw'] & 0x20);
+                                        $thisfile_id3v2['exthead']['flags']['restrictions'] = (bool) ($thisfile_id3v2['exthead']['flag_raw'] & 0x10);
+
+                                        if ($thisfile_id3v2['exthead']['flags']['update']) {
+                                                $ext_header_chunk_length = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 1)); // should be 0
+                                                $extended_header_offset += 1;
+                                        }
+
+                                        if ($thisfile_id3v2['exthead']['flags']['crc']) {
+                                                $ext_header_chunk_length = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 1)); // should be 5
+                                                $extended_header_offset += 1;
+                                                $thisfile_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, $ext_header_chunk_length), true, false);
+                                                $extended_header_offset += $ext_header_chunk_length;
+                                        }
+
+                                        if ($thisfile_id3v2['exthead']['flags']['restrictions']) {
+                                                $ext_header_chunk_length = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 1)); // should be 1
+                                                $extended_header_offset += 1;
+
+                                                // %ppqrrstt
+                                                $restrictions_raw = getid3_lib::BigEndian2Int(substr($framedata, $extended_header_offset, 1));
+                                                $extended_header_offset += 1;
+                                                $thisfile_id3v2['exthead']['flags']['restrictions']['tagsize']  = ($restrictions_raw & 0xC0) >> 6; // p - Tag size restrictions
+                                                $thisfile_id3v2['exthead']['flags']['restrictions']['textenc']  = ($restrictions_raw & 0x20) >> 5; // q - Text encoding restrictions
+                                                $thisfile_id3v2['exthead']['flags']['restrictions']['textsize'] = ($restrictions_raw & 0x18) >> 3; // r - Text fields size restrictions
+                                                $thisfile_id3v2['exthead']['flags']['restrictions']['imgenc']   = ($restrictions_raw & 0x04) >> 2; // s - Image encoding restrictions
+                                                $thisfile_id3v2['exthead']['flags']['restrictions']['imgsize']  = ($restrictions_raw & 0x03) >> 0; // t - Image size restrictions
+
+                                                $thisfile_id3v2['exthead']['flags']['restrictions_text']['tagsize']  = $this->LookupExtendedHeaderRestrictionsTagSizeLimits($thisfile_id3v2['exthead']['flags']['restrictions']['tagsize']);
+                                                $thisfile_id3v2['exthead']['flags']['restrictions_text']['textenc']  = $this->LookupExtendedHeaderRestrictionsTextEncodings($thisfile_id3v2['exthead']['flags']['restrictions']['textenc']);
+                                                $thisfile_id3v2['exthead']['flags']['restrictions_text']['textsize'] = $this->LookupExtendedHeaderRestrictionsTextFieldSize($thisfile_id3v2['exthead']['flags']['restrictions']['textsize']);
+                                                $thisfile_id3v2['exthead']['flags']['restrictions_text']['imgenc']   = $this->LookupExtendedHeaderRestrictionsImageEncoding($thisfile_id3v2['exthead']['flags']['restrictions']['imgenc']);
+                                                $thisfile_id3v2['exthead']['flags']['restrictions_text']['imgsize']  = $this->LookupExtendedHeaderRestrictionsImageSizeSize($thisfile_id3v2['exthead']['flags']['restrictions']['imgsize']);
+                                        }
+
+                                        if ($thisfile_id3v2['exthead']['length'] != $extended_header_offset) {
+                                                $info['warning'][] = 'ID3v2.4 extended header length mismatch (expecting '.intval($thisfile_id3v2['exthead']['length']).', found '.intval($extended_header_offset).')';
+                                        }
+                                }
+
+                                $framedataoffset += $extended_header_offset;
+                                $framedata = substr($framedata, $extended_header_offset);
+                        } // end extended header
+
+
+                        while (isset($framedata) && (strlen($framedata) > 0)) { // cycle through until no more frame data is left to parse
+                                if (strlen($framedata) <= $this->ID3v2HeaderLength($id3v2_majorversion)) {
+                                        // insufficient room left in ID3v2 header for actual data - must be padding
+                                        $thisfile_id3v2['padding']['start']  = $framedataoffset;
+                                        $thisfile_id3v2['padding']['length'] = strlen($framedata);
+                                        $thisfile_id3v2['padding']['valid']  = true;
+                                        for ($i = 0; $i < $thisfile_id3v2['padding']['length']; $i++) {
+                                                if ($framedata{$i} != "\x00") {
+                                                        $thisfile_id3v2['padding']['valid'] = false;
+                                                        $thisfile_id3v2['padding']['errorpos'] = $thisfile_id3v2['padding']['start'] + $i;
+                                                        $info['warning'][] = 'Invalid ID3v2 padding found at offset '.$thisfile_id3v2['padding']['errorpos'].' (the remaining '.($thisfile_id3v2['padding']['length'] - $i).' bytes are considered invalid)';
+                                                        break;
+                                                }
+                                        }
+                                        break; // skip rest of ID3v2 header
+                                }
+                                if ($id3v2_majorversion == 2) {
+                                        // Frame ID  $xx xx xx (three characters)
+                                        // Size      $xx xx xx (24-bit integer)
+                                        // Flags     $xx xx
+
+                                        $frame_header = substr($framedata, 0, 6); // take next 6 bytes for header
+                                        $framedata    = substr($framedata, 6);    // and leave the rest in $framedata
+                                        $frame_name   = substr($frame_header, 0, 3);
+                                        $frame_size   = getid3_lib::BigEndian2Int(substr($frame_header, 3, 3), 0);
+                                        $frame_flags  = 0; // not used for anything in ID3v2.2, just set to avoid E_NOTICEs
+
+                                } elseif ($id3v2_majorversion > 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($framedata, 0, 10); // take next 10 bytes for header
+                                        $framedata    = substr($framedata, 10);    // and leave the rest in $framedata
+
+                                        $frame_name = substr($frame_header, 0, 4);
+                                        if ($id3v2_majorversion == 3) {
+                                                $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4), 0); // 32-bit integer
+                                        } else { // ID3v2.4+
+                                                $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4), 1); // 32-bit synchsafe integer (28-bit value)
+                                        }
+
+                                        if ($frame_size < (strlen($framedata) + 4)) {
+                                                $nextFrameID = substr($framedata, $frame_size, 4);
+                                                if ($this->IsValidID3v2FrameName($nextFrameID, $id3v2_majorversion)) {
+                                                        // 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_majorversion == 4) && ($this->IsValidID3v2FrameName(substr($framedata, getid3_lib::BigEndian2Int(substr($frame_header, 4, 4), 0), 4), 3))) {
+                                                        $info['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_majorversion = 3;
+                                                        $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4), 0); // 32-bit integer
+                                                }
+                                        }
+
+
+                                        $frame_flags = getid3_lib::BigEndian2Int(substr($frame_header, 8, 2));
+                                }
+
+                                if ((($id3v2_majorversion == 2) && ($frame_name == "\x00\x00\x00")) || ($frame_name == "\x00\x00\x00\x00")) {
+                                        // padding encountered
+
+                                        $thisfile_id3v2['padding']['start']  = $framedataoffset;
+                                        $thisfile_id3v2['padding']['length'] = strlen($frame_header) + strlen($framedata);
+                                        $thisfile_id3v2['padding']['valid']  = true;
+
+                                        $len = strlen($framedata);
+                                        for ($i = 0; $i < $len; $i++) {
+                                                if ($framedata{$i} != "\x00") {
+                                                        $thisfile_id3v2['padding']['valid'] = false;
+                                                        $thisfile_id3v2['padding']['errorpos'] = $thisfile_id3v2['padding']['start'] + $i;
+                                                        $info['warning'][] = 'Invalid ID3v2 padding found at offset '.$thisfile_id3v2['padding']['errorpos'].' (the remaining '.($thisfile_id3v2['padding']['length'] - $i).' bytes are considered invalid)';
+                                                        break;
+                                                }
+                                        }
+                                        break; // skip rest of ID3v2 header
+                                }
+
+                                if ($frame_name == 'COM ') {
+                                        $info['warning'][] = 'error parsing "'.$frame_name.'" ('.$framedataoffset.' bytes into the ID3v2.'.$id3v2_majorversion.' tag). (ERROR: IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_majorversion.'))). [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($framedata)) && ($this->IsValidID3v2FrameName($frame_name, $id3v2_majorversion))) {
+
+                                        unset($parsedFrame);
+                                        $parsedFrame['frame_name']      = $frame_name;
+                                        $parsedFrame['frame_flags_raw'] = $frame_flags;
+                                        $parsedFrame['data']            = substr($framedata, 0, $frame_size);
+                                        $parsedFrame['datalength']      = getid3_lib::CastAsInt($frame_size);
+                                        $parsedFrame['dataoffset']      = $framedataoffset;
+
+                                        $this->ParseID3v2Frame($parsedFrame);
+                                        $thisfile_id3v2[$frame_name][] = $parsedFrame;
+
+                                        $framedata = substr($framedata, $frame_size);
+
+                                } else { // invalid frame length or FrameID
+
+                                        if ($frame_size <= strlen($framedata)) {
+
+                                                if ($this->IsValidID3v2FrameName(substr($framedata, $frame_size, 4), $id3v2_majorversion)) {
+
+                                                        // next frame is valid, just skip the current frame
+                                                        $framedata = substr($framedata, $frame_size);
+                                                        $info['warning'][] = 'Next ID3v2 frame is valid, skipping current frame.';
+
+                                                } else {
+
+                                                        // next frame is invalid too, abort processing
+                                                        //unset($framedata);
+                                                        $framedata = null;
+                                                        $info['error'][] = 'Next ID3v2 frame is also invalid, aborting processing.';
+
+                                                }
+
+                                        } elseif ($frame_size == strlen($framedata)) {
+
+                                                // this is the last frame, just skip
+                                                $info['warning'][] = 'This was the last ID3v2 frame.';
+
+                                        } else {
+
+                                                // next frame is invalid too, abort processing
+                                                //unset($framedata);
+                                                $framedata = null;
+                                                $info['warning'][] = 'Invalid ID3v2 frame size, aborting.';
+
+                                        }
+                                        if (!$this->IsValidID3v2FrameName($frame_name, $id3v2_majorversion)) {
+
+                                                switch ($frame_name) {
+                                                        case "\x00\x00".'MP':
+                                                        case "\x00".'MP3':
+                                                        case ' MP3':
+                                                        case 'MP3e':
+                                                        case "\x00".'MP':
+                                                        case ' MP':
+                                                        case 'MP3':
+                                                                $info['warning'][] = 'error parsing "'.$frame_name.'" ('.$framedataoffset.' bytes into the ID3v2.'.$id3v2_majorversion.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_majorversion.'))). [Note: this particular error has been known to happen with tags edited by "MP3ext (www.mutschler.de/mp3ext/)"]';
+                                                                break;
+
+                                                        default:
+                                                                $info['warning'][] = 'error parsing "'.$frame_name.'" ('.$framedataoffset.' bytes into the ID3v2.'.$id3v2_majorversion.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_majorversion.'))).';
+                                                                break;
+                                                }
+
+                                        } elseif (!isset($framedata) || ($frame_size > strlen($framedata))) {
+
+                                                $info['error'][] = 'error parsing "'.$frame_name.'" ('.$framedataoffset.' bytes into the ID3v2.'.$id3v2_majorversion.' tag). (ERROR: $frame_size ('.$frame_size.') > strlen($framedata) ('.(isset($framedata) ? strlen($framedata) : 'null').')).';
+
+                                        } else {
+
+                                                $info['error'][] = 'error parsing "'.$frame_name.'" ('.$framedataoffset.' bytes into the ID3v2.'.$id3v2_majorversion.' tag).';
+
+                                        }
+
+                                }
+                                $framedataoffset += ($frame_size + $this->ID3v2HeaderLength($id3v2_majorversion));
+
+                        }
+
+                }
+
+
+        //    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($thisfile_id3v2_flags['isfooter']) && $thisfile_id3v2_flags['isfooter']) {
+                        $footer = fread($this->getid3->fp, 10);
+                        if (substr($footer, 0, 3) == '3DI') {
+                                $thisfile_id3v2['footer'] = true;
+                                $thisfile_id3v2['majorversion_footer'] = ord($footer{3});
+                                $thisfile_id3v2['minorversion_footer'] = ord($footer{4});
+                        }
+                        if ($thisfile_id3v2['majorversion_footer'] <= 4) {
+                                $id3_flags = ord(substr($footer{5}));
+                                $thisfile_id3v2_flags['unsynch_footer']  = (bool) ($id3_flags & 0x80);
+                                $thisfile_id3v2_flags['extfoot_footer']  = (bool) ($id3_flags & 0x40);
+                                $thisfile_id3v2_flags['experim_footer']  = (bool) ($id3_flags & 0x20);
+                                $thisfile_id3v2_flags['isfooter_footer'] = (bool) ($id3_flags & 0x10);
+
+                                $thisfile_id3v2['footerlength'] = getid3_lib::BigEndian2Int(substr($footer, 6, 4), 1);
+                        }
+                } // end footer
+
+                if (isset($thisfile_id3v2['comments']['genre'])) {
+                        foreach ($thisfile_id3v2['comments']['genre'] as $key => $value) {
+                                unset($thisfile_id3v2['comments']['genre'][$key]);
+                                $thisfile_id3v2['comments'] = getid3_lib::array_merge_noclobber($thisfile_id3v2['comments'], array('genre'=>$this->ParseID3v2GenreString($value)));
+                        }
+                }
+
+                if (isset($thisfile_id3v2['comments']['track'])) {
+                        foreach ($thisfile_id3v2['comments']['track'] as $key => $value) {
+                                if (strstr($value, '/')) {
+                                        list($thisfile_id3v2['comments']['tracknum'][$key], $thisfile_id3v2['comments']['totaltracks'][$key]) = explode('/', $thisfile_id3v2['comments']['track'][$key]);
+                                }
+                        }
+                }
+
+                if (!isset($thisfile_id3v2['comments']['year']) && !empty($thisfile_id3v2['comments']['recording_time'][0]) && preg_match('#^([0-9]{4})#', trim($thisfile_id3v2['comments']['recording_time'][0]), $matches)) {
+                        $thisfile_id3v2['comments']['year'] = array($matches[1]);
+                }
+
+
+                if (!empty($thisfile_id3v2['TXXX'])) {
+                        // MediaMonkey does this, maybe others: write a blank RGAD frame, but put replay-gain adjustment values in TXXX frames
+                        foreach ($thisfile_id3v2['TXXX'] as $txxx_array) {
+                                switch ($txxx_array['description']) {
+                                        case 'replaygain_track_gain':
+                                                if (empty($info['replay_gain']['track']['adjustment']) && !empty($txxx_array['data'])) {
+                                                        $info['replay_gain']['track']['adjustment'] = floatval(trim(str_replace('dB', '', $txxx_array['data'])));
+                                                }
+                                                break;
+                                        case 'replaygain_track_peak':
+                                                if (empty($info['replay_gain']['track']['peak']) && !empty($txxx_array['data'])) {
+                                                        $info['replay_gain']['track']['peak'] = floatval($txxx_array['data']);
+                                                }
+                                                break;
+                                        case 'replaygain_album_gain':
+                                                if (empty($info['replay_gain']['album']['adjustment']) && !empty($txxx_array['data'])) {
+                                                        $info['replay_gain']['album']['adjustment'] = floatval(trim(str_replace('dB', '', $txxx_array['data'])));
+                                                }
+                                                break;
+                                }
+                        }
+                }
+
+
+                // Set avdataoffset
+                $info['avdataoffset'] = $thisfile_id3v2['headerlength'];
+                if (isset($thisfile_id3v2['footer'])) {
+                        $info['avdataoffset'] += 10;
+                }
+
+                return true;
+        }
+
+
+        public function ParseID3v2GenreString($genrestring) {
+                // 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
+                $clean_genres = array();
+                if (strpos($genrestring, "\x00") === false) {
+                        $genrestring = preg_replace('#\(([0-9]{1,3})\)#', '$1'."\x00", $genrestring);
+                }
+                $genre_elements = explode("\x00", $genrestring);
+                foreach ($genre_elements as $element) {
+                        $element = trim($element);
+                        if ($element) {
+                                if (preg_match('#^[0-9]{1,3}#', $element)) {
+                                        $clean_genres[] = getid3_id3v1::LookupGenreName($element);
+                                } else {
+                                        $clean_genres[] = str_replace('((', '(', $element);
+                                }
+                        }
+                }
+                return $clean_genres;
+        }
+
+
+        public function ParseID3v2Frame(&$parsedFrame) {
+
+                // shortcuts
+                $info = &$this->getid3->info;
+                $id3v2_majorversion = $info['id3v2']['majorversion'];
+
+                $parsedFrame['framenamelong']  = $this->FrameNameLongLookup($parsedFrame['frame_name']);
+                if (empty($parsedFrame['framenamelong'])) {
+                        unset($parsedFrame['framenamelong']);
+                }
+                $parsedFrame['framenameshort'] = $this->FrameNameShortLookup($parsedFrame['frame_name']);
+                if (empty($parsedFrame['framenameshort'])) {
+                        unset($parsedFrame['framenameshort']);
+                }
+
+                if ($id3v2_majorversion >= 3) { // frame flags are not part of the ID3v2.2 standard
+                        if ($id3v2_majorversion == 3) {
+                                //    Frame Header Flags
+                                //    %abc00000 %ijk00000
+                                $parsedFrame['flags']['TagAlterPreservation']  = (bool) ($parsedFrame['frame_flags_raw'] & 0x8000); // a - Tag alter preservation
+                                $parsedFrame['flags']['FileAlterPreservation'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x4000); // b - File alter preservation
+                                $parsedFrame['flags']['ReadOnly']              = (bool) ($parsedFrame['frame_flags_raw'] & 0x2000); // c - Read only
+                                $parsedFrame['flags']['compression']           = (bool) ($parsedFrame['frame_flags_raw'] & 0x0080); // i - Compression
+                                $parsedFrame['flags']['Encryption']            = (bool) ($parsedFrame['frame_flags_raw'] & 0x0040); // j - Encryption
+                                $parsedFrame['flags']['GroupingIdentity']      = (bool) ($parsedFrame['frame_flags_raw'] & 0x0020); // k - Grouping identity
+
+                        } elseif ($id3v2_majorversion == 4) {
+                                //    Frame Header Flags
+                                //    %0abc0000 %0h00kmnp
+                                $parsedFrame['flags']['TagAlterPreservation']  = (bool) ($parsedFrame['frame_flags_raw'] & 0x4000); // a - Tag alter preservation
+                                $parsedFrame['flags']['FileAlterPreservation'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x2000); // b - File alter preservation
+                                $parsedFrame['flags']['ReadOnly']              = (bool) ($parsedFrame['frame_flags_raw'] & 0x1000); // c - Read only
+                                $parsedFrame['flags']['GroupingIdentity']      = (bool) ($parsedFrame['frame_flags_raw'] & 0x0040); // h - Grouping identity
+                                $parsedFrame['flags']['compression']           = (bool) ($parsedFrame['frame_flags_raw'] & 0x0008); // k - Compression
+                                $parsedFrame['flags']['Encryption']            = (bool) ($parsedFrame['frame_flags_raw'] & 0x0004); // m - Encryption
+                                $parsedFrame['flags']['Unsynchronisation']     = (bool) ($parsedFrame['frame_flags_raw'] & 0x0002); // n - Unsynchronisation
+                                $parsedFrame['flags']['DataLengthIndicator']   = (bool) ($parsedFrame['frame_flags_raw'] & 0x0001); // p - Data length indicator
+
+                                // Frame-level de-unsynchronisation - ID3v2.4
+                                if ($parsedFrame['flags']['Unsynchronisation']) {
+                                        $parsedFrame['data'] = $this->DeUnsynchronise($parsedFrame['data']);
+                                }
+
+                                if ($parsedFrame['flags']['DataLengthIndicator']) {
+                                        $parsedFrame['data_length_indicator'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], 0, 4), 1);
+                                        $parsedFrame['data']                  =                           substr($parsedFrame['data'], 4);
+                                }
+                        }
+
+                        //    Frame-level de-compression
+                        if ($parsedFrame['flags']['compression']) {
+                                $parsedFrame['decompressed_size'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], 0, 4));
+                                if (!function_exists('gzuncompress')) {
+                                        $info['warning'][] = 'gzuncompress() support required to decompress ID3v2 frame "'.$parsedFrame['frame_name'].'"';
+                                } else {
+                                        if ($decompresseddata = @gzuncompress(substr($parsedFrame['data'], 4))) {
+                                        //if ($decompresseddata = @gzuncompress($parsedFrame['data'])) {
+                                                $parsedFrame['data'] = $decompresseddata;
+                                                unset($decompresseddata);
+                                        } else {
+                                                $info['warning'][] = 'gzuncompress() failed on compressed contents of ID3v2 frame "'.$parsedFrame['frame_name'].'"';
+                                        }
+                                }
+                        }
+                }
+
+                if (!empty($parsedFrame['flags']['DataLengthIndicator'])) {
+                        if ($parsedFrame['data_length_indicator'] != strlen($parsedFrame['data'])) {
+                                $info['warning'][] = 'ID3v2 frame "'.$parsedFrame['frame_name'].'" should be '.$parsedFrame['data_length_indicator'].' bytes long according to DataLengthIndicator, but found '.strlen($parsedFrame['data']).' bytes of data';
+                        }
+                }
+
+                if (isset($parsedFrame['datalength']) && ($parsedFrame['datalength'] == 0)) {
+
+                        $warning = 'Frame "'.$parsedFrame['frame_name'].'" at offset '.$parsedFrame['dataoffset'].' has no data portion';
+                        switch ($parsedFrame['frame_name']) {
+                                case 'WCOM':
+                                        $warning .= ' (this is known to happen with files tagged by RioPort)';
+                                        break;
+
+                                default:
+                                        break;
+                        }
+                        $info['warning'][] = $warning;
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'UFID')) || // 4.1   UFID Unique file identifier
+                        (($id3v2_majorversion == 2) && ($parsedFrame['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'.
+                        // <Header for 'Unique file identifier', ID: 'UFID'>
+                        // Owner identifier        <text string> $00
+                        // Identifier              <up to 64 bytes binary data>
+                        $exploded = explode("\x00", $parsedFrame['data'], 2);
+                        $parsedFrame['ownerid'] = (isset($exploded[0]) ? $exploded[0] : '');
+                        $parsedFrame['data']    = (isset($exploded[1]) ? $exploded[1] : '');
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'TXXX')) || // 4.2.2 TXXX User defined text information frame
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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.
+                        // <Header for 'User defined text information frame', ID: 'TXXX'>
+                        // Text encoding     $xx
+                        // Description       <text string according to encoding> $00 (00)
+                        // Value             <text string according to encoding>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_description) === 0) {
+                                $frame_description = '';
+                        }
+                        $parsedFrame['encodingid']  = $frame_textencoding;
+                        $parsedFrame['encoding']    = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $parsedFrame['description'] = $frame_description;
+                        $parsedFrame['data'] = substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));
+                        if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = trim(getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $parsedFrame['data']));
+                        }
+                        //unset($parsedFrame['data']); do not unset, may be needed elsewhere, e.g. for replaygain
+
+
+                } elseif ($parsedFrame['frame_name']{0} == 'T') { // 4.2. T??[?] Text information frame
+                        //   There may only be one text information frame of its kind in an tag.
+                        // <Header for 'Text information frame', ID: 'T000' - 'TZZZ',
+                        // excluding 'TXXX' described in 4.2.6.>
+                        // Text encoding                $xx
+                        // Information                  <text string(s) according to encoding>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+
+                        $parsedFrame['data'] = (string) substr($parsedFrame['data'], $frame_offset);
+
+                        $parsedFrame['encodingid'] = $frame_textencoding;
+                        $parsedFrame['encoding']   = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                // ID3v2.3 specs say that TPE1 (and others) can contain multiple artist values separated with /
+                                // This of course breaks when an aritst name contains slash character, e.g. "AC/DC"
+                                // MP3tag (maybe others) implement alternative system where multiple artists are null-separated, which makes more sense
+                                // getID3 will split null-separated artists into multiple artists and leave slash-separated ones to the user
+                                switch ($parsedFrame['encoding']) {
+                                        case 'UTF-16':
+                                        case 'UTF-16BE':
+                                        case 'UTF-16LE':
+                                                $wordsize = 2;
+                                                break;
+                                        case 'ISO-8859-1':
+                                        case 'UTF-8':
+                                        default:
+                                                $wordsize = 1;
+                                                break;
+                                }
+                                $Txxx_elements = array();
+                                $Txxx_elements_start_offset = 0;
+                                for ($i = 0; $i < strlen($parsedFrame['data']); $i += $wordsize) {
+                                        if (substr($parsedFrame['data'], $i, $wordsize) == str_repeat("\x00", $wordsize)) {
+                                                $Txxx_elements[] = substr($parsedFrame['data'], $Txxx_elements_start_offset, $i - $Txxx_elements_start_offset);
+                                                $Txxx_elements_start_offset = $i + $wordsize;
+                                        }
+                                }
+                                $Txxx_elements[] = substr($parsedFrame['data'], $Txxx_elements_start_offset, $i - $Txxx_elements_start_offset);
+                                foreach ($Txxx_elements as $Txxx_element) {
+                                        $string = getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $Txxx_element);
+                                        if (!empty($string)) {
+                                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = $string;
+                                        }
+                                }
+                                unset($string, $wordsize, $i, $Txxx_elements, $Txxx_element, $Txxx_elements_start_offset);
+                        }
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'WXXX')) || // 4.3.2 WXXX User defined URL link frame
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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
+                        // <Header for 'User defined URL link frame', ID: 'WXXX'>
+                        // Text encoding     $xx
+                        // Description       <text string according to encoding> $00 (00)
+                        // URL               <text string>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+
+                        if (ord($frame_description) === 0) {
+                                $frame_description = '';
+                        }
+                        $parsedFrame['data'] = substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding));
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        if ($frame_terminatorpos) {
+                                // 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($parsedFrame['data'], 0, $frame_terminatorpos);
+                        } else {
+                                // no null bytes following data, just use all data
+                                $frame_urldata = (string) $parsedFrame['data'];
+                        }
+
+                        $parsedFrame['encodingid']  = $frame_textencoding;
+                        $parsedFrame['encoding']    = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $parsedFrame['url']         = $frame_urldata;
+                        $parsedFrame['description'] = $frame_description;
+                        if (!empty($parsedFrame['framenameshort']) && $parsedFrame['url']) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $parsedFrame['url']);
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ($parsedFrame['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
+                        // <Header for 'URL link frame', ID: 'W000' - 'WZZZ', excluding 'WXXX'
+                        // described in 4.3.2.>
+                        // URL              <text string>
+
+                        $parsedFrame['url'] = trim($parsedFrame['data']);
+                        if (!empty($parsedFrame['framenameshort']) && $parsedFrame['url']) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = $parsedFrame['url'];
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion == 3) && ($parsedFrame['frame_name'] == 'IPLS')) || // 4.4  IPLS Involved people list (ID3v2.3 only)
+                                (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'IPL'))) {     // 4.4  IPL  Involved people list (ID3v2.2 only)
+                        // http://id3.org/id3v2.3.0#sec4.4
+                        //   There may only be one 'IPL' frame in each tag
+                        // <Header for 'User defined URL link frame', ID: 'IPL'>
+                        // Text encoding     $xx
+                        // People list strings    <textstrings>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $parsedFrame['encodingid'] = $frame_textencoding;
+                        $parsedFrame['encoding']   = $this->TextEncodingNameLookup($parsedFrame['encodingid']);
+                        $parsedFrame['data_raw']   = (string) substr($parsedFrame['data'], $frame_offset);
+
+                        // http://www.getid3.org/phpBB3/viewtopic.php?t=1369
+                        // "this tag typically contains null terminated strings, which are associated in pairs"
+                        // "there are users that use the tag incorrectly"
+                        $IPLS_parts = array();
+                        if (strpos($parsedFrame['data_raw'], "\x00") !== false) {
+                                $IPLS_parts_unsorted = array();
+                                if (((strlen($parsedFrame['data_raw']) % 2) == 0) && ((substr($parsedFrame['data_raw'], 0, 2) == "\xFF\xFE") || (substr($parsedFrame['data_raw'], 0, 2) == "\xFE\xFF"))) {
+                                        // UTF-16, be careful looking for null bytes since most 2-byte characters may contain one; you need to find twin null bytes, and on even padding
+                                        $thisILPS  = '';
+                                        for ($i = 0; $i < strlen($parsedFrame['data_raw']); $i += 2) {
+                                                $twobytes = substr($parsedFrame['data_raw'], $i, 2);
+                                                if ($twobytes === "\x00\x00") {
+                                                        $IPLS_parts_unsorted[] = getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $thisILPS);
+                                                        $thisILPS  = '';
+                                                } else {
+                                                        $thisILPS .= $twobytes;
+                                                }
+                                        }
+                                        if (strlen($thisILPS) > 2) { // 2-byte BOM
+                                                $IPLS_parts_unsorted[] = getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $thisILPS);
+                                        }
+                                } else {
+                                        // ISO-8859-1 or UTF-8 or other single-byte-null character set
+                                        $IPLS_parts_unsorted = explode("\x00", $parsedFrame['data_raw']);
+                                }
+                                if (count($IPLS_parts_unsorted) == 1) {
+                                        // just a list of names, e.g. "Dino Baptiste, Jimmy Copley, John Gordon, Bernie Marsden, Sharon Watson"
+                                        foreach ($IPLS_parts_unsorted as $key => $value) {
+                                                $IPLS_parts_sorted = preg_split('#[;,\\r\\n\\t]#', $value);
+                                                $position = '';
+                                                foreach ($IPLS_parts_sorted as $person) {
+                                                        $IPLS_parts[] = array('position'=>$position, 'person'=>$person);
+                                                }
+                                        }
+                                } elseif ((count($IPLS_parts_unsorted) % 2) == 0) {
+                                        $position = '';
+                                        $person   = '';
+                                        foreach ($IPLS_parts_unsorted as $key => $value) {
+                                                if (($key % 2) == 0) {
+                                                        $position = $value;
+                                                } else {
+                                                        $person   = $value;
+                                                        $IPLS_parts[] = array('position'=>$position, 'person'=>$person);
+                                                        $position = '';
+                                                        $person   = '';
+                                                }
+                                        }
+                                } else {
+                                        foreach ($IPLS_parts_unsorted as $key => $value) {
+                                                $IPLS_parts[] = array($value);
+                                        }
+                                }
+
+                        } else {
+                                $IPLS_parts = preg_split('#[;,\\r\\n\\t]#', $parsedFrame['data_raw']);
+                        }
+                        $parsedFrame['data'] = $IPLS_parts;
+
+                        if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = $parsedFrame['data'];
+                        }
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'MCDI')) || // 4.4   MCDI Music CD identifier
+                                (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'MCI'))) {     // 4.5   MCI  Music CD identifier
+                        //   There may only be one 'MCDI' frame in each tag
+                        // <Header for 'Music CD identifier', ID: 'MCDI'>
+                        // CD TOC                <binary data>
+
+                        if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = $parsedFrame['data'];
+                        }
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'ETCO')) || // 4.5   ETCO Event timing codes
+                                (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'ETC'))) {     // 4.6   ETC  Event timing codes
+                        //   There may only be one 'ETCO' frame in each tag
+                        // <Header for 'Event timing codes', ID: 'ETCO'>
+                        // 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;
+                        $parsedFrame['timestampformat'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+
+                        while ($frame_offset < strlen($parsedFrame['data'])) {
+                                $parsedFrame['typeid']    = substr($parsedFrame['data'], $frame_offset++, 1);
+                                $parsedFrame['type']      = $this->ETCOEventLookup($parsedFrame['typeid']);
+                                $parsedFrame['timestamp'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));
+                                $frame_offset += 4;
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'MLLT')) || // 4.6   MLLT MPEG location lookup table
+                                (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'MLL'))) {     // 4.7   MLL MPEG location lookup table
+                        //   There may only be one 'MLLT' frame in each tag
+                        // <Header for 'Location lookup table', ID: 'MLLT'>
+                        // 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;
+                        $parsedFrame['framesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], 0, 2));
+                        $parsedFrame['bytesbetweenreferences']  = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], 2, 3));
+                        $parsedFrame['msbetweenreferences']     = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], 5, 3));
+                        $parsedFrame['bitsforbytesdeviation']   = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], 8, 1));
+                        $parsedFrame['bitsformsdeviation']      = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], 9, 1));
+                        $parsedFrame['data'] = substr($parsedFrame['data'], 10);
+                        while ($frame_offset < strlen($parsedFrame['data'])) {
+                                $deviationbitstream .= getid3_lib::BigEndian2Bin(substr($parsedFrame['data'], $frame_offset++, 1));
+                        }
+                        $reference_counter = 0;
+                        while (strlen($deviationbitstream) > 0) {
+                                $parsedFrame[$reference_counter]['bytedeviation'] = bindec(substr($deviationbitstream, 0, $parsedFrame['bitsforbytesdeviation']));
+                                $parsedFrame[$reference_counter]['msdeviation']   = bindec(substr($deviationbitstream, $parsedFrame['bitsforbytesdeviation'], $parsedFrame['bitsformsdeviation']));
+                                $deviationbitstream = substr($deviationbitstream, $parsedFrame['bitsforbytesdeviation'] + $parsedFrame['bitsformsdeviation']);
+                                $reference_counter++;
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'SYTC')) || // 4.7   SYTC Synchronised tempo codes
+                                  (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'STC'))) {  // 4.8   STC  Synchronised tempo codes
+                        //   There may only be one 'SYTC' frame in each tag
+                        // <Header for 'Synchronised tempo codes', ID: 'SYTC'>
+                        // Time stamp format   $xx
+                        // Tempo data          <binary 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;
+                        $parsedFrame['timestampformat'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $timestamp_counter = 0;
+                        while ($frame_offset < strlen($parsedFrame['data'])) {
+                                $parsedFrame[$timestamp_counter]['tempo'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                                if ($parsedFrame[$timestamp_counter]['tempo'] == 255) {
+                                        $parsedFrame[$timestamp_counter]['tempo'] += ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                                }
+                                $parsedFrame[$timestamp_counter]['timestamp'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));
+                                $frame_offset += 4;
+                                $timestamp_counter++;
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'USLT')) || // 4.8   USLT Unsynchronised lyric/text transcription
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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.
+                        // <Header for 'Unsynchronised lyrics/text transcription', ID: 'USLT'>
+                        // Text encoding        $xx
+                        // Language             $xx xx xx
+                        // Content descriptor   <text string according to encoding> $00 (00)
+                        // Lyrics/text          <full text string according to encoding>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $frame_language = substr($parsedFrame['data'], $frame_offset, 3);
+                        $frame_offset += 3;
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_description) === 0) {
+                                $frame_description = '';
+                        }
+                        $parsedFrame['data'] = substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));
+
+                        $parsedFrame['encodingid']   = $frame_textencoding;
+                        $parsedFrame['encoding']     = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $parsedFrame['data']         = $parsedFrame['data'];
+                        $parsedFrame['language']     = $frame_language;
+                        $parsedFrame['languagename'] = $this->LanguageLookup($frame_language, false);
+                        $parsedFrame['description']  = $frame_description;
+                        if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $parsedFrame['data']);
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'SYLT')) || // 4.9   SYLT Synchronised lyric/text
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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.
+                        // <Header for 'Synchronised lyrics/text', ID: 'SYLT'>
+                        // 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   <text string according to encoding> $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_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $frame_language = substr($parsedFrame['data'], $frame_offset, 3);
+                        $frame_offset += 3;
+                        $parsedFrame['timestampformat'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['contenttypeid']   = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['contenttype']     = $this->SYTLContentTypeLookup($parsedFrame['contenttypeid']);
+                        $parsedFrame['encodingid']      = $frame_textencoding;
+                        $parsedFrame['encoding']        = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $parsedFrame['language']        = $frame_language;
+                        $parsedFrame['languagename']    = $this->LanguageLookup($frame_language, false);
+
+                        $timestampindex = 0;
+                        $frame_remainingdata = substr($parsedFrame['data'], $frame_offset);
+                        while (strlen($frame_remainingdata)) {
+                                $frame_offset = 0;
+                                $frame_terminatorpos = strpos($frame_remainingdata, $this->TextEncodingTerminatorLookup($frame_textencoding));
+                                if ($frame_terminatorpos === false) {
+                                        $frame_remainingdata = '';
+                                } else {
+                                        if (ord(substr($frame_remainingdata, $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                                        }
+                                        $parsedFrame['lyrics'][$timestampindex]['data'] = substr($frame_remainingdata, $frame_offset, $frame_terminatorpos - $frame_offset);
+
+                                        $frame_remainingdata = substr($frame_remainingdata, $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));
+                                        if (($timestampindex == 0) && (ord($frame_remainingdata{0}) != 0)) {
+                                                // timestamp probably omitted for first data item
+                                        } else {
+                                                $parsedFrame['lyrics'][$timestampindex]['timestamp'] = getid3_lib::BigEndian2Int(substr($frame_remainingdata, 0, 4));
+                                                $frame_remainingdata = substr($frame_remainingdata, 4);
+                                        }
+                                        $timestampindex++;
+                                }
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'COMM')) || // 4.10  COMM Comments
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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.
+                        // <Header for 'Comment', ID: 'COMM'>
+                        // Text encoding          $xx
+                        // Language               $xx xx xx
+                        // Short content descrip. <text string according to encoding> $00 (00)
+                        // The actual text        <full text string according to encoding>
+
+                        if (strlen($parsedFrame['data']) < 5) {
+
+                                $info['warning'][] = 'Invalid data (too short) for "'.$parsedFrame['frame_name'].'" frame at offset '.$parsedFrame['dataoffset'];
+
+                        } else {
+
+                                $frame_offset = 0;
+                                $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                                if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                        $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                                }
+                                $frame_language = substr($parsedFrame['data'], $frame_offset, 3);
+                                $frame_offset += 3;
+                                $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                                if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                        $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                                }
+                                $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                                if (ord($frame_description) === 0) {
+                                        $frame_description = '';
+                                }
+                                $frame_text = (string) substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));
+
+                                $parsedFrame['encodingid']   = $frame_textencoding;
+                                $parsedFrame['encoding']     = $this->TextEncodingNameLookup($frame_textencoding);
+
+                                $parsedFrame['language']     = $frame_language;
+                                $parsedFrame['languagename'] = $this->LanguageLookup($frame_language, false);
+                                $parsedFrame['description']  = $frame_description;
+                                $parsedFrame['data']         = $frame_text;
+                                if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                        $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $parsedFrame['data']);
+                                }
+
+                        }
+
+                } elseif (($id3v2_majorversion >= 4) && ($parsedFrame['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
+                        // <Header for 'Relative volume adjustment (2)', ID: 'RVA2'>
+                        // Identification          <text string> $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_terminatorpos = strpos($parsedFrame['data'], "\x00");
+                        $frame_idstring = substr($parsedFrame['data'], 0, $frame_terminatorpos);
+                        if (ord($frame_idstring) === 0) {
+                                $frame_idstring = '';
+                        }
+                        $frame_remainingdata = substr($parsedFrame['data'], $frame_terminatorpos + strlen("\x00"));
+                        $parsedFrame['description'] = $frame_idstring;
+                        $RVA2channelcounter = 0;
+                        while (strlen($frame_remainingdata) >= 5) {
+                                $frame_offset = 0;
+                                $frame_channeltypeid = ord(substr($frame_remainingdata, $frame_offset++, 1));
+                                $parsedFrame[$RVA2channelcounter]['channeltypeid']  = $frame_channeltypeid;
+                                $parsedFrame[$RVA2channelcounter]['channeltype']    = $this->RVA2ChannelTypeLookup($frame_channeltypeid);
+                                $parsedFrame[$RVA2channelcounter]['volumeadjust']   = getid3_lib::BigEndian2Int(substr($frame_remainingdata, $frame_offset, 2), false, true); // 16-bit signed
+                                $frame_offset += 2;
+                                $parsedFrame[$RVA2channelcounter]['bitspeakvolume'] = ord(substr($frame_remainingdata, $frame_offset++, 1));
+                                if (($parsedFrame[$RVA2channelcounter]['bitspeakvolume'] < 1) || ($parsedFrame[$RVA2channelcounter]['bitspeakvolume'] > 4)) {
+                                        $info['warning'][] = 'ID3v2::RVA2 frame['.$RVA2channelcounter.'] contains invalid '.$parsedFrame[$RVA2channelcounter]['bitspeakvolume'].'-byte bits-representing-peak value';
+                                        break;
+                                }
+                                $frame_bytespeakvolume = ceil($parsedFrame[$RVA2channelcounter]['bitspeakvolume'] / 8);
+                                $parsedFrame[$RVA2channelcounter]['peakvolume']     = getid3_lib::BigEndian2Int(substr($frame_remainingdata, $frame_offset, $frame_bytespeakvolume));
+                                $frame_remainingdata = substr($frame_remainingdata, $frame_offset + $frame_bytespeakvolume);
+                                $RVA2channelcounter++;
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion == 3) && ($parsedFrame['frame_name'] == 'RVAD')) || // 4.12  RVAD Relative volume adjustment (ID3v2.3 only)
+                                  (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'RVA'))) {  // 4.12  RVA  Relative volume adjustment (ID3v2.2 only)
+                        //   There may only be one 'RVA' frame in each tag
+                        // <Header for 'Relative volume adjustment', ID: 'RVA'>
+                        // 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(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['incdec']['right'] = (bool) substr($frame_incrdecrflags, 6, 1);
+                        $parsedFrame['incdec']['left']  = (bool) substr($frame_incrdecrflags, 7, 1);
+                        $parsedFrame['bitsvolume'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $frame_bytesvolume = ceil($parsedFrame['bitsvolume'] / 8);
+                        $parsedFrame['volumechange']['right'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                        if ($parsedFrame['incdec']['right'] === false) {
+                                $parsedFrame['volumechange']['right'] *= -1;
+                        }
+                        $frame_offset += $frame_bytesvolume;
+                        $parsedFrame['volumechange']['left'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                        if ($parsedFrame['incdec']['left'] === false) {
+                                $parsedFrame['volumechange']['left'] *= -1;
+                        }
+                        $frame_offset += $frame_bytesvolume;
+                        $parsedFrame['peakvolume']['right'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                        $frame_offset += $frame_bytesvolume;
+                        $parsedFrame['peakvolume']['left']  = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                        $frame_offset += $frame_bytesvolume;
+                        if ($id3v2_majorversion == 3) {
+                                $parsedFrame['data'] = substr($parsedFrame['data'], $frame_offset);
+                                if (strlen($parsedFrame['data']) > 0) {
+                                        $parsedFrame['incdec']['rightrear'] = (bool) substr($frame_incrdecrflags, 4, 1);
+                                        $parsedFrame['incdec']['leftrear']  = (bool) substr($frame_incrdecrflags, 5, 1);
+                                        $parsedFrame['volumechange']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        if ($parsedFrame['incdec']['rightrear'] === false) {
+                                                $parsedFrame['volumechange']['rightrear'] *= -1;
+                                        }
+                                        $frame_offset += $frame_bytesvolume;
+                                        $parsedFrame['volumechange']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        if ($parsedFrame['incdec']['leftrear'] === false) {
+                                                $parsedFrame['volumechange']['leftrear'] *= -1;
+                                        }
+                                        $frame_offset += $frame_bytesvolume;
+                                        $parsedFrame['peakvolume']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        $frame_offset += $frame_bytesvolume;
+                                        $parsedFrame['peakvolume']['leftrear']  = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        $frame_offset += $frame_bytesvolume;
+                                }
+                                $parsedFrame['data'] = substr($parsedFrame['data'], $frame_offset);
+                                if (strlen($parsedFrame['data']) > 0) {
+                                        $parsedFrame['incdec']['center'] = (bool) substr($frame_incrdecrflags, 3, 1);
+                                        $parsedFrame['volumechange']['center'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        if ($parsedFrame['incdec']['center'] === false) {
+                                                $parsedFrame['volumechange']['center'] *= -1;
+                                        }
+                                        $frame_offset += $frame_bytesvolume;
+                                        $parsedFrame['peakvolume']['center'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        $frame_offset += $frame_bytesvolume;
+                                }
+                                $parsedFrame['data'] = substr($parsedFrame['data'], $frame_offset);
+                                if (strlen($parsedFrame['data']) > 0) {
+                                        $parsedFrame['incdec']['bass'] = (bool) substr($frame_incrdecrflags, 2, 1);
+                                        $parsedFrame['volumechange']['bass'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        if ($parsedFrame['incdec']['bass'] === false) {
+                                                $parsedFrame['volumechange']['bass'] *= -1;
+                                        }
+                                        $frame_offset += $frame_bytesvolume;
+                                        $parsedFrame['peakvolume']['bass'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesvolume));
+                                        $frame_offset += $frame_bytesvolume;
+                                }
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif (($id3v2_majorversion >= 4) && ($parsedFrame['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
+                        // <Header of 'Equalisation (2)', ID: 'EQU2'>
+                        // Interpolation method  $xx
+                        //   $00  Band
+                        //   $01  Linear
+                        // Identification        <text string> $00
+                        //   The following is then repeated for every adjustment point
+                        // Frequency          $xx xx
+                        // Volume adjustment  $xx xx
+
+                        $frame_offset = 0;
+                        $frame_interpolationmethod = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_idstring = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_idstring) === 0) {
+                                $frame_idstring = '';
+                        }
+                        $parsedFrame['description'] = $frame_idstring;
+                        $frame_remainingdata = substr($parsedFrame['data'], $frame_terminatorpos + strlen("\x00"));
+                        while (strlen($frame_remainingdata)) {
+                                $frame_frequency = getid3_lib::BigEndian2Int(substr($frame_remainingdata, 0, 2)) / 2;
+                                $parsedFrame['data'][$frame_frequency] = getid3_lib::BigEndian2Int(substr($frame_remainingdata, 2, 2), false, true);
+                                $frame_remainingdata = substr($frame_remainingdata, 4);
+                        }
+                        $parsedFrame['interpolationmethod'] = $frame_interpolationmethod;
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion == 3) && ($parsedFrame['frame_name'] == 'EQUA')) || // 4.12  EQUA Equalisation (ID3v2.3 only)
+                                (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'EQU'))) {     // 4.13  EQU  Equalisation (ID3v2.2 only)
+                        //   There may only be one 'EQUA' frame in each tag
+                        // <Header for 'Relative volume adjustment', ID: 'EQU'>
+                        // 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;
+                        $parsedFrame['adjustmentbits'] = substr($parsedFrame['data'], $frame_offset++, 1);
+                        $frame_adjustmentbytes = ceil($parsedFrame['adjustmentbits'] / 8);
+
+                        $frame_remainingdata = (string) substr($parsedFrame['data'], $frame_offset);
+                        while (strlen($frame_remainingdata) > 0) {
+                                $frame_frequencystr = getid3_lib::BigEndian2Bin(substr($frame_remainingdata, 0, 2));
+                                $frame_incdec    = (bool) substr($frame_frequencystr, 0, 1);
+                                $frame_frequency = bindec(substr($frame_frequencystr, 1, 15));
+                                $parsedFrame[$frame_frequency]['incdec'] = $frame_incdec;
+                                $parsedFrame[$frame_frequency]['adjustment'] = getid3_lib::BigEndian2Int(substr($frame_remainingdata, 2, $frame_adjustmentbytes));
+                                if ($parsedFrame[$frame_frequency]['incdec'] === false) {
+                                        $parsedFrame[$frame_frequency]['adjustment'] *= -1;
+                                }
+                                $frame_remainingdata = substr($frame_remainingdata, 2 + $frame_adjustmentbytes);
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'RVRB')) || // 4.13  RVRB Reverb
+                                (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'REV'))) {     // 4.14  REV  Reverb
+                        //   There may only be one 'RVRB' frame in each tag.
+                        // <Header for 'Reverb', ID: 'RVRB'>
+                        // 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;
+                        $parsedFrame['left']  = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 2));
+                        $frame_offset += 2;
+                        $parsedFrame['right'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 2));
+                        $frame_offset += 2;
+                        $parsedFrame['bouncesL']      = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['bouncesR']      = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['feedbackLL']    = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['feedbackLR']    = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['feedbackRR']    = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['feedbackRL']    = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['premixLR']      = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['premixRL']      = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'APIC')) || // 4.14  APIC Attached picture
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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
+                        // <Header for 'Attached picture', ID: 'APIC'>
+                        // Text encoding      $xx
+                        // ID3v2.3+ => MIME type          <text string> $00
+                        // ID3v2.2  => Image format       $xx xx xx
+                        // Picture type       $xx
+                        // Description        <text string according to encoding> $00 (00)
+                        // Picture data       <binary data>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+
+                        if ($id3v2_majorversion == 2 && strlen($parsedFrame['data']) > $frame_offset) {
+                                $frame_imagetype = substr($parsedFrame['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_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                                        $frame_mimetype = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $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_terminatorpos + strlen("\x00");
+                                } else {
+                                        $frame_offset += 3;
+                                }
+                        }
+                        if ($id3v2_majorversion > 2 && strlen($parsedFrame['data']) > $frame_offset) {
+                                $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                                $frame_mimetype = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                                if (ord($frame_mimetype) === 0) {
+                                        $frame_mimetype = '';
+                                }
+                                $frame_offset = $frame_terminatorpos + strlen("\x00");
+                        }
+
+                        $frame_picturetype = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+
+                        if ($frame_offset >= $parsedFrame['datalength']) {
+                                $info['warning'][] = 'data portion of APIC frame is missing at offset '.($parsedFrame['dataoffset'] + 8 + $frame_offset);
+                        } else {
+                                $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                                if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                        $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                                }
+                                $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                                if (ord($frame_description) === 0) {
+                                        $frame_description = '';
+                                }
+                                $parsedFrame['encodingid']       = $frame_textencoding;
+                                $parsedFrame['encoding']         = $this->TextEncodingNameLookup($frame_textencoding);
+
+                                if ($id3v2_majorversion == 2) {
+                                        $parsedFrame['imagetype']    = $frame_imagetype;
+                                } else {
+                                        $parsedFrame['mime']         = $frame_mimetype;
+                                }
+                                $parsedFrame['picturetypeid']    = $frame_picturetype;
+                                $parsedFrame['picturetype']      = $this->APICPictureTypeLookup($frame_picturetype);
+                                $parsedFrame['description']      = $frame_description;
+                                $parsedFrame['data']             = substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));
+                                $parsedFrame['datalength']       = strlen($parsedFrame['data']);
+
+                                $parsedFrame['image_mime'] = '';
+                                $imageinfo = array();
+                                $imagechunkcheck = getid3_lib::GetDataImageSize($parsedFrame['data'], $imageinfo);
+                                if (($imagechunkcheck[2] >= 1) && ($imagechunkcheck[2] <= 3)) {
+                                        $parsedFrame['image_mime']       = 'image/'.getid3_lib::ImageTypesLookup($imagechunkcheck[2]);
+                                        if ($imagechunkcheck[0]) {
+                                                $parsedFrame['image_width']  = $imagechunkcheck[0];
+                                        }
+                                        if ($imagechunkcheck[1]) {
+                                                $parsedFrame['image_height'] = $imagechunkcheck[1];
+                                        }
+                                }
+
+                                do {
+                                        if ($this->getid3->option_save_attachments === false) {
+                                                // skip entirely
+                                                unset($parsedFrame['data']);
+                                                break;
+                                        }
+                                        if ($this->getid3->option_save_attachments === true) {
+                                                // great
+/*
+                                        } elseif (is_int($this->getid3->option_save_attachments)) {
+                                                if ($this->getid3->option_save_attachments < $parsedFrame['data_length']) {
+                                                        // too big, skip
+                                                        $info['warning'][] = 'attachment at '.$frame_offset.' is too large to process inline ('.number_format($parsedFrame['data_length']).' bytes)';
+                                                        unset($parsedFrame['data']);
+                                                        break;
+                                                }
+*/
+                                        } elseif (is_string($this->getid3->option_save_attachments)) {
+                                                $dir = rtrim(str_replace(array('/', '\\'), DIRECTORY_SEPARATOR, $this->getid3->option_save_attachments), DIRECTORY_SEPARATOR);
+                                                if (!is_dir($dir) || !is_writable($dir)) {
+                                                        // cannot write, skip
+                                                        $info['warning'][] = 'attachment at '.$frame_offset.' cannot be saved to "'.$dir.'" (not writable)';
+                                                        unset($parsedFrame['data']);
+                                                        break;
+                                                }
+                                        }
+                                        // if we get this far, must be OK
+                                        if (is_string($this->getid3->option_save_attachments)) {
+                                                $destination_filename = $dir.DIRECTORY_SEPARATOR.md5($info['filenamepath']).'_'.$frame_offset;
+                                                if (!file_exists($destination_filename) || is_writable($destination_filename)) {
+                                                        file_put_contents($destination_filename, $parsedFrame['data']);
+                                                } else {
+                                                        $info['warning'][] = 'attachment at '.$frame_offset.' cannot be saved to "'.$destination_filename.'" (not writable)';
+                                                }
+                                                $parsedFrame['data_filename'] = $destination_filename;
+                                                unset($parsedFrame['data']);
+                                        } else {
+                                                if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                                        if (!isset($info['id3v2']['comments']['picture'])) {
+                                                                $info['id3v2']['comments']['picture'] = array();
+                                                        }
+                                                        $info['id3v2']['comments']['picture'][] = array('data'=>$parsedFrame['data'], 'image_mime'=>$parsedFrame['image_mime']);
+                                                }
+                                        }
+                                } while (false);
+                        }
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'GEOB')) || // 4.15  GEOB General encapsulated object
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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
+                        // <Header for 'General encapsulated object', ID: 'GEOB'>
+                        // Text encoding          $xx
+                        // MIME type              <text string> $00
+                        // Filename               <text string according to encoding> $00 (00)
+                        // Content description    <text string according to encoding> $00 (00)
+                        // Encapsulated object    <binary data>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_mimetype = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_mimetype) === 0) {
+                                $frame_mimetype = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        $frame_filename = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_filename) === 0) {
+                                $frame_filename = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding));
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_description) === 0) {
+                                $frame_description = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding));
+
+                        $parsedFrame['objectdata']  = (string) substr($parsedFrame['data'], $frame_offset);
+                        $parsedFrame['encodingid']  = $frame_textencoding;
+                        $parsedFrame['encoding']    = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $parsedFrame['mime']        = $frame_mimetype;
+                        $parsedFrame['filename']    = $frame_filename;
+                        $parsedFrame['description'] = $frame_description;
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'PCNT')) || // 4.16  PCNT Play counter
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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
+                        // <Header for 'Play counter', ID: 'PCNT'>
+                        // Counter        $xx xx xx xx (xx ...)
+
+                        $parsedFrame['data']          = getid3_lib::BigEndian2Int($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'POPM')) || // 4.17  POPM Popularimeter
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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
+                        // <Header for 'Popularimeter', ID: 'POPM'>
+                        // Email to user   <text string> $00
+                        // Rating          $xx
+                        // Counter         $xx xx xx xx (xx ...)
+
+                        $frame_offset = 0;
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_emailaddress = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_emailaddress) === 0) {
+                                $frame_emailaddress = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+                        $frame_rating = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['counter'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset));
+                        $parsedFrame['email']   = $frame_emailaddress;
+                        $parsedFrame['rating']  = $frame_rating;
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'RBUF')) || // 4.18  RBUF Recommended buffer size
+                                (($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'BUF'))) {     // 4.19  BUF  Recommended buffer size
+                        //   There may only be one 'RBUF' frame in each tag
+                        // <Header for 'Recommended buffer size', ID: 'RBUF'>
+                        // Buffer size               $xx xx xx
+                        // Embedded info flag        %0000000x
+                        // Offset to next tag        $xx xx xx xx
+
+                        $frame_offset = 0;
+                        $parsedFrame['buffersize'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 3));
+                        $frame_offset += 3;
+
+                        $frame_embeddedinfoflags = getid3_lib::BigEndian2Bin(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['flags']['embededinfo'] = (bool) substr($frame_embeddedinfoflags, 7, 1);
+                        $parsedFrame['nexttagoffset'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));
+                        unset($parsedFrame['data']);
+
+
+                } elseif (($id3v2_majorversion == 2) && ($parsedFrame['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'
+                        // <Header for 'Encrypted meta frame', ID: 'CRM'>
+                        // Owner identifier      <textstring> $00 (00)
+                        // Content/explanation   <textstring> $00 (00)
+                        // Encrypted datablock   <binary data>
+
+                        $frame_offset = 0;
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_ownerid = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_description) === 0) {
+                                $frame_description = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $parsedFrame['ownerid']     = $frame_ownerid;
+                        $parsedFrame['data']        = (string) substr($parsedFrame['data'], $frame_offset);
+                        $parsedFrame['description'] = $frame_description;
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'AENC')) || // 4.19  AENC Audio encryption
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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'
+                        // <Header for 'Audio encryption', ID: 'AENC'>
+                        // Owner identifier   <text string> $00
+                        // Preview start      $xx xx
+                        // Preview length     $xx xx
+                        // Encryption info    <binary data>
+
+                        $frame_offset = 0;
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_ownerid = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_ownerid) === 0) {
+                                $frame_ownerid == '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+                        $parsedFrame['ownerid'] = $frame_ownerid;
+                        $parsedFrame['previewstart'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 2));
+                        $frame_offset += 2;
+                        $parsedFrame['previewlength'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 2));
+                        $frame_offset += 2;
+                        $parsedFrame['encryptioninfo'] = (string) substr($parsedFrame['data'], $frame_offset);
+                        unset($parsedFrame['data']);
+
+
+                } elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'LINK')) || // 4.20  LINK Linked information
+                                (($id3v2_majorversion == 2) && ($parsedFrame['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
+                        // <Header for 'Linked information', ID: 'LINK'>
+                        // ID3v2.3+ => Frame identifier   $xx xx xx xx
+                        // ID3v2.2  => Frame identifier   $xx xx xx
+                        // URL                            <text string> $00
+                        // ID and additional data         <text string(s)>
+
+                        $frame_offset = 0;
+                        if ($id3v2_majorversion == 2) {
+                                $parsedFrame['frameid'] = substr($parsedFrame['data'], $frame_offset, 3);
+                                $frame_offset += 3;
+                        } else {
+                                $parsedFrame['frameid'] = substr($parsedFrame['data'], $frame_offset, 4);
+                                $frame_offset += 4;
+                        }
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_url = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_url) === 0) {
+                                $frame_url = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+                        $parsedFrame['url'] = $frame_url;
+
+                        $parsedFrame['additionaldata'] = (string) substr($parsedFrame['data'], $frame_offset);
+                        if (!empty($parsedFrame['framenameshort']) && $parsedFrame['url']) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = utf8_encode($parsedFrame['url']);
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'POSS')) { // 4.21  POSS Position synchronisation frame (ID3v2.3+ only)
+                        //   There may only be one 'POSS' frame in each tag
+                        // <Head for 'Position synchronisation', ID: 'POSS'>
+                        // Time stamp format         $xx
+                        // Position                  $xx (xx ...)
+
+                        $frame_offset = 0;
+                        $parsedFrame['timestampformat'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['position']        = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset));
+                        unset($parsedFrame['data']);
+
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['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'
+                        // <Header for 'Terms of use frame', ID: 'USER'>
+                        // Text encoding        $xx
+                        // Language             $xx xx xx
+                        // The actual text      <text string according to encoding>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $frame_language = substr($parsedFrame['data'], $frame_offset, 3);
+                        $frame_offset += 3;
+                        $parsedFrame['language']     = $frame_language;
+                        $parsedFrame['languagename'] = $this->LanguageLookup($frame_language, false);
+                        $parsedFrame['encodingid']   = $frame_textencoding;
+                        $parsedFrame['encoding']     = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $parsedFrame['data']         = (string) substr($parsedFrame['data'], $frame_offset);
+                        if (!empty($parsedFrame['framenameshort']) && !empty($parsedFrame['data'])) {
+                                $info['id3v2']['comments'][$parsedFrame['framenameshort']][] = getid3_lib::iconv_fallback($parsedFrame['encoding'], $info['id3v2']['encoding'], $parsedFrame['data']);
+                        }
+                        unset($parsedFrame['data']);
+
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'OWNE')) { // 4.23  OWNE Ownership frame (ID3v2.3+ only)
+                        //   There may only be one 'OWNE' frame in a tag
+                        // <Header for 'Ownership frame', ID: 'OWNE'>
+                        // Text encoding     $xx
+                        // Price paid        <text string> $00
+                        // Date of purch.    <text string>
+                        // Seller            <text string according to encoding>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+                        $parsedFrame['encodingid'] = $frame_textencoding;
+                        $parsedFrame['encoding']   = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_pricepaid = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $parsedFrame['pricepaid']['currencyid'] = substr($frame_pricepaid, 0, 3);
+                        $parsedFrame['pricepaid']['currency']   = $this->LookupCurrencyUnits($parsedFrame['pricepaid']['currencyid']);
+                        $parsedFrame['pricepaid']['value']      = substr($frame_pricepaid, 3);
+
+                        $parsedFrame['purchasedate'] = substr($parsedFrame['data'], $frame_offset, 8);
+                        if (!$this->IsValidDateStampString($parsedFrame['purchasedate'])) {
+                                $parsedFrame['purchasedateunix'] = mktime (0, 0, 0, substr($parsedFrame['purchasedate'], 4, 2), substr($parsedFrame['purchasedate'], 6, 2), substr($parsedFrame['purchasedate'], 0, 4));
+                        }
+                        $frame_offset += 8;
+
+                        $parsedFrame['seller'] = (string) substr($parsedFrame['data'], $frame_offset);
+                        unset($parsedFrame['data']);
+
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['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
+                        // <Header for 'Commercial frame', ID: 'COMR'>
+                        // Text encoding      $xx
+                        // Price string       <text string> $00
+                        // Valid until        <text string>
+                        // Contact URL        <text string> $00
+                        // Received as        $xx
+                        // Name of seller     <text string according to encoding> $00 (00)
+                        // Description        <text string according to encoding> $00 (00)
+                        // Picture MIME type  <string> $00
+                        // Seller logo        <binary data>
+
+                        $frame_offset = 0;
+                        $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3))) {
+                                $info['warning'][] = 'Invalid text encoding byte ('.$frame_textencoding.') in frame "'.$parsedFrame['frame_name'].'" - defaulting to ISO-8859-1 encoding';
+                        }
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_pricestring = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+                        $frame_rawpricearray = explode('/', $frame_pricestring);
+                        foreach ($frame_rawpricearray as $key => $val) {
+                                $frame_currencyid = substr($val, 0, 3);
+                                $parsedFrame['price'][$frame_currencyid]['currency'] = $this->LookupCurrencyUnits($frame_currencyid);
+                                $parsedFrame['price'][$frame_currencyid]['value']    = substr($val, 3);
+                        }
+
+                        $frame_datestring = substr($parsedFrame['data'], $frame_offset, 8);
+                        $frame_offset += 8;
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_contacturl = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $frame_receivedasid = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        $frame_sellername = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_sellername) === 0) {
+                                $frame_sellername = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding));
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);
+                        if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0) {
+                                $frame_terminatorpos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
+                        }
+                        $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_description) === 0) {
+                                $frame_description = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding));
+
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_mimetype = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $frame_sellerlogo = substr($parsedFrame['data'], $frame_offset);
+
+                        $parsedFrame['encodingid']        = $frame_textencoding;
+                        $parsedFrame['encoding']          = $this->TextEncodingNameLookup($frame_textencoding);
+
+                        $parsedFrame['pricevaliduntil']   = $frame_datestring;
+                        $parsedFrame['contacturl']        = $frame_contacturl;
+                        $parsedFrame['receivedasid']      = $frame_receivedasid;
+                        $parsedFrame['receivedas']        = $this->COMRReceivedAsLookup($frame_receivedasid);
+                        $parsedFrame['sellername']        = $frame_sellername;
+                        $parsedFrame['description']       = $frame_description;
+                        $parsedFrame['mime']              = $frame_mimetype;
+                        $parsedFrame['logo']              = $frame_sellerlogo;
+                        unset($parsedFrame['data']);
+
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['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
+                        // <Header for 'Encryption method registration', ID: 'ENCR'>
+                        // Owner identifier    <text string> $00
+                        // Method symbol       $xx
+                        // Encryption data     <binary data>
+
+                        $frame_offset = 0;
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_ownerid = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_ownerid) === 0) {
+                                $frame_ownerid = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $parsedFrame['ownerid']      = $frame_ownerid;
+                        $parsedFrame['methodsymbol'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['data']         = (string) substr($parsedFrame['data'], $frame_offset);
+
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['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
+                        // <Header for 'Group ID registration', ID: 'GRID'>
+                        // Owner identifier      <text string> $00
+                        // Group symbol          $xx
+                        // Group dependent data  <binary data>
+
+                        $frame_offset = 0;
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_ownerid = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_ownerid) === 0) {
+                                $frame_ownerid = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $parsedFrame['ownerid']       = $frame_ownerid;
+                        $parsedFrame['groupsymbol']   = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['data']          = (string) substr($parsedFrame['data'], $frame_offset);
+
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['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
+                        // <Header for 'Private frame', ID: 'PRIV'>
+                        // Owner identifier      <text string> $00
+                        // The private data      <binary data>
+
+                        $frame_offset = 0;
+                        $frame_terminatorpos = strpos($parsedFrame['data'], "\x00", $frame_offset);
+                        $frame_ownerid = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);
+                        if (ord($frame_ownerid) === 0) {
+                                $frame_ownerid = '';
+                        }
+                        $frame_offset = $frame_terminatorpos + strlen("\x00");
+
+                        $parsedFrame['ownerid'] = $frame_ownerid;
+                        $parsedFrame['data']    = (string) substr($parsedFrame['data'], $frame_offset);
+
+
+                } elseif (($id3v2_majorversion >= 4) && ($parsedFrame['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
+                        // <Header for 'Signature frame', ID: 'SIGN'>
+                        // Group symbol      $xx
+                        // Signature         <binary data>
+
+                        $frame_offset = 0;
+                        $parsedFrame['groupsymbol'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $parsedFrame['data']        = (string) substr($parsedFrame['data'], $frame_offset);
+
+
+                } elseif (($id3v2_majorversion >= 4) && ($parsedFrame['frame_name'] == 'SEEK')) { // 4.29  SEEK Seek frame (ID3v2.4+ only)
+                        //   There may only be one 'seek frame' in a tag
+                        // <Header for 'Seek frame', ID: 'SEEK'>
+                        // Minimum offset to next tag       $xx xx xx xx
+
+                        $frame_offset = 0;
+                        $parsedFrame['data']          = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));
+
+
+                } elseif (($id3v2_majorversion >= 4) && ($parsedFrame['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
+                        // <Header for 'Seek Point Index', ID: 'ASPI'>
+                        // 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;
+                        $parsedFrame['datastart'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));
+                        $frame_offset += 4;
+                        $parsedFrame['indexeddatalength'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));
+                        $frame_offset += 4;
+                        $parsedFrame['indexpoints'] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 2));
+                        $frame_offset += 2;
+                        $parsedFrame['bitsperpoint'] = ord(substr($parsedFrame['data'], $frame_offset++, 1));
+                        $frame_bytesperpoint = ceil($parsedFrame['bitsperpoint'] / 8);
+                        for ($i = 0; $i < $frame_indexpoints; $i++) {
+                                $parsedFrame['indexes'][$i] = getid3_lib::BigEndian2Int(substr($parsedFrame['data'], $frame_offset, $frame_bytesperpoint));
+                                $frame_offset += $frame_bytesperpoint;
+                        }
+                        unset($parsedFrame['data']);
+
+                } elseif (($id3v2_majorversion >= 3) && ($parsedFrame['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
+                        // <Header for 'Replay Gain Adjustment', ID: 'RGAD'>
+                        // 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;
+                        $parsedFrame['peakamplitude'] = getid3_lib::BigEndian2Float(substr($parsedFrame['data'], $frame_offset, 4));
+                        $frame_offset += 4;
+                        $rg_track_adjustment = getid3_lib::Dec2Bin(substr($parsedFrame['data'], $frame_offset, 2));
+                        $frame_offset += 2;
+                        $rg_album_adjustment = getid3_lib::Dec2Bin(substr($parsedFrame['data'], $frame_offset, 2));
+                        $frame_offset += 2;
+                        $parsedFrame['raw']['track']['name']       = getid3_lib::Bin2Dec(substr($rg_track_adjustment, 0, 3));
+                        $parsedFrame['raw']['track']['originator'] = getid3_lib::Bin2Dec(substr($rg_track_adjustment, 3, 3));
+                        $parsedFrame['raw']['track']['signbit']    = getid3_lib::Bin2Dec(substr($rg_track_adjustment, 6, 1));
+                        $parsedFrame['raw']['track']['adjustment'] = getid3_lib::Bin2Dec(substr($rg_track_adjustment, 7, 9));
+                        $parsedFrame['raw']['album']['name']       = getid3_lib::Bin2Dec(substr($rg_album_adjustment, 0, 3));
+                        $parsedFrame['raw']['album']['originator'] = getid3_lib::Bin2Dec(substr($rg_album_adjustment, 3, 3));
+                        $parsedFrame['raw']['album']['signbit']    = getid3_lib::Bin2Dec(substr($rg_album_adjustment, 6, 1));
+                        $parsedFrame['raw']['album']['adjustment'] = getid3_lib::Bin2Dec(substr($rg_album_adjustment, 7, 9));
+                        $parsedFrame['track']['name']       = getid3_lib::RGADnameLookup($parsedFrame['raw']['track']['name']);
+                        $parsedFrame['track']['originator'] = getid3_lib::RGADoriginatorLookup($parsedFrame['raw']['track']['originator']);
+                        $parsedFrame['track']['adjustment'] = getid3_lib::RGADadjustmentLookup($parsedFrame['raw']['track']['adjustment'], $parsedFrame['raw']['track']['signbit']);
+                        $parsedFrame['album']['name']       = getid3_lib::RGADnameLookup($parsedFrame['raw']['album']['name']);
+                        $parsedFrame['album']['originator'] = getid3_lib::RGADoriginatorLookup($parsedFrame['raw']['album']['originator']);
+                        $parsedFrame['album']['adjustment'] = getid3_lib::RGADadjustmentLookup($parsedFrame['raw']['album']['adjustment'], $parsedFrame['raw']['album']['signbit']);
+
+                        $info['replay_gain']['track']['peak']       = $parsedFrame['peakamplitude'];
+                        $info['replay_gain']['track']['originator'] = $parsedFrame['track']['originator'];
+                        $info['replay_gain']['track']['adjustment'] = $parsedFrame['track']['adjustment'];
+                        $info['replay_gain']['album']['originator'] = $parsedFrame['album']['originator'];
+                        $info['replay_gain']['album']['adjustment'] = $parsedFrame['album']['adjustment'];
+
+                        unset($parsedFrame['data']);
+
+                }
+
+                return true;
+        }
+
+
+        public function DeUnsynchronise($data) {
+                return str_replace("\xFF\x00", "\xFF", $data);
+        }
+
+        public function LookupExtendedHeaderRestrictionsTagSizeLimits($index) {
+                static $LookupExtendedHeaderRestrictionsTagSizeLimits = array(
+                        0x00 => 'No more than 128 frames and 1 MB total tag size',
+                        0x01 => 'No more than 64 frames and 128 KB total tag size',
+                        0x02 => 'No more than 32 frames and 40 KB total tag size',
+                        0x03 => 'No more than 32 frames and 4 KB total tag size',
+                );
+                return (isset($LookupExtendedHeaderRestrictionsTagSizeLimits[$index]) ? $LookupExtendedHeaderRestrictionsTagSizeLimits[$index] : '');
+        }
+
+        public function LookupExtendedHeaderRestrictionsTextEncodings($index) {
+                static $LookupExtendedHeaderRestrictionsTextEncodings = array(
+                        0x00 => 'No restrictions',
+                        0x01 => 'Strings are only encoded with ISO-8859-1 or UTF-8',
+                );
+                return (isset($LookupExtendedHeaderRestrictionsTextEncodings[$index]) ? $LookupExtendedHeaderRestrictionsTextEncodings[$index] : '');
+        }
+
+        public function LookupExtendedHeaderRestrictionsTextFieldSize($index) {
+                static $LookupExtendedHeaderRestrictionsTextFieldSize = array(
+                        0x00 => 'No restrictions',
+                        0x01 => 'No string is longer than 1024 characters',
+                        0x02 => 'No string is longer than 128 characters',
+                        0x03 => 'No string is longer than 30 characters',
+                );
+                return (isset($LookupExtendedHeaderRestrictionsTextFieldSize[$index]) ? $LookupExtendedHeaderRestrictionsTextFieldSize[$index] : '');
+        }
+
+        public function LookupExtendedHeaderRestrictionsImageEncoding($index) {
+                static $LookupExtendedHeaderRestrictionsImageEncoding = array(
+                        0x00 => 'No restrictions',
+                        0x01 => 'Images are encoded only with PNG or JPEG',
+                );
+                return (isset($LookupExtendedHeaderRestrictionsImageEncoding[$index]) ? $LookupExtendedHeaderRestrictionsImageEncoding[$index] : '');
+        }
+
+        public function LookupExtendedHeaderRestrictionsImageSizeSize($index) {
+                static $LookupExtendedHeaderRestrictionsImageSizeSize = array(
+                        0x00 => 'No restrictions',
+                        0x01 => 'All images are 256x256 pixels or smaller',
+                        0x02 => 'All images are 64x64 pixels or smaller',
+                        0x03 => 'All images are exactly 64x64 pixels, unless required otherwise',
+                );
+                return (isset($LookupExtendedHeaderRestrictionsImageSizeSize[$index]) ? $LookupExtendedHeaderRestrictionsImageSizeSize[$index] : '');
+        }
+
+        public function LookupCurrencyUnits($currencyid) {
+
+                $begin = __LINE__;
+
+                /** This is not a comment!
+
+
+                        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 getid3_lib::EmbeddedLookup($currencyid, $begin, __LINE__, __FILE__, 'id3v2-currency-units');
+        }
+
+
+        public function LookupCurrencyCountry($currencyid) {
+
+                $begin = __LINE__;
+
+                /** This is not a comment!
+
+                        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 getid3_lib::EmbeddedLookup($currencyid, $begin, __LINE__, __FILE__, 'id3v2-currency-country');
+        }
+
+
+
+        public static function LanguageLookup($languagecode, $casesensitive=false) {
+
+                if (!$casesensitive) {
+                        $languagecode = strtolower($languagecode);
+                }
+
+                // 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
+
+                $begin = __LINE__;
+
+                /** This is not a comment!
+
+                        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 getid3_lib::EmbeddedLookup($languagecode, $begin, __LINE__, __FILE__, 'id3v2-languagecode');
+        }
+
+
+        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 $EventLookup = 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 (isset($EventLookup[$index]) ? $EventLookup[$index] : '');
+        }
+
+        public static function SYTLContentTypeLookup($index) {
+                static $SYTLContentTypeLookup = 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 (isset($SYTLContentTypeLookup[$index]) ? $SYTLContentTypeLookup[$index] : '');
+        }
+
+        public static function APICPictureTypeLookup($index, $returnarray=false) {
+                static $APICPictureTypeLookup = 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',