(PHP 5 >= 5.5.0, PHP 7)
imagecropauto — Recadre une image automatiquement en utilisant un des modes disponibles
$image
[, int $mode = -1
[, float $threshold = .5
[, int $color = -1
]]] )
Recadre automatiquement une image selon le mode.
imageUne ressource d'image, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
modeUne constante parmi :
IMG_CROP_DEFAULTIMG_CROP_TRANSPARENT et utilise
IMG_CROP_SIDES en cas d'échec.
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.
colorSoit une valeur de couleur RVB, soit un index de palette.
Utilisé uniquement en mode IMG_CROP_THRESHOLD.
Retourne la ressource de l'image recadrée en cas de
succès ou FALSE si une erreur survient.
Si l'image n'est pas rognée ou que l'image complète était complètement rognée
cela est traité en comme une erreur. La fonction imagecrop() retourne FALSE.
Exemple #1 Rognage automatique correcte
Comme indiqué dans la section valeur de retour,
imagecropauto() retourne FALSE quand il n'y a rien
à rogner ou l'image entière serait recadrée. Dans cet exemple, nous
avons une ressource d'image $im qui ne devrait être
automatiquement recadré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 recadrée à $im
}
?>