Recadre une image automatiquement en utilisant un des modes disponibles

# imagecropauto

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

imagecropauto — Recadre une image automatiquement en utilisant un des modes disponibles

### Description

function imagecropauto(
GdImage `$image`,
int `$mode` = `IMG_CROP_DEFAULT`,
float `$threshold` = 0.5,
int `$color` = -1
): GdImage|false

Rogne automatiquement une image selon le `mode`.

### Liste de paramètres

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

  Une constante parmi :

  `IMG_CROP_DEFAULT`
    Identique à `IMG_CROP_TRANSPARENT`. Antérieurement à PHP 7.4.0, la bibliothèque libgd intégrée utilisait `IMG_CROP_SIDES` en tant que solution de repli, si l'image n'avait pas de couleur de transparence.
  `IMG_CROP_TRANSPARENT`
    Rogne le fond transparent.
  `IMG_CROP_BLACK`
    Rogne le fond noir.
  `IMG_CROP_WHITE`
    Rogne le fond blanc.
  `IMG_CROP_SIDES`
    Utilise les 4 coins de l'image pour tenter de détecter l'arrière-plan à rogner.
  `IMG_CROP_THRESHOLD`
    Rogne l'image en utilisant le seuil `threshold` et `color`.
`threshold`

  Spécifie la tolérance en pourcentage à utiliser lors de la comparaison de la couleur d'image et de la couleur à rogner. La méthode utilisée pour calculer la différence de couleur est basée sur la distance des couleurs dans le cube RVB(a).

  Utilisé uniquement en mode `IMG_CROP_THRESHOLD`.

  > Note: Antérieurement à PHP 7.4.0, la bibliothèque libgd intégrée utilisait un algorithme quelque peu différent, donc le même `threshold` produisait des résultats différents pour libgd système et intégré.

`color`

  Soit une valeur de couleur RVB, soit un index de palette.

  Utilisé uniquement en mode `IMG_CROP_THRESHOLD`.

### Valeurs de retour

Retourne l'objet de l'image rognée en cas de succès ou `false` si une erreur survient. `false` sera aussi retourné si toute l'image a été rognée.

### 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.
7.4.0 | Le comportement de imagecropauto de la bibliothèque libgd intégrée a été synchronisé avec celle de libgd système : `IMG_CROP_DEFAULT` n'utilise plus `IMG_CROP_SIDES` comme solution de repli et la tolérance de rognage utilise désormais le même algorithme que libgd système.
7.4.0 | La valeur par défaut de `mode` a été modifiée en `IMG_CROP_AUTO`. Antérieurement, la valeur par défaut était `-1` qui correspond à `IMG_CROP_DEFAULT`, mais passer `-1` est désormais obsolète.

### Exemples

Exemple #1 Rognage automatique correct

Comme indiqué dans la section valeur de retour, imagecropauto() retourne `false` si l'image entière a été rognée. Dans cet exemple, nous avons un objet d'image `$im` qui ne devrait être automatiquement rogné que s'il y a quelque chose à rogner ; sinon, nous voulons conserver l'image originale.

    <?php
    $cropped = imagecropauto($im, IMG_CROP_DEFAULT);
    if ($cropped !== false) { // Si un nouvel objet d'image a été retourné
        $im = $cropped;       // et assigne l'image rognée à $im
    }
    ?>

### Voir aussi

- imagecrop() - Recadre une image sur le rectangle donné

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