Docs For Class Image

addBorder [line 962]

void addBorder(
)

Overridden in child classes as:

Image_Transform_Driver_GD::addBorder(): Adds a border of constant width around an image

[ Top ]

addDropShadow [line 956]

void addDropShadow(
)

[ Top ]

addText [line 950]

void addText(
)

Overridden in child classes as:

Image_Transform_Driver_Imagick::addText(): addText

Image_Transform_Driver_GD::addText(): addText

Image_Transform_Driver_NetPBM::addText(): adds text to an image

Image_Transform_Driver_Imlib::addText(): Adds text to the image. Note that the angle should be one of the following constants: IMLIB_TEXT_TO_RIGHT, IMLIB_TEXT_TO_LEFT, IMLIB_TEXT_TO_DOWN, IMLIB_TEXT_TO_UP, IMLIB_TEXT_TO_ANGLE

Image_Transform_Driver_IM::addText(): addText

Image_Transform_Driver_Imagick2::addText(): addText

[ Top ]

canvasResize [line 985]

void canvasResize(
)

[ Top ]

colorarray2colorhex [line 907]

mixed colorarray2colorhex(
array
$color)

Converts an array of RGB value into a #FFFFFF format color.

Return: A color following the #FFFFFF format or FALSE if the array couldn't be converted
See: Image_Transform::colorhex2colorarray()
See: rgb2colorname
Access: public

Parameters:

array $color — 3-element array with 0-255 values

[ Top ]

colorhex2colorarray [line 880]

array colorhex2colorarray(
string
$colorhex)

Converts a color string into an array of RGB values

Return: 3-element array with 0-255 values
See: Image_Transform::colorarray2colorhex()
See: rgb2colorname
Access: public

Parameters:

string $colorhex — A color following the #FFFFFF format

[ Top ]

crop [line 979]

mixed crop(
int
$width, int
$height, [int
$x = 0], [int
$y = 0])

Crops an image

Return: TRUE or a PEAR_Error object on error
Access: public

Overridden in child classes as:

Image_Transform_Driver_GD::crop(): Crops image by size and start coordinates

Image_Transform_Driver_NetPBM::crop(): Crop an image

Image_Transform_Driver_Imlib::crop(): Crops the current image to a specified height and width

Image_Transform_Driver_IM::crop(): Crop image

Image_Transform_Driver_Imagick2::crop(): Crops the image

Parameters:

int	`$width`	—	width Cropped image width
int	`$height`	—	height Cropped image height
int	`$x`	—	x X-coordinate to crop at
int	`$y`	—	y Y-coordinate to crop at

[ Top ]

display [line 822]

PEAR_error display(
string
$type, [mixed
$quality = null])

Outputs the image to standard output

Place holder for the real display method used by extended methods to do the resizing

Access: public

Overridden in child classes as:

Image_Transform_Driver_Imagick::display(): Display image without saving and lose changes

Image_Transform_Driver_GD::display(): Displays image without saving and lose changes.

Image_Transform_Driver_NetPBM::display(): Display image without saving and lose changes

Image_Transform_Driver_Imlib::display(): Display image without saving and lose changes

Image_Transform_Driver_IM::display(): Display image without saving and lose changes

Image_Transform_Driver_Imagick2::display(): Displays image without saving and lose changes

Parameters:

string	`$type`	—	Format of image to save as
mixed	`$quality`	—	Format-dependent

[ Top ]

factory [line 199]

object an &factory(
string
$driver)

Creates a new Image_Transform object

Return: Image_Transform object, or PEAR_Error on error
See: Image_Transform::setOption()
See: PEAR::isError()

Parameters:

string $driver — name of driver class to initialize. If no driver is specified the factory will attempt to use 'Imagick' first then 'GD' second, then 'Imlib' last

[ Top ]

fit [line 408]

bool|PEAR_Error fit(

$width, 
$height)

Fits the image in the specified box size

If the image is bigger than the box specified by $width and $height, it will be scaled down to fit inside of it. If the image is smaller, nothing is done.

Return: TRUE or PEAR_Error object on error
Access: public

Parameters:

	`$width`	—
	`$height`	—

[ Top ]

flip [line 1038]

TRUE flip(
)

Vertical mirroring

Return: or PEAR Error object on error
See: Image_Transform::mirror()
Access: public

