(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);
?>