blob: 69cccae11608dd110e36cf6811570267b9c2e21f [file] [log] [blame]
cristy06f63f22012-10-31 00:50:07 +00001<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html version="-//W3C//DTD XHTML 1.1//EN"
4 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
5 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
6 xsi:schemaLocation="http://www.w3.org/1999/xhtml
7 http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
8<head>
9 <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
cristy8ee7f242013-06-20 16:08:44 +000010 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4"/>
cristyffb69ed2010-12-25 00:06:48 +000011 <title>ImageMagick: MagickCore, C API for ImageMagick: Count the Colors in an Image</title>
cristy751980d2012-06-03 23:18:35 +000012 <meta http-equiv="content-language" content="en-US"/>
13 <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
14 <meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
15 <meta name="application-name" content="ImageMagick"/>
cristy8ee7f242013-06-20 16:08:44 +000016 <meta name="description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition, resize, rotate, shear, distort or transform images automagically."/>
cristy751980d2012-06-03 23:18:35 +000017 <meta name="application-url" content="http://www.imagemagick.org"/>
18 <meta name="generator" content="PHP"/>
cristy8ee7f242013-06-20 16:08:44 +000019 <meta name="keywords" content="magickcore, c, api, for, imagemagick:, count, the, colors, in, an, image, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"/>
cristy751980d2012-06-03 23:18:35 +000020 <meta name="rating" content="GENERAL"/>
21 <meta name="robots" content="INDEX, FOLLOW"/>
22 <meta name="generator" content="ImageMagick Studio LLC"/>
23 <meta name="author" content="ImageMagick Studio LLC"/>
24 <meta name="revisit-after" content="2 DAYS"/>
25 <meta name="resource-type" content="document"/>
cristy72da67d2013-02-24 21:40:48 +000026 <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
cristy751980d2012-06-03 23:18:35 +000027 <meta name="distribution" content="Global"/>
cristy72da67d2013-02-24 21:40:48 +000028 <link rel="icon" href="../../images/wand.png"/>
29 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
cristy06f63f22012-10-31 00:50:07 +000030 <link rel="canonical" href="http://www.imagemagick.org" />
31 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristy8ee7f242013-06-20 16:08:44 +000032
33 <!-- Add jQuery library -->
34 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7/jquery.min.js"></script>
35
36 <!-- Add mousewheel plugin (this is optional) -->
37 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/lib/jquery.mousewheel-3.0.6.pack.js"></script>
38
39 <!-- Add fancyBox -->
40 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/jquery.fancybox.css?v=2.0.6" type="text/css" media="screen" />
41 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/jquery.fancybox.pack.js?v=2.0.6"></script>
42
43 <!-- Optionally add helpers - button, thumbnail and/or media -->
44 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.css?v=1.0.2" type="text/css" media="screen" />
45 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.js?v=1.0.2"></script>
46 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-media.js?v=1.0.0"></script>
47
48 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.css?v=2.0.6" type="text/css" media="screen" />
49 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.js?v=2.0.6"></script>
50
cristy72da67d2013-02-24 21:40:48 +000051 <script type="text/javascript">
cristy8ee7f242013-06-20 16:08:44 +000052 $(document).ready(function() {
53 $(".fancybox").fancybox();
54 });
cristy72da67d2013-02-24 21:40:48 +000055 </script>
cristy8ee7f242013-06-20 16:08:44 +000056
57 <!-- ImageMagick style -->
58 <style type="text/css" media="all">
59 @import url("../../www/magick.css");
60 </style>
cristy06f63f22012-10-31 00:50:07 +000061</head>
62
63<body id="www-imagemagick-org">
cristy8ee7f242013-06-20 16:08:44 +000064
65<script>
66 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
67 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
68 m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
69 })(window,document,'offline-script','//127.0.0.1/analytics.js','ga');
70
71 ga('create', 'UA-40133312-1', 'imagemagick.org');
72 ga('send', 'pageview');
73</script>
74
cristy06f63f22012-10-31 00:50:07 +000075<div class="titlebar">
76<div style="margin: 17px auto; float: left;">
77 <script type="text/javascript">
78 <!--
79 google_ad_client = "pub-3129977114552745";
80 google_ad_slot = "5439289906";
81 google_ad_width = 728;
82 google_ad_height = 90;
83 //-->
84 </script>
85 <script type="text/javascript"
cristy8ee7f242013-06-20 16:08:44 +000086 src="http://127.0.0.1/pagead/show_ads.js">
cristy06f63f22012-10-31 00:50:07 +000087 </script>
88</div>
cristy8ee7f242013-06-20 16:08:44 +000089<a href="http://www.imagemagick.org/discourse-server/">
cristy72da67d2013-02-24 21:40:48 +000090 <img src="../../images/logo.jpg"
cristy06f63f22012-10-31 00:50:07 +000091 alt="ImageMagick Logo"
92 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy8ee7f242013-06-20 16:08:44 +000093<a href="../../index.html">
cristy72da67d2013-02-24 21:40:48 +000094 <img src="../../images/sprite.jpg"
cristy06f63f22012-10-31 00:50:07 +000095 alt="ImageMagick Sprite"
96 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
97</div>
98
99<div class="westbar">
100
cristy3ed852e2009-09-05 21:47:34 +0000101<div class="menu">
cristy8ee7f242013-06-20 16:08:44 +0000102 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000103</div>
cristy3ed852e2009-09-05 21:47:34 +0000104<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000105 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
cristybb503372010-05-27 20:51:26 +0000106</div>
107<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000108 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
cristybb503372010-05-27 20:51:26 +0000109</div>
110<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000111 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
cristybb503372010-05-27 20:51:26 +0000112</div>
113<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000114 <a title="Binary Release: iOS" href="../../www/binary-releases.html#iOS">iOS</a>
cristyda16f162011-02-19 23:52:17 +0000115</div>
116<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000117 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
cristybb503372010-05-27 20:51:26 +0000118</div>
cristy06f63f22012-10-31 00:50:07 +0000119<div class="sep"></div>
cristybb503372010-05-27 20:51:26 +0000120<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000121 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000122</div>
123<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000124 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000125</div>
126<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000127 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000128</div>
129<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000130 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000131</div>
132<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000133 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000134</div>
135<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000136 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000137</div>
138<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000139 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000140</div>
141<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000142 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000143</div>
144<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000145 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000146</div>
cristy06f63f22012-10-31 00:50:07 +0000147<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000148<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000149 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000150</div>
151<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000152 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000153</div>
154<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000155 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000156 </div>
157<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000158 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000159</div>
cristybb503372010-05-27 20:51:26 +0000160<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000161 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
cristybb503372010-05-27 20:51:26 +0000162</div>
cristy3ed852e2009-09-05 21:47:34 +0000163<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000164 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000165</div>
cristy06f63f22012-10-31 00:50:07 +0000166<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000167<div class="menu">
cristy3dfa2192013-02-24 22:46:05 +0000168 <a title="Search" href="http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000169</div>
cristy06f63f22012-10-31 00:50:07 +0000170<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000171<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000172 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000173</div>
174<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000175 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000176</div>
cristy06f63f22012-10-31 00:50:07 +0000177<div class="sep"></div>
cristy8ee7f242013-06-20 16:08:44 +0000178<div class="menu">
179 <a title="Support ImageMagick Development" href="../../www/support.html">Support ImageMagick Development</a>
cristyce69bb02010-07-27 19:49:46 +0000180</div>
cristy06f63f22012-10-31 00:50:07 +0000181</div>
182
183<div class="eastbar">
cristy06f63f22012-10-31 00:50:07 +0000184 <script type="text/javascript">
cristy8ee7f242013-06-20 16:08:44 +0000185 /* <![CDATA[ */
cristy06f63f22012-10-31 00:50:07 +0000186 (function() {
cristy8ee7f242013-06-20 16:08:44 +0000187 var po = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
188 po.type = 'text/javascript';
189 po.async = true;
190 po.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
191 var script = document.getElementsByTagName('offline-script')[0];
192 script.parentNode.insertBefore(po, script);
cristy06f63f22012-10-31 00:50:07 +0000193 })();
cristy8ee7f242013-06-20 16:08:44 +0000194 /* ]]> */
cristy06f63f22012-10-31 00:50:07 +0000195 </script>
cristy8ee7f242013-06-20 16:08:44 +0000196 <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="http://www.imagemagick.org/"></a></div>
197 <noscript>
198 <a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
199 <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0" /></a>
200 </noscript>
201 <div class="g-plusone" id="gplusone"></div>
202 <script type="text/javascript">
203 /* <![CDATA[ */
204 window.___gcfg = {
205 lang: 'en-US'
206 };
207
208 (function() {
209 var po = document.createElement('offline-script');
210 po.type = 'text/javascript';
211 po.async = true;
212 po.src = 'https://127.0.0.1/js/plusone.js';
213 var script = document.getElementsByTagName('offline-script')[0];
214 script.parentNode.insertBefore(po, script);
215 })();
216 var gplusone = document.getElementById("gplusone");
217 gplusone.setAttribute("data-size","medium");
218 gplusone.setAttribute("data-count","true");
219 /* ]]> */
220 </script>
cristy06f63f22012-10-31 00:50:07 +0000221</div>
222
223<div class="main">
224
cristy20398432011-08-11 01:31:50 +0000225<h1>Module color Methods</h1>
cristydba8f1d2013-07-28 13:49:24 +0000226<p class="navigation-index">[<a href="color.html#GetColorInfoList">GetColorInfoList</a> &#8226; <a href="color.html#GetColorList">GetColorList</a> &#8226; <a href="color.html#ListColorInfo">ListColorInfo</a> &#8226; <a href="color.html#LoadColorList">LoadColorList</a> &#8226; <a href="color.html#QueryColorCompliance">QueryColorCompliance</a> &#8226; <a href="color.html#QueryColorDatabase">QueryColorDatabase</a> &#8226; <a href="color.html#QueryColorname">QueryColorname</a> &#8226; <a href="color.html#QueryMagickColorCompliance">QueryMagickColorCompliance</a> &#8226; <a href="color.html#QueryMagickColor">QueryMagickColor</a> &#8226; <a href="color.html#QueryMagickColorname">QueryMagickColorname</a>]</p>
cristy6f77f692011-02-15 15:31:39 +0000227
cristy20398432011-08-11 01:31:50 +0000228<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="GetColorInfoList">GetColorInfoList</a></h2>
229<div class="doc-section">
230
231<p>GetColorInfoList() returns any colors that match the specified pattern.</p>
232
233<p>The format of the GetColorInfoList function is:</p>
234
235<pre class="text">
236 const ColorInfo **GetColorInfoList(const char *pattern,
237 size_t *number_colors,ExceptionInfo *exception)
238</pre>
239
240<p>A description of each parameter follows:</p>
241
242<h5>pattern</h5>
243<p>Specifies a pointer to a text string containing a pattern.</p>
244
245<h5>number_colors</h5>
246<p>This integer returns the number of colors in the list.</p>
247
248<h5>exception</h5>
249<p>return any errors or warnings in this structure.</p>
250
251 </div>
252<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="GetColorList">GetColorList</a></h2>
253<div class="doc-section">
254
255<p>GetColorList() returns any colors that match the specified pattern.</p>
256
257<p>The format of the GetColorList function is:</p>
258
259<pre class="text">
260 char **GetColorList(const char *pattern,size_t *number_colors,
261 ExceptionInfo *exception)
262</pre>
263
264<p>A description of each parameter follows:</p>
265
266<h5>pattern</h5>
267<p>Specifies a pointer to a text string containing a pattern.</p>
268
269<h5>number_colors</h5>
270<p>This integer returns the number of colors in the list.</p>
271
272<h5>exception</h5>
273<p>return any errors or warnings in this structure.</p>
274
275 </div>
276<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="ListColorInfo">ListColorInfo</a></h2>
277<div class="doc-section">
278
279<p>ListColorInfo() lists color names to the specified file. Color names are a convenience. Rather than defining a color by its red, green, and blue intensities just use a color name such as white, blue, or yellow.</p>
280
281<p>The format of the ListColorInfo method is:</p>
282
283<pre class="code">
284 MagickBooleanType ListColorInfo(FILE *file,ExceptionInfo *exception)
285</pre>
286
287<p>A description of each parameter follows.</p>
288
289<h5>file</h5>
290<p>List color names to this file handle.</p>
291
292<h5>exception</h5>
293<p>return any errors or warnings in this structure.</p>
294
295 </div>
296<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="LoadColorList">LoadColorList</a></h2>
297<div class="doc-section">
298
299<p>LoadColorList() loads one or more color configuration file which provides a mapping between color attributes and a color name.</p>
300
301<p>The format of the LoadColorLists method is:</p>
302
303<pre class="code">
304 MagickBooleanType LoadColorLists(const char *filename,
305 ExceptionInfo *exception)
306</pre>
307
308<p>A description of each parameter follows:</p>
309
310<h5>filename</h5>
311<p>the font file name.</p>
312
313<h5>exception</h5>
314<p>return any errors or warnings in this structure.</p>
315
316 </div>
cristyeed6cb62012-01-28 19:38:34 +0000317<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="QueryColorCompliance">QueryColorCompliance</a></h2>
cristy20398432011-08-11 01:31:50 +0000318<div class="doc-section">
319
cristyeed6cb62012-01-28 19:38:34 +0000320<p>QueryColorCompliance() returns the red, green, blue, and opacity intensities for a given color name.</p>
cristy20398432011-08-11 01:31:50 +0000321
cristyeed6cb62012-01-28 19:38:34 +0000322<p>The format of the QueryColorCompliance method is:</p>
cristy20398432011-08-11 01:31:50 +0000323
324<pre class="code">
cristyeed6cb62012-01-28 19:38:34 +0000325 MagickBooleanType QueryColorCompliance(const char *name,
cristy20398432011-08-11 01:31:50 +0000326 const ComplianceType compliance,PixelPacket *color,
327 ExceptionInfo *exception)
328</pre>
329
330<p>A description of each parameter follows:</p>
331
332<h5>name</h5>
333<p>the color name (e.g. white, blue, yellow).</p>
334
335<h5>compliance</h5>
336<p>Adhere to this color standard: SVG, X11, or XPM.</p>
337
338<h5>color</h5>
339<p>the red, green, blue, and opacity intensities values of the named color in this structure.</p>
340
341<h5>exception</h5>
342<p>return any errors or warnings in this structure.</p>
343
344 </div>
345<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="QueryColorDatabase">QueryColorDatabase</a></h2>
346<div class="doc-section">
347
348<p>QueryColorDatabase() returns the red, green, blue, and opacity intensities for a given color name.</p>
349
350<p>The format of the QueryColorDatabase method is:</p>
351
352<pre class="code">
353 MagickBooleanType QueryColorDatabase(const char *name,PixelPacket *color,
354 ExceptionInfo *exception)
355</pre>
356
357<p>A description of each parameter follows:</p>
358
359<h5>name</h5>
360<p>the color name (e.g. white, blue, yellow).</p>
361
362<h5>color</h5>
363<p>the red, green, blue, and opacity intensities values of the named color in this structure.</p>
364
365<h5>exception</h5>
366<p>return any errors or warnings in this structure.</p>
367
368 </div>
369<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="QueryColorname">QueryColorname</a></h2>
370<div class="doc-section">
371
372<p>QueryColorname() returns a named color for the given color intensity. If an exact match is not found, a rgb() color is returned instead.</p>
373
374<p>The format of the QueryColorname method is:</p>
375
376<pre class="code">
377 MagickBooleanType QueryColorname(const Image *image,
378 const PixelPacket *color,const ComplianceType compliance,char *name,
379 ExceptionInfo *exception)
380</pre>
381
382<p>A description of each parameter follows.</p>
383
384<h5>image</h5>
385<p>the image.</p>
386
387<h5>color</h5>
388<p>the color intensities.</p>
389
390<h5>compliance</h5>
391<p>Adhere to this color standard: SVG, X11, or XPM.</p>
392
393<h5>name</h5>
394<p>Return the color name or hex value.</p>
395
396<h5>exception</h5>
397<p>return any errors or warnings in this structure.</p>
398
399 </div>
400<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="QueryMagickColorCompliance">QueryMagickColorCompliance</a></h2>
401<div class="doc-section">
402
403<p>QueryMagickColorCompliance() returns the red, green, blue, and opacity intensities for a given color name and standards compliance.</p>
404
405<p>The format of the QueryMagickColor method is:</p>
406
407<pre class="code">
cristyeed6cb62012-01-28 19:38:34 +0000408 MagickBooleanType QueryMagickColorCompilence(const char *name,
cristy20398432011-08-11 01:31:50 +0000409 const ComplianceType compliance,MagickPixelPacket *color,
410 ExceptionInfo *exception)
411</pre>
412
413<p>A description of each parameter follows:</p>
414
415<h5>name</h5>
416<p>the color name (e.g. white, blue, yellow).</p>
417
418<h5>compliance</h5>
419<p>Adhere to this color standard: SVG, X11, or XPM.</p>
420
421<h5>color</h5>
422<p>the red, green, blue, and opacity intensities values of the named color in this structure.</p>
423
424<h5>exception</h5>
425<p>return any errors or warnings in this structure.</p>
426
427 </div>
428<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="QueryMagickColor">QueryMagickColor</a></h2>
429<div class="doc-section">
430
431<p>QueryMagickColor() returns the red, green, blue, and opacity intensities for a given color name.</p>
432
433<p>The format of the QueryMagickColor method is:</p>
434
435<pre class="code">
436 MagickBooleanType QueryMagickColor(const char *name,
437 MagickPixelPacket *color,ExceptionInfo *exception)
438</pre>
439
440<p>A description of each parameter follows:</p>
441
442<h5>name</h5>
443<p>the color name (e.g. white, blue, yellow).</p>
444
445<h5>color</h5>
446<p>the red, green, blue, and opacity intensities values of the named color in this structure.</p>
447
448<h5>exception</h5>
449<p>return any errors or warnings in this structure.</p>
450
451 </div>
452<h2><a href="http://www.imagemagick.org/api/MagickCore/color_8c.html" id="QueryMagickColorname">QueryMagickColorname</a></h2>
453<div class="doc-section">
454
455<p>QueryMagickColorname() returns a named color for the given color intensity. If an exact match is not found, a hex value is returned instead. For example an intensity of rgb:(0,0,0) returns black whereas rgb:(223,223,223) returns #dfdfdf.</p>
456
457<p>The format of the QueryMagickColorname method is:</p>
458
459<pre class="code">
460 MagickBooleanType QueryMagickColorname(const Image *image,
461 const PixelPacket *color,const ComplianceType compliance,char *name,
462 ExceptionInfo *exception)
463</pre>
464
465<p>A description of each parameter follows.</p>
466
467<h5>image</h5>
468<p>the image.</p>
469
470<h5>color</h5>
471<p>the color intensities.</p>
472
473<h5>Compliance</h5>
474<p>Adhere to this color standard: SVG, X11, or XPM.</p>
475
476<h5>name</h5>
477<p>Return the color name or hex value.</p>
478
479<h5>exception</h5>
480<p>return any errors or warnings in this structure.</p>
481
482 </div>
cristy06f63f22012-10-31 00:50:07 +0000483
484</div>
485
486<div id="linkbar">
cristyac1b4322013-07-28 13:58:06 +0000487 <span id="linkbar-west"> </span>
cristy8ee7f242013-06-20 16:08:44 +0000488
cristy06f63f22012-10-31 00:50:07 +0000489 <span id="linkbar-center">
cristydba8f1d2013-07-28 13:49:24 +0000490 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &#8226;
491 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> &#8226;
cristy8ee7f242013-06-20 16:08:44 +0000492 <a href="http://jqmagick.imagemagick.org/">JqMagick</a>
cristy06f63f22012-10-31 00:50:07 +0000493 </span>
cristyac1b4322013-07-28 13:58:06 +0000494 <span id="linkbar-east"> </span>
cristy06f63f22012-10-31 00:50:07 +0000495 </div>
496 <div class="footer">
cristyac1b4322013-07-28 13:58:06 +0000497 <span id="footer-west">© 1999-2013 ImageMagick Studio LLC</span>
cristyd8833bf2013-02-24 22:14:53 +0000498 <span id="footer-east"> <a href="../../www/contact.html">Contact the Wizards</a></span>
cristy06f63f22012-10-31 00:50:07 +0000499 </div>
500 <div style="clear: both; margin: 0; width: 100%; "></div>
cristy06f63f22012-10-31 00:50:07 +0000501</body>
502</html>