Overridden in child classes as:

Image_Transform_Driver_GD::flip(): Vertical mirroring

Image_Transform_Driver_NetPBM::flip(): Vertical mirroring

Image_Transform_Driver_Imlib::flip(): Vertical mirroring

Image_Transform_Driver_IM::flip(): Vertical mirroring

Image_Transform_Driver_Imagick2::flip(): Vertical mirroring

[ Top ]

free [line 865]

PEAR_error free(
)

Releases resource

Place holder for the real free method used by extended methods to do the resizing

Access: public

Overridden in child classes as:

Image_Transform_Driver_Imagick::free(): Destroy image handle

Image_Transform_Driver_GD::free(): Destroys image handle

Image_Transform_Driver_NetPBM::free(): Destroy image handle

Image_Transform_Driver_Imlib::free(): Destroy image handle

Image_Transform_Driver_IM::free(): Destroy image handle

Image_Transform_Driver_Imagick2::free(): Destroy image handle

[ Top ]

gamma [line 998]

mixed gamma(
[float
$outputgamma = 1.0])

Corrects the gamma of an image

Return: TRUE or a PEAR_error object on error
Access: public

Overridden in child classes as:

Image_Transform_Driver_GD::gamma(): Adjusts the image gamma

Image_Transform_Driver_NetPBM::gamma(): Adjust the image gamma

Image_Transform_Driver_IM::gamma(): Adjust the image gamma

Image_Transform_Driver_Imagick2::gamma(): Adjusts the image gamma

Parameters:

float $outputgamma — Gamma correction factor

[ Top ]

getImageHeight [line 722]

int getImageHeight(
)

Returns the image height

Return: the width of the image
Access: public

[ Top ]

getImageSize [line 735]

array getImageSize(
)

Returns the image size and extra format information

Return: The width and height of the image
See: PHP::getimagesize()
Access: public

[ Top ]

getImageType [line 685]

string getImageType(
)

Returns the type of the image being manipulated

Return: the image type
Access: public

[ Top ]

getImageWidth [line 710]

int getImageWidth(
)

Returns the image width

Return: the width of the image
Access: public

[ Top ]

getMimeType [line 699]

string getMimeType(
[string
$type = null])

Returns the MIME type of the image being manipulated

Return: The MIME type if available, or an empty string
See: PHP_Compat::image_type_to_mime_type()
Link: http://php.net/image_type_to_mime_type
Access: public

Parameters:

string $type — Image type to get MIME type for

[ Top ]

getTempDir [line 925]

string getTempDir(
)

Returns the temp directory according to either the TMP, TMPDIR, or TEMP env variables. If these are not set it will also check for the existence of /tmp, %WINDIR%\temp

Return: The system tmp directory
Access: public

[ Top ]

getTempFile [line 938]

string getTempFile(
[string
$dirname = NULL])

Returns a temporary filename using tempnam() and the above getTmpDir() function.

Return: Filename and path of the tmp file
Access: public

Parameters:

string $dirname — Optional directory name for the tmp file

[ Top ]

getWebSafeFormat [line 754]

string getWebSafeFormat(
)

This looks at the current image type and attempts to determine which

web-safe format will be most suited. It does not work brilliantly with *.png images, because it is very difficult to know whether they are 8-bit or greater. Guess I need to have fatter code here :-)

Return: web-safe image type
Access: public

[ Top ]

grayscale [line 1059]

void grayscale(
)

See: Image_Transform::greyscale()

[ Top ]

greyscale [line 1050]

mixed greyscale(
)

Converts an image into greyscale colors

Return: TRUE or a PEAR error object on error
Access: public

Overridden in child classes as:

Image_Transform_Driver_GD::greyscale(): Converts the image to greyscale

Image_Transform_Driver_NetPBM::greyscale(): Converts an image into greyscale colors

Image_Transform_Driver_IM::greyscale(): Convert the image to greyscale

[ Top ]

isError [line 240]

mixed &isError(
[object PEAR_Error
$error = null])

Returns/sets an error when the instance couldn't initialize properly

Return: FALSE or PEAR_Error object
Access: protected

Parameters:

object PEAR_Error $error — object when setting an error

[ Top ]

keepSettingsOnSave [line 943]

