(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — Crop an image to the given rectangle
Crops an image to the given rectangular area and returns the resulting image. The given image is not modified.
imageA GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor().
rectangle The cropping rectangle as array with keys x, y, width and height.
Return cropped image object on success or false on failure.
| Version | Description |
|---|---|
| 8.0.0 | image expects a GdImage instance now; previously, a valid gdresource was expected. |
| 8.0.0 | On success, this function returns a GDImage instance now; previously, a resource was returned. |
Example #1 imagecrop() example
This example shows how to crop an image to a square area.
<?php
$im = imagecreatefrompng('example.png');
$size = min(imagesx($im), imagesy($im));
$im2 = imagecrop($im, ['x' => 0, 'y' => 0, 'width' => $size, 'height' => $size]);
if ($im2 !== FALSE) {
imagepng($im2, 'example-cropped.png');
imagedestroy($im2);
}
imagedestroy($im);
?>