(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — Обрезать изображение до заданного прямоугольника
Обрезает изображение до заданной прямоугольной области и возвращает полученное изображение.
Заданный параметр image не изменяется.
imageОбъект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
rectangle
Обрезанный прямоугольник в виде массива (array) с ключами
x, y, width и
height.
Возвращает объект обрезанного изображения в случае успешного выполнения или false, если возникла ошибка.
| Версия | Описание |
|---|---|
| 8.0.0 |
Параметр image теперь ожидает экземпляр класса GdImage;
раньше параметр ждал корректный gd-ресурс (resource).
|
| 8.0.0 | В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource). |
Пример #1 Пример использования imagecrop()
В этом примере показано, как обрезать изображение до квадратной области.
<?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);
?>