imagecropauto
(PHP 5 >= 5.5.0, PHP 7)
imagecropauto — Recadre une image automatiquement en utilisant un des modes disponibles
Description
$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é utilisaitIMG_CROP_SIDESen 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
thresholdetcolor.
-
-
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
thresholdproduisait 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
}
?>
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.imagecropauto.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
