owncloud / music

3rdparty/getID3/getid3/getid3.lib.php

Doc Comments +69 added lines

@@ -99,6 +99,9 @@ 
 	}
 
 
+	/**
+	 * @param string $binarynumerator
+	 */
 	public static function DecimalBinary2Float($binarynumerator) {
 		$numerator   = self::Bin2Dec($binarynumerator);
 		$denominator = self::Bin2Dec('1'.str_repeat('0', strlen($binarynumerator)));
@@ -106,6 +109,9 @@ 
 	}
 
 
+	/**
+	 * @param string $binarypointnumber
+	 */
 	public static function NormalizeBinaryPoint($binarypointnumber, $maxbits=52) {
 		// http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html
 		if (strpos($binarypointnumber, '.') === false) {
@@ -146,6 +152,9 @@ 
 	}
 
 
+	/**
+	 * @param integer $bits
+	 */
 	public static function Float2String($floatvalue, $bits) {
 		// http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html
 		switch ($bits) {
@@ -177,6 +186,9 @@ 
 	}
 
 
+	/**
+	 * @param string $byteword
+	 */
 	public static function LittleEndian2Float($byteword) {
 		return self::BigEndian2Float(strrev($byteword));
 	}
@@ -293,6 +305,9 @@ 
 		return self::BigEndian2Int(strrev($byteword), false, $signed);
 	}
 
+	/**
+	 * @param string $byteword
+	 */
 	public static function LittleEndian2Bin($byteword) {
 		return self::BigEndian2Bin(strrev($byteword));
 	}
@@ -358,6 +373,9 @@ 
 	}
 
 
+	/**
+	 * @param string $binstring
+	 */
 	public static function Bin2String($binstring) {
 		// return 'hi' for input of '0110100001101001'
 		$string = '';
@@ -369,6 +387,9 @@ 
 	}
 
 
