# Gmagick::quantizeimages

(PECL gmagick >= Unknown)

Gmagick::quantizeimages — Le but de quantizeimages

### Description

public Gmagick::quantizeimages(
int `$numColors`,
int `$colorspace`,
int `$treeDepth`,
bool `$dither`,
bool `$measureError`
): Gmagick

Analyse les couleurs d'une séquence d'images et choisit un nombre fixe de couleurs pour représenter l'image. Le but de cet 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 une réduction de couleur dans cet espace de couleur, habituellement, RGBColorspace.

`treeDepth`

  Normalement, cet entier vaut zéro ou un. Ces valeurs indique au Quantize de choisir une profondeur d'arbre optimal de Log4(number_colors). Un arbre de cette profondeur autorise généralement la meilleure représentation de l'image de référence, avec un minimum de mémoire, et une rapidité d'exécution optimale. Dans certains cas, comme une image avec peu de dispersion de couleurs (un nombre peu élevé de couleurs), une valeur autre que Log4(number_colors) est nécessaire. Pour étendre l'arbre des couleurs complétement, utilisez la valeur 8.

`dither`

  Une valeur autre que 0 distribue la différence entre l'image originale et la couleur correspondante réduite par l'algorithme aux pixels voisins le long d'une courbe Hilbert.

`measureError`

  Une valeur autre que 0 mesure la différence entre l'image originale et celle quantifiée. La différence représente les erreurs 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.