PHPerKaigi 2025

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');
}

?>

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

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

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top