<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<style type="text/css" media="screen,projection"><!--
@import url("../../www/magick.css");
//--></style>
<meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
<link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
<title>ImageMagick: MagickCore, C API for ImageMagick: Count the Colors in an Image</title>
<meta http-equiv="Content-Language" content="en-US"/>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
<meta name="Generator" content="PHP"/>
<meta name="Keywords" content="magickcore, c, api, for, imagemagick:, count, the, colors, in, an, image, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject"/>
<meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves. ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems. The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
<meta name="Rating" content="GENERAL"/>
<meta name="Robots" content="INDEX, FOLLOW"/>
<meta name="Generator" content="ImageMagick Studio LLC"/>
<meta name="Author" content="ImageMagick Studio LLC"/>
<meta name="Revisit-after" content="2 DAYS"/>
<meta name="Resource-type" content="document"/>
<meta name="Copyright" content="Copyright (c) 1999-2008 ImageMagick Studio LLC"/>
<meta name="Distribution" content="Global"/>
<link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
</head>
<body id="www-imagemagick-org">
<table id="titlebar" style="width: 100%;background-color: #f5f5f5" cellpadding="0" cellspacing="0" border="0" summary="ImageMagick">
<tbody>
<tr valign="top">
<td align="left"><a href="../../index.html"><img id="titlebar-west" src="../../images/script.png" alt="[ImageMagick]" width="350" height="60" border="0" vspace="28" name="titlebar-west"/></a></td>
<td align="left"><a href="https://secure.networkredux.com/affiliate/idevaffiliate.html?id=146" target="70601344"><img id="titlebar-west" src="../../images/networkredux.png" alt="[sponsor]" border="0" vspace="45" name="titlebar-west"/></a></td>
<td width="99%"><br /> </td>
<td style="background-color: white" align="right"><a href="../../index.html"><img src="../../images/sprite.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
<td style="background-color: white" align="right"><a href="http://www.imagemagick.org/discourse-server/" target="1249191163"><img id="titlebar-east" src="../../images/logo.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
</tr>
</tbody>
</table>
<table style="width: 100%" border="0" cellpadding="0" cellspacing="0" summary="">
<tbody>
<tr valign="top" style="height: 100%;">
<td id="menu" width="1%" height="100%">
<p><a href="#main">Skip to page contents</a></p>
<font size="-1">
<span>[</span>
<a href="../../index.html">About ImageMagick</a>
<span>]</span><br /><span>[</span>
<a href="../../www/command-line-tools.html">Command-line Tools</a>
<a href="../../www/command-line-processing.html" class="sub">Processing</a>
<a href="../../www/command-line-options.html" class="sub">Options</a>
<a href="http://www.imagemagick.org/Usage/" target="145287234" class="sub">Usage</a>
<a href="../../www/api.html">Program Interfaces</a>
<a href="../../www/magick-wand.html" class="sub">MagickWand</a>
<a href="../../www/magick-core.html" class="sub">MagickCore</a>
<a href="../../www/perl-magick.html" class="sub">PerlMagick</a>
<a href="../../Magick++/" target="426463906" class="sub">Magick++</a>
<a href="../../www/architecture.html">Architecture</a>
<span>]</span><br /><span>[</span>
<a href="../../www/install-source.html">Install from Source</a>
<a href="../../www/install-source.html#unix" class="sub">Unix</a>
<a href="../../www/install-source.html#windows" class="sub">Windows</a>
<a href="../../www/binary-releases.html">Binary Releases</a>
<a href="../../www/binary-releases.html#unix" class="sub">Unix</a>
<a href="../../www/binary-releases.html#macosx" class="sub">Mac OS X</a>
<a href="../../www/binary-releases.html#windows" class="sub">Windows</a>
<a href="../../www/resources.html">Resources</a>
<span>]</span><br /><span>[</span>
<a href="../../www/download.html">Download</a>
<span>]</span><br /><span>[</span>
<a href="../../www/sitemap.html">Site Map</a>
<a href="../../www/links.html" class="sub">Links</a>
<span>]</span><br /><span>[</span>
<a href="../../www/sponsors.html">Sponsors:</a>
<fieldset>
<a href="http://www.aoemedia.de" class="sponsor" target="sponsor">TYPO3 Agentur</a><!-- 200807010000 -->
<br />
<a href="http://business-directory.com"><img src="../../images/business+directory.gif" alt="[Business + Directory]" width="105" height="60" border="0" name="business+directory"/></a> <!-- 200808010160 -->
<br />
<a href="http://analogik.com"><img src="../../images/analogik.png" alt="[Electronic Music]" width="105" height="60" border="0" name="analogik"/></a> <!-- 200804030160 -->
</fieldset>
<span>]</span>
</font>
</td>
<td id="main" valign="top">
<p class="navigation-index">[ <a href="#GetColorInfoList">GetColorInfoList</a> | <a href="#GetColorList">GetColorList</a> | <a href="#GetImageHistogram">GetImageHistogram</a> | <a href="#GetNumberColors">GetNumberColors</a> | <a href="#IsGrayImage">IsGrayImage</a> | <a href="#IsHistogramImage">IsHistogramImage</a> | <a href="#IsMonochromeImage">IsMonochromeImage</a> | <a href="#IsOpaqueImage">IsOpaqueImage</a> | <a href="#IsPaletteImage">IsPaletteImage</a> | <a href="#ListColorInfo">ListColorInfo</a> | <a href="#LoadColorList">LoadColorList</a> | <a href="#QueryColorDatabase">QueryColorDatabase</a> | <a href="#QueryColorname">QueryColorname</a> | <a href="#QueryMagickColor">QueryMagickColor</a> | <a href="#QueryMagickColorname">QueryMagickColorname</a> | <a href="#UniqueImageColors">UniqueImageColors</a> ]</p>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="GetColorInfoList">GetColorInfoList</a></h2>
</div>
<p>GetColorInfoList() returns any colors that match the specified pattern.</p></ol>
<p>The format of the GetColorInfoList function is:</p>
<pre class="text">
const ColorInfo **GetColorInfoList(const char *pattern,
unsigned long *number_colors,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>pattern</h5>
<ol><p>Specifies a pointer to a text string containing a pattern.</p></ol>
<h5>number_colors</h5>
<ol><p>This integer returns the number of colors in the list.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="GetColorList">GetColorList</a></h2>
</div>
<p>GetColorList() returns any colors that match the specified pattern.</p></ol>
<p>The format of the GetColorList function is:</p>
<pre class="text">
char **GetColorList(const char *pattern,unsigned long *number_colors,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>pattern</h5>
<ol><p>Specifies a pointer to a text string containing a pattern.</p></ol>
<h5>number_colors</h5>
<ol><p>This integer returns the number of colors in the list.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="GetImageHistogram">GetImageHistogram</a></h2>
</div>
<p>GetImageHistogram() returns the unique colors in an image.</p></ol>
<p>The format of the GetImageHistogram method is:</p>
<pre class="code">
unsigned long GetImageHistogram(const Image *image,
unsigned long *number_colors,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>file</h5>
<ol><p>Write a histogram of the color distribution to this file handle.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="GetNumberColors">GetNumberColors</a></h2>
</div>
<p>GetNumberColors() returns the number of unique colors in an image.</p></ol>
<p>The format of the GetNumberColors method is:</p>
<pre class="code">
unsigned long GetNumberColors(const Image *image,FILE *file,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>file</h5>
<ol><p>Write a histogram of the color distribution to this file handle.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="IsGrayImage">IsGrayImage</a></h2>
</div>
<p>IsGrayImage() returns MagickTrue if all the pixels in the image have the same red, green, and blue intensities.</p></ol>
<p>The format of the IsGrayImage method is:</p>
<pre class="code">
MagickBooleanType IsGrayImage(const Image *image,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="IsHistogramImage">IsHistogramImage</a></h2>
</div>
<p>IsHistogramImage() returns MagickTrue if the image has 1024 unique colors or less.</p></ol>
<p>The format of the IsHistogramImage method is:</p>
<pre class="code">
MagickBooleanType IsHistogramImage(const Image *image,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="IsMonochromeImage">IsMonochromeImage</a></h2>
</div>
<p>IsMonochromeImage() returns MagickTrue if all the pixels in the image have the same red, green, and blue intensities and the intensity is either 0 or QuantumRange.</p></ol>
<p>The format of the IsMonochromeImage method is:</p>
<pre class="code">
MagickBooleanType IsMonochromeImage(const Image *image,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="IsOpaqueImage">IsOpaqueImage</a></h2>
</div>
<p>IsOpaqueImage() returns MagickTrue if none of the pixels in the image have an opacity value other than opaque (0).</p></ol>
<p>The format of the IsOpaqueImage method is:</p>
<pre class="code">
MagickBooleanType IsOpaqueImage(const Image *image,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="IsPaletteImage">IsPaletteImage</a></h2>
</div>
<p>IsPaletteImage() returns MagickTrue if the image is PseudoClass and has 256 unique colors or less.</p></ol>
<p>The format of the IsPaletteImage method is:</p>
<pre class="code">
MagickBooleanType IsPaletteImage(const Image *image,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="ListColorInfo">ListColorInfo</a></h2>
</div>
<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></ol>
<p>The format of the ListColorInfo method is:</p>
<pre class="code">
MagickBooleanType ListColorInfo(FILE *file,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>file</h5>
<ol><p>List color names to this file handle.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="LoadColorList">LoadColorList</a></h2>
</div>
<p>LoadColorList() loads one or more color configuration file which provides a mapping between color attributes and a color name.</p></ol>
<p>The format of the LoadColorLists method is:</p>
<pre class="code">
MagickBooleanType LoadColorLists(const char *filename,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>filename</h5>
<ol><p>the font file name.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="QueryColorDatabase">QueryColorDatabase</a></h2>
</div>
<p>QueryColorDatabase() returns the red, green, blue, and opacity intensities for a given color name.</p></ol>
<p>The format of the QueryColorDatabase method is:</p>
<pre class="code">
MagickBooleanType QueryColorDatabase(const char *name,PixelPacket *color,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>name</h5>
<ol><p>the color name (e.g. white, blue, yellow).</p></ol>
<h5>color</h5>
<ol><p>the red, green, blue, and opacity intensities values of the named color in this structure.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="QueryColorname">QueryColorname</a></h2>
</div>
<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></ol>
<p>The format of the QueryColorname method is:</p>
<pre class="code">
MagickBooleanType QueryColorname(const Image *image,
const PixelPacket *color,const ComplianceType compliance,char *name,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>color</h5>
<ol><p>the color intensities.</p></ol>
<h5>compliance</h5>
<ol><p>Adhere to this color standard: SVG, X11, or XPM.</p></ol>
<h5>name</h5>
<ol><p>Return the color name or hex value.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="QueryMagickColor">QueryMagickColor</a></h2>
</div>
<p>QueryMagickColor() returns the red, green, blue, and opacity intensities for a given color name.</p></ol>
<p>The format of the QueryMagickColor method is:</p>
<pre class="code">
MagickBooleanType QueryMagickColor(const char *name,
MagickPixelPacket *color,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>name</h5>
<ol><p>the color name (e.g. white, blue, yellow).</p></ol>
<h5>color</h5>
<ol><p>the red, green, blue, and opacity intensities values of the named color in this structure.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="QueryMagickColorname">QueryMagickColorname</a></h2>
</div>
<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></ol>
<p>The format of the QueryMagickColorname method is:</p>
<pre class="code">
MagickBooleanType QueryMagickColorname(const Image *image,
const PixelPacket *color,const ComplianceType compliance,
const MagickBooleanType hex,char *name,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>color</h5>
<ol><p>the color intensities.</p></ol>
<h5>Compliance</h5>
<ol><p>Adhere to this color standard: SVG, X11, or XPM.</p></ol>
<h5>hex</h5>
<ol><p>A value other than zero returns the tuple in a hexidecimal format.</p></ol>
<h5>name</h5>
<ol><p>Return the color name or hex value.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/color.c
?view=markup" target="source" name="UniqueImageColors">UniqueImageColors</a></h2>
</div>
<p>UniqueImageColors() returns the unique colors of an image.</p></ol>
<p>The format of the UniqueImageColors method is:</p>
<pre class="code">
Image *UniqueImageColors(const Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
</td>
<td id="margin" width="1%" height="100%" valign="top" align="right"> </td>
</tr>
</tbody>
</table>
<div id="linkbar">
<a href="http://www.imagemagick.org/discourse-server/" target="495121172">Discourse Server</a> •
<a href="../../www/mailing-list.html">Mailing Lists</a> •
<a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi" target="481724552">ImageMagick Studio</a>
</div>
<div id="footer">
<span id="footer-west">© 1999-2008 ImageMagick Studio LLC</span>
</div>
<div style="clear: both; margin: 0; width: 100%; "></div>
</body>
</html>
