getimagesize
(PHP 3, PHP 4 )
getimagesize -- Get the size of an image
Description
array getimagesize ( string filename [, array imageinfo])
The getimagesize() function will determine the size of any
GIF, JPG, PNG, SWF, SWC, PSD, TIFF, BMP, IFF, JP2, JPX,
JB2, JPC, XBM, or WBMP image file and return the dimensions
along with the file type and a height/width text string
to be used inside a normal HTML IMG tag.
Note: Support for JPC, JP2, JPX, JB2, XBM, and WBMP became
available in PHP 4.3.2. Support for SWC as of PHP 4.3.0.
Returns an array with 4 elements. Index 0 contains the
width of the image in pixels. Index 1 contains the height.
Index 2 is a flag indicating the type of the image: 1 =
GIF, 2 = JPG, 3 = PNG, 4 = SWF, 5 = PSD, 6 = BMP, 7 = TIFF(intel
byte order), 8 = TIFF(motorola byte order), 9 = JPC, 10
= JP2, 11 = JPX, 12 = JB2, 13 = SWC, 14 = IFF, 15 = WBMP,
16 = XBM. These values correspond to the IMAGETYPE constants
that were added in PHP 4.3. Index 3 is a text string with
the correct height="yyy" width="xxx"
string that can be used directly in an IMG tag. Example
1. getimagesize (file)
<?php
list($width, $height, $type, $attr) = getimagesize("img/flag.jpg");
echo "<img src=\"img/flag.jpg\" $attr
alt=\"getimagesize() example\" />";
?>
Example 2. getimagesize (URL)
<?php
$size = getimagesize("http://www.example.com/gifs/logo.gif");
// if the file name has space in it, encode it properly
$size = getimagesize("http://www.example.com/gifs/lo%20go.gif");
?>
With JPG images, two extra indexes are returned: channels
and bits. channels will be 3 for RGB pictures and 4 for
CMYK pictures. bits is the number of bits for each color.
Beginning with PHP 4.3, bits and channels are present for
other image types, too. However, the presence of these values
can be a bit confusing. As an example, GIF always uses 3
channels per pixel, but the number of bits per pixel cannot
be calculated for an animated GIF with a global color table.
Some formats may contain no image or may contain multiple
images. In these cases, getimagesize() might not be able
to properly determine the image size. getimagesize() will
return zero for width and height in these cases.
Beginning with PHP 4.3, getimagesize() also returns an
additional parameter, mime, that corresponds with the MIME
type of the image. This information can be used to deliver
images with correct HTTP Content-type headers: