Recadre une image automatiquement en utilisant un des modes disponibles

Description

imagecropauto ( resource $image [, int $mode = IMG_CROP_DEFAULT [, float $threshold = .5 [, int $color = -1 ]]] ) : resource

Rogne automatiquement une image selon le mode.

Liste de paramètres

image

Une ressource d'image, 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érieur à PHP 7.4.0, la bibliothèque libgd intégré utilisait IMG_CROP_SIDES en tant que solution de replis, si l'image n'avait pas de couleur de transparance.
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érieur à PHP 7.4.0, la bibliothèque libgd intégré 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 la ressource de l'image rognée en cas de succès ou FALSE si une erreur survient. Si l'image complète a été rognée, imagecrop() retourne FALSE.

Historique

Version	Description
7.4.0	Le comportement de imagecropauto de la bibliothèque libgd intégré a été syncrhonisé avec celle de libgd système : `IMG_CROP_DEFAULT` n'utilise plus `IMG_CROP_SIDES` comme solution de replis et la tolérance de rognage utilise désormais le même algorithme que libgd système.
7.4.0	La valeur par défault de `mode` a été modifié en `IMG_CROP_AUTO`. Auparavant, 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 correcte

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 une ressource d'image $im qui ne devrait être automatiquement rognée que s'il ya quelque chose à rogner; Sinon, nous voulons conserver à l'image originale.


<?php
$cropped = imagecropauto($im, IMG_CROP_DEFAULT);
if ($cropped !== false) { // Si une nouvelle ressource d'image a été retournée
    imagedestroy($im);    // nous détruisons l'image originale
    $im = $cropped;       // et assignons l'image rognée à $im
}
?>

Voir aussi

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