+	/**
+	 * @param integer $number
+	 */
 	public static function LittleEndian2String($number, $minbytes=1, $synchsafe=false) {
 		$intstring = '';
 		while ($number > 0) {
@@ -475,22 +496,34 @@ 
 	}
 
 
+	/**
+	 * @param string $rawdata
+	 */
 	public static function FixedPoint8_8($rawdata) {
 		return self::BigEndian2Int(substr($rawdata, 0, 1)) + (float) (self::BigEndian2Int(substr($rawdata, 1, 1)) / pow(2, 8));
 	}
 
 
+	/**
+	 * @param string $rawdata
+	 */
 	public static function FixedPoint16_16($rawdata) {
 		return self::BigEndian2Int(substr($rawdata, 0, 2)) + (float) (self::BigEndian2Int(substr($rawdata, 2, 2)) / pow(2, 16));
 	}
 
 
+	/**
+	 * @param string $rawdata
+	 */
 	public static function FixedPoint2_30($rawdata) {
 		$binarystring = self::BigEndian2Bin($rawdata);
 		return self::Bin2Dec(substr($binarystring, 0, 2)) + (float) (self::Bin2Dec(substr($binarystring, 2, 30)) / pow(2, 30));
 	}
 
 
+	/**
+	 * @param string $Separator
+	 */
 	public static function CreateDeepArray($ArrayPath, $Separator, $Value) {
 		// assigns $Value to a nested array path:
 		//   $foo = self::CreateDeepArray('/path/to/my', '/', 'file.txt')
@@ -548,6 +581,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param SimpleXMLElement $XMLobject
+	 */
 	public static function SimpleXMLelement2array($XMLobject) {
 		if (!is_object($XMLobject) && !is_array($XMLobject)) {
 			return $XMLobject;
@@ -648,6 +684,9 @@ 
 		return $result;
 	}
 
+	/**
+	 * @param string $filename_dest
+	 */
 	public static function CopyFileParts($filename_source, $filename_dest, $offset, $length) {
 		if (!self::intValueSupported($offset + $length)) {
 			throw new Exception('cannot copy file portion, it extends beyond the '.round(PHP_INT_MAX / 1073741824).'GB limit');
@@ -880,6 +919,10 @@ 
 	}
 
 	// UTF-16BE => UTF-8
+
+	/**
+	 * @param string $string
+	 */
 	public static function iconv_fallback_utf16be_utf8($string) {
 		if (substr($string, 0, 2) == "\xFE\xFF") {
 			// strip BOM
@@ -894,6 +937,10 @@ 
 	}
 
 	// UTF-16LE => UTF-8
+
+	/**
+	 * @param string $string
+	 */
 	public static function iconv_fallback_utf16le_utf8($string) {
 		if (substr($string, 0, 2) == "\xFF\xFE") {
 			// strip BOM
@@ -908,6 +955,10 @@ 
 	}
 
 	// UTF-16BE => ISO-8859-1
+
+	/**
+	 * @param string $string
+	 */
 	public static function iconv_fallback_utf16be_iso88591($string) {
 		if (substr($string, 0, 2) == "\xFE\xFF") {
 			// strip BOM
@@ -922,6 +973,10 @@ 
 	}
 
 	// UTF-16LE => ISO-8859-1
+
+	/**
+	 * @param string $string
+	 */
 	public static function iconv_fallback_utf16le_iso88591($string) {
 		if (substr($string, 0, 2) == "\xFF\xFE") {
 			// strip BOM
@@ -947,6 +1002,10 @@ 
 	}
 
 	// UTF-16 (BOM) => UTF-8
+
+	/**
+	 * @param string $string
+	 */
 	public static function iconv_fallback_utf16_utf8($string) {
 		$bom = substr($string, 0, 2);
 		if ($bom == "\xFE\xFF") {
@@ -1327,6 +1386,12 @@ 
 	}
 
 
+	/**
+	 * @param integer $begin
+	 * @param integer $end
+	 * @param string $file
+	 * @param string $name
+	 */
 	public static function EmbeddedLookup($key, $begin, $end, $file, $name) {
 
 		// Cached
@@ -1373,6 +1438,10 @@ 
 		return (isset($cache[$file][$name][$key]) ? $cache[$file][$name][$key] : '');
 	}
 
+	/**
+	 * @param string $filename
+	 * @param string $sourcefile
+	 */
 	public static function IncludeDependency($filename, $sourcefile, $DieOnFailure=false) {
 		global $GETID3_ERRORARRAY;
 

3rdparty/getID3/getid3/module.audio-video.quicktime.php

Doc Comments +27 added lines

@@ -200,6 +200,10 @@ 
 		return true;
 	}
 
+	/**
+	 * @param string $atomname
+	 * @param string $atom_data
+	 */
 	public function QuicktimeParseAtom($atomname, $atomsize, $atom_data, $baseoffset, &$atomHierarchy, $ParseAllPossibleAtoms) {
 		// http://developer.apple.com/techpubs/quicktime/qtdevdocs/APIREF/INDEX/atomalphaindex.htm
 		// https://code.google.com/p/mp4v2/wiki/iTunesMetadata
@@ -1742,6 +1746,9 @@ 
 		return $atom_structure;
 	}
 
+	/**
+	 * @param integer $baseoffset
+	 */
 	public function QuicktimeParseContainerAtom($atom_data, $baseoffset, &$atomHierarchy, $ParseAllPossibleAtoms) {
 //echo 'QuicktimeParseContainerAtom('.substr($atom_data, 4, 4).') @ '.$baseoffset.'<br><br>';
 		$atom_structure  = false;
@@ -1774,6 +1781,9 @@ 
 	}
 
 
+	/**
+	 * @param integer $offset
+	 */
 	public function quicktime_read_mp4_descr_length($data, &$offset) {
 		// http://libquicktime.sourcearchive.com/documentation/2:1.0.2plus-pdebian-2build1/esds_8c-source.html
 		$num_bytes = 0;
@@ -2565,6 +2575,9 @@ 
 		return true;
 	}
 
+    /**
+     * @param string $lstring
+     */
     public function LociString($lstring, &$count) {
             // Loci strings are UTF-8 or UTF-16 and null (x00/x0000) terminated. UTF-16 has a BOM
             // Also need to return the number of bytes the string occupied so additional fields can be extracted
@@ -2598,6 +2611,9 @@ 
             }
         }
 
+	/**
+	 * @param string $nullterminatedstring
+	 */
 	public function NoNullString($nullterminatedstring) {
 		// remove the single null terminator on null terminated strings
 		if (substr($nullterminatedstring, strlen($nullterminatedstring) - 1, 1) === "\x00") {
@@ -2606,6 +2622,9 @@ 
 		return $nullterminatedstring;
 	}
 
+	/**
+	 * @param string $pascalstring
+	 */
 	public function Pascal2String($pascalstring) {
 		// Pascal strings have 1 unsigned byte at the beginning saying how many chars (1-255) are in the string
 		return substr($pascalstring, 1);
@@ -2616,6 +2635,10 @@ 
 	// helper functions for m4b audiobook chapters
 	// code by Steffen Hartmann 2015-Nov-08
 	*/
+
+	/**
+	 * @param string $tag
+	 */
 	public function search_tag_by_key($info, $tag, $history, &$result) {
 		foreach ($info as $key => $value) {
 			$key_history = $history.'/'.$key;
@@ -2629,6 +2652,10 @@ 
 		}
 	}
 
+	/**
+	 * @param string $k
+	 * @param string $v
+	 */
 	public function search_tag_by_pair($info, $k, $v, $history, &$result) {
 		foreach ($info as $key => $value) {
 			$key_history = $history.'/'.$key;