(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecropauto — Recadre une image automatiquement en utilisant un des modes disponibles
$image,$mode = IMG_CROP_DEFAULT,$threshold = 0.5,$color = -1
Rogne automatiquement une image selon le mode.
imageUn objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
modeUne constante parmi :
IMG_CROP_DEFAULTIMG_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_TRANSPARENTIMG_CROP_BLACKIMG_CROP_WHITEIMG_CROP_SIDESIMG_CROP_THRESHOLDthreshold et
color.
thresholdSpé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
thresholdproduisait des résultats différents pour libgd système et intégré.
colorSoit une valeur de couleur RVB, soit un index de palette.
Utilisé uniquement en mode IMG_CROP_THRESHOLD.
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.
| 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é 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éfaut 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.
|
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 un objet 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 un nouveau objet d'image a été retournée
imagedestroy($im); // nous détruisons l'image originale
$im = $cropped; // et assignons l'image rognée à $im
}
?>