www/plugins-dist/medias/lib/getid3/module.audio.amr.php

   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.aa.php                                         //
  12 // module for analyzing Audible Audiobook files                //
  13 // dependencies: NONE                                          //
  14 //                                                            ///
  15 /////////////////////////////////////////////////////////////////
  16
  17
  18 class getid3_amr extends getid3_handler
  19 {
  20         /**
  21          * @return bool
  22          */
  23         public function Analyze() {
  24                 $info = &$this->getid3->info;
  25
  26                 $this->fseek($info['avdataoffset']);
  27                 $AMRheader = $this->fread(6);
  28
  29                 $magic = '#!AMR'."\x0A";
  30                 if (substr($AMRheader, 0, 6) != $magic) {
  31                         $this->error('Expecting "'.getid3_lib::PrintHexBytes($magic).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib::PrintHexBytes(substr($AMRheader, 0, 6)).'"');
  32                         return false;
  33                 }
  34
  35                 // shortcut
  36                 $info['amr'] = array();
  37                 $thisfile_amr = &$info['amr'];
  38
  39                 $info['fileformat']               = 'amr';
  40                 $info['audio']['dataformat']      = 'amr';
  41                 $info['audio']['bitrate_mode']    = 'vbr';   // within a small predefined range: 4.75kbps to 12.2kbps
  42                 $info['audio']['bits_per_sample'] =    13;   // http://en.wikipedia.org/wiki/Adaptive_Multi-Rate_audio_codec: "Sampling frequency 8 kHz/13-bit (160 samples for 20 ms frames), filtered to 200–3400 Hz"
  43                 $info['audio']['sample_rate']     =  8000;   // http://en.wikipedia.org/wiki/Adaptive_Multi-Rate_audio_codec: "Sampling frequency 8 kHz/13-bit (160 samples for 20 ms frames), filtered to 200–3400 Hz"
  44                 $info['audio']['channels']        =     1;
  45                 $thisfile_amr['frame_mode_count'] = array(0=>0, 1=>0, 2=>0, 3=>0, 4=>0, 5=>0, 6=>0, 7=>0);
  46
  47                 $buffer = '';
  48                 do {
  49                         if ((strlen($buffer) < $this->getid3->fread_buffer_size()) && !feof($this->getid3->fp)) {
  50                                 $buffer .= $this->fread($this->getid3->fread_buffer_size() * 2);
  51                         }
  52                         $AMR_frame_header = ord(substr($buffer, 0, 1));
  53                         $codec_mode_request = ($AMR_frame_header & 0x78) >> 3; // The 2nd bit through 5th bit (counting the most significant bit as the first bit) comprise the CMR (Codec Mode Request), values 0-7 being valid for AMR. The top bit of the CMR can actually be ignored, though it is used when AMR forms RTP payloads. The lower 3-bits of the header are reserved and are not used. Viewing the header from most significant bit to least significant bit, the encoding is XCCCCXXX, where Xs are reserved (typically 0) and the Cs are the CMR.
  54                         if ($codec_mode_request > 7) {
  55                                 break;
  56                         }
  57                         $thisfile_amr['frame_mode_count'][$codec_mode_request]++;
  58                         $buffer = substr($buffer, $this->amr_mode_bytes_per_frame($codec_mode_request));
  59                 } while (strlen($buffer) > 0);
  60
  61                 $info['playtime_seconds'] = array_sum($thisfile_amr['frame_mode_count']) * 0.020; // each frame contain 160 samples and is 20 milliseconds long
  62                 $info['audio']['bitrate'] = (8 * ($info['avdataend'] - $info['avdataoffset'])) / $info['playtime_seconds']; // bitrate could be calculated from average bitrate by distributation of frame types. That would give effective audio bitrate, this gives overall file bitrate which will be a little bit higher since every frame will waste 8 bits for header, plus a few bits for octet padding
  63                 $info['bitrate'] = $info['audio']['bitrate'];
  64
  65                 return true;
  66         }
  67
  68         /**
  69          * @param int $key
  70          *
  71          * @return int|false
  72          */
  73         public function amr_mode_bitrate($key) {
  74                 static $amr_mode_bitrate = array(
  75                         0 =>  4750,
  76                         1 =>  5150,
  77                         2 =>  5900,
  78                         3 =>  6700,
  79                         4 =>  7400,
  80                         5 =>  7950,
  81                         6 => 10200,
  82                         7 => 12200,
  83                 );
  84                 return (isset($amr_mode_bitrate[$key]) ? $amr_mode_bitrate[$key] : false);
  85         }
  86
  87         /**
  88          * @param int $key
  89          *
  90          * @return int|false
  91          */
  92         public function amr_mode_bytes_per_frame($key) {
  93                 static $amr_mode_bitrate = array(
  94                         0 =>  13, // 1-byte frame header +  95 bits [padded to: 12 bytes] audio data
  95                         1 =>  14, // 1-byte frame header + 103 bits [padded to: 13 bytes] audio data
  96                         2 =>  16, // 1-byte frame header + 118 bits [padded to: 15 bytes] audio data
  97                         3 =>  18, // 1-byte frame header + 134 bits [padded to: 17 bytes] audio data
  98                         4 =>  20, // 1-byte frame header + 148 bits [padded to: 19 bytes] audio data
  99                         5 =>  21, // 1-byte frame header + 159 bits [padded to: 20 bytes] audio data
 100                         6 =>  27, // 1-byte frame header + 204 bits [padded to: 26 bytes] audio data
 101                         7 =>  32, // 1-byte frame header + 244 bits [padded to: 31 bytes] audio data
 102                 );
 103                 return (isset($amr_mode_bitrate[$key]) ? $amr_mode_bitrate[$key] : false);
 104         }
 105
 106
 107 }