Skip to content

Phalcon image

NOTE

All classes are prefixed with Phalcon

Image\Adapter\AbstractAdapter

Abstract Source on GitHub

All image adapters must use this class

Uses Phalcon\Image\Enum · Phalcon\Image\Exception · Phalcon\Image\Exceptions\MissingDimensions · Phalcon\Image\Exceptions\MissingHeight · Phalcon\Image\Exceptions\MissingWidth

Method Summary

public AdapterInterface background(string $color,int $opacity = 100) Set the background color of an image public AdapterInterface blur( int $radius ) Blur image public AdapterInterface crop(int $width,int $height,mixed $offsetX = null,mixed $offsetY = null) Crop an image to the given size public AdapterInterface flip( int $direction ) Flip the image along the horizontal or vertical axis public int getHeight() public getImage() public string getMime() public string getRealpath() public int getType() public int getWidth() public AdapterInterface mask( AdapterInterface $mask ) Composite one image onto another public AdapterInterface pixelate( int $amount ) Pixelate image public AdapterInterface reflection(int $height,int $opacity = 100,bool $fadeIn = false) Add a reflection to an image public string render(string $extension = null,int $quality = 100) Render the image and return the binary string public AdapterInterface resize(int $width = null,int $height = null,int $master = Enum::AUTO) Resize the image to the given size public AdapterInterface rotate( int $degrees ) Rotate the image by a given amount public AdapterInterface save(string $file = null,int $quality = -1) Save the image public AdapterInterface sharpen( int $amount ) Sharpen the image by a given amount public AdapterInterface text(string $text,mixed $offsetX = false,mixed $offsetY = false,int $opacity = 100,string $color = "000000",int $size = 12,string $fontFile = null) Add a text to an image with a specified opacity public AdapterInterface watermark(AdapterInterface $watermark,int $offsetX = 0,int $offsetY = 0,int $opacity = 100) Add a watermark to an image with the specified opacity protected int checkHighLow(int $value,int $min = 0,int $max = 100)

Properties

protected string $file
protected int $height Image height
protected mixed|null $image = null
protected string $mime Image mime type
protected string $realpath
protected int $type Image type Driver dependent
protected int $width Image width

Methods

Public · 20

background()

public function background(
    string $color,
    int $opacity = 100
): AdapterInterface;

Set the background color of an image

blur()

public function blur( int $radius ): AdapterInterface;

Blur image

crop()

public function crop(
    int $width,
    int $height,
    mixed $offsetX = null,
    mixed $offsetY = null
): AdapterInterface;

Crop an image to the given size

flip()

public function flip( int $direction ): AdapterInterface;

Flip the image along the horizontal or vertical axis

getHeight()

public function getHeight(): int;

getImage()

public function getImage();

getMime()

public function getMime(): string;

getRealpath()

public function getRealpath(): string;

getType()

public function getType(): int;

getWidth()

public function getWidth(): int;

mask()

public function mask( AdapterInterface $mask ): AdapterInterface;

Composite one image onto another

pixelate()

public function pixelate( int $amount ): AdapterInterface;

Pixelate image

reflection()

public function reflection(
    int $height,
    int $opacity = 100,
    bool $fadeIn = false
): AdapterInterface;

Add a reflection to an image

render()

public function render(
    string $extension = null,
    int $quality = 100
): string;

Render the image and return the binary string

resize()

public function resize(
    int $width = null,
    int $height = null,
    int $master = Enum::AUTO
): AdapterInterface;

Resize the image to the given size

rotate()

public function rotate( int $degrees ): AdapterInterface;

Rotate the image by a given amount

save()

public function save(
    string $file = null,
    int $quality = -1
): AdapterInterface;

Save the image

sharpen()

public function sharpen( int $amount ): AdapterInterface;

Sharpen the image by a given amount

text()

public function text(
    string $text,
    mixed $offsetX = false,
    mixed $offsetY = false,
    int $opacity = 100,
    string $color = "000000",
    int $size = 12,
    string $fontFile = null
): AdapterInterface;

Add a text to an image with a specified opacity

watermark()

public function watermark(
    AdapterInterface $watermark,
    int $offsetX = 0,
    int $offsetY = 0,
    int $opacity = 100
): AdapterInterface;

Add a watermark to an image with the specified opacity

Protected · 1

checkHighLow()

protected function checkHighLow(
    int $value,
    int $min = 0,
    int $max = 100
): int;

Image\Adapter\AdapterInterface

Interface Source on GitHub

Interface for Phalcon\Image\Adapter classes

  • Phalcon\Image\Adapter\AdapterInterface

Uses Phalcon\Image\Enum

Method Summary

Methods

Public · 16

background()

public function background(
    string $color,
    int $opacity = 100
): AdapterInterface;

Add a background to an image

blur()

public function blur( int $radius ): AdapterInterface;

Blur an image

crop()

public function crop(
    int $width,
    int $height,
    int $offsetX = null,
    int $offsetY = null
): AdapterInterface;

Crop an image

flip()

