Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 30b8c8049806eef7eb826ebc8b9b26e83fa17cd0 / . / www / api / histogram.html
blob: 267a1cb666b2a8da24b0dc50b1b1dcff43bcfaa2 [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"/>
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]12 <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition resize, 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/">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]55 <img src="../../images/logo.jpg"
56 alt="ImageMagick Logo"
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]57 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]58<a href="../../index.html">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]59 <img src="../../images/sprite.jpg"
60 alt="ImageMagick Sprite"
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]61 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
62</div>
63
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]64<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]65
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]66<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]67 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]68</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]69<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]70<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]71 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
72</div>
73<div class="sub">
74 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
75</div>
76<div class="sub">
77 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
78</div>
79<div class="sub">
80 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
81</div>
82<div class="sep"></div>
83<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]84 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]85</div>
86<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]87 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]88</div>
89<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]90 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]91</div>
92<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]93 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]94</div>
95<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]96 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]97</div>
98<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]99 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]100</div>
101<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]102 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103</div>
104<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]105 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]106</div>
107<div class="sub">
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]108 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]110<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]112 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]113</div>
114<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]115 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]116</div>
117<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]118 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]119 </div>
120<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]121 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]122</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]123<div class="menu">
124 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
125</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]126<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]127 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]128</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]129<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]130<div class="menu">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]131 <a title="Search" href="../../www/search.html">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]132</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]133<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]134<div class="menu">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]135 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]136</div>
137<div class="sub">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]138 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]139</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]140<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]141<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]142 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]143
144<div class="sponsbox">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]145<div class="sponsor">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]146 <a title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
147</div>
148<div class="sponsor">
149 <a title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
150</div>
151<div class="sponsor">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]152 <a title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201106010240 -->
153</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]154<div class="sponsor">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]155 <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]156</div>
157<div class="sponsor">
cristyc5baf4f2010-08-31 15:05:33 +0000[diff] [blame]158 <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
159</div>
160<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]161 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
162</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]163<div class="sponsor">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]164 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
165</div>
166<div class="sponsor">
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]167 <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]168</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]169</div>
170</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]171</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]172
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]173<div class="eastbar">
174 <script type="text/javascript">
175 <!--
176 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]177 google_ad_slot = "0574824969";
178 google_ad_width = 160;
179 google_ad_height = 600;
180 //-->
181 </script>
182 <script type="text/javascript"
183 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
184 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]185</div>
186
187<div class="main">
188
cristy307ba182010-12-25 01:00:34 +0000[diff] [blame]189<h1>Module histogram
190 Methods</h1>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]191<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]192
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]193<h2><a href="http://www.imagemagick.org/api/MagickCore/histogram
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]194_8c.html" id="GetImageHistogram">GetImageHistogram</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]195<div class="doc-section">
196
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]197<p>GetImageHistogram() returns the unique colors in an image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]198
199<p>The format of the GetImageHistogram method is:</p>
200
201<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]202 size_t GetImageHistogram(const Image *image,
203 size_t *number_colors,ExceptionInfo *exception)
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]204</pre>
205
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]206<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]207
208<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]209<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]210
211<h5>file</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]212<p>Write a histogram of the color distribution to this file handle.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]213
214<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]215<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]216
217 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]218<h2><a href="http://www.imagemagick.org/api/MagickCore/histogram
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]219_8c.html" id="IsHistogramImage">IsHistogramImage</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]220<div class="doc-section">
221
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]222<p>IsHistogramImage() returns MagickTrue if the image has 1024 unique colors or less.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]223
224<p>The format of the IsHistogramImage method is:</p>
225
226<pre class="code">
227 MagickBooleanType IsHistogramImage(const Image *image,
228 ExceptionInfo *exception)
229</pre>
230
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]231<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]232
233<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]234<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]235
236<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]237<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]238
239 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]240<h2><a href="http://www.imagemagick.org/api/MagickCore/histogram
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]241_8c.html" id="IsPaletteImage">IsPaletteImage</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]242<div class="doc-section">
243
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]244<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]245
246<p>The format of the IsPaletteImage method is:</p>
247
248<pre class="code">
249 MagickBooleanType IsPaletteImage(const Image *image,
250 ExceptionInfo *exception)
251</pre>
252
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]253<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]254
255<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]256<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]257
258<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]259<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]260
261 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]262<h2><a href="http://www.imagemagick.org/api/MagickCore/histogram
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]263_8c.html" id="MinMaxStretchImage">MinMaxStretchImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]264<div class="doc-section">
265
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]266<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]267
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]268<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]269
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]270<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]271
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]272<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]273
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]274<p>The 'SyncChannels' is turned on in the 'DefaultChannels' setting by default.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]275
276<p>The format of the MinMaxStretchImage method is:</p>
277
278<pre class="code">
279 MagickBooleanType MinMaxStretchImage(Image *image,
280 const ChannelType channel, const double black_adjust,
281 const double white_adjust)
282</pre>
283
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]284<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]285
286<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]287<p>The image to auto-level</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]288
289<h5>channel</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]290<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]291
292<h5>black_adjust, white_adjust</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]293<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]294
295 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]296<h2><a href="http://www.imagemagick.org/api/MagickCore/histogram
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]297_8c.html" id="GetNumberColors">GetNumberColors</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]298<div class="doc-section">
299
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]300<p>GetNumberColors() returns the number of unique colors in an image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]301
302<p>The format of the GetNumberColors method is:</p>
303
304<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]305 size_t GetNumberColors(const Image *image,FILE *file,
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]306 ExceptionInfo *exception)
307</pre>
308
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]309<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]310
311<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]312<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]313
314<h5>file</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]315<p>Write a histogram of the color distribution to this file handle.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]316
317<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]318<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]319
320 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]321<h2><a href="http://www.imagemagick.org/api/MagickCore/histogram
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]322_8c.html" id="UniqueImageColors">UniqueImageColors</a></h2>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]323<div class="doc-section">
324
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]325<p>UniqueImageColors() returns the unique colors of an image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]326
327<p>The format of the UniqueImageColors method is:</p>
328
329<pre class="code">
330 Image *UniqueImageColors(const Image *image,ExceptionInfo *exception)
331</pre>
332
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]333<p>A description of each parameter follows.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]334
335<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]336<p>the image.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]337
338<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]339<p>return any errors or warnings in this structure.</p>
cristy83543962009-10-16 19:04:28 +0000[diff] [blame]340
341 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]342
343</div>
344
345<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]346 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]347 <span id="linkbar-center">
348 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]349 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]350 </span>
351 <span id="linkbar-east">&nbsp;</span>
352 </div>
353 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]354 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]355 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
356 </div>
357 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]358 <script type="text/javascript">
359 var _gaq = _gaq || [];
360 _gaq.push(['_setAccount', 'UA-17690367-1']);
361 _gaq.push(['_trackPageview']);
362
363 (function() {
364 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
365 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
366 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
367 })();
368 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]369</body>
370</html>