<h2>Editing File: /usr/local/sitepad/editor/site-inc/ID3/module.audio.flac.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/////////////////////////////////////////////////////////////////
/// getID3() by James Heinrich &lt;info@getid3.org&gt;               //
//  available at http://getid3.sourceforge.net                 //
//            or http://www.getid3.org                         //
//          also https://github.com/JamesHeinrich/getID3       //
/////////////////////////////////////////////////////////////////
// See readme.txt for more details                             //
/////////////////////////////////////////////////////////////////
//                                                             //
// module.audio.flac.php                                       //
// module for analyzing FLAC and OggFLAC audio files           //
// dependencies: module.audio.ogg.php                          //
//                                                            ///
/////////////////////////////////////////////////////////////////


getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.audio.ogg.php', __FILE__, true);

/**
* @tutorial http://flac.sourceforge.net/format.html
*/
class getid3_flac extends getid3_handler
{
	const syncword = 'fLaC';

	public function Analyze() {
		$info = &amp;$this-&gt;getid3-&gt;info;

		$this-&gt;fseek($info['avdataoffset']);
		$StreamMarker = $this-&gt;fread(4);
		if ($StreamMarker != self::syncword) {
			return $this-&gt;error('Expecting &quot;'.getid3_lib::PrintHexBytes(self::syncword).'&quot; at offset '.$info['avdataoffset'].', found &quot;'.getid3_lib::PrintHexBytes($StreamMarker).'&quot;');
		}
		$info['fileformat']            = 'flac';
		$info['audio']['dataformat']   = 'flac';
		$info['audio']['bitrate_mode'] = 'vbr';
		$info['audio']['lossless']     = true;

		// parse flac container
		return $this-&gt;parseMETAdata();
	}