public function flip( int $direction ): AdapterInterface;

Flip an image

getHeight()

public function getHeight(): int;

getWidth()

public function getWidth(): int;

mask()

public function mask( AdapterInterface $mask ): AdapterInterface;

Add a mask to an image

pixelate()

public function pixelate( int $amount ): AdapterInterface;

Pixelate an image

reflection()

public function reflection(
    int $height,
    int $opacity = 100,
    bool $fadeIn = false
): AdapterInterface;

Reflect an image

render()

public function render(
    string $extension = null,
    int $quality = 100
): string;

Render an image

resize()

public function resize(
    int $width = null,
    int $height = null,
    int $master = Enum::AUTO
): AdapterInterface;

Resize an image

rotate()

public function rotate( int $degrees ): AdapterInterface;

Rotate an image

save()

public function save(
    string $file = null,
    int $quality = 100
): AdapterInterface;

Save an image

sharpen()

public function sharpen( int $amount ): AdapterInterface;

Sharpen an image

text()

public function text(
    string $text,
    int $offsetX = 0,
    int $offsetY = 0,
    int $opacity = 100,
    string $color = "000000",
    int $size = 12,
    string $fontFile = null
): AdapterInterface;

Adds text on an image

watermark()

public function watermark(
    AdapterInterface $watermark,
    int $offsetX = 0,
    int $offsetY = 0,
    int $opacity = 100
): AdapterInterface;

Add a watermark on an image

Image\Adapter\Gd

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Enum · Phalcon\Image\Exception · Phalcon\Image\Exceptions\ExtensionNotLoaded · Phalcon\Image\Exceptions\ImageLoadFailed · Phalcon\Image\Exceptions\TextRenderingFailed · Phalcon\Image\Exceptions\UnsupportedImageType · Phalcon\Image\Exceptions\VersionMismatch

Method Summary

Methods

Public · 3

__construct()

public function __construct(
    string $file,
    int $width = null,
    int $height = null
);

__destruct()

public function __destruct();

Destructor

getVersion()

public function getVersion(): string;
Protected · 15

processBackground()

protected function processBackground(
    int $red,
    int $green,
    int $blue,
    int $opacity
): void;

processBlur()

protected function processBlur( int $radius ): void;

processCreate()

protected function processCreate(
    int $width,
    int $height
);

processCrop()

protected function processCrop(
    int $width,
    int $height,
    int $offsetX,
    int $offsetY
): void;

processFlip()

protected function processFlip( int $direction ): void;

processMask()

protected function processMask( AdapterInterface $mask );

processPixelate()

protected function processPixelate( int $amount ): void;

processReflection()

protected function processReflection(
    int $height,
    int $opacity,
    bool $fadeIn
): void;

processRender()

protected function processRender(
    string $extension,
    int $quality
);

processResize()

protected function processResize(
    int $width,
    int $height
): void;

processRotate()

protected function processRotate( int $degrees ): void;

processSave()

protected function processSave(
    string $file,
    int $quality
): bool;

processSharpen()

protected function processSharpen( int $amount ): void;

processText()

protected function processText(
    string $text,
    mixed $offsetX,
    mixed $offsetY,
    int $opacity,
    int $red,
    int $green,
    int $blue,
    int $size,
    string $fontFile = null
): void;

processWatermark()

protected function processWatermark(
    AdapterInterface $watermark,
    int $offsetX,
    int $offsetY,
    int $opacity
): void;

Image\Adapter\Imagick

Class Source on GitHub

Phalcon\Image\Adapter\Imagick

Image manipulation support. Resize, rotate, crop etc.

$image = new \Phalcon\Image\Adapter\Imagick("upload/test.jpg");

$image->resize(200, 200)->rotate(90)->crop(100, 100);

if ($image->save()) {
    echo "success";
}

Uses Imagick · ImagickDraw · ImagickDrawException · ImagickException · ImagickPixel · ImagickPixelException · Phalcon\Image\Enum · Phalcon\Image\Exception · Phalcon\Image\Exceptions\CompositeFailed · Phalcon\Image\Exceptions\ExtensionNotLoaded · Phalcon\Image\Exceptions\ImageLoadFailed · Phalcon\Image\Exceptions\ResizeFailed · Phalcon\Image\Exceptions\ResourceTypeError

Method Summary

public __construct(string $file,int $width = null,int $height = null) Constructor public __destruct() Destroys the loaded image to free up resources. public AbstractAdapter liquidRescale(int $width,int $height,int $deltaX = 0,int $rigidity = 0) This method scales the images using liquid rescaling method. Only support public void setResourceLimit(int $type,int $limit) Sets the limit for a particular resource in megabytes protected void processBackground(int $red,int $green,int $blue,int $opacity) Execute a background. protected void processBlur( int $radius ) Blur image protected void processCrop(int $width,int $height,int $offsetX,int $offsetY) Execute a crop. protected void processFlip( int $direction ) Execute a flip. protected void processMask( AdapterInterface $image ) Composite one image onto another protected void processPixelate( int $amount ) Pixelate image protected void processReflection(int $height,int $opacity,bool $fadeIn) Execute a reflection. protected string processRender(string $extension,int $quality) Execute a render. protected void processResize(int $width,int $height) Execute a resize. protected void processRotate( int $degrees ) Execute a rotation. protected void processSave(string $file,int $quality) Execute a save. protected void processSharpen( int $amount ) Execute a sharpen. protected void processText(string $text,mixed $offsetX,mixed $offsetY,int $opacity,int $red,int $green,int $blue,int $size,string $fontFile = null) Execute a text protected void processWatermark(AdapterInterface $image,int $offsetX,int $offsetY,int $opacity) Add Watermark

