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

# imagecrop

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

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

### Описание

function 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() - Обрезает изображение автоматически на основе заданного режима

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open