# imagecrop

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

imagecrop — Recadre une image sur le rectangle donné

### Description

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`

  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 | 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