1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>quantize - Reduce the Number of Unique Colors in an Image</title>
<link rel="stylesheet" type="text/css" href="../magick.css">
</head>
<body marginheight="1" marginwidth="1" topmargin="1" leftmargin="1">
<a name="top"></a>
<table border="0" cellpadding="0" cellspacing="0" summary="Masthead" width="100%">
<tbody>
<tr>
<td bgcolor="#003399" width="25%" height="118" background="../../images/background.gif"><a href="http://www.imagemagick.org/"><img src="../../images/script.gif" width="278" height="118" border="0" alt="" /></a></td>
<td bgcolor="#003399" width="60%" height="118" background="../../images/background.gif"><a href="http://www.networkeleven.com/direct.php?magick_all"><img src="../../images/promote.png" border="0" width="186" height="52" vspace="29" alt="Powered by NetworkEleven" /></a></td>
<td bgcolor="#003399" width="114" height="118" align="right"><img src="../../images/sprite.png" width="114" height="118" alt="" /></td>
<td bgcolor="#003399" width="114" height="118" align="right"><a href="http://www.imagemagick.net"><img src="../../images/logo.png" width="114" height="118" border="0" alt="ImageMagick logo" /></a></td>
</tr></tbody></table>
<table align="left" border="0" cellpadding="2" cellspacing="2" summary="Navigation buttons" width="20%">
<tr>
<td>
<form target="_self" action="../../index.html"><input type="submit" title="ImageMagick Home" value=" Home" style="background-color: #1947A3; background-image:url('../../../images/background.gif'); color:#fbc713; font-weight:bold"></form></td>
<td>
<form target="_self" action="../../www/apis.html"><input type="submit" title="ImageMagick API" value=" API " style="background-color: #1947A3; background-image:url('../../../images/background.gif'); color:#fbc713; font-weight:bold"></form></td>
<td>
<form target="_self" action="../../www/archives.html"><input type="submit" title="ImageMagick Download" value="Download" style="background-color: #1947A3; background-image:url('../../../images/background.gif'); color:#fbc713; font-weight:bold"></form></td></tr></table>
<div align="right" style="margin-top:3px; padding-right:4px">
<form action="http://studio.imagemagick.org/Sage/scripts/Sage.cgi"><input type="TEXT" name="query" size="32" maxlength="255"> <input type="SUBMIT" name="sa" value="Search" style="background-color: #1947A3; background-image:url('../../../images/background.gif'); bgcolor:#003399; color:#fbc713; font-weight:bold"></form></div>
<table align="left" border="0" cellpadding="10" cellspacing="0" style="margin-top:-17px" width="100%">
<tr>
<td>
<P><a name="__index__"></a></P>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#function_descriptions">FUNCTION DESCRIPTIONS</a></li>
<ul>
<li><a href="#clonequantizeinfo">CloneQuantizeInfo</a></li>
<li><a href="#compressimagecolormap">CompressImageColormap</a></li>
<li><a href="#destroyquantizeinfo">DestroyQuantizeInfo</a></li>
<li><a href="#getimagequantizeerror">GetImageQuantizeError</a></li>
<li><a href="#getquantizeinfo">GetQuantizeInfo</a></li>
<li><a href="#mapimage">MapImage</a></li>
<li><a href="#mapimages">MapImages</a></li>
<li><a href="#orderedditherimage">OrderedDitherImage</a></li>
<li><a href="#posterizeimage">PosterizeImage</a></li>
<li><a href="#quantizeimage">QuantizeImage</a></li>
<li><a href="#quantizeimages">QuantizeImages</a></li>
</ul>
</ul>
<!-- INDEX END -->
<hr />
<P>
</P>
<h1><a name="name">NAME</a></h1>
<P>quantize - Reduce the Number of Unique Colors in an Image</P>
<P>
</P>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<P>QuantizeInfo * <strong>CloneQuantizeInfo</strong>( const QuantizeInfo *quantize_info );</P>
<P>void <strong>CompressImageColormap</strong>( Image *image );</P>
<P><strong>DestroyQuantizeInfo</strong>( QuantizeInfo *quantize_info );</P>
<P>MagickBooleanType <strong>GetImageQuantizeError</strong>( Image *image );</P>
<P><strong>GetQuantizeInfo</strong>( QuantizeInfo *quantize_info );</P>
<P>MagickBooleanType <strong>MapImage</strong>( Image *image, const Image *map_image, const MagickBooleanType dither );</P>
<P>MagickBooleanType <strong>MapImages</strong>( Image *images, Image *map_image, const MagickBooleanType dither );</P>
<P>MagickBooleanType <strong>OrderedDitherImage</strong>( Image *image );</P>
<P>MagickBooleanType <strong>PosterizeImage</strong>( Image *image, const unsigned long levels, const MagickBooleanType dither );</P>
<P>MagickBooleanType <strong>QuantizeImage</strong>( const QuantizeInfo *quantize_info, Image *image );</P>
<P>MagickBooleanType <strong>QuantizeImages</strong>( const QuantizeInfo *quantize_info, Image *images );</P>
<P>
</P>
<hr />
<h1><a name="function_descriptions">FUNCTION DESCRIPTIONS</a></h1>
<P>
</P>
<h2><a name="clonequantizeinfo">CloneQuantizeInfo</a></h2>
<blockquote>CloneQuantizeInfo() makes a duplicate of the given quantize info structure, or if quantize info is NULL, a new one. </blockquote><P>The format of the CloneQuantizeInfo method is:</P>
<blockquote><A HREF="types.html#QuantizeInfo">QuantizeInfo</A> *CloneQuantizeInfo ( const <A HREF="types.html#QuantizeInfo">QuantizeInfo</A> *quantize_info ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong><a name="item_o_clone_info_3a">clone_info:</a></strong><br />
</dt>
<DD>
Method CloneQuantizeInfo returns a duplicate of the given quantize info, or if image info is NULL a new one.
</dd>
<P></P>
<dt><strong><a name="item_o_quantize_info_3a">quantize_info:</a></strong><br />
</dt>
<DD>
a structure of type info.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="compressimagecolormap">CompressImageColormap</a></h2>
<blockquote>CompressImageColormap() compresses an image colormap by removing any duplicate or unused color entries. </blockquote><P>The format of the CompressImageColormap method is:</P>
<blockquote>void CompressImageColormap ( <A HREF="types.html#Image">Image</A> *image ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong><a name="item_o_image_3a">image:</a></strong><br />
</dt>
<DD>
The image.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="destroyquantizeinfo">DestroyQuantizeInfo</a></h2>
<blockquote>DestroyQuantizeInfo() deallocates memory associated with an <A HREF="types.html#QuantizeInfo">QuantizeInfo</A> structure. </blockquote><P>The format of the DestroyQuantizeInfo method is:</P>
<blockquote>DestroyQuantizeInfo ( <A HREF="types.html#QuantizeInfo">QuantizeInfo</A> *quantize_info ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong>quantize_info:</strong><br />
</dt>
<DD>
Specifies a pointer to an QuantizeInfo structure.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="getimagequantizeerror">GetImageQuantizeError</a></h2>
<blockquote>GetImageQuantizeError() measures the difference between the original and quantized images. This difference is the total quantization error. The error is computed by summing over all pixels in an image the distance squared in RGB space between each reference pixel value and its quantized value. These values are computed: </blockquote><dl>
<dt><strong><a name="item_o_mean_error_per_pixel_3a">mean_error_per_pixel:</a></strong><br />
</dt>
<DD>
This value is the mean error for any single pixel in the image.
</dd>
<P></P>
<dt><strong><a name="item_o_normalized_mean_square_error_3a">normalized_mean_square_error:</a></strong><br />
</dt>
<DD>
This value is the normalized mean quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in the image.
</dd>
<P></P>
<dt><strong><a name="item_o_normalized_maximum_square_error_3a">normalized_maximum_square_error:</a></strong><br />
</dt>
<DD>
Thsi value is the normalized maximum quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in your image.
</dd>
<P></P></dl>
<P>The format of the GetImageQuantizeError method is:</P>
<blockquote>MagickBooleanType GetImageQuantizeError ( <A HREF="types.html#Image">Image</A> *image ); </blockquote><P>A description of each parameter follows.</P>
<dl>
<dt><strong>image:</strong><br />
</dt>
<DD>
Specifies a pointer to an Image structure; returned from ReadImage.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="getquantizeinfo">GetQuantizeInfo</a></h2>
<blockquote>GetQuantizeInfo() initializes the <A HREF="types.html#QuantizeInfo">QuantizeInfo</A> structure. </blockquote><P>The format of the GetQuantizeInfo method is:</P>
<blockquote>GetQuantizeInfo ( <A HREF="types.html#QuantizeInfo">QuantizeInfo</A> *quantize_info ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong>quantize_info:</strong><br />
</dt>
<DD>
Specifies a pointer to a QuantizeInfo structure.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="mapimage">MapImage</a></h2>
<blockquote>MapImage() replaces the colors of an image with the closest color from a reference image. </blockquote><P>The format of the MapImage method is:</P>
<blockquote>MagickBooleanType MapImage ( <A HREF="types.html#Image">Image</A> *image, const <A HREF="types.html#Image">Image</A> *map_image, const MagickBooleanType dither ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong>image:</strong><br />
</dt>
<DD>
Specifies a pointer to an Image structure.
</dd>
<P></P>
<dt><strong><a name="item_o_map_image_3a">map_image:</a></strong><br />
</dt>
<DD>
The image. Reduce image to a set of colors represented by this image.
</dd>
<P></P>
<dt><strong><a name="item_o_dither_3a">dither:</a></strong><br />
</dt>
<DD>
Set this integer value to something other than zero to dither the mapped image.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="mapimages">MapImages</a></h2>
<blockquote>MapImages() replaces the colors of a sequence of images with the closest color from a reference image. </blockquote><P>The format of the MapImage method is:</P>
<blockquote>MagickBooleanType MapImages ( <A HREF="types.html#Image">Image</A> *images, <A HREF="types.html#Image">Image</A> *map_image, const MagickBooleanType dither ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong>image:</strong><br />
</dt>
<DD>
Specifies a pointer to a set of Image structures.
</dd>
<P></P>
<dt><strong>map_image:</strong><br />
</dt>
<DD>
The image. Reduce image to a set of colors represented by this image.
</dd>
<P></P>
<dt><strong>dither:</strong><br />
</dt>
<DD>
Set this integer value to something other than zero to dither the quantized image.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="orderedditherimage">OrderedDitherImage</a></h2>
<blockquote>OrderedDitherImage() uses the ordered dithering technique of reducing color images to monochrome using positional information to retain as much information as possible. </blockquote><P>The format of the OrderedDitherImage method is:</P>
<blockquote>MagickBooleanType OrderedDitherImage ( <A HREF="types.html#Image">Image</A> *image ); </blockquote><P>A description of each parameter follows.</P>
<dl>
<dt><strong>image:</strong><br />
</dt>
<DD>
The image.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="posterizeimage">PosterizeImage</a></h2>
<blockquote>PosterizeImage() reduces the image to a limited number of colors for a "poster" effect. </blockquote><P>The format of the PosterizeImage method is:</P>
<blockquote>MagickBooleanType PosterizeImage ( <A HREF="types.html#Image">Image</A> *image, const unsigned long levels, const MagickBooleanType dither ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong>image:</strong><br />
</dt>
<DD>
Specifies a pointer to an Image structure.
</dd>
<P></P>
<dt><strong><a name="item_o_levels_3a">levels:</a></strong><br />
</dt>
<DD>
Number of color levels allowed in each channel. Very low values (2, 3, or 4) have the most visible effect.
</dd>
<P></P>
<dt><strong>dither:</strong><br />
</dt>
<DD>
Set this integer value to something other than zero to dither the mapped image.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="quantizeimage">QuantizeImage</a></h2>
<blockquote>QuantizeImage() analyzes the colors within a reference image and chooses a fixed number of colors to represent the image. The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time. </blockquote><P>The format of the QuantizeImage method is:</P>
<blockquote>MagickBooleanType QuantizeImage ( const <A HREF="types.html#QuantizeInfo">QuantizeInfo</A> *quantize_info, <A HREF="types.html#Image">Image</A> *image ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong>quantize_info:</strong><br />
</dt>
<DD>
Specifies a pointer to an QuantizeInfo structure.
</dd>
<P></P>
<dt><strong>image:</strong><br />
</dt>
<DD>
The image.
</dd>
<P></P></dl>
<P>
</P>
<h2><a name="quantizeimages">QuantizeImages</a></h2>
<blockquote>QuantizeImages() analyzes the colors within a set of reference images and chooses a fixed number of colors to represent the set. The goal of the algorithm is to minimize the color difference between the input and output images while minimizing the processing time. </blockquote><P>The format of the QuantizeImages method is:</P>
<blockquote>MagickBooleanType QuantizeImages ( const <A HREF="types.html#QuantizeInfo">QuantizeInfo</A> *quantize_info, <A HREF="types.html#Image">Image</A> *images ); </blockquote><P>A description of each parameter follows:</P>
<dl>
<dt><strong>quantize_info:</strong><br />
</dt>
<DD>
Specifies a pointer to an QuantizeInfo structure.
</dd>
<P></P>
<dt><strong><a name="item_o_images_3a">images:</a></strong><br />
</dt>
<DD>
Specifies a pointer to a list of Image structures.
</dd>
</dl>
<HR>
<a href="#top"><img src="../../../images/top.gif" border=0 width=42 height=42 align="right" alt="Top of page"></a>
<form action="http://studio.imagemagick.org/magick/" style="margin-top:5px">
<input type="submit" title="Help!" value="Help!" style="background-image:url('../../../images/background.gif'); color:#fbc713; font-weight:bold">
<small>"Image manipulation software that works like magick"</small>
</form></td>
</tr></table>
</body>
</html>
|
