eZImageGDHandler Class Reference

The class eZImageGDHandler does. More...

Inheritance diagram for eZImageGDHandler:

Collaboration diagram for eZImageGDHandler:

List of all members.

Public Member Functions
	calculateFixedHeightAspectGeometry ($sourceWidth, $sourceHeight, $destinationHeight, $allowUpScale)
	calculateFixedWidthAspectGeometry ($sourceWidth, $sourceHeight, $destinationWidth, $allowUpScale)
	calculateScaledAspectGeometry ($sourceWidth, $sourceHeight, $destinationWidth, $destinationHeight, $allowUpScale)
	calculateScaledPercentAspectGeometry ($sourceWidth, $sourceHeight, $destinationWidthPercent, $destinationHeightPercent, $allowUpScale)
	convert ($manager, $sourceMimeData, &$destinationMimeData, $filters=false)
	createImageBorder ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	cropImage ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	eZImageGDHandler ($handlerName, $isGloballyEnabled, $outputRewriteType=self::REPLACE_SUFFIX, $conversionRules=false)
	scaleImage ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	scaleImageDownOnly ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	scaleImageExact ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	scaleImageHeight ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	scaleImageHeightDownOnly ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	scaleImagePercent ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	scaleImageWidth ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	scaleImageWidthDownOnly ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	setImageBorder ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	setImageBorderWidth ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	setImageColorspaceGray ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	setImageColorThresholdName ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	setImageLuminance ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
	setImageLuminanceColorScale ($imageObject, $filterData, $sourceMimeData, $destinationMimeData, $colorScale)
	setImageLuminanceNamed ($imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
Static Public Member Functions
static	createFromINI ($iniGroup, $iniFilename=false)
static	createGeometry ($width, $height, $x=0, $y=0)
static	imageCopy ($imageObject, $destinationGeometry, $sourceGeometry, $sourceMimeData, $destinationMimeData)
static	imageCreate ($width, $height, $isTrueColor=true)
static	isImageTrueColor (&$imageObject, $mimeData)
static	scaleImageCopy ($imageObject, $geometry, $sourceMimeData, $destinationMimeData)
static	setImageBorderColor (&$imageObject, $filterData, &$filterVariables, $sourceMimeData, $destinationMimeData)
static	setImageColorThreshold ($imageObject, $filterData, $sourceMimeData, $destinationMimeData, $thresholdList)
Public Attributes
	$Executable
	$Path
	$PostParameters
	$PreParameters

---

Detailed Description

The class eZImageGDHandler does.

A geometry array has the following entries.

• x - The x position
• y - The y position
• width - The width
• height - The height

Definition at line 23 of file ezimagegdhandler.php.

---

Member Function Documentation

eZImageGDHandler::calculateFixedHeightAspectGeometry	(	$	sourceWidth,
		$	sourceHeight,
		$	destinationHeight,
		$	allowUpScale
	)

Calculates the geometry for the scaled image with a fixed height while maintaining the aspect ratio.

Parameters:

$allowUpScale

If this is true images will be scaled up as well, if not they will keep their source size.

Returns:

a geometry array.

See also:

createGeometry

Definition at line 605 of file ezimagegdhandler.php.

Referenced by scaleImageHeight(), and scaleImageHeightDownOnly().

eZImageGDHandler::calculateFixedWidthAspectGeometry	(	$	sourceWidth,
		$	sourceHeight,
		$	destinationWidth,
		$	allowUpScale
	)

Calculates the geometry for the scaled image with a fixed width while maintaining the aspect ratio.

Parameters:

$allowUpScale

If this is true images will be scaled up as well, if not they will keep their source size.

Returns:

a geometry array.

See also:

createGeometry

Definition at line 580 of file ezimagegdhandler.php.

Referenced by scaleImageWidth(), and scaleImageWidthDownOnly().

eZImageGDHandler::calculateScaledAspectGeometry	(	$	sourceWidth,
		$	sourceHeight,
		$	destinationWidth,
		$	destinationHeight,
		$	allowUpScale
	)

Calculates the geometry for the scaled image while maintaining the aspect ratio.

Parameters:

$allowUpScale

If this is true images will be scaled up as well, if not they will keep their source size.

Returns:

a geometry array.

See also:

createGeometry

Definition at line 532 of file ezimagegdhandler.php.

Referenced by calculateScaledPercentAspectGeometry(), scaleImage(), and scaleImageDownOnly().

eZImageGDHandler::calculateScaledPercentAspectGeometry	(	$	sourceWidth,
		$	sourceHeight,
		$	destinationWidthPercent,
		$	destinationHeightPercent,
		$	allowUpScale
	)

Calculates the geometry for the scaled image in terms of percent while maintaining the aspect ratio.

Parameters:

$allowUpScale

If this is true images will be scaled up as well, if not they will keep their source size.

Note:

Percentage must be given as a float value, e.g. 50% is 0.5 and 200% is 2.0

Returns:

a geometry array.

See also:

createGeometry

Definition at line 563 of file ezimagegdhandler.php.

Referenced by scaleImagePercent().

eZImageGDHandler::convert	(	$	manager,
		$	sourceMimeData,
		&$	destinationMimeData,
		$	filters = false
	)		[virtual]

Creates the shell string and runs the executable.

Implements eZImageHandler.

Definition at line 118 of file ezimagegdhandler.php.

static eZImageGDHandler::createFromINI	(	$	iniGroup,
		$	iniFilename = false
	)		[static]

Creates a new image handler for shell executable from INI settings. The INI settings are read from ini file $iniFilename and group $iniGroup. If $iniFilename is not supplied image.ini is used.

Definition at line 698 of file ezimagegdhandler.php.

Referenced by eZImageGDFactory\produceFromINI().

static eZImageGDHandler::createGeometry	(	$	width,
		$	height,
		$	x = 0,
		$	y = 0
	)		[static]

Creates a geometry array with width $width, height $height, x position $x and y position $y and returns it.

Definition at line 685 of file ezimagegdhandler.php.

Referenced by calculateFixedHeightAspectGeometry(), calculateFixedWidthAspectGeometry(), calculateScaledAspectGeometry(), createImageBorder(), cropImage(), and scaleImageExact().

eZImageGDHandler::createImageBorder	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Definition at line 227 of file ezimagegdhandler.php.

Referenced by setImageBorder(), and setImageBorderWidth().

eZImageGDHandler::cropImage	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Crops a portion of the image from the filter parameters.

Definition at line 399 of file ezimagegdhandler.php.

eZImageGDHandler::eZImageGDHandler	(	$	handlerName,
		$	isGloballyEnabled,
		$	outputRewriteType = self::REPLACE_SUFFIX,
		$	conversionRules = false
	)

Constructor

Definition at line 28 of file ezimagegdhandler.php.

Referenced by createFromINI().

static eZImageGDHandler::imageCopy	(	$	imageObject,
		$	destinationGeometry,
		$	sourceGeometry,
		$	sourceMimeData,
		$	destinationMimeData
	)		[static]

Copies a portion of the source image $imageObject to a new image.

Definition at line 648 of file ezimagegdhandler.php.

Referenced by createImageBorder(), and cropImage().

static eZImageGDHandler::imageCreate	(	$	width,
		$	height,
		$	isTrueColor = true
	)		[static]

Creates a new GD image and returns it.

Parameters:

$isTrueColor

determines if a true color image is created, if false an indexed image is created.

Definition at line 674 of file ezimagegdhandler.php.

Referenced by imageCopy(), and scaleImageCopy().

static eZImageGDHandler::isImageTrueColor	(	&$	imageObject,
		$	mimeData
	)		[static]

Returns:

true if the image object $imageObject is in true color format.

Definition at line 665 of file ezimagegdhandler.php.

Referenced by imageCopy(), and scaleImageCopy().

eZImageGDHandler::scaleImage	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData with aspect ration maintained. This means that image will not be exactly the image size.

See also:

scaleImageExact

Definition at line 422 of file ezimagegdhandler.php.

static eZImageGDHandler::scaleImageCopy	(	$	imageObject,
		$	geometry,
		$	sourceMimeData,
		$	destinationMimeData
	)		[static]

Scales the image $imageObject to the size specified in $filterData.

Definition at line 627 of file ezimagegdhandler.php.

Referenced by scaleImage(), scaleImageDownOnly(), scaleImageExact(), scaleImageHeight(), scaleImageHeightDownOnly(), scaleImagePercent(), scaleImageWidth(), and scaleImageWidthDownOnly().

eZImageGDHandler::scaleImageDownOnly	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData with aspect ration maintained. This means that image will not be exactly the image size.

Note:

The image will not be scaled if the source size is smaller than the destination size.

See also:

scaleImageExact

Definition at line 437 of file ezimagegdhandler.php.

eZImageGDHandler::scaleImageExact	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData without caring about aspect ratio.

Definition at line 507 of file ezimagegdhandler.php.

eZImageGDHandler::scaleImageHeight	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData with aspect ration maintained. This means that image will not be exactly the image size.

See also:

scaleImageExact

Definition at line 465 of file ezimagegdhandler.php.

eZImageGDHandler::scaleImageHeightDownOnly	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData with aspect ration maintained. This means that image will not be exactly the image size.

Note:

The image will not be scaled if the source size is smaller than the destination size.

See also:

scaleImageExact

Definition at line 495 of file ezimagegdhandler.php.

eZImageGDHandler::scaleImagePercent	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData with aspect ratio maintained.

Definition at line 517 of file ezimagegdhandler.php.

eZImageGDHandler::scaleImageWidth	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData with aspect ration maintained. This means that image will not be exactly the image size.

See also:

scaleImageExact

Definition at line 451 of file ezimagegdhandler.php.

eZImageGDHandler::scaleImageWidthDownOnly	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Scales the image $imageObject to the size specified in $filterData with aspect ration maintained. This means that image will not be exactly the image size.

Note:

The image will not be scaled if the source size is smaller than the destination size.

See also:

scaleImageExact

Definition at line 480 of file ezimagegdhandler.php.

eZImageGDHandler::setImageBorder	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Definition at line 221 of file ezimagegdhandler.php.

static eZImageGDHandler::setImageBorderColor	(	&$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)		[static]

Definition at line 209 of file ezimagegdhandler.php.

eZImageGDHandler::setImageBorderWidth	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Definition at line 215 of file ezimagegdhandler.php.

eZImageGDHandler::setImageColorspaceGray	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Converts the image to grayscale.

Definition at line 252 of file ezimagegdhandler.php.

static eZImageGDHandler::setImageColorThreshold	(	$	imageObject,
		$	filterData,
		$	sourceMimeData,
		$	destinationMimeData,
		$	thresholdList
	)		[static]

Changes the colors of the image based on threshold values. The luminance will be calculated and if it is in a threshold range it will use the specified color for the range.

Definition at line 355 of file ezimagegdhandler.php.

Referenced by setImageColorThresholdName().

eZImageGDHandler::setImageColorThresholdName	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Changes the colors of the image based on threshold values. The threshold values are based on the filter name.

Definition at line 333 of file ezimagegdhandler.php.

eZImageGDHandler::setImageLuminance	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Changes the colors of the image based on the luminance. The new scale for the colors are taken from the filter parameters, the parameters must contain three values.

Definition at line 263 of file ezimagegdhandler.php.

eZImageGDHandler::setImageLuminanceColorScale	(	$	imageObject,
		$	filterData,
		$	sourceMimeData,
		$	destinationMimeData,
		$	colorScale
	)

Changes the colors of the image based on the luminance.

Parameters:

$colorScale

is an array with three float elements in range 0 to 1 that define the new color scale.

Definition at line 293 of file ezimagegdhandler.php.

Referenced by setImageColorspaceGray(), setImageLuminance(), and setImageLuminanceNamed().

eZImageGDHandler::setImageLuminanceNamed	(	$	imageObject,
		$	filterData,
		&$	filterVariables,
		$	sourceMimeData,
		$	destinationMimeData
	)

Changes the colors of the image based on the luminance. The new scale for the colors are based on the name of the filters.

Definition at line 274 of file ezimagegdhandler.php.

---

Member Data Documentation

eZImageGDHandler::$Executable

Definition at line 743 of file ezimagegdhandler.php.

eZImageGDHandler::$Path

Definition at line 742 of file ezimagegdhandler.php.

eZImageGDHandler::$PostParameters

Definition at line 745 of file ezimagegdhandler.php.

eZImageGDHandler::$PreParameters

Definition at line 744 of file ezimagegdhandler.php.

---

The documentation for this class was generated from the following file:

• ezimagegdhandler.php