void keepSettingsOnSave(

$bool)

Parameters:

$bool —

[ Top ]

load [line 806]

PEAR_error load(

$filename)

Loads an image file to work with

Place holder for the real load method used by extended methods to do the resizing

Access: public

Overridden in child classes as:

Image_Transform_Driver_Imagick::load(): Load image

Image_Transform_Driver_GD::load(): Loads an image from file

Image_Transform_Driver_NetPBM::load(): Load image

Image_Transform_Driver_Imlib::load(): Load image

Image_Transform_Driver_IM::load(): Load an image.

Image_Transform_Driver_Imagick2::load(): Loads an image

Parameters:

$filename —

[ Top ]

mirror [line 1025]

mixed mirror(
)

Horizontal mirroring

Return: TRUE or PEAR_Error object on error
See: Image_Transform::flip()
Access: public

Overridden in child classes as:

Image_Transform_Driver_GD::mirror(): Horizontal mirroring

Image_Transform_Driver_NetPBM::mirror(): Horizontal mirroring

Image_Transform_Driver_Imlib::mirror(): Horizontal mirroring

Image_Transform_Driver_IM::mirror(): Horizontal mirroring

Image_Transform_Driver_Imagick2::mirror(): Horizontal mirroring

[ Top ]

resize [line 259]

mixed resize(
[mixed
$new_x = 0], [mixed
$new_y = 0], [array
$options = null])

Resizes the image in the X and/or Y direction(s)

If either is 0 it will keep the original size for that dimension

Return: TRUE or PEAR_Error object on error
Access: public

Parameters:

mixed	`$new_x`	—	(0, number, percentage 10% or 0.1)
mixed	`$new_y`	—	(0, number, percentage 10% or 0.1)
array	`$options`	—	Options

[ Top ]

rotate [line 1012]

bool|PEAR_Error rotate(
float
$angle, [mixed
$options = null])

Rotates the image clockwise

Return: TRUE on success, PEAR_Error object on error
Access: public

Overridden in child classes as:

Image_Transform_Driver_Imagick::rotate(): rotate Note: color mask are currently not supported

Image_Transform_Driver_GD::rotate(): Rotates image by the given angle

Image_Transform_Driver_GD1::rotate()

Image_Transform_Driver_NetPBM::rotate(): Rotates the image

Image_Transform_Driver_Imlib::rotate(): Rotate image by the given angle

Image_Transform_Driver_IM::rotate(): rotate

Image_Transform_Driver_Imagick2::rotate(): Rotates the current image Note: color mask are currently not supported

Parameters:

float	`$angle`	—	angle of rotation in degres
mixed	`$options`	—

[ Top ]

save [line 851]

PEAR_error save(
string
$filename, string
$type, [mixed
$quality = null])

Saves image to file

Place holder for the real save method used by extended methods to do the resizing

Access: public

Overridden in child classes as:

Image_Transform_Driver_Imagick::save(): Save the image file

Image_Transform_Driver_GD::save(): Saves the image to a file

Image_Transform_Driver_NetPBM::save(): Save the image file

Image_Transform_Driver_Imlib::save(): Save the image file. Determines what type of image to save based on extension.

Image_Transform_Driver_IM::save(): Save the image file

Image_Transform_Driver_Imagick2::save(): Saves the image to a file

Parameters:

string	`$filename`	—	Filename to save image to
string	`$type`	—	Format of image to save as
mixed	`$quality`	—	Format-dependent

[ Top ]

scale [line 324]

mixed scale(
mixed
$size)

Scales an image by a percentage, factor or a given length

This method preserves the aspect ratio

Return: TRUE or PEAR_Error object on error
See: Image_Transform::scaleByPercentage(), Image_Transform::scaleByFactor(), Image_Transform::scaleByLength()
Access: public

Parameters:

mixed $size — (number, percentage 10% or 0.1)

[ Top ]

scaleByFactor [line 358]

mixed scaleByFactor(
float
$size)

Scales an image to a factor of its original size. For example, if my image was 640x480 and I called scaleByFactor(0.5) then the image would be resized to 320x240.

Return: TRUE or PEAR_Error object on error
Access: public

Parameters:

float $size — Factor of original size to scale to

[ Top ]

scaleByLength [line 393]

mixed scaleByLength(

$size)

