# ImageMagick QuantizeInfo Structure

The QuantizeInfo structure is used to support passing parameters to ImageMagick's color quantization (reduction) functions. Color quantization is the process of analyzing one or more images, and calculating a color palette which best approximates the image within a specified colorspace, and then adjusting the image pixels to use the calculated color palette. The maximum number of colors allowed in the color palette may be specified.

Methods Supporting QuantizeInfo
Method | Description
GetQuantizeInfo() | Allocate new structure with defaults set.
CloneQuantizeInfo() | Copy existing structure, allocating new structure in the process.
DestroyQuantizeInfo() | Deallocate structure, including any members.
QuantizeImage | Analyzes the colors within a reference image and chooses a fixed number of colors to represent the image.
QuantizeImages | Analyzes the colors within a set of reference images and chooses a fixed number of colors to represent the set.

QuantizeInfo Structure Members
Member | Type | Description

colorspace

ColorspaceType

The colorspace to quantize in. Color reduction, by default, takes place in the RGB color space. Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. The Transparent color space behaves uniquely in that it preserves the matte channel of the image if it exists.

dither | unsigned int | Set to True (non-zero) to apply Floyd/Steinberg error diffusion to the image. When the size of the color palette is less than the image colors, this trades off spacial resolution for color resolution by dithering to achieve a similar looking image.
measure_error | unsigned int | Set to True (non-zero) to calculate quantization errors when quantizing the image.
number_colors | unsigned int | Specify the maximum number of colors in the output image. Must be equal to, or less than MaxRGB, which is determined by the value of QuantumLeap when ImageMagick was compiled.
signature | unsigned long | ???
tree_depth | unsigned int | Specify the tree depth to use while quantizing. The values zero and one support automatic tree depth determination. The tree depth may be forced via values ranging from two to eight. The ideal tree depth depends on the characteristics of the input image, and may be determined through experimentation.

Image manipulation software that works like magic.