---
title: "Phalcon Image"
version: "5.20"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.phalcon.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Phalcon Image
:::info[NOTE]
All classes are prefixed with `Phalcon`
:::
## Image\Adapter\AbstractAdapter
Abstract
All image adapters must use this class
@template TImage of object
- **`Phalcon\Image\Adapter\AbstractAdapter`** - implements [`Phalcon\Image\Adapter\AdapterInterface`](#imageadapteradapterinterface)
- [`Phalcon\Image\Adapter\Gd`](#imageadaptergd)
- [`Phalcon\Image\Adapter\Imagick`](#imageadapterimagick)
`Phalcon\Contracts\Image\ImageTypes` · `Phalcon\Image\Enum` · `Phalcon\Image\Exception` · `Phalcon\Image\Exceptions\ImageTooLarge` · `Phalcon\Image\Exceptions\InvalidColor` · `Phalcon\Image\Exceptions\MissingDimensions` · `Phalcon\Image\Exceptions\MissingHeight` · `Phalcon\Image\Exceptions\MissingWidth`
### Method Summary
Set the background color of an image
Blur image
Crop an image to the given size
Flip the image along the horizontal or vertical axis
Composite one image onto another
Pixelate image
Add a reflection to an image
Render the image and return the binary string
Resize the image to the given size
Rotate the image by a given amount
Save the image
Sharpen the image by a given amount
Add a text to an image with a specified opacity
Add a watermark to an image with the specified opacity
Rejects an image whose pixel count exceeds the configured limit before
Renders the supplied colour onto the image as the background. Channels
Applies a blur. The radius is already clamped to 1-100.
Crops the image. Width, height and both offsets are already normalized
Flips the image. The direction is already normalized to
Composites the supplied image as a mask onto this one. The mask is read
Pixelates the image. The amount is already at least 2.
Adds a reflection. The height is clamped to the image height and the
Renders the image to a binary string. The extension is non-empty and the
Resizes the image. Width and height are already resolved to positive
Rotates the image. The degrees value is already normalized to -180..180.
Saves the image to the supplied file path.
Sharpens the image. The amount is already clamped to 1-100.
Renders text onto the image. The opacity is clamped to 0-100 and the
Composites the supplied watermark onto this image. Offsets and opacity
### Constants
Default cap on the pixel count (width * height) of a loaded image, used
when the constructor is not given an explicit limit. Bounds the memory a
crafted image (decompression bomb / pixel flood) can force the backend to
allocate (CWE-409). Generous by default; override per instance.
### Properties
The handle of the underlying backend. Every adapter assigns it in its
constructor and releases it in its destructor.
Maximum allowed pixel count (width * height) for a loaded image. Zero
disables the check.
Image type
Driver dependent
Image width
### Methods
background()
```php
public function background(
string $color,
int $opacity = 100
): AdapterInterface;
```
Set the background color of an image
blur()
```php
public function blur( int $radius ): AdapterInterface;
```
Blur image
crop()
```php
public function crop(
int $width,
int $height,
mixed $offsetX = null,
mixed $offsetY = null
): AdapterInterface;
```
Crop an image to the given size
flip()
```php
public function flip( int $direction ): AdapterInterface;
```
Flip the image along the horizontal or vertical axis
getHeight()
```php
public function getHeight(): int;
```
getImage()
```php
public function getImage();
```
getMime()
```php
public function getMime(): string;
```
getRealpath()
```php
public function getRealpath(): string;
```
getType()
```php
public function getType(): int;
```
getWidth()
```php
public function getWidth(): int;
```
mask()
```php
public function mask( AdapterInterface $mask ): AdapterInterface;
```
Composite one image onto another
The mask is read through its public render() output rather than its
internal handle, so a mask created with a different backend composites
correctly. The cost is one encode/decode round trip per call, which is
worth knowing inside loops.
pixelate()
```php
public function pixelate( int $amount ): AdapterInterface;
```
Pixelate image
reflection()
```php
public function reflection(
int $height,
int $opacity = 100,
bool $fadeIn = false
): AdapterInterface;
```
Add a reflection to an image
render()
```php
public function render(
string|null $extension = null,
int $quality = 100
): string;
```
Render the image and return the binary string
resize()
```php
public function resize(
int|null $width = null,
int|null $height = null,
int $master = Enum::AUTO
): AdapterInterface;
```
Resize the image to the given size
rotate()
```php
public function rotate( int $degrees ): AdapterInterface;
```
Rotate the image by a given amount
save()
```php
public function save(
string|null $file = null,
int $quality = -1
): AdapterInterface;
```
Save the image
sharpen()
```php
public function sharpen( int $amount ): AdapterInterface;
```
Sharpen the image by a given amount
text()
```php
public function text(
string $text,
mixed $offsetX = false,
mixed $offsetY = false,
int $opacity = 100,
string $color = "000000",
int $size = 12,
string|null $fontFile = null
): AdapterInterface;
```
Add a text to an image with a specified opacity
The offsets accept `false` to centre the text on that axis, so they are
wider than the `int` the interface documents.
watermark()
```php
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
The watermark is read through its public render() output rather than its
internal handle, so a watermark created with a different backend
composites correctly. The cost is one encode/decode round trip per call,
which is worth knowing inside loops.
assertPixelLimit()
```php
protected function assertPixelLimit(
int $width,
int $height
): void;
```
Rejects an image whose pixel count exceeds the configured limit before
the backend allocates it, bounding decompression-bomb / pixel-flood
memory use (CWE-409). A zero limit disables the check.
checkHighLow()
```php
protected function checkHighLow(
int $value,
int $min = 0,
int $max = 100
): int;
```
processBackground()
```php
abstract protected function processBackground(
int $red,
int $green,
int $blue,
int $opacity
): void;
```
Renders the supplied colour onto the image as the background. Channels
are 0-255; the opacity is the validated 0-100 value.
processBlur()
```php
abstract protected function processBlur( int $radius ): void;
```
Applies a blur. The radius is already clamped to 1-100.
processCrop()
```php
abstract protected function processCrop(
int $width,
int $height,
int $offsetX,
int $offsetY
): void;
```
Crops the image. Width, height and both offsets are already normalized
to fit within the current canvas.
processFlip()
```php
abstract protected function processFlip( int $direction ): void;
```
Flips the image. The direction is already normalized to
Enum::HORIZONTAL or Enum::VERTICAL.
processMask()
```php
abstract protected function processMask( AdapterInterface $mask );
```
Composites the supplied image as a mask onto this one. The mask is read
through its public render() output, so it may be any adapter backend.
processPixelate()
```php
abstract protected function processPixelate( int $amount ): void;
```
Pixelates the image. The amount is already at least 2.
processReflection()
```php
abstract protected function processReflection(
int $height,
int $opacity,
bool $fadeIn
): void;
```
Adds a reflection. The height is clamped to the image height and the
opacity to 0-100.
processRender()
```php
abstract protected function processRender(
string $extension,
int $quality
);
```
Renders the image to a binary string. The extension is non-empty and the
quality is already clamped to 1-100. Returns the encoded bytes.
processResize()
```php
abstract protected function processResize(
int $width,
int $height
): void;
```
Resizes the image. Width and height are already resolved to positive
integers per the requested resize mode.
processRotate()
```php
abstract protected function processRotate( int $degrees ): void;
```
Rotates the image. The degrees value is already normalized to -180..180.
processSave()
```php
abstract protected function processSave(
string $file,
int $quality
): bool;
```
Saves the image to the supplied file path.
processSharpen()
```php
abstract protected function processSharpen( int $amount ): void;
```
Sharpens the image. The amount is already clamped to 1-100.
processText()
```php
abstract protected function processText(
string $text,
mixed $offsetX,
mixed $offsetY,
int $opacity,
int $red,
int $green,
int $blue,
int $size,
string|null $fontFile = null
): void;
```
Renders text onto the image. The opacity is clamped to 0-100 and the
colour is supplied as separate 0-255 channels.
processWatermark()
```php
abstract protected function processWatermark(
AdapterInterface $watermark,
int $offsetX,
int $offsetY,
int $opacity
): void;
```
Composites the supplied watermark onto this image. Offsets and opacity
are already clamped to the valid range; the watermark is read through
its public render() output, so it may be any adapter backend.
## Image\Adapter\AdapterInterface
Interface
Interface for Phalcon\Image\Adapter classes
- **`Phalcon\Image\Adapter\AdapterInterface`**
`Phalcon\Image\Enum`
### Method Summary
Add a background to an image
Blur an image
Crop an image
Flip an image
Add a mask to an image
Pixelate an image
Reflect an image
Render an image
Resize an image
Rotate an image
Save an image
Sharpen an image
Adds text on an image
Add a watermark on an image
### Methods
background()
```php
public function background(
string $color,
int $opacity = 100
): AdapterInterface;
```
Add a background to an image
blur()
```php
public function blur( int $radius ): AdapterInterface;
```
Blur an image
crop()
```php
public function crop(
int $width,
int $height,
int|null $offsetX = null,
int|null $offsetY = null
): AdapterInterface;
```
Crop an image
flip()
```php
public function flip( int $direction ): AdapterInterface;
```
Flip an image
getHeight()
```php
public function getHeight(): int;
```
getWidth()
```php
public function getWidth(): int;
```
mask()
```php
public function mask( AdapterInterface $mask ): AdapterInterface;
```
Add a mask to an image
pixelate()
```php
public function pixelate( int $amount ): AdapterInterface;
```
Pixelate an image
reflection()
```php
public function reflection(
int $height,
int $opacity = 100,
bool $fadeIn = false
): AdapterInterface;
```
Reflect an image
render()
```php
public function render(
string|null $extension = null,
int $quality = 100
): string;
```
Render an image
resize()
```php
public function resize(
int|null $width = null,
int|null $height = null,
int $master = Enum::AUTO
): AdapterInterface;
```
Resize an image
rotate()
```php
public function rotate( int $degrees ): AdapterInterface;
```
Rotate an image
save()
```php
public function save(
string|null $file = null,
int $quality = 100
): AdapterInterface;
```
Save an image
sharpen()
```php
public function sharpen( int $amount ): AdapterInterface;
```
Sharpen an image
text()
```php
public function text(
string $text,
int $offsetX = 0,
int $offsetY = 0,
int $opacity = 100,
string $color = "000000",
int $size = 12,
string|null $fontFile = null
): AdapterInterface;
```
Adds text on an image
watermark()
```php
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
Image manipulation backed by the GD extension.
Capabilities:
| Aspect | Support |
|---------------------|---------------------------------------------|
| Load formats | GIF, JPEG, JPEG 2000, PNG, WEBP, WBMP, XBM |
| Render/save formats | GIF, JPEG, PNG, WBMP, WEBP, XBM |
| Backend-only API | none |
Unsupported render/save formats raise
Phalcon\Image\Exceptions\UnsupportedImageType. Visual semantics differ from
the Imagick adapter: blur() applies repeated 3x3 Gaussian convolutions
(the radius is the number of passes), while sharpen and reflection use GD's
own scales. Switching the factory backend can change the rendered output.
@extends AbstractAdapter<GdImage>
- [`Phalcon\Image\Adapter\AbstractAdapter`](#imageadapterabstractadapter)
- **`Phalcon\Image\Adapter\Gd`**
`GdImage` · `Phalcon\Contracts\Image\ImageTypes` · `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` · `Phalcon\Traits\Php\FileTrait` · `Phalcon\Traits\Php\InfoTrait`
### Method Summary
Loads an image from a file, or creates a blank canvas.
Destructor
Creates a blank true-color canvas of the given dimensions, without the
### Methods
__construct()
```php
public function __construct(
string $file,
int|null $width = null,
int|null $height = null,
int $maxPixels = 0
);
```
Loads an image from a file, or creates a blank canvas.
When the file exists it is loaded. When the file does not exist and both
a width and a height are supplied, a blank true-color canvas is created
instead - its realpath, mime and type then describe a PNG canvas rather
than the named file. Prefer Gd::create() for the canvas case; this dual
mode is slated for removal in the next major version.
__destruct()
```php
public function __destruct();
```
Destructor
create()
```php
public static function create(
int $width,
int $height
): AbstractAdapter;
```
Creates a blank true-color canvas of the given dimensions, without the
load-or-create ambiguity of the constructor.
getVersion()
```php
public function getVersion(): string;
```
processBackground()
```php
protected function processBackground(
int $red,
int $green,
int $blue,
int $opacity
): void;
```
processBlur()
```php
protected function processBlur( int $radius ): void;
```
processCreate()
```php
protected function processCreate(
int $width,
int $height
);
```
processCrop()
```php
protected function processCrop(
int $width,
int $height,
int $offsetX,
int $offsetY
): void;
```
processFlip()
```php
protected function processFlip( int $direction ): void;
```
processMask()
```php
protected function processMask( AdapterInterface $mask );
```
processPixelate()
```php
protected function processPixelate( int $amount ): void;
```
processReflection()
```php
protected function processReflection(
int $height,
int $opacity,
bool $fadeIn
): void;
```
processRender()
```php
protected function processRender(
string $extension,
int $quality
): false|string;
```
processResize()
```php
protected function processResize(
int $width,
int $height
): void;
```
processRotate()
```php
protected function processRotate( int $degrees ): void;
```
processSave()
```php
protected function processSave(
string $file,
int $quality
): bool;
```
processSharpen()
```php
protected function processSharpen( int $amount ): void;
```
processText()
```php
protected function processText(
string $text,
mixed $offsetX,
mixed $offsetY,
int $opacity,
int $red,
int $green,
int $blue,
int $size,
string|null $fontFile = null
): void;
```
processWatermark()
```php
protected function processWatermark(
AdapterInterface $watermark,
int $offsetX,
int $offsetY,
int $opacity
): void;
```
## Image\Adapter\Imagick
Class
Phalcon\Image\Adapter\Imagick
Image manipulation support. Resize, rotate, crop etc.
```php
$image = new \Phalcon\Image\Adapter\Imagick("upload/test.jpg");
$image->resize(200, 200)->rotate(90)->crop(100, 100);
if ($image->save()) {
echo "success";
}
```
Capabilities:
| Aspect | Support |
|---------------------|------------------------------------------------|
| Load formats | Whatever the linked ImageMagick build supports |
| Render/save formats | Whatever the linked ImageMagick build supports |
| Backend-only API | liquidRescale(), setResourceLimit() |
Visual semantics differ from the Gd adapter: blur() maps the radius to a
blur sigma, while sharpen and reflection use ImageMagick's own scales.
Switching the factory backend can change the rendered output.
@extends AbstractAdapter<ImagickNative>
- [`Phalcon\Image\Adapter\AbstractAdapter`](#imageadapterabstractadapter)
- **`Phalcon\Image\Adapter\Imagick`**
`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` · `Phalcon\Traits\Php\FileTrait`
### Method Summary
Loads an image from a file, or creates a blank canvas.
Destroys the loaded image to free up resources.
Creates a blank transparent canvas of the given dimensions, without the
This method scales the images using liquid rescaling method. Only support
Sets the limit for a particular resource in megabytes
Execute a background.
Blur image
Execute a crop.
Execute a flip.
Composite one image onto another
Pixelate image
Execute a reflection.
Execute a render.
Execute a resize.
Execute a rotation.
Execute a save.
Execute a sharpen.
Execute a text
Add Watermark
### Properties
### Methods
__construct()
```php
public function __construct(
string $file,
int|null $width = null,
int|null $height = null,
int $maxPixels = 0
);
```
Loads an image from a file, or creates a blank canvas.
When the file exists it is loaded. When the file does not exist and both
a width and a height are supplied, a blank transparent canvas is created
instead - its realpath, mime and type then describe a PNG canvas rather
than the named file. Prefer Imagick::create() for the canvas case; this
dual mode is slated for removal in the next major version.
__destruct()
```php
public function __destruct();
```
Destroys the loaded image to free up resources.
create()
```php
public static function create(
int $width,
int $height
): AbstractAdapter;
```
Creates a blank transparent canvas of the given dimensions, without the
load-or-create ambiguity of the constructor.
liquidRescale()
```php
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()
```php
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
processBackground()
```php
protected function processBackground(
int $red,
int $green,
int $blue,
int $opacity
): void;
```
Execute a background.
processBlur()
```php
protected function processBlur( int $radius ): void;
```
Blur image
processCrop()
```php
protected function processCrop(
int $width,
int $height,
int $offsetX,
int $offsetY
): void;
```
Execute a crop.
processFlip()
```php
protected function processFlip( int $direction ): void;
```
Execute a flip.
processMask()
```php
protected function processMask( AdapterInterface $mask ): void;
```
Composite one image onto another
processPixelate()
```php
protected function processPixelate( int $amount ): void;
```
Pixelate image
processReflection()
```php
protected function processReflection(
int $height,
int $opacity,
bool $fadeIn
): void;
```
Execute a reflection.
processRender()
```php
protected function processRender(
string $extension,
int $quality
): string;
```
Execute a render.
processResize()
```php
protected function processResize(
int $width,
int $height
): void;
```
Execute a resize.
processRotate()
```php
protected function processRotate( int $degrees ): void;
```
Execute a rotation.
processSave()
```php
protected function processSave(
string $file,
int $quality
): bool;
```
Execute a save.
processSharpen()
```php
protected function processSharpen( int $amount ): void;
```
Execute a sharpen.
processText()
```php
protected function processText(
string $text,
mixed $offsetX,
mixed $offsetY,
int $opacity,
int $red,
int $green,
int $blue,
int $size,
string|null $fontFile = null
): void;
```
Execute a text
processWatermark()
```php
protected function processWatermark(
AdapterInterface $watermark,
int $offsetX,
int $offsetY,
int $opacity
): void;
```
Add Watermark
## Image\Enum
Class
- **`Phalcon\Image\Enum`**
### Constants
## Image\Exception
Class
Exceptions thrown in Phalcon\Image will use this class
- `\Exception`
- **`Phalcon\Image\Exception`**
- [`Phalcon\Image\Exceptions\CompositeFailed`](#imageexceptionscompositefailed)
- [`Phalcon\Image\Exceptions\ExtensionNotLoaded`](#imageexceptionsextensionnotloaded)
- [`Phalcon\Image\Exceptions\ImageLoadFailed`](#imageexceptionsimageloadfailed)
- [`Phalcon\Image\Exceptions\ImageTooLarge`](#imageexceptionsimagetoolarge)
- [`Phalcon\Image\Exceptions\InvalidColor`](#imageexceptionsinvalidcolor)
- [`Phalcon\Image\Exceptions\MissingDimensions`](#imageexceptionsmissingdimensions)
- [`Phalcon\Image\Exceptions\MissingHeight`](#imageexceptionsmissingheight)
- [`Phalcon\Image\Exceptions\MissingWidth`](#imageexceptionsmissingwidth)
- [`Phalcon\Image\Exceptions\ResizeFailed`](#imageexceptionsresizefailed)
- [`Phalcon\Image\Exceptions\ResourceTypeError`](#imageexceptionsresourcetypeerror)
- [`Phalcon\Image\Exceptions\TextRenderingFailed`](#imageexceptionstextrenderingfailed)
- [`Phalcon\Image\Exceptions\UnsupportedImageType`](#imageexceptionsunsupportedimagetype)
- [`Phalcon\Image\Exceptions\VersionMismatch`](#imageexceptionsversionmismatch)
## Image\Exceptions\CompositeFailed
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\CompositeFailed`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct();
```
## Image\Exceptions\ExtensionNotLoaded
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\ExtensionNotLoaded`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct( string $extension );
```
## Image\Exceptions\ImageLoadFailed
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\ImageLoadFailed`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct( string $file );
```
## Image\Exceptions\ImageTooLarge
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\ImageTooLarge`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
```php
public function __construct(
int $pixels,
int $maxPixels
);
```
## Image\Exceptions\InvalidColor
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\InvalidColor`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct( string $color );
```
## Image\Exceptions\MissingDimensions
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\MissingDimensions`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct();
```
## Image\Exceptions\MissingHeight
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\MissingHeight`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct();
```
## Image\Exceptions\MissingWidth
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\MissingWidth`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct();
```
## Image\Exceptions\ResizeFailed
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\ResizeFailed`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct();
```
## Image\Exceptions\ResourceTypeError
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\ResourceTypeError`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct();
```
## Image\Exceptions\TextRenderingFailed
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\TextRenderingFailed`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct();
```
## Image\Exceptions\UnsupportedImageType
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\UnsupportedImageType`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct( string $format = "" );
```
## Image\Exceptions\VersionMismatch
Class
- `\Exception`
- [`Phalcon\Image\Exception`](#imageexception)
- **`Phalcon\Image\Exceptions\VersionMismatch`**
`Phalcon\Image\Exception`
### Method Summary
### Methods
__construct()
```php
public function __construct( string $version );
```
## Image\ImageFactory
Class
Factory to create adapters for image manipulation
- [`Phalcon\Factory\AbstractConfigFactory`](/5.20/api/phalcon_factory/#factoryabstractconfigfactory)
- [`Phalcon\Factory\AbstractFactory`](/5.20/api/phalcon_factory/#factoryabstractfactory)
- **`Phalcon\Image\ImageFactory`**
`Exception` · `Phalcon\Config\ConfigInterface` · `Phalcon\Contracts\Image\ImageTypes` · `Phalcon\Factory\AbstractFactory` · `Phalcon\Image\Adapter\AdapterInterface` · `Phalcon\Image\Adapter\Gd` · `Phalcon\Image\Adapter\Imagick` · `Phalcon\Traits\Support\Helper\Arr\GetTrait` · `Throwable`
### Method Summary
Constructor
Factory to create an instance from a Config object
Creates a new instance
Returns the available adapters
### Methods
__construct()
```php
public function __construct( array $services = [] );
```
Constructor
load()
```php
public function load( mixed $config ): AdapterInterface;
```
Factory to create an instance from a Config object
newInstance()
```php
public function newInstance(
string $name,
string $file,
int|null $width = null,
int|null $height = null
): AdapterInterface;
```
Creates a new instance
getExceptionClass()
```php
protected function getExceptionClass(): string;
```
getServices()
```php
protected function getServices(): array;
```
Returns the available adapters
Source: https://docs.phalcon.io/5.20/api/phalcon_image/index.mdx