PHP 5 >= 5.5.0, PHP 7, PHP 8
imagecrop - Crop an image to the given rectangle
Code Examples

imagecrop( GdImage$image, array$rectangle ): GdImage|false

Crops an image to the given rectangular area and returns the resulting image. The given image is not modified.



A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor.


The cropping rectangle as array with keys x, y, width and height.

Return Values

Return cropped image object on success or false on failure.


Version Description
8.0.0 image expects a GdImage instance now; previously, a resource was expected.
8.0.0 On success, this function returns a GDImage instance now; previously, a resource was returned.

Related Functions

Example of imagecrop

Show all examples for imagecrop

PHP Version:

Function imagecrop:

Image Processing and GD Functions

Most used PHP functions