Documentation

Gd extends AbstractAdapter
in package

Gd adapter class

Tags
category

Pop

author

Nick Sagona, III dev@nolainteractive.com

copyright

Copyright (c) 2009-2021 NOLA Interactive, LLC. (http://www.nolainteractive.com)

license

http://www.popphp.org/license New BSD License

version
3.4.0

Table of Contents

IMAGE_CMYK  = 3
IMAGE_GRAY  = 1
Colorspace constants
IMAGE_RGB  = 2
$adjust  : AdjustInterface
Image adjust object
$colorspace  : int
Image colorspace
$draw  : DrawInterface
Image draw object
$effect  : EffectInterface
Image effect object
$exif  : array<string|int, mixed>
EXIF data
$filter  : FilterInterface
Image filter object
$format  : string
Image format
$height  : int
Image height
$indexed  : bool
Index color flag
$layer  : LayerInterface
Image layer object
$name  : string
Image name
$resource  : mixed
Image resource
$type  : TypeInterface
Image type object
$width  : int
Image width
__construct()  : mixed
Constructor
__get()  : mixed
Magic get method to return a manipulation object
__toString()  : string
Output the image
adjust()  : AdjustInterface
Get the image adjust object
convert()  : Gd
Convert the image object to another format
create()  : Gd
Create a new image resource
createColor()  : mixed
Create and return a color
createIndex()  : Gd
Create a new image resource
createResource()  : void
Create the image resource
crop()  : Gd
Crop the image object to a image whose dimensions are based on the value of the $wid and $hgt argument. The optional $x and $y arguments allow for the adjustment of the crop to select a certain area of the image to be cropped.
cropThumb()  : Gd
Crop the image object to a square image whose dimensions are based on the value of the $px argument. The optional $offset argument allows for the adjustment of the crop to select a certain area of the image to be cropped.
destroy()  : void
Destroy the image object and the related image file directly
draw()  : DrawInterface
Get the image draw object
effect()  : EffectInterface
Get the image effect object
filter()  : FilterInterface
Get the image filter object
flip()  : Gd
Method to flip the image over the x-axis
flop()  : Gd
Method to flip the image over the y-axis
getColorspace()  : int
Get the colorspace
getExif()  : array<string|int, mixed>
Get the image EXIF data
getFormat()  : string
Get the image format
getHeight()  : int
Get the image height
getName()  : string
Get the image name
getResource()  : resource
Get the image resource
getWidth()  : int
Get the image width
hasResource()  : bool
Determine if there is an image resource
isCmyk()  : bool
Determine if the image is CMYK
isGray()  : bool
Determine if the image is grayscale
isIndexed()  : bool
Determine if the image is index color
isRgb()  : bool
Determine if the image is RGB
layer()  : LayerInterface
Get the image layer object
load()  : Gd
Load the image resource from the existing image file
loadFromString()  : Gd
Load the image resource from data
outputToHttp()  : void
Output the image object directly to HTTP
resize()  : Gd
Resize the image object, allowing for the largest dimension to be scaled to the value of the $px argument.
resizeToHeight()  : Gd
Resize the image object to the height parameter passed
resizeToWidth()  : Gd
Resize the image object to the width parameter passed
rotate()  : Gd
Rotate the image object
scale()  : Gd
Scale the image object, allowing for the dimensions to be scaled proportionally to the value of the $scale argument.
sendHeaders()  : void
Send image headers the image
setAdjust()  : AbstractAdapter
Set the image adjust object
setDraw()  : AbstractAdapter
Set the image draw object
setEffect()  : AbstractAdapter
Set the image effect object
setFilter()  : AbstractAdapter
Set the image filter object
setLayer()  : AbstractAdapter
Set the image layer object
setType()  : AbstractAdapter
Set the image type object
type()  : TypeInterface
Get the image type object
writeToFile()  : void
Write the image object to a file on disk
copyImage()  : void
Copy the image resource to the image output resource with the set parameters
generateImage()  : void
Parse the image data
parseImage()  : void
Parse the image data

Constants

Properties

Methods

__construct()

Constructor

public __construct() : mixed

Instantiate an image object based on either a pre-existing image file on disk, or a new image file.

Return values
mixed

__get()

Magic get method to return a manipulation object

public __get(string $name) : mixed
Parameters
$name : string
Return values
mixed

__toString()

Output the image

public __toString() : string
Return values
string

convert()

Convert the image object to another format

public convert(string $to) : Gd
Parameters
$to : string
Tags
throws
Exception
Return values
Gd

create()

Create a new image resource

public create([int $width = null ][, int $height = null ][, string $name = null ]) : Gd
Parameters
$width : int = null
$height : int = null
$name : string = null
Tags
throws
Exception
Return values
Gd

createColor()

Create and return a color

public createColor([ColorInterface $color = null ][, int $alpha = null ]) : mixed
Parameters
$color : ColorInterface = null
$alpha : int = null
Tags
throws
Exception
Return values
mixed

createIndex()

Create a new image resource

public createIndex([int $width = null ][, int $height = null ][, string $name = null ]) : Gd
Parameters
$width : int = null
$height : int = null
$name : string = null
Tags
throws
Exception
Return values
Gd

createResource()

Create the image resource

public createResource() : void
Return values
void

crop()

Crop the image object to a image whose dimensions are based on the value of the $wid and $hgt argument. The optional $x and $y arguments allow for the adjustment of the crop to select a certain area of the image to be cropped.

public crop(int $w, int $h, int $x, int $y) : Gd
Parameters
$w : int
$h : int
$x : int
$y : int
Return values
Gd

cropThumb()

Crop the image object to a square image whose dimensions are based on the value of the $px argument. The optional $offset argument allows for the adjustment of the crop to select a certain area of the image to be cropped.

public cropThumb(int $px[, int $offset = null ]) : Gd
Parameters
$px : int
$offset : int = null
Return values
Gd

destroy()

Destroy the image object and the related image file directly

public destroy([bool $delete = false ]) : void
Parameters
$delete : bool = false
Return values
void

flip()

Method to flip the image over the x-axis

public flip() : Gd
Return values
Gd

flop()

Method to flip the image over the y-axis

public flop() : Gd
Return values
Gd

getColorspace()

Get the colorspace

public getColorspace() : int
Return values
int

getExif()

Get the image EXIF data

public getExif() : array<string|int, mixed>
Return values
array<string|int, mixed>

getFormat()

Get the image format

public getFormat() : string
Return values
string

getHeight()

Get the image height

public getHeight() : int
Return values
int

getName()

Get the image name

public getName() : string
Return values
string

getResource()

Get the image resource

public getResource() : resource
Return values
resource

getWidth()

Get the image width

public getWidth() : int
Return values
int

hasResource()

Determine if there is an image resource

public hasResource() : bool
Return values
bool

isCmyk()

Determine if the image is CMYK

public isCmyk() : bool
Return values
bool

isGray()

Determine if the image is grayscale

public isGray() : bool
Return values
bool

isIndexed()

Determine if the image is index color

public isIndexed() : bool
Return values
bool

isRgb()

Determine if the image is RGB

public isRgb() : bool
Return values
bool

load()

Load the image resource from the existing image file

public load([string $name = null ]) : Gd
Parameters
$name : string = null
Tags
throws
Exception
Return values
Gd

loadFromString()

Load the image resource from data

public loadFromString(string $data[, string $name = null ]) : Gd
Parameters
$data : string
$name : string = null
Tags
throws
Exception
Return values
Gd

outputToHttp()

Output the image object directly to HTTP

public outputToHttp([int $quality = 100 ][, string $to = null ][, bool $download = false ][, bool $sendHeaders = true ][, array<string|int, mixed> $headers = [] ]) : void
Parameters
$quality : int = 100
$to : string = null
$download : bool = false
$sendHeaders : bool = true
$headers : array<string|int, mixed> = []
Tags
throws
Exception
Return values
void

resize()

Resize the image object, allowing for the largest dimension to be scaled to the value of the $px argument.

public resize(int $px) : Gd
Parameters
$px : int
Return values
Gd

resizeToHeight()

Resize the image object to the height parameter passed

public resizeToHeight(int $h) : Gd
Parameters
$h : int
Return values
Gd

resizeToWidth()

Resize the image object to the width parameter passed

public resizeToWidth(int $w) : Gd
Parameters
$w : int
Return values
Gd

rotate()

Rotate the image object

public rotate(int $degrees[, ColorInterface $bgColor = null ][, int $alpha = null ]) : Gd
Parameters
$degrees : int
$bgColor : ColorInterface = null
$alpha : int = null
Return values
Gd

scale()

Scale the image object, allowing for the dimensions to be scaled proportionally to the value of the $scale argument.

public scale(float $scale) : Gd
Parameters
$scale : float
Return values
Gd

sendHeaders()

Send image headers the image

public sendHeaders([string $to = null ][, bool $download = false ][, array<string|int, mixed> $additionalHeaders = [] ]) : void
Parameters
$to : string = null
$download : bool = false
$additionalHeaders : array<string|int, mixed> = []
Return values
void

writeToFile()

Write the image object to a file on disk

public writeToFile([string $to = null ][, int $quality = 100 ]) : void
Parameters
$to : string = null
$quality : int = 100
Tags
throws
Exception
Return values
void

copyImage()

Copy the image resource to the image output resource with the set parameters

protected copyImage(int $w, int $h, int $x, int $y) : void
Parameters
$w : int
$h : int
$x : int
$y : int
Return values
void

generateImage()

Parse the image data

protected generateImage(int $quality[, string $to = null ]) : void
Parameters
$quality : int
$to : string = null
Return values
void

parseImage()

Parse the image data

protected parseImage(array<string|int, mixed> $size, string $data) : void
Parameters
$size : array<string|int, mixed>
$data : string
Return values
void

Search results