Alias for scaleMaxLength

Return: TRUE or PEAR_Error object on error
See: Image_Transform::scaleMaxLength()
Access: public

Parameters:

$size —

[ Top ]

scaleByPercentage [line 344]

mixed scaleByPercentage(
int
$size)

Scales an image to a percentage of its original size. For example, if my image was 640x480 and I called scaleByPercentage(10) then the image would be resized to 64x48

Return: TRUE or PEAR_Error object on error
Access: public

Parameters:

int $size — Percentage of original size to scale to

[ Top ]

scaleByX [line 283]

mixed scaleByX(
int
$new_x)

Scales the image to the specified width

This method preserves the aspect ratio

Return: TRUE or PEAR_Error object on error
Access: public

Parameters:

int $new_x — Size to scale X-dimension to

[ Top ]

scaleByXY [line 294]

void scaleByXY(
[
$new_x = 0], [
$new_y = 0], [
$options = null])

Alias for resize()

See: Image_Transform::resize()

Parameters:

	`$new_x`	—
	`$new_y`	—
	`$options`	—

[ Top ]

scaleByY [line 308]

mixed scaleByY(
int
$new_y)

Scales the image to the specified height.

This method preserves the aspect ratio

Return: TRUE or PEAR_Error object on error
Access: public

Parameters:

int $new_y — Size to scale Y-dimension to

[ Top ]

scaleMaxLength [line 374]

mixed scaleMaxLength(
int
$size)

Scales an image so that the longest side has the specified dimension.

This method preserves the aspect ratio

Return: TRUE or PEAR_Error object on error
Access: public

Parameters:

int $size — Max dimension in pixels

[ Top ]

setOption [line 433]

void setOption(
string
$name, mixed
$value)

Sets one options

See: Image_Transform::setOptions()
Access: public

Parameters:

string	`$name`	—	Name of option
mixed	`$value`	—	Value of option

[ Top ]

setOptions [line 448]

void setOptions(
array
$options)

Sets multiple options at once

Associative array of options:

quality (Integer: 0: poor - 100: best)
scaleMethod ('smooth', 'pixel')

Access: public

Parameters:

array $options — Array of options

[ Top ]

supportsType [line 835]

TRUE supportsType(
string
$type, [string
$mode = 'rw'])

Returns if the driver supports a given image type

Return: if type (and mode) is supported FALSE otherwise
Access: public

Parameters:

string	`$type`	—	Image type (GIF, PNG, JPEG...)
string	`$mode`	—	'r' for read, 'w' for write, 'rw' for both

[ Top ]

_convert_image_type [line 539]

mixed _convert_image_type(
mixed
$type)

Returns the matching IMAGETYPE_* constant for a given image type

Return: string or integer or input on error
See: PHP_Compat::image_type_to_mime_type()
Access: protected

Parameters:

mixed $type — String (GIF, JPG,...)

[ Top ]

_getColor [line 1073]

array _getColor(
string
$colorOf, [array
$options = array()], [array
$default = array(0, 0, 0)])

Returns a color option

Return: an RGB color array
Access: protected

Parameters:

string	`$colorOf`	—	one of 'canvasColor', 'pencilColor', 'fontColor'
array	`$options`	—
array	`$default`	—	default value to return if color not found

[ Top ]

_getOption [line 1100]

mixed _getOption(
string
$name, [array
$options = array()], [mixed
$default = null])

Returns an option

Return: the option
Access: protected

Parameters:

string	`$name`	—	name of option
array	`$options`	—	local override option array
mixed	`$default`	—	default value to return if option is not found

[ Top ]

_get_default_text_params [line 626]

array _get_default_text_params(
)

Returns the current value of $this->default_text_params.

Return: The current text parameters
Access: protected

[ Top ]

_get_image_details [line 461]

mixed _get_image_details(

$image)

Sets the image type (in lowercase letters), the image height and width.

Return: TRUE or PEAR_error
See: PHP_Compat::image_type_to_mime_type()
Link: http://php.net/getimagesize
Access: protected

Parameters:

$image —

[ Top ]

_parse_size [line 592]

mixed _parse_size(
mixed
$new_size, int
$old_size)

Parses input for number format and convert

If either parameter is 0 it will be scaled proportionally

Return: Integer or PEAR_error
Access: protected