	public function parseMETAdata() {
		$info = &amp;$this-&gt;getid3-&gt;info;
		do {
			$BlockOffset   = $this-&gt;ftell();
			$BlockHeader   = $this-&gt;fread(4);
			$LBFBT         = getid3_lib::BigEndian2Int(substr($BlockHeader, 0, 1));
			$LastBlockFlag = (bool) ($LBFBT &amp; 0x80);
			$BlockType     =        ($LBFBT &amp; 0x7F);
			$BlockLength   = getid3_lib::BigEndian2Int(substr($BlockHeader, 1, 3));
			$BlockTypeText = self::metaBlockTypeLookup($BlockType);

			if (($BlockOffset + 4 + $BlockLength) &gt; $info['avdataend']) {
				$this-&gt;error('METADATA_BLOCK_HEADER.BLOCK_TYPE ('.$BlockTypeText.') at offset '.$BlockOffset.' extends beyond end of file');
				break;
			}
			if ($BlockLength &lt; 1) {
				$this-&gt;error('METADATA_BLOCK_HEADER.BLOCK_LENGTH ('.$BlockLength.') at offset '.$BlockOffset.' is invalid');
				break;
			}

			$info['flac'][$BlockTypeText]['raw'] = array();
			$BlockTypeText_raw = &amp;$info['flac'][$BlockTypeText]['raw'];

			$BlockTypeText_raw['offset']          = $BlockOffset;
			$BlockTypeText_raw['last_meta_block'] = $LastBlockFlag;
			$BlockTypeText_raw['block_type']      = $BlockType;
			$BlockTypeText_raw['block_type_text'] = $BlockTypeText;
			$BlockTypeText_raw['block_length']    = $BlockLength;
			if ($BlockTypeText_raw['block_type'] != 0x06) { // do not read attachment data automatically
				$BlockTypeText_raw['block_data']  = $this-&gt;fread($BlockLength);
			}

			switch ($BlockTypeText) {
				case 'STREAMINFO':     // 0x00
					if (!$this-&gt;parseSTREAMINFO($BlockTypeText_raw['block_data'])) {
						return false;
					}
					break;

				case 'PADDING':        // 0x01
					unset($info['flac']['PADDING']); // ignore
					break;

				case 'APPLICATION':    // 0x02
					if (!$this-&gt;parseAPPLICATION($BlockTypeText_raw['block_data'])) {
						return false;
					}
					break;

				case 'SEEKTABLE':      // 0x03
					if (!$this-&gt;parseSEEKTABLE($BlockTypeText_raw['block_data'])) {
						return false;
					}
					break;

				case 'VORBIS_COMMENT': // 0x04
					if (!$this-&gt;parseVORBIS_COMMENT($BlockTypeText_raw['block_data'])) {
						return false;
					}
					break;

				case 'CUESHEET':       // 0x05
					if (!$this-&gt;parseCUESHEET($BlockTypeText_raw['block_data'])) {
						return false;
					}
					break;

				case 'PICTURE':        // 0x06
					if (!$this-&gt;parsePICTURE()) {
						return false;
					}
					break;

				default:
					$this-&gt;warning('Unhandled METADATA_BLOCK_HEADER.BLOCK_TYPE ('.$BlockType.') at offset '.$BlockOffset);
			}

			unset($info['flac'][$BlockTypeText]['raw']);
			$info['avdataoffset'] = $this-&gt;ftell();
		}
		while ($LastBlockFlag === false);

		// handle tags
		if (!empty($info['flac']['VORBIS_COMMENT']['comments'])) {
			$info['flac']['comments'] = $info['flac']['VORBIS_COMMENT']['comments'];
		}
		if (!empty($info['flac']['VORBIS_COMMENT']['vendor'])) {
			$info['audio']['encoder'] = str_replace('reference ', '', $info['flac']['VORBIS_COMMENT']['vendor']);
		}

		// copy attachments to 'comments' array if nesesary
		if (isset($info['flac']['PICTURE']) &amp;&amp; ($this-&gt;getid3-&gt;option_save_attachments !== getID3::ATTACHMENTS_NONE)) {
			foreach ($info['flac']['PICTURE'] as $entry) {
				if (!empty($entry['data'])) {
					if (!isset($info['flac']['comments']['picture'])) {
						$info['flac']['comments']['picture'] = array();
					}
					$comments_picture_data = array();
					foreach (array('data', 'image_mime', 'image_width', 'image_height', 'imagetype', 'picturetype', 'description', 'datalength') as $picture_key) {
						if (isset($entry[$picture_key])) {
							$comments_picture_data[$picture_key] = $entry[$picture_key];
						}
					}
					$info['flac']['comments']['picture'][] = $comments_picture_data;
					unset($comments_picture_data);
				}
			}
		}

		if (isset($info['flac']['STREAMINFO'])) {
			if (!$this-&gt;isDependencyFor('matroska')) {
				$info['flac']['compressed_audio_bytes'] = $info['avdataend'] - $info['avdataoffset'];
			}
			$info['flac']['uncompressed_audio_bytes'] = $info['flac']['STREAMINFO']['samples_stream'] * $info['flac']['STREAMINFO']['channels'] * ($info['flac']['STREAMINFO']['bits_per_sample'] / 8);
			if ($info['flac']['uncompressed_audio_bytes'] == 0) {
				return $this-&gt;error('Corrupt FLAC file: uncompressed_audio_bytes == zero');
			}
			if (!empty($info['flac']['compressed_audio_bytes'])) {
				$info['flac']['compression_ratio'] = $info['flac']['compressed_audio_bytes'] / $info['flac']['uncompressed_audio_bytes'];
			}
		}

		// set md5_data_source - built into flac 0.5+
		if (isset($info['flac']['STREAMINFO']['audio_signature'])) {

			if ($info['flac']['STREAMINFO']['audio_signature'] === str_repeat(&quot;\x00&quot;, 16)) {
                $this-&gt;warning('FLAC STREAMINFO.audio_signature is null (known issue with libOggFLAC)');
			}
			else {
				$info['md5_data_source'] = '';
				$md5 = $info['flac']['STREAMINFO']['audio_signature'];
				for ($i = 0; $i &lt; strlen($md5); $i++) {
					$info['md5_data_source'] .= str_pad(dechex(ord($md5[$i])), 2, '00', STR_PAD_LEFT);
				}
				if (!preg_match('/^[0-9a-f]{32}$/', $info['md5_data_source'])) {
					unset($info['md5_data_source']);
				}
			}
		}

		if (isset($info['flac']['STREAMINFO']['bits_per_sample'])) {
			$info['audio']['bits_per_sample'] = $info['flac']['STREAMINFO']['bits_per_sample'];
			if ($info['audio']['bits_per_sample'] == 8) {
				// special case
				// must invert sign bit on all data bytes before MD5'ing to match FLAC's calculated value
				// MD5sum calculates on unsigned bytes, but FLAC calculated MD5 on 8-bit audio data as signed
				$this-&gt;warning('FLAC calculates MD5 data strangely on 8-bit audio, so the stored md5_data_source value will not match the decoded WAV file');
			}
		}

		return true;
	}

