[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/ID3/ -> module.audio-video.quicktime.php (source)

   1  <?php
   2  
   3  /////////////////////////////////////////////////////////////////
   4  /// getID3() by James Heinrich <info@getid3.org>               //
   5  //  available at https://github.com/JamesHeinrich/getID3       //
   6  //            or https://www.getid3.org                        //
   7  //            or http://getid3.sourceforge.net                 //
   8  //  see readme.txt for more details                            //
   9  /////////////////////////////////////////////////////////////////
  10  //                                                             //
  11  // module.audio-video.quicktime.php                            //
  12  // module for analyzing Quicktime and MP3-in-MP4 files         //
  13  // dependencies: module.audio.mp3.php                          //
  14  // dependencies: module.tag.id3v2.php                          //
  15  //                                                            ///
  16  /////////////////////////////////////////////////////////////////
  17  
  18  if (!defined('GETID3_INCLUDEPATH')) { // prevent path-exposing attacks that access modules directly on public webservers
  19      exit;
  20  }
  21  getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.mp3.php', __FILE__, true);
  22  getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.tag.id3v2.php', __FILE__, true); // needed for ISO 639-2 language code lookup
  23  
  24  class getid3_quicktime extends getid3_handler
  25  {
  26  
  27      /** audio-video.quicktime
  28       * return all parsed data from all atoms if true, otherwise just returned parsed metadata
  29       *
  30       * @var bool
  31       */
  32      public $ReturnAtomData        = false;
  33  
  34      /** audio-video.quicktime
  35       * return all parsed data from all atoms if true, otherwise just returned parsed metadata
  36       *
  37       * @var bool
  38       */
  39      public $ParseAllPossibleAtoms = false;
  40  
  41      /**
  42       * @return bool
  43       */
  44  	public function Analyze() {
  45          $info = &$this->getid3->info;
  46  
  47          $info['fileformat'] = 'quicktime';
  48          $info['quicktime']['hinting']    = false;
  49          $info['quicktime']['controller'] = 'standard'; // may be overridden if 'ctyp' atom is present
  50  
  51          $this->fseek($info['avdataoffset']);
  52  
  53          $offset      = 0;
  54          $atomcounter = 0;
  55          $atom_data_read_buffer_size = $info['php_memory_limit'] ? round($info['php_memory_limit'] / 4) : $this->getid3->option_fread_buffer_size * 1024; // set read buffer to 25% of PHP memory limit (if one is specified), otherwise use option_fread_buffer_size [default: 32MB]
  56          while ($offset < $info['avdataend']) {
  57              if (!getid3_lib::intValueSupported($offset)) {
  58                  $this->error('Unable to parse atom at offset '.$offset.' because beyond '.round(PHP_INT_MAX / 1073741824).'GB limit of PHP filesystem functions');
  59                  break;
  60              }
  61              $this->fseek($offset);
  62              $AtomHeader = $this->fread(8);
  63  
  64              // https://github.com/JamesHeinrich/getID3/issues/382
  65              // Atom sizes are stored as 32-bit number in most cases, but sometimes (notably for "mdat")
  66              // a 64-bit value is required, in which case the normal 32-bit size field is set to 0x00000001
  67              // and the 64-bit "real" size value is the next 8 bytes.
  68              $atom_size_extended_bytes = 0;
  69              $atomsize = getid3_lib::BigEndian2Int(substr($AtomHeader, 0, 4));
  70              $atomname = substr($AtomHeader, 4, 4);
  71              if ($atomsize == 1) {
  72                  $atom_size_extended_bytes = 8;
  73                  $atomsize = getid3_lib::BigEndian2Int($this->fread($atom_size_extended_bytes));
  74              }
  75  
  76              if (($offset + $atomsize) > $info['avdataend']) {
  77                  $info['quicktime'][$atomname]['name']   = $atomname;
  78                  $info['quicktime'][$atomname]['size']   = $atomsize;
  79                  $info['quicktime'][$atomname]['offset'] = $offset;
  80                  $this->error('Atom at offset '.$offset.' claims to go beyond end-of-file (length: '.$atomsize.' bytes)');
  81                  return false;
  82              }
  83              if ($atomsize == 0) {
  84                  // Furthermore, for historical reasons the list of atoms is optionally
  85                  // terminated by a 32-bit integer set to 0. If you are writing a program
  86                  // to read user data atoms, you should allow for the terminating 0.
  87                  $info['quicktime'][$atomname]['name']   = $atomname;
  88                  $info['quicktime'][$atomname]['size']   = $atomsize;
  89                  $info['quicktime'][$atomname]['offset'] = $offset;
  90                  break;
  91              }
  92              $atomHierarchy = array();
  93              $parsedAtomData = $this->QuicktimeParseAtom($atomname, $atomsize, $this->fread(min($atomsize - $atom_size_extended_bytes, $atom_data_read_buffer_size)), $offset, $atomHierarchy, $this->ParseAllPossibleAtoms);
  94              $parsedAtomData['name']   = $atomname;
  95              $parsedAtomData['size']   = $atomsize;
  96              $parsedAtomData['offset'] = $offset;
  97              if ($atom_size_extended_bytes) {
  98                  $parsedAtomData['xsize_bytes'] = $atom_size_extended_bytes;
  99              }
 100              if (in_array($atomname, array('uuid'))) {
 101                  @$info['quicktime'][$atomname][] = $parsedAtomData;
 102              } else {
 103                  $info['quicktime'][$atomname] = $parsedAtomData;
 104              }
 105  
 106              $offset += $atomsize;
 107              $atomcounter++;
 108          }
 109  
 110          if (!empty($info['avdataend_tmp'])) {
 111              // this value is assigned to a temp value and then erased because
 112              // otherwise any atoms beyond the 'mdat' atom would not get parsed
 113              $info['avdataend'] = $info['avdataend_tmp'];
 114              unset($info['avdataend_tmp']);
 115          }
 116  
 117          if (isset($info['quicktime']['comments']['chapters']) && is_array($info['quicktime']['comments']['chapters']) && (count($info['quicktime']['comments']['chapters']) > 0)) {
 118              $durations = $this->quicktime_time_to_sample_table($info);
 119              for ($i = 0; $i < count($info['quicktime']['comments']['chapters']); $i++) {
 120                  $bookmark = array();
 121                  $bookmark['title'] = $info['quicktime']['comments']['chapters'][$i];
 122                  if (isset($durations[$i])) {
 123                      $bookmark['duration_sample'] = $durations[$i]['sample_duration'];
 124                      if ($i > 0) {
 125                          $bookmark['start_sample'] = $info['quicktime']['bookmarks'][($i - 1)]['start_sample'] + $info['quicktime']['bookmarks'][($i - 1)]['duration_sample'];
 126                      } else {
 127                          $bookmark['start_sample'] = 0;
 128                      }
 129                      if ($time_scale = $this->quicktime_bookmark_time_scale($info)) {
 130                          $bookmark['duration_seconds'] = $bookmark['duration_sample'] / $time_scale;
 131                          $bookmark['start_seconds']    = $bookmark['start_sample']    / $time_scale;
 132                      }
 133                  }
 134                  $info['quicktime']['bookmarks'][] = $bookmark;
 135              }
 136          }
 137  
 138          if (isset($info['quicktime']['temp_meta_key_names'])) {
 139              unset($info['quicktime']['temp_meta_key_names']);
 140          }
 141  
 142          if (!empty($info['quicktime']['comments']['location.ISO6709'])) {
 143              // https://en.wikipedia.org/wiki/ISO_6709
 144              foreach ($info['quicktime']['comments']['location.ISO6709'] as $ISO6709string) {
 145                  $ISO6709parsed = array('latitude'=>false, 'longitude'=>false, 'altitude'=>false);
 146                  if (preg_match('#^([\\+\\-])([0-9]{2}|[0-9]{4}|[0-9]{6})(\\.[0-9]+)?([\\+\\-])([0-9]{3}|[0-9]{5}|[0-9]{7})(\\.[0-9]+)?(([\\+\\-])([0-9]{3}|[0-9]{5}|[0-9]{7})(\\.[0-9]+)?)?/$#', $ISO6709string, $matches)) {
 147                      @list($dummy, $lat_sign, $lat_deg, $lat_deg_dec, $lon_sign, $lon_deg, $lon_deg_dec, $dummy, $alt_sign, $alt_deg, $alt_deg_dec) = $matches;
 148  
 149                      if (strlen($lat_deg) == 2) {        // [+-]DD.D
 150                          $ISO6709parsed['latitude'] = (($lat_sign == '-') ? -1 : 1) * floatval(ltrim($lat_deg, '0').$lat_deg_dec);
 151                      } elseif (strlen($lat_deg) == 4) {  // [+-]DDMM.M
 152                          $ISO6709parsed['latitude'] = (($lat_sign == '-') ? -1 : 1) * floatval(ltrim(substr($lat_deg, 0, 2), '0')) + floatval(ltrim(substr($lat_deg, 2, 2), '0').$lat_deg_dec / 60);
 153                      } elseif (strlen($lat_deg) == 6) {  // [+-]DDMMSS.S
 154                          $ISO6709parsed['latitude'] = (($lat_sign == '-') ? -1 : 1) * floatval(ltrim(substr($lat_deg, 0, 2), '0')) + floatval((int) ltrim(substr($lat_deg, 2, 2), '0') / 60) + floatval(ltrim(substr($lat_deg, 4, 2), '0').$lat_deg_dec / 3600);
 155                      }
 156  
 157                      if (strlen($lon_deg) == 3) {        // [+-]DDD.D
 158                          $ISO6709parsed['longitude'] = (($lon_sign == '-') ? -1 : 1) * floatval(ltrim($lon_deg, '0').$lon_deg_dec);
 159                      } elseif (strlen($lon_deg) == 5) {  // [+-]DDDMM.M
 160                          $ISO6709parsed['longitude'] = (($lon_sign == '-') ? -1 : 1) * floatval(ltrim(substr($lon_deg, 0, 2), '0')) + floatval(ltrim(substr($lon_deg, 2, 2), '0').$lon_deg_dec / 60);
 161                      } elseif (strlen($lon_deg) == 7) {  // [+-]DDDMMSS.S
 162                          $ISO6709parsed['longitude'] = (($lon_sign == '-') ? -1 : 1) * floatval(ltrim(substr($lon_deg, 0, 2), '0')) + floatval((int) ltrim(substr($lon_deg, 2, 2), '0') / 60) + floatval(ltrim(substr($lon_deg, 4, 2), '0').$lon_deg_dec / 3600);
 163                      }
 164  
 165                      if (strlen($alt_deg) == 3) {        // [+-]DDD.D
 166                          $ISO6709parsed['altitude'] = (($alt_sign == '-') ? -1 : 1) * floatval(ltrim($alt_deg, '0').$alt_deg_dec);
 167                      } elseif (strlen($alt_deg) == 5) {  // [+-]DDDMM.M
 168                          $ISO6709parsed['altitude'] = (($alt_sign == '-') ? -1 : 1) * floatval(ltrim(substr($alt_deg, 0, 2), '0')) + floatval(ltrim(substr($alt_deg, 2, 2), '0').$alt_deg_dec / 60);
 169                      } elseif (strlen($alt_deg) == 7) {  // [+-]DDDMMSS.S
 170                          $ISO6709parsed['altitude'] = (($alt_sign == '-') ? -1 : 1) * floatval(ltrim(substr($alt_deg, 0, 2), '0')) + floatval((int) ltrim(substr($alt_deg, 2, 2), '0') / 60) + floatval(ltrim(substr($alt_deg, 4, 2), '0').$alt_deg_dec / 3600);
 171                      }
 172  
 173                      foreach (array('latitude', 'longitude', 'altitude') as $key) {
 174                          if ($ISO6709parsed[$key] !== false) {
 175                              $value = (($lat_sign == '-') ? -1 : 1) * floatval($ISO6709parsed[$key]);
 176                              if (!isset($info['quicktime']['comments']['gps_'.$key]) || !in_array($value, $info['quicktime']['comments']['gps_'.$key])) {
 177                                  @$info['quicktime']['comments']['gps_'.$key][] = (($lat_sign == '-') ? -1 : 1) * floatval($ISO6709parsed[$key]);
 178                              }
 179                          }
 180                      }
 181                  }
 182                  if ($ISO6709parsed['latitude'] === false) {
 183                      $this->warning('location.ISO6709 string not parsed correctly: "'.$ISO6709string.'", please submit as a bug');
 184                  }
 185                  break;
 186              }
 187          }
 188  
 189          if (!isset($info['bitrate']) && !empty($info['playtime_seconds'])) {
 190              $info['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $info['playtime_seconds'];
 191          }
 192          if (isset($info['bitrate']) && !isset($info['audio']['bitrate']) && !isset($info['quicktime']['video'])) {
 193              $info['audio']['bitrate'] = $info['bitrate'];
 194          }
 195          if (!empty($info['bitrate']) && !empty($info['audio']['bitrate']) && empty($info['video']['bitrate']) && !empty($info['video']['frame_rate']) && !empty($info['video']['resolution_x']) && ($info['bitrate'] > $info['audio']['bitrate'])) {
 196              $info['video']['bitrate'] = $info['bitrate'] - $info['audio']['bitrate'];
 197          }
 198          if (!empty($info['playtime_seconds']) && !isset($info['video']['frame_rate']) && !empty($info['quicktime']['stts_framecount'])) {
 199              foreach ($info['quicktime']['stts_framecount'] as $key => $samples_count) {
 200                  $samples_per_second = $samples_count / $info['playtime_seconds'];
 201                  if ($samples_per_second > 240) {
 202                      // has to be audio samples
 203                  } else {
 204                      $info['video']['frame_rate'] = $samples_per_second;
 205                      break;
 206                  }
 207              }
 208          }
 209          if ($info['audio']['dataformat'] == 'mp4') {
 210              $info['fileformat'] = 'mp4';
 211              if (empty($info['video']['resolution_x'])) {
 212                  $info['mime_type']  = 'audio/mp4';
 213                  unset($info['video']['dataformat']);
 214              } else {
 215                  $info['mime_type']  = 'video/mp4';
 216              }
 217          }
 218  
 219          if (!$this->ReturnAtomData) {
 220              unset($info['quicktime']['moov']);
 221          }
 222  
 223          if (empty($info['audio']['dataformat']) && !empty($info['quicktime']['audio'])) {
 224              $info['audio']['dataformat'] = 'quicktime';
 225          }
 226          if (empty($info['video']['dataformat']) && !empty($info['quicktime']['video'])) {
 227              $info['video']['dataformat'] = 'quicktime';
 228          }
 229          if (isset($info['video']) && ($info['mime_type'] == 'audio/mp4') && empty($info['video']['resolution_x']) && empty($info['video']['resolution_y']))  {
 230              unset($info['video']);
 231          }
 232  
 233          return true;
 234      }
 235  
 236      /**
 237       * @param string $atomname
 238       * @param int    $atomsize
 239       * @param string $atom_data
 240       * @param int    $baseoffset
 241       * @param array  $atomHierarchy
 242       * @param bool   $ParseAllPossibleAtoms
 243       *
 244       * @return array|false
 245       */
 246  	public function QuicktimeParseAtom($atomname, $atomsize, $atom_data, $baseoffset, &$atomHierarchy, $ParseAllPossibleAtoms) {
 247          // http://developer.apple.com/techpubs/quicktime/qtdevdocs/APIREF/INDEX/atomalphaindex.htm
 248          // https://code.google.com/p/mp4v2/wiki/iTunesMetadata
 249  
 250          $info = &$this->getid3->info;
 251  
 252          $atom_parent = end($atomHierarchy); // not array_pop($atomHierarchy); see https://www.getid3.org/phpBB3/viewtopic.php?t=1717
 253          array_push($atomHierarchy, $atomname);
 254          $atom_structure              = array();
 255          $atom_structure['hierarchy'] = implode(' ', $atomHierarchy);
 256          $atom_structure['name']      = $atomname;
 257          $atom_structure['size']      = $atomsize;
 258          $atom_structure['offset']    = $baseoffset;
 259          if (substr($atomname, 0, 3) == "\x00\x00\x00") {
 260              // https://github.com/JamesHeinrich/getID3/issues/139
 261              $atomname = getid3_lib::BigEndian2Int($atomname);
 262              $atom_structure['name'] = $atomname;
 263              $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
 264          } else {
 265              switch ($atomname) {
 266                  case 'moov': // MOVie container atom
 267                  case 'moof': // MOvie Fragment box
 268                  case 'trak': // TRAcK container atom
 269                  case 'traf': // TRAck Fragment box
 270                  case 'clip': // CLIPping container atom
 271                  case 'matt': // track MATTe container atom
 272                  case 'edts': // EDiTS container atom
 273                  case 'tref': // Track REFerence container atom
 274                  case 'mdia': // MeDIA container atom
 275                  case 'minf': // Media INFormation container atom
 276                  case 'dinf': // Data INFormation container atom
 277                  case 'nmhd': // Null Media HeaDer container atom
 278                  case 'udta': // User DaTA container atom
 279                  case 'cmov': // Compressed MOVie container atom
 280                  case 'rmra': // Reference Movie Record Atom
 281                  case 'rmda': // Reference Movie Descriptor Atom
 282                  case 'gmhd': // Generic Media info HeaDer atom (seen on QTVR)
 283                      $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
 284                      break;
 285  
 286                  case 'ilst': // Item LiST container atom
 287                      if ($atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms)) {
 288                          // some "ilst" atoms contain data atoms that have a numeric name, and the data is far more accessible if the returned array is compacted
 289                          $allnumericnames = true;
 290                          foreach ($atom_structure['subatoms'] as $subatomarray) {
 291                              if (!is_integer($subatomarray['name']) || (count($subatomarray['subatoms']) != 1)) {
 292                                  $allnumericnames = false;
 293                                  break;
 294                              }
 295                          }
 296                          if ($allnumericnames) {
 297                              $newData = array();
 298                              foreach ($atom_structure['subatoms'] as $subatomarray) {
 299                                  foreach ($subatomarray['subatoms'] as $newData_subatomarray) {
 300                                      unset($newData_subatomarray['hierarchy'], $newData_subatomarray['name']);
 301                                      $newData[$subatomarray['name']] = $newData_subatomarray;
 302                                      break;
 303                                  }
 304                              }
 305                              $atom_structure['data'] = $newData;
 306                              unset($atom_structure['subatoms']);
 307                          }
 308                      }
 309                      break;
 310  
 311                  case 'stbl': // Sample TaBLe container atom
 312                      $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
 313                      $isVideo = false;
 314                      $framerate  = 0;
 315                      $framecount = 0;
 316                      foreach ($atom_structure['subatoms'] as $key => $value_array) {
 317                          if (isset($value_array['sample_description_table'])) {
 318                              foreach ($value_array['sample_description_table'] as $key2 => $value_array2) {
 319                                  if (isset($value_array2['data_format'])) {
 320                                      switch ($value_array2['data_format']) {
 321                                          case 'avc1':
 322                                          case 'mp4v':
 323                                              // video data
 324                                              $isVideo = true;
 325                                              break;
 326                                          case 'mp4a':
 327                                              // audio data
 328                                              break;
 329                                      }
 330                                  }
 331                              }
 332                          } elseif (isset($value_array['time_to_sample_table'])) {
 333                              foreach ($value_array['time_to_sample_table'] as $key2 => $value_array2) {
 334                                  if (isset($value_array2['sample_count']) && isset($value_array2['sample_duration']) && ($value_array2['sample_duration'] > 0) && !empty($info['quicktime']['time_scale'])) {
 335                                      $framerate  = round($info['quicktime']['time_scale'] / $value_array2['sample_duration'], 3);
 336                                      $framecount = $value_array2['sample_count'];
 337                                  }
 338                              }
 339                          }
 340                      }
 341                      if ($isVideo && $framerate) {
 342                          $info['quicktime']['video']['frame_rate'] = $framerate;
 343                          $info['video']['frame_rate'] = $info['quicktime']['video']['frame_rate'];
 344                      }
 345                      if ($isVideo && $framecount) {
 346                          $info['quicktime']['video']['frame_count'] = $framecount;
 347                      }
 348                      break;
 349  
 350  
 351                  case "\xA9".'alb': // ALBum
 352                  case "\xA9".'ART': //
 353                  case "\xA9".'art': // ARTist
 354                  case "\xA9".'aut': //
 355                  case "\xA9".'cmt': // CoMmenT
 356                  case "\xA9".'com': // COMposer
 357                  case "\xA9".'cpy': //
 358                  case "\xA9".'day': // content created year
 359                  case "\xA9".'dir': //
 360                  case "\xA9".'ed1': //
 361                  case "\xA9".'ed2': //
 362                  case "\xA9".'ed3': //
 363                  case "\xA9".'ed4': //
 364                  case "\xA9".'ed5': //
 365                  case "\xA9".'ed6': //
 366                  case "\xA9".'ed7': //
 367                  case "\xA9".'ed8': //
 368                  case "\xA9".'ed9': //
 369                  case "\xA9".'enc': //
 370                  case "\xA9".'fmt': //
 371                  case "\xA9".'gen': // GENre
 372                  case "\xA9".'grp': // GRouPing
 373                  case "\xA9".'hst': //
 374                  case "\xA9".'inf': //
 375                  case "\xA9".'lyr': // LYRics
 376                  case "\xA9".'mak': //
 377                  case "\xA9".'mod': //
 378                  case "\xA9".'nam': // full NAMe
 379                  case "\xA9".'ope': //
 380                  case "\xA9".'PRD': //
 381                  case "\xA9".'prf': //
 382                  case "\xA9".'req': //
 383                  case "\xA9".'src': //
 384                  case "\xA9".'swr': //
 385                  case "\xA9".'too': // encoder
 386                  case "\xA9".'trk': // TRacK
 387                  case "\xA9".'url': //
 388                  case "\xA9".'wrn': //
 389                  case "\xA9".'wrt': // WRiTer
 390                  case '----': // itunes specific
 391                  case 'aART': // Album ARTist
 392                  case 'akID': // iTunes store account type
 393                  case 'apID': // Purchase Account
 394                  case 'atID': //
 395                  case 'catg': // CaTeGory
 396                  case 'cmID': //
 397                  case 'cnID': //
 398                  case 'covr': // COVeR artwork
 399                  case 'cpil': // ComPILation
 400                  case 'cprt': // CoPyRighT
 401                  case 'desc': // DESCription
 402                  case 'disk': // DISK number
 403                  case 'egid': // Episode Global ID
 404                  case 'geID': //
 405                  case 'gnre': // GeNRE
 406                  case 'hdvd': // HD ViDeo
 407                  case 'keyw': // KEYWord
 408                  case 'ldes': // Long DEScription
 409                  case 'pcst': // PodCaST
 410                  case 'pgap': // GAPless Playback
 411                  case 'plID': //
 412                  case 'purd': // PURchase Date
 413                  case 'purl': // Podcast URL
 414                  case 'rati': //
 415                  case 'rndu': //
 416                  case 'rpdu': //
 417                  case 'rtng': // RaTiNG
 418                  case 'sfID': // iTunes store country
 419                  case 'soaa': // SOrt Album Artist
 420                  case 'soal': // SOrt ALbum
 421                  case 'soar': // SOrt ARtist
 422                  case 'soco': // SOrt COmposer
 423                  case 'sonm': // SOrt NaMe
 424                  case 'sosn': // SOrt Show Name
 425                  case 'stik': //
 426                  case 'tmpo': // TeMPO (BPM)
 427                  case 'trkn': // TRacK Number
 428                  case 'tven': // tvEpisodeID
 429                  case 'tves': // TV EpiSode
 430                  case 'tvnn': // TV Network Name
 431                  case 'tvsh': // TV SHow Name
 432                  case 'tvsn': // TV SeasoN
 433                      if ($atom_parent == 'udta') {
 434                          // User data atom handler
 435                          $atom_structure['data_length'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 2));
 436                          $atom_structure['language_id'] = getid3_lib::BigEndian2Int(substr($atom_data, 2, 2));
 437                          $atom_structure['data']        =                           substr($atom_data, 4);
 438  
 439                          $atom_structure['language']    = $this->QuicktimeLanguageLookup($atom_structure['language_id']);
 440                          if (empty($info['comments']['language']) || (!in_array($atom_structure['language'], $info['comments']['language']))) {
 441                              $info['comments']['language'][] = $atom_structure['language'];
 442                          }
 443                      } else {
 444                          // Apple item list box atom handler
 445                          $atomoffset = 0;
 446                          if (substr($atom_data, 2, 2) == "\x10\xB5") {
 447                              // not sure what it means, but observed on iPhone4 data.
 448                              // Each $atom_data has 2 bytes of datasize, plus 0x10B5, then data
 449                              while ($atomoffset < strlen($atom_data)) {
 450                                  $boxsmallsize = getid3_lib::BigEndian2Int(substr($atom_data, $atomoffset,     2));
 451                                  $boxsmalltype =                           substr($atom_data, $atomoffset + 2, 2);
 452                                  $boxsmalldata =                           substr($atom_data, $atomoffset + 4, $boxsmallsize);
 453                                  if ($boxsmallsize <= 1) {
 454                                      $this->warning('Invalid QuickTime atom smallbox size "'.$boxsmallsize.'" in atom "'.preg_replace('#[^a-zA-Z0-9 _\\-]#', '?', $atomname).'" at offset: '.($atom_structure['offset'] + $atomoffset));
 455                                      $atom_structure['data'] = null;
 456                                      $atomoffset = strlen($atom_data);
 457                                      break;
 458                                  }
 459                                  switch ($boxsmalltype) {
 460                                      case "\x10\xB5":
 461                                          $atom_structure['data'] = $boxsmalldata;
 462                                          break;
 463                                      default:
 464                                          $this->warning('Unknown QuickTime smallbox type: "'.preg_replace('#[^a-zA-Z0-9 _\\-]#', '?', $boxsmalltype).'" ('.trim(getid3_lib::PrintHexBytes($boxsmalltype)).') at offset '.$baseoffset);
 465                                          $atom_structure['data'] = $atom_data;
 466                                          break;
 467                                  }
 468                                  $atomoffset += (4 + $boxsmallsize);
 469                              }
 470                          } else {
 471                              while ($atomoffset < strlen($atom_data)) {
 472                                  $boxsize = getid3_lib::BigEndian2Int(substr($atom_data, $atomoffset, 4));
 473                                  $boxtype =                           substr($atom_data, $atomoffset + 4, 4);
 474                                  $boxdata =                           substr($atom_data, $atomoffset + 8, $boxsize - 8);
 475                                  if ($boxsize <= 1) {
 476                                      $this->warning('Invalid QuickTime atom box size "'.$boxsize.'" in atom "'.preg_replace('#[^a-zA-Z0-9 _\\-]#', '?', $atomname).'" at offset: '.($atom_structure['offset'] + $atomoffset));
 477                                      $atom_structure['data'] = null;
 478                                      $atomoffset = strlen($atom_data);
 479                                      break;
 480                                  }
 481                                  $atomoffset += $boxsize;
 482  
 483                                  switch ($boxtype) {
 484                                      case 'mean':
 485                                      case 'name':
 486                                          $atom_structure[$boxtype] = substr($boxdata, 4);
 487                                          break;
 488  
 489                                      case 'data':
 490                                          $atom_structure['version']   = getid3_lib::BigEndian2Int(substr($boxdata,  0, 1));
 491                                          $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($boxdata,  1, 3));
 492                                          switch ($atom_structure['flags_raw']) {
 493                                              case  0: // data flag
 494                                              case 21: // tmpo/cpil flag
 495                                                  switch ($atomname) {
 496                                                      case 'cpil':
 497                                                      case 'hdvd':
 498                                                      case 'pcst':
 499                                                      case 'pgap':
 500                                                          // 8-bit integer (boolean)
 501                                                          $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 1));
 502                                                          break;
 503  
 504                                                      case 'tmpo':
 505                                                          // 16-bit integer
 506                                                          $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 2));
 507                                                          break;
 508  
 509                                                      case 'disk':
 510                                                      case 'trkn':
 511                                                          // binary
 512                                                          $num       = getid3_lib::BigEndian2Int(substr($boxdata, 10, 2));
 513                                                          $num_total = getid3_lib::BigEndian2Int(substr($boxdata, 12, 2));
 514                                                          $atom_structure['data']  = empty($num) ? '' : $num;
 515                                                          $atom_structure['data'] .= empty($num_total) ? '' : '/'.$num_total;
 516                                                          break;
 517  
 518                                                      case 'gnre':
 519                                                          // enum
 520                                                          $GenreID = getid3_lib::BigEndian2Int(substr($boxdata, 8, 4));
 521                                                          $atom_structure['data']    = getid3_id3v1::LookupGenreName($GenreID - 1);
 522                                                          break;
 523  
 524                                                      case 'rtng':
 525                                                          // 8-bit integer
 526                                                          $atom_structure[$atomname] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 1));
 527                                                          $atom_structure['data']    = $this->QuicktimeContentRatingLookup($atom_structure[$atomname]);
 528                                                          break;
 529  
 530                                                      case 'stik':
 531                                                          // 8-bit integer (enum)
 532                                                          $atom_structure[$atomname] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 1));
 533                                                          $atom_structure['data']    = $this->QuicktimeSTIKLookup($atom_structure[$atomname]);
 534                                                          break;
 535  
 536                                                      case 'sfID':
 537                                                          // 32-bit integer
 538                                                          $atom_structure[$atomname] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 4));
 539                                                          $atom_structure['data']    = $this->QuicktimeStoreFrontCodeLookup($atom_structure[$atomname]);
 540                                                          break;
 541  
 542                                                      case 'egid':
 543                                                      case 'purl':
 544                                                          $atom_structure['data'] = substr($boxdata, 8);
 545                                                          break;
 546  
 547                                                      case 'plID':
 548                                                          // 64-bit integer
 549                                                          $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 8));
 550                                                          break;
 551  
 552                                                      case 'covr':
 553                                                          $atom_structure['data'] = substr($boxdata, 8);
 554                                                          // not a foolproof check, but better than nothing
 555                                                          if (preg_match('#^\\xFF\\xD8\\xFF#', $atom_structure['data'])) {
 556                                                              $atom_structure['image_mime'] = 'image/jpeg';
 557                                                          } elseif (preg_match('#^\\x89\\x50\\x4E\\x47\\x0D\\x0A\\x1A\\x0A#', $atom_structure['data'])) {
 558                                                              $atom_structure['image_mime'] = 'image/png';
 559                                                          } elseif (preg_match('#^GIF#', $atom_structure['data'])) {
 560                                                              $atom_structure['image_mime'] = 'image/gif';
 561                                                          }
 562                                                          $info['quicktime']['comments']['picture'][] = array('image_mime'=>$atom_structure['image_mime'], 'data'=>$atom_structure['data'], 'description'=>'cover');
 563                                                          break;
 564  
 565                                                      case 'atID':
 566                                                      case 'cnID':
 567                                                      case 'geID':
 568                                                      case 'tves':
 569                                                      case 'tvsn':
 570                                                      default:
 571                                                          // 32-bit integer
 572                                                          $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($boxdata, 8, 4));
 573                                                  }
 574                                                  break;
 575  
 576                                              case  1: // text flag
 577                                              case 13: // image flag
 578                                              default:
 579                                                  $atom_structure['data'] = substr($boxdata, 8);
 580                                                  if ($atomname == 'covr') {
 581                                                      if (!empty($atom_structure['data'])) {
 582                                                          $atom_structure['image_mime'] = 'image/unknown'; // provide default MIME type to ensure array keys exist
 583                                                          if (function_exists('getimagesizefromstring') && ($getimagesize = getimagesizefromstring($atom_structure['data'])) && !empty($getimagesize['mime'])) {
 584                                                              $atom_structure['image_mime'] = $getimagesize['mime'];
 585                                                          } else {
 586                                                              // if getimagesizefromstring is not available, or fails for some reason, fall back to simple detection of common image formats
 587                                                              $ImageFormatSignatures = array(
 588                                                                  'image/jpeg' => "\xFF\xD8\xFF",
 589                                                                  'image/png'  => "\x89\x50\x4E\x47\x0D\x0A\x1A\x0A",
 590                                                                  'image/gif'  => 'GIF',
 591                                                              );
 592                                                              foreach ($ImageFormatSignatures as $mime => $image_format_signature) {
 593                                                                  if (substr($atom_structure['data'], 0, strlen($image_format_signature)) == $image_format_signature) {
 594                                                                      $atom_structure['image_mime'] = $mime;
 595                                                                      break;
 596                                                                  }
 597                                                              }
 598                                                          }
 599                                                          $info['quicktime']['comments']['picture'][] = array('image_mime'=>$atom_structure['image_mime'], 'data'=>$atom_structure['data'], 'description'=>'cover');
 600                                                      } else {
 601                                                          $this->warning('Unknown empty "covr" image at offset '.$baseoffset);
 602                                                      }
 603                                                  }
 604                                                  break;
 605  
 606                                          }
 607                                          break;
 608  
 609                                      default:
 610                                          $this->warning('Unknown QuickTime box type: "'.preg_replace('#[^a-zA-Z0-9 _\\-]#', '?', $boxtype).'" ('.trim(getid3_lib::PrintHexBytes($boxtype)).') at offset '.$baseoffset);
 611                                          $atom_structure['data'] = $atom_data;
 612  
 613                                  }
 614                              }
 615                          }
 616                      }
 617                      $this->CopyToAppropriateCommentsSection($atomname, $atom_structure['data'], $atom_structure['name']);
 618                      break;
 619  
 620  
 621                  case 'play': // auto-PLAY atom
 622                      $atom_structure['autoplay'] = (bool) getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
 623  
 624                      $info['quicktime']['autoplay'] = $atom_structure['autoplay'];
 625                      break;
 626  
 627  
 628                  case 'WLOC': // Window LOCation atom
 629                      $atom_structure['location_x']  = getid3_lib::BigEndian2Int(substr($atom_data,  0, 2));
 630                      $atom_structure['location_y']  = getid3_lib::BigEndian2Int(substr($atom_data,  2, 2));
 631                      break;
 632  
 633  
 634                  case 'LOOP': // LOOPing atom
 635                  case 'SelO': // play SELection Only atom
 636                  case 'AllF': // play ALL Frames atom
 637                      $atom_structure['data'] = getid3_lib::BigEndian2Int($atom_data);
 638                      break;
 639  
 640  
 641                  case 'name': //
 642                  case 'MCPS': // Media Cleaner PRo
 643                  case '@PRM': // adobe PReMiere version
 644                  case '@PRQ': // adobe PRemiere Quicktime version
 645                      $atom_structure['data'] = $atom_data;
 646                      break;
 647  
 648  
 649                  case 'cmvd': // Compressed MooV Data atom
 650                      // Code by ubergeekØubergeek*tv based on information from
 651                      // http://developer.apple.com/quicktime/icefloe/dispatch012.html
 652                      $atom_structure['unCompressedSize'] = getid3_lib::BigEndian2Int(substr($atom_data, 0, 4));
 653  
 654                      $CompressedFileData = substr($atom_data, 4);
 655                      if ($UncompressedHeader = @gzuncompress($CompressedFileData)) {
 656                          $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($UncompressedHeader, 0, $atomHierarchy, $ParseAllPossibleAtoms);
 657                      } else {
 658                          $this->warning('Error decompressing compressed MOV atom at offset '.$atom_structure['offset']);
 659                      }
 660                      break;
 661  
 662  
 663                  case 'dcom': // Data COMpression atom
 664                      $atom_structure['compression_id']   = $atom_data;
 665                      $atom_structure['compression_text'] = $this->QuicktimeDCOMLookup($atom_data);
 666                      break;
 667  
 668  
 669                  case 'rdrf': // Reference movie Data ReFerence atom
 670                      $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
 671                      $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
 672                      $atom_structure['flags']['internal_data'] = (bool) ($atom_structure['flags_raw'] & 0x000001);
 673  
 674                      $atom_structure['reference_type_name']    =                           substr($atom_data,  4, 4);
 675                      $atom_structure['reference_length']       = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
 676                      switch ($atom_structure['reference_type_name']) {
 677                          case 'url ':
 678                              $atom_structure['url']            =       $this->NoNullString(substr($atom_data, 12));
 679                              break;
 680  
 681                          case 'alis':
 682                              $atom_structure['file_alias']     =                           substr($atom_data, 12);
 683                              break;
 684  
 685                          case 'rsrc':
 686                              $atom_structure['resource_alias'] =                           substr($atom_data, 12);
 687                              break;
 688  
 689                          default:
 690                              $atom_structure['data']           =                           substr($atom_data, 12);
 691                              break;
 692                      }
 693                      break;
 694  
 695  
 696                  case 'rmqu': // Reference Movie QUality atom
 697                      $atom_structure['movie_quality'] = getid3_lib::BigEndian2Int($atom_data);
 698                      break;
 699  
 700  
 701                  case 'rmcs': // Reference Movie Cpu Speed atom
 702                      $atom_structure['version']          = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
 703                      $atom_structure['flags_raw']        = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
 704                      $atom_structure['cpu_speed_rating'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
 705                      break;
 706  
 707  
 708                  case 'rmvc': // Reference Movie Version Check atom
 709                      $atom_structure['version']            = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
 710                      $atom_structure['flags_raw']          = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
 711                      $atom_structure['gestalt_selector']   =                           substr($atom_data,  4, 4);
 712                      $atom_structure['gestalt_value_mask'] = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
 713                      $atom_structure['gestalt_value']      = getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
 714                      $atom_structure['gestalt_check_type'] = getid3_lib::BigEndian2Int(substr($atom_data, 14, 2));
 715                      break;
 716  
 717  
 718                  case 'rmcd': // Reference Movie Component check atom
 719                      $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
 720                      $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
 721                      $atom_structure['component_type']         =                           substr($atom_data,  4, 4);
 722                      $atom_structure['component_subtype']      =                           substr($atom_data,  8, 4);
 723                      $atom_structure['component_manufacturer'] =                           substr($atom_data, 12, 4);
 724                      $atom_structure['component_flags_raw']    = getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
 725                      $atom_structure['component_flags_mask']   = getid3_lib::BigEndian2Int(substr($atom_data, 20, 4));
 726                      $atom_structure['component_min_version']  = getid3_lib::BigEndian2Int(substr($atom_data, 24, 4));
 727                      break;
 728  
 729  
 730                  case 'rmdr': // Reference Movie Data Rate atom
 731                      $atom_structure['version']       = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
 732                      $atom_structure['flags_raw']     = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
 733                      $atom_structure['data_rate']     = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
 734  
 735                      $atom_structure['data_rate_bps'] = $atom_structure['data_rate'] * 10;
 736                      break;
 737  
 738  
 739                  case 'rmla': // Reference Movie Language Atom
 740                      $atom_structure['version']     = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
 741                      $atom_structure['flags_raw']   = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
 742                      $atom_structure['language_id'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
 743  
 744                      $atom_structure['language']    = $this->QuicktimeLanguageLookup($atom_structure['language_id']);
 745                      if (empty($info['comments']['language']) || (!in_array($atom_structure['language'], $info['comments']['language']))) {
 746                          $info['comments']['language'][] = $atom_structure['language'];
 747                      }
 748                      break;
 749  
 750  
 751                  case 'ptv ': // Print To Video - defines a movie's full screen mode
 752                      // http://developer.apple.com/documentation/QuickTime/APIREF/SOURCESIV/at_ptv-_pg.htm
 753                      $atom_structure['display_size_raw']  = getid3_lib::BigEndian2Int(substr($atom_data, 0, 2));
 754                      $atom_structure['reserved_1']        = getid3_lib::BigEndian2Int(substr($atom_data, 2, 2)); // hardcoded: 0x0000
 755                      $atom_structure['reserved_2']        = getid3_lib::BigEndian2Int(substr($atom_data, 4, 2)); // hardcoded: 0x0000
 756                      $atom_structure['slide_show_flag']   = getid3_lib::BigEndian2Int(substr($atom_data, 6, 1));
 757                      $atom_structure['play_on_open_flag'] = getid3_lib::BigEndian2Int(substr($atom_data, 7, 1));
 758  
 759                      $atom_structure['flags']['play_on_open'] = (bool) $atom_structure['play_on_open_flag'];
 760                      $atom_structure['flags']['slide_show']   = (bool) $atom_structure['slide_show_flag'];
 761  
 762                      $ptv_lookup = array(
 763                          0 => 'normal',
 764                          1 => 'double',
 765                          2 => 'half',
 766                          3 => 'full',
 767                          4 => 'current'
 768                      );
 769                      if (isset($ptv_lookup[$atom_structure['display_size_raw']])) {
 770                          $atom_structure['display_size'] = $ptv_lookup[$atom_structure['display_size_raw']];
 771                      } else {
 772                          $this->warning('unknown "ptv " display constant ('.$atom_structure['display_size_raw'].')');
 773                      }
 774                      break;
 775  
 776  
 777                  case 'stsd': // Sample Table Sample Description atom
 778                      $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1)); // hardcoded: 0x00
 779                      $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x000000
 780                      $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
 781  
 782                      // see: https://github.com/JamesHeinrich/getID3/issues/111
 783                      // Some corrupt files have been known to have high bits set in the number_entries field
 784                      // This field shouldn't really need to be 32-bits, values stores are likely in the range 1-100000
 785                      // Workaround: mask off the upper byte and throw a warning if it's nonzero
 786                      if ($atom_structure['number_entries'] > 0x000FFFFF) {
 787                          if ($atom_structure['number_entries'] > 0x00FFFFFF) {
 788                              $this->warning('"stsd" atom contains improbably large number_entries (0x'.getid3_lib::PrintHexBytes(substr($atom_data, 4, 4), true, false).' = '.$atom_structure['number_entries'].'), probably in error. Ignoring upper byte and interpreting this as 0x'.getid3_lib::PrintHexBytes(substr($atom_data, 5, 3), true, false).' = '.($atom_structure['number_entries'] & 0x00FFFFFF));
 789                              $atom_structure['number_entries'] = ($atom_structure['number_entries'] & 0x00FFFFFF);
 790                          } else {
 791                              $this->warning('"stsd" atom contains improbably large number_entries (0x'.getid3_lib::PrintHexBytes(substr($atom_data, 4, 4), true, false).' = '.$atom_structure['number_entries'].'), probably in error. Please report this to info@getid3.org referencing bug report #111');
 792                          }
 793                      }
 794  
 795                      $stsdEntriesDataOffset = 8;
 796                      for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
 797                          $atom_structure['sample_description_table'][$i]['size']             = getid3_lib::BigEndian2Int(substr($atom_data, $stsdEntriesDataOffset, 4));
 798                          $stsdEntriesDataOffset += 4;
 799                          $atom_structure['sample_description_table'][$i]['data_format']      =                           substr($atom_data, $stsdEntriesDataOffset, 4);
 800                          $stsdEntriesDataOffset += 4;
 801                          $atom_structure['sample_description_table'][$i]['reserved']         = getid3_lib::BigEndian2Int(substr($atom_data, $stsdEntriesDataOffset, 6));
 802                          $stsdEntriesDataOffset += 6;
 803                          $atom_structure['sample_description_table'][$i]['reference_index']  = getid3_lib::BigEndian2Int(substr($atom_data, $stsdEntriesDataOffset, 2));
 804                          $stsdEntriesDataOffset += 2;
 805                          $atom_structure['sample_description_table'][$i]['data']             =                           substr($atom_data, $stsdEntriesDataOffset, ($atom_structure['sample_description_table'][$i]['size'] - 4 - 4 - 6 - 2));
 806                          $stsdEntriesDataOffset += ($atom_structure['sample_description_table'][$i]['size'] - 4 - 4 - 6 - 2);
 807                          if (substr($atom_structure['sample_description_table'][$i]['data'],  1, 54) == 'application/octet-stream;type=com.parrot.videometadata') {
 808                              // special handling for apparently-malformed (TextMetaDataSampleEntry?) data for some version of Parrot drones
 809                              $atom_structure['sample_description_table'][$i]['parrot_frame_metadata']['mime_type']        =       substr($atom_structure['sample_description_table'][$i]['data'],  1, 55);
 810                              $atom_structure['sample_description_table'][$i]['parrot_frame_metadata']['metadata_version'] = (int) substr($atom_structure['sample_description_table'][$i]['data'], 55,  1);
 811                              unset($atom_structure['sample_description_table'][$i]['data']);
 812  $this->warning('incomplete/incorrect handling of "stsd" with Parrot metadata in this version of getID3() ['.$this->getid3->version().']');
 813                              continue;
 814                          }
 815  
 816                          $atom_structure['sample_description_table'][$i]['encoder_version']  = getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  0, 2));
 817                          $atom_structure['sample_description_table'][$i]['encoder_revision'] = getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  2, 2));
 818                          $atom_structure['sample_description_table'][$i]['encoder_vendor']   =                           substr($atom_structure['sample_description_table'][$i]['data'],  4, 4);
 819  
 820                          switch ($atom_structure['sample_description_table'][$i]['encoder_vendor']) {
 821  
 822                              case "\x00\x00\x00\x00":
 823                                  // audio tracks
 824                                  $atom_structure['sample_description_table'][$i]['audio_channels']       =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  8,  2));
 825                                  $atom_structure['sample_description_table'][$i]['audio_bit_depth']      =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 10,  2));
 826                                  $atom_structure['sample_description_table'][$i]['audio_compression_id'] =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 12,  2));
 827                                  $atom_structure['sample_description_table'][$i]['audio_packet_size']    =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 14,  2));
 828                                  $atom_structure['sample_description_table'][$i]['audio_sample_rate']    = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 16,  4));
 829  
 830                                  // video tracks
 831                                  // http://developer.apple.com/library/mac/#documentation/QuickTime/QTFF/QTFFChap3/qtff3.html
 832                                  $atom_structure['sample_description_table'][$i]['temporal_quality'] =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  8,  4));
 833                                  $atom_structure['sample_description_table'][$i]['spatial_quality']  =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 12,  4));
 834                                  $atom_structure['sample_description_table'][$i]['width']            =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 16,  2));
 835                                  $atom_structure['sample_description_table'][$i]['height']           =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 18,  2));
 836                                  $atom_structure['sample_description_table'][$i]['resolution_x']     = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 24,  4));
 837                                  $atom_structure['sample_description_table'][$i]['resolution_y']     = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 28,  4));
 838                                  $atom_structure['sample_description_table'][$i]['data_size']        =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 32,  4));
 839                                  $atom_structure['sample_description_table'][$i]['frame_count']      =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 36,  2));
 840                                  $atom_structure['sample_description_table'][$i]['compressor_name']  =                             substr($atom_structure['sample_description_table'][$i]['data'], 38,  4);
 841                                  $atom_structure['sample_description_table'][$i]['pixel_depth']      =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 42,  2));
 842                                  $atom_structure['sample_description_table'][$i]['color_table_id']   =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 44,  2));
 843  
 844                                  switch ($atom_structure['sample_description_table'][$i]['data_format']) {
 845                                      case '2vuY':
 846                                      case 'avc1':
 847                                      case 'cvid':
 848                                      case 'dvc ':
 849                                      case 'dvcp':
 850                                      case 'gif ':
 851                                      case 'h263':
 852                                      case 'hvc1':
 853                                      case 'jpeg':
 854                                      case 'kpcd':
 855                                      case 'mjpa':
 856                                      case 'mjpb':
 857                                      case 'mp4v':
 858                                      case 'png ':
 859                                      case 'raw ':
 860                                      case 'rle ':
 861                                      case 'rpza':
 862                                      case 'smc ':
 863                                      case 'SVQ1':
 864                                      case 'SVQ3':
 865                                      case 'tiff':
 866                                      case 'v210':
 867                                      case 'v216':
 868                                      case 'v308':
 869                                      case 'v408':
 870                                      case 'v410':
 871                                      case 'yuv2':
 872                                          $info['fileformat'] = 'mp4';
 873                                          $info['video']['fourcc'] = $atom_structure['sample_description_table'][$i]['data_format'];
 874                                          if ($this->QuicktimeVideoCodecLookup($info['video']['fourcc'])) {
 875                                              $info['video']['fourcc_lookup'] = $this->QuicktimeVideoCodecLookup($info['video']['fourcc']);
 876                                          }
 877  
 878                                          // https://www.getid3.org/phpBB3/viewtopic.php?t=1550
 879                                          //if ((!empty($atom_structure['sample_description_table'][$i]['width']) && !empty($atom_structure['sample_description_table'][$i]['width'])) && (empty($info['video']['resolution_x']) || empty($info['video']['resolution_y']) || (number_format($info['video']['resolution_x'], 6) != number_format(round($info['video']['resolution_x']), 6)) || (number_format($info['video']['resolution_y'], 6) != number_format(round($info['video']['resolution_y']), 6)))) { // ugly check for floating point numbers
 880                                          if (!empty($atom_structure['sample_description_table'][$i]['width']) && !empty($atom_structure['sample_description_table'][$i]['height'])) {
 881                                              // assume that values stored here are more important than values stored in [tkhd] atom
 882                                              $info['video']['resolution_x'] = $atom_structure['sample_description_table'][$i]['width'];
 883                                              $info['video']['resolution_y'] = $atom_structure['sample_description_table'][$i]['height'];
 884                                              $info['quicktime']['video']['resolution_x'] = $info['video']['resolution_x'];
 885                                              $info['quicktime']['video']['resolution_y'] = $info['video']['resolution_y'];
 886                                          }
 887                                          break;
 888  
 889                                      case 'qtvr':
 890                                          $info['video']['dataformat'] = 'quicktimevr';
 891                                          break;
 892  
 893                                      case 'mp4a':
 894                                          $atom_structure['sample_description_table'][$i]['subatoms'] = $this->QuicktimeParseContainerAtom(substr($atom_structure['sample_description_table'][$i]['data'], 20), $baseoffset + $stsdEntriesDataOffset - 20 - 16, $atomHierarchy, $ParseAllPossibleAtoms);
 895  
 896                                          $info['quicktime']['audio']['codec']       = $this->QuicktimeAudioCodecLookup($atom_structure['sample_description_table'][$i]['data_format']);
 897                                          $info['quicktime']['audio']['sample_rate'] = $atom_structure['sample_description_table'][$i]['audio_sample_rate'];
 898                                          $info['quicktime']['audio']['channels']    = $atom_structure['sample_description_table'][$i]['audio_channels'];
 899                                          $info['quicktime']['audio']['bit_depth']   = $atom_structure['sample_description_table'][$i]['audio_bit_depth'];
 900                                          $info['audio']['codec']                    = $info['quicktime']['audio']['codec'];
 901                                          $info['audio']['sample_rate']              = $info['quicktime']['audio']['sample_rate'];
 902                                          $info['audio']['channels']                 = $info['quicktime']['audio']['channels'];
 903                                          $info['audio']['bits_per_sample']          = $info['quicktime']['audio']['bit_depth'];
 904                                          switch ($atom_structure['sample_description_table'][$i]['data_format']) {
 905                                              case 'raw ': // PCM
 906                                              case 'alac': // Apple Lossless Audio Codec
 907                                              case 'sowt': // signed/two's complement (Little Endian)
 908                                              case 'twos': // signed/two's complement (Big Endian)
 909                                              case 'in24': // 24-bit Integer
 910                                              case 'in32': // 32-bit Integer
 911                                              case 'fl32': // 32-bit Floating Point
 912                                              case 'fl64': // 64-bit Floating Point
 913                                                  $info['audio']['lossless'] = $info['quicktime']['audio']['lossless'] = true;
 914                                                  $info['audio']['bitrate']  = $info['quicktime']['audio']['bitrate']  = $info['audio']['channels'] * $info['audio']['bits_per_sample'] * $info['audio']['sample_rate'];
 915                                                  break;
 916                                              default:
 917                                                  $info['audio']['lossless'] = false;
 918                                                  break;
 919                                          }
 920                                          break;
 921  
 922                                      default:
 923                                          break;
 924                                  }
 925                                  break;
 926  
 927                              default:
 928                                  switch ($atom_structure['sample_description_table'][$i]['data_format']) {
 929                                      case 'mp4s':
 930                                          $info['fileformat'] = 'mp4';
 931                                          break;
 932  
 933                                      default:
 934                                          // video atom
 935                                          $atom_structure['sample_description_table'][$i]['video_temporal_quality']  =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'],  8,  4));
 936                                          $atom_structure['sample_description_table'][$i]['video_spatial_quality']   =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 12,  4));
 937                                          $atom_structure['sample_description_table'][$i]['video_frame_width']       =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 16,  2));
 938                                          $atom_structure['sample_description_table'][$i]['video_frame_height']      =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 18,  2));
 939                                          $atom_structure['sample_description_table'][$i]['video_resolution_x']      = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 20,  4));
 940                                          $atom_structure['sample_description_table'][$i]['video_resolution_y']      = getid3_lib::FixedPoint16_16(substr($atom_structure['sample_description_table'][$i]['data'], 24,  4));
 941                                          $atom_structure['sample_description_table'][$i]['video_data_size']         =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 28,  4));
 942                                          $atom_structure['sample_description_table'][$i]['video_frame_count']       =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 32,  2));
 943                                          $atom_structure['sample_description_table'][$i]['video_encoder_name_len']  =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 34,  1));
 944                                          $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']);
 945                                          $atom_structure['sample_description_table'][$i]['video_pixel_color_depth'] =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 66,  2));
 946                                          $atom_structure['sample_description_table'][$i]['video_color_table_id']    =   getid3_lib::BigEndian2Int(substr($atom_structure['sample_description_table'][$i]['data'], 68,  2));
 947  
 948                                          $atom_structure['sample_description_table'][$i]['video_pixel_color_type']  = (((int) $atom_structure['sample_description_table'][$i]['video_pixel_color_depth'] > 32) ? 'grayscale' : 'color');
 949                                          $atom_structure['sample_description_table'][$i]['video_pixel_color_name']  = $this->QuicktimeColorNameLookup($atom_structure['sample_description_table'][$i]['video_pixel_color_depth']);
 950  
 951                                          if ($atom_structure['sample_description_table'][$i]['video_pixel_color_name'] != 'invalid') {
 952                                              $info['quicktime']['video']['codec_fourcc']        = $atom_structure['sample_description_table'][$i]['data_format'];
 953                                              $info['quicktime']['video']['codec_fourcc_lookup'] = $this->QuicktimeVideoCodecLookup($atom_structure['sample_description_table'][$i]['data_format']);
 954                                              $info['quicktime']['video']['codec']               = (((int) $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']);
 955                                              $info['quicktime']['video']['color_depth']         = $atom_structure['sample_description_table'][$i]['video_pixel_color_depth'];
 956                                              $info['quicktime']['video']['color_depth_name']    = $atom_structure['sample_description_table'][$i]['video_pixel_color_name'];
 957  
 958                                              $info['video']['codec']           = $info['quicktime']['video']['codec'];
 959                                              $info['video']['bits_per_sample'] = $info['quicktime']['video']['color_depth'];
 960                                          }
 961                                          $info['video']['lossless']           = false;
 962                                          $info['video']['pixel_aspect_ratio'] = (float) 1;
 963                                          break;
 964                                  }
 965                                  break;
 966                          }
 967                          switch (strtolower($atom_structure['sample_description_table'][$i]['data_format'])) {
 968                              case 'mp4a':
 969                                  $info['audio']['dataformat']         = 'mp4';
 970                                  $info['quicktime']['audio']['codec'] = 'mp4';
 971                                  break;
 972  
 973                              case '3ivx':
 974                              case '3iv1':
 975                              case '3iv2':
 976                                  $info['video']['dataformat'] = '3ivx';
 977                                  break;
 978  
 979                              case 'xvid':
 980                                  $info['video']['dataformat'] = 'xvid';
 981                                  break;
 982  
 983                              case 'mp4v':
 984                                  $info['video']['dataformat'] = 'mpeg4';
 985                                  break;
 986  
 987                              case 'divx':
 988                              case 'div1':
 989                              case 'div2':
 990                              case 'div3':
 991                              case 'div4':
 992                              case 'div5':
 993                              case 'div6':
 994                                  $info['video']['dataformat'] = 'divx';
 995                                  break;
 996  
 997                              default:
 998                                  // do nothing
 999                                  break;
1000                          }
1001                          unset($atom_structure['sample_description_table'][$i]['data']);
1002                      }
1003                      break;
1004  
1005  
1006                  case 'stts': // Sample Table Time-to-Sample atom
1007                      $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1008                      $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1009                      $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1010                      $sttsEntriesDataOffset = 8;
1011                      //$FrameRateCalculatorArray = array();
1012                      $frames_count = 0;
1013  
1014                      $max_stts_entries_to_scan = ($info['php_memory_limit'] ? min(floor($this->getid3->memory_limit / 10000), $atom_structure['number_entries']) : $atom_structure['number_entries']);
1015                      if ($max_stts_entries_to_scan < $atom_structure['number_entries']) {
1016                          $this->warning('QuickTime atom "stts" has '.$atom_structure['number_entries'].' but only scanning the first '.$max_stts_entries_to_scan.' entries due to limited PHP memory available ('.floor($this->getid3->memory_limit / 1048576).'MB).');
1017                      }
1018                      for ($i = 0; $i < $max_stts_entries_to_scan; $i++) {
1019                          $atom_structure['time_to_sample_table'][$i]['sample_count']    = getid3_lib::BigEndian2Int(substr($atom_data, $sttsEntriesDataOffset, 4));
1020                          $sttsEntriesDataOffset += 4;
1021                          $atom_structure['time_to_sample_table'][$i]['sample_duration'] = getid3_lib::BigEndian2Int(substr($atom_data, $sttsEntriesDataOffset, 4));
1022                          $sttsEntriesDataOffset += 4;
1023  
1024                          $frames_count += $atom_structure['time_to_sample_table'][$i]['sample_count'];
1025  
1026                          // THIS SECTION REPLACED WITH CODE IN "stbl" ATOM
1027                          //if (!empty($info['quicktime']['time_scale']) && ($atom_structure['time_to_sample_table'][$i]['sample_duration'] > 0)) {
1028                          //    $stts_new_framerate = $info['quicktime']['time_scale'] / $atom_structure['time_to_sample_table'][$i]['sample_duration'];
1029                          //    if ($stts_new_framerate <= 60) {
1030                          //        // some atoms have durations of "1" giving a very large framerate, which probably is not right
1031                          //        $info['video']['frame_rate'] = max($info['video']['frame_rate'], $stts_new_framerate);
1032                          //    }
1033                          //}
1034                          //
1035                          //$FrameRateCalculatorArray[($info['quicktime']['time_scale'] / $atom_structure['time_to_sample_table'][$i]['sample_duration'])] += $atom_structure['time_to_sample_table'][$i]['sample_count'];
1036                      }
1037                      $info['quicktime']['stts_framecount'][] = $frames_count;
1038                      //$sttsFramesTotal  = 0;
1039                      //$sttsSecondsTotal = 0;
1040                      //foreach ($FrameRateCalculatorArray as $frames_per_second => $frame_count) {
1041                      //    if (($frames_per_second > 60) || ($frames_per_second < 1)) {
1042                      //        // not video FPS information, probably audio information
1043                      //        $sttsFramesTotal  = 0;
1044                      //        $sttsSecondsTotal = 0;
1045                      //        break;
1046                      //    }
1047                      //    $sttsFramesTotal  += $frame_count;
1048                      //    $sttsSecondsTotal += $frame_count / $frames_per_second;
1049                      //}
1050                      //if (($sttsFramesTotal > 0) && ($sttsSecondsTotal > 0)) {
1051                      //    if (($sttsFramesTotal / $sttsSecondsTotal) > $info['video']['frame_rate']) {
1052                      //        $info['video']['frame_rate'] = $sttsFramesTotal / $sttsSecondsTotal;
1053                      //    }
1054                      //}
1055                      break;
1056  
1057  
1058                  case 'stss': // Sample Table Sync Sample (key frames) atom
1059                      if ($ParseAllPossibleAtoms) {
1060                          $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1061                          $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1062                          $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1063                          $stssEntriesDataOffset = 8;
1064                          for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
1065                              $atom_structure['time_to_sample_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stssEntriesDataOffset, 4));
1066                              $stssEntriesDataOffset += 4;
1067                          }
1068                      }
1069                      break;
1070  
1071  
1072                  case 'stsc': // Sample Table Sample-to-Chunk atom
1073                      if ($ParseAllPossibleAtoms) {
1074                          $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1075                          $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1076                          $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1077                          $stscEntriesDataOffset = 8;
1078                          for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
1079                              $atom_structure['sample_to_chunk_table'][$i]['first_chunk']        = getid3_lib::BigEndian2Int(substr($atom_data, $stscEntriesDataOffset, 4));
1080                              $stscEntriesDataOffset += 4;
1081                              $atom_structure['sample_to_chunk_table'][$i]['samples_per_chunk']  = getid3_lib::BigEndian2Int(substr($atom_data, $stscEntriesDataOffset, 4));
1082                              $stscEntriesDataOffset += 4;
1083                              $atom_structure['sample_to_chunk_table'][$i]['sample_description'] = getid3_lib::BigEndian2Int(substr($atom_data, $stscEntriesDataOffset, 4));
1084                              $stscEntriesDataOffset += 4;
1085                          }
1086                      }
1087                      break;
1088  
1089  
1090                  case 'stsz': // Sample Table SiZe atom
1091                      if ($ParseAllPossibleAtoms) {
1092                          $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1093                          $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1094                          $atom_structure['sample_size']    = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1095                          $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
1096                          $stszEntriesDataOffset = 12;
1097                          if ($atom_structure['sample_size'] == 0) {
1098                              for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
1099                                  $atom_structure['sample_size_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stszEntriesDataOffset, 4));
1100                                  $stszEntriesDataOffset += 4;
1101                              }
1102                          }
1103                      }
1104                      break;
1105  
1106  
1107                  case 'stco': // Sample Table Chunk Offset atom
1108  //                    if (true) {
1109                      if ($ParseAllPossibleAtoms) {
1110                          $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1111                          $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1112                          $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1113                          $stcoEntriesDataOffset = 8;
1114                          for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
1115                              $atom_structure['chunk_offset_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stcoEntriesDataOffset, 4));
1116                              $stcoEntriesDataOffset += 4;
1117                          }
1118                      }
1119                      break;
1120  
1121  
1122                  case 'co64': // Chunk Offset 64-bit (version of "stco" that supports > 2GB files)
1123                      if ($ParseAllPossibleAtoms) {
1124                          $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1125                          $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1126                          $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1127                          $stcoEntriesDataOffset = 8;
1128                          for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
1129                              $atom_structure['chunk_offset_table'][$i] = getid3_lib::BigEndian2Int(substr($atom_data, $stcoEntriesDataOffset, 8));
1130                              $stcoEntriesDataOffset += 8;
1131                          }
1132                      }
1133                      break;
1134  
1135  
1136                  case 'dref': // Data REFerence atom
1137                      $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1138                      $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1139                      $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1140                      $drefDataOffset = 8;
1141                      for ($i = 0; $i < $atom_structure['number_entries']; $i++) {
1142                          $atom_structure['data_references'][$i]['size']                    = getid3_lib::BigEndian2Int(substr($atom_data, $drefDataOffset, 4));
1143                          $drefDataOffset += 4;
1144                          $atom_structure['data_references'][$i]['type']                    =                           substr($atom_data, $drefDataOffset, 4);
1145                          $drefDataOffset += 4;
1146                          $atom_structure['data_references'][$i]['version']                 = getid3_lib::BigEndian2Int(substr($atom_data,  $drefDataOffset, 1));
1147                          $drefDataOffset += 1;
1148                          $atom_structure['data_references'][$i]['flags_raw']               = getid3_lib::BigEndian2Int(substr($atom_data,  $drefDataOffset, 3)); // hardcoded: 0x0000
1149                          $drefDataOffset += 3;
1150                          $atom_structure['data_references'][$i]['data']                    =                           substr($atom_data, $drefDataOffset, ($atom_structure['data_references'][$i]['size'] - 4 - 4 - 1 - 3));
1151                          $drefDataOffset += ($atom_structure['data_references'][$i]['size'] - 4 - 4 - 1 - 3);
1152  
1153                          $atom_structure['data_references'][$i]['flags']['self_reference'] = (bool) ($atom_structure['data_references'][$i]['flags_raw'] & 0x001);
1154                      }
1155                      break;
1156  
1157  
1158                  case 'gmin': // base Media INformation atom
1159                      $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1160                      $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1161                      $atom_structure['graphics_mode']          = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
1162                      $atom_structure['opcolor_red']            = getid3_lib::BigEndian2Int(substr($atom_data,  6, 2));
1163                      $atom_structure['opcolor_green']          = getid3_lib::BigEndian2Int(substr($atom_data,  8, 2));
1164                      $atom_structure['opcolor_blue']           = getid3_lib::BigEndian2Int(substr($atom_data, 10, 2));
1165                      $atom_structure['balance']                = getid3_lib::BigEndian2Int(substr($atom_data, 12, 2));
1166                      $atom_structure['reserved']               = getid3_lib::BigEndian2Int(substr($atom_data, 14, 2));
1167                      break;
1168  
1169  
1170                  case 'smhd': // Sound Media information HeaDer atom
1171                      $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1172                      $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1173                      $atom_structure['balance']                = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
1174                      $atom_structure['reserved']               = getid3_lib::BigEndian2Int(substr($atom_data,  6, 2));
1175                      break;
1176  
1177  
1178                  case 'vmhd': // Video Media information HeaDer atom
1179                      $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1180                      $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
1181                      $atom_structure['graphics_mode']          = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2));
1182                      $atom_structure['opcolor_red']            = getid3_lib::BigEndian2Int(substr($atom_data,  6, 2));
1183                      $atom_structure['opcolor_green']          = getid3_lib::BigEndian2Int(substr($atom_data,  8, 2));
1184                      $atom_structure['opcolor_blue']           = getid3_lib::BigEndian2Int(substr($atom_data, 10, 2));
1185  
1186                      $atom_structure['flags']['no_lean_ahead'] = (bool) ($atom_structure['flags_raw'] & 0x001);
1187                      break;
1188  
1189  
1190                  case 'hdlr': // HanDLeR reference atom
1191                      $atom_structure['version']                = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1192                      $atom_structure['flags_raw']              = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1193                      $atom_structure['component_type']         =                           substr($atom_data,  4, 4);
1194                      $atom_structure['component_subtype']      =                           substr($atom_data,  8, 4);
1195                      $atom_structure['component_manufacturer'] =                           substr($atom_data, 12, 4);
1196                      $atom_structure['component_flags_raw']    = getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
1197                      $atom_structure['component_flags_mask']   = getid3_lib::BigEndian2Int(substr($atom_data, 20, 4));
1198                      $atom_structure['component_name']         = $this->MaybePascal2String(substr($atom_data, 24));
1199  
1200                      if (($atom_structure['component_subtype'] == 'STpn') && ($atom_structure['component_manufacturer'] == 'zzzz')) {
1201                          $info['video']['dataformat'] = 'quicktimevr';
1202                      }
1203                      break;
1204  
1205  
1206                  case 'mdhd': // MeDia HeaDer atom
1207                      $atom_structure['version']               = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1208                      $atom_structure['flags_raw']             = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1209                      $atom_structure['creation_time']         = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1210                      $atom_structure['modify_time']           = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
1211                      $atom_structure['time_scale']            = getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
1212                      $atom_structure['duration']              = getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
1213                      $atom_structure['language_id']           = getid3_lib::BigEndian2Int(substr($atom_data, 20, 2));
1214                      $atom_structure['quality']               = getid3_lib::BigEndian2Int(substr($atom_data, 22, 2));
1215  
1216                      if ($atom_structure['time_scale'] == 0) {
1217                          $this->error('Corrupt Quicktime file: mdhd.time_scale == zero');
1218                          return false;
1219                      }
1220                      $info['quicktime']['time_scale'] = ((isset($info['quicktime']['time_scale']) && ($info['quicktime']['time_scale'] < 1000)) ? max($info['quicktime']['time_scale'], $atom_structure['time_scale']) : $atom_structure['time_scale']);
1221  
1222                      $atom_structure['creation_time_unix']    = getid3_lib::DateMac2Unix($atom_structure['creation_time']);
1223                      $atom_structure['modify_time_unix']      = getid3_lib::DateMac2Unix($atom_structure['modify_time']);
1224                      $atom_structure['playtime_seconds']      = $atom_structure['duration'] / $atom_structure['time_scale'];
1225                      $atom_structure['language']              = $this->QuicktimeLanguageLookup($atom_structure['language_id']);
1226                      if (empty($info['comments']['language']) || (!in_array($atom_structure['language'], $info['comments']['language']))) {
1227                          $info['comments']['language'][] = $atom_structure['language'];
1228                      }
1229                      $info['quicktime']['timestamps_unix']['create'][$atom_structure['hierarchy']] = $atom_structure['creation_time_unix'];
1230                      $info['quicktime']['timestamps_unix']['modify'][$atom_structure['hierarchy']] = $atom_structure['modify_time_unix'];
1231                      break;
1232  
1233  
1234                  case 'pnot': // Preview atom
1235                      $atom_structure['modification_date']      = getid3_lib::BigEndian2Int(substr($atom_data,  0, 4)); // "standard Macintosh format"
1236                      $atom_structure['version_number']         = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2)); // hardcoded: 0x00
1237                      $atom_structure['atom_type']              =                           substr($atom_data,  6, 4);        // usually: 'PICT'
1238                      $atom_structure['atom_index']             = getid3_lib::BigEndian2Int(substr($atom_data, 10, 2)); // usually: 0x01
1239  
1240                      $atom_structure['modification_date_unix'] = getid3_lib::DateMac2Unix($atom_structure['modification_date']);
1241                      $info['quicktime']['timestamps_unix']['modify'][$atom_structure['hierarchy']] = $atom_structure['modification_date_unix'];
1242                      break;
1243  
1244  
1245                  case 'crgn': // Clipping ReGioN atom
1246                      $atom_structure['region_size']   = getid3_lib::BigEndian2Int(substr($atom_data,  0, 2)); // The Region size, Region boundary box,
1247                      $atom_structure['boundary_box']  = getid3_lib::BigEndian2Int(substr($atom_data,  2, 8)); // and Clipping region data fields
1248                      $atom_structure['clipping_data'] =                           substr($atom_data, 10);           // constitute a QuickDraw region.
1249                      break;
1250  
1251  
1252                  case 'load': // track LOAD settings atom
1253                      $atom_structure['preload_start_time'] = getid3_lib::BigEndian2Int(substr($atom_data,  0, 4));
1254                      $atom_structure['preload_duration']   = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1255                      $atom_structure['preload_flags_raw']  = getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
1256                      $atom_structure['default_hints_raw']  = getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
1257  
1258                      $atom_structure['default_hints']['double_buffer'] = (bool) ($atom_structure['default_hints_raw'] & 0x0020);
1259                      $atom_structure['default_hints']['high_quality']  = (bool) ($atom_structure['default_hints_raw'] & 0x0100);
1260                      break;
1261  
1262  
1263                  case 'tmcd': // TiMe CoDe atom
1264                  case 'chap': // CHAPter list atom
1265                  case 'sync': // SYNChronization atom
1266                  case 'scpt': // tranSCriPT atom
1267                  case 'ssrc': // non-primary SouRCe atom
1268                      for ($i = 0; $i < strlen($atom_data); $i += 4) {
1269                          @$atom_structure['track_id'][] = getid3_lib::BigEndian2Int(substr($atom_data, $i, 4));
1270                      }
1271                      break;
1272  
1273  
1274                  case 'elst': // Edit LiST atom
1275                      $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1276                      $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1277                      $atom_structure['number_entries'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1278                      for ($i = 0; $i < $atom_structure['number_entries']; $i++ ) {
1279                          $atom_structure['edit_list'][$i]['track_duration'] =   getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($i * 12) + 0, 4));
1280                          $atom_structure['edit_list'][$i]['media_time']     =   getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($i * 12) + 4, 4));
1281                          $atom_structure['edit_list'][$i]['media_rate']     = getid3_lib::FixedPoint16_16(substr($atom_data, 8 + ($i * 12) + 8, 4));
1282                      }
1283                      break;
1284  
1285  
1286                  case 'kmat': // compressed MATte atom
1287                      $atom_structure['version']        = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1288                      $atom_structure['flags_raw']      = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x0000
1289                      $atom_structure['matte_data_raw'] =               substr($atom_data,  4);
1290                      break;
1291  
1292  
1293                  case 'ctab': // Color TABle atom
1294                      $atom_structure['color_table_seed']   = getid3_lib::BigEndian2Int(substr($atom_data,  0, 4)); // hardcoded: 0x00000000
1295                      $atom_structure['color_table_flags']  = getid3_lib::BigEndian2Int(substr($atom_data,  4, 2)); // hardcoded: 0x8000
1296                      $atom_structure['color_table_size']   = getid3_lib::BigEndian2Int(substr($atom_data,  6, 2)) + 1;
1297                      for ($colortableentry = 0; $colortableentry < $atom_structure['color_table_size']; $colortableentry++) {
1298                          $atom_structure['color_table'][$colortableentry]['alpha'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 0, 2));
1299                          $atom_structure['color_table'][$colortableentry]['red']   = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 2, 2));
1300                          $atom_structure['color_table'][$colortableentry]['green'] = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 4, 2));
1301                          $atom_structure['color_table'][$colortableentry]['blue']  = getid3_lib::BigEndian2Int(substr($atom_data, 8 + ($colortableentry * 8) + 6, 2));
1302                      }
1303                      break;
1304  
1305  
1306                  case 'mvhd': // MoVie HeaDer atom
1307                      $atom_structure['version']            =   getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1308                      $atom_structure['flags_raw']          =   getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
1309                      $atom_structure['creation_time']      =   getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1310                      $atom_structure['modify_time']        =   getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
1311                      $atom_structure['time_scale']         =   getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
1312                      $atom_structure['duration']           =   getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
1313                      $atom_structure['preferred_rate']     = getid3_lib::FixedPoint16_16(substr($atom_data, 20, 4));
1314                      $atom_structure['preferred_volume']   =   getid3_lib::FixedPoint8_8(substr($atom_data, 24, 2));
1315                      $atom_structure['reserved']           =                             substr($atom_data, 26, 10);
1316                      $atom_structure['matrix_a']           = getid3_lib::FixedPoint16_16(substr($atom_data, 36, 4));
1317                      $atom_structure['matrix_b']           = getid3_lib::FixedPoint16_16(substr($atom_data, 40, 4));
1318                      $atom_structure['matrix_u']           =  getid3_lib::FixedPoint2_30(substr($atom_data, 44, 4));
1319                      $atom_structure['matrix_c']           = getid3_lib::FixedPoint16_16(substr($atom_data, 48, 4));
1320                      $atom_structure['matrix_d']           = getid3_lib::FixedPoint16_16(substr($atom_data, 52, 4));
1321                      $atom_structure['matrix_v']           =  getid3_lib::FixedPoint2_30(substr($atom_data, 56, 4));
1322                      $atom_structure['matrix_x']           = getid3_lib::FixedPoint16_16(substr($atom_data, 60, 4));
1323                      $atom_structure['matrix_y']           = getid3_lib::FixedPoint16_16(substr($atom_data, 64, 4));
1324                      $atom_structure['matrix_w']           =  getid3_lib::FixedPoint2_30(substr($atom_data, 68, 4));
1325                      $atom_structure['preview_time']       =   getid3_lib::BigEndian2Int(substr($atom_data, 72, 4));
1326                      $atom_structure['preview_duration']   =   getid3_lib::BigEndian2Int(substr($atom_data, 76, 4));
1327                      $atom_structure['poster_time']        =   getid3_lib::BigEndian2Int(substr($atom_data, 80, 4));
1328                      $atom_structure['selection_time']     =   getid3_lib::BigEndian2Int(substr($atom_data, 84, 4));
1329                      $atom_structure['selection_duration'] =   getid3_lib::BigEndian2Int(substr($atom_data, 88, 4));
1330                      $atom_structure['current_time']       =   getid3_lib::BigEndian2Int(substr($atom_data, 92, 4));
1331                      $atom_structure['next_track_id']      =   getid3_lib::BigEndian2Int(substr($atom_data, 96, 4));
1332  
1333                      if ($atom_structure['time_scale'] == 0) {
1334                          $this->error('Corrupt Quicktime file: mvhd.time_scale == zero');
1335                          return false;
1336                      }
1337                      $atom_structure['creation_time_unix']        = getid3_lib::DateMac2Unix($atom_structure['creation_time']);
1338                      $atom_structure['modify_time_unix']          = getid3_lib::DateMac2Unix($atom_structure['modify_time']);
1339                      $info['quicktime']['timestamps_unix']['create'][$atom_structure['hierarchy']] = $atom_structure['creation_time_unix'];
1340                      $info['quicktime']['timestamps_unix']['modify'][$atom_structure['hierarchy']] = $atom_structure['modify_time_unix'];
1341                      $info['quicktime']['time_scale']    = ((isset($info['quicktime']['time_scale']) && ($info['quicktime']['time_scale'] < 1000)) ? max($info['quicktime']['time_scale'], $atom_structure['time_scale']) : $atom_structure['time_scale']);
1342                      $info['quicktime']['display_scale'] = $atom_structure['matrix_a'];
1343                      $info['playtime_seconds']           = $atom_structure['duration'] / $atom_structure['time_scale'];
1344                      break;
1345  
1346  
1347                  case 'tkhd': // TracK HeaDer atom
1348                      $atom_structure['version']             =   getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1349                      $atom_structure['flags_raw']           =   getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
1350                      $atom_structure['creation_time']       =   getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1351                      $atom_structure['modify_time']         =   getid3_lib::BigEndian2Int(substr($atom_data,  8, 4));
1352                      $atom_structure['trackid']             =   getid3_lib::BigEndian2Int(substr($atom_data, 12, 4));
1353                      $atom_structure['reserved1']           =   getid3_lib::BigEndian2Int(substr($atom_data, 16, 4));
1354                      $atom_structure['duration']            =   getid3_lib::BigEndian2Int(substr($atom_data, 20, 4));
1355                      $atom_structure['reserved2']           =   getid3_lib::BigEndian2Int(substr($atom_data, 24, 8));
1356                      $atom_structure['layer']               =   getid3_lib::BigEndian2Int(substr($atom_data, 32, 2));
1357                      $atom_structure['alternate_group']     =   getid3_lib::BigEndian2Int(substr($atom_data, 34, 2));
1358                      $atom_structure['volume']              =   getid3_lib::FixedPoint8_8(substr($atom_data, 36, 2));
1359                      $atom_structure['reserved3']           =   getid3_lib::BigEndian2Int(substr($atom_data, 38, 2));
1360                      // http://developer.apple.com/library/mac/#documentation/QuickTime/RM/MovieBasics/MTEditing/K-Chapter/11MatrixFunctions.html
1361                      // http://developer.apple.com/library/mac/#documentation/QuickTime/qtff/QTFFChap4/qtff4.html#//apple_ref/doc/uid/TP40000939-CH206-18737
1362                      $atom_structure['matrix_a']            = getid3_lib::FixedPoint16_16(substr($atom_data, 40, 4));
1363                      $atom_structure['matrix_b']            = getid3_lib::FixedPoint16_16(substr($atom_data, 44, 4));
1364                      $atom_structure['matrix_u']            =  getid3_lib::FixedPoint2_30(substr($atom_data, 48, 4));
1365                      $atom_structure['matrix_c']            = getid3_lib::FixedPoint16_16(substr($atom_data, 52, 4));
1366                      $atom_structure['matrix_d']            = getid3_lib::FixedPoint16_16(substr($atom_data, 56, 4));
1367                      $atom_structure['matrix_v']            =  getid3_lib::FixedPoint2_30(substr($atom_data, 60, 4));
1368                      $atom_structure['matrix_x']            = getid3_lib::FixedPoint16_16(substr($atom_data, 64, 4));
1369                      $atom_structure['matrix_y']            = getid3_lib::FixedPoint16_16(substr($atom_data, 68, 4));
1370                      $atom_structure['matrix_w']            =  getid3_lib::FixedPoint2_30(substr($atom_data, 72, 4));
1371                      $atom_structure['width']               = getid3_lib::FixedPoint16_16(substr($atom_data, 76, 4));
1372                      $atom_structure['height']              = getid3_lib::FixedPoint16_16(substr($atom_data, 80, 4));
1373                      $atom_structure['flags']['enabled']    = (bool) ($atom_structure['flags_raw'] & 0x0001);
1374                      $atom_structure['flags']['in_movie']   = (bool) ($atom_structure['flags_raw'] & 0x0002);
1375                      $atom_structure['flags']['in_preview'] = (bool) ($atom_structure['flags_raw'] & 0x0004);
1376                      $atom_structure['flags']['in_poster']  = (bool) ($atom_structure['flags_raw'] & 0x0008);
1377                      $atom_structure['creation_time_unix']  = getid3_lib::DateMac2Unix($atom_structure['creation_time']);
1378                      $atom_structure['modify_time_unix']    = getid3_lib::DateMac2Unix($atom_structure['modify_time']);
1379                      $info['quicktime']['timestamps_unix']['create'][$atom_structure['hierarchy']] = $atom_structure['creation_time_unix'];
1380                      $info['quicktime']['timestamps_unix']['modify'][$atom_structure['hierarchy']] = $atom_structure['modify_time_unix'];
1381  
1382                      // https://www.getid3.org/phpBB3/viewtopic.php?t=1908
1383                      // attempt to compute rotation from matrix values
1384                      // 2017-Dec-28: uncertain if 90/270 are correctly oriented; values returned by FixedPoint16_16 should perhaps be -1 instead of 65535(?)
1385                      $matrixRotation = 0;
1386                      switch ($atom_structure['matrix_a'].':'.$atom_structure['matrix_b'].':'.$atom_structure['matrix_c'].':'.$atom_structure['matrix_d']) {
1387                          case '1:0:0:1':         $matrixRotation =   0; break;
1388                          case '0:1:65535:0':     $matrixRotation =  90; break;
1389                          case '65535:0:0:65535': $matrixRotation = 180; break;
1390                          case '0:65535:1:0':     $matrixRotation = 270; break;
1391                          default: break;
1392                      }
1393  
1394                      // https://www.getid3.org/phpBB3/viewtopic.php?t=2468
1395                      // The rotation matrix can appear in the Quicktime file multiple times, at least once for each track,
1396                      // and it's possible that only the video track (or, in theory, one of the video tracks) is flagged as
1397                      // rotated while the other tracks (e.g. audio) is tagged as rotation=0 (behavior noted on iPhone 8 Plus)
1398                      // The correct solution would be to check if the TrackID associated with the rotation matrix is indeed
1399                      // a video track (or the main video track) and only set the rotation then, but since information about
1400                      // what track is what is not trivially there to be examined, the lazy solution is to set the rotation
1401                      // if it is found to be nonzero, on the assumption that tracks that don't need it will have rotation set
1402                      // to zero (and be effectively ignored) and the video track will have rotation set correctly, which will
1403                      // either be zero and automatically correct, or nonzero and be set correctly.
1404                      if (!isset($info['video']['rotate']) || (($info['video']['rotate'] == 0) && ($matrixRotation > 0))) {
1405                          $info['quicktime']['video']['rotate'] = $info['video']['rotate'] = $matrixRotation;
1406                      }
1407  
1408                      if ($atom_structure['flags']['enabled'] == 1) {
1409                          if (!isset($info['video']['resolution_x']) || !isset($info['video']['resolution_y'])) {
1410                              $info['video']['resolution_x'] = $atom_structure['width'];
1411                              $info['video']['resolution_y'] = $atom_structure['height'];
1412                          }
1413                          $info['video']['resolution_x'] = max($info['video']['resolution_x'], $atom_structure['width']);
1414                          $info['video']['resolution_y'] = max($info['video']['resolution_y'], $atom_structure['height']);
1415                          $info['quicktime']['video']['resolution_x'] = $info['video']['resolution_x'];
1416                          $info['quicktime']['video']['resolution_y'] = $info['video']['resolution_y'];
1417                      } else {
1418                          // see: https://www.getid3.org/phpBB3/viewtopic.php?t=1295
1419                          //if (isset($info['video']['resolution_x'])) { unset($info['video']['resolution_x']); }
1420                          //if (isset($info['video']['resolution_y'])) { unset($info['video']['resolution_y']); }
1421                          //if (isset($info['quicktime']['video']))    { unset($info['quicktime']['video']);    }
1422                      }
1423                      break;
1424  
1425  
1426                  case 'iods': // Initial Object DeScriptor atom
1427                      // http://www.koders.com/c/fid1FAB3E762903DC482D8A246D4A4BF9F28E049594.aspx?s=windows.h
1428                      // http://libquicktime.sourcearchive.com/documentation/1.0.2plus-pdebian/iods_8c-source.html
1429                      $offset = 0;
1430                      $atom_structure['version']                =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1431                      $offset += 1;
1432                      $atom_structure['flags_raw']              =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 3));
1433                      $offset += 3;
1434                      $atom_structure['mp4_iod_tag']            =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1435                      $offset += 1;
1436                      $atom_structure['length']                 = $this->quicktime_read_mp4_descr_length($atom_data, $offset);
1437                      //$offset already adjusted by quicktime_read_mp4_descr_length()
1438                      $atom_structure['object_descriptor_id']   =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 2));
1439                      $offset += 2;
1440                      $atom_structure['od_profile_level']       =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1441                      $offset += 1;
1442                      $atom_structure['scene_profile_level']    =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1443                      $offset += 1;
1444                      $atom_structure['audio_profile_id']       =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1445                      $offset += 1;
1446                      $atom_structure['video_profile_id']       =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1447                      $offset += 1;
1448                      $atom_structure['graphics_profile_level'] =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1449                      $offset += 1;
1450  
1451                      $atom_structure['num_iods_tracks'] = ($atom_structure['length'] - 7) / 6; // 6 bytes would only be right if all tracks use 1-byte length fields
1452                      for ($i = 0; $i < $atom_structure['num_iods_tracks']; $i++) {
1453                          $atom_structure['track'][$i]['ES_ID_IncTag'] =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 1));
1454                          $offset += 1;
1455                          $atom_structure['track'][$i]['length']       = $this->quicktime_read_mp4_descr_length($atom_data, $offset);
1456                          //$offset already adjusted by quicktime_read_mp4_descr_length()
1457                          $atom_structure['track'][$i]['track_id']     =       getid3_lib::BigEndian2Int(substr($atom_data, $offset, 4));
1458                          $offset += 4;
1459                      }
1460  
1461                      $atom_structure['audio_profile_name'] = $this->QuicktimeIODSaudioProfileName($atom_structure['audio_profile_id']);
1462                      $atom_structure['video_profile_name'] = $this->QuicktimeIODSvideoProfileName($atom_structure['video_profile_id']);
1463                      break;
1464  
1465                  case 'ftyp': // FileTYPe (?) atom (for MP4 it seems)
1466                      $atom_structure['signature'] =                           substr($atom_data,  0, 4);
1467                      $atom_structure['unknown_1'] = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1468                      $atom_structure['fourcc']    =                           substr($atom_data,  8, 4);
1469                      break;
1470  
1471                  case 'mdat': // Media DATa atom
1472                      // 'mdat' contains the actual data for the audio/video, possibly also subtitles
1473  
1474      /* due to lack of known documentation, this is a kludge implementation. If you know of documentation on how mdat is properly structed, please send it to info@getid3.org */
1475  
1476                      // first, skip any 'wide' padding, and second 'mdat' header (with specified size of zero?)
1477                      $mdat_offset = 0;
1478                      while (true) {
1479                          if (substr($atom_data, $mdat_offset, 8) == "\x00\x00\x00\x08".'wide') {
1480                              $mdat_offset += 8;
1481                          } elseif (substr($atom_data, $mdat_offset, 8) == "\x00\x00\x00\x00".'mdat') {
1482                              $mdat_offset += 8;
1483                          } else {
1484                              break;
1485                          }
1486                      }
1487                      if (substr($atom_data, $mdat_offset, 4) == 'GPRO') {
1488                          $GOPRO_chunk_length = getid3_lib::LittleEndian2Int(substr($atom_data, $mdat_offset + 4, 4));
1489                          $GOPRO_offset = 8;
1490                          $atom_structure['GPRO']['raw'] = substr($atom_data, $mdat_offset + 8, $GOPRO_chunk_length - 8);
1491                          $atom_structure['GPRO']['firmware'] = substr($atom_structure['GPRO']['raw'],  0, 15);
1492                          $atom_structure['GPRO']['unknown1'] = substr($atom_structure['GPRO']['raw'], 15, 16);
1493                          $atom_structure['GPRO']['unknown2'] = substr($atom_structure['GPRO']['raw'], 31, 32);
1494                          $atom_structure['GPRO']['unknown3'] = substr($atom_structure['GPRO']['raw'], 63, 16);
1495                          $atom_structure['GPRO']['camera']   = substr($atom_structure['GPRO']['raw'], 79, 32);
1496                          $info['quicktime']['camera']['model'] = rtrim($atom_structure['GPRO']['camera'], "\x00");
1497                      }
1498  
1499                      // check to see if it looks like chapter titles, in the form of unterminated strings with a leading 16-bit size field
1500                      while (($mdat_offset < (strlen($atom_data) - 8))
1501                          && ($chapter_string_length = getid3_lib::BigEndian2Int(substr($atom_data, $mdat_offset, 2)))
1502                          && ($chapter_string_length < 1000)
1503                          && ($chapter_string_length <= (strlen($atom_data) - $mdat_offset - 2))
1504                          && preg_match('#^([\x00-\xFF]{2})([\x20-\xFF]+)$#', substr($atom_data, $mdat_offset, $chapter_string_length + 2), $chapter_matches)) {
1505                              list($dummy, $chapter_string_length_hex, $chapter_string) = $chapter_matches;
1506                              $mdat_offset += (2 + $chapter_string_length);
1507                              @$info['quicktime']['comments']['chapters'][] = $chapter_string;
1508  
1509                              // "encd" atom specifies encoding. In theory could be anything, almost always UTF-8, but may be UTF-16 with BOM (not currently handled)
1510                              if (substr($atom_data, $mdat_offset, 12) == "\x00\x00\x00\x0C\x65\x6E\x63\x64\x00\x00\x01\x00") { // UTF-8
1511                                  $mdat_offset += 12;
1512                              }
1513                      }
1514  
1515                      if (($atomsize > 8) && (!isset($info['avdataend_tmp']) || ($info['quicktime'][$atomname]['size'] > ($info['avdataend_tmp'] - $info['avdataoffset'])))) {
1516  
1517                          $info['avdataoffset'] = $atom_structure['offset'] + 8;                       // $info['quicktime'][$atomname]['offset'] + 8;
1518                          $OldAVDataEnd         = $info['avdataend'];
1519                          $info['avdataend']    = $atom_structure['offset'] + $atom_structure['size']; // $info['quicktime'][$atomname]['offset'] + $info['quicktime'][$atomname]['size'];
1520  
1521                          $getid3_temp = new getID3();
1522                          $getid3_temp->openfile($this->getid3->filename, $this->getid3->info['filesize'], $this->getid3->fp);
1523                          $getid3_temp->info['avdataoffset'] = $info['avdataoffset'];
1524                          $getid3_temp->info['avdataend']    = $info['avdataend'];
1525                          $getid3_mp3 = new getid3_mp3($getid3_temp);
1526                          if ($getid3_mp3->MPEGaudioHeaderValid($getid3_mp3->MPEGaudioHeaderDecode($this->fread(4)))) {
1527                              $getid3_mp3->getOnlyMPEGaudioInfo($getid3_temp->info['avdataoffset'], false);
1528                              if (!empty($getid3_temp->info['warning'])) {
1529                                  foreach ($getid3_temp->info['warning'] as $value) {
1530                                      $this->warning($value);
1531                                  }
1532                              }
1533                              if (!empty($getid3_temp->info['mpeg'])) {
1534                                  $info['mpeg'] = $getid3_temp->info['mpeg'];
1535                                  if (isset($info['mpeg']['audio'])) {
1536                                      $info['audio']['dataformat']   = 'mp3';
1537                                      $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')));
1538                                      $info['audio']['sample_rate']  = $info['mpeg']['audio']['sample_rate'];
1539                                      $info['audio']['channels']     = $info['mpeg']['audio']['channels'];
1540                                      $info['audio']['bitrate']      = $info['mpeg']['audio']['bitrate'];
1541                                      $info['audio']['bitrate_mode'] = strtolower($info['mpeg']['audio']['bitrate_mode']);
1542                                      $info['bitrate']               = $info['audio']['bitrate'];
1543                                  }
1544                              }
1545                          }
1546                          unset($getid3_mp3, $getid3_temp);
1547                          $info['avdataend'] = $OldAVDataEnd;
1548                          unset($OldAVDataEnd);
1549  
1550                      }
1551  
1552                      unset($mdat_offset, $chapter_string_length, $chapter_matches);
1553                      break;
1554  
1555                  case 'ID32': // ID3v2
1556                      getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.tag.id3v2.php', __FILE__, true);
1557  
1558                      $getid3_temp = new getID3();
1559                      $getid3_temp->openfile($this->getid3->filename, $this->getid3->info['filesize'], $this->getid3->fp);
1560                      $getid3_id3v2 = new getid3_id3v2($getid3_temp);
1561                      $getid3_id3v2->StartingOffset = $atom_structure['offset'] + 14; // framelength(4)+framename(4)+flags(4)+??(2)
1562                      if ($atom_structure['valid'] = $getid3_id3v2->Analyze()) {
1563                          $atom_structure['id3v2'] = $getid3_temp->info['id3v2'];
1564                      } else {
1565                          $this->warning('ID32 frame at offset '.$atom_structure['offset'].' did not parse');
1566                      }
1567                      unset($getid3_temp, $getid3_id3v2);
1568                      break;
1569  
1570                  case 'free': // FREE space atom
1571                  case 'skip': // SKIP atom
1572                  case 'wide': // 64-bit expansion placeholder atom
1573                      // 'free', 'skip' and 'wide' are just padding, contains no useful data at all
1574  
1575                      // When writing QuickTime files, it is sometimes necessary to update an atom's size.
1576                      // It is impossible to update a 32-bit atom to a 64-bit atom since the 32-bit atom
1577                      // is only 8 bytes in size, and the 64-bit atom requires 16 bytes. Therefore, QuickTime
1578                      // puts an 8-byte placeholder atom before any atoms it may have to update the size of.
1579                      // In this way, if the atom needs to be converted from a 32-bit to a 64-bit atom, the
1580                      // placeholder atom can be overwritten to obtain the necessary 8 extra bytes.
1581                      // The placeholder atom has a type of kWideAtomPlaceholderType ( 'wide' ).
1582                      break;
1583  
1584  
1585                  case 'nsav': // NoSAVe atom
1586                      // http://developer.apple.com/technotes/tn/tn2038.html
1587                      $atom_structure['data'] = getid3_lib::BigEndian2Int(substr($atom_data,  0, 4));
1588                      break;
1589  
1590                  case 'ctyp': // Controller TYPe atom (seen on QTVR)
1591                      // http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt
1592                      // some controller names are:
1593                      //   0x00 + 'std' for linear movie
1594                      //   'none' for no controls
1595                      $atom_structure['ctyp'] = substr($atom_data, 0, 4);
1596                      $info['quicktime']['controller'] = $atom_structure['ctyp'];
1597                      switch ($atom_structure['ctyp']) {
1598                          case 'qtvr':
1599                              $info['video']['dataformat'] = 'quicktimevr';
1600                              break;
1601                      }
1602                      break;
1603  
1604                  case 'pano': // PANOrama track (seen on QTVR)
1605                      $atom_structure['pano'] = getid3_lib::BigEndian2Int(substr($atom_data,  0, 4));
1606                      break;
1607  
1608                  case 'hint': // HINT track
1609                  case 'hinf': //
1610                  case 'hinv': //
1611                  case 'hnti': //
1612                      $info['quicktime']['hinting'] = true;
1613                      break;
1614  
1615                  case 'imgt': // IMaGe Track reference (kQTVRImageTrackRefType) (seen on QTVR)
1616                      for ($i = 0; $i < ($atom_structure['size'] - 8); $i += 4) {
1617                          $atom_structure['imgt'][] = getid3_lib::BigEndian2Int(substr($atom_data, $i, 4));
1618                      }
1619                      break;
1620  
1621  
1622                  // Observed-but-not-handled atom types are just listed here to prevent warnings being generated
1623                  case 'FXTC': // Something to do with Adobe After Effects (?)
1624                  case 'PrmA':
1625                  case 'code':
1626                  case 'FIEL': // this is NOT "fiel" (Field Ordering) as describe here: http://developer.apple.com/documentation/QuickTime/QTFF/QTFFChap3/chapter_4_section_2.html
1627                  case 'tapt': // TrackApertureModeDimensionsAID - http://developer.apple.com/documentation/QuickTime/Reference/QT7-1_Update_Reference/Constants/Constants.html
1628                              // tapt seems to be used to compute the video size [https://www.getid3.org/phpBB3/viewtopic.php?t=838]
1629                              // * http://lists.apple.com/archives/quicktime-api/2006/Aug/msg00014.html
1630                              // * http://handbrake.fr/irclogs/handbrake-dev/handbrake-dev20080128_pg2.html
1631                  case 'ctts'://  STCompositionOffsetAID             - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
1632                  case 'cslg'://  STCompositionShiftLeastGreatestAID - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
1633                  case 'sdtp'://  STSampleDependencyAID              - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
1634                  case 'stps'://  STPartialSyncSampleAID             - http://developer.apple.com/documentation/QuickTime/Reference/QTRef_Constants/Reference/reference.html
1635                      //$atom_structure['data'] = $atom_data;
1636                      break;
1637  
1638                  case "\xA9".'xyz':  // GPS latitude+longitude+altitude
1639                      $atom_structure['data'] = $atom_data;
1640                      if (preg_match('#([\\+\\-][0-9\\.]+)([\\+\\-][0-9\\.]+)([\\+\\-][0-9\\.]+)?/$#i', $atom_data, $matches)) {
1641                          @list($all, $latitude, $longitude, $altitude) = $matches;
1642                          $info['quicktime']['comments']['gps_latitude'][]  = floatval($latitude);
1643                          $info['quicktime']['comments']['gps_longitude'][] = floatval($longitude);
1644                          if (!empty($altitude)) {
1645                              $info['quicktime']['comments']['gps_altitude'][] = floatval($altitude);
1646                          }
1647                      } else {
1648                          $this->warning('QuickTime atom "©xyz" data does not match expected data pattern at offset '.$baseoffset.'. Please report as getID3() bug.');
1649                      }
1650                      break;
1651  
1652                  case 'NCDT':
1653                      // https://exiftool.org/TagNames/Nikon.html
1654                      // Nikon-specific QuickTime tags found in the NCDT atom of MOV videos from some Nikon cameras such as the Coolpix S8000 and D5100
1655                      $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 4, $atomHierarchy, $ParseAllPossibleAtoms);
1656                      break;
1657                  case 'NCTH': // Nikon Camera THumbnail image
1658                  case 'NCVW': // Nikon Camera preVieW image
1659                  case 'NCM1': // Nikon Camera preview iMage 1
1660                  case 'NCM2': // Nikon Camera preview iMage 2
1661                      // https://exiftool.org/TagNames/Nikon.html
1662                      if (preg_match('/^\xFF\xD8\xFF/', $atom_data)) {
1663                          $descriptions = array(
1664                              'NCTH' => 'Nikon Camera Thumbnail Image',
1665                              'NCVW' => 'Nikon Camera Preview Image',
1666                              'NCM1' => 'Nikon Camera Preview Image 1',
1667                              'NCM2' => 'Nikon Camera Preview Image 2',
1668                          );
1669                          $atom_structure['data'] = $atom_data;
1670                          $atom_structure['image_mime'] = 'image/jpeg';
1671                          $atom_structure['description'] = $descriptions[$atomname];
1672                          $info['quicktime']['comments']['picture'][] = array(
1673                              'image_mime' => $atom_structure['image_mime'],
1674                              'data' => $atom_data,
1675                              'description' => $atom_structure['description']
1676                          );
1677                      }
1678                      break;
1679                  case 'NCTG': // Nikon - https://exiftool.org/TagNames/Nikon.html#NCTG
1680                      getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.tag.nikon-nctg.php', __FILE__, true);
1681                      $nikonNCTG = new getid3_tag_nikon_nctg($this->getid3);
1682  
1683                      $atom_structure['data'] = $nikonNCTG->parse($atom_data);
1684                      break;
1685                  case 'NCHD': // Nikon:MakerNoteVersion  - https://exiftool.org/TagNames/Nikon.html
1686                      $makerNoteVersion = '';
1687                      for ($i = 0, $iMax = strlen($atom_data); $i < $iMax; ++$i) {
1688                          if (ord($atom_data[$i]) <= 0x1F) {
1689                              $makerNoteVersion .= ' '.ord($atom_data[$i]);
1690                          } else {
1691                              $makerNoteVersion .= $atom_data[$i];
1692                          }
1693                      }
1694                      $makerNoteVersion = rtrim($makerNoteVersion, "\x00");
1695                      $atom_structure['data'] = array(
1696                          'MakerNoteVersion' => $makerNoteVersion
1697                      );
1698                      break;
1699                  case 'NCDB': // Nikon                   - https://exiftool.org/TagNames/Nikon.html
1700                  case 'CNCV': // Canon:CompressorVersion - https://exiftool.org/TagNames/Canon.html
1701                      $atom_structure['data'] = $atom_data;
1702                      break;
1703  
1704                  case "\x00\x00\x00\x00":
1705                      // some kind of metacontainer, may contain a big data dump such as:
1706                      // mdta keys \005 mdtacom.apple.quicktime.make (mdtacom.apple.quicktime.creationdate ,mdtacom.apple.quicktime.location.ISO6709 $mdtacom.apple.quicktime.software !mdtacom.apple.quicktime.model ilst \01D \001 \015data \001DE\010Apple 0 \002 (data \001DE\0102011-05-11T17:54:04+0200 2 \003 *data \001DE\010+52.4936+013.3897+040.247/ \01D \004 \015data \001DE\0104.3.1 \005 \018data \001DE\010iPhone 4
1707                      // https://xhelmboyx.tripod.com/formats/qti-layout.txt
1708  
1709                      $atom_structure['version']   =          getid3_lib::BigEndian2Int(substr($atom_data, 0, 1));
1710                      $atom_structure['flags_raw'] =          getid3_lib::BigEndian2Int(substr($atom_data, 1, 3));
1711                      $atom_structure['subatoms']  = $this->QuicktimeParseContainerAtom(substr($atom_data, 4), $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
1712                      //$atom_structure['subatoms']  = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
1713                      break;
1714  
1715                  case 'meta': // METAdata atom
1716                      // https://developer.apple.com/library/mac/documentation/QuickTime/QTFF/Metadata/Metadata.html
1717  
1718                      $atom_structure['version']   =          getid3_lib::BigEndian2Int(substr($atom_data, 0, 1));
1719                      $atom_structure['flags_raw'] =          getid3_lib::BigEndian2Int(substr($atom_data, 1, 3));
1720                      $atom_structure['subatoms']  = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 8, $atomHierarchy, $ParseAllPossibleAtoms);
1721                      break;
1722  
1723                  case 'data': // metaDATA atom
1724                      static $metaDATAkey = 1; // real ugly, but so is the QuickTime structure that stores keys and values in different multinested locations that are hard to relate to each other
1725                      // seems to be 2 bytes language code (ASCII), 2 bytes unknown (set to 0x10B5 in sample I have), remainder is useful data
1726                      $atom_structure['language'] =                           substr($atom_data, 4 + 0, 2);
1727                      $atom_structure['unknown']  = getid3_lib::BigEndian2Int(substr($atom_data, 4 + 2, 2));
1728                      $atom_structure['data']     =                           substr($atom_data, 4 + 4);
1729                      $atom_structure['key_name'] = (isset($info['quicktime']['temp_meta_key_names'][$metaDATAkey]) ? $info['quicktime']['temp_meta_key_names'][$metaDATAkey] : '');
1730                      $metaDATAkey++;
1731  
1732                      if ($atom_structure['key_name'] && $atom_structure['data']) {
1733                          @$info['quicktime']['comments'][str_replace('com.apple.quicktime.', '', $atom_structure['key_name'])][] = $atom_structure['data'];
1734                      }
1735                      break;
1736  
1737                  case 'keys': // KEYS that may be present in the metadata atom.
1738                      // https://developer.apple.com/library/mac/documentation/QuickTime/QTFF/Metadata/Metadata.html#//apple_ref/doc/uid/TP40000939-CH1-SW21
1739                      // The metadata item keys atom holds a list of the metadata keys that may be present in the metadata atom.
1740                      // This list is indexed starting with 1; 0 is a reserved index value. The metadata item keys atom is a full atom with an atom type of "keys".
1741                      $atom_structure['version']       = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1));
1742                      $atom_structure['flags_raw']     = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3));
1743                      $atom_structure['entry_count']   = getid3_lib::BigEndian2Int(substr($atom_data,  4, 4));
1744                      $keys_atom_offset = 8;
1745                      for ($i = 1; $i <= $atom_structure['entry_count']; $i++) {
1746                          $atom_structure['keys'][$i]['key_size']      = getid3_lib::BigEndian2Int(substr($atom_data, $keys_atom_offset + 0, 4));
1747                          $atom_structure['keys'][$i]['key_namespace'] =                           substr($atom_data, $keys_atom_offset + 4, 4);
1748                          $atom_structure['keys'][$i]['key_value']     =                           substr($atom_data, $keys_atom_offset + 8, $atom_structure['keys'][$i]['key_size'] - 8);
1749                          $keys_atom_offset += $atom_structure['keys'][$i]['key_size']; // key_size includes the 4+4 bytes for key_size and key_namespace
1750  
1751                          $info['quicktime']['temp_meta_key_names'][$i] = $atom_structure['keys'][$i]['key_value'];
1752                      }
1753                      break;
1754  
1755                  case 'uuid': // user-defined atom often seen containing XML data, also used for potentially many other purposes, only a few specifically handled by getID3 (e.g. 360fly spatial data)
1756                      //Get the UUID ID in first 16 bytes
1757                      $uuid_bytes_read = unpack('H8time_low/H4time_mid/H4time_hi/H4clock_seq_hi/H12clock_seq_low', substr($atom_data, 0, 16));
1758                      $atom_structure['uuid_field_id'] = implode('-', $uuid_bytes_read);
1759  
1760                      switch ($atom_structure['uuid_field_id']) {   // http://fileformats.archiveteam.org/wiki/Boxes/atoms_format#UUID_boxes
1761  
1762                          case '0537cdab-9d0c-4431-a72a-fa561f2a113e': // Exif                                       - http://fileformats.archiveteam.org/wiki/Exif
1763                          case '2c4c0100-8504-40b9-a03e-562148d6dfeb': // Photoshop Image Resources                  - http://fileformats.archiveteam.org/wiki/Photoshop_Image_Resources
1764                          case '33c7a4d2-b81d-4723-a0ba-f1a3e097ad38': // IPTC-IIM                                   - http://fileformats.archiveteam.org/wiki/IPTC-IIM
1765                          case '8974dbce-7be7-4c51-84f9-7148f9882554': // PIFF Track Encryption Box                  - http://fileformats.archiveteam.org/wiki/Protected_Interoperable_File_Format
1766                          case '96a9f1f1-dc98-402d-a7ae-d68e34451809': // GeoJP2 World File Box                      - http://fileformats.archiveteam.org/wiki/GeoJP2
1767                          case 'a2394f52-5a9b-4f14-a244-6c427c648df4': // PIFF Sample Encryption Box                 - http://fileformats.archiveteam.org/wiki/Protected_Interoperable_File_Format
1768                          case 'b14bf8bd-083d-4b43-a5ae-8cd7d5a6ce03': // GeoJP2 GeoTIFF Box                         - http://fileformats.archiveteam.org/wiki/GeoJP2
1769                          case 'd08a4f18-10f3-4a82-b6c8-32d8aba183d3': // PIFF Protection System Specific Header Box - http://fileformats.archiveteam.org/wiki/Protected_Interoperable_File_Format
1770                              $this->warning('Unhandled (but recognized) "uuid" atom identified by "'.$atom_structure['uuid_field_id'].'" at offset '.$atom_structure['offset'].' ('.strlen($atom_data).' bytes)');
1771                              break;
1772  
1773                          case 'be7acfcb-97a9-42e8-9c71-999491e3afac': // XMP data (in XML format)
1774                              $atom_structure['xml'] = substr($atom_data, 16, strlen($atom_data) - 16 - 8); // 16 bytes for UUID, 8 bytes header(?)
1775                              break;
1776  
1777                          case 'efe1589a-bb77-49ef-8095-27759eb1dc6f': // 360fly data
1778                              /* 360fly code in this block by Paul Lewis 2019-Oct-31 */
1779                              /*    Sensor Timestamps need to be calculated using the recordings base time at ['quicktime']['moov']['subatoms'][0]['creation_time_unix']. */
1780                              $atom_structure['title'] = '360Fly Sensor Data';
1781  
1782                              //Get the UUID HEADER data
1783                              $uuid_bytes_read = unpack('vheader_size/vheader_version/vtimescale/vhardware_version/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/x/', substr($atom_data, 16, 32));
1784                              $atom_structure['uuid_header'] = $uuid_bytes_read;
1785  
1786                              $start_byte = 48;
1787                              $atom_SENSOR_data = substr($atom_data, $start_byte);
1788                              $atom_structure['sensor_data']['data_type'] = array(
1789                                      'fusion_count'   => 0,       // ID 250
1790                                      'fusion_data'    => array(),
1791                                      'accel_count'    => 0,       // ID 1
1792                                      'accel_data'     => array(),
1793                                      'gyro_count'     => 0,       // ID 2
1794                                      'gyro_data'      => array(),
1795                                      'magno_count'    => 0,       // ID 3
1796                                      'magno_data'     => array(),
1797                                      'gps_count'      => 0,       // ID 5
1798                                      'gps_data'       => array(),
1799                                      'rotation_count' => 0,       // ID 6
1800                                      'rotation_data'  => array(),
1801                                      'unknown_count'  => 0,       // ID ??
1802                                      'unknown_data'   => array(),
1803                                      'debug_list'     => '',      // Used to debug variables stored as comma delimited strings
1804                              );
1805                              $debug_structure = array();
1806                              $debug_structure['debug_items'] = array();
1807                              // Can start loop here to decode all sensor data in 32 Byte chunks:
1808                              foreach (str_split($atom_SENSOR_data, 32) as $sensor_key => $sensor_data) {
1809                                  // This gets me a data_type code to work out what data is in the next 31 bytes.
1810                                  $sensor_data_type = substr($sensor_data, 0, 1);
1811                                  $sensor_data_content = substr($sensor_data, 1);
1812                                  $uuid_bytes_read = unpack('C*', $sensor_data_type);
1813                                  $sensor_data_array = array();
1814                                  switch ($uuid_bytes_read[1]) {
1815                                      case 250:
1816                                          $atom_structure['sensor_data']['data_type']['fusion_count']++;
1817                                          $uuid_bytes_read = unpack('cmode/Jtimestamp/Gyaw/Gpitch/Groll/x*', $sensor_data_content);
1818                                          $sensor_data_array['mode']      = $uuid_bytes_read['mode'];
1819                                          $sensor_data_array['timestamp'] = $uuid_bytes_read['timestamp'];
1820                                          $sensor_data_array['yaw']       = $uuid_bytes_read['yaw'];
1821                                          $sensor_data_array['pitch']     = $uuid_bytes_read['pitch'];
1822                                          $sensor_data_array['roll']      = $uuid_bytes_read['roll'];
1823                                          array_push($atom_structure['sensor_data']['data_type']['fusion_data'], $sensor_data_array);
1824                                          break;
1825                                      case 1:
1826                                          $atom_structure['sensor_data']['data_type']['accel_count']++;
1827                                          $uuid_bytes_read = unpack('cmode/Jtimestamp/Gyaw/Gpitch/Groll/x*', $sensor_data_content);
1828                                          $sensor_data_array['mode']      = $uuid_bytes_read['mode'];
1829                                          $sensor_data_array['timestamp'] = $uuid_bytes_read['timestamp'];
1830                                          $sensor_data_array['yaw']       = $uuid_bytes_read['yaw'];
1831                                          $sensor_data_array['pitch']     = $uuid_bytes_read['pitch'];
1832                                          $sensor_data_array['roll']      = $uuid_bytes_read['roll'];
1833                                          array_push($atom_structure['sensor_data']['data_type']['accel_data'], $sensor_data_array);
1834                                          break;
1835                                      case 2:
1836                                          $atom_structure['sensor_data']['data_type']['gyro_count']++;
1837                                          $uuid_bytes_read = unpack('cmode/Jtimestamp/Gyaw/Gpitch/Groll/x*', $sensor_data_content);
1838                                          $sensor_data_array['mode']      = $uuid_bytes_read['mode'];
1839                                          $sensor_data_array['timestamp'] = $uuid_bytes_read['timestamp'];
1840                                          $sensor_data_array['yaw']       = $uuid_bytes_read['yaw'];
1841                                          $sensor_data_array['pitch']     = $uuid_bytes_read['pitch'];
1842                                          $sensor_data_array['roll']      = $uuid_bytes_read['roll'];
1843                                          array_push($atom_structure['sensor_data']['data_type']['gyro_data'], $sensor_data_array);
1844                                          break;
1845                                      case 3:
1846                                          $atom_structure['sensor_data']['data_type']['magno_count']++;
1847                                          $uuid_bytes_read = unpack('cmode/Jtimestamp/Gmagx/Gmagy/Gmagz/x*', $sensor_data_content);
1848                                          $sensor_data_array['mode']      = $uuid_bytes_read['mode'];
1849                                          $sensor_data_array['timestamp'] = $uuid_bytes_read['timestamp'];
1850                                          $sensor_data_array['magx']      = $uuid_bytes_read['magx'];
1851                                          $sensor_data_array['magy']      = $uuid_bytes_read['magy'];
1852                                          $sensor_data_array['magz']      = $uuid_bytes_read['magz'];
1853                                          array_push($atom_structure['sensor_data']['data_type']['magno_data'], $sensor_data_array);
1854                                          break;
1855                                      case 5:
1856                                          $atom_structure['sensor_data']['data_type']['gps_count']++;
1857                                          $uuid_bytes_read = unpack('cmode/Jtimestamp/Glat/Glon/Galt/Gspeed/nbearing/nacc/x*', $sensor_data_content);
1858                                          $sensor_data_array['mode']      = $uuid_bytes_read['mode'];
1859                                          $sensor_data_array['timestamp'] = $uuid_bytes_read['timestamp'];
1860                                          $sensor_data_array['lat']       = $uuid_bytes_read['lat'];
1861                                          $sensor_data_array['lon']       = $uuid_bytes_read['lon'];
1862                                          $sensor_data_array['alt']       = $uuid_bytes_read['alt'];
1863                                          $sensor_data_array['speed']     = $uuid_bytes_read['speed'];
1864                                          $sensor_data_array['bearing']   = $uuid_bytes_read['bearing'];
1865                                          $sensor_data_array['acc']       = $uuid_bytes_read['acc'];
1866                                          array_push($atom_structure['sensor_data']['data_type']['gps_data'], $sensor_data_array);
1867                                          //array_push($debug_structure['debug_items'], $uuid_bytes_read['timestamp']);
1868                                          break;
1869                                      case 6:
1870                                          $atom_structure['sensor_data']['data_type']['rotation_count']++;
1871                                          $uuid_bytes_read = unpack('cmode/Jtimestamp/Grotx/Groty/Grotz/x*', $sensor_data_content);
1872                                          $sensor_data_array['mode']      = $uuid_bytes_read['mode'];
1873                                          $sensor_data_array['timestamp'] = $uuid_bytes_read['timestamp'];
1874                                          $sensor_data_array['rotx']      = $uuid_bytes_read['rotx'];
1875                                          $sensor_data_array['roty']      = $uuid_bytes_read['roty'];
1876                                          $sensor_data_array['rotz']      = $uuid_bytes_read['rotz'];
1877                                          array_push($atom_structure['sensor_data']['data_type']['rotation_data'], $sensor_data_array);
1878                                          break;
1879                                      default:
1880                                          $atom_structure['sensor_data']['data_type']['unknown_count']++;
1881                                          break;
1882                                  }
1883                              }
1884                              //if (isset($debug_structure['debug_items']) && count($debug_structure['debug_items']) > 0) {
1885                              //    $atom_structure['sensor_data']['data_type']['debug_list'] = implode(',', $debug_structure['debug_items']);
1886                              //} else {
1887                                  $atom_structure['sensor_data']['data_type']['debug_list'] = 'No debug items in list!';
1888                              //}
1889                              break;
1890  
1891                          default:
1892                              $this->warning('Unhandled "uuid" atom identified by "'.$atom_structure['uuid_field_id'].'" at offset '.$atom_structure['offset'].' ('.strlen($atom_data).' bytes)');
1893                      }
1894                      break;
1895  
1896                  case 'gps ':
1897                      // https://dashcamtalk.com/forum/threads/script-to-extract-gps-data-from-novatek-mp4.20808/page-2#post-291730
1898                      // The 'gps ' contains simple look up table made up of 8byte rows, that point to the 'free' atoms that contains the actual GPS data.
1899                      // The first row is version/metadata/notsure, I skip that.
1900                      // The following rows consist of 4byte address (absolute) and 4byte size (0x1000), these point to the GPS data in the file.
1901  
1902                      $GPS_rowsize = 8; // 4 bytes for offset, 4 bytes for size
1903                      if (strlen($atom_data) > 0) {
1904                          if ((strlen($atom_data) % $GPS_rowsize) == 0) {
1905                              $atom_structure['gps_toc'] = array();
1906                              foreach (str_split($atom_data, $GPS_rowsize) as $counter => $datapair) {
1907                                  $atom_structure['gps_toc'][] = unpack('Noffset/Nsize', substr($atom_data, $counter * $GPS_rowsize, $GPS_rowsize));
1908                              }
1909  
1910                              $atom_structure['gps_entries'] = array();
1911                              $previous_offset = $this->ftell();
1912                              foreach ($atom_structure['gps_toc'] as $key => $gps_pointer) {
1913                                  if ($key == 0) {
1914                                      // "The first row is version/metadata/notsure, I skip that."
1915                                      continue;
1916                                  }
1917                                  $this->fseek($gps_pointer['offset']);
1918                                  $GPS_free_data = $this->fread($gps_pointer['size']);
1919  
1920                                  /*
1921                                  // 2017-05-10: I see some of the data, notably the Hour-Minute-Second, but cannot reconcile the rest of the data. However, the NMEA "GPRMC" line is there and relatively easy to parse, so I'm using that instead
1922  
1923                                  // https://dashcamtalk.com/forum/threads/script-to-extract-gps-data-from-novatek-mp4.20808/page-2#post-291730
1924                                  // The structure of the GPS data atom (the 'free' atoms mentioned above) is following:
1925                                  // hour,minute,second,year,month,day,active,latitude_b,longitude_b,unknown2,latitude,longitude,speed = struct.unpack_from('<IIIIIIssssfff',data, 48)
1926                                  // For those unfamiliar with python struct:
1927                                  // I = int
1928                                  // s = is string (size 1, in this case)
1929                                  // f = float
1930  
1931                                  //$atom_structure['gps_entries'][$key] = unpack('Vhour/Vminute/Vsecond/Vyear/Vmonth/Vday/Vactive/Vlatitude_b/Vlongitude_b/Vunknown2/flatitude/flongitude/fspeed', substr($GPS_free_data, 48));
1932                                  */
1933  
1934                                  // $GPRMC,081836,A,3751.65,S,14507.36,E,000.0,360.0,130998,011.3,E*62
1935                                  // $GPRMC,183731,A,3907.482,N,12102.436,W,000.0,360.0,080301,015.5,E*67
1936                                  // $GPRMC,002454,A,3553.5295,N,13938.6570,E,0.0,43.1,180700,7.1,W,A*3F
1937                                  // $GPRMC,094347.000,A,5342.0061,N,00737.9908,W,0.01,156.75,140217,,,A*7D
1938                                  if (preg_match('#\\$GPRMC,([0-9\\.]*),([AV]),([0-9\\.]*),([NS]),([0-9\\.]*),([EW]),([0-9\\.]*),([0-9\\.]*),([0-9]*),([0-9\\.]*),([EW]?)(,[A])?(\\*[0-9A-F]{2})#', $GPS_free_data, $matches)) {
1939                                      $GPS_this_GPRMC = array();
1940                                      $GPS_this_GPRMC_raw = array();
1941                                      list(
1942                                          $GPS_this_GPRMC_raw['gprmc'],
1943                                          $GPS_this_GPRMC_raw['timestamp'],
1944                                          $GPS_this_GPRMC_raw['status'],
1945                                          $GPS_this_GPRMC_raw['latitude'],
1946                                          $GPS_this_GPRMC_raw['latitude_direction'],
1947                                          $GPS_this_GPRMC_raw['longitude'],
1948                                          $GPS_this_GPRMC_raw['longitude_direction'],
1949                                          $GPS_this_GPRMC_raw['knots'],
1950                                          $GPS_this_GPRMC_raw['angle'],
1951                                          $GPS_this_GPRMC_raw['datestamp'],
1952                                          $GPS_this_GPRMC_raw['variation'],
1953                                          $GPS_this_GPRMC_raw['variation_direction'],
1954                                          $dummy,
1955                                          $GPS_this_GPRMC_raw['checksum'],
1956                                      ) = $matches;
1957                                      $GPS_this_GPRMC['raw'] = $GPS_this_GPRMC_raw;
1958  
1959                                      $hour   = substr($GPS_this_GPRMC['raw']['timestamp'], 0, 2);
1960                                      $minute = substr($GPS_this_GPRMC['raw']['timestamp'], 2, 2);
1961                                      $second = substr($GPS_this_GPRMC['raw']['timestamp'], 4, 2);
1962                                      $ms     = substr($GPS_this_GPRMC['raw']['timestamp'], 6);    // may contain decimal seconds
1963                                      $day    = substr($GPS_this_GPRMC['raw']['datestamp'], 0, 2);
1964                                      $month  = substr($GPS_this_GPRMC['raw']['datestamp'], 2, 2);
1965                                      $year   = (int) substr($GPS_this_GPRMC['raw']['datestamp'], 4, 2);
1966                                      $year += (($year > 90) ? 1900 : 2000); // complete lack of foresight: datestamps are stored with 2-digit years, take best guess
1967                                      $GPS_this_GPRMC['timestamp'] = $year.'-'.$month.'-'.$day.' '.$hour.':'.$minute.':'.$second.$ms;
1968  
1969                                      $GPS_this_GPRMC['active'] = ($GPS_this_GPRMC['raw']['status'] == 'A'); // A=Active,V=Void
1970  
1971                                      foreach (array('latitude','longitude') as $latlon) {
1972                                          preg_match('#^([0-9]{1,3})([0-9]{2}\\.[0-9]+)$#', $GPS_this_GPRMC['raw'][$latlon], $matches);
1973                                          list($dummy, $deg, $min) = $matches;
1974                                          $GPS_this_GPRMC[$latlon] = $deg + ($min / 60);
1975                                      }
1976                                      $GPS_this_GPRMC['latitude']  *= (($GPS_this_GPRMC['raw']['latitude_direction']  == 'S') ? -1 : 1);
1977                                      $GPS_this_GPRMC['longitude'] *= (($GPS_this_GPRMC['raw']['longitude_direction'] == 'W') ? -1 : 1);
1978  
1979                                      $GPS_this_GPRMC['heading']    = $GPS_this_GPRMC['raw']['angle'];
1980                                      $GPS_this_GPRMC['speed_knot'] = $GPS_this_GPRMC['raw']['knots'];
1981                                      $GPS_this_GPRMC['speed_kmh']  = $GPS_this_GPRMC['raw']['knots'] * 1.852;
1982                                      if ($GPS_this_GPRMC['raw']['variation']) {
1983                                          $GPS_this_GPRMC['variation']  = $GPS_this_GPRMC['raw']['variation'];
1984                                          $GPS_this_GPRMC['variation'] *= (($GPS_this_GPRMC['raw']['variation_direction'] == 'W') ? -1 : 1);
1985                                      }
1986  
1987                                      $atom_structure['gps_entries'][$key] = $GPS_this_GPRMC;
1988  
1989                                      @$info['quicktime']['gps_track'][$GPS_this_GPRMC['timestamp']] = array(
1990                                          'latitude'  => (float) $GPS_this_GPRMC['latitude'],
1991                                          'longitude' => (float) $GPS_this_GPRMC['longitude'],
1992                                          'speed_kmh' => (float) $GPS_this_GPRMC['speed_kmh'],
1993                                          'heading'   => (float) $GPS_this_GPRMC['heading'],
1994                                      );
1995  
1996                                  } else {
1997                                      $this->warning('Unhandled GPS format in "free" atom at offset '.$gps_pointer['offset']);
1998                                  }
1999                              }
2000                              $this->fseek($previous_offset);
2001  
2002                          } else {
2003                              $this->warning('QuickTime atom "'.$atomname.'" is not mod-8 bytes long ('.$atomsize.' bytes) at offset '.$baseoffset);
2004                          }
2005                      } else {
2006                          $this->warning('QuickTime atom "'.$atomname.'" is zero bytes long at offset '.$baseoffset);
2007                      }
2008                      break;
2009  
2010                  case 'loci':// 3GP location (El Loco)
2011                      $loffset = 0;
2012                      $info['quicktime']['comments']['gps_flags']     = array(  getid3_lib::BigEndian2Int(substr($atom_data, 0, 4)));
2013                      $info['quicktime']['comments']['gps_lang']      = array(  getid3_lib::BigEndian2Int(substr($atom_data, 4, 2)));
2014                      $info['quicktime']['comments']['gps_location']  = array(          $this->LociString(substr($atom_data, 6), $loffset));
2015                      $loci_data = substr($atom_data, 6 + $loffset);
2016                      $info['quicktime']['comments']['gps_role']      = array(  getid3_lib::BigEndian2Int(substr($loci_data, 0, 1)));
2017                      $info['quicktime']['comments']['gps_longitude'] = array(getid3_lib::FixedPoint16_16(substr($loci_data, 1, 4)));
2018                      $info['quicktime']['comments']['gps_latitude']  = array(getid3_lib::FixedPoint16_16(substr($loci_data, 5, 4)));
2019                      $info['quicktime']['comments']['gps_altitude']  = array(getid3_lib::FixedPoint16_16(substr($loci_data, 9, 4)));
2020                      $info['quicktime']['comments']['gps_body']      = array(          $this->LociString(substr($loci_data, 13           ), $loffset));
2021                      $info['quicktime']['comments']['gps_notes']     = array(          $this->LociString(substr($loci_data, 13 + $loffset), $loffset));
2022                      break;
2023  
2024                  case 'chpl': // CHaPter List
2025                      // https://www.adobe.com/content/dam/Adobe/en/devnet/flv/pdfs/video_file_format_spec_v10.pdf
2026                      $chpl_version = getid3_lib::BigEndian2Int(substr($atom_data, 4, 1)); // Expected to be 0
2027                      $chpl_flags   = getid3_lib::BigEndian2Int(substr($atom_data, 5, 3)); // Reserved, set to 0
2028                      $chpl_count   = getid3_lib::BigEndian2Int(substr($atom_data, 8, 1));
2029                      $chpl_offset = 9;
2030                      for ($i = 0; $i < $chpl_count; $i++) {
2031                          if (($chpl_offset + 9) >= strlen($atom_data)) {
2032                              $this->warning('QuickTime chapter '.$i.' extends beyond end of "chpl" atom');
2033                              break;
2034                          }
2035                          $info['quicktime']['chapters'][$i]['timestamp'] = getid3_lib::BigEndian2Int(substr($atom_data, $chpl_offset, 8)) / 10000000; // timestamps are stored as 100-nanosecond units
2036                          $chpl_offset += 8;
2037                          $chpl_title_size = getid3_lib::BigEndian2Int(substr($atom_data, $chpl_offset, 1));
2038                          $chpl_offset += 1;
2039                          $info['quicktime']['chapters'][$i]['title']     =                           substr($atom_data, $chpl_offset, $chpl_title_size);
2040                          $chpl_offset += $chpl_title_size;
2041                      }
2042                      break;
2043  
2044                  case 'FIRM': // FIRMware version(?), seen on GoPro Hero4
2045                      $info['quicktime']['camera']['firmware'] = $atom_data;
2046                      break;
2047  
2048                  case 'CAME': // FIRMware version(?), seen on GoPro Hero4
2049                      $info['quicktime']['camera']['serial_hash'] = unpack('H*', $atom_data);
2050                      break;
2051  
2052                  case 'dscp':
2053                  case 'rcif':
2054                      // https://www.getid3.org/phpBB3/viewtopic.php?t=1908
2055                      if (substr($atom_data, 0, 7) == "\x00\x00\x00\x00\x55\xC4".'{') {
2056                          if ($json_decoded = @json_decode(rtrim(substr($atom_data, 6), "\x00"), true)) {
2057                              $info['quicktime']['camera'][$atomname] = $json_decoded;
2058                              if (($atomname == 'rcif') && isset($info['quicktime']['camera']['rcif']['wxcamera']['rotate'])) {
2059                                  $info['video']['rotate'] = $info['quicktime']['video']['rotate'] = $info['quicktime']['camera']['rcif']['wxcamera']['rotate'];
2060                              }
2061                          } else {
2062                              $this->warning('Failed to JSON decode atom "'.$atomname.'"');
2063                              $atom_structure['data'] = $atom_data;
2064                          }
2065                          unset($json_decoded);
2066                      } else {
2067                          $this->warning('Expecting 55 C4 7B at start of atom "'.$atomname.'", found '.getid3_lib::PrintHexBytes(substr($atom_data, 4, 3)).' instead');
2068                          $atom_structure['data'] = $atom_data;
2069                      }
2070                      break;
2071  
2072                  case 'frea':
2073                      // https://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Kodak.html#frea
2074                      // may contain "scra" (PreviewImage) and/or "thma" (ThumbnailImage)
2075                      $atom_structure['subatoms'] = $this->QuicktimeParseContainerAtom($atom_data, $baseoffset + 4, $atomHierarchy, $ParseAllPossibleAtoms);
2076                      break;
2077                  case 'tima': // subatom to "frea"
2078                      // no idea what this does, the one sample file I've seen has a value of 0x00000027
2079                      $atom_structure['data'] = $atom_data;
2080                      break;
2081                  case 'ver ': // subatom to "frea"
2082                      // some kind of version number, the one sample file I've seen has a value of "3.00.073"
2083                      $atom_structure['data'] = $atom_data;
2084                      break;
2085                  case 'thma': // subatom to "frea" -- "ThumbnailImage"
2086                      // https://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Kodak.html#frea
2087                      if (strlen($atom_data) > 0) {
2088                          $info['quicktime']['comments']['picture'][] = array('data'=>$atom_data, 'image_mime'=>'image/jpeg', 'description'=>'ThumbnailImage');
2089                      }
2090                      break;
2091                  case 'scra': // subatom to "frea" -- "PreviewImage"
2092                      // https://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Kodak.html#frea
2093                      // but the only sample file I've seen has no useful data here
2094                      if (strlen($atom_data) > 0) {
2095                          $info['quicktime']['comments']['picture'][] = array('data'=>$atom_data, 'image_mime'=>'image/jpeg', 'description'=>'PreviewImage');
2096                      }
2097                      break;
2098  
2099                  case 'cdsc': // timed metadata reference
2100                      // A QuickTime movie can contain none, one, or several timed metadata tracks. Timed metadata tracks can refer to multiple tracks.
2101                      // Metadata tracks are linked to the tracks they describe using a track-reference of type 'cdsc'. The metadata track holds the 'cdsc' track reference.
2102                      $atom_structure['track_number'] = getid3_lib::BigEndian2Int($atom_data);
2103                      break;
2104  
2105  
2106                  case 'esds': // Elementary Stream DeScriptor
2107                      // https://github.com/JamesHeinrich/getID3/issues/414
2108                      // https://chromium.googlesource.com/chromium/src/media/+/refs/heads/main/formats/mp4/es_descriptor.cc
2109                      // https://chromium.googlesource.com/chromium/src/media/+/refs/heads/main/formats/mp4/es_descriptor.h
2110                      $atom_structure['version']   = getid3_lib::BigEndian2Int(substr($atom_data,  0, 1)); // hardcoded: 0x00
2111                      $atom_structure['flags_raw'] = getid3_lib::BigEndian2Int(substr($atom_data,  1, 3)); // hardcoded: 0x000000
2112                      $esds_offset = 4;
2113  
2114                      $atom_structure['ES_DescrTag'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 1));
2115                      $esds_offset += 1;
2116                      if ($atom_structure['ES_DescrTag'] != 0x03) {
2117                          $this->warning('expecting esds.ES_DescrTag = 0x03, found 0x'.getid3_lib::PrintHexBytes($atom_structure['ES_DescrTag']).'), at offset '.$atom_structure['offset']);
2118                          break;
2119                      }
2120                      $atom_structure['ES_DescrSize'] = $this->quicktime_read_mp4_descr_length($atom_data, $esds_offset);
2121  
2122                      $atom_structure['ES_ID'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 2));
2123                      $esds_offset += 2;
2124                      $atom_structure['ES_flagsraw'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 1));
2125                      $esds_offset += 1;
2126                      $atom_structure['ES_flags']['stream_dependency'] = (bool) ($atom_structure['ES_flagsraw'] & 0x80);
2127                      $atom_structure['ES_flags']['url_flag']          = (bool) ($atom_structure['ES_flagsraw'] & 0x40);
2128                      $atom_structure['ES_flags']['ocr_stream']        = (bool) ($atom_structure['ES_flagsraw'] & 0x20);
2129                      $atom_structure['ES_stream_priority']            =        ($atom_structure['ES_flagsraw'] & 0x1F);
2130                      if ($atom_structure['ES_flags']['url_flag']) {
2131                          $this->warning('Unsupported esds.url_flag enabled at offset '.$atom_structure['offset']);
2132                          break;
2133                      }
2134                      if ($atom_structure['ES_flags']['stream_dependency']) {
2135                          $atom_structure['ES_dependsOn_ES_ID'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 2));
2136                          $esds_offset += 2;
2137                      }
2138                      if ($atom_structure['ES_flags']['ocr_stream']) {
2139                          $atom_structure['ES_OCR_ES_Id'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 2));
2140                          $esds_offset += 2;
2141                      }
2142  
2143                      $atom_structure['ES_DecoderConfigDescrTag'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 1));
2144                      $esds_offset += 1;
2145                      if ($atom_structure['ES_DecoderConfigDescrTag'] != 0x04) {
2146                          $this->warning('expecting esds.ES_DecoderConfigDescrTag = 0x04, found 0x'.getid3_lib::PrintHexBytes($atom_structure['ES_DecoderConfigDescrTag']).'), at offset '.$atom_structure['offset']);
2147                          break;
2148                      }
2149                      $atom_structure['ES_DecoderConfigDescrTagSize'] = $this->quicktime_read_mp4_descr_length($atom_data, $esds_offset);
2150  
2151                      $atom_structure['ES_objectTypeIndication'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 1));
2152                      $esds_offset += 1;
2153                      // https://stackoverflow.com/questions/3987850
2154                      // 0x40 = "Audio ISO/IEC 14496-3"                       = MPEG-4 Audio
2155                      // 0x67 = "Audio ISO/IEC 13818-7 LowComplexity Profile" = MPEG-2 AAC LC
2156                      // 0x69 = "Audio ISO/IEC 13818-3"                       = MPEG-2 Backward Compatible Audio (MPEG-2 Layers 1, 2, and 3)
2157                      // 0x6B = "Audio ISO/IEC 11172-3"                       = MPEG-1 Audio (MPEG-1 Layers 1, 2, and 3)
2158  
2159                      $streamTypePlusFlags = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 1));
2160                      $esds_offset += 1;
2161                      $atom_structure['ES_streamType'] =        ($streamTypePlusFlags & 0xFC) >> 2;
2162                      $atom_structure['ES_upStream']   = (bool) ($streamTypePlusFlags & 0x02) >> 1;
2163                      $atom_structure['ES_bufferSizeDB'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 3));
2164                      $esds_offset += 3;
2165                      $atom_structure['ES_maxBitrate'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 4));
2166                      $esds_offset += 4;
2167                      $atom_structure['ES_avgBitrate'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 4));
2168                      $esds_offset += 4;
2169                      if ($atom_structure['ES_avgBitrate']) {
2170                          $info['quicktime']['audio']['bitrate'] = $atom_structure['ES_avgBitrate'];
2171                          $info['audio']['bitrate']              = $atom_structure['ES_avgBitrate'];
2172                      }
2173  
2174                      $atom_structure['ES_DecSpecificInfoTag'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 1));
2175                      $esds_offset += 1;
2176                      if ($atom_structure['ES_DecSpecificInfoTag'] != 0x05) {
2177                          $this->warning('expecting esds.ES_DecSpecificInfoTag = 0x05, found 0x'.getid3_lib::PrintHexBytes($atom_structure['ES_DecSpecificInfoTag']).'), at offset '.$atom_structure['offset']);
2178                          break;
2179                      }
2180                      $atom_structure['ES_DecSpecificInfoTagSize'] = $this->quicktime_read_mp4_descr_length($atom_data, $esds_offset);
2181  
2182                      $atom_structure['ES_DecSpecificInfo'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, $atom_structure['ES_DecSpecificInfoTagSize']));
2183                      $esds_offset += $atom_structure['ES_DecSpecificInfoTagSize'];
2184  
2185                      $atom_structure['ES_SLConfigDescrTag'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, 1));
2186                      $esds_offset += 1;
2187                      if ($atom_structure['ES_SLConfigDescrTag'] != 0x06) {
2188                          $this->warning('expecting esds.ES_SLConfigDescrTag = 0x05, found 0x'.getid3_lib::PrintHexBytes($atom_structure['ES_SLConfigDescrTag']).'), at offset '.$atom_structure['offset']);
2189                          break;
2190                      }
2191                      $atom_structure['ES_SLConfigDescrTagSize'] = $this->quicktime_read_mp4_descr_length($atom_data, $esds_offset);
2192  
2193                      $atom_structure['ES_SLConfigDescr'] = getid3_lib::BigEndian2Int(substr($atom_data, $esds_offset, $atom_structure['ES_SLConfigDescrTagSize']));
2194                      $esds_offset += $atom_structure['ES_SLConfigDescrTagSize'];
2195                      break;
2196  
2197  // AVIF-related - https://docs.rs/avif-parse/0.13.2/src/avif_parse/boxes.rs.html
2198                  case 'pitm': // Primary ITeM
2199                  case 'iloc': // Item LOCation
2200                  case 'iinf': // Item INFo
2201                  case 'iref': // Image REFerence
2202                  case 'iprp': // Image PRoPerties
2203  $this->error('AVIF files not currently supported');
2204                      $atom_structure['data'] = $atom_data;
2205                      break;
2206  
2207                  case 'tfdt': // Track Fragment base media Decode Time box
2208                  case 'tfhd': // Track Fragment HeaDer box
2209                  case 'mfhd': // Movie Fragment HeaDer box
2210                  case 'trun': // Track fragment RUN box
2211  $this->error('fragmented mp4 files not currently supported');
2212                      $atom_structure['data'] = $atom_data;
2213                      break;
2214  
2215                  case 'mvex': // MoVie EXtends box
2216                  case 'pssh': // Protection System Specific Header box
2217                  case 'sidx': // Segment InDeX box
2218                  default:
2219                      $this->warning('Unknown QuickTime atom type: "'.preg_replace('#[^a-zA-Z0-9 _\\-]#', '?', $atomname).'" ('.trim(getid3_lib::PrintHexBytes($atomname)).'), '.$atomsize.' bytes at offset '.$baseoffset);
2220                      $atom_structure['data'] = $atom_data;
2221                      break;
2222              }
2223          }
2224          array_pop($atomHierarchy);
2225          return $atom_structure;
2226      }
2227  
2228      /**
2229       * @param string $atom_data
2230       * @param int    $baseoffset
2231       * @param array  $atomHierarchy
2232       * @param bool   $ParseAllPossibleAtoms
2233       *
2234       * @return array|false
2235       */
2236  	public function QuicktimeParseContainerAtom($atom_data, $baseoffset, &$atomHierarchy, $ParseAllPossibleAtoms) {
2237          $atom_structure = array();
2238          $subatomoffset  = 0;
2239          $subatomcounter = 0;
2240          if ((strlen($atom_data) == 4) && (getid3_lib::BigEndian2Int($atom_data) == 0x00000000)) {
2241              return false;
2242          }
2243          while ($subatomoffset < strlen($atom_data)) {
2244              $subatomsize = getid3_lib::BigEndian2Int(substr($atom_data, $subatomoffset + 0, 4));
2245              $subatomname =                           substr($atom_data, $subatomoffset + 4, 4);
2246              $subatomdata =                           substr($atom_data, $subatomoffset + 8, $subatomsize - 8);
2247              if ($subatomsize == 0) {
2248                  // Furthermore, for historical reasons the list of atoms is optionally
2249                  // terminated by a 32-bit integer set to 0. If you are writing a program
2250                  // to read user data atoms, you should allow for the terminating 0.
2251                  if (strlen($atom_data) > 12) {
2252                      $subatomoffset += 4;
2253                      continue;
2254                  }
2255                  break;
2256              }
2257              if (strlen($subatomdata) < ($subatomsize - 8)) {
2258                  // we don't have enough data to decode the subatom.
2259                  // this may be because we are refusing to parse large subatoms, or it may be because this atom had its size set too large
2260                  // so we passed in the start of a following atom incorrectly?
2261                  break;
2262              }
2263              $atom_structure[$subatomcounter++] = $this->QuicktimeParseAtom($subatomname, $subatomsize, $subatomdata, $baseoffset + $subatomoffset, $atomHierarchy, $ParseAllPossibleAtoms);
2264              $subatomoffset += $subatomsize;
2265          }
2266  
2267          if (empty($atom_structure)) {
2268              return false;
2269          }
2270  
2271          return $atom_structure;
2272      }
2273  
2274      /**
2275       * @param string $data
2276       * @param int    $offset
2277       *
2278       * @return int
2279       */
2280  	public function quicktime_read_mp4_descr_length($data, &$offset) {
2281          // http://libquicktime.sourcearchive.com/documentation/2:1.0.2plus-pdebian-2build1/esds_8c-source.html
2282          $num_bytes = 0;
2283          $length    = 0;
2284          do {
2285              $b = ord(substr($data, $offset++, 1));
2286              $length = ($length << 7) | ($b & 0x7F);
2287          } while (($b & 0x80) && ($num_bytes++ < 4));
2288          return $length;
2289      }
2290  
2291      /**
2292       * @param int $languageid
2293       *
2294       * @return string
2295       */
2296  	public function QuicktimeLanguageLookup($languageid) {
2297          // http://developer.apple.com/library/mac/#documentation/QuickTime/QTFF/QTFFChap4/qtff4.html#//apple_ref/doc/uid/TP40000939-CH206-34353
2298          static $QuicktimeLanguageLookup = array();
2299          if (empty($QuicktimeLanguageLookup)) {
2300              $QuicktimeLanguageLookup[0]     = 'English';
2301              $QuicktimeLanguageLookup[1]     = 'French';
2302              $QuicktimeLanguageLookup[2]     = 'German';
2303              $QuicktimeLanguageLookup[3]     = 'Italian';
2304              $QuicktimeLanguageLookup[4]     = 'Dutch';
2305              $QuicktimeLanguageLookup[5]     = 'Swedish';
2306              $QuicktimeLanguageLookup[6]     = 'Spanish';
2307              $QuicktimeLanguageLookup[7]     = 'Danish';
2308              $QuicktimeLanguageLookup[8]     = 'Portuguese';
2309              $QuicktimeLanguageLookup[9]     = 'Norwegian';
2310              $QuicktimeLanguageLookup[10]    = 'Hebrew';
2311              $QuicktimeLanguageLookup[11]    = 'Japanese';
2312              $QuicktimeLanguageLookup[12]    = 'Arabic';
2313              $QuicktimeLanguageLookup[13]    = 'Finnish';
2314              $QuicktimeLanguageLookup[14]    = 'Greek';
2315              $QuicktimeLanguageLookup[15]    = 'Icelandic';
2316              $QuicktimeLanguageLookup[16]    = 'Maltese';
2317              $QuicktimeLanguageLookup[17]    = 'Turkish';
2318              $QuicktimeLanguageLookup[18]    = 'Croatian';
2319              $QuicktimeLanguageLookup[19]    = 'Chinese (Traditional)';
2320              $QuicktimeLanguageLookup[20]    = 'Urdu';
2321              $QuicktimeLanguageLookup[21]    = 'Hindi';
2322              $QuicktimeLanguageLookup[22]    = 'Thai';
2323              $QuicktimeLanguageLookup[23]    = 'Korean';
2324              $QuicktimeLanguageLookup[24]    = 'Lithuanian';
2325              $QuicktimeLanguageLookup[25]    = 'Polish';
2326              $QuicktimeLanguageLookup[26]    = 'Hungarian';
2327              $QuicktimeLanguageLookup[27]    = 'Estonian';
2328              $QuicktimeLanguageLookup[28]    = 'Lettish';
2329              $QuicktimeLanguageLookup[28]    = 'Latvian';
2330              $QuicktimeLanguageLookup[29]    = 'Saamisk';
2331              $QuicktimeLanguageLookup[29]    = 'Lappish';
2332              $QuicktimeLanguageLookup[30]    = 'Faeroese';
2333              $QuicktimeLanguageLookup[31]    = 'Farsi';
2334              $QuicktimeLanguageLookup[31]    = 'Persian';
2335              $QuicktimeLanguageLookup[32]    = 'Russian';
2336              $QuicktimeLanguageLookup[33]    = 'Chinese (Simplified)';
2337              $QuicktimeLanguageLookup[34]    = 'Flemish';
2338              $QuicktimeLanguageLookup[35]    = 'Irish';
2339              $QuicktimeLanguageLookup[36]    = 'Albanian';
2340              $QuicktimeLanguageLookup[37]    = 'Romanian';
2341              $QuicktimeLanguageLookup[38]    = 'Czech';
2342              $QuicktimeLanguageLookup[39]    = 'Slovak';
2343              $QuicktimeLanguageLookup[40]    = 'Slovenian';
2344              $QuicktimeLanguageLookup[41]    = 'Yiddish';
2345              $QuicktimeLanguageLookup[42]    = 'Serbian';
2346              $QuicktimeLanguageLookup[43]    = 'Macedonian';
2347              $QuicktimeLanguageLookup[44]    = 'Bulgarian';
2348              $QuicktimeLanguageLookup[45]    = 'Ukrainian';
2349              $QuicktimeLanguageLookup[46]    = 'Byelorussian';
2350              $QuicktimeLanguageLookup[47]    = 'Uzbek';
2351              $QuicktimeLanguageLookup[48]    = 'Kazakh';
2352              $QuicktimeLanguageLookup[49]    = 'Azerbaijani';
2353              $QuicktimeLanguageLookup[50]    = 'AzerbaijanAr';
2354              $QuicktimeLanguageLookup[51]    = 'Armenian';
2355              $QuicktimeLanguageLookup[52]    = 'Georgian';
2356              $QuicktimeLanguageLookup[53]    = 'Moldavian';
2357              $QuicktimeLanguageLookup[54]    = 'Kirghiz';
2358              $QuicktimeLanguageLookup[55]    = 'Tajiki';
2359              $QuicktimeLanguageLookup[56]    = 'Turkmen';
2360              $QuicktimeLanguageLookup[57]    = 'Mongolian';
2361              $QuicktimeLanguageLookup[58]    = 'MongolianCyr';
2362              $QuicktimeLanguageLookup[59]    = 'Pashto';
2363              $QuicktimeLanguageLookup[60]    = 'Kurdish';
2364              $QuicktimeLanguageLookup[61]    = 'Kashmiri';
2365              $QuicktimeLanguageLookup[62]    = 'Sindhi';
2366              $QuicktimeLanguageLookup[63]    = 'Tibetan';
2367              $QuicktimeLanguageLookup[64]    = 'Nepali';
2368              $QuicktimeLanguageLookup[65]    = 'Sanskrit';
2369              $QuicktimeLanguageLookup[66]    = 'Marathi';
2370              $QuicktimeLanguageLookup[67]    = 'Bengali';
2371              $QuicktimeLanguageLookup[68]    = 'Assamese';
2372              $QuicktimeLanguageLookup[69]    = 'Gujarati';
2373              $QuicktimeLanguageLookup[70]    = 'Punjabi';
2374              $QuicktimeLanguageLookup[71]    = 'Oriya';
2375              $QuicktimeLanguageLookup[72]    = 'Malayalam';
2376              $QuicktimeLanguageLookup[73]    = 'Kannada';
2377              $QuicktimeLanguageLookup[74]    = 'Tamil';
2378              $QuicktimeLanguageLookup[75]    = 'Telugu';
2379              $QuicktimeLanguageLookup[76]    = 'Sinhalese';
2380              $QuicktimeLanguageLookup[77]    = 'Burmese';
2381              $QuicktimeLanguageLookup[78]    = 'Khmer';
2382              $QuicktimeLanguageLookup[79]    = 'Lao';
2383              $QuicktimeLanguageLookup[80]    = 'Vietnamese';
2384              $QuicktimeLanguageLookup[81]    = 'Indonesian';
2385              $QuicktimeLanguageLookup[82]    = 'Tagalog';
2386              $QuicktimeLanguageLookup[83]    = 'MalayRoman';
2387              $QuicktimeLanguageLookup[84]    = 'MalayArabic';
2388              $QuicktimeLanguageLookup[85]    = 'Amharic';
2389              $QuicktimeLanguageLookup[86]    = 'Tigrinya';
2390              $QuicktimeLanguageLookup[87]    = 'Galla';
2391              $QuicktimeLanguageLookup[87]    = 'Oromo';
2392              $QuicktimeLanguageLookup[88]    = 'Somali';
2393              $QuicktimeLanguageLookup[89]    = 'Swahili';
2394              $QuicktimeLanguageLookup[90]    = 'Ruanda';
2395              $QuicktimeLanguageLookup[91]    = 'Rundi';
2396              $QuicktimeLanguageLookup[92]    = 'Chewa';
2397              $QuicktimeLanguageLookup[93]    = 'Malagasy';
2398              $QuicktimeLanguageLookup[94]    = 'Esperanto';
2399              $QuicktimeLanguageLookup[128]   = 'Welsh';
2400              $QuicktimeLanguageLookup[129]   = 'Basque';
2401              $QuicktimeLanguageLookup[130]   = 'Catalan';
2402              $QuicktimeLanguageLookup[131]   = 'Latin';
2403              $QuicktimeLanguageLookup[132]   = 'Quechua';
2404              $QuicktimeLanguageLookup[133]   = 'Guarani';
2405              $QuicktimeLanguageLookup[134]   = 'Aymara';
2406              $QuicktimeLanguageLookup[135]   = 'Tatar';
2407              $QuicktimeLanguageLookup[136]   = 'Uighur';
2408              $QuicktimeLanguageLookup[137]   = 'Dzongkha';
2409              $QuicktimeLanguageLookup[138]   = 'JavaneseRom';
2410              $QuicktimeLanguageLookup[32767] = 'Unspecified';
2411          }
2412          if (($languageid > 138) && ($languageid < 32767)) {
2413              /*
2414              ISO Language Codes - http://www.loc.gov/standards/iso639-2/php/code_list.php
2415              Because the language codes specified by ISO 639-2/T are three characters long, they must be packed to fit into a 16-bit field.
2416              The packing algorithm must map each of the three characters, which are always lowercase, into a 5-bit integer and then concatenate
2417              these integers into the least significant 15 bits of a 16-bit integer, leaving the 16-bit integer's most significant bit set to zero.
2418  
2419              One algorithm for performing this packing is to treat each ISO character as a 16-bit integer. Subtract 0x60 from the first character
2420              and multiply by 2^10 (0x400), subtract 0x60 from the second character and multiply by 2^5 (0x20), subtract 0x60 from the third character,
2421              and add the three 16-bit values. This will result in a single 16-bit value with the three codes correctly packed into the 15 least
2422              significant bits and the most significant bit set to zero.
2423              */
2424              $iso_language_id  = '';
2425              $iso_language_id .= chr((($languageid & 0x7C00) >> 10) + 0x60);
2426              $iso_language_id .= chr((($languageid & 0x03E0) >>  5) + 0x60);
2427              $iso_language_id .= chr((($languageid & 0x001F) >>  0) + 0x60);
2428              $QuicktimeLanguageLookup[$languageid] = getid3_id3v2::LanguageLookup($iso_language_id);
2429          }
2430          return (isset($QuicktimeLanguageLookup[$languageid]) ? $QuicktimeLanguageLookup[$languageid] : 'invalid');
2431      }
2432  
2433      /**
2434       * @param string $codecid
2435       *
2436       * @return string
2437       */
2438  	public function QuicktimeVideoCodecLookup($codecid) {
2439          static $QuicktimeVideoCodecLookup = array();
2440          if (empty($QuicktimeVideoCodecLookup)) {
2441              $QuicktimeVideoCodecLookup['.SGI'] = 'SGI';
2442              $QuicktimeVideoCodecLookup['3IV1'] = '3ivx MPEG-4 v1';
2443              $QuicktimeVideoCodecLookup['3IV2'] = '3ivx MPEG-4 v2';
2444              $QuicktimeVideoCodecLookup['3IVX'] = '3ivx MPEG-4';
2445              $QuicktimeVideoCodecLookup['8BPS'] = 'Planar RGB';
2446              $QuicktimeVideoCodecLookup['avc1'] = 'H.264/MPEG-4 AVC';
2447              $QuicktimeVideoCodecLookup['avr '] = 'AVR-JPEG';
2448              $QuicktimeVideoCodecLookup['b16g'] = '16Gray';
2449              $QuicktimeVideoCodecLookup['b32a'] = '32AlphaGray';
2450              $QuicktimeVideoCodecLookup['b48r'] = '48RGB';
2451              $QuicktimeVideoCodecLookup['b64a'] = '64ARGB';
2452              $QuicktimeVideoCodecLookup['base'] = 'Base';
2453              $QuicktimeVideoCodecLookup['clou'] = 'Cloud';
2454              $QuicktimeVideoCodecLookup['cmyk'] = 'CMYK';
2455              $QuicktimeVideoCodecLookup['cvid'] = 'Cinepak';
2456              $QuicktimeVideoCodecLookup['dmb1'] = 'OpenDML JPEG';
2457              $QuicktimeVideoCodecLookup['dvc '] = 'DVC-NTSC';
2458              $QuicktimeVideoCodecLookup['dvcp'] = 'DVC-PAL';
2459              $QuicktimeVideoCodecLookup['dvpn'] = 'DVCPro-NTSC';
2460              $QuicktimeVideoCodecLookup['dvpp'] = 'DVCPro-PAL';
2461              $QuicktimeVideoCodecLookup['fire'] = 'Fire';
2462              $QuicktimeVideoCodecLookup['flic'] = 'FLC';
2463              $QuicktimeVideoCodecLookup['gif '] = 'GIF';
2464              $QuicktimeVideoCodecLookup['h261'] = 'H261';
2465              $QuicktimeVideoCodecLookup['h263'] = 'H263';
2466              $QuicktimeVideoCodecLookup['hvc1'] = 'H.265/HEVC';
2467              $QuicktimeVideoCodecLookup['IV41'] = 'Indeo4';
2468              $QuicktimeVideoCodecLookup['jpeg'] = 'JPEG';
2469              $QuicktimeVideoCodecLookup['kpcd'] = 'PhotoCD';
2470              $QuicktimeVideoCodecLookup['mjpa'] = 'Motion JPEG-A';
2471              $QuicktimeVideoCodecLookup['mjpb'] = 'Motion JPEG-B';
2472              $QuicktimeVideoCodecLookup['msvc'] = 'Microsoft Video1';
2473              $QuicktimeVideoCodecLookup['myuv'] = 'MPEG YUV420';
2474              $QuicktimeVideoCodecLookup['path'] = 'Vector';
2475              $QuicktimeVideoCodecLookup['png '] = 'PNG';
2476              $QuicktimeVideoCodecLookup['PNTG'] = 'MacPaint';
2477              $QuicktimeVideoCodecLookup['qdgx'] = 'QuickDrawGX';
2478              $QuicktimeVideoCodecLookup['qdrw'] = 'QuickDraw';
2479              $QuicktimeVideoCodecLookup['raw '] = 'RAW';
2480              $QuicktimeVideoCodecLookup['ripl'] = 'WaterRipple';
2481              $QuicktimeVideoCodecLookup['rpza'] = 'Video';
2482              $QuicktimeVideoCodecLookup['smc '] = 'Graphics';
2483              $QuicktimeVideoCodecLookup['SVQ1'] = 'Sorenson Video 1';
2484              $QuicktimeVideoCodecLookup['SVQ1'] = 'Sorenson Video 3';
2485              $QuicktimeVideoCodecLookup['syv9'] = 'Sorenson YUV9';
2486              $QuicktimeVideoCodecLookup['tga '] = 'Targa';
2487              $QuicktimeVideoCodecLookup['tiff'] = 'TIFF';
2488              $QuicktimeVideoCodecLookup['WRAW'] = 'Windows RAW';
2489              $QuicktimeVideoCodecLookup['WRLE'] = 'BMP';
2490              $QuicktimeVideoCodecLookup['y420'] = 'YUV420';
2491              $QuicktimeVideoCodecLookup['yuv2'] = 'ComponentVideo';
2492              $QuicktimeVideoCodecLookup['yuvs'] = 'ComponentVideoUnsigned';
2493              $QuicktimeVideoCodecLookup['yuvu'] = 'ComponentVideoSigned';
2494          }
2495          return (isset($QuicktimeVideoCodecLookup[$codecid]) ? $QuicktimeVideoCodecLookup[$codecid] : '');
2496      }
2497  
2498      /**
2499       * @param string $codecid
2500       *
2501       * @return mixed|string
2502       */
2503  	public function QuicktimeAudioCodecLookup($codecid) {
2504          static $QuicktimeAudioCodecLookup = array();
2505          if (empty($QuicktimeAudioCodecLookup)) {
2506              $QuicktimeAudioCodecLookup['.mp3']          = 'Fraunhofer MPEG Layer-III alias';
2507              $QuicktimeAudioCodecLookup['aac ']          = 'ISO/IEC 14496-3 AAC';
2508              $QuicktimeAudioCodecLookup['agsm']          = 'Apple GSM 10:1';
2509              $QuicktimeAudioCodecLookup['alac']          = 'Apple Lossless Audio Codec';
2510              $QuicktimeAudioCodecLookup['alaw']          = 'A-law 2:1';
2511              $QuicktimeAudioCodecLookup['conv']          = 'Sample Format';
2512              $QuicktimeAudioCodecLookup['dvca']          = 'DV';
2513              $QuicktimeAudioCodecLookup['dvi ']          = 'DV 4:1';
2514              $QuicktimeAudioCodecLookup['eqal']          = 'Frequency Equalizer';
2515              $QuicktimeAudioCodecLookup['fl32']          = '32-bit Floating Point';
2516              $QuicktimeAudioCodecLookup['fl64']          = '64-bit Floating Point';
2517              $QuicktimeAudioCodecLookup['ima4']          = 'Interactive Multimedia Association 4:1';
2518              $QuicktimeAudioCodecLookup['in24']          = '24-bit Integer';
2519              $QuicktimeAudioCodecLookup['in32']          = '32-bit Integer';
2520              $QuicktimeAudioCodecLookup['lpc ']          = 'LPC 23:1';
2521              $QuicktimeAudioCodecLookup['MAC3']          = 'Macintosh Audio Compression/Expansion (MACE) 3:1';
2522              $QuicktimeAudioCodecLookup['MAC6']          = 'Macintosh Audio Compression/Expansion (MACE) 6:1';
2523              $QuicktimeAudioCodecLookup['mixb']          = '8-bit Mixer';
2524              $QuicktimeAudioCodecLookup['mixw']          = '16-bit Mixer';
2525              $QuicktimeAudioCodecLookup['mp4a']          = 'ISO/IEC 14496-3 AAC';
2526              $QuicktimeAudioCodecLookup['MS'."\x00\x02"] = 'Microsoft ADPCM';
2527              $QuicktimeAudioCodecLookup['MS'."\x00\x11"] = 'DV IMA';
2528              $QuicktimeAudioCodecLookup['MS'."\x00\x55"] = 'Fraunhofer MPEG Layer III';
2529              $QuicktimeAudioCodecLookup['NONE']          = 'No Encoding';
2530              $QuicktimeAudioCodecLookup['Qclp']          = 'Qualcomm PureVoice';
2531              $QuicktimeAudioCodecLookup['QDM2']          = 'QDesign Music 2';
2532              $QuicktimeAudioCodecLookup['QDMC']          = 'QDesign Music 1';
2533              $QuicktimeAudioCodecLookup['ratb']          = '8-bit Rate';
2534              $QuicktimeAudioCodecLookup['ratw']          = '16-bit Rate';
2535              $QuicktimeAudioCodecLookup['raw ']          = 'raw PCM';
2536              $QuicktimeAudioCodecLookup['sour']          = 'Sound Source';
2537              $QuicktimeAudioCodecLookup['sowt']          = 'signed/two\'s complement (Little Endian)';
2538              $QuicktimeAudioCodecLookup['str1']          = 'Iomega MPEG layer II';
2539              $QuicktimeAudioCodecLookup['str2']          = 'Iomega MPEG *layer II';
2540              $QuicktimeAudioCodecLookup['str3']          = 'Iomega MPEG **layer II';
2541              $QuicktimeAudioCodecLookup['str4']          = 'Iomega MPEG ***layer II';
2542              $QuicktimeAudioCodecLookup['twos']          = 'signed/two\'s complement (Big Endian)';
2543              $QuicktimeAudioCodecLookup['ulaw']          = 'mu-law 2:1';
2544          }
2545          return (isset($QuicktimeAudioCodecLookup[$codecid]) ? $QuicktimeAudioCodecLookup[$codecid] : '');
2546      }
2547  
2548      /**
2549       * @param string $compressionid
2550       *
2551       * @return string
2552       */
2553  	public function QuicktimeDCOMLookup($compressionid) {
2554          static $QuicktimeDCOMLookup = array();
2555          if (empty($QuicktimeDCOMLookup)) {
2556              $QuicktimeDCOMLookup['zlib'] = 'ZLib Deflate';
2557              $QuicktimeDCOMLookup['adec'] = 'Apple Compression';
2558          }
2559          return (isset($QuicktimeDCOMLookup[$compressionid]) ? $QuicktimeDCOMLookup[$compressionid] : '');
2560      }
2561  
2562      /**
2563       * @param int $colordepthid
2564       *
2565       * @return string
2566       */
2567  	public function QuicktimeColorNameLookup($colordepthid) {
2568          static $QuicktimeColorNameLookup = array();
2569          if (empty($QuicktimeColorNameLookup)) {
2570              $QuicktimeColorNameLookup[1]  = '2-color (monochrome)';
2571              $QuicktimeColorNameLookup[2]  = '4-color';
2572              $QuicktimeColorNameLookup[4]  = '16-color';
2573              $QuicktimeColorNameLookup[8]  = '256-color';
2574              $QuicktimeColorNameLookup[16] = 'thousands (16-bit color)';
2575              $QuicktimeColorNameLookup[24] = 'millions (24-bit color)';
2576              $QuicktimeColorNameLookup[32] = 'millions+ (32-bit color)';
2577              $QuicktimeColorNameLookup[33] = 'black & white';
2578              $QuicktimeColorNameLookup[34] = '4-gray';
2579              $QuicktimeColorNameLookup[36] = '16-gray';
2580              $QuicktimeColorNameLookup[40] = '256-gray';
2581          }
2582          return (isset($QuicktimeColorNameLookup[$colordepthid]) ? $QuicktimeColorNameLookup[$colordepthid] : 'invalid');
2583      }
2584  
2585      /**
2586       * @param int $stik
2587       *
2588       * @return string
2589       */
2590  	public function QuicktimeSTIKLookup($stik) {
2591          static $QuicktimeSTIKLookup = array();
2592          if (empty($QuicktimeSTIKLookup)) {
2593              $QuicktimeSTIKLookup[0]  = 'Movie';
2594              $QuicktimeSTIKLookup[1]  = 'Normal';
2595              $QuicktimeSTIKLookup[2]  = 'Audiobook';
2596              $QuicktimeSTIKLookup[5]  = 'Whacked Bookmark';
2597              $QuicktimeSTIKLookup[6]  = 'Music Video';
2598              $QuicktimeSTIKLookup[9]  = 'Short Film';
2599              $QuicktimeSTIKLookup[10] = 'TV Show';
2600              $QuicktimeSTIKLookup[11] = 'Booklet';
2601              $QuicktimeSTIKLookup[14] = 'Ringtone';
2602              $QuicktimeSTIKLookup[21] = 'Podcast';
2603          }
2604          return (isset($QuicktimeSTIKLookup[$stik]) ? $QuicktimeSTIKLookup[$stik] : 'invalid');
2605      }
2606  
2607      /**
2608       * @param int $audio_profile_id
2609       *
2610       * @return string
2611       */
2612  	public function QuicktimeIODSaudioProfileName($audio_profile_id) {
2613          static $QuicktimeIODSaudioProfileNameLookup = array();
2614          if (empty($QuicktimeIODSaudioProfileNameLookup)) {
2615              $QuicktimeIODSaudioProfileNameLookup = array(
2616                  0x00 => 'ISO Reserved (0x00)',
2617                  0x01 => 'Main Audio Profile @ Level 1',
2618                  0x02 => 'Main Audio Profile @ Level 2',
2619                  0x03 => 'Main Audio Profile @ Level 3',
2620                  0x04 => 'Main Audio Profile @ Level 4',
2621                  0x05 => 'Scalable Audio Profile @ Level 1',
2622                  0x06 => 'Scalable Audio Profile @ Level 2',
2623                  0x07 => 'Scalable Audio Profile @ Level 3',
2624                  0x08 => 'Scalable Audio Profile @ Level 4',
2625                  0x09 => 'Speech Audio Profile @ Level 1',
2626                  0x0A => 'Speech Audio Profile @ Level 2',
2627                  0x0B => 'Synthetic Audio Profile @ Level 1',
2628                  0x0C => 'Synthetic Audio Profile @ Level 2',
2629                  0x0D => 'Synthetic Audio Profile @ Level 3',
2630                  0x0E => 'High Quality Audio Profile @ Level 1',
2631                  0x0F => 'High Quality Audio Profile @ Level 2',
2632                  0x10 => 'High Quality Audio Profile @ Level 3',
2633                  0x11 => 'High Quality Audio Profile @ Level 4',
2634                  0x12 => 'High Quality Audio Profile @ Level 5',
2635                  0x13 => 'High Quality Audio Profile @ Level 6',
2636                  0x14 => 'High Quality Audio Profile @ Level 7',
2637                  0x15 => 'High Quality Audio Profile @ Level 8',
2638                  0x16 => 'Low Delay Audio Profile @ Level 1',
2639                  0x17 => 'Low Delay Audio Profile @ Level 2',
2640                  0x18 => 'Low Delay Audio Profile @ Level 3',
2641                  0x19 => 'Low Delay Audio Profile @ Level 4',
2642                  0x1A => 'Low Delay Audio Profile @ Level 5',
2643                  0x1B => 'Low Delay Audio Profile @ Level 6',
2644                  0x1C => 'Low Delay Audio Profile @ Level 7',
2645                  0x1D => 'Low Delay Audio Profile @ Level 8',
2646                  0x1E => 'Natural Audio Profile @ Level 1',
2647                  0x1F => 'Natural Audio Profile @ Level 2',
2648                  0x20 => 'Natural Audio Profile @ Level 3',
2649                  0x21 => 'Natural Audio Profile @ Level 4',
2650                  0x22 => 'Mobile Audio Internetworking Profile @ Level 1',
2651                  0x23 => 'Mobile Audio Internetworking Profile @ Level 2',
2652                  0x24 => 'Mobile Audio Internetworking Profile @ Level 3',
2653                  0x25 => 'Mobile Audio Internetworking Profile @ Level 4',
2654                  0x26 => 'Mobile Audio Internetworking Profile @ Level 5',
2655                  0x27 => 'Mobile Audio Internetworking Profile @ Level 6',
2656                  0x28 => 'AAC Profile @ Level 1',
2657                  0x29 => 'AAC Profile @ Level 2',
2658                  0x2A => 'AAC Profile @ Level 4',
2659                  0x2B => 'AAC Profile @ Level 5',
2660                  0x2C => 'High Efficiency AAC Profile @ Level 2',
2661                  0x2D => 'High Efficiency AAC Profile @ Level 3',
2662                  0x2E => 'High Efficiency AAC Profile @ Level 4',
2663                  0x2F => 'High Efficiency AAC Profile @ Level 5',
2664                  0xFE => 'Not part of MPEG-4 audio profiles',
2665                  0xFF => 'No audio capability required',
2666              );
2667          }
2668          return (isset($QuicktimeIODSaudioProfileNameLookup[$audio_profile_id]) ? $QuicktimeIODSaudioProfileNameLookup[$audio_profile_id] : 'ISO Reserved / User Private');
2669      }
2670  
2671      /**
2672       * @param int $video_profile_id
2673       *
2674       * @return string
2675       */
2676  	public function QuicktimeIODSvideoProfileName($video_profile_id) {
2677          static $QuicktimeIODSvideoProfileNameLookup = array();
2678          if (empty($QuicktimeIODSvideoProfileNameLookup)) {
2679              $QuicktimeIODSvideoProfileNameLookup = array(
2680                  0x00 => 'Reserved (0x00) Profile',
2681                  0x01 => 'Simple Profile @ Level 1',
2682                  0x02 => 'Simple Profile @ Level 2',
2683                  0x03 => 'Simple Profile @ Level 3',
2684                  0x08 => 'Simple Profile @ Level 0',
2685                  0x10 => 'Simple Scalable Profile @ Level 0',
2686                  0x11 => 'Simple Scalable Profile @ Level 1',
2687                  0x12 => 'Simple Scalable Profile @ Level 2',
2688                  0x15 => 'AVC/H264 Profile',
2689                  0x21 => 'Core Profile @ Level 1',
2690                  0x22 => 'Core Profile @ Level 2',
2691                  0x32 => 'Main Profile @ Level 2',
2692                  0x33 => 'Main Profile @ Level 3',
2693                  0x34 => 'Main Profile @ Level 4',
2694                  0x42 => 'N-bit Profile @ Level 2',
2695                  0x51 => 'Scalable Texture Profile @ Level 1',
2696                  0x61 => 'Simple Face Animation Profile @ Level 1',
2697                  0x62 => 'Simple Face Animation Profile @ Level 2',
2698                  0x63 => 'Simple FBA Profile @ Level 1',
2699                  0x64 => 'Simple FBA Profile @ Level 2',
2700                  0x71 => 'Basic Animated Texture Profile @ Level 1',
2701                  0x72 => 'Basic Animated Texture Profile @ Level 2',
2702                  0x81 => 'Hybrid Profile @ Level 1',
2703                  0x82 => 'Hybrid Profile @ Level 2',
2704                  0x91 => 'Advanced Real Time Simple Profile @ Level 1',
2705                  0x92 => 'Advanced Real Time Simple Profile @ Level 2',
2706                  0x93 => 'Advanced Real Time Simple Profile @ Level 3',
2707                  0x94 => 'Advanced Real Time Simple Profile @ Level 4',
2708                  0xA1 => 'Core Scalable Profile @ Level1',
2709                  0xA2 => 'Core Scalable Profile @ Level2',
2710                  0xA3 => 'Core Scalable Profile @ Level3',
2711                  0xB1 => 'Advanced Coding Efficiency Profile @ Level 1',
2712                  0xB2 => 'Advanced Coding Efficiency Profile @ Level 2',
2713                  0xB3 => 'Advanced Coding Efficiency Profile @ Level 3',
2714                  0xB4 => 'Advanced Coding Efficiency Profile @ Level 4',
2715                  0xC1 => 'Advanced Core Profile @ Level 1',
2716                  0xC2 => 'Advanced Core Profile @ Level 2',
2717                  0xD1 => 'Advanced Scalable Texture @ Level1',
2718                  0xD2 => 'Advanced Scalable Texture @ Level2',
2719                  0xE1 => 'Simple Studio Profile @ Level 1',
2720                  0xE2 => 'Simple Studio Profile @ Level 2',
2721                  0xE3 => 'Simple Studio Profile @ Level 3',
2722                  0xE4 => 'Simple Studio Profile @ Level 4',
2723                  0xE5 => 'Core Studio Profile @ Level 1',
2724                  0xE6 => 'Core Studio Profile @ Level 2',
2725                  0xE7 => 'Core Studio Profile @ Level 3',
2726                  0xE8 => 'Core Studio Profile @ Level 4',
2727                  0xF0 => 'Advanced Simple Profile @ Level 0',
2728                  0xF1 => 'Advanced Simple Profile @ Level 1',
2729                  0xF2 => 'Advanced Simple Profile @ Level 2',
2730                  0xF3 => 'Advanced Simple Profile @ Level 3',
2731                  0xF4 => 'Advanced Simple Profile @ Level 4',
2732                  0xF5 => 'Advanced Simple Profile @ Level 5',
2733                  0xF7 => 'Advanced Simple Profile @ Level 3b',
2734                  0xF8 => 'Fine Granularity Scalable Profile @ Level 0',
2735                  0xF9 => 'Fine Granularity Scalable Profile @ Level 1',
2736                  0xFA => 'Fine Granularity Scalable Profile @ Level 2',
2737                  0xFB => 'Fine Granularity Scalable Profile @ Level 3',
2738                  0xFC => 'Fine Granularity Scalable Profile @ Level 4',
2739                  0xFD => 'Fine Granularity Scalable Profile @ Level 5',
2740                  0xFE => 'Not part of MPEG-4 Visual profiles',
2741                  0xFF => 'No visual capability required',
2742              );
2743          }
2744          return (isset($QuicktimeIODSvideoProfileNameLookup[$video_profile_id]) ? $QuicktimeIODSvideoProfileNameLookup[$video_profile_id] : 'ISO Reserved Profile');
2745      }
2746  
2747      /**
2748       * @param int $rtng
2749       *
2750       * @return string
2751       */
2752  	public function QuicktimeContentRatingLookup($rtng) {
2753          static $QuicktimeContentRatingLookup = array();
2754          if (empty($QuicktimeContentRatingLookup)) {
2755              $QuicktimeContentRatingLookup[0]  = 'None';
2756              $QuicktimeContentRatingLookup[1]  = 'Explicit';
2757              $QuicktimeContentRatingLookup[2]  = 'Clean';
2758              $QuicktimeContentRatingLookup[4]  = 'Explicit (old)';
2759          }
2760          return (isset($QuicktimeContentRatingLookup[$rtng]) ? $QuicktimeContentRatingLookup[$rtng] : 'invalid');
2761      }
2762  
2763      /**
2764       * @param int $akid
2765       *
2766       * @return string
2767       */
2768  	public function QuicktimeStoreAccountTypeLookup($akid) {
2769          static $QuicktimeStoreAccountTypeLookup = array();
2770          if (empty($QuicktimeStoreAccountTypeLookup)) {
2771              $QuicktimeStoreAccountTypeLookup[0] = 'iTunes';
2772              $QuicktimeStoreAccountTypeLookup[1] = 'AOL';
2773          }
2774          return (isset($QuicktimeStoreAccountTypeLookup[$akid]) ? $QuicktimeStoreAccountTypeLookup[$akid] : 'invalid');
2775      }
2776  
2777      /**
2778       * @param int $sfid
2779       *
2780       * @return string
2781       */
2782  	public function QuicktimeStoreFrontCodeLookup($sfid) {
2783          static $QuicktimeStoreFrontCodeLookup = array();
2784          if (empty($QuicktimeStoreFrontCodeLookup)) {
2785              $QuicktimeStoreFrontCodeLookup[143460] = 'Australia';
2786              $QuicktimeStoreFrontCodeLookup[143445] = 'Austria';
2787              $QuicktimeStoreFrontCodeLookup[143446] = 'Belgium';
2788              $QuicktimeStoreFrontCodeLookup[143455] = 'Canada';
2789              $QuicktimeStoreFrontCodeLookup[143458] = 'Denmark';
2790              $QuicktimeStoreFrontCodeLookup[143447] = 'Finland';
2791              $QuicktimeStoreFrontCodeLookup[143442] = 'France';
2792              $QuicktimeStoreFrontCodeLookup[143443] = 'Germany';
2793              $QuicktimeStoreFrontCodeLookup[143448] = 'Greece';
2794              $QuicktimeStoreFrontCodeLookup[143449] = 'Ireland';
2795              $QuicktimeStoreFrontCodeLookup[143450] = 'Italy';
2796              $QuicktimeStoreFrontCodeLookup[143462] = 'Japan';
2797              $QuicktimeStoreFrontCodeLookup[143451] = 'Luxembourg';
2798              $QuicktimeStoreFrontCodeLookup[143452] = 'Netherlands';
2799              $QuicktimeStoreFrontCodeLookup[143461] = 'New Zealand';
2800              $QuicktimeStoreFrontCodeLookup[143457] = 'Norway';
2801              $QuicktimeStoreFrontCodeLookup[143453] = 'Portugal';
2802              $QuicktimeStoreFrontCodeLookup[143454] = 'Spain';
2803              $QuicktimeStoreFrontCodeLookup[143456] = 'Sweden';
2804              $QuicktimeStoreFrontCodeLookup[143459] = 'Switzerland';
2805              $QuicktimeStoreFrontCodeLookup[143444] = 'United Kingdom';
2806              $QuicktimeStoreFrontCodeLookup[143441] = 'United States';
2807          }
2808          return (isset($QuicktimeStoreFrontCodeLookup[$sfid]) ? $QuicktimeStoreFrontCodeLookup[$sfid] : 'invalid');
2809      }
2810  
2811      /**
2812       * @param string $keyname
2813       * @param string|array $data
2814       * @param string $boxname
2815       *
2816       * @return bool
2817       */
2818  	public function CopyToAppropriateCommentsSection($keyname, $data, $boxname='') {
2819          static $handyatomtranslatorarray = array();
2820          if (empty($handyatomtranslatorarray)) {
2821              // http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt
2822              // http://www.geocities.com/xhelmboyx/quicktime/formats/mp4-layout.txt
2823              // http://atomicparsley.sourceforge.net/mpeg-4files.html
2824              // https://code.google.com/p/mp4v2/wiki/iTunesMetadata
2825              $handyatomtranslatorarray["\xA9".'alb'] = 'album';               // iTunes 4.0
2826              $handyatomtranslatorarray["\xA9".'ART'] = 'artist';
2827              $handyatomtranslatorarray["\xA9".'art'] = 'artist';              // iTunes 4.0
2828              $handyatomtranslatorarray["\xA9".'aut'] = 'author';
2829              $handyatomtranslatorarray["\xA9".'cmt'] = 'comment';             // iTunes 4.0
2830              $handyatomtranslatorarray["\xA9".'com'] = 'comment';
2831              $handyatomtranslatorarray["\xA9".'cpy'] = 'copyright';
2832              $handyatomtranslatorarray["\xA9".'day'] = 'creation_date';       // iTunes 4.0
2833              $handyatomtranslatorarray["\xA9".'dir'] = 'director';
2834              $handyatomtranslatorarray["\xA9".'ed1'] = 'edit1';
2835              $handyatomtranslatorarray["\xA9".'ed2'] = 'edit2';
2836              $handyatomtranslatorarray["\xA9".'ed3'] = 'edit3';
2837              $handyatomtranslatorarray["\xA9".'ed4'] = 'edit4';
2838              $handyatomtranslatorarray["\xA9".'ed5'] = 'edit5';
2839              $handyatomtranslatorarray["\xA9".'ed6'] = 'edit6';
2840              $handyatomtranslatorarray["\xA9".'ed7'] = 'edit7';
2841              $handyatomtranslatorarray["\xA9".'ed8'] = 'edit8';
2842              $handyatomtranslatorarray["\xA9".'ed9'] = 'edit9';
2843              $handyatomtranslatorarray["\xA9".'enc'] = 'encoded_by';
2844              $handyatomtranslatorarray["\xA9".'fmt'] = 'format';
2845              $handyatomtranslatorarray["\xA9".'gen'] = 'genre';               // iTunes 4.0
2846              $handyatomtranslatorarray["\xA9".'grp'] = 'grouping';            // iTunes 4.2
2847              $handyatomtranslatorarray["\xA9".'hst'] = 'host_computer';
2848              $handyatomtranslatorarray["\xA9".'inf'] = 'information';
2849              $handyatomtranslatorarray["\xA9".'lyr'] = 'lyrics';              // iTunes 5.0
2850              $handyatomtranslatorarray["\xA9".'mak'] = 'make';
2851              $handyatomtranslatorarray["\xA9".'mod'] = 'model';
2852              $handyatomtranslatorarray["\xA9".'nam'] = 'title';               // iTunes 4.0
2853              $handyatomtranslatorarray["\xA9".'ope'] = 'composer';
2854              $handyatomtranslatorarray["\xA9".'prd'] = 'producer';
2855              $handyatomtranslatorarray["\xA9".'PRD'] = 'product';
2856              $handyatomtranslatorarray["\xA9".'prf'] = 'performers';
2857              $handyatomtranslatorarray["\xA9".'req'] = 'system_requirements';
2858              $handyatomtranslatorarray["\xA9".'src'] = 'source_credit';
2859              $handyatomtranslatorarray["\xA9".'swr'] = 'software';
2860              $handyatomtranslatorarray["\xA9".'too'] = 'encoding_tool';       // iTunes 4.0
2861              $handyatomtranslatorarray["\xA9".'trk'] = 'track_number';
2862              $handyatomtranslatorarray["\xA9".'url'] = 'url';
2863              $handyatomtranslatorarray["\xA9".'wrn'] = 'warning';
2864              $handyatomtranslatorarray["\xA9".'wrt'] = 'composer';
2865              $handyatomtranslatorarray['aART'] = 'album_artist';
2866              $handyatomtranslatorarray['apID'] = 'purchase_account';
2867              $handyatomtranslatorarray['catg'] = 'category';            // iTunes 4.9
2868              $handyatomtranslatorarray['covr'] = 'picture';             // iTunes 4.0
2869              $handyatomtranslatorarray['cpil'] = 'compilation';         // iTunes 4.0
2870              $handyatomtranslatorarray['cprt'] = 'copyright';           // iTunes 4.0?
2871              $handyatomtranslatorarray['desc'] = 'description';         // iTunes 5.0
2872              $handyatomtranslatorarray['disk'] = 'disc_number';         // iTunes 4.0
2873              $handyatomtranslatorarray['egid'] = 'episode_guid';        // iTunes 4.9
2874              $handyatomtranslatorarray['gnre'] = 'genre';               // iTunes 4.0
2875              $handyatomtranslatorarray['hdvd'] = 'hd_video';            // iTunes 4.0
2876              $handyatomtranslatorarray['ldes'] = 'description_long';    //
2877              $handyatomtranslatorarray['keyw'] = 'keyword';             // iTunes 4.9
2878              $handyatomtranslatorarray['pcst'] = 'podcast';             // iTunes 4.9
2879              $handyatomtranslatorarray['pgap'] = 'gapless_playback';    // iTunes 7.0
2880              $handyatomtranslatorarray['purd'] = 'purchase_date';       // iTunes 6.0.2
2881              $handyatomtranslatorarray['purl'] = 'podcast_url';         // iTunes 4.9
2882              $handyatomtranslatorarray['rtng'] = 'rating';              // iTunes 4.0
2883              $handyatomtranslatorarray['soaa'] = 'sort_album_artist';   //
2884              $handyatomtranslatorarray['soal'] = 'sort_album';          //
2885              $handyatomtranslatorarray['soar'] = 'sort_artist';         //
2886              $handyatomtranslatorarray['soco'] = 'sort_composer';       //
2887              $handyatomtranslatorarray['sonm'] = 'sort_title';          //
2888              $handyatomtranslatorarray['sosn'] = 'sort_show';           //
2889              $handyatomtranslatorarray['stik'] = 'stik';                // iTunes 4.9
2890              $handyatomtranslatorarray['tmpo'] = 'bpm';                 // iTunes 4.0
2891              $handyatomtranslatorarray['trkn'] = 'track_number';        // iTunes 4.0
2892              $handyatomtranslatorarray['tven'] = 'tv_episode_id';       //
2893              $handyatomtranslatorarray['tves'] = 'tv_episode';          // iTunes 6.0
2894              $handyatomtranslatorarray['tvnn'] = 'tv_network_name';     // iTunes 6.0
2895              $handyatomtranslatorarray['tvsh'] = 'tv_show_name';        // iTunes 6.0
2896              $handyatomtranslatorarray['tvsn'] = 'tv_season';           // iTunes 6.0
2897  
2898              // boxnames:
2899              /*
2900              $handyatomtranslatorarray['iTunSMPB']                    = 'iTunSMPB';
2901              $handyatomtranslatorarray['iTunNORM']                    = 'iTunNORM';
2902              $handyatomtranslatorarray['Encoding Params']             = 'Encoding Params';
2903              $handyatomtranslatorarray['replaygain_track_gain']       = 'replaygain_track_gain';
2904              $handyatomtranslatorarray['replaygain_track_peak']       = 'replaygain_track_peak';
2905              $handyatomtranslatorarray['replaygain_track_minmax']     = 'replaygain_track_minmax';
2906              $handyatomtranslatorarray['MusicIP PUID']                = 'MusicIP PUID';
2907              $handyatomtranslatorarray['MusicBrainz Artist Id']       = 'MusicBrainz Artist Id';
2908              $handyatomtranslatorarray['MusicBrainz Album Id']        = 'MusicBrainz Album Id';
2909              $handyatomtranslatorarray['MusicBrainz Album Artist Id'] = 'MusicBrainz Album Artist Id';
2910              $handyatomtranslatorarray['MusicBrainz Track Id']        = 'MusicBrainz Track Id';
2911              $handyatomtranslatorarray['MusicBrainz Disc Id']         = 'MusicBrainz Disc Id';
2912  
2913              // http://age.hobba.nl/audio/tag_frame_reference.html
2914              $handyatomtranslatorarray['PLAY_COUNTER']                = 'play_counter'; // Foobar2000 - https://www.getid3.org/phpBB3/viewtopic.php?t=1355
2915              $handyatomtranslatorarray['MEDIATYPE']                   = 'mediatype';    // Foobar2000 - https://www.getid3.org/phpBB3/viewtopic.php?t=1355
2916              */
2917          }
2918          $info = &$this->getid3->info;
2919          $comment_key = '';
2920          if ($boxname && ($boxname != $keyname)) {
2921              $comment_key = (isset($handyatomtranslatorarray[$boxname]) ? $handyatomtranslatorarray[$boxname] : $boxname);
2922          } elseif (isset($handyatomtranslatorarray[$keyname])) {
2923              $comment_key = $handyatomtranslatorarray[$keyname];
2924          }
2925          if ($comment_key) {
2926              if ($comment_key == 'picture') {
2927                  // already copied directly into [comments][picture] elsewhere, do not re-copy here
2928                  return true;
2929              }
2930              $gooddata = array($data);
2931              if ($comment_key == 'genre') {
2932                  // some other taggers separate multiple genres with semicolon, e.g. "Heavy Metal;Thrash Metal;Metal"
2933                  $gooddata = explode(';', $data);
2934              }
2935              foreach ($gooddata as $data) {
2936                  if (!empty($info['quicktime']['comments'][$comment_key]) && in_array($data, $info['quicktime']['comments'][$comment_key], true)) {
2937                      // avoid duplicate copies of identical data
2938                      continue;
2939                  }
2940                  $info['quicktime']['comments'][$comment_key][] = $data;
2941              }
2942          }
2943          return true;
2944      }
2945  
2946      /**
2947       * @param string $lstring
2948       * @param int    $count
2949       *
2950       * @return string
2951       */
2952  	public function LociString($lstring, &$count) {
2953          // Loci strings are UTF-8 or UTF-16 and null (x00/x0000) terminated. UTF-16 has a BOM
2954          // Also need to return the number of bytes the string occupied so additional fields can be extracted
2955          $len = strlen($lstring);
2956          if ($len == 0) {
2957              $count = 0;
2958              return '';
2959          }
2960          if ($lstring[0] == "\x00") {
2961              $count = 1;
2962              return '';
2963          }
2964          // check for BOM
2965          if (($len > 2) && ((($lstring[0] == "\xFE") && ($lstring[1] == "\xFF")) || (($lstring[0] == "\xFF") && ($lstring[1] == "\xFE")))) {
2966              // UTF-16
2967              if (preg_match('/(.*)\x00/', $lstring, $lmatches)) {
2968                  $count = strlen($lmatches[1]) * 2 + 2; //account for 2 byte characters and trailing \x0000
2969                  return getid3_lib::iconv_fallback_utf16_utf8($lmatches[1]);
2970              } else {
2971                  return '';
2972              }
2973          }
2974          // UTF-8
2975          if (preg_match('/(.*)\x00/', $lstring, $lmatches)) {
2976              $count = strlen($lmatches[1]) + 1; //account for trailing \x00
2977              return $lmatches[1];
2978          }
2979          return '';
2980      }
2981  
2982      /**
2983       * @param string $nullterminatedstring
2984       *
2985       * @return string
2986       */
2987  	public function NoNullString($nullterminatedstring) {
2988          // remove the single null terminator on null terminated strings
2989          if (substr($nullterminatedstring, strlen($nullterminatedstring) - 1, 1) === "\x00") {
2990              return substr($nullterminatedstring, 0, strlen($nullterminatedstring) - 1);
2991          }
2992          return $nullterminatedstring;
2993      }
2994  
2995      /**
2996       * @param string $pascalstring
2997       *
2998       * @return string
2999       */
3000  	public function Pascal2String($pascalstring) {
3001          // Pascal strings have 1 unsigned byte at the beginning saying how many chars (1-255) are in the string
3002          return substr($pascalstring, 1);
3003      }
3004  
3005      /**
3006       * @param string $pascalstring
3007       *
3008       * @return string
3009       */
3010  	public function MaybePascal2String($pascalstring) {
3011          // Pascal strings have 1 unsigned byte at the beginning saying how many chars (1-255) are in the string
3012          // Check if string actually is in this format or written incorrectly, straight string, or null-terminated string
3013          if (ord(substr($pascalstring, 0, 1)) == (strlen($pascalstring) - 1)) {
3014              return substr($pascalstring, 1);
3015          } elseif (substr($pascalstring, -1, 1) == "\x00") {
3016              // appears to be null-terminated instead of Pascal-style
3017              return substr($pascalstring, 0, -1);
3018          }
3019          return $pascalstring;
3020      }
3021  
3022  
3023      /**
3024       * Helper functions for m4b audiobook chapters
3025       * code by Steffen Hartmann 2015-Nov-08.
3026       *
3027       * @param array  $info
3028       * @param string $tag
3029       * @param string $history
3030       * @param array  $result
3031       */
3032  	public function search_tag_by_key($info, $tag, $history, &$result) {
3033          foreach ($info as $key => $value) {
3034              $key_history = $history.'/'.$key;
3035              if ($key === $tag) {
3036                  $result[] = array($key_history, $info);
3037              } else {
3038                  if (is_array($value)) {
3039                      $this->search_tag_by_key($value, $tag, $key_history, $result);
3040                  }
3041              }
3042          }
3043      }
3044  
3045      /**
3046       * @param array  $info
3047       * @param string $k
3048       * @param string $v
3049       * @param string $history
3050       * @param array  $result
3051       */
3052  	public function search_tag_by_pair($info, $k, $v, $history, &$result) {
3053          foreach ($info as $key => $value) {
3054              $key_history = $history.'/'.$key;
3055              if (($key === $k) && ($value === $v)) {
3056                  $result[] = array($key_history, $info);
3057              } else {
3058                  if (is_array($value)) {
3059                      $this->search_tag_by_pair($value, $k, $v, $key_history, $result);
3060                  }
3061              }
3062          }
3063      }
3064  
3065      /**
3066       * @param array $info
3067       *
3068       * @return array
3069       */
3070  	public function quicktime_time_to_sample_table($info) {
3071          $res = array();
3072          $this->search_tag_by_pair($info['quicktime']['moov'], 'name', 'stbl', 'quicktime/moov', $res);
3073          foreach ($res as $value) {
3074              $stbl_res = array();
3075              $this->search_tag_by_pair($value[1], 'data_format', 'text', $value[0], $stbl_res);
3076              if (count($stbl_res) > 0) {
3077                  $stts_res = array();
3078                  $this->search_tag_by_key($value[1], 'time_to_sample_table', $value[0], $stts_res);
3079                  if (count($stts_res) > 0) {
3080                      return $stts_res[0][1]['time_to_sample_table'];
3081                  }
3082              }
3083          }
3084          return array();
3085      }
3086  
3087  
3088      /**
3089       * @param array $info
3090       *
3091       * @return int
3092       */
3093  	public function quicktime_bookmark_time_scale($info) {
3094          $time_scale = '';
3095          $ts_prefix_len = 0;
3096          $res = array();
3097          $this->search_tag_by_pair($info['quicktime']['moov'], 'name', 'stbl', 'quicktime/moov', $res);
3098          foreach ($res as $value) {
3099              $stbl_res = array();
3100              $this->search_tag_by_pair($value[1], 'data_format', 'text', $value[0], $stbl_res);
3101              if (count($stbl_res) > 0) {
3102                  $ts_res = array();
3103                  $this->search_tag_by_key($info['quicktime']['moov'], 'time_scale', 'quicktime/moov', $ts_res);
3104                  foreach ($ts_res as $sub_value) {
3105                      $prefix = substr($sub_value[0], 0, -12);
3106                      if ((substr($stbl_res[0][0], 0, strlen($prefix)) === $prefix) && ($ts_prefix_len < strlen($prefix))) {
3107                          $time_scale = $sub_value[1]['time_scale'];
3108                          $ts_prefix_len = strlen($prefix);
3109                      }
3110                  }
3111              }
3112          }
3113          return $time_scale;
3114      }
3115      /*
3116      // END helper functions for m4b audiobook chapters
3117      */
3118  
3119  
3120  }


Generated : Fri Oct 10 08:20:03 2025 Cross-referenced by PHPXref