Parameters:

mixed	`$new_size`	—	(0, number, percentage 10% or 0.1)
int	`$old_size`	—

[ Top ]

_prepare_cmd [line 775]

string _prepare_cmd(
string
$path, string
$command, [string
$args = ''])

Handles space in path and Windows/UNIX difference

Return: A prepared string suitable for exec()
Access: protected

Parameters:

string	`$path`	—	Base dir
string	`$command`	—	Command to execute
string	`$args`	—	Arguments to pass to the command

[ Top ]

_resize [line 791]

PEAR_error _resize(
)

Place holder for the real resize method used by extended methods to do the resizing

Access: protected

Overridden in child classes as:

Image_Transform_Driver_GD::_resize(): Resize Action

Image_Transform_Driver_Imagick2::_resize(): Resize Action

[ Top ]

_rotation_angle [line 614]

float _rotation_angle(
float
$angle)

Returns an angle between 0 and 360 from any angle value

Return: the angle
Access: protected

Parameters:

float $angle — The angle to normalize

[ Top ]

_set_img_x [line 638]

void _set_img_x(
int
$size)

Sets the image width

Since: 29/05/02 13:36:31
Access: protected

Parameters:

int $size — dimension to set

[ Top ]

_set_img_y [line 650]

void _set_img_y(
int
$size)

Sets the image height

Since: 29/05/02 13:36:31
Access: protected

Parameters:

int $size — dimension to set

[ Top ]

_set_new_x [line 662]

void _set_new_x(
int
$size)

Sets the new image width

Since: 29/05/02 13:36:31
Access: protected

Parameters:

int $size — dimension to set

[ Top ]

_set_new_y [line 674]

void _set_new_y(
int
$size)

Sets the new image height

Since: 29/05/02 13:36:31
Access: protected

Parameters:

int $size — dimension to set

[ Top ]

Class: Image_Transform

Class Overview

Author(s):

Version:

Copyright:

Variables

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Class Variables

$default_text_params = array('text' => 'Default text', 'x' => 10, 'y' => 20, 'color' => 'red', 'font' => 'Arial.ttf', 'size' => '12', 'angle' => 0, 'resize_first' => false)

$image = ''

$img_x = ''

$img_y = ''

$keep_settings_on_save = false

$lib_path = ''

$new_x = ''

$new_y = ''

$resized = false

$type = ''

$_options = array( 'quality' => 75, 'scaleMethod' => 'smooth', 'canvasColor' => array(255, 255, 255),'pencilColor'=>array(0,0,0),'textColor'=>array(0,0,0))

$_programs = array()

$_supported_image_types = array()

Method Detail

addBorder [line 962]

addDropShadow [line 956]

addText [line 950]

canvasResize [line 985]

colorarray2colorhex [line 907]

Parameters:

colorhex2colorarray [line 880]

Parameters:

crop [line 979]

Parameters:

display [line 822]

Parameters:

factory [line 199]

Parameters:

fit [line 408]

Parameters:

flip [line 1038]

free [line 865]

gamma [line 998]

Parameters:

getImageHeight [line 722]

getImageSize [line 735]

getImageType [line 685]

getImageWidth [line 710]

getMimeType [line 699]

Parameters:

getTempDir [line 925]

getTempFile [line 938]

Parameters:

getWebSafeFormat [line 754]

grayscale [line 1059]

greyscale [line 1050]

isError [line 240]

Parameters:

keepSettingsOnSave [line 943]

Parameters:

load [line 806]

Parameters:

mirror [line 1025]

resize [line 259]

Parameters:

rotate [line 1012]

Parameters:

save [line 851]

Parameters:

scale [line 324]

Parameters:

scaleByFactor [line 358]

Parameters:

scaleByLength [line 393]

Parameters:

scaleByPercentage [line 344]

Parameters:

scaleByX [line 283]

$default_text_params = array('text' => 'Default text',
'x' => 10,
'y' => 20,
'color' => 'red',
'font' => 'Arial.ttf',
'size' => '12',
'angle' => 0,
'resize_first' => false)

$_options = array(
'quality' => 75,
'scaleMethod' => 'smooth',
'canvasColor' => array(255, 255, 255),'pencilColor'=>array(0,0,0),'textColor'=>array(0,0,0))