Crop an image to the given rectangle

# imagecrop

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

imagecrop — Crop an image to the given rectangle

### Beschreibung

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

Crops an image to the given rectangular area and returns the resulting image. The given `image` is not modified.

### Parameter-Liste

`image`

  Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

`rectangle`

  The cropping rectangle as array with keys `x`, `y`, `width` and `height`.

### Rückgabewerte

Return cropped image object on successBei einem Fehler wird `false` zurückgegeben..

### Changelog

Version | Beschreibung
--- | ---
8.0.0 | `image` erwartet nun eine GdImage-Instanz; vorher wurde eine gültige `gd`-Ressource erwartet.
8.0.0 | On success, this function returns a GDImage instance now; previously, a resource was returned.

### Beispiele

Beispiel #1 imagecrop() example

This example shows how to crop an image to a square area.

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

### Siehe auch

- imagecropauto() - Crop an image automatically using one of the available modes

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