Gmagick::quantizeimage
(PECL gmagick >= Unknown)
Gmagick::quantizeimage — Analyse les couleurs d'une image de référence
Description
public Gmagick::quantizeimage(
int $numColors,
int $colorspace,
int $treeDepth,
bool $dither,
bool $measureError):
Gmagick
Analyse les couleurs d'une image de référence et choisit un nombre fixe
de couleurs représentant l'image. Le but de l'algorithme est de minimiser
les différences de couleurs entre l'image d'entrée et celle de sortie
lors d'un processus d'optimisation.
Liste de paramètres
numColors-
Le nombre de couleurs.
colorspace-
Effectue la réduction de couleurs dans cette espace
de couleurs, typiquement RGBColorspace.
treeDepth-
Normalement, la valeur de cet entier est zéro ou un. Une telle valeur demande à
Quantize de choisir une profondeur optionnelle de Log4(number_colors). Un arbre
de cette profondeur autrise généralement la meilleure représentation de l'image
de référence tout en utilisant une quantité de mémoire raisonnable ainsi qu'une
rapidité d'exécution optimum. Dans certains cas, comme avec une image contenant
des dispersions de couleurs basses (un petit nombre de couleurs), une valeur autre
que Log4(number_colors) est nécessaire. Pour étendre totalement l'arbre de couleurs,
utilisez la valeur 8.
dither-
Une valeur autre que zéro distribue la différence entre l'image originale
et la couleur correspondante réduite par l'algorithme vers les pixels voisins
le long de la courbe Hilbert.
measureError-
Une valeur autre que zéro mesure la différence entre l'image originale et l'image
optimisée. Cette différence représente l'erreur totale de quantification. L'erreur
est calculé en faisant la somme de tous les pixels dans une image carrée de la distance
dans l'espace RVB entre chaque valeur de pixel de référence et sa valeur quantifiée.
Valeurs de retour
L'objet Gmagick en cas de succès.
Erreurs / Exceptions
Émet une exception
GmagickException en cas d'erreur.
