Recadre une image sur le rectangle donné

# imagecrop

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

imagecrop — Recadre une image sur le rectangle donné

### Description

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

Recadre une image à la zone rectangulaire donnée et retourne l'image résultante. L'`image` n'est pas modifiée.

### Liste de paramètres

`image`
  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
`rectangle`

  Le rectangle de recadrage sous forme de array contenant les clés `x`, `y`, `width` et `height`.

### Valeurs de retour

Retourne l'objet de l'image recadrée en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.
8.0.0 | En cas de succès, cette fonction retourne désormais une instance de GDImage ; auparavant, une resource était retournée.

### Exemples

Exemple #1 Exemple avec imagecrop()

Cet exemple montre comment rogner une image sur une zone carrée.

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

### Voir aussi

- imagecropauto() - Recadre une image automatiquement en utilisant un des modes disponibles

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