PHP 8.4.0 RC2 available for testing

imagecrop

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

imagecropОбрезать изображение до заданного прямоугольника

Описание

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

Обрезает изображение до заданной прямоугольной области и возвращает полученное изображение. Заданный параметр 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);
?>

Смотрите также

  • imagecropauto() - Обрезает изображение автоматически на основе заданного режима
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top