2 # Class to represent an image
3 # Provides methods to retrieve paths (physical, logical, URL),
4 # to generate thumbnails or for uploading.
9 var $name, # name of the image
10 $imagePath, # Path of the image
12 $title, # Title object for this image. Initialized when needed.
13 $fileExists, # does the image file exist on disk?
14 $historyLine, # Number of line to return by nextHistoryLine()
15 $historyRes, # result of the query for the image's history
17 $height, # --- returned by getimagesize, see http://de3.php.net/manual/en/function.getimagesize.php
23 function Image( $name )
25 global $wgUploadDirectory;
28 $this->title
= Title
::makeTitle( Namespace::getImage(), $this->name
);
29 //$this->imagePath = wfImagePath( $name );
30 $hash = md5( $this->title
->getDBkey() );
31 $this->imagePath
= $wgUploadDirectory . "/" . $hash{0} . "/" .substr( $hash, 0, 2 ) . "/{$name}";
33 $this->url
= $this->wfImageUrl( $name );
35 if ( $this->fileExists
= file_exists( $this->imagePath
) ) // Sic!, "=" is intended
37 list($this->width
, $this->height
, $this->type
, $this->attr
) = getimagesize( $this->imagePath
);
39 $this->historyLine
= 0;
42 function newFromTitle( $nt )
44 $img = new Image( $nt->getDBKey() );
59 function getImagePath()
61 return $this->imagePath
;
79 function getEscapeLocalURL()
81 return $this->title
->escapeLocalURL();
84 function wfImageUrl( $name )
89 $url = "{$wgUploadPath}/" . $hash{0} . "/" .
90 substr( $hash, 0, 2 ) . "/{$name}";
91 return wfUrlencode( $url );
97 return $this->fileExists
;
100 function thumbUrl( $width, $subdir="thumb" ) {
101 global $wgUploadPath;
103 $name = $this->thumbName( $width );
104 $hash = md5( $name );
105 $url = "{$wgUploadPath}/{$subdir}/" . $hash{0} . "/" . substr( $hash, 0, 2 ) . "/{$name}";
107 return wfUrlencode($url);
110 function thumbName( $width ) {
111 return $width."px-".$this->name
;
114 //**********************************************************************
115 // Create a thumbnail of the image having the specified width.
116 // The thumbnail will not be created if the width is larger than the
117 // image's width. Let the browser do the scaling in this case.
118 // The thumbnail is stored on disk and is only computed if the thumbnail
119 // file does not exist OR if it is older than the image.
120 function createThumb( $width ) {
121 global $wgUploadDirectory;
122 global $wgImageMagickConvertCommand;
123 global $wgUseImageMagick;
124 global $wgUseSquid, $wgInternalServer;
126 $width = IntVal( $width );
128 $thumbName = $this->thumbName( $width );
129 $thumbPath = wfImageThumbDir( $thumbName )."/".$thumbName;
130 $thumbUrl = $this->thumbUrl( $width );
132 if ( ! $this->exists() )
134 # If there is no image, there will be no thumbnail
138 # Sanity check $width
144 if( $width > $this->width
) {
145 # Don't make an image bigger than the source
146 return $this->getURL();
149 if ( (! file_exists( $thumbPath ) )
150 ||
( filemtime($thumbPath) < filemtime($this->imagePath
) ) ) {
154 $wgInternalServer.$thumbUrl
156 wfPurgeSquidServers($urlArr);
159 if ( $wgUseImageMagick ) {
161 $cmd = $wgImageMagickConvertCommand .
162 " -quality 85 -geometry {$width} ".
163 escapeshellarg($this->imagePath
) . " " .
164 escapeshellarg($thumbPath);
165 $conv = shell_exec( $cmd );
167 # Use PHP's builtin GD library functions.
169 # First find out what kind of file this is, and select the correct
170 # input routine for this.
172 switch( $this->type
) {
174 $src_image = imagecreatefromgif( $this->imagePath
);
177 $src_image = imagecreatefromjpeg( $this->imagePath
);
180 $src_image = imagecreatefrompng( $this->imagePath
);
182 case 15: # WBMP for WML
183 $src_image = imagecreatefromwbmp( $this->imagePath
);
186 $src_image = imagecreatefromxbm( $this->imagePath
);
189 return "Image type not supported";
192 $height = floor( $this->height
* ( $width/$this->width
) );
193 $dst_image = imagecreatetruecolor( $width, $height );
194 imagecopyresampled( $dst_image, $src_image,
196 $width, $height, $this->width
, $this->height
);
197 switch( $this->type
) {
202 #$thumbUrl .= ".png";
203 #$thumbPath .= ".png";
204 imagepng( $dst_image, $thumbPath );
207 #$thumbUrl .= ".jpg";
208 #$thumbPath .= ".jpg";
209 imageinterlace( $dst_image );
210 imagejpeg( $dst_image, $thumbPath, 95 );
215 imagedestroy( $dst_image );
216 imagedestroy( $src_image );
221 # Check for zero-sized thumbnails. Those can be generated when
222 # no disk space is available or some other error occurs
224 $thumbstat = stat( $thumbPath );
225 if( $thumbstat["size"] == 0 )
227 unlink( $thumbPath );
232 } // END OF function createThumb
234 //**********************************************************************
235 // Return the image history of this image, line by line.
236 // start with current version, than old versions.
237 // use $this->historyLine to check which line to return:
238 // 0 return line for current version
239 // 1 query for old versions, return first one
240 // 2, ... return next old version from above query
241 function nextHistoryLine()
243 $fname = "Image::nextHistoryLine()";
245 if ( $this->historyLine
== 0 ) // called for the first time, return line from cur
247 $sql = "SELECT img_size,img_description,img_user," .
248 "img_user_text,img_timestamp, '' AS oi_archive_name FROM image WHERE " .
249 "img_name='" . wfStrencode( $this->title
->getDBkey() ) . "'";
250 $this->historyRes
= wfQuery( $sql, DB_READ
, $fname );
252 if ( 0 == wfNumRows( $this->historyRes
) ) { return FALSE; }
254 } else if ( $this->historyLine
== 1 )
256 $sql = "SELECT oi_size AS img_size, oi_description AS img_description," .
257 "oi_user AS img_user," .
258 "oi_user_text AS img_user_text, oi_timestamp AS img_timestamp , oi_archive_name FROM oldimage WHERE " .
259 "oi_name='" . wfStrencode( $this->title
->getDBkey() ) . "' " .
260 "ORDER BY oi_timestamp DESC";
261 $this->historyRes
= wfQuery( $sql, DB_READ
, $fname );
263 $this->historyLine ++
;
265 return wfFetchObject( $this->historyRes
);
268 function resetHistory()
270 $this->historyLine
= 0;