includes/ImageFunctions.php

   1 <?php
   2
   3 /**
   4  * Returns the image directory of an image
   5  * The result is an absolute path.
   6  *
   7  * This function is called from thumb.php before Setup.php is included
   8  *
   9  * @param $fname String: file name of the image file.
  10  * @public
  11  */
  12 function wfImageDir( $fname ) {
  13         global $wgUploadDirectory, $wgHashedUploadDirectory;
  14
  15         if (!$wgHashedUploadDirectory) { return $wgUploadDirectory; }
  16
  17         $hash = md5( $fname );
  18         $dest = $wgUploadDirectory . '/' . $hash{0} . '/' . substr( $hash, 0, 2 );
  19
  20         return $dest;
  21 }
  22
  23 /**
  24  * Returns the image directory of an image's thubnail
  25  * The result is an absolute path.
  26  *
  27  * This function is called from thumb.php before Setup.php is included
  28  *
  29  * @param $fname String: file name of the original image file
  30  * @param $shared Boolean: (optional) use the shared upload directory (default: 'false').
  31  * @public
  32  */
  33 function wfImageThumbDir( $fname, $shared = false ) {
  34         $base = wfImageArchiveDir( $fname, 'thumb', $shared );
  35         if ( Image::isHashed( $shared ) ) {
  36                 $dir =  "$base/$fname";
  37         } else {
  38                 $dir = $base;
  39         }
  40
  41         return $dir;
  42 }
  43
  44 /**
  45  * Old thumbnail directory, kept for conversion
  46  */
  47 function wfDeprecatedThumbDir( $thumbName , $subdir='thumb', $shared=false) {
  48         return wfImageArchiveDir( $thumbName, $subdir, $shared );
  49 }
  50
  51 /**
  52  * Returns the image directory of an image's old version
  53  * The result is an absolute path.
  54  *
  55  * This function is called from thumb.php before Setup.php is included
  56  *
  57  * @param $fname String: file name of the thumbnail file, including file size prefix.
  58  * @param $subdir String: subdirectory of the image upload directory that should be used for storing the old version. Default is 'archive'.
  59  * @param $shared Boolean use the shared upload directory (only relevant for other functions which call this one). Default is 'false'.
  60  * @public
  61  */
  62 function wfImageArchiveDir( $fname , $subdir='archive', $shared=false ) {
  63         global $wgUploadDirectory, $wgHashedUploadDirectory;
  64         global $wgSharedUploadDirectory, $wgHashedSharedUploadDirectory;
  65         $dir = $shared ? $wgSharedUploadDirectory : $wgUploadDirectory;
  66         $hashdir = $shared ? $wgHashedSharedUploadDirectory : $wgHashedUploadDirectory;
  67         if (!$hashdir) { return $dir.'/'.$subdir; }
  68         $hash = md5( $fname );
  69
  70         return $dir.'/'.$subdir.'/'.$hash[0].'/'.substr( $hash, 0, 2 );
  71 }
  72
  73
  74 /*
  75  * Return the hash path component of an image path (URL or filesystem),
  76  * e.g. "/3/3c/", or just "/" if hashing is not used.
  77  *
  78  * @param $dbkey The filesystem / database name of the file
  79  * @param $fromSharedDirectory Use the shared file repository? It may
  80  *   use different hash settings from the local one.
  81  */
  82 function wfGetHashPath ( $dbkey, $fromSharedDirectory = false ) {
  83         if( Image::isHashed( $fromSharedDirectory ) ) {
  84                 $hash = md5($dbkey);
  85                 return '/' . $hash{0} . '/' . substr( $hash, 0, 2 ) . '/';
  86         } else {
  87                 return '/';
  88         }
  89 }
  90
  91 /**
  92  * Returns the image URL of an image's old version
  93  *
  94  * @param $name String: file name of the image file
  95  * @param $subdir String: (optional) subdirectory of the image upload directory that is used by the old version. Default is 'archive'
  96  * @public
  97  */
  98 function wfImageArchiveUrl( $name, $subdir='archive' ) {
  99         global $wgUploadPath, $wgHashedUploadDirectory;
 100
 101         if ($wgHashedUploadDirectory) {
 102                 $hash = md5( substr( $name, 15) );
 103                 $url = $wgUploadPath.'/'.$subdir.'/' . $hash{0} . '/' .
 104                   substr( $hash, 0, 2 ) . '/'.$name;
 105         } else {
 106                 $url = $wgUploadPath.'/'.$subdir.'/'.$name;
 107         }
 108         return wfUrlencode($url);
 109 }
 110
 111 /**
 112  * Return a rounded pixel equivalent for a labeled CSS/SVG length.
 113  * http://www.w3.org/TR/SVG11/coords.html#UnitIdentifiers
 114  *
 115  * @param $length String: CSS/SVG length.
 116  * @return Integer: length in pixels
 117  */
 118 function wfScaleSVGUnit( $length ) {
 119         static $unitLength = array(
 120                 'px' => 1.0,
 121                 'pt' => 1.25,
 122                 'pc' => 15.0,
 123                 'mm' => 3.543307,
 124                 'cm' => 35.43307,
 125                 'in' => 90.0,
 126                 ''   => 1.0, // "User units" pixels by default
 127                 '%'  => 2.0, // Fake it!
 128                 );
 129         if( preg_match( '/^(\d+(?:\.\d+)?)(em|ex|px|pt|pc|cm|mm|in|%|)$/', $length, $matches ) ) {
 130                 $length = floatval( $matches[1] );
 131                 $unit = $matches[2];
 132                 return round( $length * $unitLength[$unit] );
 133         } else {
 134                 // Assume pixels
 135                 return round( floatval( $length ) );
 136         }
 137 }
 138
 139 /**
 140  * Compatible with PHP getimagesize()
 141  * @todo support gzipped SVGZ
 142  * @todo check XML more carefully
 143  * @todo sensible defaults
 144  *
 145  * @param $filename String: full name of the file (passed to php fopen()).
 146  * @return array
 147  */
 148 function wfGetSVGsize( $filename ) {
 149         $width = 256;
 150         $height = 256;
 151
 152         // Read a chunk of the file
 153         $f = fopen( $filename, "rt" );
 154         if( !$f ) return false;
 155         $chunk = fread( $f, 4096 );
 156         fclose( $f );
 157
 158         // Uber-crappy hack! Run through a real XML parser.
 159         if( !preg_match( '/<svg\s*([^>]*)\s*>/s', $chunk, $matches ) ) {
 160                 return false;
 161         }
 162         $tag = $matches[1];
 163         if( preg_match( '/\bwidth\s*=\s*("[^"]+"|\'[^\']+\')/s', $tag, $matches ) ) {
 164                 $width = wfScaleSVGUnit( trim( substr( $matches[1], 1, -1 ) ) );
 165         }
 166         if( preg_match( '/\bheight\s*=\s*("[^"]+"|\'[^\']+\')/s', $tag, $matches ) ) {
 167                 $height = wfScaleSVGUnit( trim( substr( $matches[1], 1, -1 ) ) );
 168         }
 169
 170         return array( $width, $height, 'SVG',
 171                 "width=\"$width\" height=\"$height\"" );
 172 }
 173
 174 /**
 175  * Determine if an image exists on the 'bad image list'.
 176  *
 177  * @param $name String: the image name to check
 178  * @return bool
 179  */
 180 function wfIsBadImage( $name ) {
 181         static $titleList = false;
 182         wfProfileIn( __METHOD__ );
 183         $bad = false;
 184         if( wfRunHooks( 'BadImage', array( $name, &$bad ) ) ) {
 185                 if( !$titleList ) {
 186                         # Build the list now
 187                         $titleList = array();
 188                         $lines = explode( "\n", wfMsgForContent( 'bad_image_list' ) );
 189                         foreach( $lines as $line ) {
 190                                 if( preg_match( '/^\*\s*\[\[:?(.*?)\]\]/i', $line, $matches ) ) {
 191                                         $title = Title::newFromText( $matches[1] );
 192                                         if( is_object( $title ) && $title->getNamespace() == NS_IMAGE )
 193                                                 $titleList[ $title->getDBkey() ] = true;
 194                                 }
 195                         }
 196                 }
 197                 wfProfileOut( __METHOD__ );
 198                 return array_key_exists( $name, $titleList );
 199         } else {
 200                 wfProfileOut( __METHOD__ );
 201                 return $bad;
 202         }
 203 }
 204
 205 /**
 206  * Calculate the largest thumbnail width for a given original file size
 207  * such that the thumbnail's height is at most $maxHeight.
 208  * @param $boxWidth Integer Width of the thumbnail box.
 209  * @param $boxHeight Integer Height of the thumbnail box.
 210  * @param $maxHeight Integer Maximum height expected for the thumbnail.
 211  * @return Integer.
 212  */
 213 function wfFitBoxWidth( $boxWidth, $boxHeight, $maxHeight ) {
 214         $idealWidth = $boxWidth * $maxHeight / $boxHeight;
 215         $roundedUp = ceil( $idealWidth );
 216         if( round( $roundedUp * $boxHeight / $boxWidth ) > $maxHeight )
 217                 return floor( $idealWidth );
 218         else
 219                 return $roundedUp;
 220 }
 221
 222
 223 ?>