Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 5292344af862c8d10e50c4e9300a591aad3acae5 / . / www / api / histogram.html
blob: 487b85aa6cf6b8179767a1e467de583d10900694 [file] [log] [blame]
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]4<head>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]7 <title>ImageMagick: MagickCore, C API for ImageMagick: Image Histograms</title>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]8 <meta http-equiv="Content-Language" content="en-US"/>
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
10 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]11 <meta name="Application-name" content="ImageMagick"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]12 <meta name="Description" content="ImageMagick is a software suite to create, edit, compose, or convert bitmap images in a variety of formats. Use ImageMagick to scale, rotate, shear, distort and transform images."/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]13 <meta name="Application-url" content="http://www.imagemagick.org"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]14 <meta name="Generator" content="PHP"/>
15 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, image, histograms, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]16 <meta name="Rating" content="GENERAL"/>
17 <meta name="Robots" content="INDEX, FOLLOW"/>
18 <meta name="Generator" content="ImageMagick Studio LLC"/>
19 <meta name="Author" content="ImageMagick Studio LLC"/>
20 <meta name="Revisit-after" content="2 DAYS"/>
21 <meta name="Resource-type" content="document"/>
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]22 <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]23 <meta name="Distribution" content="Global"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]24 <link rel="icon" href="../../images/wand.png"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]25 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
26 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]27 <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]28 <style type="text/css" media="all">
29 @import url("../../www/magick.css");
30 </style>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]31 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
cristy361f4662010-12-31 23:02:52 +0000[diff] [blame]32 <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>
33 <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />
34 <script type="text/javascript">
35 $(document).ready(function() {
36 $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
37 'transitionIn' : 'elastic',
38 'transitionOut' : 'elastic',
39 'overlayShow' : false,
40 'opacity' : true
41 });
42 });
43 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]44</head>
45
46<body id="www-imagemagick-org">
47<div class="titlebar">
48<a href="../../index.html">
49 <img src="../../images/script.png" alt="[ImageMagick]"
50 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
51<a href="http://www.networkredux.com">
52 <img src="../../images/networkredux.png" alt="[sponsor]"
cristy52923442011-01-15 22:54:31 +0000[diff] [blame^]53 style="margin-top: 42px; border: 0px; float: left;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]54<a href="http://www.imagemagick.org/discourse-server/">
55 <img src="../../images/logo.jpg" alt=""
56 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
57<a href="../../index.html">
58 <img src="../../images/sprite.jpg" alt=""
59 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
60</div>
61
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]62<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]63
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]64<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]65 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]66</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]67<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]68<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]69 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
70</div>
71<div class="sub">
72 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
73</div>
74<div class="sub">
75 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
76</div>
77<div class="sub">
78 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
79</div>
80<div class="sep"></div>
81<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]82 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]83</div>
84<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]85 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]86</div>
87<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]88 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]89</div>
90<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]91 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]92</div>
93<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]94 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]95</div>
96<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]97 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]98</div>
99<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]100 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]101</div>
102<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]103 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]104</div>
105<div class="sub">
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]106 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]107</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]108<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]110 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111</div>
112<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]113 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]114</div>
115<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]116 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]117 </div>
118<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]119 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]120</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]121<div class="menu">
122 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
123</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]124<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]125 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]126</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]127<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]128<div class="menu">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame^]129 <a title="Search" href="../../www/search.html">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]130</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]131<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]132<div class="menu">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]133 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]134</div>
135<div class="sub">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]136 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]137</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]138<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]139<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]140 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]141
142<div class="sponsbox">
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]143<div class="sponsor">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame^]144 <a title="Sponsor: Web Hosting" href="http://www.bodhost.com/hosting.shtml">Web Hosting</a><!-- 201104010090 -->
cristy7d52cd62010-10-01 17:26:59 +0000[diff] [blame]145</div>
146<div class="sponsor">
147 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
cristy73fd1cd2010-09-12 19:14:25 +0000[diff] [blame]148</div>
149<div class="sponsor">
cristyc5baf4f2010-08-31 15:05:33 +0000[diff] [blame]150 <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
151</div>
152<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]153 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
154</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]155<div class="sponsor">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame^]156 <a title="Sponsor: alaTest.com" href="http://alatest.com">alaTest.com</a><!-- 20110801000300 -->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]157</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]158</div>
159</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]160</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]161
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]162<div class="eastbar">
163 <script type="text/javascript">
164 <!--
165 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]166 google_ad_slot = "0574824969";
167 google_ad_width = 160;
168 google_ad_height = 600;
169 //-->
170 </script>
171 <script type="text/javascript"
172 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
173 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]174</div>
175
176<div class="main">
177
cristy307ba182010-12-25 01:00:34 +0000[diff] [blame]178<h1>Module histogram
179 Methods</h1>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]180<p class="navigation-index">[<a href="#GetImageHistogram">GetImageHistogram</a> &bull; <a href="#IsHistogramImage">IsHistogramImage</a> &bull; <a href="#IsPaletteImage">IsPaletteImage</a> &bull; <a href="#MinMaxStretchImage">MinMaxStretchImage</a> &bull; <a href="#GetNumberColors">GetNumberColors</a> &bull; <a href="#UniqueImageColors">UniqueImageColors</a>]</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]181
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]182<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/histogram
183_8c.html" id="GetImageHistogram">GetImageHistogram</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]184<div class="doc-section">
185
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]186<p>GetImageHistogram() returns the unique colors in an image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]187
188<p>The format of the GetImageHistogram method is:</p>
189
190<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]191 size_t GetImageHistogram(const Image *image,
192 size_t *number_colors,ExceptionInfo *exception)
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]193</pre>
194
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]195<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]196
197<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]198<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]199
200<h5>file</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]201<p>Write a histogram of the color distribution to this file handle.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]202
203<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]204<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]205
206 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]207<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/histogram
208_8c.html" id="IsHistogramImage">IsHistogramImage</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]209<div class="doc-section">
210
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]211<p>IsHistogramImage() returns MagickTrue if the image has 1024 unique colors or less.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]212
213<p>The format of the IsHistogramImage method is:</p>
214
215<pre class="code">
216 MagickBooleanType IsHistogramImage(const Image *image,
217 ExceptionInfo *exception)
218</pre>
219
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]220<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]221
222<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]223<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]224
225<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]226<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]227
228 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]229<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/histogram
230_8c.html" id="IsPaletteImage">IsPaletteImage</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]231<div class="doc-section">
232
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]233<p>IsPaletteImage() returns MagickTrue if the image is PseudoClass and has 256 unique colors or less.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]234
235<p>The format of the IsPaletteImage method is:</p>
236
237<pre class="code">
238 MagickBooleanType IsPaletteImage(const Image *image,
239 ExceptionInfo *exception)
240</pre>
241
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]242<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]243
244<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]245<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]246
247<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]248<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]249
250 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]251<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/histogram
252_8c.html" id="MinMaxStretchImage">MinMaxStretchImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]253<div class="doc-section">
254
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]255<p>MinMaxStretchImage() uses the exact minimum and maximum values found in each of the channels given, as the BlackPoint and WhitePoint to linearly stretch the colors (and histogram) of the image. The stretch points are also moved further inward by the adjustment values given.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]256
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]257<p>If the adjustment values are both zero this function is equivelent to a perfect normalization (or autolevel) of the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]258
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]259<p>Each channel is stretched independantally of each other (producing color distortion) unless the special 'SyncChannels' flag is also provided in the channels setting. If this flag is present the minimum and maximum point will be extracted from all the given channels, and those channels will be stretched by exactly the same amount (preventing color distortion).</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]260
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]261<p>In the special case that only ONE value is found in a channel of the image that value is not stretched, that value is left as is.</p>
cristy031b7a82010-04-08 00:33:24 +0000[diff] [blame]262
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]263<p>The 'SyncChannels' is turned on in the 'DefaultChannels' setting by default.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]264
265<p>The format of the MinMaxStretchImage method is:</p>
266
267<pre class="code">
268 MagickBooleanType MinMaxStretchImage(Image *image,
269 const ChannelType channel, const double black_adjust,
270 const double white_adjust)
271</pre>
272
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]273<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]274
275<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]276<p>The image to auto-level</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]277
278<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]279<p>The channels to auto-level. If the special 'SyncChannels' flag is set, all the given channels are stretched by the same amount.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]280
281<h5>black_adjust, white_adjust</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]282<p>Move the Black/White Point inward from the minimum and maximum points by this color value.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]283
284 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]285<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/histogram
286_8c.html" id="GetNumberColors">GetNumberColors</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]287<div class="doc-section">
288
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]289<p>GetNumberColors() returns the number of unique colors in an image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]290
291<p>The format of the GetNumberColors method is:</p>
292
293<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]294 size_t GetNumberColors(const Image *image,FILE *file,
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]295 ExceptionInfo *exception)
296</pre>
297
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]298<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]299
300<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]301<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]302
303<h5>file</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]304<p>Write a histogram of the color distribution to this file handle.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]305
306<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]307<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]308
309 </div>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]310<h2><a href="http://www.wizards-toolkit.org/api/MagickCore/histogram
311_8c.html" id="UniqueImageColors">UniqueImageColors</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]312<div class="doc-section">
313
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]314<p>UniqueImageColors() returns the unique colors of an image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]315
316<p>The format of the UniqueImageColors method is:</p>
317
318<pre class="code">
319 Image *UniqueImageColors(const Image *image,ExceptionInfo *exception)
320</pre>
321
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]322<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]323
324<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]325<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]326
327<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]328<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]329
330 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]331
332</div>
333
334<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]335 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]336 <span id="linkbar-center">
337 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]338 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]339 </span>
340 <span id="linkbar-east">&nbsp;</span>
341 </div>
342 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]343 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]344 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
345 </div>
346 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]347 <script type="text/javascript">
348 var _gaq = _gaq || [];
349 _gaq.push(['_setAccount', 'UA-17690367-1']);
350 _gaq.push(['_trackPageview']);
351
352 (function() {
353 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
354 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
355 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
356 })();
357 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]358</body>
359</html>