Properties

protected int $version = 0

Methods

Public · 4

__construct()

public function __construct(
    string $file,
    int $width = null,
    int $height = null
);

Constructor

__destruct()

public function __destruct();

Destroys the loaded image to free up resources.

liquidRescale()

public function liquidRescale(
    int $width,
    int $height,
    int $deltaX = 0,
    int $rigidity = 0
): AbstractAdapter;

This method scales the images using liquid rescaling method. Only support Imagick

setResourceLimit()

public function setResourceLimit(
    int $type,
    int $limit
): void;

Sets the limit for a particular resource in megabytes

@link https://www.php.net/manual/en/imagick.constants.php#imagick.constants.resourcetypes

Protected · 14

processBackground()

protected function processBackground(
    int $red,
    int $green,
    int $blue,
    int $opacity
): void;

Execute a background.

processBlur()

protected function processBlur( int $radius ): void;

Blur image

processCrop()

protected function processCrop(
    int $width,
    int $height,
    int $offsetX,
    int $offsetY
): void;

Execute a crop.

processFlip()

protected function processFlip( int $direction ): void;

Execute a flip.

processMask()

protected function processMask( AdapterInterface $image ): void;

Composite one image onto another

processPixelate()

protected function processPixelate( int $amount ): void;

Pixelate image

processReflection()

protected function processReflection(
    int $height,
    int $opacity,
    bool $fadeIn
): void;

Execute a reflection.

processRender()

protected function processRender(
    string $extension,
    int $quality
): string;

Execute a render.

processResize()

protected function processResize(
    int $width,
    int $height
): void;

Execute a resize.

processRotate()

protected function processRotate( int $degrees ): void;

Execute a rotation.

processSave()

protected function processSave(
    string $file,
    int $quality
): void;

Execute a save.

processSharpen()

protected function processSharpen( int $amount ): void;

Execute a sharpen.

processText()

protected function processText(
    string $text,
    mixed $offsetX,
    mixed $offsetY,
    int $opacity,
    int $red,
    int $green,
    int $blue,
    int $size,
    string $fontFile = null
): void;

Execute a text

processWatermark()

protected function processWatermark(
    AdapterInterface $image,
    int $offsetX,
    int $offsetY,
    int $opacity
): void;

Add Watermark

Image\Enum

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

  • Phalcon\Image\Enum

Constants

int AUTO = 4
int HEIGHT = 3
int HORIZONTAL = 11
int INVERSE = 5
int NONE = 1
int PRECISE = 6
int TENSILE = 7
int VERTICAL = 12
int WIDTH = 2

Image\Exception

Class Source on GitHub

Exceptions thrown in Phalcon\Image will use this class

Image\Exceptions\CompositeFailed

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct();

Image\Exceptions\ExtensionNotLoaded

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct( string $extension );

Image\Exceptions\ImageLoadFailed

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct( string $file );

Image\Exceptions\MissingDimensions

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct();

Image\Exceptions\MissingHeight

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct();

Image\Exceptions\MissingWidth

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct();

Image\Exceptions\ResizeFailed

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct();

Image\Exceptions\ResourceTypeError

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct();

Image\Exceptions\TextRenderingFailed

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct();

Image\Exceptions\UnsupportedImageType

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct( string $format = "" );

Image\Exceptions\VersionMismatch

Class Source on GitHub

This file is part of the Phalcon Framework.

(c) Phalcon Team team@phalcon.io

For the full copyright and license information, please view the LICENSE.txt file that was distributed with this source code.

Uses Phalcon\Image\Exception

Method Summary

Methods

Public · 1

__construct()

public function __construct( string $version );

Image\ImageFactory

Class Source on GitHub

Factory to create adapters for image manipulation

Uses Phalcon\Config\ConfigInterface · Phalcon\Factory\AbstractFactory · Phalcon\Image\Adapter\AdapterInterface

Method Summary

Methods

Public · 3

__construct()

public function __construct( array $services = [] );

Constructor

load()

public function load( mixed $config ): AdapterInterface;

Factory to create an instance from a Config object

newInstance()

public function newInstance(
    string $name,
    string $file,
    int $width = null,
    int $height = null
): AdapterInterface;

Creates a new instance

Protected · 2

getExceptionClass()

protected function getExceptionClass(): string;

getServices()

protected function getServices(): array;

Returns the available adapters