WideImage

# Class: WideImage Source Location: /WideImage.php
### Class Overview
The gateway class for loading images and core library functions | ### Variables $path | ### Constants SIDE_ALL SIDE_BOTTOM SIDE_BOTTOM_LEFT SIDE_BOTTOM_RIGHT SIDE_LEFT SIDE_RIGHT SIDE_TOP SIDE_TOP_LEFT SIDE_TOP_RIGHT | ### Methods assertValidImageHandle checkGD createPaletteImage createTrueColorImage isValidImageHandle load loadFromFile loadFromHandle loadFromString loadFromUpload path registerCustomMapper version
### Class Details [line 62] The gateway class for loading images and core library functions [ Top ] ### Class Variables #### static $path = null [line 77] #### Tags:
var: | Path to the library base directory
access: | protected
Type: | string
[ Top ] ### Class Methods ### static method assertValidImageHandle [line 366]
`static void assertValidImageHandle( mixed $handle)`
Throws exception if the handle isn't a valid GD resource #### Parameters:
mixed | $handle | The variable to check
[ Top ] ### static method checkGD [line 102]
`static void checkGD( )`
Checks whether the gd library is loaded, and throws an exception otherwise [ Top ] ### static method createPaletteImage [line 333]
`static WideImage_PaletteImage createPaletteImage( int $width, int $height)`
Factory method for creating a palette image #### Parameters:
int | $width |
int | $height |
[ Top ] ### static method createTrueColorImage [line 345]
`static WideImage_TrueColorImage createTrueColorImage( int $width, int $height)`
Factory method for creating a true-color image #### Parameters:
int | $width |
int | $height |
[ Top ] ### static method isValidImageHandle [line 356]
`static bool isValidImageHandle( mixed $handle)`
Check whether the given handle is a valid GD resource #### Parameters:
mixed | $handle | The variable to check
[ Top ] ### static method load [line 150]
`static WideImage_Image load( mixed $source)`
Loads an image from a file, URL, HTML input file field, binary string, or a valid image handle. The image format is auto-detected. Currently supported formats: PNG, GIF, JPG, BMP, TGA, GD, GD2. This function analyzes the input and decides whether to use WideImage::loadFromHandle(), WideImage::loadFromFile(), WideImage::loadFromUpload() or WideImage::loadFromString(), all of which you can also call directly to spare WideImage some guessing. Arrays are supported for upload fields; it returns an array of loaded images. To load only a single image from an array field, use WideImage::loadFromUpload('img', $i), where $i is the index of the image you want to load. $img = WideImage::load('http://url/image.png'); // image URL $img = WideImage::load('/path/to/image.png'); // local file path $img = WideImage::load('img'); // upload field name $img = WideImage::load(imagecreatetruecolor(10, 10)); // a GD resource $img = WideImage::load($image_data); // binary string containing image data #### Tags:
return: | WideImage_PaletteImage or WideImage_TrueColorImage instance
#### Parameters:
mixed | $source | File name, url, HTML file input field name, binary string, or a GD image resource
[ Top ] ### static method loadFromFile [line 193]
`static WideImage_Image loadFromFile( string $uri)`
Create and load an image from a file or URL. The image format is auto-detected. #### Tags:
return: | WideImage_PaletteImage or WideImage_TrueColorImage instance
#### Parameters:
string | $uri | File or url
[ Top ] ### static method loadFromHandle [line 279]
`static WideImage_Image loadFromHandle( resource $handle)`
Create and load an image from an image handle. Note: the resulting image object takes ownership of the passed handle. When the newly-created image object is destroyed, the handle is destroyed too, so it's not a valid image handle anymore. In order to preserve the handle for use after object destruction, you have to call WideImage_Image::releaseHandle() on the created image instance prior to its destruction. $handle = imagecreatefrompng('file.png'); $image = WideImage::loadFromHandle($handle); #### Tags:
return: | WideImage_PaletteImage or WideImage_TrueColorImage instance
#### Parameters:
resource | $handle | A valid GD image resource
[ Top ] ### static method loadFromString [line 237]
`static WideImage_Image loadFromString( string $string)`
Create and load an image from a string. Format is auto-detected. #### Tags:
return: | WideImage_PaletteImage or WideImage_TrueColorImage instance
#### Parameters:
string | $string | Binary data, i.e. from BLOB field in the database
[ Top ] ### static method loadFromUpload [line 301]
`static WideImage_Image loadFromUpload( $field_name $field_name, [int $index = null])`
This method loads a file from the $_FILES array. The image format is auto-detected. You only have to pass the field name as the parameter. For array fields, this function will return an array of image objects, unless you specify the $index parameter, which will load the desired image. #### Tags:
return: | The loaded image
#### Parameters:
int | $index | The index of the file to load (if the input field is an array)
$field_name | $field_name | Name of the key in $_FILES array
[ Top ] ### static method path [line 92]
`static string path( )`
Returns the path to the library [ Top ] ### static method registerCustomMapper [line 120]
`static void registerCustomMapper( string $mapper_class_name, string $mime_type, string $extension)`
Registers a custom mapper for image loading and saving Example: WideImage::registerCustomMapper('WideImage_Mapper_TGA', 'image/tga', 'tga'); #### Parameters:
string | $mapper_class_name |
string | $mime_type |
string | $extension |
[ Top ] ### static method version [line 83]
`static string version( )`
Returns the library version #### Tags:
return: | The library version
[ Top ] ### Class Constants #### SIDE_ALL = 255 [line 72] [ Top ] #### SIDE_BOTTOM = 32 [line 69] [ Top ] #### SIDE_BOTTOM_LEFT = 64 [line 70] [ Top ] #### SIDE_BOTTOM_RIGHT = 16 [line 68] [ Top ] #### SIDE_LEFT = 128 [line 71] [ Top ] #### SIDE_RIGHT = 8 [line 67] [ Top ] #### SIDE_TOP = 2 [line 65] [ Top ] #### SIDE_TOP_LEFT = 1 [line 64] [ Top ] #### SIDE_TOP_RIGHT = 4 [line 66] [ Top ] Documentation generated on Sat, 19 Feb 2011 12:55:43 +0100 by phpDocumentor 1.4.3