	private function parseSTREAMINFO($BlockData) {
		$info = &amp;$this-&gt;getid3-&gt;info;

		$info['flac']['STREAMINFO'] = array();
		$streaminfo = &amp;$info['flac']['STREAMINFO'];

		$streaminfo['min_block_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 0, 2));
		$streaminfo['max_block_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 2, 2));
		$streaminfo['min_frame_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 4, 3));
		$streaminfo['max_frame_size']  = getid3_lib::BigEndian2Int(substr($BlockData, 7, 3));

		$SRCSBSS                       = getid3_lib::BigEndian2Bin(substr($BlockData, 10, 8));
		$streaminfo['sample_rate']     = getid3_lib::Bin2Dec(substr($SRCSBSS,  0, 20));
		$streaminfo['channels']        = getid3_lib::Bin2Dec(substr($SRCSBSS, 20,  3)) + 1;
		$streaminfo['bits_per_sample'] = getid3_lib::Bin2Dec(substr($SRCSBSS, 23,  5)) + 1;
		$streaminfo['samples_stream']  = getid3_lib::Bin2Dec(substr($SRCSBSS, 28, 36));

		$streaminfo['audio_signature'] = substr($BlockData, 18, 16);

		if (!empty($streaminfo['sample_rate'])) {

			$info['audio']['bitrate_mode']    = 'vbr';
			$info['audio']['sample_rate']     = $streaminfo['sample_rate'];
			$info['audio']['channels']        = $streaminfo['channels'];
			$info['audio']['bits_per_sample'] = $streaminfo['bits_per_sample'];
			$info['playtime_seconds']         = $streaminfo['samples_stream'] / $streaminfo['sample_rate'];
			if ($info['playtime_seconds'] &gt; 0) {
				if (!$this-&gt;isDependencyFor('matroska')) {
					$info['audio']['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $info['playtime_seconds'];
				}
				else {
					$this-&gt;warning('Cannot determine audio bitrate because total stream size is unknown');
				}
			}

		} else {
			return $this-&gt;error('Corrupt METAdata block: STREAMINFO');
		}

		return true;
	}

	private function parseAPPLICATION($BlockData) {
		$info = &amp;$this-&gt;getid3-&gt;info;

		$ApplicationID = getid3_lib::BigEndian2Int(substr($BlockData, 0, 4));
		$info['flac']['APPLICATION'][$ApplicationID]['name'] = self::applicationIDLookup($ApplicationID);
		$info['flac']['APPLICATION'][$ApplicationID]['data'] = substr($BlockData, 4);

		return true;
	}

	private function parseSEEKTABLE($BlockData) {
		$info = &amp;$this-&gt;getid3-&gt;info;

		$offset = 0;
		$BlockLength = strlen($BlockData);
		$placeholderpattern = str_repeat(&quot;\xFF&quot;, 8);
		while ($offset &lt; $BlockLength) {
			$SampleNumberString = substr($BlockData, $offset, 8);
			$offset += 8;
			if ($SampleNumberString == $placeholderpattern) {

				// placeholder point
				getid3_lib::safe_inc($info['flac']['SEEKTABLE']['placeholders'], 1);
				$offset += 10;

			} else {

				$SampleNumber                                        = getid3_lib::BigEndian2Int($SampleNumberString);
				$info['flac']['SEEKTABLE'][$SampleNumber]['offset']  = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
				$offset += 8;
				$info['flac']['SEEKTABLE'][$SampleNumber]['samples'] = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 2));
				$offset += 2;

			}
		}

		return true;
	}

	private function parseVORBIS_COMMENT($BlockData) {
		$info = &amp;$this-&gt;getid3-&gt;info;

		$getid3_ogg = new getid3_ogg($this-&gt;getid3);
		if ($this-&gt;isDependencyFor('matroska')) {
			$getid3_ogg-&gt;setStringMode($this-&gt;data_string);
		}
		$getid3_ogg-&gt;ParseVorbisComments();
		if (isset($info['ogg'])) {
			unset($info['ogg']['comments_raw']);
			$info['flac']['VORBIS_COMMENT'] = $info['ogg'];
			unset($info['ogg']);
		}

		unset($getid3_ogg);

		return true;
	}

	private function parseCUESHEET($BlockData) {
		$info = &amp;$this-&gt;getid3-&gt;info;
		$offset = 0;
		$info['flac']['CUESHEET']['media_catalog_number'] =                              trim(substr($BlockData, $offset, 128), &quot;\0&quot;);
		$offset += 128;
		$info['flac']['CUESHEET']['lead_in_samples']      =         getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
		$offset += 8;
		$info['flac']['CUESHEET']['flags']['is_cd']       = (bool) (getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1)) &amp; 0x80);
		$offset += 1;

		$offset += 258; // reserved

		$info['flac']['CUESHEET']['number_tracks']        =         getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
		$offset += 1;

		for ($track = 0; $track &lt; $info['flac']['CUESHEET']['number_tracks']; $track++) {
			$TrackSampleOffset = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
			$offset += 8;
			$TrackNumber       = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
			$offset += 1;

			$info['flac']['CUESHEET']['tracks'][$TrackNumber]['sample_offset']         = $TrackSampleOffset;

			$info['flac']['CUESHEET']['tracks'][$TrackNumber]['isrc']                  =                           substr($BlockData, $offset, 12);
			$offset += 12;

			$TrackFlagsRaw                                                             = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
			$offset += 1;
			$info['flac']['CUESHEET']['tracks'][$TrackNumber]['flags']['is_audio']     = (bool) ($TrackFlagsRaw &amp; 0x80);
			$info['flac']['CUESHEET']['tracks'][$TrackNumber]['flags']['pre_emphasis'] = (bool) ($TrackFlagsRaw &amp; 0x40);

			$offset += 13; // reserved

			$info['flac']['CUESHEET']['tracks'][$TrackNumber]['index_points']          = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
			$offset += 1;

			for ($index = 0; $index &lt; $info['flac']['CUESHEET']['tracks'][$TrackNumber]['index_points']; $index++) {
				$IndexSampleOffset = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 8));
				$offset += 8;
				$IndexNumber       = getid3_lib::BigEndian2Int(substr($BlockData, $offset, 1));
				$offset += 1;

				$offset += 3; // reserved

				$info['flac']['CUESHEET']['tracks'][$TrackNumber]['indexes'][$IndexNumber] = $IndexSampleOffset;
			}
		}

		return true;
	}

	/**
	* Parse METADATA_BLOCK_PICTURE flac structure and extract attachment
	* External usage: audio.ogg
	*/
	public function parsePICTURE() {
		$info = &amp;$this-&gt;getid3-&gt;info;

		$picture['typeid']         = getid3_lib::BigEndian2Int($this-&gt;fread(4));
		$picture['picturetype']    = self::pictureTypeLookup($picture['typeid']);
		$picture['image_mime']     = $this-&gt;fread(getid3_lib::BigEndian2Int($this-&gt;fread(4)));
		$descr_length              = getid3_lib::BigEndian2Int($this-&gt;fread(4));
		if ($descr_length) {
			$picture['description'] = $this-&gt;fread($descr_length);
		}
		$picture['image_width']    = getid3_lib::BigEndian2Int($this-&gt;fread(4));
		$picture['image_height']   = getid3_lib::BigEndian2Int($this-&gt;fread(4));
		$picture['color_depth']    = getid3_lib::BigEndian2Int($this-&gt;fread(4));
		$picture['colors_indexed'] = getid3_lib::BigEndian2Int($this-&gt;fread(4));
		$picture['datalength']     = getid3_lib::BigEndian2Int($this-&gt;fread(4));

		if ($picture['image_mime'] == '--&gt;') {
			$picture['data'] = $this-&gt;fread($picture['datalength']);
		} else {
			$picture['data'] = $this-&gt;saveAttachment(
				str_replace('/', '_', $picture['picturetype']).'_'.$this-&gt;ftell(),
				$this-&gt;ftell(),
				$picture['datalength'],
				$picture['image_mime']);
		}

		$info['flac']['PICTURE'][] = $picture;

		return true;
	}

	public static function metaBlockTypeLookup($blocktype) {
		static $lookup = array(
			0 =&gt; 'STREAMINFO',
			1 =&gt; 'PADDING',
			2 =&gt; 'APPLICATION',
			3 =&gt; 'SEEKTABLE',
			4 =&gt; 'VORBIS_COMMENT',
			5 =&gt; 'CUESHEET',
			6 =&gt; 'PICTURE',
		);
		return (isset($lookup[$blocktype]) ? $lookup[$blocktype] : 'reserved');
	}

	public static function applicationIDLookup($applicationid) {
		// http://flac.sourceforge.net/id.html
		static $lookup = array(
			0x41544348 =&gt; 'FlacFile',                                                                           // &quot;ATCH&quot;
			0x42534F4C =&gt; 'beSolo',                                                                             // &quot;BSOL&quot;
			0x42554753 =&gt; 'Bugs Player',                                                                        // &quot;BUGS&quot;
			0x43756573 =&gt; 'GoldWave cue points (specification)',                                                // &quot;Cues&quot;
			0x46696361 =&gt; 'CUE Splitter',                                                                       // &quot;Fica&quot;
			0x46746F6C =&gt; 'flac-tools',                                                                         // &quot;Ftol&quot;
			0x4D4F5442 =&gt; 'MOTB MetaCzar',                                                                      // &quot;MOTB&quot;
			0x4D505345 =&gt; 'MP3 Stream Editor',                                                                  // &quot;MPSE&quot;
			0x4D754D4C =&gt; 'MusicML: Music Metadata Language',                                                   // &quot;MuML&quot;
			0x52494646 =&gt; 'Sound Devices RIFF chunk storage',                                                   // &quot;RIFF&quot;
			0x5346464C =&gt; 'Sound Font FLAC',                                                                    // &quot;SFFL&quot;
			0x534F4E59 =&gt; 'Sony Creative Software',                                                             // &quot;SONY&quot;
			0x5351455A =&gt; 'flacsqueeze',                                                                        // &quot;SQEZ&quot;
			0x54745776 =&gt; 'TwistedWave',                                                                        // &quot;TtWv&quot;
			0x55495453 =&gt; 'UITS Embedding tools',                                                               // &quot;UITS&quot;
			0x61696666 =&gt; 'FLAC AIFF chunk storage',                                                            // &quot;aiff&quot;
			0x696D6167 =&gt; 'flac-image application for storing arbitrary files in APPLICATION metadata blocks',  // &quot;imag&quot;
			0x7065656D =&gt; 'Parseable Embedded Extensible Metadata (specification)',                             // &quot;peem&quot;
			0x71667374 =&gt; 'QFLAC Studio',                                                                       // &quot;qfst&quot;
			0x72696666 =&gt; 'FLAC RIFF chunk storage',                                                            // &quot;riff&quot;
			0x74756E65 =&gt; 'TagTuner',                                                                           // &quot;tune&quot;
			0x78626174 =&gt; 'XBAT',                                                                               // &quot;xbat&quot;
			0x786D6364 =&gt; 'xmcd',                                                                               // &quot;xmcd&quot;
		);
		return (isset($lookup[$applicationid]) ? $lookup[$applicationid] : 'reserved');
	}

	public static function pictureTypeLookup($type_id) {
		static $lookup = array (
			 0 =&gt; 'Other',
			 1 =&gt; '32x32 pixels \'file icon\' (PNG only)',
			 2 =&gt; 'Other file icon',
			 3 =&gt; 'Cover (front)',
			 4 =&gt; 'Cover (back)',
			 5 =&gt; 'Leaflet page',
			 6 =&gt; 'Media (e.g. label side of CD)',
			 7 =&gt; 'Lead artist/lead performer/soloist',
			 8 =&gt; 'Artist/performer',
			 9 =&gt; 'Conductor',
			10 =&gt; 'Band/Orchestra',
			11 =&gt; 'Composer',
			12 =&gt; 'Lyricist/text writer',
			13 =&gt; 'Recording Location',
			14 =&gt; 'During recording',
			15 =&gt; 'During performance',
			16 =&gt; 'Movie/video screen capture',
			17 =&gt; 'A bright coloured fish',
			18 =&gt; 'Illustration',
			19 =&gt; 'Band/artist logotype',
			20 =&gt; 'Publisher/Studio logotype',
		);
		return (isset($lookup[$type_id]) ? $lookup[$type_id] : 'reserved');
	}

}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fsitepad%2Feditor%2Fsite-inc%2FID3'>Back to Directory</a>